@nucleux/md3-navigation-bar 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nucleux
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# @nucleux/md3-navigation-bar
+
+Material 3 bottom navigation bar — Nucleux agentic UI for React.
+
+Part of **[Nucleux](https://github.com/intelligaia-open-labs/nucleux)** — agentic UI components for React. Install a single component, or the full kit via [`@nucleux/react`](https://www.npmjs.com/package/@nucleux/react).
+
+## Install
+
+```bash
+pnpm add @nucleux/md3-navigation-bar @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { Md3NavigationBar } from "@nucleux/md3-navigation-bar";
+```
+
+Requires the theme once in your app: `import "@nucleux/tokens/styles.css";`
+and the Tailwind preset from `@nucleux/tokens/preset`.
+
+## License
+
+MIT © Nucleux

package/dist/index.cjs

@@ -0,0 +1,92 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var utils = require('@nucleux/utils');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React__namespace = /*#__PURE__*/_interopNamespace(React);
+
+// src/index.tsx
+var NavContext = React__namespace.createContext(null);
+var Md3NavigationBar = React__namespace.forwardRef(
+  ({ value, defaultValue, onValueChange, className, children, ...props }, ref) => {
+    const isControlled = value !== void 0;
+    const [internal, setInternal] = React__namespace.useState(defaultValue);
+    const current = isControlled ? value : internal;
+    const setValue = (v) => {
+      if (!isControlled) setInternal(v);
+      onValueChange?.(v);
+    };
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "nav",
+      {
+        ref,
+        className: utils.cn("flex h-20 items-stretch justify-around bg-md-surface-container px-2", className),
+        ...props,
+        children: /* @__PURE__ */ jsxRuntime.jsx(NavContext.Provider, { value: { value: current, setValue }, children })
+      }
+    );
+  }
+);
+Md3NavigationBar.displayName = "Md3NavigationBar";
+var Md3NavigationBarItem = React__namespace.forwardRef(
+  ({ value, icon, label, className, ...props }, ref) => {
+    const ctx = React__namespace.useContext(NavContext);
+    if (!ctx) throw new Error("Md3NavigationBarItem must be used within a Md3NavigationBar");
+    const active = ctx.value === value;
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "button",
+      {
+        ref,
+        type: "button",
+        "aria-current": active ? "page" : void 0,
+        onClick: () => ctx.setValue(value),
+        className: utils.cn(
+          "group flex flex-1 flex-col items-center justify-center gap-1 pt-3 pb-2 outline-none",
+          className
+        ),
+        ...props,
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsx(
+            "span",
+            {
+              className: utils.cn(
+                "relative flex h-8 w-16 items-center justify-center overflow-hidden rounded-full transition-colors [&_svg]:size-6",
+                "before:absolute before:inset-0 before:bg-md-on-surface before:opacity-0 before:transition-opacity before:content-['']",
+                "group-hover:before:opacity-[0.08] group-focus-visible:before:opacity-[0.12]",
+                active ? "bg-md-secondary-container text-md-on-secondary-container" : "text-md-on-surface-variant"
+              ),
+              children: /* @__PURE__ */ jsxRuntime.jsx("span", { className: "relative", children: icon })
+            }
+          ),
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: utils.cn("text-xs font-medium", active ? "text-md-on-surface" : "text-md-on-surface-variant"), children: label })
+        ]
+      }
+    );
+  }
+);
+Md3NavigationBarItem.displayName = "Md3NavigationBarItem";
+
+exports.Md3NavigationBar = Md3NavigationBar;
+exports.Md3NavigationBarItem = Md3NavigationBarItem;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["React","jsx","cn","jsxs"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,IAAM,UAAA,GAAmBA,+BAAsC,IAAI,CAAA;AAU5D,IAAM,gBAAA,GAAyBA,gBAAA,CAAA,UAAA;AAAA,EACpC,CAAC,EAAE,KAAA,EAAO,YAAA,EAAc,aAAA,EAAe,WAAW,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AAC9E,IAAA,MAAM,eAAe,KAAA,KAAU,MAAA;AAC/B,IAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAUA,0BAAS,YAAY,CAAA;AAC3D,IAAA,MAAM,OAAA,GAAU,eAAe,KAAA,GAAQ,QAAA;AACvC,IAAA,MAAM,QAAA,GAAW,CAAC,CAAA,KAAc;AAC9B,MAAA,IAAI,CAAC,YAAA,EAAc,WAAA,CAAY,CAAC,CAAA;AAChC,MAAA,aAAA,GAAgB,CAAC,CAAA;AAAA,IACnB,CAAA;AACA,IAAA,uBACEC,cAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAWC,QAAA,CAAG,qEAAA,EAAuE,SAAS,CAAA;AAAA,QAC7F,GAAG,KAAA;AAAA,QAEJ,QAAA,kBAAAD,cAAA,CAAC,UAAA,CAAW,QAAA,EAAX,EAAoB,KAAA,EAAO,EAAE,KAAA,EAAO,OAAA,EAAS,QAAA,EAAS,EAAI,QAAA,EAAS;AAAA;AAAA,KACtE;AAAA,EAEJ;AACF;AACA,gBAAA,CAAiB,WAAA,GAAc,kBAAA;AASxB,IAAM,oBAAA,GAA6BD,gBAAA,CAAA,UAAA;AAAA,EACxC,CAAC,EAAE,KAAA,EAAO,IAAA,EAAM,OAAO,SAAA,EAAW,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AACpD,IAAA,MAAM,GAAA,GAAYA,4BAAW,UAAU,CAAA;AACvC,IAAA,IAAI,CAAC,GAAA,EAAK,MAAM,IAAI,MAAM,6DAA6D,CAAA;AACvF,IAAA,MAAM,MAAA,GAAS,IAAI,KAAA,KAAU,KAAA;AAC7B,IAAA,uBACEG,eAAA;AAAA,MAAC,QAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,IAAA,EAAK,QAAA;AAAA,QACL,cAAA,EAAc,SAAS,MAAA,GAAS,MAAA;AAAA,QAChC,OAAA,EAAS,MAAM,GAAA,CAAI,QAAA,CAAS,KAAK,CAAA;AAAA,QACjC,SAAA,EAAWD,QAAA;AAAA,UACT,qFAAA;AAAA,UACA;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEJ,QAAA,EAAA;AAAA,0BAAAD,cAAA;AAAA,YAAC,MAAA;AAAA,YAAA;AAAA,cACC,SAAA,EAAWC,QAAA;AAAA,gBACT,kHAAA;AAAA,gBACA,uHAAA;AAAA,gBACA,6EAAA;AAAA,gBACA,SAAS,0DAAA,GAA6D;AAAA,eACxE;AAAA,cAEA,QAAA,kBAAAD,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,UAAA,EAAY,QAAA,EAAA,IAAA,EAAK;AAAA;AAAA,WACnC;AAAA,0BACAA,cAAA,CAAC,UAAK,SAAA,EAAWC,QAAA,CAAG,uBAAuB,MAAA,GAAS,oBAAA,GAAuB,4BAA4B,CAAA,EACpG,QAAA,EAAA,KAAA,EACH;AAAA;AAAA;AAAA,KACF;AAAA,EAEJ;AACF;AACA,oBAAA,CAAqB,WAAA,GAAc,sBAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\ninterface NavContextValue {\n  value: string | undefined;\n  setValue: (v: string) => void;\n}\nconst NavContext = React.createContext<NavContextValue | null>(null);\n\nexport interface Md3NavigationBarProps\n  extends Omit<React.HTMLAttributes<HTMLElement>, \"defaultValue\"> {\n  value?: string;\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n}\n\n/** A Material Design 3 bottom navigation bar. Compose with Md3NavigationBarItem. */\nexport const Md3NavigationBar = React.forwardRef<HTMLElement, Md3NavigationBarProps>(\n  ({ value, defaultValue, onValueChange, className, children, ...props }, ref) => {\n    const isControlled = value !== undefined;\n    const [internal, setInternal] = React.useState(defaultValue);\n    const current = isControlled ? value : internal;\n    const setValue = (v: string) => {\n      if (!isControlled) setInternal(v);\n      onValueChange?.(v);\n    };\n    return (\n      <nav\n        ref={ref}\n        className={cn(\"flex h-20 items-stretch justify-around bg-md-surface-container px-2\", className)}\n        {...props}\n      >\n        <NavContext.Provider value={{ value: current, setValue }}>{children}</NavContext.Provider>\n      </nav>\n    );\n  },\n);\nMd3NavigationBar.displayName = \"Md3NavigationBar\";\n\nexport interface Md3NavigationBarItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  value: string;\n  icon: React.ReactNode;\n  label: React.ReactNode;\n}\n\n/** A destination in a {@link Md3NavigationBar}. */\nexport const Md3NavigationBarItem = React.forwardRef<HTMLButtonElement, Md3NavigationBarItemProps>(\n  ({ value, icon, label, className, ...props }, ref) => {\n    const ctx = React.useContext(NavContext);\n    if (!ctx) throw new Error(\"Md3NavigationBarItem must be used within a Md3NavigationBar\");\n    const active = ctx.value === value;\n    return (\n      <button\n        ref={ref}\n        type=\"button\"\n        aria-current={active ? \"page\" : undefined}\n        onClick={() => ctx.setValue(value)}\n        className={cn(\n          \"group flex flex-1 flex-col items-center justify-center gap-1 pt-3 pb-2 outline-none\",\n          className,\n        )}\n        {...props}\n      >\n        <span\n          className={cn(\n            \"relative flex h-8 w-16 items-center justify-center overflow-hidden rounded-full transition-colors [&_svg]:size-6\",\n            \"before:absolute before:inset-0 before:bg-md-on-surface before:opacity-0 before:transition-opacity before:content-['']\",\n            \"group-hover:before:opacity-[0.08] group-focus-visible:before:opacity-[0.12]\",\n            active ? \"bg-md-secondary-container text-md-on-secondary-container\" : \"text-md-on-surface-variant\",\n          )}\n        >\n          <span className=\"relative\">{icon}</span>\n        </span>\n        <span className={cn(\"text-xs font-medium\", active ? \"text-md-on-surface\" : \"text-md-on-surface-variant\")}>\n          {label}\n        </span>\n      </button>\n    );\n  },\n);\nMd3NavigationBarItem.displayName = \"Md3NavigationBarItem\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,18 @@
+import * as React from 'react';
+
+interface Md3NavigationBarProps extends Omit<React.HTMLAttributes<HTMLElement>, "defaultValue"> {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+}
+/** A Material Design 3 bottom navigation bar. Compose with Md3NavigationBarItem. */
+declare const Md3NavigationBar: React.ForwardRefExoticComponent<Md3NavigationBarProps & React.RefAttributes<HTMLElement>>;
+interface Md3NavigationBarItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    value: string;
+    icon: React.ReactNode;
+    label: React.ReactNode;
+}
+/** A destination in a {@link Md3NavigationBar}. */
+declare const Md3NavigationBarItem: React.ForwardRefExoticComponent<Md3NavigationBarItemProps & React.RefAttributes<HTMLButtonElement>>;
+
+export { Md3NavigationBar, Md3NavigationBarItem, type Md3NavigationBarItemProps, type Md3NavigationBarProps };

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import * as React from 'react';
+
+interface Md3NavigationBarProps extends Omit<React.HTMLAttributes<HTMLElement>, "defaultValue"> {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+}
+/** A Material Design 3 bottom navigation bar. Compose with Md3NavigationBarItem. */
+declare const Md3NavigationBar: React.ForwardRefExoticComponent<Md3NavigationBarProps & React.RefAttributes<HTMLElement>>;
+interface Md3NavigationBarItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    value: string;
+    icon: React.ReactNode;
+    label: React.ReactNode;
+}
+/** A destination in a {@link Md3NavigationBar}. */
+declare const Md3NavigationBarItem: React.ForwardRefExoticComponent<Md3NavigationBarItemProps & React.RefAttributes<HTMLButtonElement>>;
+
+export { Md3NavigationBar, Md3NavigationBarItem, type Md3NavigationBarItemProps, type Md3NavigationBarProps };

