@nucleux/native-select 0.0.0-stage → 0.7.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

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# @nucleux/native-select
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Accessible native-backed select with a chevron — 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/native-select @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { NativeSelect } from "@nucleux/native-select";
+```
+
+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,61 @@
+"use client";
+'use strict';
+
+var React = require('react');
+var lucideReact = require('lucide-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 NativeSelect = React__namespace.forwardRef(
+  ({ className, containerClassName, children, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: utils.cn("relative inline-flex w-full", containerClassName), children: [
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "select",
+      {
+        ref,
+        className: utils.cn(
+          "h-9 w-full appearance-none rounded-lg border border-input bg-background pl-3 pr-8 text-sm text-foreground shadow-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50",
+          className
+        ),
+        ...props,
+        children
+      }
+    ),
+    /* @__PURE__ */ jsxRuntime.jsx(lucideReact.ChevronDown, { className: "pointer-events-none absolute right-2 top-1/2 size-4 -translate-y-1/2 text-muted-foreground" })
+  ] })
+);
+NativeSelect.displayName = "NativeSelect";
+var NativeSelectOption = React__namespace.forwardRef(
+  (props, ref) => /* @__PURE__ */ jsxRuntime.jsx("option", { ref, ...props })
+);
+NativeSelectOption.displayName = "NativeSelectOption";
+var NativeSelectOptGroup = React__namespace.forwardRef(
+  (props, ref) => /* @__PURE__ */ jsxRuntime.jsx("optgroup", { ref, ...props })
+);
+NativeSelectOptGroup.displayName = "NativeSelectOptGroup";
+
+exports.NativeSelect = NativeSelect;
+exports.NativeSelectOptGroup = NativeSelectOptGroup;
+exports.NativeSelectOption = NativeSelectOption;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":["React","cn","jsx","ChevronDown"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcO,IAAM,YAAA,GAAqBA,gBAAA,CAAA,UAAA;AAAA,EAChC,CAAC,EAAE,SAAA,EAAW,kBAAA,EAAoB,UAAU,GAAG,KAAA,EAAM,EAAG,GAAA,qCACrD,KAAA,EAAA,EAAI,SAAA,EAAWC,QAAA,CAAG,6BAAA,EAA+B,kBAAkB,CAAA,EAClE,QAAA,EAAA;AAAA,oBAAAC,cAAA;AAAA,MAAC,QAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAWD,QAAA;AAAA,UACT,+PAAA;AAAA,UACA;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEH;AAAA;AAAA,KACH;AAAA,oBACAC,cAAA,CAACC,uBAAA,EAAA,EAAY,SAAA,EAAU,4FAAA,EAA6F;AAAA,GAAA,EACtH;AAEJ;AACA,YAAA,CAAa,WAAA,GAAc,cAAA;AAGpB,IAAM,kBAAA,GAA2BH,gBAAA,CAAA,UAAA;AAAA,EACtC,CAAC,KAAA,EAAO,GAAA,oCAAS,QAAA,EAAA,EAAO,GAAA,EAAW,GAAG,KAAA,EAAO;AAC/C;AACA,kBAAA,CAAmB,WAAA,GAAc,oBAAA;AAG1B,IAAM,oBAAA,GAA6BA,gBAAA,CAAA,UAAA;AAAA,EACxC,CAAC,KAAA,EAAO,GAAA,oCAAS,UAAA,EAAA,EAAS,GAAA,EAAW,GAAG,KAAA,EAAO;AACjD;AACA,oBAAA,CAAqB,WAAA,GAAc,sBAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { ChevronDown } from \"lucide-react\";\nimport { cn } from \"@nucleux/utils\";\n\nexport interface NativeSelectProps extends React.SelectHTMLAttributes<HTMLSelectElement> {\n  /** Wrapper className (the chevron is positioned within it). */\n  containerClassName?: string;\n}\n\n/**\n * An accessible select built on the native `<select>` element (full keyboard +\n * screen-reader support), styled to match the design system with a chevron.\n * Pass `<option>`s as children.\n */\nexport const NativeSelect = React.forwardRef<HTMLSelectElement, NativeSelectProps>(\n  ({ className, containerClassName, children, ...props }, ref) => (\n    <div className={cn(\"relative inline-flex w-full\", containerClassName)}>\n      <select\n        ref={ref}\n        className={cn(\n          \"h-9 w-full appearance-none rounded-lg border border-input bg-background pl-3 pr-8 text-sm text-foreground shadow-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50\",\n          className,\n        )}\n        {...props}\n      >\n        {children}\n      </select>\n      <ChevronDown className=\"pointer-events-none absolute right-2 top-1/2 size-4 -translate-y-1/2 text-muted-foreground\" />\n    </div>\n  ),\n);\nNativeSelect.displayName = \"NativeSelect\";\n\n/** An `<option>` for NativeSelect. */\nexport const NativeSelectOption = React.forwardRef<HTMLOptionElement, React.OptionHTMLAttributes<HTMLOptionElement>>(\n  (props, ref) => <option ref={ref} {...props} />,\n);\nNativeSelectOption.displayName = \"NativeSelectOption\";\n\n/** An `<optgroup>` for NativeSelect. */\nexport const NativeSelectOptGroup = React.forwardRef<HTMLOptGroupElement, React.OptgroupHTMLAttributes<HTMLOptGroupElement>>(\n  (props, ref) => <optgroup ref={ref} {...props} />,\n);\nNativeSelectOptGroup.displayName = \"NativeSelectOptGroup\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,18 @@
+import * as React from 'react';
+
+interface NativeSelectProps extends React.SelectHTMLAttributes<HTMLSelectElement> {
+    /** Wrapper className (the chevron is positioned within it). */
+    containerClassName?: string;
+}
+/**
+ * An accessible select built on the native `<select>` element (full keyboard +
+ * screen-reader support), styled to match the design system with a chevron.
+ * Pass `<option>`s as children.
+ */
+declare const NativeSelect: React.ForwardRefExoticComponent<NativeSelectProps & React.RefAttributes<HTMLSelectElement>>;
+/** An `<option>` for NativeSelect. */
+declare const NativeSelectOption: React.ForwardRefExoticComponent<React.OptionHTMLAttributes<HTMLOptionElement> & React.RefAttributes<HTMLOptionElement>>;
+/** An `<optgroup>` for NativeSelect. */
+declare const NativeSelectOptGroup: React.ForwardRefExoticComponent<React.OptgroupHTMLAttributes<HTMLOptGroupElement> & React.RefAttributes<HTMLOptGroupElement>>;
+
+export { NativeSelect, NativeSelectOptGroup, NativeSelectOption, type NativeSelectProps };

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import * as React from 'react';
+
+interface NativeSelectProps extends React.SelectHTMLAttributes<HTMLSelectElement> {
+    /** Wrapper className (the chevron is positioned within it). */
+    containerClassName?: string;
+}
+/**
+ * An accessible select built on the native `<select>` element (full keyboard +
+ * screen-reader support), styled to match the design system with a chevron.
+ * Pass `<option>`s as children.
+ */
+declare const NativeSelect: React.ForwardRefExoticComponent<NativeSelectProps & React.RefAttributes<HTMLSelectElement>>;
+/** An `<option>` for NativeSelect. */
+declare const NativeSelectOption: React.ForwardRefExoticComponent<React.OptionHTMLAttributes<HTMLOptionElement> & React.RefAttributes<HTMLOptionElement>>;
+/** An `<optgroup>` for NativeSelect. */
+declare const NativeSelectOptGroup: React.ForwardRefExoticComponent<React.OptgroupHTMLAttributes<HTMLOptGroupElement> & React.RefAttributes<HTMLOptGroupElement>>;
+
+export { NativeSelect, NativeSelectOptGroup, NativeSelectOption, type NativeSelectProps };

package/dist/index.js

@@ -0,0 +1,37 @@
+"use client";
+import * as React from 'react';
+import { ChevronDown } from 'lucide-react';
+import { cn } from '@nucleux/utils';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var NativeSelect = React.forwardRef(
+  ({ className, containerClassName, children, ...props }, ref) => /* @__PURE__ */ jsxs("div", { className: cn("relative inline-flex w-full", containerClassName), children: [
+    /* @__PURE__ */ jsx(
+      "select",
+      {
+        ref,
+        className: cn(
+          "h-9 w-full appearance-none rounded-lg border border-input bg-background pl-3 pr-8 text-sm text-foreground shadow-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50",
+          className
+        ),
+        ...props,
+        children
+      }
+    ),
+    /* @__PURE__ */ jsx(ChevronDown, { className: "pointer-events-none absolute right-2 top-1/2 size-4 -translate-y-1/2 text-muted-foreground" })
+  ] })
+);
+NativeSelect.displayName = "NativeSelect";
+var NativeSelectOption = React.forwardRef(
+  (props, ref) => /* @__PURE__ */ jsx("option", { ref, ...props })
+);
+NativeSelectOption.displayName = "NativeSelectOption";
+var NativeSelectOptGroup = React.forwardRef(
+  (props, ref) => /* @__PURE__ */ jsx("optgroup", { ref, ...props })
+);
+NativeSelectOptGroup.displayName = "NativeSelectOptGroup";
+
+export { NativeSelect, NativeSelectOptGroup, NativeSelectOption };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;;AAcO,IAAM,YAAA,GAAqB,KAAA,CAAA,UAAA;AAAA,EAChC,CAAC,EAAE,SAAA,EAAW,kBAAA,EAAoB,UAAU,GAAG,KAAA,EAAM,EAAG,GAAA,0BACrD,KAAA,EAAA,EAAI,SAAA,EAAW,EAAA,CAAG,6BAAA,EAA+B,kBAAkB,CAAA,EAClE,QAAA,EAAA;AAAA,oBAAA,GAAA;AAAA,MAAC,QAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,SAAA,EAAW,EAAA;AAAA,UACT,+PAAA;AAAA,UACA;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEH;AAAA;AAAA,KACH;AAAA,oBACA,GAAA,CAAC,WAAA,EAAA,EAAY,SAAA,EAAU,4FAAA,EAA6F;AAAA,GAAA,EACtH;AAEJ;AACA,YAAA,CAAa,WAAA,GAAc,cAAA;AAGpB,IAAM,kBAAA,GAA2B,KAAA,CAAA,UAAA;AAAA,EACtC,CAAC,KAAA,EAAO,GAAA,yBAAS,QAAA,EAAA,EAAO,GAAA,EAAW,GAAG,KAAA,EAAO;AAC/C;AACA,kBAAA,CAAmB,WAAA,GAAc,oBAAA;AAG1B,IAAM,oBAAA,GAA6B,KAAA,CAAA,UAAA;AAAA,EACxC,CAAC,KAAA,EAAO,GAAA,yBAAS,UAAA,EAAA,EAAS,GAAA,EAAW,GAAG,KAAA,EAAO;AACjD;AACA,oBAAA,CAAqB,WAAA,GAAc,sBAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { ChevronDown } from \"lucide-react\";\nimport { cn } from \"@nucleux/utils\";\n\nexport interface NativeSelectProps extends React.SelectHTMLAttributes<HTMLSelectElement> {\n  /** Wrapper className (the chevron is positioned within it). */\n  containerClassName?: string;\n}\n\n/**\n * An accessible select built on the native `<select>` element (full keyboard +\n * screen-reader support), styled to match the design system with a chevron.\n * Pass `<option>`s as children.\n */\nexport const NativeSelect = React.forwardRef<HTMLSelectElement, NativeSelectProps>(\n  ({ className, containerClassName, children, ...props }, ref) => (\n    <div className={cn(\"relative inline-flex w-full\", containerClassName)}>\n      <select\n        ref={ref}\n        className={cn(\n          \"h-9 w-full appearance-none rounded-lg border border-input bg-background pl-3 pr-8 text-sm text-foreground shadow-sm transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50\",\n          className,\n        )}\n        {...props}\n      >\n        {children}\n      </select>\n      <ChevronDown className=\"pointer-events-none absolute right-2 top-1/2 size-4 -translate-y-1/2 text-muted-foreground\" />\n    </div>\n  ),\n);\nNativeSelect.displayName = \"NativeSelect\";\n\n/** An `<option>` for NativeSelect. */\nexport const NativeSelectOption = React.forwardRef<HTMLOptionElement, React.OptionHTMLAttributes<HTMLOptionElement>>(\n  (props, ref) => <option ref={ref} {...props} />,\n);\nNativeSelectOption.displayName = \"NativeSelectOption\";\n\n/** An `<optgroup>` for NativeSelect. */\nexport const NativeSelectOptGroup = React.forwardRef<HTMLOptGroupElement, React.OptgroupHTMLAttributes<HTMLOptGroupElement>>(\n  (props, ref) => <optgroup ref={ref} {...props} />,\n);\nNativeSelectOptGroup.displayName = \"NativeSelectOptGroup\";\n"]}

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@nucleux/native-select",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.7.0",
+  "type": "module",
+  "sideEffects": false,
+  "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.7.0",
+    "lucide-react": "^0.469.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "@types/react": "^18.3.18",
+    "react": "^18.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligaia-open-labs/nucleux.git",
+    "directory": "packages/native-select"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "description": "Styled native <select> — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "native-select"
+  ],
+  "scripts": {
+    "build": "tsup"
+  }
 }