Resolves #627

haydenbleasel · haydenbleasel · commit 581ea40aafd4 · 2026-03-28T23:36:26.000-07:00
diff --git a/.changeset/fix-typed-oxlint-exports.md b/.changeset/fix-typed-oxlint-exports.md
@@ -0,0 +1,5 @@
+---
+"ultracite": patch
+---
+
+Add typed `ultracite/oxlint` exports for use in `oxlint.config.ts`.
diff --git a/apps/docs/provider/oxlint.mdx b/apps/docs/provider/oxlint.mdx
@@ -49,6 +49,18 @@ Add framework presets as needed:
 }
 ```
 
+If you prefer `oxlint.config.ts`, use Ultracite's typed exports instead of importing the JSON presets directly:
+
+```ts title="oxlint.config.ts"
+import { defineConfig } from "oxlint";
+
+import { core, next, react } from "ultracite/oxlint";
+
+export default defineConfig({
+  extends: [core, react, next],
+});
+```
+
 ## Configuration Approach
 
 Ultracite's Oxlint configuration uses an **opt-out** approach. This means we enable all rule categories at the `error` level, then selectively disable rules that are too strict or don't fit our opinionated defaults. This ensures maximum bug-catching coverage while avoiding noise.
diff --git a/packages/cli/README.md b/packages/cli/README.md
@@ -18,6 +18,20 @@ npx ultracite init
 
 The interactive setup will guide you through selecting your formatter/linter, framework, editor, and AI agents.
 
+## Oxlint TypeScript Configs
+
+If you're using `oxlint.config.ts`, import the typed presets instead of the raw JSON files:
+
+```ts
+import { defineConfig } from "oxlint";
+
+import { core, next, react } from "ultracite/oxlint";
+
+export default defineConfig({
+  extends: [core, react, next],
+});
+```
+
 ## Supported Tools
 
 - **Biome** — All-in-one formatting and linting
diff --git a/packages/cli/__tests__/oxlint-exports.test.ts b/packages/cli/__tests__/oxlint-exports.test.ts
@@ -0,0 +1,30 @@
+import { describe, expect, test } from "bun:test";
+import { join } from "node:path";
+import { parse } from "jsonc-parser";
+
+import { configs, core, next, react } from "../src/oxlint";
+
+const readOxlintConfig = async (name: string) => {
+  const configPath = join(
+    import.meta.dirname,
+    `../config/oxlint/${name}/.oxlintrc.json`
+  );
+  const content = await Bun.file(configPath).text();
+  const config = parse(content) as Record<string, unknown>;
+
+  delete config.$schema;
+
+  return config;
+};
+
+describe("oxlint TypeScript exports", () => {
+  for (const [name, config] of Object.entries(configs)) {
+    test(`${name} matches the published JSON preset`, async () => {
+      expect(config).toEqual(await readOxlintConfig(name));
+    });
+  }
+
+  test("core, react, and next compose in extends arrays", () => {
+    expect([core, react, next]).toHaveLength(3);
+  });
+});
diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -24,12 +24,15 @@
   },
   "files": [
     "config",
-    "dist/index.js",
-    "dist/index.d.ts",
+    "dist",
     "README.md"
   ],
   "type": "module",
   "exports": {
+    "./oxlint": {
+      "types": "./dist/oxlint.d.ts",
+      "default": "./dist/oxlint.js"
+    },
     "./biome/*": "./config/biome/*/biome.jsonc",
     "./eslint/*": "./config/eslint/*/eslint.config.mjs",
     "./oxlint/*": "./config/oxlint/*/.oxlintrc.json",
diff --git a/packages/cli/src/oxlint.ts b/packages/cli/src/oxlint.ts
diff --git a/packages/cli/tsup.config.ts b/packages/cli/tsup.config.ts

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +"ultracite": patch
 +---
++
 +Add typed `ultracite/oxlint` exports for use in `oxlint.config.ts`.