package/dist/index.js

@@ -0,0 +1,69 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+// src/index.tsx
+var NavContext = React.createContext(null);
+var Md3NavigationBar = React.forwardRef(
+  ({ value, defaultValue, onValueChange, className, children, ...props }, ref) => {
+    const isControlled = value !== void 0;
+    const [internal, setInternal] = React.useState(defaultValue);
+    const current = isControlled ? value : internal;
+    const setValue = (v) => {
+      if (!isControlled) setInternal(v);
+      onValueChange?.(v);
+    };
+    return /* @__PURE__ */ jsx(
+      "nav",
+      {
+        ref,
+        className: cn("flex h-20 items-stretch justify-around bg-md-surface-container px-2", className),
+        ...props,
+        children: /* @__PURE__ */ jsx(NavContext.Provider, { value: { value: current, setValue }, children })
+      }
+    );
+  }
+);
+Md3NavigationBar.displayName = "Md3NavigationBar";
+var Md3NavigationBarItem = React.forwardRef(
+  ({ value, icon, label, className, ...props }, ref) => {
+    const ctx = React.useContext(NavContext);
+    if (!ctx) throw new Error("Md3NavigationBarItem must be used within a Md3NavigationBar");
+    const active = ctx.value === value;
+    return /* @__PURE__ */ jsxs(
+      "button",
+      {
+        ref,
+        type: "button",
+        "aria-current": active ? "page" : void 0,
+        onClick: () => ctx.setValue(value),
+        className: cn(
+          "group flex flex-1 flex-col items-center justify-center gap-1 pt-3 pb-2 outline-none",
+          className
+        ),
+        ...props,
+        children: [
+          /* @__PURE__ */ jsx(
+            "span",
+            {
+              className: cn(
+                "relative flex h-8 w-16 items-center justify-center overflow-hidden rounded-full transition-colors [&_svg]:size-6",
+                "before:absolute before:inset-0 before:bg-md-on-surface before:opacity-0 before:transition-opacity before:content-['']",
+                "group-hover:before:opacity-[0.08] group-focus-visible:before:opacity-[0.12]",
+                active ? "bg-md-secondary-container text-md-on-secondary-container" : "text-md-on-surface-variant"
+              ),
+              children: /* @__PURE__ */ jsx("span", { className: "relative", children: icon })
+            }
+          ),
+          /* @__PURE__ */ jsx("span", { className: cn("text-xs font-medium", active ? "text-md-on-surface" : "text-md-on-surface-variant"), children: label })
+        ]
+      }
+    );
+  }
+);
+Md3NavigationBarItem.displayName = "Md3NavigationBarItem";
+
+export { Md3NavigationBar, Md3NavigationBarItem };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;AAOA,IAAM,UAAA,GAAmB,oBAAsC,IAAI,CAAA;AAU5D,IAAM,gBAAA,GAAyB,KAAA,CAAA,UAAA;AAAA,EACpC,CAAC,EAAE,KAAA,EAAO,YAAA,EAAc,aAAA,EAAe,WAAW,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AAC9E,IAAA,MAAM,eAAe,KAAA,KAAU,MAAA;AAC/B,IAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAU,eAAS,YAAY,CAAA;AAC3D,IAAA,MAAM,OAAA,GAAU,eAAe,KAAA,GAAQ,QAAA;AACvC,IAAA,MAAM,QAAA,GAAW,CAAC,CAAA,KAAc;AAC9B,MAAA,IAAI,CAAC,YAAA,EAAc,WAAA,CAAY,CAAC,CAAA;AAChC,MAAA,aAAA,GAAgB,CAAC,CAAA;AAAA,IACnB,CAAA;AACA,IAAA,uBACE,GAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAW,EAAA,CAAG,qEAAA,EAAuE,SAAS,CAAA;AAAA,QAC7F,GAAG,KAAA;AAAA,QAEJ,QAAA,kBAAA,GAAA,CAAC,UAAA,CAAW,QAAA,EAAX,EAAoB,KAAA,EAAO,EAAE,KAAA,EAAO,OAAA,EAAS,QAAA,EAAS,EAAI,QAAA,EAAS;AAAA;AAAA,KACtE;AAAA,EAEJ;AACF;AACA,gBAAA,CAAiB,WAAA,GAAc,kBAAA;AASxB,IAAM,oBAAA,GAA6B,KAAA,CAAA,UAAA;AAAA,EACxC,CAAC,EAAE,KAAA,EAAO,IAAA,EAAM,OAAO,SAAA,EAAW,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AACpD,IAAA,MAAM,GAAA,GAAY,iBAAW,UAAU,CAAA;AACvC,IAAA,IAAI,CAAC,GAAA,EAAK,MAAM,IAAI,MAAM,6DAA6D,CAAA;AACvF,IAAA,MAAM,MAAA,GAAS,IAAI,KAAA,KAAU,KAAA;AAC7B,IAAA,uBACE,IAAA;AAAA,MAAC,QAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,IAAA,EAAK,QAAA;AAAA,QACL,cAAA,EAAc,SAAS,MAAA,GAAS,MAAA;AAAA,QAChC,OAAA,EAAS,MAAM,GAAA,CAAI,QAAA,CAAS,KAAK,CAAA;AAAA,QACjC,SAAA,EAAW,EAAA;AAAA,UACT,qFAAA;AAAA,UACA;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEJ,QAAA,EAAA;AAAA,0BAAA,GAAA;AAAA,YAAC,MAAA;AAAA,YAAA;AAAA,cACC,SAAA,EAAW,EAAA;AAAA,gBACT,kHAAA;AAAA,gBACA,uHAAA;AAAA,gBACA,6EAAA;AAAA,gBACA,SAAS,0DAAA,GAA6D;AAAA,eACxE;AAAA,cAEA,QAAA,kBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,UAAA,EAAY,QAAA,EAAA,IAAA,EAAK;AAAA;AAAA,WACnC;AAAA,0BACA,GAAA,CAAC,UAAK,SAAA,EAAW,EAAA,CAAG,uBAAuB,MAAA,GAAS,oBAAA,GAAuB,4BAA4B,CAAA,EACpG,QAAA,EAAA,KAAA,EACH;AAAA;AAAA;AAAA,KACF;AAAA,EAEJ;AACF;AACA,oBAAA,CAAqB,WAAA,GAAc,sBAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\ninterface NavContextValue {\n  value: string | undefined;\n  setValue: (v: string) => void;\n}\nconst NavContext = React.createContext<NavContextValue | null>(null);\n\nexport interface Md3NavigationBarProps\n  extends Omit<React.HTMLAttributes<HTMLElement>, \"defaultValue\"> {\n  value?: string;\n  defaultValue?: string;\n  onValueChange?: (value: string) => void;\n}\n\n/** A Material Design 3 bottom navigation bar. Compose with Md3NavigationBarItem. */\nexport const Md3NavigationBar = React.forwardRef<HTMLElement, Md3NavigationBarProps>(\n  ({ value, defaultValue, onValueChange, className, children, ...props }, ref) => {\n    const isControlled = value !== undefined;\n    const [internal, setInternal] = React.useState(defaultValue);\n    const current = isControlled ? value : internal;\n    const setValue = (v: string) => {\n      if (!isControlled) setInternal(v);\n      onValueChange?.(v);\n    };\n    return (\n      <nav\n        ref={ref}\n        className={cn(\"flex h-20 items-stretch justify-around bg-md-surface-container px-2\", className)}\n        {...props}\n      >\n        <NavContext.Provider value={{ value: current, setValue }}>{children}</NavContext.Provider>\n      </nav>\n    );\n  },\n);\nMd3NavigationBar.displayName = \"Md3NavigationBar\";\n\nexport interface Md3NavigationBarItemProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  value: string;\n  icon: React.ReactNode;\n  label: React.ReactNode;\n}\n\n/** A destination in a {@link Md3NavigationBar}. */\nexport const Md3NavigationBarItem = React.forwardRef<HTMLButtonElement, Md3NavigationBarItemProps>(\n  ({ value, icon, label, className, ...props }, ref) => {\n    const ctx = React.useContext(NavContext);\n    if (!ctx) throw new Error(\"Md3NavigationBarItem must be used within a Md3NavigationBar\");\n    const active = ctx.value === value;\n    return (\n      <button\n        ref={ref}\n        type=\"button\"\n        aria-current={active ? \"page\" : undefined}\n        onClick={() => ctx.setValue(value)}\n        className={cn(\n          \"group flex flex-1 flex-col items-center justify-center gap-1 pt-3 pb-2 outline-none\",\n          className,\n        )}\n        {...props}\n      >\n        <span\n          className={cn(\n            \"relative flex h-8 w-16 items-center justify-center overflow-hidden rounded-full transition-colors [&_svg]:size-6\",\n            \"before:absolute before:inset-0 before:bg-md-on-surface before:opacity-0 before:transition-opacity before:content-['']\",\n            \"group-hover:before:opacity-[0.08] group-focus-visible:before:opacity-[0.12]\",\n            active ? \"bg-md-secondary-container text-md-on-secondary-container\" : \"text-md-on-surface-variant\",\n          )}\n        >\n          <span className=\"relative\">{icon}</span>\n        </span>\n        <span className={cn(\"text-xs font-medium\", active ? \"text-md-on-surface\" : \"text-md-on-surface-variant\")}>\n          {label}\n        </span>\n      </button>\n    );\n  },\n);\nMd3NavigationBarItem.displayName = \"Md3NavigationBarItem\";\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nucleux/md3-navigation-bar",
+  "version": "0.3.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Material 3 bottom navigation bar — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "md3-navigation-bar"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "dependencies": {
+    "@nucleux/utils": "0.3.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "@types/react": "^18.3.18",
+    "react": "^18.3.1",
+    "lucide-react": "^0.469.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligaia-open-labs/nucleux.git",
+    "directory": "packages/md3-navigation-bar"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
+}