@nucleux/md3-list 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-list
+
+Material 3 list — 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-list @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { Md3List } from "@nucleux/md3-list";
+```
+
+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,73 @@
+"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 Md3List = React__namespace.forwardRef(
+  ({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, role: "list", className: utils.cn("bg-md-surface py-2 text-md-on-surface", className), ...props })
+);
+Md3List.displayName = "Md3List";
+var Md3ListItem = React__namespace.forwardRef(
+  ({ headline, supportingText, leading, trailing, interactive = false, className, onClick, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      ref,
+      role: interactive ? "button" : "listitem",
+      tabIndex: interactive ? 0 : void 0,
+      onClick,
+      onKeyDown: interactive ? (e) => {
+        if (e.key === "Enter" || e.key === " ") {
+          e.preventDefault();
+          e.currentTarget.click();
+        }
+      } : void 0,
+      className: utils.cn(
+        "relative flex items-center gap-4 overflow-hidden px-4 py-3 text-left",
+        interactive && [
+          "cursor-pointer outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-md-primary",
+          "before:absolute before:inset-0 before:bg-md-on-surface before:opacity-0 before:transition-opacity before:content-['']",
+          "hover:before:opacity-[0.08] active:before:opacity-[0.12]"
+        ],
+        className
+      ),
+      ...props,
+      children: [
+        leading && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "relative shrink-0 text-md-on-surface-variant [&_svg]:size-6", children: leading }),
+        /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "relative min-w-0 flex-1", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "block truncate text-md-on-surface", children: headline }),
+          supportingText && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "block truncate text-sm text-md-on-surface-variant", children: supportingText })
+        ] }),
+        trailing && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "relative shrink-0 text-md-on-surface-variant", children: trailing })
+      ]
+    }
+  )
+);
+Md3ListItem.displayName = "Md3ListItem";
+
+exports.Md3List = Md3List;
+exports.Md3ListItem = Md3ListItem;
+//# 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":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAIO,IAAM,OAAA,GAAgBA,gBAAA,CAAA,UAAA;AAAA,EAC3B,CAAC,EAAE,SAAA,EAAW,GAAG,KAAA,EAAM,EAAG,wBACxBC,cAAA,CAAC,KAAA,EAAA,EAAI,GAAA,EAAU,IAAA,EAAK,QAAO,SAAA,EAAWC,QAAA,CAAG,yCAAyC,SAAS,CAAA,EAAI,GAAG,KAAA,EAAO;AAE7G;AACA,OAAA,CAAQ,WAAA,GAAc,SAAA;AAYf,IAAM,WAAA,GAAoBF,gBAAA,CAAA,UAAA;AAAA,EAC/B,CAAC,EAAE,QAAA,EAAU,cAAA,EAAgB,OAAA,EAAS,QAAA,EAAU,WAAA,GAAc,KAAA,EAAO,SAAA,EAAW,OAAA,EAAS,GAAG,KAAA,IAAS,GAAA,qBACnGG,eAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACC,GAAA;AAAA,MACA,IAAA,EAAM,cAAc,QAAA,GAAW,UAAA;AAAA,MAC/B,QAAA,EAAU,cAAc,CAAA,GAAI,MAAA;AAAA,MAC5B,OAAA;AAAA,MACA,SAAA,EACE,WAAA,GACI,CAAC,CAAA,KAAM;AACL,QAAA,IAAI,CAAA,CAAE,GAAA,KAAQ,OAAA,IAAW,CAAA,CAAE,QAAQ,GAAA,EAAK;AACtC,UAAA,CAAA,CAAE,cAAA,EAAe;AACjB,UAAC,CAAA,CAAE,cAAiC,KAAA,EAAM;AAAA,QAC5C;AAAA,MACF,CAAA,GACA,MAAA;AAAA,MAEN,SAAA,EAAWD,QAAA;AAAA,QACT,sEAAA;AAAA,QACA,WAAA,IAAe;AAAA,UACb,yGAAA;AAAA,UACA,uHAAA;AAAA,UACA;AAAA,SACF;AAAA,QACA;AAAA,OACF;AAAA,MACC,GAAG,KAAA;AAAA,MAEH,QAAA,EAAA;AAAA,QAAA,OAAA,oBAAWD,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,6DAAA,EAA+D,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,wBACnGE,eAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,yBAAA,EACd,QAAA,EAAA;AAAA,0BAAAF,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,mCAAA,EAAqC,QAAA,EAAA,QAAA,EAAS,CAAA;AAAA,UAC7D,cAAA,oBACCA,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,qDAAqD,QAAA,EAAA,cAAA,EAAe;AAAA,SAAA,EAExF,CAAA;AAAA,QACC,QAAA,oBAAYA,cAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,gDAAgD,QAAA,EAAA,QAAA,EAAS;AAAA;AAAA;AAAA;AAG5F;AACA,WAAA,CAAY,WAAA,GAAc,aAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\n/** A Material Design 3 list container. Compose with Md3ListItem. */\nexport const Md3List = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(\n  ({ className, ...props }, ref) => (\n    <div ref={ref} role=\"list\" className={cn(\"bg-md-surface py-2 text-md-on-surface\", className)} {...props} />\n  ),\n);\nMd3List.displayName = \"Md3List\";\n\nexport 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}\n\n/** A row in a {@link Md3List} (one- or two-line, with leading/trailing slots). */\nexport const Md3ListItem = React.forwardRef<HTMLDivElement, Md3ListItemProps>(\n  ({ headline, supportingText, leading, trailing, interactive = false, className, onClick, ...props }, ref) => (\n    <div\n      ref={ref}\n      role={interactive ? \"button\" : \"listitem\"}\n      tabIndex={interactive ? 0 : undefined}\n      onClick={onClick}\n      onKeyDown={\n        interactive\n          ? (e) => {\n              if (e.key === \"Enter\" || e.key === \" \") {\n                e.preventDefault();\n                (e.currentTarget as HTMLDivElement).click();\n              }\n            }\n          : undefined\n      }\n      className={cn(\n        \"relative flex items-center gap-4 overflow-hidden px-4 py-3 text-left\",\n        interactive && [\n          \"cursor-pointer outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-md-primary\",\n          \"before:absolute before:inset-0 before:bg-md-on-surface before:opacity-0 before:transition-opacity before:content-['']\",\n          \"hover:before:opacity-[0.08] active:before:opacity-[0.12]\",\n        ],\n        className,\n      )}\n      {...props}\n    >\n      {leading && <span className=\"relative shrink-0 text-md-on-surface-variant [&_svg]:size-6\">{leading}</span>}\n      <span className=\"relative min-w-0 flex-1\">\n        <span className=\"block truncate text-md-on-surface\">{headline}</span>\n        {supportingText && (\n          <span className=\"block truncate text-sm text-md-on-surface-variant\">{supportingText}</span>\n        )}\n      </span>\n      {trailing && <span className=\"relative shrink-0 text-md-on-surface-variant\">{trailing}</span>}\n    </div>\n  ),\n);\nMd3ListItem.displayName = \"Md3ListItem\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+
+/** A Material Design 3 list container. Compose with Md3ListItem. */
+declare const Md3List: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+interface Md3ListItemProps extends React.HTMLAttributes<HTMLDivElement> {
+    headline: React.ReactNode;
+    supportingText?: React.ReactNode;
+    leading?: React.ReactNode;
+    trailing?: React.ReactNode;
+    /** Add a hover/press state layer + role="button" for actionable rows. */
+    interactive?: boolean;
+}
+/** A row in a {@link Md3List} (one- or two-line, with leading/trailing slots). */
+declare const Md3ListItem: React.ForwardRefExoticComponent<Md3ListItemProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Md3List, Md3ListItem, type Md3ListItemProps };

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+
+/** A Material Design 3 list container. Compose with Md3ListItem. */
+declare const Md3List: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+interface Md3ListItemProps extends React.HTMLAttributes<HTMLDivElement> {
+    headline: React.ReactNode;
+    supportingText?: React.ReactNode;
+    leading?: React.ReactNode;
+    trailing?: React.ReactNode;
+    /** Add a hover/press state layer + role="button" for actionable rows. */
+    interactive?: boolean;
+}
+/** A row in a {@link Md3List} (one- or two-line, with leading/trailing slots). */
+declare const Md3ListItem: React.ForwardRefExoticComponent<Md3ListItemProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Md3List, Md3ListItem, type Md3ListItemProps };

package/dist/index.js

@@ -0,0 +1,50 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+// src/index.tsx
+var Md3List = React.forwardRef(
+  ({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, role: "list", className: cn("bg-md-surface py-2 text-md-on-surface", className), ...props })
+);
+Md3List.displayName = "Md3List";
+var Md3ListItem = React.forwardRef(
+  ({ headline, supportingText, leading, trailing, interactive = false, className, onClick, ...props }, ref) => /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ref,
+      role: interactive ? "button" : "listitem",
+      tabIndex: interactive ? 0 : void 0,
+      onClick,
+      onKeyDown: interactive ? (e) => {
+        if (e.key === "Enter" || e.key === " ") {
+          e.preventDefault();
+          e.currentTarget.click();
+        }
+      } : void 0,
+      className: cn(
+        "relative flex items-center gap-4 overflow-hidden px-4 py-3 text-left",
+        interactive && [
+          "cursor-pointer outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-md-primary",
+          "before:absolute before:inset-0 before:bg-md-on-surface before:opacity-0 before:transition-opacity before:content-['']",
+          "hover:before:opacity-[0.08] active:before:opacity-[0.12]"
+        ],
+        className
+      ),
+      ...props,
+      children: [
+        leading && /* @__PURE__ */ jsx("span", { className: "relative shrink-0 text-md-on-surface-variant [&_svg]:size-6", children: leading }),
+        /* @__PURE__ */ jsxs("span", { className: "relative min-w-0 flex-1", children: [
+          /* @__PURE__ */ jsx("span", { className: "block truncate text-md-on-surface", children: headline }),
+          supportingText && /* @__PURE__ */ jsx("span", { className: "block truncate text-sm text-md-on-surface-variant", children: supportingText })
+        ] }),
+        trailing && /* @__PURE__ */ jsx("span", { className: "relative shrink-0 text-md-on-surface-variant", children: trailing })
+      ]
+    }
+  )
+);
+Md3ListItem.displayName = "Md3ListItem";
+
+export { Md3List, Md3ListItem };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;AAIO,IAAM,OAAA,GAAgB,KAAA,CAAA,UAAA;AAAA,EAC3B,CAAC,EAAE,SAAA,EAAW,GAAG,KAAA,EAAM,EAAG,wBACxB,GAAA,CAAC,KAAA,EAAA,EAAI,GAAA,EAAU,IAAA,EAAK,QAAO,SAAA,EAAW,EAAA,CAAG,yCAAyC,SAAS,CAAA,EAAI,GAAG,KAAA,EAAO;AAE7G;AACA,OAAA,CAAQ,WAAA,GAAc,SAAA;AAYf,IAAM,WAAA,GAAoB,KAAA,CAAA,UAAA;AAAA,EAC/B,CAAC,EAAE,QAAA,EAAU,cAAA,EAAgB,OAAA,EAAS,QAAA,EAAU,WAAA,GAAc,KAAA,EAAO,SAAA,EAAW,OAAA,EAAS,GAAG,KAAA,IAAS,GAAA,qBACnG,IAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACC,GAAA;AAAA,MACA,IAAA,EAAM,cAAc,QAAA,GAAW,UAAA;AAAA,MAC/B,QAAA,EAAU,cAAc,CAAA,GAAI,MAAA;AAAA,MAC5B,OAAA;AAAA,MACA,SAAA,EACE,WAAA,GACI,CAAC,CAAA,KAAM;AACL,QAAA,IAAI,CAAA,CAAE,GAAA,KAAQ,OAAA,IAAW,CAAA,CAAE,QAAQ,GAAA,EAAK;AACtC,UAAA,CAAA,CAAE,cAAA,EAAe;AACjB,UAAC,CAAA,CAAE,cAAiC,KAAA,EAAM;AAAA,QAC5C;AAAA,MACF,CAAA,GACA,MAAA;AAAA,MAEN,SAAA,EAAW,EAAA;AAAA,QACT,sEAAA;AAAA,QACA,WAAA,IAAe;AAAA,UACb,yGAAA;AAAA,UACA,uHAAA;AAAA,UACA;AAAA,SACF;AAAA,QACA;AAAA,OACF;AAAA,MACC,GAAG,KAAA;AAAA,MAEH,QAAA,EAAA;AAAA,QAAA,OAAA,oBAAW,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,6DAAA,EAA+D,QAAA,EAAA,OAAA,EAAQ,CAAA;AAAA,wBACnG,IAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,yBAAA,EACd,QAAA,EAAA;AAAA,0BAAA,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,mCAAA,EAAqC,QAAA,EAAA,QAAA,EAAS,CAAA;AAAA,UAC7D,cAAA,oBACC,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,qDAAqD,QAAA,EAAA,cAAA,EAAe;AAAA,SAAA,EAExF,CAAA;AAAA,QACC,QAAA,oBAAY,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,gDAAgD,QAAA,EAAA,QAAA,EAAS;AAAA;AAAA;AAAA;AAG5F;AACA,WAAA,CAAY,WAAA,GAAc,aAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\n/** A Material Design 3 list container. Compose with Md3ListItem. */\nexport const Md3List = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(\n  ({ className, ...props }, ref) => (\n    <div ref={ref} role=\"list\" className={cn(\"bg-md-surface py-2 text-md-on-surface\", className)} {...props} />\n  ),\n);\nMd3List.displayName = \"Md3List\";\n\nexport 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}\n\n/** A row in a {@link Md3List} (one- or two-line, with leading/trailing slots). */\nexport const Md3ListItem = React.forwardRef<HTMLDivElement, Md3ListItemProps>(\n  ({ headline, supportingText, leading, trailing, interactive = false, className, onClick, ...props }, ref) => (\n    <div\n      ref={ref}\n      role={interactive ? \"button\" : \"listitem\"}\n      tabIndex={interactive ? 0 : undefined}\n      onClick={onClick}\n      onKeyDown={\n        interactive\n          ? (e) => {\n              if (e.key === \"Enter\" || e.key === \" \") {\n                e.preventDefault();\n                (e.currentTarget as HTMLDivElement).click();\n              }\n            }\n          : undefined\n      }\n      className={cn(\n        \"relative flex items-center gap-4 overflow-hidden px-4 py-3 text-left\",\n        interactive && [\n          \"cursor-pointer outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-md-primary\",\n          \"before:absolute before:inset-0 before:bg-md-on-surface before:opacity-0 before:transition-opacity before:content-['']\",\n          \"hover:before:opacity-[0.08] active:before:opacity-[0.12]\",\n        ],\n        className,\n      )}\n      {...props}\n    >\n      {leading && <span className=\"relative shrink-0 text-md-on-surface-variant [&_svg]:size-6\">{leading}</span>}\n      <span className=\"relative min-w-0 flex-1\">\n        <span className=\"block truncate text-md-on-surface\">{headline}</span>\n        {supportingText && (\n          <span className=\"block truncate text-sm text-md-on-surface-variant\">{supportingText}</span>\n        )}\n      </span>\n      {trailing && <span className=\"relative shrink-0 text-md-on-surface-variant\">{trailing}</span>}\n    </div>\n  ),\n);\nMd3ListItem.displayName = \"Md3ListItem\";\n"]}

package/package.json

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