@jsdevlab/classnames 1.0.0 → 1.0.1

package/README.md

@@ -35,13 +35,13 @@ yarn add @jsdevlab/classnames
 ```ts
 import { classNames, cx, createClassNames } from '@jsdevlab/classnames';
 
-classNames('btn', 'btn-primary');                                // 'btn btn-primary'
+classNames('btn', 'btn-primary'); // 'btn btn-primary'
 classNames('btn', { 'btn-primary': true, 'is-loading': false }); // 'btn btn-primary'
-classNames('btn', ['btn-lg', ['rounded']]);                      // 'btn btn-lg rounded'
-classNames('btn', new Set(['btn-lg', 'rounded']));               // 'btn btn-lg rounded'
-classNames('btn', 'btn');                                        // 'btn'
+classNames('btn', ['btn-lg', ['rounded']]); // 'btn btn-lg rounded'
+classNames('btn', new Set(['btn-lg', 'rounded'])); // 'btn btn-lg rounded'
+classNames('btn', 'btn'); // 'btn'
 
-cx('btn', { disabled: true });                                   // 'btn disabled'
+cx('btn', { disabled: true }); // 'btn disabled'
 ```
 
 There is **no default export** — use named imports:
@@ -86,8 +86,8 @@ classNames({ zero: 0, one: 1 }); // 'one'
 Arrays are flattened recursively, and `Set`s are supported directly:
 
 ```ts
-classNames(['a', ['b', ['c']]]);           // 'a b c'
-classNames(new Set(['a', 'b']));           // 'a b'
+classNames(['a', ['b', ['c']]]); // 'a b c'
+classNames(new Set(['a', 'b'])); // 'a b'
 classNames([new Set(['a']), { b: true }]); // 'a b'
 ```
 
@@ -128,8 +128,8 @@ import { createClassNames } from '@jsdevlab/classnames';
 
 const join = createClassNames({ unique: false });
 
-join('a', 'a');        // 'a a'
-classNames('a', 'a');  // 'a'
+join('a', 'a'); // 'a a'
+classNames('a', 'a'); // 'a'
 ```
 
 Options are resolved when the factory is created, so the returned function is
@@ -137,7 +137,7 @@ bound to them:
 
 ```ts
 const cls = createClassNames(); // unique defaults to true
-cls('a', 'a');                  // 'a'
+cls('a', 'a'); // 'a'
 ```
 
 ### React
@@ -153,12 +153,7 @@ interface ButtonProps {
   children: ReactNode;
 }
 
-export function Button({
-  primary,
-  loading,
-  className,
-  children,
-}: ButtonProps) {
+export function Button({ primary, loading, className, children }: ButtonProps) {
   return (
     <button
       className={cx(
@@ -203,7 +198,7 @@ Accepts any mix of supported values and returns a single space-separated class
 name string. Returns `''` when nothing matches:
 
 ```ts
-classNames();                       // ''
+classNames(); // ''
 classNames(null, false, undefined); // ''
 ```
 
@@ -221,13 +216,13 @@ Returns a `classNames`-style function bound to the given options.
 
 #### `ClassNamesOptions`
 
-| Option   | Type      | Default | Description                                       |
-| -------- | --------- | ------- | ------------------------------------------------- |
+| Option   | Type      | Default | Description                                                 |
+| -------- | --------- | ------- | ----------------------------------------------------------- |
 | `unique` | `boolean` | `true`  | Deduplicate class names, preserving first-occurrence order. |
 
 ```ts
