@bilazo/oxc-config 0.0.0-stage → 0.1.0

package/dist/lint.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.mts","names":[],"sources":["../src/utils.ts","../src/lint.ts"],"mappings":";;;qBAgDa;;qBAGA;;qBAGA;;qBAGA;;qBAGA;;qBAMA;;qBAGA;;;;;;;wBCuCG,KAAK,YAAY,QAAQ,gBAAgB;;;;;wBA6HzC,UAAU,YAAY,QAAQ,gBAAgB;;wBAa9C,QAAQ,YAAY,QAAQ,gBAAgB;;wBA2C5C,OAAO,YAAY,QAAQ,gBAAgB;;wBAwB3C,KAAK,YAAY,QAAQ,gBAAgB;;wBAazC,QAAQ,YAAY,QAAQ,gBAAgB;;wBAuE5C,MAAM,YAAY,QAAQ,gBAAgB;;wBAW1C,UAAU,YAAY,QAAQ,gBAAgB;;wBAe9C,OAAO,YAAY,QAAQ,gBAAgB;;;;;;;;;;;wBAc3C,eAAe,YAAY,QAAQ,gBAAgB;;;;;;;;;wBAuFnD,cAAc,YAAY,QAAQ,gBAAgB;;wBAkGlD,KAAK,YAAY,QAAQ,gBAAgB;;wBAKzC,MAAM,YAAY,QAAQ,gBAAgB;UAQhD,sBAAsB,QAAQ;;EAEtC;;;wBAIc,OAAO,UAAU,gBAAgB;UAkDvC,wBAAwB,QAAQ;EACxC;EACA;;EAEA;;;wBAIc,SAAS,UAAS,kBAAuB;;;;;wBA6BzC,OAAO,YAAY,QAAQ,gBAAgB;;wBA+B3C,QAAQ,YAAY,QAAQ,gBAAgB"}

package/dist/lint.mjs

