@nucleux/switch 0.1.1

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/switch
+
+Accessible on/off toggle — 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/switch @nucleux/tokens
+```
+
+`react` / `react-dom` are peer dependencies.
+
+## Usage
+
+```tsx
+import { Switch } from "@nucleux/switch";
+```
+
+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,82 @@
+"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 track = {
+  sm: "h-4 w-7",
+  md: "h-5 w-9"
+};
+var thumb = {
+  sm: "size-3 data-[state=checked]:translate-x-[14px] data-[state=unchecked]:translate-x-0.5",
+  md: "size-4 data-[state=checked]:translate-x-[18px] data-[state=unchecked]:translate-x-0.5"
+};
+var Switch = React__namespace.forwardRef(
+  ({ checked, defaultChecked = false, onCheckedChange, size = "md", disabled, className, ...props }, ref) => {
+    const [internal, setInternal] = React__namespace.useState(defaultChecked);
+    const isControlled = checked != null;
+    const value = isControlled ? checked : internal;
+    const toggle = () => {
+      if (disabled) return;
+      if (!isControlled) setInternal(!value);
+      onCheckedChange?.(!value);
+    };
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "button",
+      {
+        ref,
+        type: "button",
+        role: "switch",
+        "aria-checked": value,
+        disabled,
+        "data-state": value ? "checked" : "unchecked",
+        onClick: toggle,
+        className: utils.cn(
+          "inline-flex shrink-0 cursor-pointer items-center rounded-full border-2 border-transparent transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:cursor-not-allowed disabled:opacity-50",
+          value ? "bg-primary" : "bg-input",
+          track[size],
+          className
+        ),
+        ...props,
+        children: /* @__PURE__ */ jsxRuntime.jsx(
+          "span",
+          {
+            "data-state": value ? "checked" : "unchecked",
+            className: utils.cn(
+              "pointer-events-none inline-block rounded-full bg-background shadow-sm ring-0 transition-transform",
+              thumb[size]
+            )
+          }
+        )
+      }
+    );
+  }
+);
+Switch.displayName = "Switch";
+
+exports.Switch = Switch;
+//# 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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,IAAM,KAAA,GAAoC;AAAA,EACxC,EAAA,EAAI,SAAA;AAAA,EACJ,EAAA,EAAI;AACN,CAAA;AACA,IAAM,KAAA,GAAoC;AAAA,EACxC,EAAA,EAAI,uFAAA;AAAA,EACJ,EAAA,EAAI;AACN,CAAA;AAGO,IAAM,MAAA,GAAeA,gBAAA,CAAA,UAAA;AAAA,EAC1B,CACE,EAAE,OAAA,EAAS,cAAA,GAAiB,KAAA,EAAO,eAAA,EAAiB,IAAA,GAAO,IAAA,EAAM,QAAA,EAAU,SAAA,EAAW,GAAG,KAAA,IACzF,GAAA,KACG;AACH,IAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAUA,0BAAS,cAAc,CAAA;AAC7D,IAAA,MAAM,eAAe,OAAA,IAAW,IAAA;AAChC,IAAA,MAAM,KAAA,GAAQ,eAAe,OAAA,GAAU,QAAA;AAEvC,IAAA,MAAM,SAAS,MAAM;AACnB,MAAA,IAAI,QAAA,EAAU;AACd,MAAA,IAAI,CAAC,YAAA,EAAc,WAAA,CAAY,CAAC,KAAK,CAAA;AACrC,MAAA,eAAA,GAAkB,CAAC,KAAK,CAAA;AAAA,IAC1B,CAAA;AAEA,IAAA,uBACEC,cAAA;AAAA,MAAC,QAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,IAAA,EAAK,QAAA;AAAA,QACL,IAAA,EAAK,QAAA;AAAA,QACL,cAAA,EAAc,KAAA;AAAA,QACd,QAAA;AAAA,QACA,YAAA,EAAY,QAAQ,SAAA,GAAY,WAAA;AAAA,QAChC,OAAA,EAAS,MAAA;AAAA,QACT,SAAA,EAAWC,QAAA;AAAA,UACT,sSAAA;AAAA,UACA,QAAQ,YAAA,GAAe,UAAA;AAAA,UACvB,MAAM,IAAI,CAAA;AAAA,UACV;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEJ,QAAA,kBAAAD,cAAA;AAAA,UAAC,MAAA;AAAA,UAAA;AAAA,YACC,YAAA,EAAY,QAAQ,SAAA,GAAY,WAAA;AAAA,YAChC,SAAA,EAAWC,QAAA;AAAA,cACT,mGAAA;AAAA,cACA,MAAM,IAAI;AAAA;AACZ;AAAA;AACF;AAAA,KACF;AAAA,EAEJ;AACF;AACA,MAAA,CAAO,WAAA,GAAc,QAAA","file":"index.cjs","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\nexport type SwitchSize = \"sm\" | \"md\";\n\nexport interface SwitchProps\n  extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, \"onChange\" | \"value\"> {\n  /** Controlled on/off state. */\n  checked?: boolean;\n  /** Initial state when uncontrolled. */\n  defaultChecked?: boolean;\n  /** Called with the next state when toggled. */\n  onCheckedChange?: (checked: boolean) => void;\n  size?: SwitchSize;\n}\n\nconst track: Record<SwitchSize, string> = {\n  sm: \"h-4 w-7\",\n  md: \"h-5 w-9\",\n};\nconst thumb: Record<SwitchSize, string> = {\n  sm: \"size-3 data-[state=checked]:translate-x-[14px] data-[state=unchecked]:translate-x-0.5\",\n  md: \"size-4 data-[state=checked]:translate-x-[18px] data-[state=unchecked]:translate-x-0.5\",\n};\n\n/** Accessible on/off toggle. Controlled via `checked`, or uncontrolled via `defaultChecked`. */\nexport const Switch = React.forwardRef<HTMLButtonElement, SwitchProps>(\n  (\n    { checked, defaultChecked = false, onCheckedChange, size = \"md\", disabled, className, ...props },\n    ref,\n  ) => {\n    const [internal, setInternal] = React.useState(defaultChecked);\n    const isControlled = checked != null;\n    const value = isControlled ? checked : internal;\n\n    const toggle = () => {\n      if (disabled) return;\n      if (!isControlled) setInternal(!value);\n      onCheckedChange?.(!value);\n    };\n\n    return (\n      <button\n        ref={ref}\n        type=\"button\"\n        role=\"switch\"\n        aria-checked={value}\n        disabled={disabled}\n        data-state={value ? \"checked\" : \"unchecked\"}\n        onClick={toggle}\n        className={cn(\n          \"inline-flex shrink-0 cursor-pointer items-center rounded-full border-2 border-transparent transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:cursor-not-allowed disabled:opacity-50\",\n          value ? \"bg-primary\" : \"bg-input\",\n          track[size],\n          className,\n        )}\n        {...props}\n      >\n        <span\n          data-state={value ? \"checked\" : \"unchecked\"}\n          className={cn(\n            \"pointer-events-none inline-block rounded-full bg-background shadow-sm ring-0 transition-transform\",\n            thumb[size],\n          )}\n        />\n      </button>\n    );\n  },\n);\nSwitch.displayName = \"Switch\";\n"]}

package/dist/index.d.cts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+
+type SwitchSize = "sm" | "md";
+interface SwitchProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onChange" | "value"> {
+    /** Controlled on/off state. */
+    checked?: boolean;
+    /** Initial state when uncontrolled. */
+    defaultChecked?: boolean;
+    /** Called with the next state when toggled. */
+    onCheckedChange?: (checked: boolean) => void;
+    size?: SwitchSize;
+}
+/** Accessible on/off toggle. Controlled via `checked`, or uncontrolled via `defaultChecked`. */
+declare const Switch: React.ForwardRefExoticComponent<SwitchProps & React.RefAttributes<HTMLButtonElement>>;
+
+export { Switch, type SwitchProps, type SwitchSize };

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+
+type SwitchSize = "sm" | "md";
+interface SwitchProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onChange" | "value"> {
+    /** Controlled on/off state. */
+    checked?: boolean;
+    /** Initial state when uncontrolled. */
+    defaultChecked?: boolean;
+    /** Called with the next state when toggled. */
+    onCheckedChange?: (checked: boolean) => void;
+    size?: SwitchSize;
+}
+/** Accessible on/off toggle. Controlled via `checked`, or uncontrolled via `defaultChecked`. */
+declare const Switch: React.ForwardRefExoticComponent<SwitchProps & React.RefAttributes<HTMLButtonElement>>;
+
+export { Switch, type SwitchProps, type SwitchSize };

package/dist/index.js

@@ -0,0 +1,60 @@
+"use client";
+import * as React from 'react';
+import { cn } from '@nucleux/utils';
+import { jsx } from 'react/jsx-runtime';
+
+// src/index.tsx
+var track = {
+  sm: "h-4 w-7",
+  md: "h-5 w-9"
+};
+var thumb = {
+  sm: "size-3 data-[state=checked]:translate-x-[14px] data-[state=unchecked]:translate-x-0.5",
+  md: "size-4 data-[state=checked]:translate-x-[18px] data-[state=unchecked]:translate-x-0.5"
+};
+var Switch = React.forwardRef(
+  ({ checked, defaultChecked = false, onCheckedChange, size = "md", disabled, className, ...props }, ref) => {
+    const [internal, setInternal] = React.useState(defaultChecked);
+    const isControlled = checked != null;
+    const value = isControlled ? checked : internal;
+    const toggle = () => {
+      if (disabled) return;
+      if (!isControlled) setInternal(!value);
+      onCheckedChange?.(!value);
+    };
+    return /* @__PURE__ */ jsx(
+      "button",
+      {
+        ref,
+        type: "button",
+        role: "switch",
+        "aria-checked": value,
+        disabled,
+        "data-state": value ? "checked" : "unchecked",
+        onClick: toggle,
+        className: cn(
+          "inline-flex shrink-0 cursor-pointer items-center rounded-full border-2 border-transparent transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:cursor-not-allowed disabled:opacity-50",
+          value ? "bg-primary" : "bg-input",
+          track[size],
+          className
+        ),
+        ...props,
+        children: /* @__PURE__ */ jsx(
+          "span",
+          {
+            "data-state": value ? "checked" : "unchecked",
+            className: cn(
+              "pointer-events-none inline-block rounded-full bg-background shadow-sm ring-0 transition-transform",
+              thumb[size]
+            )
+          }
+        )
+      }
+    );
+  }
+);
+Switch.displayName = "Switch";
+
+export { Switch };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;AAgBA,IAAM,KAAA,GAAoC;AAAA,EACxC,EAAA,EAAI,SAAA;AAAA,EACJ,EAAA,EAAI;AACN,CAAA;AACA,IAAM,KAAA,GAAoC;AAAA,EACxC,EAAA,EAAI,uFAAA;AAAA,EACJ,EAAA,EAAI;AACN,CAAA;AAGO,IAAM,MAAA,GAAe,KAAA,CAAA,UAAA;AAAA,EAC1B,CACE,EAAE,OAAA,EAAS,cAAA,GAAiB,KAAA,EAAO,eAAA,EAAiB,IAAA,GAAO,IAAA,EAAM,QAAA,EAAU,SAAA,EAAW,GAAG,KAAA,IACzF,GAAA,KACG;AACH,IAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAU,eAAS,cAAc,CAAA;AAC7D,IAAA,MAAM,eAAe,OAAA,IAAW,IAAA;AAChC,IAAA,MAAM,KAAA,GAAQ,eAAe,OAAA,GAAU,QAAA;AAEvC,IAAA,MAAM,SAAS,MAAM;AACnB,MAAA,IAAI,QAAA,EAAU;AACd,MAAA,IAAI,CAAC,YAAA,EAAc,WAAA,CAAY,CAAC,KAAK,CAAA;AACrC,MAAA,eAAA,GAAkB,CAAC,KAAK,CAAA;AAAA,IAC1B,CAAA;AAEA,IAAA,uBACE,GAAA;AAAA,MAAC,QAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,IAAA,EAAK,QAAA;AAAA,QACL,IAAA,EAAK,QAAA;AAAA,QACL,cAAA,EAAc,KAAA;AAAA,QACd,QAAA;AAAA,QACA,YAAA,EAAY,QAAQ,SAAA,GAAY,WAAA;AAAA,QAChC,OAAA,EAAS,MAAA;AAAA,QACT,SAAA,EAAW,EAAA;AAAA,UACT,sSAAA;AAAA,UACA,QAAQ,YAAA,GAAe,UAAA;AAAA,UACvB,MAAM,IAAI,CAAA;AAAA,UACV;AAAA,SACF;AAAA,QACC,GAAG,KAAA;AAAA,QAEJ,QAAA,kBAAA,GAAA;AAAA,UAAC,MAAA;AAAA,UAAA;AAAA,YACC,YAAA,EAAY,QAAQ,SAAA,GAAY,WAAA;AAAA,YAChC,SAAA,EAAW,EAAA;AAAA,cACT,mGAAA;AAAA,cACA,MAAM,IAAI;AAAA;AACZ;AAAA;AACF;AAAA,KACF;AAAA,EAEJ;AACF;AACA,MAAA,CAAO,WAAA,GAAc,QAAA","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { cn } from \"@nucleux/utils\";\n\nexport type SwitchSize = \"sm\" | \"md\";\n\nexport interface SwitchProps\n  extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, \"onChange\" | \"value\"> {\n  /** Controlled on/off state. */\n  checked?: boolean;\n  /** Initial state when uncontrolled. */\n  defaultChecked?: boolean;\n  /** Called with the next state when toggled. */\n  onCheckedChange?: (checked: boolean) => void;\n  size?: SwitchSize;\n}\n\nconst track: Record<SwitchSize, string> = {\n  sm: \"h-4 w-7\",\n  md: \"h-5 w-9\",\n};\nconst thumb: Record<SwitchSize, string> = {\n  sm: \"size-3 data-[state=checked]:translate-x-[14px] data-[state=unchecked]:translate-x-0.5\",\n  md: \"size-4 data-[state=checked]:translate-x-[18px] data-[state=unchecked]:translate-x-0.5\",\n};\n\n/** Accessible on/off toggle. Controlled via `checked`, or uncontrolled via `defaultChecked`. */\nexport const Switch = React.forwardRef<HTMLButtonElement, SwitchProps>(\n  (\n    { checked, defaultChecked = false, onCheckedChange, size = \"md\", disabled, className, ...props },\n    ref,\n  ) => {\n    const [internal, setInternal] = React.useState(defaultChecked);\n    const isControlled = checked != null;\n    const value = isControlled ? checked : internal;\n\n    const toggle = () => {\n      if (disabled) return;\n      if (!isControlled) setInternal(!value);\n      onCheckedChange?.(!value);\n    };\n\n    return (\n      <button\n        ref={ref}\n        type=\"button\"\n        role=\"switch\"\n        aria-checked={value}\n        disabled={disabled}\n        data-state={value ? \"checked\" : \"unchecked\"}\n        onClick={toggle}\n        className={cn(\n          \"inline-flex shrink-0 cursor-pointer items-center rounded-full border-2 border-transparent transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:cursor-not-allowed disabled:opacity-50\",\n          value ? \"bg-primary\" : \"bg-input\",\n          track[size],\n          className,\n        )}\n        {...props}\n      >\n        <span\n          data-state={value ? \"checked\" : \"unchecked\"}\n          className={cn(\n            \"pointer-events-none inline-block rounded-full bg-background shadow-sm ring-0 transition-transform\",\n            thumb[size],\n          )}\n        />\n      </button>\n    );\n  },\n);\nSwitch.displayName = \"Switch\";\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@nucleux/switch",
+  "version": "0.1.1",
+  "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.1.1"
+  },
+  "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/switch"
+  },
+  "homepage": "https://github.com/intelligaia-open-labs/nucleux#readme",
+  "description": "Accessible on/off toggle — Nucleux agentic UI for React.",
+  "keywords": [
+    "nucleux",
+    "react",
+    "ui",
+    "components",
+    "agentic",
+    "ai",
+    "tailwind",
+    "switch"
+  ],
+  "scripts": {
+    "build": "tsup"
+  }
+}