feat: stash-ui 0.1.0（40 个组件 + 文档站 + 主题机制）

src/components/Switch.tsx

@@ -0,0 +1,44 @@
+import styles from './Switch.module.css'
+
+/**
+ * 开关：设置项的即时生效开关。
+ *
+ * 原生 `button` + `role="switch"`，空格/回车都能切换；
+ * 没有可见文字标签时，`label` 必填（进 aria-label）。
+ */
+export type SwitchSize = 'sm' | 'md'
+
+export type SwitchProps = {
+  checked: boolean
+  onChange: (checked: boolean) => void
+  disabled?: boolean
+  size?: SwitchSize
+  /** 无障碍名称：开关旁边没有文字时必填 */
+  label?: string
+  className?: string
+}
+
+export function Switch({
+  checked,
+  onChange,
+  disabled = false,
+  size = 'md',
+  label,
+  className,
+}: SwitchProps) {
+  return (
+    <button
+      type="button"
+      role="switch"
+      aria-checked={checked}
+      aria-label={label}
+      disabled={disabled}
+      className={[styles.root, styles[size], checked ? styles.on : undefined, className]
+        .filter(Boolean)
+        .join(' ')}
+      onClick={() => onChange(!checked)}
+    >
+      <span className={styles.thumb} aria-hidden="true" />
+    </button>
+  )
+}