-const defaultJoin = createClassNames();                    // unique: true
-const keepAll = createClassNames({ unique: false });       // keeps duplicates
+const defaultJoin = createClassNames(); // unique: true
+const keepAll = createClassNames({ unique: false }); // keeps duplicates
 ```
 
 ## Types
@@ -256,18 +251,18 @@ export interface ClassNamesOptions {
 
 ## Behavior reference
 
-| Input                                                          | Output     |
-| -------------------------------------------------------------- | ---------- |
-| `classNames('a', 'b')`                                         | `'a b'`    |
-| `classNames('a', '', null, undefined, false, true)`            | `'a'`      |
-| `classNames(0, 1)`                                             | `'0 1'`    |
-| `classNames({ a: true, b: false, c: 1, d: 0 })`                | `'a c'`    |
-| `classNames(['a', [{ b: true }]])`                             | `'a b'`    |
-| `classNames(new Set(['a', 'b']))`                              | `'a b'`    |
-| `classNames({ active: () => true, hidden: () => false })`      | `'active'` |
-| `classNames('a', 'b', 'a')`                                    | `'a b'`    |
-| `createClassNames({ unique: false })('a', 'a')`                | `'a a'`    |
-| `classNames()`                                                 | `''`       |
+| Input                                                     | Output     |
+| --------------------------------------------------------- | ---------- |
+| `classNames('a', 'b')`                                    | `'a b'`    |
+| `classNames('a', '', null, undefined, false, true)`       | `'a'`      |
+| `classNames(0, 1)`                                        | `'0 1'`    |
+| `classNames({ a: true, b: false, c: 1, d: 0 })`           | `'a c'`    |
+| `classNames(['a', [{ b: true }]])`                        | `'a b'`    |
+| `classNames(new Set(['a', 'b']))`                         | `'a b'`    |
+| `classNames({ active: () => true, hidden: () => false })` | `'active'` |
+| `classNames('a', 'b', 'a')`                               | `'a b'`    |
+| `createClassNames({ unique: false })('a', 'a')`           | `'a a'`    |
+| `classNames()`                                            | `''`       |
 
 ## Notes and edge cases
 
@@ -295,18 +290,18 @@ export interface ClassNamesOptions {
 +import { classNames } from '@jsdevlab/classnames';
 ```
 
-| Capability                          | `classnames`                    | `@jsdevlab/classnames`              |
-| ----------------------------------- | ------------------------------- | ----------------------------------- |
-| Strings / numbers                   | ✅                              | ✅                                  |
-| Objects with truthy keys            | ✅                              | ✅                                  |
-| Nested arrays                       | ✅                              | ✅                                  |
-| Skips `null` / `undefined` / `false` / `''` | ✅                      | ✅                                  |
-| `Set` input                         | —                               | ✅                                  |
-| Function values in objects          | Not evaluated (functions are truthy) | Evaluated at call time         |
-| Duplicate removal                   | via `classnames/dedupe`         | Default                             |
-| Keep duplicates                     | Default                         | `createClassNames({ unique: false })` |
-| Custom separator                    | —                               | —                                   |
-| Default export                      | ✅                              | — (named exports only)              |
+| Capability                                  | `classnames`                         | `@jsdevlab/classnames`                |
+| ------------------------------------------- | ------------------------------------ | ------------------------------------- |
+| Strings / numbers                           | ✅                                   | ✅                                    |
+| Objects with truthy keys                    | ✅                                   | ✅                                    |
+| Nested arrays                               | ✅                                   | ✅                                    |
+| Skips `null` / `undefined` / `false` / `''` | ✅                                   | ✅                                    |
+| `Set` input                                 | —                                    | ✅                                    |
+| Function values in objects                  | Not evaluated (functions are truthy) | Evaluated at call time                |
+| Duplicate removal                           | via `classnames/dedupe`              | Default                               |
+| Keep duplicates                             | Default                              | `createClassNames({ unique: false })` |
+| Custom separator                            | —                                    | —                                     |
+| Default export                              | ✅                                   | — (named exports only)                |
 
 If you relied on the default duplicate-preserving behavior of `classnames`, bind
 your own instance:
@@ -319,11 +314,11 @@ const classNames = createClassNames({ unique: false });
 
 ## Module formats
 
-| Format     | File               |
-| ---------- | ------------------ |
-| ESM        | `dist/index.js`    |
-| CommonJS   | `dist/index.cjs`   |
-| TypeScript | `dist/index.d.ts`  |
+| Format     | File              |
+| ---------- | ----------------- |
+| ESM        | `dist/index.js`   |
+| CommonJS   | `dist/index.cjs`  |
+| TypeScript | `dist/index.d.ts` |
 
 ```ts
 // ESM
@@ -342,12 +337,18 @@ Requires Node.js ≥ 24.19 and pnpm 12.18.
 
 ```bash
 pnpm install
-pnpm test        # tsc --noEmit + rstest
-pnpm build       # rslib build → dist/
-pnpm check       # Biome lint + fix
-pnpm format      # Biome format + fix
+pnpm test          # tsc --noEmit + Node test suite
+pnpm test:browser  # same suite in real Chromium
+pnpm test:all      # Node + browser suites
+pnpm build         # rslib build → dist/
+pnpm check         # Biome lint + fix
+pnpm format        # Biome format + fix
 ```
 
+Browser tests download Chromium once with
+`pnpm exec playwright install chromium`; they are kept separate from
+`pnpm test` so the default suite stays fast.
+
 Releases are managed with [changesets](https://github.com/changesets/changesets):
 
 ```bash

package/README.zh-CN.md

