biome-to-oxc 3.0.0 → 3.5.0

package/README.md

@@ -22,6 +22,8 @@ Current capabilities:
 
 - Converts `biome.json`/`biome.jsonc` to `.oxlintrc.json` and `.oxfmtrc.jsonc`
 - Maps 80+ Biome linter rules to Oxlint equivalents (native `typescript/` rules)
+- Substitutes a non-type-aware Oxlint rule for the three Biome rules that need no types but whose
+  only Oxlint counterpart is type-aware, so a migration without tsgolint keeps their coverage
 - Transforms Biome formatter options to Oxfmt (Prettier-compatible)
 - Normalizes `include`/`includes` field variations automatically
 
@@ -37,7 +39,10 @@ Current capabilities:
 - Rule severities (`error`/`warn`/`off`; `info` and `on` are accepted with explicit lossy-mapping warnings)
 - Explicit `printWidth` handling (no silent changes)
 - The set of formatted files: Oxfmt-only formats (YAML, TOML, Markdown) are excluded, and
-  `sortPackageJson` is pinned off, so migrating never reformats files Biome left alone
+  `sortPackageJson` is pinned off unless the Biome config turns the matching assist action on, so
+  migrating never reformats files Biome left alone
+- Assist actions: `organizeImports` and `useSortedPackageJson` become the Oxfmt options that
+  implement them, and every other `assist.actions.source` entry is reported as a loss
 
 ✅ **Refuses to Lose Behaviour Silently**
 
@@ -301,6 +306,52 @@ Oxlint's broader `restriction` category.
 | bracketSpacing   | bracketSpacing  | Direct mapping                                                |
 | bracketSameLine  | bracketSameLine | Direct mapping                                                |
 
+### Type-Aware Rule Fallbacks
+
+Three Biome rules need no type information, but their only Oxlint counterpart is a type-aware
+(tsgolint) rule. Type-aware linting is off unless the migration enables it, so mapping straight to
+the tsgolint rule would drop diagnostics the Biome config did produce. When type-aware linting is
+off, a non-type-aware Oxlint rule takes its place instead:
+
+| Biome Rule                | Type-aware mapping                          | Fallback when type-aware is off          |
+| ------------------------- | ------------------------------------------- | ---------------------------------------- |
+| `useArrayFind`            | `typescript/prefer-find`                    | `unicorn/prefer-array-find`              |
+| `useIncludes`             | `typescript/prefer-includes`                | `unicorn/prefer-includes`                |
+| `useStringStartsEndsWith` | `typescript/prefer-string-starts-ends-with` | `unicorn/prefer-string-starts-ends-with` |
+
+The fallback replaces the type-aware rule rather than joining it, so turning type-aware linting on
+later can never report the same line twice. The first two pairs report exactly what the Biome rule
+reports; `unicorn/prefer-string-starts-ends-with` covers only the anchored-regex form of the four
+Biome flags, so that substitution is reported as a semantic loss.
+
+Every other Biome rule that maps only to a type-aware Oxlint rule — `noFloatingPromises`,
+`noMisusedPromises`, `useOptionalChain` and the rest — needs types on both sides and has no
+fallback.
+
+### Assist Actions
+
+Biome's assist actions are code actions rather than lint rules. Oxfmt implements two of them as
+formatter options; the rest have no Oxc equivalent and are reported as semantic losses.
+
+| Biome Assist Action    | Oxfmt Option      | Notes                                                            |
+| ---------------------- | ----------------- | ---------------------------------------------------------------- |
+| `organizeImports`      | `sortImports`     | `options.sortBareImports` → `sortImports.sortSideEffects`        |
+| `useSortedPackageJson` | `sortPackageJson` | Lifts the default pin that keeps Oxfmt from sorting package.json |
+
+Only actions the Biome config names explicitly are migrated. Biome enables `organizeImports`
+through its recommended set even when the config never mentions it, but both Oxfmt options default
+to off here, so deriving them from a preset would start rewriting imports in projects whose Biome
+config never asked for it. When a preset is what turned the actions on, the migration reports it.
+
+Biome's `organizeImports` `groups` are matcher predicates (`:NODE:`, source globs) while Oxfmt's
+are a fixed set of group names, so custom group ordering is reported as a loss rather than guessed
+at. Per-override `assist` is not migrated either, and is likewise reported.
+
+Biome and Oxfmt sort imports and `package.json` keys into different orders, so the first Oxfmt run
+after migrating either action reorders once; the migration warns about it. And because Biome sorts
+imports by default through its recommended assist set, a config that never settles
+`organizeImports` also gets a warning: Oxfmt leaves imports alone unless `sortImports` is set.
+
 ## After Migration
 
 1. **Review generated configs**
@@ -380,6 +431,9 @@ npx oxlint --type-aware --type-check
   targeted typescript-eslint rules are currently implemented
 - CSS and JSON formatter overrides are mapped but may need manual review
 - Prettier plugin support is not available in Oxfmt
+- Assist actions are migrated only when the Biome config names them explicitly; actions enabled
+  through `recommended` or a preset are reported rather than derived
+- `organizeImports` custom `groups` and `identifierOrder` have no Oxfmt counterpart and are reported
 - Some Biome rules still require JS plugin fallback until native rule parity is available
 
 ## Migration Report

package/dist/bin/biome-to-oxc.d.mts

@@ -7,7 +7,6 @@ interface CliRuntimeOptions {
   stderr?: CliWriteStream;
   stdout?: CliWriteStream;
 }
