@bilazo/oxc-config 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bilazo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,452 @@
-# Temporary Holding Version
+# @bilazo/oxc-config
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **Note:** This is a community preset collection for the [Oxc](https://oxc.rs) toolchain. Not affiliated with the official Oxc project.
+
+Shared [Oxlint](https://oxc.rs/) + [Oxfmt](https://oxc.rs/docs/guide/usage/formatter) presets for my projects. One install, lint and format ready.
+
+## Install
+
+```bash
+pnpm add -D @bilazo/oxc-config
+```
+
+> [!TIP]
+> Works with pnpm strict mode out of the box — jsPlugin paths are resolved internally via `require.resolve()`, no hoisting hacks needed.
+
+## Lint (Oxlint)
+
+Create `oxlint.config.ts` in your project root:
+
+```ts
+import { base, unicorn, depend, reactVite, tailwind } from '@bilazo/oxc-config/lint'
+import { defineConfig } from 'oxlint'
+
+export default defineConfig({
+  extends: [base(), unicorn(), depend(), reactVite(), tailwind()],
+})
+```
+
+Every preset is a function. Call without arguments for defaults, or pass overrides:
+
+```ts
+export default defineConfig({
+  extends: [
+    base({ rules: { 'no-console': 'off' } }),
+    unicorn({ rules: { 'unicorn/no-array-for-each': 'off' } }),
+    vitest({ files: ['**/*.e2e-spec.ts', '**/*.spec.ts'] }),
+  ],
+})
+```
+
+> [!IMPORTANT]
+> Most presets use deep merge via `defu` — user values take priority. File scope options **replace** their defaults (e.g. `vitest({ files: [...] })` replaces the default test globs).
+
+### Available presets
+
+#### Core
+
+| Preset        | Description                                                         |
+| ------------- | ------------------------------------------------------------------- |
+| `base()`      | TypeScript, Import, categories, env, ignores. Always include first. |
+| `typeAware()` | 59 type-aware rules via tsgolint (requires TS-compatible tsconfig)  |
+| `unicorn()`   | 100+ code quality rules                                             |
+| `depend()`    | Flag packages replaceable with native APIs or micro-utilities       |
+
+#### Runtime
+
+| Preset      | Description                       |
+| ----------- | --------------------------------- |
+| `node()`    | Node.js specific rules            |
+| `promise()` | Promise best practices (16 rules) |
+
+#### Frontend
+
+| Preset             | Description                                                     |
+| ------------------ | --------------------------------------------------------------- |
+| `react()`          | React + React Hooks — core rules for any React setup            |
+| `reactVite()`      | React + React Hooks + React Refresh (for Vite)                  |
+| `nextjs()`         | Next.js rules + Core Web Vitals                                 |
+| `tanstackRouter()` | TanStack Router — routing rules + route folder naming convention |
+| `tanstackStart()`  | TanStack Start — server/client boundaries, SSR safety           |
+| `tailwind()`       | Tailwind class consistency (better-tailwindcss plugin)          |
+
+#### Backend / ORM
+
+| Preset      | Description                                                            |
+| ----------- | ---------------------------------------------------------------------- |
+| `nestjs()`  | NestJS DI validation, Swagger consistency, decorator checks (14 rules) |
+| `drizzle()` | Drizzle ORM — enforce where clause on delete/update                    |
+
+#### Quality
+
+| Preset    | Description              |
+| --------- | ------------------------ |
+| `a11y()`  | JSX accessibility (WCAG) |
+| `jsdoc()` | JSDoc validation         |
+
+#### Testing
+
+| Preset     | Description                              |
+| ---------- | ---------------------------------------- |
+| `vitest()` | Vitest best practices, environment-aware |
+
+### Which React preset should I use?
+
+| Project type              | Presets to use                                    |
+| ------------------------- | ------------------------------------------------- |
+| Next.js                   | `nextjs()` + `react()`                            |
+| Vite + React              | `reactVite()`                                     |
+| TanStack Router (SPA)     | `reactVite()` + `tanstackRouter()`                |
+| TanStack Start            | `reactVite()` + `tanstackRouter()` + `tanstackStart()` |
+| Plain React (custom build)| `react()`                                         |
+
+> `reactVite()` adds `eslint-plugin-react-refresh` to warn about incorrect fast-refresh patterns — use it for any Vite-based setup.
+
+### React rules
+
+The `react()` and `reactVite()` presets enable **~27 rules** covering:
+
+- **Hooks (critical):** `rules-of-hooks`, `exhaustive-deps`
+- **JSX correctness:** `jsx-key`, `jsx-no-duplicate-props`, `jsx-no-undef`, `jsx-no-target-blank`, `jsx-no-script-url`, `jsx-no-comment-textnodes`
+- **JSX style:** `jsx-boolean-value`, `jsx-curly-brace-presence`, `jsx-fragments`, `jsx-pascal-case`, `self-closing-comp`, `hook-use-state`
+- **Runtime safety:** `no-children-prop`, `no-danger-with-children`, `no-deprecated`, `no-direct-mutation-state`, `no-find-dom-node`, `no-is-mounted`, `no-render-return-value`, `no-string-refs`, `no-unknown-property`, `no-unsafe`, `require-render-return`, `void-dom-elements-no-children`
+
+Modern React 17+ is assumed — `react/react-in-jsx-scope` and `react/jsx-uses-react` are off.
+
+### TanStack Router
+
+The `tanstackRouter()` preset loads [`@tanstack/eslint-plugin-router`](https://www.npmjs.com/package/@tanstack/eslint-plugin-router) and enforces file naming for the `routes/` folder.
+
+```ts
+import { base, reactVite, tanstackRouter, tailwind } from '@bilazo/oxc-config/lint'
+import { defineConfig } from 'oxlint'
+
+export default defineConfig({
+  extends: [base(), reactVite(), tanstackRouter(), tailwind()],
+})
+```
+
+**Rules provided:**
+
+- `tanstack-router/route-param-names` — validates `$param` names between route path and params
+- `tanstack-router/create-route-property-order` — enforces property order in `createRoute()`
+
+**File naming convention:**
+
+All files inside a `routes/` folder must be **kebab-case**:
+
+| Filename                    | Valid? | Notes                                  |
+| --------------------------- | ------ | -------------------------------------- |
+| `posts.tsx`                 | ✅     |                                        |
+| `posts-index.tsx`           | ✅     |                                        |
+| `about-page.tsx`            | ✅     |                                        |
+| `posts.$postId.tsx`         | ✅     | exception: `$` dynamic params          |
+| `_auth.tsx`                 | ✅     | exception: `_` pathless routes         |
+| `__root.tsx`                | ✅     | exception: `_` prefix                  |
+| `posts.index.tsx`           | ✅     | exception: multiple dots (file nesting)|
+| `Posts.tsx`                 | ❌     | must be `posts.tsx`                    |
+| `postsIndex.tsx`            | ❌     | must be `posts-index.tsx`              |
+| `posts_index.tsx`           | ❌     | must be `posts-index.tsx`              |
+
+> [!NOTE]
+> Folder naming inside `routes/` is **not** covered by Oxlint (linters run file-by-file). To enforce kebab-case for folders, use a separate script or CI step.
+
+### TanStack Start
+
+The `tanstackStart()` preset adds rules for **server/client boundaries**, **server function safety**, and **SSR conventions**.
+
+> [!IMPORTANT]
+> This preset does **not** include `reactVite()` or `tanstackRouter()`. Add them in the correct order:
+>
+> ```ts
+> extends: [base(), reactVite(), tanstackRouter(), tanstackStart(), tailwind(), vitest()]
+> ```
+
+**Rules added:**
+
+- `no-async-promise-executor`, `consistent-return`, `no-empty-function`
+- `import/no-nodejs-modules` — prevents Node.js APIs from leaking into client bundles
+- `no-restricted-globals` for `window`/`document`/`localStorage`/`sessionStorage` in server files
+
+**File scope conventions:**
+
+| File pattern                                                    | Behavior                                              |
+| --------------------------------------------------------------- | ----------------------------------------------------- |
+| `**/*.server.{ts,tsx}`, `**/server/**`, `**/server-fns/**`      | Node.js APIs allowed, browser globals forbidden       |
+| `**/*.client.{ts,tsx}`, `**/components/**`                      | Node.js APIs forbidden                                |
+| `**/routes/**`                                                  | Warning on direct `fetch()` — prefer loaders          |
+
+**Example:**
+
+```ts
+import {
+  base,
+  unicorn,
+  depend,
+  reactVite,
+  tanstackRouter,
+  tanstackStart,
+  tailwind,
+  vitest,
+} from '@bilazo/oxc-config/lint'
+import { defineConfig } from 'oxlint'
+
+export default defineConfig({
+  extends: [
+    base(),
+    unicorn(),
+    depend(),
+    reactVite(),
+    tanstackRouter(),
+    tanstackStart(),
+    tailwind({ entryPoint: 'src/styles/globals.css' }),
+    vitest(),
+  ],
+})
+```
+
+### NestJS
+
+> [!WARNING]
+> NestJS must disable `typescript/consistent-type-imports` — NestJS DI uses runtime class references in constructor params, and without type-aware linting this rule incorrectly converts them to `import type`, breaking DI at runtime.
+
+```ts
+import { base, node, promise, nestjs, drizzle, vitest } from '@bilazo/oxc-config/lint'
+import { defineConfig } from 'oxlint'
+
+export default defineConfig({
+  extends: [
+    base(),
+    node(),
+    promise(),
+    nestjs(),
+    drizzle({
+      rules: {
+        'drizzle/enforce-delete-with-where': ['error', { drizzleObjectName: 'db' }],
+        'drizzle/enforce-update-with-where': ['error', { drizzleObjectName: 'db' }],
+      },
+    }),
+    vitest({ files: ['**/*.spec.ts', '**/*.e2e-spec.ts'] }),
+  ],
+  rules: {
+    // NestJS exception filter .catch() is not Promise.catch()
+    'promise/valid-params': 'off',
+  },
+  overrides: [
+    {
+      files: ['**/*.{ts,mts,cts,tsx}'],
+      rules: {
+        'typescript/consistent-type-imports': 'off',
+        'typescript/no-extraneous-class': ['error', { allowWithDecorator: true }],
+      },
+    },
+  ],
+})
+```
+
+### Type-aware linting
+
+The `typeAware()` preset enables two options on oxlint:
+
+- **`typeAware`** — turns on ~59 lint rules that need type information, implemented via [`oxlint-tsgolint`](https://www.npmjs.com/package/oxlint-tsgolint) (e.g. `no-floating-promises`, `no-misused-promises`, `consistent-type-imports`)
+- **`typeCheck`** — pipes the TypeScript compiler's own diagnostics (`TS2322`, `TS6133`, `TS2307`, ...) through oxlint, so `oxlint` reports type errors alongside lint violations
+
+```ts
+import { base, typeAware, unicorn } from '@bilazo/oxc-config/lint'
+import { defineConfig } from 'oxlint'
+
+export default defineConfig({
+  extends: [base(), typeAware(), unicorn()],
+})
+```
+
+> [!IMPORTANT]
+> `typeAware` and `typeCheck` are **root-config-only** options. Oxlint will error if either is set in a nested (per-package) config file. Always place `typeAware()` in the root config only.
+
+Each package's own `tsconfig.json` is auto-detected by oxlint — no extra configuration needed.
+
+#### Do I still need a separate `tsc --noEmit` step?
+
+**Yes, keep it.** With `typeCheck` enabled, `oxlint` already surfaces tsc diagnostics for the files it lints, so during local development you'll usually catch type errors from `lint` alone. But a dedicated `typecheck` script is still worth keeping because:
+
+- **Different file scope.** `tsc --noEmit` honors the tsconfig's `include`/`exclude`. `oxlint` walks the filesystem by its own rules and honors `ignorePatterns`. The two sets overlap but are not identical.
+- **Project-level diagnostics.** tsc catches errors that aren't attached to a single source file: `tsconfig.json` misconfiguration (`TS5xxx`), broken project `references`, `paths` alias typos.
+- **Clearer CI failures.** Running `typecheck` and `lint` as separate steps makes it obvious whether a red build is a type error or a lint rule violation.
+
+### Monorepo (nested configs)
+
+Oxlint supports [nested configuration](https://oxc.rs/docs/guide/usage/linter/nested-config.html) for monorepos. Each package can have its own `oxlint.config.ts` that extends the root config and adds package-specific presets.
+
+#### Root config
+
+```ts
+// oxlint.config.ts (root)
+import { base, typeAware, unicorn, depend } from '@bilazo/oxc-config/lint'
+import { defineConfig } from 'oxlint'
+
+export default defineConfig({
+  extends: [base(), typeAware(), unicorn(), depend()],
+})
+```
+
+#### Package configs
+
+```ts
+// packages/web/oxlint.config.ts
+import rootConfig from '../../oxlint.config.ts'
+import { reactVite, tanstackRouter, tanstackStart, vitest, tailwind } from '@bilazo/oxc-config/lint'
+import { defineConfig } from 'oxlint'
+
+export default defineConfig({
+  extends: [rootConfig, reactVite(), tanstackRouter(), tanstackStart(), vitest(), tailwind()],
+})
+```
+
+```ts
+// packages/api/oxlint.config.ts
+import rootConfig from '../../oxlint.config.ts'
+import { node, nestjs, drizzle, vitest } from '@bilazo/oxc-config/lint'
+import { defineConfig } from 'oxlint'
+
+export default defineConfig({
+  extends: [rootConfig, node(), nestjs(), drizzle(), vitest()],
+})
+```
+
+> [!TIP]
+> Packages without their own `oxlint.config.ts` automatically use the root config.
+
+> [!WARNING]
+> Passing `-c` or `--config` explicitly on the CLI **disables** nested config lookup. Let oxlint auto-detect configs by running without `-c`.
+
+## Format (Oxfmt)
+
+Create `oxfmt.config.ts`:
+
+```ts
+import { format } from '@bilazo/oxc-config/format'
+import { defineConfig } from 'oxfmt'
+
+export default defineConfig({ ...format() })
+```
+
+### Defaults
+
+| Option               | Value                 |
+| -------------------- | --------------------- |
+| `semi`               | `false`               |
+| `singleQuote`        | `true`                |
+| `trailingComma`      | `all`                 |
+| `printWidth`         | `100`                 |
+| `tabWidth`           | `2`                   |
+| `endOfLine`          | `lf`                  |
+| Import sorting       | Grouped with newlines |
+| Package.json sorting | Enabled               |
+| Ignore patterns      | Build outputs, lockfiles, generated files |
+
+### Override
+
+```ts
+export default defineConfig({
+  ...format({ printWidth: 120, semi: true }),
+})
+```
+
+### Tailwind class sorting
+
+```ts
+import { format, tailwindFormat } from '@bilazo/oxc-config/format'
+
+export default defineConfig({
+  ...format(),
+  ...tailwindFormat({ stylesheet: 'src/styles/globals.css' }),
+})
+```
+
+### Editor setup (recommended)
+
+To keep line endings consistent and avoid the "final newline flip-flop" problem, add an `.editorconfig` at the root of every project:
+
+```ini
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+max_line_length = 100
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+```
+
+Most modern editors support EditorConfig natively or via a plugin. This ensures LF endings and a single trailing newline across every file.
+
+## Scripts
+
+```json
+{
+  "scripts": {
+    "lint": "oxlint .",
+    "lint:fix": "oxlint . --fix",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check .",
+    "typecheck": "tsc --noEmit"
+  }
+}
+```
+
+## Full-stack example (TanStack Start + NestJS)
+
+```ts
+// apps/web/oxlint.config.ts
+import rootConfig from '../../oxlint.config.ts'
+import { reactVite, tanstackRouter, tanstackStart, tailwind, vitest } from '@bilazo/oxc-config/lint'
+import { defineConfig } from 'oxlint'
+
+export default defineConfig({
+  extends: [
+    rootConfig,
+    reactVite(),
+    tanstackRouter(),
+    tanstackStart(),
+    tailwind(),
+    vitest(),
+  ],
+})
+```
+
+```ts
+// apps/api/oxlint.config.ts
+import rootConfig from '../../oxlint.config.ts'
+import { node, promise, nestjs, drizzle, vitest } from '@bilazo/oxc-config/lint'
+import { defineConfig } from 'oxlint'
+
+export default defineConfig({
+  extends: [rootConfig, node(), promise(), nestjs(), drizzle(), vitest()],
+  overrides: [
+    {
+      files: ['**/*.{ts,mts,cts,tsx}'],
+      rules: {
+        'typescript/consistent-type-imports': 'off',
+        'typescript/no-extraneous-class': ['error', { allowWithDecorator: true }],
+      },
+    },
+  ],
+})
+```
+
+## License
+
+MIT
+
+## Sources
+
+1. [Oxlint: Writing JS Plugins](https://oxc.rs/docs/guide/usage/linter/writing-js-plugins.html)
+2. [infra-code source](https://github.com/oNo500/infra-code/tree/master/packages/code-quality)

package/dist/format.d.mts

@@ -0,0 +1,13 @@
+import { OxfmtConfig } from "oxfmt";
+//#region src/format.d.ts
+/** Base format preset. Pass overrides to customize. */
+export declare function format(overrides?: Record<string, unknown>): OxfmtConfig;
+/**
+ * Oxfmt Tailwind class-sorting preset.
+ * Spread into your format config alongside `format()` to enable.
+ */
+export declare function tailwindFormat(options?: {
+  stylesheet?: string;
+}): OxfmtConfig;
+//#endregion
+//# sourceMappingURL=format.d.mts.map

package/dist/format.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.mts","names":[],"sources":["../src/format.ts"],"mappings":";;;wBAqBgB,OAAO,YAAY,0BAA0B;;;;;wBA4E7C,eAAe;EAAW;IAA6B"}

package/dist/format.mjs

@@ -0,0 +1,98 @@
+import { defu } from "defu";
+//#region src/format.ts
+/**
+* Oxfmt format presets.
+*
+* @example
+* ```ts
+* // oxfmt.config.ts
+* import { format, tailwindFormat } from '@bilazo/oxc-config/format'
+* import { defineConfig } from 'oxfmt'
+*
+* export default defineConfig({
+*   ...format(),
+*   ...tailwindFormat({ stylesheet: 'src/styles/globals.css' }),
+* })
+* ```
+*/
+/** Base format preset. Pass overrides to customize. */
+function format(overrides) {
+	return defu(overrides, {
+		printWidth: 100,
+		tabWidth: 2,
+		useTabs: false,
+		endOfLine: "lf",
+		semi: false,
+		singleQuote: true,
+		jsxSingleQuote: false,
+		quoteProps: "consistent",
+		trailingComma: "all",
+		bracketSpacing: true,
+		bracketSameLine: false,
+		arrowParens: "always",
+		sortPackageJson: true,
+		sortImports: {
+			groups: [
+				"builtin",
+				{ newlinesBetween: true },
+				"external",
+				{ newlinesBetween: true },
+				"internal",
+				{ newlinesBetween: true },
+				["parent", "sibling"],
+				{ newlinesBetween: true },
+				"index",
+				{ newlinesBetween: true },
+				"type"
+			],
+			internalPattern: [
+				"~/",
+				"@/",
+				"#/"
+			]
+		},
+		ignorePatterns: [
+			"dist/**",
+			"build/**",
+			"out/**",
+			".output/**",
+			".next/**",
+			".turbo/**",
+			".cache/**",
+			".nitro/**",
+			".tanstack/**",
+			".vinxi/**",
+			".content-collections/**",
+			"public/**",
+			"coverage/**",
+			"**/api",
+			"**/build",
+			"**/public",
+			"routeTree.gen.ts",
+			"*.min.js",
+			"*.min.css",
+			"pnpm-lock.yaml",
+			"package-lock.json",
+			"yarn.lock"
+		]
+	});
+}
+/**
+* Oxfmt Tailwind class-sorting preset.
+* Spread into your format config alongside `format()` to enable.
+*/
+function tailwindFormat(options = {}) {
+	return { sortTailwindcss: {
+		stylesheet: options.stylesheet ?? "src/styles/globals.css",
+		functions: [
+			"cn",
+			"clsx",
+			"cva",
+			"tw"
+		]
+	} };
+}
+//#endregion
+export { format, tailwindFormat };
+
+//# sourceMappingURL=format.mjs.map

package/dist/format.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.mjs","names":[],"sources":["../src/format.ts"],"sourcesContent":["/**\n * Oxfmt format presets.\n *\n * @example\n * ```ts\n * // oxfmt.config.ts\n * import { format, tailwindFormat } from '@bilazo/oxc-config/format'\n * import { defineConfig } from 'oxfmt'\n *\n * export default defineConfig({\n *   ...format(),\n *   ...tailwindFormat({ stylesheet: 'src/styles/globals.css' }),\n * })\n * ```\n */\n\nimport { defu } from 'defu'\n\nimport type { OxfmtConfig } from 'oxfmt'\n\n/** Base format preset. Pass overrides to customize. */\nexport function format(overrides?: Record<string, unknown>): OxfmtConfig {\n  return defu(overrides, {\n    // Layout\n    printWidth: 100,\n    tabWidth: 2,\n    useTabs: false,\n    endOfLine: 'lf' as const,\n\n    // Quotes & Semicolons\n    semi: false,\n    singleQuote: true,\n    jsxSingleQuote: false,\n    quoteProps: 'consistent' as const,\n\n    // Trailing & Spacing\n    trailingComma: 'all' as const,\n    bracketSpacing: true,\n    bracketSameLine: false,\n    arrowParens: 'always' as const,\n\n    // Sorting\n    sortPackageJson: true,\n    sortImports: {\n      groups: [\n        'builtin',\n        { newlinesBetween: true },\n        'external',\n        { newlinesBetween: true },\n        'internal',\n        { newlinesBetween: true },\n        ['parent', 'sibling'],\n        { newlinesBetween: true },\n        'index',\n        { newlinesBetween: true },\n        'type',\n      ],\n      internalPattern: ['~/', '@/', '#/'],\n    },\n\n    // Ignore\n    ignorePatterns: [\n      // Build outputs\n      'dist/**',\n      'build/**',\n      'out/**',\n      '.output/**',\n      '.next/**',\n      '.turbo/**',\n      '.cache/**',\n      '.nitro/**',\n      '.tanstack/**',\n      '.vinxi/**',\n      '.content-collections/**',\n\n      // Generated / vendor\n      'public/**',\n      'coverage/**',\n      '**/api',\n      '**/build',\n      '**/public',\n      'routeTree.gen.ts',\n      '*.min.js',\n      '*.min.css',\n\n      // Lock files\n      'pnpm-lock.yaml',\n      'package-lock.json',\n      'yarn.lock',\n    ],\n  }) as OxfmtConfig\n}\n\n/**\n * Oxfmt Tailwind class-sorting preset.\n * Spread into your format config alongside `format()` to enable.\n */\nexport function tailwindFormat(options: { stylesheet?: string } = {}): OxfmtConfig {\n  return {\n    sortTailwindcss: {\n      stylesheet: options.stylesheet ?? 'src/styles/globals.css',\n      functions: ['cn', 'clsx', 'cva', 'tw'] as string[],\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,SAAgB,OAAO,WAAkD;CACvE,OAAO,KAAK,WAAW;EAErB,YAAY;EACZ,UAAU;EACV,SAAS;EACT,WAAW;EAGX,MAAM;EACN,aAAa;EACb,gBAAgB;EAChB,YAAY;EAGZ,eAAe;EACf,gBAAgB;EAChB,iBAAiB;EACjB,aAAa;EAGb,iBAAiB;EACjB,aAAa;GACX,QAAQ;IACN;IACA,EAAE,iBAAiB,KAAK;IACxB;IACA,EAAE,iBAAiB,KAAK;IACxB;IACA,EAAE,iBAAiB,KAAK;IACxB,CAAC,UAAU,SAAS;IACpB,EAAE,iBAAiB,KAAK;IACxB;IACA,EAAE,iBAAiB,KAAK;IACxB;GACF;GACA,iBAAiB;IAAC;IAAM;IAAM;GAAI;EACpC;EAGA,gBAAgB;GAEd;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GAGA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GAGA;GACA;GACA;EACF;CACF,CAAC;AACH;;;;;AAMA,SAAgB,eAAe,UAAmC,CAAC,GAAgB;CACjF,OAAO,EACL,iBAAiB;EACf,YAAY,QAAQ,cAAc;EAClC,WAAW;GAAC;GAAM;GAAQ;GAAO;EAAI;CACvC,EACF;AACF"}

package/dist/lint.d.mts

@@ -0,0 +1,90 @@
+import { OxlintConfig, defineConfig } from "oxlint";
+//#region src/utils.d.ts
+/** All JS/TS source files */
+export declare const GLOB_SRC = "**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}";
+/** JavaScript files only */
+export declare const GLOB_JS = "**/*.{js,mjs,cjs,jsx}";
+/** TypeScript files only */
+export declare const GLOB_TS = "**/*.{ts,mts,cts,tsx}";
+/** JSX/TSX files (React-related) */
+export declare const GLOB_JSX = "**/*.{jsx,tsx}";
+/** Test files */
+export declare const GLOB_TESTS: string[];
+/** JSON files */
+export declare const GLOB_JSON = "**/*.json";
+/** Markdown files */
+export declare const GLOB_MARKDOWN = "**/*.md";
+//#endregion
+//#region src/lint.d.ts
+/**
+ * Base lint preset — TypeScript + Import plugins, categories, env, ignores.
+ * Always include first.
+ */
+export declare function base(overrides?: Partial<OxlintConfig>): OxlintConfig;
+/**
+ * Type-aware lint preset — enables 59 type-aware rules via tsgolint + type checking.
+ * Requires TypeScript 7.0+ and `oxlint-tsgolint` (bundled as dependency).
+ */
+export declare function typeAware(overrides?: Partial<OxlintConfig>): OxlintConfig;
+/** Unicorn lint preset — 100+ code quality rules. */
+export declare function unicorn(overrides?: Partial<OxlintConfig>): OxlintConfig;
+/** Dependency optimization — flags packages replaceable with native APIs. */
+export declare function depend(overrides?: Partial<OxlintConfig>): OxlintConfig;
+/** Node.js lint preset — native node plugin. */
+export declare function node(overrides?: Partial<OxlintConfig>): OxlintConfig;
+/** Promise lint preset — native promise plugin. */
+export declare function promise(overrides?: Partial<OxlintConfig>): OxlintConfig;
+/** React lint preset — core React + Hooks rules. */
+export declare function react(overrides?: Partial<OxlintConfig>): OxlintConfig;
+/** React + react-refresh preset (for Vite, TanStack Start, etc.). */
+export declare function reactVite(overrides?: Partial<OxlintConfig>): OxlintConfig;
+/** Next.js lint preset — enables native nextjs plugin. */
+export declare function nextjs(overrides?: Partial<OxlintConfig>): OxlintConfig;
+/**
+ * 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()`
+ */
+export declare function tanstackRouter(overrides?: Partial<OxlintConfig>): OxlintConfig;
+/**
+ * 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.
+ *
+ */
+export declare function tanstackStart(overrides?: Partial<OxlintConfig>): OxlintConfig;
+/** Accessibility lint preset — enables native jsx-a11y plugin. */
+export declare function a11y(overrides?: Partial<OxlintConfig>): OxlintConfig;
+/** JSDoc lint preset — enables native jsdoc plugin. */
+export declare function jsdoc(overrides?: Partial<OxlintConfig>): OxlintConfig;
+interface VitestOptions extends Partial<OxlintConfig> {
+  /** Test file glob patterns. Replaces the default GLOB_TESTS. */
+  files?: string[];
+}
+/** Vitest lint preset — native vitest plugin with test-file scoping. */
+export declare function vitest(options?: VitestOptions): OxlintConfig;
+interface TailwindOptions extends Partial<OxlintConfig> {
+  entryPoint?: string;
+  rootFontSize?: number;
+  /** File glob patterns for tailwind rules. @default GLOB_JSX */
+  files?: string[];
+}
+/** Tailwind CSS lint preset — eslint-plugin-better-tailwindcss. */
+export declare function tailwind(options?: TailwindOptions): OxlintConfig;
+/**
+ * NestJS lint preset — loads @darraghor/eslint-plugin-nestjs-typed via jsPlugin.
+ * Covers DI validation, Swagger consistency, decorator bug prevention (19 AST rules).
+ */
+export declare function nestjs(overrides?: Partial<OxlintConfig>): OxlintConfig;
+/** Drizzle ORM lint preset — eslint-plugin-drizzle. */
+export declare function drizzle(overrides?: Partial<OxlintConfig>): OxlintConfig;
+//#endregion
+export { defineConfig };
+//# sourceMappingURL=lint.d.mts.map