@@ -35,13 +35,13 @@ yarn add @jsdevlab/classnames
 ```ts
 import { classNames, cx, createClassNames } from '@jsdevlab/classnames';
 
-classNames('btn', 'btn-primary');                                // 'btn btn-primary'
+classNames('btn', 'btn-primary'); // 'btn btn-primary'
 classNames('btn', { 'btn-primary': true, 'is-loading': false }); // 'btn btn-primary'
-classNames('btn', ['btn-lg', ['rounded']]);                      // 'btn btn-lg rounded'
-classNames('btn', new Set(['btn-lg', 'rounded']));               // 'btn btn-lg rounded'
-classNames('btn', 'btn');                                        // 'btn'
+classNames('btn', ['btn-lg', ['rounded']]); // 'btn btn-lg rounded'
+classNames('btn', new Set(['btn-lg', 'rounded'])); // 'btn btn-lg rounded'
+classNames('btn', 'btn'); // 'btn'
 
-cx('btn', { disabled: true });                                   // 'btn disabled'
+cx('btn', { disabled: true }); // 'btn disabled'
 ```
 
 本包**没有默认导出**，请使用具名导入：
@@ -86,8 +86,8 @@ classNames({ zero: 0, one: 1 }); // 'one'
 数组会被递归展平，同时也直接支持 `Set`：
 
 ```ts
-classNames(['a', ['b', ['c']]]);           // 'a b c'
-classNames(new Set(['a', 'b']));           // 'a b'
+classNames(['a', ['b', ['c']]]); // 'a b c'
+classNames(new Set(['a', 'b'])); // 'a b'
 classNames([new Set(['a']), { b: true }]); // 'a b'
 ```
 
@@ -126,15 +126,15 @@ import { createClassNames } from '@jsdevlab/classnames';
 
 const join = createClassNames({ unique: false });
 
-join('a', 'a');        // 'a a'
-classNames('a', 'a');  // 'a'
+join('a', 'a'); // 'a a'
+classNames('a', 'a'); // 'a'
 ```
 
 选项在创建工厂时解析，返回的函数会绑定这些选项：
 
 ```ts
 const cls = createClassNames(); // unique 默认为 true
-cls('a', 'a');                  // 'a'
+cls('a', 'a'); // 'a'
 ```
 
 ### React
@@ -150,12 +150,7 @@ interface ButtonProps {
   children: ReactNode;
 }
 
-export function Button({
-  primary,
-  loading,
-  className,
-  children,
-}: ButtonProps) {
+export function Button({ primary, loading, className, children }: ButtonProps) {
   return (
     <button
       className={cx(
@@ -200,7 +195,7 @@ defineProps<{ active?: boolean; disabled?: boolean }>();
 `''`：
 
 ```ts
-classNames();                       // ''
+classNames(); // ''
 classNames(null, false, undefined); // ''
 ```
 
@@ -218,12 +213,12 @@ cx('a', { b: true }); // 'a b'
 
 #### `ClassNamesOptions`
 
-| 选项     | 类型      | 默认值 | 说明                                   |
-| -------- | --------- | ------ | -------------------------------------- |
-| `unique` | `boolean` | `true` | 对类名去重，保留首次出现的顺序。       |
+| 选项     | 类型      | 默认值 | 说明                             |
+| -------- | --------- | ------ | -------------------------------- |
+| `unique` | `boolean` | `true` | 对类名去重，保留首次出现的顺序。 |
 
 ```ts
-const defaultJoin = createClassNames();              // unique: true
+const defaultJoin = createClassNames(); // unique: true
 const keepAll = createClassNames({ unique: false }); // 保留重复项
 ```
 
@@ -253,18 +248,18 @@ export interface ClassNamesOptions {
 
 ## 行为参考
 
-| 输入                                                           | 输出       |
-| -------------------------------------------------------------- | ---------- |
-| `classNames('a', 'b')`                                         | `'a b'`    |
-| `classNames('a', '', null, undefined, false, true)`            | `'a'`      |
-| `classNames(0, 1)`                                             | `'0 1'`    |
-| `classNames({ a: true, b: false, c: 1, d: 0 })`                | `'a c'`    |
-| `classNames(['a', [{ b: true }]])`                             | `'a b'`    |
-| `classNames(new Set(['a', 'b']))`                              | `'a b'`    |
-| `classNames({ active: () => true, hidden: () => false })`      | `'active'` |
-| `classNames('a', 'b', 'a')`                                    | `'a b'`    |
-| `createClassNames({ unique: false })('a', 'a')`                | `'a a'`    |
-| `classNames()`                                                 | `''`       |
+| 输入                                                      | 输出       |
+| --------------------------------------------------------- | ---------- |
+| `classNames('a', 'b')`                                    | `'a b'`    |
+| `classNames('a', '', null, undefined, false, true)`       | `'a'`      |
+| `classNames(0, 1)`                                        | `'0 1'`    |
+| `classNames({ a: true, b: false, c: 1, d: 0 })`           | `'a c'`    |
+| `classNames(['a', [{ b: true }]])`                        | `'a b'`    |
+| `classNames(new Set(['a', 'b']))`                         | `'a b'`    |
+| `classNames({ active: () => true, hidden: () => false })` | `'active'` |
+| `classNames('a', 'b', 'a')`                               | `'a b'`    |
+| `createClassNames({ unique: false })('a', 'a')`           | `'a a'`    |
+| `classNames()`                                            | `''`       |
 
 ## 注意事项与边界情况
 
@@ -289,18 +284,18 @@ export interface ClassNamesOptions {
 +import { classNames } from '@jsdevlab/classnames';
 ```
 
