@letstri/oxc-config 0.5.0 → 0.7.0

package/README.md

@@ -29,46 +29,12 @@ npx oxc-config init --vscode --zed     # just the editor settings
 
 With flags, only the chosen targets run; with none in a non-interactive shell,
 all four run. Config files are skipped if they already exist (`--force` to
-overwrite); editor settings are deep-merged into any existing files. See
-[Editor setup](#editor-setup).
-
-## AI setup prompt
-
-Paste this into Claude Code, Cursor, or any coding agent to wire everything up:
-
-<details>
-<summary>Show prompt</summary>
-
-````text
-Set up @letstri/oxc-config (oxlint + oxfmt) in this project:
-
-1. Install dev deps: `@letstri/oxc-config oxlint oxfmt`.
-2. Remove ESLint and Prettier: their configs, deps, and scripts.
-3. Create `oxlint.config.ts`:
-   ```ts
-   import { oxlintConfig } from '@letstri/oxc-config'
-
-   export default oxlintConfig()
-   ```
-4. Create `oxfmt.config.ts`:
-   ```ts
-   import { oxfmtConfig } from '@letstri/oxc-config'
-
-   export default oxfmtConfig()
-   ```
-5. Add package.json scripts:
-   - "lint": "oxlint"
-   - "lint:fix": "oxlint --fix"
-   - "format": "oxfmt"
-   - "format:check": "oxfmt --check"
-6. Framework plugins auto-enable from the nearest package.json. If a framework
-   dep (react/vue/next/vitest/jest/typescript) lives in a nested workspace,
-   enable it manually, e.g. `oxlintConfig({ plugins: ['vue'] })`.
-7. Add the VS Code and Zed editor settings from the @letstri/oxc-config README.
-8. Run `pnpm lint` and `pnpm format` and fix anything reported.
-````
-
-</details>
+overwrite); editor settings (VS Code + Zed) are deep-merged into any existing
+files, so your other settings are kept.
+
+VS Code also needs the [`oxc.oxc-vscode`](https://marketplace.visualstudio.com/items?itemName=oxc.oxc-vscode)
+extension (the CLI adds it to `.vscode/extensions.json`). Zed has the oxc
+language servers built in.
 
 ## Usage
 
@@ -126,16 +92,16 @@ export default oxlintConfig({ rules: { 'no-console': 'off' } }, { plugins: ['vue
 
 ### Tailwind
 
-`tailwind({ entryPoint })` returns a config chunk for
-[`eslint-plugin-better-tailwindcss`](https://github.com/schoero/eslint-plugin-better-tailwindcss).
+`tailwindPlugin({ entryPoint })` returns a config chunk for
+[`oxlint-tailwindcss`](https://github.com/sergioazoc/oxlint-tailwindcss) (Tailwind v4).
 Pass it as an argument to `oxlintConfig`:
 
 ```ts
-import { oxlintConfig, tailwind } from '@letstri/oxc-config'
+import { oxlintConfig, tailwindPlugin } from '@letstri/oxc-config'
 
 export default oxlintConfig(
   { plugins: ['react', 'jsx-a11y'] },
-  tailwind({ entryPoint: 'app/globals.css' }),
+  tailwindPlugin({ entryPoint: 'app/globals.css' }),
 )
 ```
 
@@ -145,47 +111,29 @@ ones above rather than overwriting them.
 Options:
 
 - `entryPoint` (required) — your Tailwind entry CSS, so the plugin can resolve
-  class names.
+  class names. In a monorepo, pass an array of glob → CSS mappings (last match
+  wins, so end with a `'**'` catch-all):
+
+  ```ts
+  tailwindPlugin({
+    entryPoint: [
+      { files: 'packages/ui/**', use: 'packages/ui/src/styles.css' },
+      { files: '**', use: 'src/global.css' },
+    ],
+  })
+  ```
+
 - `ignoreClasses` — class names to exempt from `no-unknown-classes` (e.g. classes
   a component library generates that the plugin can't resolve):
 
   ```ts
-  tailwind({ entryPoint: 'app/globals.css', ignoreClasses: ['toaster'] })
+  tailwindPlugin({ entryPoint: 'app/globals.css', ignoreClasses: ['toaster'] })
   ```
 
 The plugin is an **optional peer dependency** — install it yourself:
 
 ```bash
-pnpm add -D eslint-plugin-better-tailwindcss
-```
-
-If the plugin is missing, `tailwind()` throws with an install hint.
-
-## Editor setup
-
-Both editors use the official [oxc](https://oxc.rs) tooling — `oxlint` for
-linting and `oxfmt` for formatting — replacing ESLint and Prettier.
-
-`oxc-config init` writes (or updates) the editor configs for you, deep-merging
-into any existing files so your other settings are kept:
-
-```bash
-# both editors
-pnpm exec oxc-config init --vscode --zed
+pnpm add -D oxlint-tailwindcss
 ```
 
-It's idempotent — safe to re-run to pull the latest recommended settings.
-
-### VS Code
-
-Install the [`oxc.oxc-vscode`](https://marketplace.visualstudio.com/items?itemName=oxc.oxc-vscode)
-extension (`init --vscode` also adds it to `.vscode/extensions.json`). It writes
-`.vscode/settings.json` — oxlint as linter, oxfmt as the default formatter with
-format-on-save, and Prettier's import organization turned off.
-
-### Zed
-
-Zed ships with the oxc language servers built in, so no extension is needed.
-`init --zed` writes `.zed/settings.json` — oxfmt as the formatter (with
-`source.fixAll.oxc` on save for JS/TS) and Prettier disabled, across the file
-types oxfmt supports.
+If the plugin is missing, `tailwindPlugin()` throws with an install hint.

package/dist/index.d.mts

@@ -1,7 +1,21 @@
 import { defineConfig } from "oxlint";
 import { defineConfig as defineConfig$1 } from "oxfmt";
 //#region src/oxlint.d.ts
-type OxlintOptions$1 = Parameters<typeof defineConfig>[0];
+type OxlintOptions = Parameters<typeof defineConfig>[0];
+type OxlintPlugin = NonNullable<NonNullable<OxlintOptions>['plugins']>[number];
+declare const basePlugins: readonly ["import", "unicorn", "jsdoc", "node", "promise", "oxc"];
+/**
+ * Plugins always enabled by the base config — excluded from the `plugins` you
+ * can add, since listing them again is redundant.
+ */
+type BasePlugin = (typeof basePlugins)[number];
+/**
+ * Oxlint config accepted by {@link oxlintConfig}. Same as oxlint's own config,
+ * but `plugins` can't include the always-on base plugins.
+ */
+type OxlintConfig = Omit<NonNullable<OxlintOptions>, 'plugins'> & {
+  plugins?: Exclude<OxlintPlugin, BasePlugin>[];
+};
 /**
  * Build an oxlint config.
  *
@@ -10,8 +24,9 @@ type OxlintOptions$1 = Parameters<typeof defineConfig>[0];
  * plugin whose dependency lives elsewhere — e.g. a nested workspace like
  * `apps/web/package.json` — add it through `plugins`.
  *
- * Pass any number of config objects; they are deep-merged (arrays concatenated),
- * so pieces like {@link tailwind} compose without clobbering each other.
+ * Pass any number of config objects; they are deep-merged (arrays concatenated,
+ * with `plugins` de-duplicated), so pieces like {@link tailwindPlugin} compose
+ * without clobbering each other.
  *
  * @example
  * ```ts
@@ -28,11 +43,11 @@ type OxlintOptions$1 = Parameters<typeof defineConfig>[0];
  * // compose Tailwind — its plugins merge with the ones above, not overwrite
  * export default oxlintConfig(
  *   { plugins: ['react', 'jsx-a11y'] },
- *   tailwind({ entryPoint: 'app/globals.css' }),
+ *   tailwindPlugin({ entryPoint: 'app/globals.css' }),
  * )
  * ```
  */
-declare function oxlintConfig(...overrides: OxlintOptions$1[]): OxlintOptions$1;
+declare function oxlintConfig(...overrides: OxlintConfig[]): OxlintOptions;
 //#endregion
 //#region src/oxfmt.d.ts
 type OxfmtOptions = Parameters<typeof defineConfig$1>[0];
@@ -43,13 +58,25 @@ type OxfmtOptions = Parameters<typeof defineConfig$1>[0];
 declare function oxfmtConfig(...overrides: OxfmtOptions[]): OxfmtOptions;
 //#endregion
 //#region src/tailwind.d.ts
-type OxlintOptions = Parameters<typeof defineConfig>[0];
 interface TailwindOptions {
   /**
-   * Path to the Tailwind entry CSS. Required — the plugin needs it to resolve
-   * class names.
+   * Path to the Tailwind entry CSS, so the plugin can resolve class names.
+   * Required. In a monorepo, pass an array of glob → CSS mappings; the last
+   * matching entry wins, so end with a `'**'` catch-all.
+   *
+   * @example 'src/global.css'
+   * @example
+   * ```ts
+   * [
+   *   { files: 'packages/ui/**', use: 'packages/ui/src/styles.css' },
+   *   { files: '**', use: 'src/global.css' },
+   * ]
+   * ```
    */
-  entryPoint: string;
+  entryPoint: string | {
+    files: string;
+    use: string;
+  }[];
   /**
    * Class names to exempt from `no-unknown-classes` — e.g. classes generated by
    * component libraries that the plugin can't resolve from the entry CSS.
@@ -63,20 +90,19 @@ interface TailwindOptions {
   cwd?: string;
 }
 /**
- * Tailwind linting via [`eslint-plugin-better-tailwindcss`](https://github.com/schoero/eslint-plugin-better-tailwindcss).
+ * Tailwind v4 linting via [`oxlint-tailwindcss`](https://github.com/sergioazoc/oxlint-tailwindcss).
  * Pass the result as an argument to `oxlintConfig`:
  *
  * ```ts
- * export default oxlintConfig(tailwind({
+ * export default oxlintConfig(tailwindPlugin({
  *   entryPoint: 'app/globals.css',
  *   ignoreClasses: ['toaster'],
  * }))
  * ```
  *
  * The plugin is an optional peer dependency — install it yourself
- * (`pnpm add -D eslint-plugin-better-tailwindcss`). If it is missing, an error
- * is thrown.
+ * (`pnpm add -D oxlint-tailwindcss`). If it is missing, an error is thrown.
  */
-declare function tailwind({ entryPoint, ignoreClasses, cwd }: TailwindOptions): OxlintOptions;
+declare function tailwindPlugin({ entryPoint, ignoreClasses, cwd }: TailwindOptions): OxlintConfig;
 //#endregion
-export { oxfmtConfig, oxlintConfig, tailwind };
+export { oxfmtConfig, oxlintConfig, tailwindPlugin };

package/dist/index.mjs

@@ -536,8 +536,9 @@ function resolvePlugins(cwd) {
 * plugin whose dependency lives elsewhere — e.g. a nested workspace like
 * `apps/web/package.json` — add it through `plugins`.
 *
-* Pass any number of config objects; they are deep-merged (arrays concatenated),
-* so pieces like {@link tailwind} compose without clobbering each other.
+* Pass any number of config objects; they are deep-merged (arrays concatenated,
+* with `plugins` de-duplicated), so pieces like {@link tailwindPlugin} compose
+* without clobbering each other.
 *
 * @example
 * ```ts
@@ -554,12 +555,14 @@ function resolvePlugins(cwd) {
 * // compose Tailwind — its plugins merge with the ones above, not overwrite
 * export default oxlintConfig(
 *   { plugins: ['react', 'jsx-a11y'] },
-*   tailwind({ entryPoint: 'app/globals.css' }),
+*   tailwindPlugin({ entryPoint: 'app/globals.css' }),
 * )
 * ```
 */
 function oxlintConfig(...overrides) {
-	return defu({}, ...overrides, { plugins: resolvePlugins(process.cwd()) }, baseOxlintConfig);
+	const merged = defu({}, ...overrides, { plugins: resolvePlugins(process.cwd()) }, baseOxlintConfig);
+	if (merged?.plugins) merged.plugins = [...new Set(merged.plugins)];
+	return merged;
 }
 //#endregion
 //#region src/oxfmt.ts
@@ -580,38 +583,40 @@ function oxfmtConfig(...overrides) {
 }
 //#endregion
 //#region src/tailwind.ts
-const TAILWIND_PLUGIN = "eslint-plugin-better-tailwindcss";
+const TAILWIND_PLUGIN = "oxlint-tailwindcss";
 /**
-* Tailwind linting via [`eslint-plugin-better-tailwindcss`](https://github.com/schoero/eslint-plugin-better-tailwindcss).
+* Tailwind v4 linting via [`oxlint-tailwindcss`](https://github.com/sergioazoc/oxlint-tailwindcss).
 * Pass the result as an argument to `oxlintConfig`:
 *
 * ```ts
-* export default oxlintConfig(tailwind({
+* export default oxlintConfig(tailwindPlugin({
 *   entryPoint: 'app/globals.css',
 *   ignoreClasses: ['toaster'],
 * }))
 * ```
 *
 * The plugin is an optional peer dependency — install it yourself
-* (`pnpm add -D eslint-plugin-better-tailwindcss`). If it is missing, an error
-* is thrown.
+* (`pnpm add -D oxlint-tailwindcss`). If it is missing, an error is thrown.
 */
-function tailwind({ entryPoint, ignoreClasses = [], cwd = process.cwd() }) {
+function tailwindPlugin({ entryPoint, ignoreClasses = [], cwd = process.cwd() }) {
 	if (!getInstalledPackages(cwd).has(TAILWIND_PLUGIN)) throw new Error(`[@letstri/oxc-config] Tailwind linting needs "${TAILWIND_PLUGIN}". Install it: pnpm add -D ${TAILWIND_PLUGIN}`);
 	return defineConfig({
 		jsPlugins: [TAILWIND_PLUGIN],
-		settings: { "better-tailwindcss": { entryPoint } },
+		settings: { tailwindcss: { entryPoint } },
 		rules: {
-			"better-tailwindcss/enforce-consistent-class-order": "error",
-			"better-tailwindcss/enforce-consistent-line-wrapping": "off",
-			"better-tailwindcss/no-unnecessary-whitespace": "off",
-			"better-tailwindcss/enforce-canonical-classes": "error",
-			"better-tailwindcss/no-conflicting-classes": "error",
-			"better-tailwindcss/no-deprecated-classes": "error",
-			"better-tailwindcss/no-duplicate-classes": "error",
-			"better-tailwindcss/no-unknown-classes": ["error", { ignore: ignoreClasses }]
+			"tailwindcss/enforce-sort-order": "error",
+			"tailwindcss/enforce-consistent-line-wrapping": "off",
+			"tailwindcss/no-unnecessary-whitespace": "off",
+			"tailwindcss/enforce-canonical": "error",
+			"tailwindcss/consistent-variant-order": "error",
+			"tailwindcss/enforce-consistent-important-position": "error",
+			"tailwindcss/no-conflicting-classes": "error",
+			"tailwindcss/no-deprecated-classes": "error",
+			"tailwindcss/no-duplicate-classes": "error",
+			"tailwindcss/no-unnecessary-arbitrary-value": "warn",
+			"tailwindcss/no-unknown-classes": ["error", { allowlist: ignoreClasses }]
 		}
 	});
 }
 //#endregion
-export { oxfmtConfig, oxlintConfig, tailwind };
+export { oxfmtConfig, oxlintConfig, tailwindPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letstri/oxc-config",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Opinionated Oxlint and Oxfmt configs",
   "homepage": "https://github.com/letstri/oxc-config#readme",
   "bugs": {
@@ -46,12 +46,12 @@
     "typescript": "^6.0.3"
   },
   "peerDependencies": {
-    "eslint-plugin-better-tailwindcss": ">=4",
     "oxfmt": ">=0.58.0",
-    "oxlint": ">=1.73.0"
+    "oxlint": ">=1.73.0",
+    "oxlint-tailwindcss": ">=1"
   },
   "peerDependenciesMeta": {
-    "eslint-plugin-better-tailwindcss": {
+    "oxlint-tailwindcss": {
       "optional": true
     }
   },