Add oxlint with type-aware linting

- Add oxlint and oxlint-tsgolint for type-aware linting
- Configure .oxlintrc.json to disable noisy rules
- Update lint script to run oxlint on src and tests

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: Boshen

.github/workflows/ci.yml

@@ -39,6 +39,9 @@ jobs:
       - name: Check formatting
         run: pnpm run format --check
 
+      - name: Lint
+        run: pnpm run lint
+
       - name: Build Prettier Plugin
         run: pnpm run build
 

.oxlintrc.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://raw.githubusercontent.com/oxc-project/oxc/main/npm/oxlint/configuration_schema.json",
+  "rules": {
+    "typescript/unbound-method": "off"
+  }
+}

package.json

@@ -36,7 +36,7 @@
     "test": "vitest",
     "prepublishOnly": "npm run build && node scripts/copy-licenses.js",
     "format": "prettier \"src/**/*.ts\" \"scripts/**/*.js\" \"tests/*.ts\" --write --print-width 100 --single-quote --no-semi",
-    "lint": "knip",
+    "lint": "knip && oxlint --type-aware src tests/*.ts",
     "release-channel": "node ./scripts/release-channel.js",
     "release-notes": "node ./scripts/release-notes.js"
   },
@@ -62,6 +62,8 @@
     "license-checker": "^25.0.1",
     "line-column": "^1.0.2",
     "marko": "^5.37.46",
+    "oxlint": "^1.43.0",
+    "oxlint-tsgolint": "^0.11.4",
     "postcss": "^8.5.6",
     "postcss-import": "^16.1.1",
     "prettier": "^3.7.3",

pnpm-lock.yaml

@@ -33,7 +33,7 @@ export function createPlugin(transforms: TransformOptions<any>[]) {
       }
     }
 
-    for (let [name, meta] of Object.entries(opts.printers ?? {})) {
+    for (let [name, _meta] of Object.entries(opts.printers ?? {})) {
       printers[name] = async () => {
         let plugin = await loadPlugins(opts.load ?? [])
         let original = plugin.printers?.[name]
@@ -154,17 +154,13 @@ async function loadPlugins<T>(fns: PluginLoad[]) {
   }
 
   for (let moduleName of fns) {
-    try {
-      let loaded = typeof moduleName === 'string' ? await loadIfExistsESM(moduleName) : moduleName
-      Object.assign(plugin.parsers!, loaded.parsers ?? {})
-      Object.assign(plugin.printers!, loaded.printers ?? {})
-      Object.assign(plugin.options!, loaded.options ?? {})
-      Object.assign(plugin.defaultOptions!, loaded.defaultOptions ?? {})
-
-      plugin.languages = [...(plugin.languages ?? []), ...(loaded.languages ?? [])]
-    } catch (err) {
-      throw err
-    }
+    let loaded = typeof moduleName === 'string' ? await loadIfExistsESM(moduleName) : moduleName
+    Object.assign(plugin.parsers!, loaded.parsers ?? {})
+    Object.assign(plugin.printers!, loaded.printers ?? {})
+    Object.assign(plugin.options!, loaded.options ?? {})
+    Object.assign(plugin.defaultOptions!, loaded.defaultOptions ?? {})
+
+    plugin.languages = [...(plugin.languages ?? []), ...(loaded.languages ?? [])]
   }
 
   return plugin

src/create-plugin.ts

@@ -9,7 +9,7 @@ import * as prettierParserCss from 'prettier/plugins/postcss'
 import { createPlugin } from './create-plugin.js'
 import type { Matcher } from './options.js'
 import { sortClasses, sortClassList } from './sorting.js'
-import { defineTransform, type TransformOptions } from './transform.js'
+import { defineTransform } from './transform.js'
 import type { StringChange, TransformerEnv } from './types'
 import { spliceChangesIntoString, visit, type Path } from './utils.js'
 

src/index.ts

@@ -43,7 +43,7 @@ export function maybeResolve(name: string) {
     try {
       modpath = resolveJsFrom(fileURLToPath(import.meta.url), name)
       resolveCache.set(name, modpath)
-    } catch (err) {
+    } catch {
       resolveCache.set(name, null)
       return null
     }
@@ -66,7 +66,7 @@ export async function loadIfExists<T>(name: string): Promise<T | null> {
 export function resolveJsFrom(base: string, id: string): string {
   try {
     return esmResolver.resolveSync({}, base, id) || id
-  } catch (err) {
+  } catch {
     return cjsResolver.resolveSync({}, base, id) || id
   }
 }

src/resolve.ts

@@ -201,12 +201,12 @@ export async function getTailwindConfig(options: TailwindConfigOptions): Promise
   })
 }
 
-let resolvedModCache = expiringMap<string, [any | null, string | null]>(10_000)
+let resolvedModCache = expiringMap<string, [any, string | null]>(10_000)
 
 async function resolveTailwindPath(
   options: { packageName?: string },
   baseDir: string,
-): Promise<[any | null, string | null]> {
+): Promise<[any, string | null]> {
   let pkgName = options.packageName ?? 'tailwindcss'
   let makeKey = (dir: string) => `${pkgName}:${dir}`
 
@@ -218,7 +218,7 @@ async function resolveTailwindPath(
 
   let resolve = async () => {
     let pkgDir: string | null = null
-    let mod: any | null = null
+    let mod: any = null
 
     try {
       let pkgPath = resolveJsFrom(baseDir, pkgName)
@@ -228,7 +228,7 @@ async function resolveTailwindPath(
       pkgDir = path.dirname(pkgFile)
     } catch {}
 
-    return [mod, pkgDir] as [any | null, string | null]
+    return [mod, pkgDir] as [any, string | null]
   }
 
   let result = await resolve()

src/sorter.ts

@@ -1,4 +1,4 @@
-import type { AstPath, ParserOptions, Plugin } from 'prettier'
+import type { AstPath, Plugin } from 'prettier'
 import type { TransformerEnv } from './types'
 
 export function defineTransform<T>(opts: TransformOptions<T>) {

src/transform.ts

@@ -13,7 +13,7 @@ describe('spliceChangesIntoString', () => {
   function buildFixture(repeatCount: number, changeCount: number) {
     // A large set of changes across random places in the string
     let indxes = new Set(
-      Array.from({ length: changeCount }, (_, i) => Math.ceil(Math.random() * repeatCount)),
+      Array.from({ length: changeCount }, () => Math.ceil(Math.random() * repeatCount)),
     )
 
     let changes: StringChange[] = Array.from(indxes).flatMap((idx) => {