-| 能力                                | `classnames`                         | `@jsdevlab/classnames`                    |
-| ----------------------------------- | ------------------------------------ | ----------------------------------------- |
-| 字符串 / 数字                       | ✅                                   | ✅                                        |
-| 值为真值的对象                      | ✅                                   | ✅                                        |
-| 嵌套数组                            | ✅                                   | ✅                                        |
-| 跳过 `null` / `undefined` / `false` / `''` | ✅                            | ✅                                        |
-| `Set` 输入                          | —                                    | ✅                                        |
-| 对象中的函数值                      | 不求值（函数本身为真值）             | 在调用时求值                              |
-| 移除重复项                          | 通过 `classnames/dedupe`             | 默认行为                                  |
-| 保留重复项                          | 默认行为                             | `createClassNames({ unique: false })`     |
-| 自定义分隔符                        | —                                    | —                                         |
-| 默认导出                            | ✅                                   | —（仅具名导出）                           |
+| 能力                                       | `classnames`             | `@jsdevlab/classnames`                |
+| ------------------------------------------ | ------------------------ | ------------------------------------- |
+| 字符串 / 数字                              | ✅                       | ✅                                    |
+| 值为真值的对象                             | ✅                       | ✅                                    |
+| 嵌套数组                                   | ✅                       | ✅                                    |
+| 跳过 `null` / `undefined` / `false` / `''` | ✅                       | ✅                                    |
+| `Set` 输入                                 | —                        | ✅                                    |
+| 对象中的函数值                             | 不求值（函数本身为真值） | 在调用时求值                          |
+| 移除重复项                                 | 通过 `classnames/dedupe` | 默认行为                              |
+| 保留重复项                                 | 默认行为                 | `createClassNames({ unique: false })` |
+| 自定义分隔符                               | —                        | —                                     |
+| 默认导出                                   | ✅                       | —（仅具名导出）                       |
 
 如果你的代码依赖 `classnames` 默认保留重复项的行为，可以绑定自己的实例：
 
@@ -312,11 +307,11 @@ const classNames = createClassNames({ unique: false });
 
 ## 模块格式
 
-| 格式       | 文件               |
-| ---------- | ------------------ |
-| ESM        | `dist/index.js`    |
-| CommonJS   | `dist/index.cjs`   |
-| TypeScript | `dist/index.d.ts`  |
+| 格式       | 文件              |
+| ---------- | ----------------- |
+| ESM        | `dist/index.js`   |
+| CommonJS   | `dist/index.cjs`  |
+| TypeScript | `dist/index.d.ts` |
 
 ```ts
 // ESM
@@ -334,12 +329,18 @@ const { classNames } = require('@jsdevlab/classnames');
 
 ```bash
 pnpm install
-pnpm test        # tsc --noEmit + rstest
-pnpm build       # rslib 构建 → dist/
-pnpm check       # Biome 检查并修复
-pnpm format      # Biome 格式化并修复
+pnpm test          # tsc --noEmit + Node 测试套件
+pnpm test:browser  # 在真实 Chromium 中运行同一套测试
+pnpm test:all      # Node + 浏览器测试
+pnpm build         # rslib 构建 → dist/
+pnpm check         # Biome 检查并修复
+pnpm format        # Biome 格式化并修复
 ```
 
+浏览器测试首次运行前需执行
+`pnpm exec playwright install chromium` 下载 Chromium；它与 `pnpm test`
+分开，以保持默认测试套件轻快。
+
 发布流程使用 [changesets](https://github.com/changesets/changesets)：
 
 ```bash

