@letstri/oxc-config 0.2.0 → 0.2.1

package/README.md

@@ -109,7 +109,7 @@ export default oxlintConfig({
 
 ### Tailwind
 
-`tailwind(options?)` returns a config chunk for
+`tailwind({ entryPoint })` returns a config chunk for
 [`eslint-plugin-better-tailwindcss`](https://github.com/schoero/eslint-plugin-better-tailwindcss).
 Spread it into `oxlintConfig`:
 
@@ -121,14 +121,14 @@ export default oxlintConfig({
 })
 ```
 
-`entryPoint` is your Tailwind entry CSS, so the plugin can resolve class names. The plugin is an **optional peer dependency** — install it yourself:
+`entryPoint` (required) is your Tailwind entry CSS, so the plugin can resolve
+class names. The plugin is an **optional peer dependency** — install it yourself:
 
 ```bash
 pnpm add -D eslint-plugin-better-tailwindcss
 ```
 
-If the plugin is missing, `tailwind()` logs a reminder and returns an empty
-config instead of crashing oxlint.
+If the plugin is missing, `tailwind()` throws with an install hint.
 
 ## Editor setup
 

package/dist/index.d.mts

@@ -1,8 +1,7 @@
-import { defineConfig } from "oxfmt";
-import { defineConfig as defineConfig$1 } from "oxlint";
-//#region src/index.d.ts
-type OxlintOptions = Parameters<typeof defineConfig$1>[0];
-type OxfmtOptions = Parameters<typeof defineConfig>[0];
+import { defineConfig } from "oxlint";
+import { defineConfig as defineConfig$1 } from "oxfmt";
+//#region src/oxlint.d.ts
+type OxlintOptions$1 = Parameters<typeof defineConfig>[0];
 /**
  * Build an oxlint config.
  *
@@ -11,8 +10,6 @@ type OxfmtOptions = Parameters<typeof defineConfig>[0];
  * plugin whose dependency lives elsewhere — e.g. a nested workspace like
  * `apps/web/package.json` — add it through `overrides.plugins`.
  *
- * `overrides` is deep-merged over the base config via defu.
- *
  * @example
  * ```ts
  * // auto-detect from the current package.json
@@ -26,10 +23,17 @@ type OxfmtOptions = Parameters<typeof defineConfig>[0];
  * @example
  * ```ts
  * // add Tailwind linting
- * export default oxlintConfig({ ...tailwind('app/globals.css') })
+ * export default oxlintConfig({ ...tailwind({ entryPoint: 'app/globals.css' }) })
  * ```
  */
-declare function oxlintConfig(overrides?: OxlintOptions): OxlintOptions;
+declare function oxlintConfig(overrides?: OxlintOptions$1): OxlintOptions$1;
+//#endregion
+//#region src/oxfmt.d.ts
+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
@@ -45,17 +49,16 @@ interface TailwindOptions {
 }
 /**
  * Tailwind linting via [`eslint-plugin-better-tailwindcss`](https://github.com/schoero/eslint-plugin-better-tailwindcss).
- * Spread the result into {@link oxlintConfig}:
+ * Spread the result into `oxlintConfig`:
  *
  * ```ts
  * export default oxlintConfig({ ...tailwind({ entryPoint: 'app/globals.css' }) })
  * ```
  *
  * The plugin is an optional peer dependency — install it yourself
- * (`pnpm add -D eslint-plugin-better-tailwindcss`). If it is missing, a warning
- * is logged and an empty config is returned so oxlint does not crash.
+ * (`pnpm add -D eslint-plugin-better-tailwindcss`). If it is missing, an error
+ * is thrown.
  */
 declare function tailwind({ entryPoint, cwd }: TailwindOptions): OxlintOptions;
-declare function oxfmtConfig(overrides?: OxfmtOptions): OxfmtOptions;
 //#endregion
 export { oxfmtConfig, oxlintConfig, tailwind };

package/dist/index.mjs

@@ -1,11 +1,25 @@
-import { readFileSync } from "node:fs";
-import { resolve } from "node:path";
 import process from "node:process";
 import { defu } from "defu";
-import { defineConfig } from "oxfmt";
-import { defineConfig as defineConfig$1 } from "oxlint";
-//#region src/index.ts
-const baseOxlintConfig = defineConfig$1({
+import { defineConfig } from "oxlint";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { defineConfig as defineConfig$1 } from "oxfmt";
+//#region src/utils.ts
+function getInstalledPackages(cwd) {
+	const names = /* @__PURE__ */ new Set();
+	try {
+		const pkg = JSON.parse(readFileSync(resolve(cwd, "package.json"), "utf-8"));
+		for (const field of [
+			pkg.dependencies,
+			pkg.devDependencies,
+			pkg.peerDependencies
+		]) for (const name of Object.keys(field ?? {})) names.add(name);
+	} catch {}
+	return names;
+}
+//#endregion
+//#region src/oxlint.ts
+const baseOxlintConfig = defineConfig({
 	categories: {
 		correctness: "error",
 		suspicious: "warn",
@@ -474,13 +488,6 @@ const baseOxlintConfig = defineConfig$1({
 		}
 	]
 });
-const baseOxfmtConfig = defineConfig({
-	singleQuote: true,
-	semi: false,
-	arrowParens: "avoid",
-	sortImports: true,
-	quoteProps: "consistent"
-});
 const basePlugins = [
 	"import",
 	"unicorn",
@@ -489,11 +496,6 @@ const basePlugins = [
 	"promise",
 	"oxc"
 ];
-const TAILWIND_PLUGIN = "eslint-plugin-better-tailwindcss";
-/**
-* Map of a dependency to the oxlint plugins it enables. A plugin is registered
-* when any of its packages is found in the nearest `package.json`.
-*/
 const pluginDetectors = {
 	typescript: {
 		packages: ["typescript"],
@@ -520,18 +522,6 @@ const pluginDetectors = {
 		plugins: ["jest"]
 	}
 };
-function getInstalledPackages(cwd) {
-	const names = /* @__PURE__ */ new Set();
-	try {
-		const pkg = JSON.parse(readFileSync(resolve(cwd, "package.json"), "utf-8"));
-		for (const field of [
-			pkg.dependencies,
-			pkg.devDependencies,
-			pkg.peerDependencies
-		]) for (const name of Object.keys(field ?? {})) names.add(name);
-	} catch {}
-	return names;
-}
 function resolvePlugins(cwd) {
 	const installed = getInstalledPackages(cwd);
 	const plugins = [...basePlugins];
@@ -546,8 +536,6 @@ function resolvePlugins(cwd) {
 * plugin whose dependency lives elsewhere — e.g. a nested workspace like
 * `apps/web/package.json` — add it through `overrides.plugins`.
 *
-* `overrides` is deep-merged over the base config via defu.
-*
 * @example
 * ```ts
 * // auto-detect from the current package.json
@@ -561,30 +549,42 @@ function resolvePlugins(cwd) {
 * @example
 * ```ts
 * // add Tailwind linting
-* export default oxlintConfig({ ...tailwind('app/globals.css') })
+* export default oxlintConfig({ ...tailwind({ entryPoint: 'app/globals.css' }) })
 * ```
 */
 function oxlintConfig(overrides = {}) {
 	return defu(overrides, { plugins: resolvePlugins(process.cwd()) }, baseOxlintConfig);
 }
+//#endregion
+//#region src/oxfmt.ts
+const baseOxfmtConfig = defineConfig$1({
+	singleQuote: true,
+	semi: false,
+	arrowParens: "avoid",
+	sortImports: true,
+	quoteProps: "consistent"
+});
+function oxfmtConfig(overrides = {}) {
+	return defu(overrides, baseOxfmtConfig);
+}
+//#endregion
+//#region src/tailwind.ts
+const TAILWIND_PLUGIN = "eslint-plugin-better-tailwindcss";
 /**
 * Tailwind linting via [`eslint-plugin-better-tailwindcss`](https://github.com/schoero/eslint-plugin-better-tailwindcss).
-* Spread the result into {@link oxlintConfig}:
+* Spread the result into `oxlintConfig`:
 *
 * ```ts
 * export default oxlintConfig({ ...tailwind({ entryPoint: 'app/globals.css' }) })
 * ```
 *
 * The plugin is an optional peer dependency — install it yourself
-* (`pnpm add -D eslint-plugin-better-tailwindcss`). If it is missing, a warning
-* is logged and an empty config is returned so oxlint does not crash.
+* (`pnpm add -D eslint-plugin-better-tailwindcss`). If it is missing, an error
+* is thrown.
 */
 function tailwind({ entryPoint, cwd = process.cwd() }) {
-	if (!getInstalledPackages(cwd).has(TAILWIND_PLUGIN)) {
-		console.warn(`[@letstri/oxc-config] Tailwind linting needs "${TAILWIND_PLUGIN}". Install it: pnpm add -D ${TAILWIND_PLUGIN}`);
-		return {};
-	}
-	return defineConfig$1({
+	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 } },
 		rules: {
@@ -599,8 +599,5 @@ function tailwind({ entryPoint, cwd = process.cwd() }) {
 		}
 	});
 }
-function oxfmtConfig(overrides = {}) {
-	return defu(overrides, baseOxfmtConfig);
-}
 //#endregion
 export { oxfmtConfig, oxlintConfig, tailwind };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letstri/oxc-config",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Opinionated Oxlint and Oxfmt configs",
   "homepage": "https://github.com/letstri/oxc-config#readme",
   "bugs": {