@@ -0,0 +1,608 @@
+import { createRequire } from "node:module";
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { defu } from "defu";
+import { defineConfig, defineConfig as defineConfig$1 } from "oxlint";
+//#region src/utils.ts
+/**
+* Utility functions and constants
+*/
+const env = process.env;
+function isCI() {
+	return !!(env["CI"] || env["CONTINUOUS_INTEGRATION"] || env["BUILD_ID"] || env["BUILD_NUMBER"] || env["RUN_ID"]);
+}
+function isInGitHooksOrLintStaged() {
+	return !!(env["GIT_PARAMS"] || env["VSCODE_GIT_COMMAND"]) || env["npm_lifecycle_script"]?.startsWith("lint-staged") === true;
+}
+/**
+* Detects whether running in an editor environment.
+* Returns false in CI, Git Hooks, or lint-staged.
+*/
+function isInEditorEnv() {
+	if (isCI()) return false;
+	if (isInGitHooksOrLintStaged()) return false;
+	return !!(env["VSCODE_PID"] || env["VSCODE_CWD"] || env["JETBRAINS_IDE"] || env["VIM"] || env["NVIM"]);
+}
+/** All JS/TS source files */
+const GLOB_SRC = "**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}";
+/** JavaScript files only */
+const GLOB_JS = "**/*.{js,mjs,cjs,jsx}";
+/** TypeScript files only */
+const GLOB_TS = "**/*.{ts,mts,cts,tsx}";
+/** JSX/TSX files (React-related) */
+const GLOB_JSX = "**/*.{jsx,tsx}";
+/** Test files */
+const GLOB_TESTS = ["**/*.{test,spec}.{js,mjs,cjs,jsx,ts,mts,cts,tsx}", "**/__tests__/**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}"];
+/** JSON files */
+const GLOB_JSON = "**/*.json";
+/** Markdown files */
+const GLOB_MARKDOWN = "**/*.md";
+//#endregion
+//#region src/lint.ts
+/**
+* Oxlint lint presets.
+*
+* Every preset is a function that accepts optional overrides, merged via `defu`.
+* User overrides take priority over preset defaults.
+*
+* @example
+* ```ts
+* // oxlint.config.ts
+* import { base, unicorn, react, tailwind, vitest } from '@bilazo/oxc-config/lint'
+* import { defineConfig } from 'oxlint'
+*
+* export default defineConfig({
+*   extends: [base(), unicorn(), react(), tailwind(), vitest()],
+* })
+* ```
+*/
+const require = createRequire(import.meta.url);
+const DEFAULT_IGNORES = [
+	"**/node_modules/**",
+	"**/dist/**",
+	"**/build/**",
+	"**/out/**",
+	"**/.next/**",
+	"**/.cache/**",
+	"**/.turbo/**",
+	"**/.output/**",
+	"**/.nitro/**",
+	"**/.tanstack/**",
+	"**/.vinxi/**",
+	"**/.git/**",
+	"**/.svn/**",
+	"**/.hg/**",
+	"**/.pnp.*",
+	"**/public/**",
+	"**/routeTree.gen.ts",
+	"**/*.d.ts"
+];
+function loadGitignorePatterns() {
+	const gitignoreFile = path.resolve(process.cwd(), ".gitignore");
+	if (!existsSync(gitignoreFile)) return [];
+	return readFileSync(gitignoreFile, "utf8").split(/\r?\n/u).map((line) => line.trim()).filter((line) => line && !line.startsWith("#")).map((pattern) => {
+		let p = pattern.trimEnd();
+		if (p.startsWith("/")) p = p.slice(1);
+		if (!p.includes("/") && !p.includes("*")) p = `**/${p}`;
+		if (p.endsWith("/")) p = `${p}**`;
+		return p;
+	});
+}
+function preset(defaults, overrides) {
+	return defineConfig$1(defu(overrides ?? {}, defaults));
+}
+/**
+* Resolve a jsPlugin package name to its absolute path.
+* This allows oxlint to load plugins directly without relying on
+* Node module resolution from the consumer's CWD — fixes pnpm strict mode.
+*/
+function resolvePlugin(name) {
+	try {
+		return require.resolve(name);
+	} catch {
+		return name;
+	}
+}
+function resolvePlugins(plugins) {
+	return plugins.map((p) => {
+		if (typeof p === "string") return resolvePlugin(p);
+		return {
+			...p,
+			specifier: resolvePlugin(p.specifier)
+		};
+	});
+}
+/**
+* Base lint preset — TypeScript + Import plugins, categories, env, ignores.
+* Always include first.
+*/
+function base(overrides) {
+	return preset({
+		plugins: ["typescript", "import"],
+		categories: {
+			correctness: "error",
+			suspicious: "error",
+			perf: "error",
+			pedantic: "warn"
+		},
+		rules: {
+			"no-await-in-loop": "off",
+			"typescript/prefer-readonly-parameter-types": "off",
+			"typescript/strict-boolean-expressions": "off",
+			"max-lines": "off",
+			"max-lines-per-function": "off",
+			"no-inline-comments": "off",
+			"no-warning-comments": "off",
+			"import/max-dependencies": "off",
+			"react/no-unescaped-entities": "off",
+			"require-await": "off"
+		},
+		env: {
+			browser: true,
+			node: true,
+			es2026: true,
+			builtin: true
+		},
+		ignorePatterns: [...DEFAULT_IGNORES, ...loadGitignorePatterns()],
+		overrides: [
+			{
+				files: [GLOB_TS],
+				rules: {
+					"typescript/consistent-type-definitions": "off",
+					"typescript/consistent-type-imports": "error",
+					"no-unused-vars": "off",
+					"no-useless-rename": "error",
+					"uninvoked-array-callback": "error",
+					"typescript/array-type": "error",
+					"typescript/consistent-generic-constructors": "error",
+					"typescript/consistent-indexed-object-style": "error",
+					"typescript/consistent-type-assertions": "error",
+					"typescript/ban-tslint-comment": "error",
+					"typescript/no-empty-interface": "error",
+					"typescript/no-inferrable-types": "error",
+					"typescript/no-misused-new": "error",
+					"typescript/no-unnecessary-parameter-property-assignment": "error",
+					"typescript/no-useless-empty-export": "error",
+					"typescript/no-deprecated": "warn",
+					"typescript/prefer-for-of": "error",
+					"typescript/prefer-function-type": "error",
+					"typescript/unified-signatures": "error"
+				}
+			},
+			{
+				files: [GLOB_SRC],
+				rules: {
+					"import/no-unassigned-import": "off",
+					"import/no-relative-parent-imports": "error",
+					"import/first": "error",
+					"import/no-duplicates": "error",
+					"import/consistent-type-specifier-style": "error",
+					"import/no-mutable-exports": "error",
+					"import/no-named-default": "error"
+				}
+			},
+			{
+				files: ["**/*.config.{ts,mts,cts,js,mjs,cjs}"],
+				rules: { "import/no-relative-parent-imports": "off" }
+			},
+			{
+				files: GLOB_TESTS,
+				rules: {
+					"import/first": "off",
+					"import/no-duplicates": "off",
+					"import/consistent-type-specifier-style": "off",
+					"unicorn/no-useless-undefined": "off",
+					"typescript/no-empty-function": "off",
+					"unicorn/prefer-string-replace-all": "off",
+					"unicorn/no-array-callback-reference": "off",
+					"unicorn/prefer-spread": "off",
+					"typescript/no-non-null-assertion": "off",
+					"no-magic-numbers": "off",
+					"typescript/no-explicit-any": "off",
+					"typescript/no-unsafe-assignment": "off",
+					"typescript/no-unsafe-call": "off",
+					"typescript/no-unsafe-member-access": "off",
+					"typescript/no-unsafe-return": "off",
+					"typescript/no-unsafe-argument": "off",
+					"react/no-array-index-key": "off"
+				}
+			}
+		]
+	}, overrides);
+}
+/**
+* Type-aware lint preset — enables 59 type-aware rules via tsgolint + type checking.
+* Requires TypeScript 7.0+ and `oxlint-tsgolint` (bundled as dependency).
+*/
+function typeAware(overrides) {
+	return preset({ options: {
+		typeAware: true,
+		typeCheck: true
+	} }, overrides);
+}
+/** Unicorn lint preset — 100+ code quality rules. */
+function unicorn(overrides) {
+	return preset({
+		plugins: ["unicorn"],
+		rules: {
+			"unicorn/no-null": "off",
+			"unicorn/filename-case": ["error", { case: "kebabCase" }],
+			"unicorn/catch-error-name": "error",
+			"unicorn/error-message": "error",
+			"unicorn/prefer-optional-catch-binding": "error",
+			"unicorn/number-literal-case": "error",
+			"unicorn/numeric-separators-style": "error",
+			"unicorn/prefer-includes": "error",
+			"unicorn/prefer-spread": "error",
+			"unicorn/prefer-ternary": "error",
+			"unicorn/prefer-string-trim-start-end": "error",
+			"unicorn/prefer-structured-clone": "error",
+			"unicorn/prefer-default-parameters": "error",
+			"unicorn/prefer-string-starts-ends-with": "error",
+			"unicorn/prefer-set-size": "error",
+			"unicorn/throw-new-error": "error",
+			"unicorn/require-array-join-separator": "error",
+			"unicorn/no-zero-fractions": "error",
+			"unicorn/no-console-spaces": "error",
+			"unicorn/no-useless-spread": "error",
+			"unicorn/no-useless-fallback-in-spread": "error",
+			"unicorn/no-unnecessary-await": "error",
+			"unicorn/no-useless-length-check": "error",
+			"unicorn/no-single-promise-in-promise-methods": "error",
+			"unicorn/no-await-in-promise-methods": "error",
+			"unicorn/no-invalid-remove-event-listener": "error",
+			"unicorn/no-invalid-fetch-options": "error",
+			"unicorn/no-new-array": "error",
+			"unicorn/no-empty-file": "warn"
+		}
+	}, overrides);
+}
+/** Dependency optimization — flags packages replaceable with native APIs. */
+function depend(overrides) {
+	return preset({
+		jsPlugins: resolvePlugins(["eslint-plugin-depend"]),
+		rules: { "depend/ban-dependencies": ["error", {
+			presets: [
+				"native",
+				"microutilities",
+				"preferred"
+			],
+			modules: [],
+			allowed: ["dotenv"]
+		}] }
+	}, overrides);
+}
+/** Node.js lint preset — native node plugin. */
+function node(overrides) {
+	return preset({
+		plugins: ["node"],
+		rules: { "unicorn/prefer-node-protocol": "error" }
+	}, overrides);
+}
+/** Promise lint preset — native promise plugin. */
+function promise(overrides) {
+	return preset({ plugins: ["promise"] }, overrides);
+}
+const reactRules = {
+	"react/rules-of-hooks": "error",
+	"react/exhaustive-deps": "warn",
+	"react/jsx-key": "error",
+	"react/jsx-no-duplicate-props": "error",
+	"react/jsx-no-undef": "error",
+	"react/jsx-no-target-blank": ["error", { allowReferrer: false }],
+	"react/jsx-no-comment-textnodes": "error",
+	"react/jsx-no-script-url": "error",
+	"react/jsx-props-no-spread-multi": "error",
+	"react/jsx-no-useless-fragment": "warn",
+	"react/jsx-boolean-value": ["error", "never"],
+	"react/jsx-curly-brace-presence": ["error", {
+		props: "never",
+		children: "never"
+	}],
+	"react/jsx-fragments": ["error", "syntax"],
+	"react/jsx-pascal-case": ["error", {
+		allowAllCaps: false,
+		allowNamespace: true
+	}],
+	"react/self-closing-comp": ["error", {
+		component: true,
+		html: true
+	}],
+	"react/hook-use-state": "error",
+	"react/no-children-prop": "error",
+	"react/no-danger-with-children": "error",
+	"react/no-direct-mutation-state": "error",
+	"react/no-find-dom-node": "error",
+	"react/no-is-mounted": "error",
+	"react/no-render-return-value": "error",
+	"react/no-string-refs": "error",
+	"react/no-unknown-property": "error",
+	"react/no-unsafe": "error",
+	"react/require-render-return": "error",
+	"react/void-dom-elements-no-children": "error",
+	"react/no-set-state": "error",
+	"react/no-did-mount-set-state": "error",
+	"react/no-did-update-set-state": "error",
+	"react/no-will-update-set-state": "error",
+	"react/no-this-in-sfc": "error",
+	"react/forward-ref-uses-ref": "error",
+	"react/no-unstable-nested-components": "warn",
+	"react/iframe-missing-sandbox": "error",
+	"react/set-state-in-render": "error",
+	"react/error-boundaries": "error",
+	"react/jsx-no-constructed-context-values": "warn",
+	"react/no-array-index-key": "warn",
+	"react/style-prop-object": "error",
+	"react/react-in-jsx-scope": "off",
+	"react/no-unescaped-entities": "off"
+};
+/** React lint preset — core React + Hooks rules. */
+function react(overrides) {
+	return preset({
+		plugins: ["react"],
+		rules: reactRules
+	}, overrides);
+}
+/** React + react-refresh preset (for Vite, TanStack Start, etc.). */
+function reactVite(overrides) {
+	return preset({
+		plugins: ["react"],
+		jsPlugins: resolvePlugins(["eslint-plugin-react-refresh"]),
+		rules: {
+			...reactRules,
+			"react-refresh/only-export-components": ["warn", { allowConstantExport: true }]
+		}
+	}, overrides);
+}
+/** Next.js lint preset — enables native nextjs plugin. */
+function nextjs(overrides) {
+	return preset({ plugins: ["nextjs"] }, overrides);
+}
+/**
+* TanStack Router lint preset.
+*
+* Loads @tanstack/eslint-plugin-router and applies conventions specific
+* to file-based routing setups.
+*
+* Rules provided by the plugin:
+* - `route-param-names` — validates `$param` names match between route path and params
+* - `create-route-property-order` — enforces consistent property order in `createRoute()`
+*/
+function tanstackRouter(overrides) {
+	return preset({
+		jsPlugins: resolvePlugins([{
+			name: "tanstack-router",
+			specifier: "@tanstack/eslint-plugin-router"
+		}]),
+		rules: {
+			"tanstack-router/route-param-names": "error",
+			"tanstack-router/create-route-property-order": "error",
+			"import/no-default-export": "off"
+		},
+		overrides: [
+			{
+				files: [
+					"**/routeTree.gen.ts",
+					"**/routeTree.gen.tsx",
+					"**/*.generated.ts",
+					"**/*.gen.ts"
+				],
+				rules: { "unicorn/filename-case": "off" }
+			},
+			{
+				files: ["**/routes/**/*.{ts,tsx}"],
+				rules: { "no-restricted-globals": ["error", {
+					name: "window",
+					message: "Use useRouter() or useNavigate() instead of window in route files."
+				}] }
+			},
+			{
+				files: ["**/routes/**/*.{ts,tsx}"],
+				plugins: ["unicorn"],
+				rules: { "unicorn/filename-case": ["error", {
+					case: "kebabCase",
+					ignore: [
+						"\\$",
+						"^_",
+						"\\."
+					]
+				}] }
+			},
+			{
+				files: ["**/routes/__root.tsx"],
+				rules: { "no-restricted-globals": "off" }
+			}
+		]
+	}, overrides);
+}
+/**
+* TanStack Start lint preset.
+*
+* Adds rules for server functions, client/server boundaries, and Start
+* conventions. This preset assumes `reactVite()` and `tanstackRouter()`
+* are already in the `extends` array.
+*
+*/
+function tanstackStart(overrides) {
+	return preset({
+		rules: {
+			"no-async-promise-executor": "error",
+			"no-await-in-loop": "off",
+			"import/no-nodejs-modules": "error",
+			"consistent-return": "error",
+			"no-empty-function": "warn"
+		},
+		overrides: [
+			{
+				files: [
+					"**/*.server.{ts,tsx}",
+					"**/server/**/*.{ts,tsx}",
+					"**/server-fns/**/*.{ts,tsx}"
+				],
+				rules: {
+					"import/no-nodejs-modules": "off",
+					"no-console": "off"
+				}
+			},
+			{
+				files: ["**/*.client.{ts,tsx}", "**/components/**/*.{ts,tsx}"],
+				rules: { "import/no-nodejs-modules": "error" }
+			},
+			{
+				files: ["**/routes/**/*.{ts,tsx}"],
+				rules: { "no-restricted-syntax": ["warn", {
+					selector: "CallExpression[callee.name=\"fetch\"]",
+					message: "Prefer a loader or server function over direct fetch in route files."
+				}] }
+			},
+			{
+				files: ["**/*.server.{ts,tsx}", "**/*.client.{ts,tsx}"],
+				plugins: ["unicorn"],
+				rules: { "unicorn/filename-case": ["error", {
+					case: "kebabCase",
+					ignore: ["\\."]
+				}] }
+			},
+			{
+				files: [
+					"**/*.server.{ts,tsx}",
+					"**/server/**/*.{ts,tsx}",
+					"**/server-fns/**/*.{ts,tsx}"
+				],
+				rules: {
+					"import/no-nodejs-modules": "off",
+					"no-console": "off",
+					"no-restricted-globals": [
+						"error",
+						{
+							name: "window",
+							message: "Not available in server context. Use a server function or guard with typeof window."
+						},
+						{
+							name: "document",
+							message: "Not available in server context."
+						},
+						{
+							name: "localStorage",
+							message: "Not available in server context."
+						},
+						{
+							name: "sessionStorage",
+							message: "Not available in server context."
+						}
+					]
+				}
+			}
+		]
+	}, overrides);
+}
+/** Accessibility lint preset — enables native jsx-a11y plugin. */
+function a11y(overrides) {
+	return preset({ plugins: ["jsx-a11y"] }, overrides);
+}
+/** JSDoc lint preset — enables native jsdoc plugin. */
+function jsdoc(overrides) {
+	return preset({ plugins: ["jsdoc"] }, overrides);
+}
+/** Vitest lint preset — native vitest plugin with test-file scoping. */
+function vitest(options) {
+	const { files, ...overrides } = options ?? {};
+	return preset({
+		plugins: ["vitest"],
+		settings: { vitest: { typecheck: true } },
+		overrides: [{
+			files: files ?? GLOB_TESTS,
+			rules: {
+				"vitest/expect-expect": "error",
+				"vitest/no-conditional-expect": "error",
+				"vitest/no-identical-title": "error",
+				"vitest/no-import-node-test": "error",
+				"vitest/no-interpolation-in-snapshots": "error",
+				"vitest/no-mocks-import": "error",
+				"vitest/no-standalone-expect": "error",
+				"vitest/valid-describe-callback": "error",
+				"vitest/valid-expect": "error",
+				"vitest/valid-title": "error",
+				"vitest/consistent-test-it": ["error", {
+					fn: "it",
+					withinDescribe: "it"
+				}],
+				"vitest/prefer-hooks-in-order": "error",
+				"vitest/prefer-lowercase-title": "error",
+				"vitest/no-disabled-tests": isInEditorEnv() ? "warn" : "error",
+				"vitest/no-focused-tests": isInEditorEnv() ? "warn" : "error",
+				"vitest/require-mock-type-parameters": "off",
+				"vitest/prefer-called-once": "error",
+				"vitest/prefer-expect-type-of": "error",
+				"vitest/prefer-to-be-object": "error",
+				"vitest/hoisted-apis-on-top": "error",
+				"vitest/require-awaited-expect-poll": "error",
+				"vitest/no-conditional-tests": "error",
+				"vitest/consistent-vitest-vi": "error",
+				"no-console": "off",
+				"unicorn/no-null": "off",
+				"typescript/ban-ts-comment": "off"
+			}
+		}]
+	}, overrides);
+}
+/** Tailwind CSS lint preset — eslint-plugin-better-tailwindcss. */
+function tailwind(options = {}) {
+	const { entryPoint = "src/styles/globals.css", rootFontSize = 16, files, ...overrides } = options;
+	return preset({
+		jsPlugins: resolvePlugins(["eslint-plugin-better-tailwindcss"]),
+		settings: { "better-tailwindcss": {
+			entryPoint,
+			rootFontSize
+		} },
+		overrides: [{
+			files: files ?? ["**/*.{jsx,tsx}"],
+			rules: {
+				"better-tailwindcss/enforce-consistent-line-wrapping": ["error", { printWidth: 0 }],
+				"better-tailwindcss/enforce-canonical-classes": "error"
+			}
+		}]
+	}, overrides);
+}
+/**
+* NestJS lint preset — loads @darraghor/eslint-plugin-nestjs-typed via jsPlugin.
+* Covers DI validation, Swagger consistency, decorator bug prevention (19 AST rules).
+*/
+function nestjs(overrides) {
+	return preset({
+		jsPlugins: resolvePlugins([{
+			name: "nestjs-typed",
+			specifier: "@darraghor/eslint-plugin-nestjs-typed"
+		}]),
+		rules: {
+			"nestjs-typed/injectable-should-be-provided": "error",
+			"nestjs-typed/provided-injected-should-match-factory-parameters": "error",
+			"nestjs-typed/use-injectable-provided-token": "error",
+			"nestjs-typed/api-property-matches-property-optionality": "error",
+			"nestjs-typed/controllers-should-supply-api-tags": "error",
+			"nestjs-typed/api-method-should-specify-api-response": "error",
+			"nestjs-typed/api-property-returning-array-should-set-array": "error",
+			"nestjs-typed/api-property-should-have-api-extra-models": "error",
+			"nestjs-typed/api-operation-summary-description-capitalized": "error",
+			"nestjs-typed/param-decorator-name-matches-route-param": "error",
+			"nestjs-typed/validate-nested-of-array-should-set-each": "error",
+			"nestjs-typed/all-properties-are-whitelisted": "error",
+			"nestjs-typed/no-duplicate-decorators": "error",
+			"nestjs-typed/validation-pipe-should-use-forbid-unknown": "error"
+		}
+	}, overrides);
+}
+/** Drizzle ORM lint preset — eslint-plugin-drizzle. */
+function drizzle(overrides) {
+	return preset({
+		jsPlugins: resolvePlugins(["eslint-plugin-drizzle"]),
+		rules: {
+			"drizzle/enforce-delete-with-where": "error",
+			"drizzle/enforce-update-with-where": "error"
+		}
+	}, overrides);
+}
+//#endregion
+export { GLOB_JS, GLOB_JSON, GLOB_JSX, GLOB_MARKDOWN, GLOB_SRC, GLOB_TESTS, GLOB_TS, a11y, base, defineConfig, depend, drizzle, jsdoc, nestjs, nextjs, node, promise, react, reactVite, tailwind, tanstackRouter, tanstackStart, typeAware, unicorn, vitest };
+
+//# sourceMappingURL=lint.mjs.map