package/dist/index.cjs

@@ -30,9 +30,12 @@ __webpack_require__.r(__webpack_exports__);
 const DEFAULT_OPTIONS = {
     unique: true
 };
-const resolveOptions = (options)=>({
-        unique: options?.unique ?? DEFAULT_OPTIONS.unique
-    });
+const resolveOptions = (options)=>{
+    var _ref;
+    return {
+        unique: null != (_ref = null == options ? void 0 : options.unique) ? _ref : DEFAULT_OPTIONS.unique
+    };
+};
 const collect = (value, parts)=>{
     if (null == value || false === value || true === value) return;
     if ('string' == typeof value || 'number' == typeof value) {
@@ -72,10 +75,9 @@ function createClassNames(options) {
     const resolved = resolveOptions(options);
     return (...values)=>classNamesImpl(values, resolved);
 }
-__webpack_require__.d(__webpack_exports__, {
-    classNames: ()=>classNames,
-    createClassNames: ()=>createClassNames
-}, {
+__webpack_require__.d(__webpack_exports__, {}, {
+    classNames: classNames,
+    createClassNames: createClassNames,
     cx: cx
 });
 exports.classNames = __webpack_exports__.classNames;

package/dist/index.js

@@ -1,9 +1,12 @@
 const DEFAULT_OPTIONS = {
     unique: true
 };
-const resolveOptions = (options)=>({
-        unique: options?.unique ?? DEFAULT_OPTIONS.unique
-    });
+const resolveOptions = (options)=>{
+    var _ref;
+    return {
+        unique: null != (_ref = null == options ? void 0 : options.unique) ? _ref : DEFAULT_OPTIONS.unique
+    };
+};
 const collect = (value, parts)=>{
     if (null == value || false === value || true === value) return;
     if ('string' == typeof value || 'number' == typeof value) {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@jsdevlab/classnames",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "private": false,
-  "description": "Type-safe classnames utility — conditional classes with lazy evaluation, dedup, and separator factory. Framework-agnostic.",
+  "description": "Type-safe classnames utility — conditional classes with lazy evaluation and deduplication by default. Framework-agnostic.",
   "keywords": [],
   "repository": {
     "type": "git",
@@ -19,19 +19,11 @@
   },
   "main": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
-  "files": ["dist", "README.md", "README.zh-CN.md"],
-  "scripts": {
-    "build": "rslib",
-    "changeset": "changeset",
-    "check": "biome check --write",
-    "dev": "rslib --watch",
-    "format": "biome format --write",
-    "prepare": "simple-git-hooks",
-    "release": "changeset publish",
-    "test": "tsc --noEmit && rstest",
-    "test:watch": "rstest --watch",
-    "version": "changeset version"
-  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh-CN.md"
+  ],
   "simple-git-hooks": {
     "pre-commit": "pnpm check",
     "pre-push": "pnpm format"
@@ -40,15 +32,16 @@
     "@biomejs/biome": "^2.6.6",
     "@changesets/changelog-github": "^1.0.1",
     "@changesets/cli": "^3.0.1",
-    "@rslib/core": "^0.23.2",
-    "@rstest/adapter-rslib": "^0.11.9",
-    "@rstest/core": "^0.11.9",
-    "@rstest/coverage-v8": "^0.11.9",
+    "@rslib/core": "^1.0.6",
+    "@rstest/adapter-rslib": "^0.12.6",
+    "@rstest/browser": "^0.12.6",
+    "@rstest/core": "^0.12.6",
+    "@rstest/coverage-v8": "^0.12.6",
     "@types/node": "^24.13.3",
+    "playwright": "^1.65.0",
     "simple-git-hooks": "^2.14.0",
     "typescript": "^6.0.3"
   },
-  "packageManager": "pnpm@12.18.0+sha512.9d7882d5dc82147ecfc4e062aa34834e0ad0296710a1837a1115ae012127d36b7109e321ac1598a1dd0a65597681b1e99917e12ed0d749eae91187943363beb3",
   "devEngines": {
     "runtime": {
       "name": "node",
@@ -59,5 +52,18 @@
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "rslib",
+    "changeset": "changeset",
+    "check": "biome check --write",
+    "dev": "rslib --watch",
+    "format": "biome format --write",
+    "release": "changeset publish",
+    "test": "tsc --noEmit && rstest run",
+    "test:all": "pnpm test && pnpm test:browser",
+    "test:browser": "rstest run --browser.enabled",
+    "test:watch": "rstest watch",
+    "version": "changeset version"
   }
-}
+}