@nucleux/md3-badge 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-badge
+
+Material 3 badge — 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-badge @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { Md3Badge } from "@nucleux/md3-badge";
+```
+
+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,62 @@
+"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 Md3Badge = React__namespace.forwardRef(
+  ({ content, max, className, children, ...props }, ref) => {
+    const isDot = content === void 0 || content === null;
+    let label = content;
+    if (!isDot && typeof content === "number" && max !== void 0 && content > max) {
+      label = `${max}+`;
+    }
+    const badge = /* @__PURE__ */ jsxRuntime.jsx(
+      "span",
+      {
+        ref,
+        className: utils.cn(
+          "z-10 inline-flex items-center justify-center rounded-full bg-md-error font-medium text-md-on-error",
+          isDot ? "h-1.5 w-1.5" : "h-4 min-w-4 px-1 text-[11px] leading-none",
+          children && "absolute -right-1 -top-1",
+          children && isDot && "right-0 top-0",
+          className
+        ),
+        ...props,
+        children: !isDot && label
+      }
+    );
+    if (!children) return badge;
+    return /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "relative inline-flex", children: [
+      children,
+      badge
+    ] });
+  }
+);
+Md3Badge.displayName = "Md3Badge";
+
+exports.Md3Badge = Md3Badge;
+//# 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":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAaO,IAAM,QAAA,GAAiBA,gBAAA,CAAA,UAAA;AAAA,EAC5B,CAAC,EAAE,OAAA,EAAS,GAAA,EAAK,WAAW,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AACxD,IAAA,MAAM,KAAA,GAAQ,OAAA,KAAY,MAAA,IAAa,OAAA,KAAY,IAAA;AACnD,IAAA,IAAI,KAAA,GAAQ,OAAA;AACZ,IAAA,IAAI,CAAC,SAAS,OAAO,OAAA,KAAY,YAAY,GAAA,KAAQ,MAAA,IAAa,UAAU,GAAA,EAAK;AAC/E,MAAA,KAAA,GAAQ,GAAG,GAAG,CAAA,CAAA,CAAA;AAAA,IAChB;AAEA,IAAA,MAAM,KAAA,mBACJC,cAAA;AAAA,MAAC,MAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAWC,QAAA;AAAA,UACT,oGAAA;AAAA,UACA,QAAQ,aAAA,GAAgB,2CAAA;AAAA,UACxB,QAAA,IAAY,0BAAA;AAAA,UACZ,YAAY,KAAA,IAAS,eAAA;AAAA,UACrB;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEH,WAAC,KAAA,IAAS;AAAA;AAAA,KACb;AAGF,IAAA,IAAI,CAAC,UAAU,OAAO,KAAA;AACtB,IAAA,uBACEC,eAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,sBAAA,EACb,QAAA,EAAA;AAAA,MAAA,QAAA;AAAA,MACA;AAAA,KAAA,EACH,CAAA;AAAA,EAEJ;AACF;AACA,QAAA,CAAS,WAAA,GAAc,UAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\nexport 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}\n\n/** A Material Design 3 badge — a small dot or a large numbered label. */\nexport const Md3Badge = React.forwardRef<HTMLSpanElement, Md3BadgeProps>(\n  ({ content, max, className, children, ...props }, ref) => {\n    const isDot = content === undefined || content === null;\n    let label = content;\n    if (!isDot && typeof content === \"number\" && max !== undefined && content > max) {\n      label = `${max}+`;\n    }\n\n    const badge = (\n      <span\n        ref={ref}\n        className={cn(\n          \"z-10 inline-flex items-center justify-center rounded-full bg-md-error font-medium text-md-on-error\",\n          isDot ? \"h-1.5 w-1.5\" : \"h-4 min-w-4 px-1 text-[11px] leading-none\",\n          children && \"absolute -right-1 -top-1\",\n          children && isDot && \"right-0 top-0\",\n          className,\n        )}\n        {...props}\n      >\n        {!isDot && label}\n      </span>\n    );\n\n    if (!children) return badge;\n    return (\n      <span className=\"relative inline-flex\">\n        {children}\n        {badge}\n      </span>\n    );\n  },\n);\nMd3Badge.displayName = \"Md3Badge\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+
+interface Md3BadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "content"> {
+    /** Numeric/text count. Omit for a small dot badge. */
+    content?: React.ReactNode;
+    /** Clamp numeric content, e.g. max=99 renders "99+". */
+    max?: number;
+    /** The element the badge is attached to (badge floats at its top-right). */
+    children?: React.ReactNode;
+}
+/** A Material Design 3 badge — a small dot or a large numbered label. */
+declare const Md3Badge: React.ForwardRefExoticComponent<Md3BadgeProps & React.RefAttributes<HTMLSpanElement>>;
+
+export { Md3Badge, type Md3BadgeProps };

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+
+interface Md3BadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "content"> {
+    /** Numeric/text count. Omit for a small dot badge. */
+    content?: React.ReactNode;
+    /** Clamp numeric content, e.g. max=99 renders "99+". */
+    max?: number;
+    /** The element the badge is attached to (badge floats at its top-right). */
+    children?: React.ReactNode;
+}
+/** A Material Design 3 badge — a small dot or a large numbered label. */
+declare const Md3Badge: React.ForwardRefExoticComponent<Md3BadgeProps & React.RefAttributes<HTMLSpanElement>>;
+
+export { Md3Badge, type Md3BadgeProps };

package/dist/index.js

@@ -0,0 +1,40 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+// src/index.tsx
+var Md3Badge = React.forwardRef(
+  ({ content, max, className, children, ...props }, ref) => {
+    const isDot = content === void 0 || content === null;
+    let label = content;
+    if (!isDot && typeof content === "number" && max !== void 0 && content > max) {
+      label = `${max}+`;
+    }
+    const badge = /* @__PURE__ */ jsx(
+      "span",
+      {
+        ref,
+        className: cn(
+          "z-10 inline-flex items-center justify-center rounded-full bg-md-error font-medium text-md-on-error",
+          isDot ? "h-1.5 w-1.5" : "h-4 min-w-4 px-1 text-[11px] leading-none",
+          children && "absolute -right-1 -top-1",
+          children && isDot && "right-0 top-0",
+          className
+        ),
+        ...props,
+        children: !isDot && label
+      }
+    );
+    if (!children) return badge;
+    return /* @__PURE__ */ jsxs("span", { className: "relative inline-flex", children: [
+      children,
+      badge
+    ] });
+  }
+);
+Md3Badge.displayName = "Md3Badge";
+
+export { Md3Badge };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;AAaO,IAAM,QAAA,GAAiB,KAAA,CAAA,UAAA;AAAA,EAC5B,CAAC,EAAE,OAAA,EAAS,GAAA,EAAK,WAAW,QAAA,EAAU,GAAG,KAAA,EAAM,EAAG,GAAA,KAAQ;AACxD,IAAA,MAAM,KAAA,GAAQ,OAAA,KAAY,MAAA,IAAa,OAAA,KAAY,IAAA;AACnD,IAAA,IAAI,KAAA,GAAQ,OAAA;AACZ,IAAA,IAAI,CAAC,SAAS,OAAO,OAAA,KAAY,YAAY,GAAA,KAAQ,MAAA,IAAa,UAAU,GAAA,EAAK;AAC/E,MAAA,KAAA,GAAQ,GAAG,GAAG,CAAA,CAAA,CAAA;AAAA,IAChB;AAEA,IAAA,MAAM,KAAA,mBACJ,GAAA;AAAA,MAAC,MAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAW,EAAA;AAAA,UACT,oGAAA;AAAA,UACA,QAAQ,aAAA,GAAgB,2CAAA;AAAA,UACxB,QAAA,IAAY,0BAAA;AAAA,UACZ,YAAY,KAAA,IAAS,eAAA;AAAA,UACrB;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEH,WAAC,KAAA,IAAS;AAAA;AAAA,KACb;AAGF,IAAA,IAAI,CAAC,UAAU,OAAO,KAAA;AACtB,IAAA,uBACE,IAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,sBAAA,EACb,QAAA,EAAA;AAAA,MAAA,QAAA;AAAA,MACA;AAAA,KAAA,EACH,CAAA;AAAA,EAEJ;AACF;AACA,QAAA,CAAS,WAAA,GAAc,UAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\nexport 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}\n\n/** A Material Design 3 badge — a small dot or a large numbered label. */\nexport const Md3Badge = React.forwardRef<HTMLSpanElement, Md3BadgeProps>(\n  ({ content, max, className, children, ...props }, ref) => {\n    const isDot = content === undefined || content === null;\n    let label = content;\n    if (!isDot && typeof content === \"number\" && max !== undefined && content > max) {\n      label = `${max}+`;\n    }\n\n    const badge = (\n      <span\n        ref={ref}\n        className={cn(\n          \"z-10 inline-flex items-center justify-center rounded-full bg-md-error font-medium text-md-on-error\",\n          isDot ? \"h-1.5 w-1.5\" : \"h-4 min-w-4 px-1 text-[11px] leading-none\",\n          children && \"absolute -right-1 -top-1\",\n          children && isDot && \"right-0 top-0\",\n          className,\n        )}\n        {...props}\n      >\n        {!isDot && label}\n      </span>\n    );\n\n    if (!children) return badge;\n    return (\n      <span className=\"relative inline-flex\">\n        {children}\n        {badge}\n      </span>\n    );\n  },\n);\nMd3Badge.displayName = \"Md3Badge\";\n"]}

package/package.json

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