-declare function runCli(argv: string[], runtimeOptions?: CliRuntimeOptions): Promise<number>;
-declare function createTerminationHandler(signalName: NodeJS.Signals, controller: AbortController, stderr: CliWriteStream): () => void;
-//#endregion
-export { createTerminationHandler, runCli };
+export declare function runCli(argv: string[], runtimeOptions?: CliRuntimeOptions): Promise<number>;
+export declare function createTerminationHandler(signalName: NodeJS.Signals, controller: AbortController, stderr: CliWriteStream): () => void;
+//#endregion

package/dist/bin/biome-to-oxc.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as readJsonFile, n as DefaultReporter, r as findClosestPackageJson, t as migrate } from "../src-CUWW9YZ_.mjs";
+import { i as readJsonFile, n as DefaultReporter, r as findClosestPackageJson, t as migrate } from "../src-Dz7Nl3tJ.mjs";
 import { realpath } from "node:fs/promises";
 import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/src/index.d.mts

@@ -1,5 +1,5 @@
 //#region src/types.d.ts
-interface BiomeConfig {
+export interface BiomeConfig {
   $schema?: string;
   extends?: string | string[];
   root?: boolean;
@@ -7,13 +7,14 @@ interface BiomeConfig {
   vcs?: BiomeVcsConfig;
   linter?: BiomeLinterConfig;
   formatter?: BiomeFormatterConfig;
+  assist?: BiomeAssistConfig;
   javascript?: BiomeJavaScriptConfig;
   json?: BiomeJsonConfig;
   css?: BiomeCssConfig;
   html?: Record<string, unknown>;
   overrides?: BiomeOverride[];
 }
-interface BiomeFilesConfig {
+export interface BiomeFilesConfig {
   include?: string[];
   includes?: string[];
   /** Negated `includes` entries (`!pattern`), split out during normalization. */
@@ -22,14 +23,14 @@ interface BiomeFilesConfig {
   ignoreUnknown?: boolean;
   maxSize?: number;
 }
-interface BiomeVcsConfig {
+export interface BiomeVcsConfig {
   enabled?: boolean;
   clientKind?: 'git';
   useIgnoreFile?: boolean;
   root?: string;
   defaultBranch?: string;
 }
-interface BiomeLinterConfig {
+export interface BiomeLinterConfig {
   enabled?: boolean;
   include?: string[];
   includes?: string[];
@@ -38,24 +39,47 @@ interface BiomeLinterConfig {
   ignore?: string[];
   rules?: BiomeLinterRules;
 }
-interface BiomeLinterRules {
+export interface BiomeLinterRules {
   recommended?: boolean;
   all?: boolean;
   preset?: 'recommended' | 'all' | 'none';
   [category: string]: boolean | BiomeRuleGroup | BiomeRuleSeverityValue | 'recommended' | 'all' | 'none' | undefined;
 }
-interface BiomeRuleGroup {
+export interface BiomeRuleGroup {
   recommended?: boolean;
   all?: boolean;
   preset?: 'recommended' | 'all' | 'none';
   [rule: string]: BiomeRuleSeverity | boolean | 'recommended' | 'all' | 'none' | undefined;
 }
-type BiomeRuleSeverityValue = 'off' | 'on' | 'info' | 'warn' | 'error';
-type BiomeRuleSeverity = BiomeRuleSeverityValue | {
+export type BiomeRuleSeverityValue = 'off' | 'on' | 'info' | 'warn' | 'error';
+export type BiomeRuleSeverity = BiomeRuleSeverityValue | {
   level: BiomeRuleSeverityValue;
   options?: unknown;
 };
-interface BiomeFormatterConfig {
+/**
+ * Biome's assist actions. They are code actions rather than lint rules, and the two Oxc
+ * surfaces split them: the sorting actions belong to Oxfmt, everything else has no home.
+ */
+export interface BiomeAssistConfig {
+  enabled?: boolean;
+  includes?: string[];
+  actions?: BiomeAssistActions;
+}
+export interface BiomeAssistActions {
+  recommended?: boolean;
+  source?: BiomeAssistSource;
+}
+export interface BiomeAssistSource {
+  recommended?: boolean;
+  preset?: 'recommended' | 'all' | 'none';
+  [action: string]: BiomeAssistAction | boolean | 'recommended' | 'all' | 'none' | undefined;
+}
+export type BiomeAssistActionLevel = 'off' | 'on';
+export type BiomeAssistAction = BiomeAssistActionLevel | {
+  level: BiomeAssistActionLevel;
+  options?: unknown;
+};
+export interface BiomeFormatterConfig {
   enabled?: boolean;
   include?: string[];
   includes?: string[];
@@ -74,7 +98,7 @@ interface BiomeFormatterConfig {
   trailingNewline?: boolean;
   [key: string]: unknown;
 }
-interface BiomeJavaScriptConfig {
+export interface BiomeJavaScriptConfig {
   parser?: {
     unsafeParameterDecoratorsEnabled?: boolean;
     jsxEverywhere?: boolean;
@@ -104,7 +128,7 @@ interface BiomeJavaScriptConfig {
   globals?: string[];
   [key: string]: unknown;
 }
-interface BiomeJsonConfig {
+export interface BiomeJsonConfig {
   parser?: {
     allowComments?: boolean;
     allowTrailingCommas?: boolean;
@@ -123,7 +147,7 @@ interface BiomeJsonConfig {
     enabled?: boolean;
   };
 }
-interface BiomeCssConfig {
+export interface BiomeCssConfig {
   parser?: {
     cssModules?: boolean;
   };
@@ -140,7 +164,7 @@ interface BiomeCssConfig {
     enabled?: boolean;
   };
 }
-interface BiomeOverride {
+export interface BiomeOverride {
   include?: string[];
   includes?: string[];
   /** Negated `includes` entries (`!pattern`), split out during normalization. */
@@ -148,18 +172,19 @@ interface BiomeOverride {
   ignore?: string[];
   linter?: BiomeLinterConfig;
   formatter?: BiomeFormatterConfig;
+  assist?: BiomeAssistConfig;
   javascript?: BiomeJavaScriptConfig;
   json?: BiomeJsonConfig;
   css?: BiomeCssConfig;
 }
-type FixStrategy = 'safe' | 'suggestions' | 'dangerous';
-type TypeAwareProfile = 'standard' | 'strict';
-type OxlintBuiltinPlugin = 'eslint' | 'react' | 'unicorn' | 'typescript' | 'oxc' | 'import' | 'jsdoc' | 'jest' | 'vitest' | 'jsx-a11y' | 'nextjs' | 'react-perf' | 'promise' | 'node' | 'vue';
-type OxlintJsPlugin = string | {
+export type FixStrategy = 'safe' | 'suggestions' | 'dangerous';
+export type TypeAwareProfile = 'standard' | 'strict';
+export type OxlintBuiltinPlugin = 'eslint' | 'react' | 'unicorn' | 'typescript' | 'oxc' | 'import' | 'jsdoc' | 'jest' | 'vitest' | 'jsx-a11y' | 'nextjs' | 'react-perf' | 'promise' | 'node' | 'vue';
+export type OxlintJsPlugin = string | {
   name: string;
   specifier: string;
 };
-interface OxlintSettings {
+export interface OxlintSettings {
   jsdoc?: {
     augmentsExtendsReplacesDocs?: boolean;
     exemptDestructuredRootsFromChecks?: boolean;
@@ -195,7 +220,7 @@ interface OxlintSettings {
   };
   [key: string]: unknown;
 }
-interface OxlintConfig {
+export interface OxlintConfig {
   $schema?: string;
   options?: {
     typeAware?: boolean;
@@ -211,7 +236,7 @@ interface OxlintConfig {
   ignorePatterns?: string[];
   settings?: OxlintSettings;
 }
-interface OxlintOverride {
+export interface OxlintOverride {
   files: string[];
   excludeFiles?: string[];
   env?: Record<string, boolean>;
@@ -220,13 +245,13 @@ interface OxlintOverride {
   jsPlugins?: OxlintJsPlugin[];
   rules?: Record<string, OxlintRuleSeverity>;
 }
-type OxlintRuleSeverity = 'off' | 'warn' | 'error' | ['off' | 'warn' | 'error', ...unknown[]];
-interface OxfmtOverride {
+export type OxlintRuleSeverity = 'off' | 'warn' | 'error' | ['off' | 'warn' | 'error', ...unknown[]];
+export interface OxfmtOverride {
   files: string[];
   excludeFiles?: string[];
   options?: Partial<Omit<OxfmtConfig, '$schema' | 'ignorePatterns' | 'overrides'>>;
 }
-interface OxfmtConfig {
+export interface OxfmtConfig {
   $schema?: string;
   printWidth?: number;
   tabWidth?: number;
@@ -309,7 +334,7 @@ interface OxfmtConfig {
   ignorePatterns?: string[];
   overrides?: OxfmtOverride[];
 }
-interface MigrationOptions {
+export interface MigrationOptions {
   configPath?: string;
   outputDir?: string;
   dryRun?: boolean;
@@ -332,23 +357,23 @@ interface MigrationOptions {
   report?: string;
   signal?: AbortSignal;
 }
-interface PackageScriptUpdate {
+export interface PackageScriptUpdate {
   name: string;
   before: string;
   after: string;
 }
-interface PackageDependencyRemoval {
+export interface PackageDependencyRemoval {
   name: string;
   dependencyType: 'dependencies' | 'devDependencies';
   version?: string;
 }
-interface PackageDevDependencyChange {
+export interface PackageDevDependencyChange {
   name: string;
   action: 'added' | 'already-present' | 'updated';
   from?: string;
   to: string;
 }
-interface PackageUpdateSummary {
+export interface PackageUpdateSummary {
   packageJsonPath: string;
   found: boolean;
   dryRun: boolean;
@@ -359,14 +384,14 @@ interface PackageUpdateSummary {
   /** Lockfile that dependency changes invalidated, when one was detected. */
   lockfile?: LockfileStatus;
 }
-interface LockfileStatus {
+export interface LockfileStatus {
   path: string;
   /** Command that regenerates the lockfile from the updated manifest. */
   installCommand: string;
   /** True when this run changed dependencies, so the lockfile no longer matches. */
   stale: boolean;
 }
-interface MigrationReport {
+export interface MigrationReport {
   /**
    * True when the migration wrote every requested change without errors AND the
    * generated configuration is a complete replacement for the Biome setup.
@@ -404,7 +429,7 @@ interface MigrationReport {
   };
   cleanup?: CleanupOutcome;
 }
-interface CleanupOutcome {
+export interface CleanupOutcome {
   /** Whether `--delete` was requested. */
   requested: boolean;
   /** Whether legacy Biome files were (or in dry-run, would be) removed. */
@@ -414,7 +439,7 @@ interface CleanupOutcome {
   /** Legacy Biome files removed, or that would be removed in dry-run. */
   files: string[];
 }
-interface Reporter {
+export interface Reporter {
   warn(message: string): void;
   error(message: string): void;
   info(message: string): void;
@@ -434,6 +459,5 @@ interface Reporter {
 }
 //#endregion
 //#region src/index.d.ts
-declare function migrate(options?: MigrationOptions, reporter?: Reporter): Promise<MigrationReport>;
-//#endregion
-export { BiomeConfig, BiomeCssConfig, BiomeFilesConfig, BiomeFormatterConfig, BiomeJavaScriptConfig, BiomeJsonConfig, BiomeLinterConfig, BiomeLinterRules, BiomeOverride, BiomeRuleGroup, BiomeRuleSeverity, BiomeRuleSeverityValue, BiomeVcsConfig, CleanupOutcome, FixStrategy, LockfileStatus, MigrationOptions, MigrationReport, OxfmtConfig, OxfmtOverride, OxlintBuiltinPlugin, OxlintConfig, OxlintJsPlugin, OxlintOverride, OxlintRuleSeverity, OxlintSettings, PackageDependencyRemoval, PackageDevDependencyChange, PackageScriptUpdate, PackageUpdateSummary, Reporter, TypeAwareProfile, migrate };
+export declare function migrate(options?: MigrationOptions, reporter?: Reporter): Promise<MigrationReport>;
+//#endregion

package/dist/src/index.mjs

@@ -1,2 +1,2 @@
-import { t as migrate } from "../src-CUWW9YZ_.mjs";
+import { t as migrate } from "../src-Dz7Nl3tJ.mjs";
 export { migrate };

package/dist/{src-CUWW9YZ_.mjs → src-Dz7Nl3tJ.mjs}

@@ -306,6 +306,7 @@ const SUPPORTED_TOP_LEVEL_FIELDS = /* @__PURE__ */ new Set([
 	"vcs",
 	"linter",
 	"formatter",
+	"assist",
 	"javascript",
 	"json",
 	"css",
@@ -471,12 +472,32 @@ const BiomeLinterConfigSchema = IncludeFieldsSchema.extend({
 	ignore: z.array(z.string()).optional(),
 	rules: BiomeLinterRulesSchema.optional()
 }).passthrough();
+const BiomeAssistActionSchema = z.union([z.enum(["off", "on"]), z.object({
+	level: z.enum(["off", "on"]),
+	options: z.unknown().optional()
+}).passthrough()]);
+const BiomeAssistConfigSchema = z.object({
+	enabled: z.boolean().optional(),
+	includes: z.array(z.string()).optional(),
+	actions: z.object({
+		recommended: z.boolean().optional(),
+		source: z.object({
+			recommended: z.boolean().optional(),
+			preset: z.enum([
+				"recommended",
+				"all",
+				"none"
+			]).optional()
+		}).catchall(z.union([BiomeAssistActionSchema, z.boolean()])).optional()
+	}).passthrough().optional()
+}).passthrough();
 const BiomeOverrideSchema = z.object({
 	include: z.array(z.string()).optional(),
 	includes: z.array(z.string()).optional(),
 	ignore: z.array(z.string()).optional(),
 	linter: BiomeLinterConfigSchema.optional(),
 	formatter: BiomeFormatterConfigSchema.optional(),
+	assist: BiomeAssistConfigSchema.optional(),
 	javascript: BiomeJavaScriptConfigSchema.optional(),
 	json: BiomeJsonConfigSchema.optional(),
 	css: BiomeCssConfigSchema.optional()
@@ -501,6 +522,7 @@ const BiomeConfigSchema = z.object({
 	}).passthrough().optional(),
 	linter: BiomeLinterConfigSchema.optional(),
 	formatter: BiomeFormatterConfigSchema.optional(),
+	assist: BiomeAssistConfigSchema.optional(),
 	javascript: BiomeJavaScriptConfigSchema.optional(),
 	json: BiomeJsonConfigSchema.optional(),
 	css: BiomeCssConfigSchema.optional(),
@@ -797,6 +819,7 @@ function generateOxfmtOverrides(biomeOverrides, reporter) {
 		if (!files || files.length === 0) continue;
 		const excludePatterns = [.../* @__PURE__ */ new Set([...override.ignore ?? [], ...override.exclude ?? []])];
 		const excludeFiles = excludePatterns.length > 0 ? excludePatterns : void 0;
+		if (override.assist) reporter.loss(`Biome override for ${files.join(", ")} configures assist actions; per-override assist is not migrated, so only the top-level assist configuration reached the Oxfmt config.`);
 		pushOverride(oxfmtOverrides, files, excludeFiles, mapBaseFormatterOptions(override.formatter, reporter));
 		pushScopedOverride(oxfmtOverrides, files, excludeFiles, mapJavaScriptFormatterOptions(override.javascript?.formatter, reporter), reporter, "javascript.formatter", JAVASCRIPT_EXTENSIONS);
 		pushScopedOverride(oxfmtOverrides, files, excludeFiles, mapJsonFormatterOptions(override.json?.formatter, reporter), reporter, "json.formatter", JSON_EXTENSIONS);
@@ -996,6 +1019,13 @@ const OXFMT_ONLY_IGNORE_PATTERNS = [
 	"**/*.toml",
 	"**/*.{md,mdx}"
 ];
+/**
+* The two Biome assist actions Oxfmt implements. Every other `assist.actions.source` entry
+* is a code action with no formatter equivalent, so enabling one is a migration loss.
+*/
+const OXFMT_BACKED_ASSIST_ACTIONS = /* @__PURE__ */ new Set(["organizeImports", "useSortedPackageJson"]);
+/** Group-level switches that sit alongside the actions and are not actions themselves. */
+const ASSIST_GROUP_LEVEL_KEYS = /* @__PURE__ */ new Set(["recommended", "preset"]);
 function generateOxfmtConfig(biomeConfig, reporter, options = {}) {
 	const oxfmtConfig = { $schema: "./node_modules/oxfmt/configuration_schema.json" };
 	const { formatter } = biomeConfig;
@@ -1011,6 +1041,7 @@ function generateOxfmtConfig(biomeConfig, reporter, options = {}) {
 	mapFormatterOptions(formatter, oxfmtConfig, reporter);
 	mapIgnorePatterns$1(biomeConfig, oxfmtConfig, options.biomeIgnorePatterns ?? []);
 	mapDisabledLanguageFormatters(biomeConfig, oxfmtConfig);
+	mapAssistActions(biomeConfig.assist, oxfmtConfig, reporter);
 	applyExplicitFormatterOptionPassThrough([formatter], oxfmtConfig, reporter);
 	oxfmtConfig.sortPackageJson ??= false;
 	const languageOverrides = generateOxfmtOverrides([
@@ -1080,6 +1111,67 @@ function mapFormatterOptions(formatter, oxfmtConfig, reporter) {
 	if (formatter?.trailingNewline !== void 0) oxfmtConfig.insertFinalNewline = formatter.trailingNewline;
 	if (formatter?.formatWithErrors) reporter.warn("Biome's formatWithErrors option is not supported in Oxfmt");
 }
+/**
+* Maps Biome's assist actions onto the Oxfmt options that implement them.
+*
+* Only actions the config turns on explicitly are migrated. Biome enables `organizeImports`
+* through its recommended set even when the config never mentions it, but both Oxfmt options
+* default to off here, so deriving them from a preset would start rewriting imports in
+* projects whose Biome config never asked for it.
+*/
+function mapAssistActions(assist, oxfmtConfig, reporter) {
+	if (assist?.includes && assist.includes.length > 0) reporter.loss(`Biome assist.includes (${assist.includes.join(", ")}) cannot be represented in an Oxfmt config; Oxfmt applies its sorting options to every file it formats.`);
+	if (assist?.enabled === false) return;
+	const source = assist?.actions?.source;
+	if (assist?.actions?.recommended || source?.recommended || source?.preset) reporter.loss("Biome assist actions were enabled through a preset rather than named individually; only the actions the config names explicitly were migrated to Oxfmt.");
+	for (const [action, value] of Object.entries(source ?? {})) {
+		if (ASSIST_GROUP_LEVEL_KEYS.has(action) || value === void 0) continue;
+		if (readAssistActionLevel(value) !== "on") continue;
+		if (!OXFMT_BACKED_ASSIST_ACTIONS.has(action)) {
+			reporter.loss(`Biome assist action "${action}" has no Oxfmt equivalent and was not migrated; its code action is lost.`);
+			continue;
+		}
+		if (action === "useSortedPackageJson") {
+			oxfmtConfig.sortPackageJson = true;
+			reporter.warn("Biome assist action useSortedPackageJson became Oxfmt's sortPackageJson; the two use different key orders, so the first Oxfmt run will reorder package.json once.");
+			continue;
+		}
+		oxfmtConfig.sortImports = mapOrganizeImportsOptions(value, reporter);
+		reporter.warn("Biome assist action organizeImports became Oxfmt's sortImports; the two group and order imports differently, so the first Oxfmt run will reorder imports once.");
+	}
+	warnAboutDefaultOrganizeImports(source, oxfmtConfig, reporter);
+}
+/**
+* Biome runs `organizeImports` through its recommended assist set even when the config never
+* mentions it, so `biome check` sorts imports in essentially every project. Oxfmt's
+* `sortImports` defaults to off and deriving it from that default would start rewriting
+* imports in projects that never asked for it, so the difference is reported instead.
+*
+* Reported as a warning rather than a loss because it applies to nearly every migration, the
+* way the linter's category-preset approximation does.
+*/
+function warnAboutDefaultOrganizeImports(source, oxfmtConfig, reporter) {
+	const organizeImports = source?.organizeImports;
+	if (oxfmtConfig.sortImports !== void 0 || organizeImports !== void 0) return;
+	reporter.warn("Biome sorts imports by default through its recommended assist set. Oxfmt does not sort imports unless asked, so the generated config leaves them alone; set \"sortImports\" in the Oxfmt config to keep sorting them.");
+}
+function readAssistActionLevel(value) {
+	if (typeof value === "boolean") return value ? "on" : "off";
+	if (typeof value === "string") return value === "on" ? "on" : "off";
+	return value.level === "on" ? "on" : "off";
+}
+/**
+* Translates the one `organizeImports` option Oxfmt has a counterpart for. Biome's `groups`
+* are matcher predicates (`:NODE:`, source globs) while Oxfmt's are a fixed list of group
+* names, so a faithful translation is not available and the ordering is reported as lost.
+*/
+function mapOrganizeImportsOptions(value, reporter) {
+	const options = typeof value === "object" && value.options && typeof value.options === "object" ? value.options : void 0;
+	if (!options) return {};
+	if (options.groups) reporter.loss("Biome assist action organizeImports option \"groups\" was not migrated; Biome's groups are matcher predicates while Oxfmt's are a fixed set of group names, so Oxfmt will sort imports into its default groups.");
+	if (options.identifierOrder !== void 0 && options.identifierOrder !== "natural") reporter.loss(`Biome assist action organizeImports option "identifierOrder": ${JSON.stringify(options.identifierOrder)} has no Oxfmt equivalent; Oxfmt sorts identifiers with its own order.`);
+	return typeof options.sortBareImports === "boolean" ? { sortSideEffects: options.sortBareImports } : {};
+}
 function mapIgnorePatterns$1(biomeConfig, oxfmtConfig, additionalIgnorePatterns) {
 	const ignorePatterns = [
 		...oxfmtConfig.ignorePatterns ?? [],
@@ -1356,28 +1448,40 @@ const OXLINT_CATEGORIES = [
 	"suspicious"
 ];
 /**
-* The React Compiler rules Oxlint activates for ESLint's `react-hooks/recommended` preset.
+* Every React Compiler rule Oxlint implements.
 *
-* Oxlint 1.79 replaced the single `react/react-compiler` rule with 22 per-diagnostic rules;
-* Biome's `useReactCompiler` runs the compiler and reports every bailout it finds, so the
-* `recommended` slice is the closest equivalent. The remaining rules default to off upstream
-* and would fire on code Biome never flagged.
+* Oxlint 1.79 replaced the single `react/react-compiler` rule with 22 per-diagnostic rules,
+* spread across the `correctness`, `perf`, `restriction`, and `suspicious` categories. Biome's
+* `useReactCompiler` runs the compiler and reports every bailout it finds, so the whole set is
+* the equivalent: mapping only the rules Oxlint enables by default would drop diagnostics the
+* Biome rule did produce. Oxlint does not implement `gating` or `memoized-effect-dependencies`,
+* so there is nothing to enable for those two.
 *
 * @see https://oxc.rs/blog/2026-08-18-react-compiler-support
 */
-const REACT_COMPILER_RECOMMENDED_RULES = [
+const REACT_COMPILER_RULES = [
+	"react/capitalized-calls",
 	"react/error-boundaries",
+	"react/exhaustive-effect-dependencies",
 	"react/globals",
+	"react/hooks",
 	"react/immutability",
 	"react/incompatible-library",
+	"react/invariant",
+	"react/memo-dependencies",
+	"react/no-deriving-state-in-effects",
 	"react/preserve-manual-memoization",
 	"react/purity",
 	"react/refs",
+	"react/rule-suppression",
 	"react/set-state-in-effect",
 	"react/set-state-in-render",
 	"react/static-components",
+	"react/syntax",
+	"react/todo",
 	"react/unsupported-syntax",
-	"react/use-memo"
+	"react/use-memo",
+	"react/void-use-memo"
 ];
 /**
 * Mappings where the Oxlint rule covers only part of what the Biome rule checked. The note
@@ -1387,8 +1491,26 @@ const PARTIAL_RULE_MAPPING_NOTES = {
 	noComponentHookFactories: "Biome rule noComponentHookFactories was mapped to react/no-unstable-nested-components, which reports nested component definitions but not nested custom hook definitions.",
 	noReactPropAssignments: "Biome rule noReactPropAssignments was mapped to the React Compiler rule react/immutability, which reports prop mutation alongside other mutations of values React treats as immutable.",
 	useExplicitType: "Biome rule useExplicitType was mapped to typescript/explicit-function-return-type, which requires return types on functions and methods but not types on variables or parameters.",
-	useReactCompiler: `Biome rule useReactCompiler was mapped to Oxlint's React Compiler rules for ESLint's recommended preset (${REACT_COMPILER_RECOMMENDED_RULES.join(", ")}); the compiler rules that are off by default upstream were not enabled. See https://oxc.rs/blog/2026-08-18-react-compiler-support`
+	useStaticResponseMethods: "Biome rule useStaticResponseMethods was mapped to unicorn/prefer-response-static-json, which reports `new Response(JSON.stringify(...))` but not the `new Response(null, { status, headers: { Location } })` form Biome rewrites to Response.redirect()."
+};
+/**
+* Biome rules whose only Oxlint counterpart is a type-aware rule, even though the Biome rule
+* itself needs no type information. Without type-aware linting the type-aware rule never runs,
+* so the migration would silently drop diagnostics the source config did produce. These
+* non-type-aware Oxlint rules take its place whenever the migration is not enabling type-aware
+* linting; they replace rather than accompany it, so switching the profile on later can never
+* report the same line twice.
+*
+* Every pair was checked by running both binaries over the same fixture.
+*/
+const TYPE_AWARE_RULE_FALLBACKS = {
+	useArrayFind: "unicorn/prefer-array-find",
+	useFind: "unicorn/prefer-array-find",
+	useIncludes: "unicorn/prefer-includes",
+	useStringStartsEndsWith: "unicorn/prefer-string-starts-ends-with"
 };
+/** Fallbacks that cover less than the type-aware rule they stand in for. */
+const TYPE_AWARE_FALLBACK_NOTES = { useStringStartsEndsWith: "Biome rule useStringStartsEndsWith was mapped to unicorn/prefer-string-starts-ends-with because type-aware linting is off; it reports anchored RegExp#test() prefix checks but not the indexOf(), slice() and charAt() comparisons Biome also reports. Enabling type-aware linting maps it to typescript/prefer-string-starts-ends-with instead, which covers all four." };
 const BIOME_TO_OXLINT_RULE_MAP = {
 	noAccessKey: "jsx-a11y/no-access-key",
 	noAdjacentSpacesInRegex: "no-regex-spaces",
@@ -1467,6 +1589,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noExtraBooleanCast: "no-extra-boolean-cast",
 	noExtraNonNullAssertion: "typescript/no-extra-non-null-assertion",
 	noFallthroughSwitchClause: "no-fallthrough",
+	noFlatMapIdentity: "unicorn/prefer-array-flat",
 	noFloatingPromises: "typescript/no-floating-promises",
 	noFocusedTests: ["jest/no-focused-tests", "vitest/no-focused-tests"],
 	noForEach: "unicorn/no-array-for-each",
@@ -1498,6 +1621,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noJsRestrictedProperties: "no-restricted-properties",
 	noJsxLiterals: "react/jsx-no-literals",
 	noJsxNamespace: "react/no-namespace",
+	noJsxPropsBind: "react-perf/jsx-no-new-function-as-prop",
 	noLabelWithoutControl: "jsx-a11y/label-has-associated-control",
 	noLabelVar: "no-label-var",
 	noLoopFunc: "no-loop-func",
@@ -1654,6 +1778,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	useConsistentObjectDefinitions: "object-shorthand",
 	useConsistentTestIt: ["jest/consistent-test-it", "vitest/consistent-test-it"],
 	useConst: "prefer-const",
+	useControlLabel: "jsx-a11y/control-has-associated-label",
 	useDateNow: "unicorn/prefer-date-now",
 	useDefaultParameterLast: "default-param-last",
 	useDefaultSwitchClause: "default-case",
@@ -1720,7 +1845,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	useParseIntRadix: "radix",
 	useReadonlyClassProperties: "typescript/prefer-readonly",
 	useReactFunctionComponentDefinition: "react/function-component-definition",
-	useReactCompiler: REACT_COMPILER_RECOMMENDED_RULES,
+	useReactCompiler: REACT_COMPILER_RULES,
 	useReactFunctionComponents: "react/prefer-function-component",
 	useReduceTypeParameter: "typescript/prefer-reduce-type-parameter",
 	useRegexLiterals: "prefer-regex-literals",
@@ -1734,6 +1859,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	useSimplifiedLogicExpression: "unicorn/prefer-logical-operator-over-ternary",
 	useSpread: "prefer-spread",
 	useSpreadOverApply: "prefer-spread",
+	useStaticResponseMethods: "unicorn/prefer-response-static-json",
 	useStringStartsEndsWith: "typescript/prefer-string-starts-ends-with",
 	useSymbolDescription: "symbol-description",
 	useTemplate: "prefer-template",
@@ -1804,11 +1930,20 @@ function mapBiomeRuleOptionsToOxlintSeverity(biomeName, severity, biomeSeverity,
 		"ts-nocheck": false,
 		"ts-check": false
 	}];
+	if (biomeName === "useReactCompiler") {
+		if (options?.compilationMode === "annotation") reporter.loss("Biome rule useReactCompiler option \"compilationMode\": \"annotation\" is not supported by Oxlint, which analyses every component and hook rather than only the functions carrying a \"use memo\" directive.");
+		else if (options?.compilationMode === "all") reporter.loss("Biome rule useReactCompiler option \"compilationMode\": \"all\" is not supported by Oxlint, which analyses components and hooks only; React Compiler diagnostics in other functions are no longer reported.");
+		return severity;
+	}
 	if (!options) return severity;
 	if (biomeName === "noAmbiguousAnchorText") {
 		const { words } = options;
 		return Array.isArray(words) && words.every((value) => typeof value === "string") ? [severity, { words }] : severity;
 	}
+	if (biomeName === "noConsole") {
+		const { allow } = options;
+		return Array.isArray(allow) && allow.every((value) => typeof value === "string") ? [severity, { allow }] : severity;
+	}
 	if (biomeName === "noEmptySource") {
 		if (options.allowComments === true) reporter.loss("Biome rule noEmptySource option \"allowComments\" is not supported by Oxlint unicorn/no-empty-file and was not migrated.");
 		return severity;
@@ -1929,7 +2064,13 @@ function mapBiomeRuleSeverity(severity, reporter, biomeRuleName) {
 	warnUnsupportedSeverityOnce(rawSeverity, reporter, biomeRuleName);
 	return "warn";
 }
-function mapBiomeRuleToOxlintRules(biomeName, reporter) {
+function mapBiomeRuleToOxlintRules(biomeName, reporter, typeAware) {
+	const fallback = typeAware ? void 0 : TYPE_AWARE_RULE_FALLBACKS[biomeName];
+	if (fallback) {
+		const fallbackNote = TYPE_AWARE_FALLBACK_NOTES[biomeName];
+		if (fallbackNote) warnPartialMappingOnce(biomeName, fallbackNote, reporter);
+		return [normalizeOxlintRuleName(fallback)];
+	}
 	const mapped = BIOME_TO_OXLINT_RULE_MAP[biomeName];
 	if (mapped) {
 		const partialMappingNote = PARTIAL_RULE_MAPPING_NOTES[biomeName];
@@ -1979,7 +2120,8 @@ function warnUnsupportedSeverityOnce(rawSeverity, reporter, biomeRuleName) {
 function mapBiomeCategoryToOxlint(biomeCategory) {
 	return BIOME_TO_OXLINT_CATEGORY_MAP[biomeCategory] || null;
 }
-function extractRulesFromBiomeConfig(linterRules, reporter, applyImplicitRecommended = false) {
+function extractRulesFromBiomeConfig(linterRules, reporter, options = {}) {
+	const { applyImplicitRecommended = false, typeAware = false } = options;
 	const rules = {};
 	const categories = {};
 	const sourceRulesConverted = /* @__PURE__ */ new Set();
@@ -2009,7 +2151,7 @@ function extractRulesFromBiomeConfig(linterRules, reporter, applyImplicitRecomme
 				if (ruleName === "recommended" || ruleName === "all" || ruleName === "preset") continue;
 				if (typeof ruleSeverity === "boolean" || ruleSeverity === void 0) continue;
 				if (!isBiomeRuleSeverity(ruleSeverity)) continue;
-				const oxlintRuleNames = mapBiomeRuleToOxlintRules(ruleName, reporter);
+				const oxlintRuleNames = mapBiomeRuleToOxlintRules(ruleName, reporter, typeAware);
 				if (oxlintRuleNames.length > 0) {
 					sourceRulesConverted.add(ruleName);
 					const oxlintSeverity = mapBiomeRuleOptionsToOxlintSeverity(ruleName, mapBiomeRuleSeverity(ruleSeverity, reporter, ruleName), ruleSeverity, reporter);
@@ -2061,7 +2203,7 @@ function isBiomeRuleSeverity(value) {
 }
 //#endregion
 //#region src/overrides-transformer.ts
-function transformOverridesToOxlint(biomeOverrides, reporter) {
+function transformOverridesToOxlint(biomeOverrides, reporter, options = {}) {
 	const oxlintOverrides = [];
 	const sourceRulesConverted = /* @__PURE__ */ new Set();
 	const sourceRulesSkipped = /* @__PURE__ */ new Set();
@@ -2080,7 +2222,7 @@ function transformOverridesToOxlint(biomeOverrides, reporter) {
 		const excludeFiles = [.../* @__PURE__ */ new Set([...override.ignore ?? [], ...override.exclude ?? []])];
 		if (excludeFiles.length > 0) oxlintOverride.excludeFiles = excludeFiles;
 		if (override.linter?.rules) {
-			const { rules, categories, ...ruleStats } = extractRulesFromBiomeConfig(override.linter.rules, reporter);
+			const { rules, categories, ...ruleStats } = extractRulesFromBiomeConfig(override.linter.rules, reporter, { typeAware: options.typeAware ?? false });
 			for (const ruleName of ruleStats.sourceRulesConverted) sourceRulesConverted.add(ruleName);
 			for (const ruleName of ruleStats.sourceRulesSkipped) sourceRulesSkipped.add(ruleName);
 			if (Object.keys(rules).length > 0) oxlintOverride.rules = rules;
@@ -2143,7 +2285,10 @@ function generateOxlintConfig(biomeConfig, reporter, options = {}) {
 		categories: { ...DISABLED_CATEGORIES },
 		sourceRulesConverted: /* @__PURE__ */ new Set(),
 		sourceRulesSkipped: /* @__PURE__ */ new Set()
-	} : extractRulesFromBiomeConfig(biomeConfig.linter?.rules ?? {}, reporter, true);
+	} : extractRulesFromBiomeConfig(biomeConfig.linter?.rules ?? {}, reporter, {
+		applyImplicitRecommended: true,
+		typeAware: options.typeAware ?? false
+	});
 	if (Object.keys(categories).length > 0) oxlintConfig.categories = categories;
 	if (Object.keys(rules).length > 0) oxlintConfig.rules = rules;
 	warnAboutUnrepresentableIncludes(biomeConfig, reporter);
@@ -2915,7 +3060,7 @@ async function runMigration(options, reporter, biomeConfigPath) {
 	if (biomeConfig.overrides) {
 		appendUniquePatterns(oxlintConfig, "ignorePatterns", collectDisabledOxlintOverridePatterns(biomeConfig.overrides));
 		appendUniquePatterns(oxfmtConfig, "ignorePatterns", collectDisabledOxfmtOverridePatterns(biomeConfig.overrides));
-		const oxlintOverrideResult = transformOverridesToOxlint(biomeConfig.overrides, reporter);
+		const oxlintOverrideResult = transformOverridesToOxlint(biomeConfig.overrides, reporter, { typeAware: typeAwareEnabled });
 		if (oxlintOverrideResult.overrides.length > 0) oxlintConfig.overrides = oxlintOverrideResult.overrides;
 		for (const ruleName of oxlintOverrideResult.sourceRulesConverted) convertedSourceRules.add(ruleName);
 		for (const ruleName of oxlintOverrideResult.sourceRulesSkipped) skippedSourceRules.add(ruleName);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "biome-to-oxc",
-  "version": "3.0.0",
+  "version": "3.5.0",
   "description": "Migrate from Biome to Oxc ecosystem (oxlint + oxfmt + oxlint-tsgolint)",
   "keywords": [
     "biome",
@@ -54,24 +54,24 @@
     "commander": "15.0.0",
     "jsonc-parser": "next",
     "picocolors": "^1.1.1",
-    "zod": "^4.4.3"
+    "zod": "^4.5.4"
   },
   "devDependencies": {
     "@arethetypeswrong/core": "^0.18.5",
-    "@biomejs/biome": "^2.5.9",
-    "@types/node": "^26.2.0",
+    "@biomejs/biome": "^2.5.11",
+    "@types/node": "^26.4.1",
     "@vitest/coverage-v8": "^4.1.11",
-    "oxfmt": "^0.64.0",
-    "oxlint": "^1.79.0",
+    "oxfmt": "^0.66.0",
+    "oxlint": "^1.81.0",
     "oxlint-tsgolint": "^7.0.2001",
     "publint": "^0.3.24",
-    "tsdown": "^0.22.14",
+    "tsdown": "rc",
     "typescript": "next",
     "vitest": "^4.1.11"
   },
   "engines": {
     "node": ">=24.19.0",
-    "pnpm": ">=11.22.0"
+    "pnpm": ">=11.25.0"
   },
-  "packageManager": "pnpm@11.22.0"
+  "packageManager": "pnpm@11.25.0"
 }