@nucleux/md3-top-app-bar 0.4.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-top-app-bar
+
+Material 3 top app 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-top-app-bar @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { Md3TopAppBar } from "@nucleux/md3-top-app-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,69 @@
+"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 Md3TopAppBar = React__namespace.forwardRef(
+  ({ variant = "small", leading, trailing, headline, className, ...props }, ref) => {
+    const tall = variant === "medium" || variant === "large";
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "header",
+      {
+        ref,
+        className: utils.cn(
+          "flex w-full bg-md-surface text-md-on-surface",
+          tall ? "flex-col px-4 pb-6 pt-2" : "h-16 items-center gap-1 px-1",
+          variant === "medium" && "h-28",
+          variant === "large" && "h-36",
+          className
+        ),
+        ...props,
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { className: utils.cn("flex items-center gap-1", tall && "w-full"), children: [
+            leading && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "shrink-0", children: leading }),
+            !tall && /* @__PURE__ */ jsxRuntime.jsx(
+              "h1",
+              {
+                className: utils.cn(
+                  "flex-1 truncate text-xl",
+                  variant === "center" ? "text-center" : "px-1"
+                ),
+                children: headline
+              }
+            ),
+            trailing && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ml-auto flex shrink-0 items-center", children: trailing })
+          ] }),
+          tall && /* @__PURE__ */ jsxRuntime.jsx("h1", { className: utils.cn("mt-auto px-1 text-md-on-surface", variant === "large" ? "text-4xl" : "text-2xl"), children: headline })
+        ]
+      }
+    );
+  }
+);
+Md3TopAppBar.displayName = "Md3TopAppBar";
+
+exports.Md3TopAppBar = Md3TopAppBar;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["React","jsxs","cn","jsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBO,IAAM,YAAA,GAAqBA,gBAAA,CAAA,UAAA;AAAA,EAChC,CAAC,EAAE,OAAA,GAAU,OAAA,EAAS,OAAA,EAAS,QAAA,EAAU,QAAA,EAAU,SAAA,EAAW,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AAChF,IAAA,MAAM,IAAA,GAAO,OAAA,KAAY,QAAA,IAAY,OAAA,KAAY,OAAA;AAEjD,IAAA,uBACEC,eAAA;AAAA,MAAC,QAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAWC,QAAA;AAAA,UACT,8CAAA;AAAA,UACA,OAAO,yBAAA,GAA4B,8BAAA;AAAA,UACnC,YAAY,QAAA,IAAY,MAAA;AAAA,UACxB,YAAY,OAAA,IAAW,MAAA;AAAA,UACvB;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEJ,QAAA,EAAA;AAAA,0BAAAD,eAAA,CAAC,SAAI,SAAA,EAAWC,QAAA,CAAG,yBAAA,EAA2B,IAAA,IAAQ,QAAQ,CAAA,EAC3D,QAAA,EAAA;AAAA,YAAA,OAAA,oBAAWC,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,UAAA,EAAY,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,YAC/C,CAAC,IAAA,oBACAA,cAAA;AAAA,cAAC,IAAA;AAAA,cAAA;AAAA,gBACC,SAAA,EAAWD,QAAA;AAAA,kBACT,yBAAA;AAAA,kBACA,OAAA,KAAY,WAAW,aAAA,GAAgB;AAAA,iBACzC;AAAA,gBAEC,QAAA,EAAA;AAAA;AAAA,aACH;AAAA,YAED,QAAA,oBAAYC,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,sCAAsC,QAAA,EAAA,QAAA,EAAS;AAAA,WAAA,EAC9E,CAAA;AAAA,UACC,IAAA,oBACCA,cAAA,CAAC,IAAA,EAAA,EAAG,SAAA,EAAWD,QAAA,CAAG,iCAAA,EAAmC,OAAA,KAAY,OAAA,GAAU,UAAA,GAAa,UAAU,CAAA,EAC/F,QAAA,EAAA,QAAA,EACH;AAAA;AAAA;AAAA,KAEJ;AAAA,EAEJ;AACF;AACA,YAAA,CAAa,WAAA,GAAc,cAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\nexport type Md3TopAppBarVariant = \"small\" | \"center\" | \"medium\" | \"large\";\n\nexport 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}\n\n/** A Material Design 3 top app bar (small, center-aligned, medium, or large). */\nexport const Md3TopAppBar = React.forwardRef<HTMLElement, Md3TopAppBarProps>(\n  ({ variant = \"small\", leading, trailing, headline, className, ...props }, ref) => {\n    const tall = variant === \"medium\" || variant === \"large\";\n\n    return (\n      <header\n        ref={ref}\n        className={cn(\n          \"flex w-full bg-md-surface text-md-on-surface\",\n          tall ? \"flex-col px-4 pb-6 pt-2\" : \"h-16 items-center gap-1 px-1\",\n          variant === \"medium\" && \"h-28\",\n          variant === \"large\" && \"h-36\",\n          className,\n        )}\n        {...props}\n      >\n        <div className={cn(\"flex items-center gap-1\", tall && \"w-full\")}>\n          {leading && <span className=\"shrink-0\">{leading}</span>}\n          {!tall && (\n            <h1\n              className={cn(\n                \"flex-1 truncate text-xl\",\n                variant === \"center\" ? \"text-center\" : \"px-1\",\n              )}\n            >\n              {headline}\n            </h1>\n          )}\n          {trailing && <span className=\"ml-auto flex shrink-0 items-center\">{trailing}</span>}\n        </div>\n        {tall && (\n          <h1 className={cn(\"mt-auto px-1 text-md-on-surface\", variant === \"large\" ? \"text-4xl\" : \"text-2xl\")}>\n            {headline}\n          </h1>\n        )}\n      </header>\n    );\n  },\n);\nMd3TopAppBar.displayName = \"Md3TopAppBar\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+
+type Md3TopAppBarVariant = "small" | "center" | "medium" | "large";
+interface Md3TopAppBarProps extends React.HTMLAttributes<HTMLElement> {
+    variant?: Md3TopAppBarVariant;
+    /** Leading element (usually a navigation icon button). */
+    leading?: React.ReactNode;
+    /** Trailing action elements. */
+    trailing?: React.ReactNode;
+    /** The title text. */
+    headline: React.ReactNode;
+}
+/** A Material Design 3 top app bar (small, center-aligned, medium, or large). */
+declare const Md3TopAppBar: React.ForwardRefExoticComponent<Md3TopAppBarProps & React.RefAttributes<HTMLElement>>;
+
+export { Md3TopAppBar, type Md3TopAppBarProps, type Md3TopAppBarVariant };

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+
+type Md3TopAppBarVariant = "small" | "center" | "medium" | "large";
+interface Md3TopAppBarProps extends React.HTMLAttributes<HTMLElement> {
+    variant?: Md3TopAppBarVariant;
+    /** Leading element (usually a navigation icon button). */
+    leading?: React.ReactNode;
+    /** Trailing action elements. */
+    trailing?: React.ReactNode;
+    /** The title text. */
+    headline: React.ReactNode;
+}
+/** A Material Design 3 top app bar (small, center-aligned, medium, or large). */
+declare const Md3TopAppBar: React.ForwardRefExoticComponent<Md3TopAppBarProps & React.RefAttributes<HTMLElement>>;
+
+export { Md3TopAppBar, type Md3TopAppBarProps, type Md3TopAppBarVariant };

package/dist/index.js

@@ -0,0 +1,47 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var Md3TopAppBar = React.forwardRef(
+  ({ variant = "small", leading, trailing, headline, className, ...props }, ref) => {
+    const tall = variant === "medium" || variant === "large";
+    return /* @__PURE__ */ jsxs(
+      "header",
+      {
+        ref,
+        className: cn(
+          "flex w-full bg-md-surface text-md-on-surface",
+          tall ? "flex-col px-4 pb-6 pt-2" : "h-16 items-center gap-1 px-1",
+          variant === "medium" && "h-28",
+          variant === "large" && "h-36",
+          className
+        ),
+        ...props,
+        children: [
+          /* @__PURE__ */ jsxs("div", { className: cn("flex items-center gap-1", tall && "w-full"), children: [
+            leading && /* @__PURE__ */ jsx("span", { className: "shrink-0", children: leading }),
+            !tall && /* @__PURE__ */ jsx(
+              "h1",
+              {
+                className: cn(
+                  "flex-1 truncate text-xl",
+                  variant === "center" ? "text-center" : "px-1"
+                ),
+                children: headline
+              }
+            ),
+            trailing && /* @__PURE__ */ jsx("span", { className: "ml-auto flex shrink-0 items-center", children: trailing })
+          ] }),
+          tall && /* @__PURE__ */ jsx("h1", { className: cn("mt-auto px-1 text-md-on-surface", variant === "large" ? "text-4xl" : "text-2xl"), children: headline })
+        ]
+      }
+    );
+  }
+);
+Md3TopAppBar.displayName = "Md3TopAppBar";
+
+export { Md3TopAppBar };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;AAgBO,IAAM,YAAA,GAAqB,KAAA,CAAA,UAAA;AAAA,EAChC,CAAC,EAAE,OAAA,GAAU,OAAA,EAAS,OAAA,EAAS,QAAA,EAAU,QAAA,EAAU,SAAA,EAAW,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AAChF,IAAA,MAAM,IAAA,GAAO,OAAA,KAAY,QAAA,IAAY,OAAA,KAAY,OAAA;AAEjD,IAAA,uBACE,IAAA;AAAA,MAAC,QAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAW,EAAA;AAAA,UACT,8CAAA;AAAA,UACA,OAAO,yBAAA,GAA4B,8BAAA;AAAA,UACnC,YAAY,QAAA,IAAY,MAAA;AAAA,UACxB,YAAY,OAAA,IAAW,MAAA;AAAA,UACvB;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEJ,QAAA,EAAA;AAAA,0BAAA,IAAA,CAAC,SAAI,SAAA,EAAW,EAAA,CAAG,yBAAA,EAA2B,IAAA,IAAQ,QAAQ,CAAA,EAC3D,QAAA,EAAA;AAAA,YAAA,OAAA,oBAAW,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,UAAA,EAAY,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,YAC/C,CAAC,IAAA,oBACA,GAAA;AAAA,cAAC,IAAA;AAAA,cAAA;AAAA,gBACC,SAAA,EAAW,EAAA;AAAA,kBACT,yBAAA;AAAA,kBACA,OAAA,KAAY,WAAW,aAAA,GAAgB;AAAA,iBACzC;AAAA,gBAEC,QAAA,EAAA;AAAA;AAAA,aACH;AAAA,YAED,QAAA,oBAAY,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,sCAAsC,QAAA,EAAA,QAAA,EAAS;AAAA,WAAA,EAC9E,CAAA;AAAA,UACC,IAAA,oBACC,GAAA,CAAC,IAAA,EAAA,EAAG,SAAA,EAAW,EAAA,CAAG,iCAAA,EAAmC,OAAA,KAAY,OAAA,GAAU,UAAA,GAAa,UAAU,CAAA,EAC/F,QAAA,EAAA,QAAA,EACH;AAAA;AAAA;AAAA,KAEJ;AAAA,EAEJ;AACF;AACA,YAAA,CAAa,WAAA,GAAc,cAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\nexport type Md3TopAppBarVariant = \"small\" | \"center\" | \"medium\" | \"large\";\n\nexport 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}\n\n/** A Material Design 3 top app bar (small, center-aligned, medium, or large). */\nexport const Md3TopAppBar = React.forwardRef<HTMLElement, Md3TopAppBarProps>(\n  ({ variant = \"small\", leading, trailing, headline, className, ...props }, ref) => {\n    const tall = variant === \"medium\" || variant === \"large\";\n\n    return (\n      <header\n        ref={ref}\n        className={cn(\n          \"flex w-full bg-md-surface text-md-on-surface\",\n          tall ? \"flex-col px-4 pb-6 pt-2\" : \"h-16 items-center gap-1 px-1\",\n          variant === \"medium\" && \"h-28\",\n          variant === \"large\" && \"h-36\",\n          className,\n        )}\n        {...props}\n      >\n        <div className={cn(\"flex items-center gap-1\", tall && \"w-full\")}>\n          {leading && <span className=\"shrink-0\">{leading}</span>}\n          {!tall && (\n            <h1\n              className={cn(\n                \"flex-1 truncate text-xl\",\n                variant === \"center\" ? \"text-center\" : \"px-1\",\n              )}\n            >\n              {headline}\n            </h1>\n          )}\n          {trailing && <span className=\"ml-auto flex shrink-0 items-center\">{trailing}</span>}\n        </div>\n        {tall && (\n          <h1 className={cn(\"mt-auto px-1 text-md-on-surface\", variant === \"large\" ? \"text-4xl\" : \"text-2xl\")}>\n            {headline}\n          </h1>\n        )}\n      </header>\n    );\n  },\n);\nMd3TopAppBar.displayName = \"Md3TopAppBar\";\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nucleux/md3-top-app-bar",
+  "version": "0.4.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Material 3 top app bar — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "md3-top-app-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.4.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-top-app-bar"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "scripts": {
+    "build": "tsup"
+  }
+}