biome-to-oxc 2.0.0 → 3.0.0

package/README.md

@@ -135,6 +135,12 @@ ignore configuration before removing Biome.
 - `docs/oxfmt-rules.tsv`: Oxfmt configuration surface inventory
 - `docs/tsgolint-rules.tsv`: typed linting implementation matrix
 - `docs/oxlint-vs-tsgolint.tsv`: typed rule availability cross-reference
+- `docs/biome-rules.tsv`: Biome rule inventory, so a mapping cannot key off a rule Biome dropped
+- `docs/biome-formatter-options.tsv`: Biome formatter surface inventory
+
+All six are generated from the schemas of the installed `oxlint`, `oxfmt`,
+`oxlint-tsgolint`, and `@biomejs/biome` packages by `pnpm docs:sync`; `pnpm docs:check`
+fails when they drift, and it runs as part of `pnpm check`.
 
 ✅ **Script Rewrite Strategy Controls**
 

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-CYMpPpfK.mjs";
+import { i as readJsonFile, n as DefaultReporter, r as findClosestPackageJson, t as migrate } from "../src-CUWW9YZ_.mjs";
 import { realpath } from "node:fs/promises";
 import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -19,6 +19,7 @@ const MigrationOptionsSchema = z.object({
 	delete: z.boolean().default(false),
 	noBackup: z.boolean().default(false),
 	updateScripts: z.boolean().default(false),
+	dom: z.boolean().default(false),
 	verbose: z.boolean().default(false),
 	typeAware: z.boolean().default(false),
 	typeCheck: z.boolean().default(false),
@@ -106,7 +107,7 @@ function createCommand(packageMetadata, streams) {
 		writeOut: (chunk) => {
 			streams.stdout.write(chunk);
 		}
-	}).option("-c, --config <path>", "Path to biome.json or biome.jsonc").option("-o, --output-dir <path>", "Output directory for generated configs").option("--dry-run", "Show what would be done without making changes").option("--delete", "Delete legacy Biome files after migration (biome.json/biome.jsonc and .biomeignore)").option("--no-backup", "Skip backup of existing config files").option("--update-scripts", "Update package.json scripts to use oxlint/oxfmt").option("--type-aware", "Include type-aware linting guidance and dependencies").option("--type-check", "Enable strict typed linting mode (implies --type-aware)").addOption(new Option("--type-aware-profile <profile>", "Type-aware profile: standard (--type-aware) or strict (--type-aware --type-check)").choices(["standard", "strict"]).default("standard")).addOption(new Option("--fix-strategy <strategy>", "Fix mode for rewritten scripts: safe | suggestions | dangerous").choices([
+	}).option("-c, --config <path>", "Path to biome.json or biome.jsonc").option("-o, --output-dir <path>", "Output directory for generated configs").option("--dry-run", "Show what would be done without making changes").option("--delete", "Delete legacy Biome files after migration (biome.json/biome.jsonc and .biomeignore)").option("--no-backup", "Skip backup of existing config files").option("--update-scripts", "Update package.json scripts to use oxlint/oxfmt").addOption(new Option("--dom").hideHelp()).option("--type-aware", "Include type-aware linting guidance and dependencies").option("--type-check", "Enable strict typed linting mode (implies --type-aware)").addOption(new Option("--type-aware-profile <profile>", "Type-aware profile: standard (--type-aware) or strict (--type-aware --type-check)").choices(["standard", "strict"]).default("standard")).addOption(new Option("--fix-strategy <strategy>", "Fix mode for rewritten scripts: safe | suggestions | dangerous").choices([
 		"safe",
 		"suggestions",
 		"dangerous"
@@ -130,6 +131,7 @@ function normalizeMigrationOptions(options) {
 		delete: options.delete,
 		noBackup: options.backup === false,
 		updateScripts: options.updateScripts,
+		dom: options.dom,
 		verbose: options.verbose,
 		typeAware,
 		typeCheck,

package/dist/src/index.d.mts

@@ -69,6 +69,9 @@ interface BiomeFormatterConfig {
   lineWidth?: number;
   attributePosition?: 'auto' | 'multiline';
   bracketSpacing?: boolean;
+  bracketSameLine?: boolean;
+  expand?: 'auto' | 'always' | 'never';
+  trailingNewline?: boolean;
   [key: string]: unknown;
 }
 interface BiomeJavaScriptConfig {
@@ -86,10 +89,13 @@ interface BiomeJavaScriptConfig {
     arrowParentheses?: 'always' | 'asNeeded';
     bracketSameLine?: boolean;
     bracketSpacing?: boolean;
+    expand?: 'auto' | 'always' | 'never';
     indentStyle?: 'tab' | 'space';
     indentWidth?: number;
     lineEnding?: 'lf' | 'crlf' | 'cr' | 'auto';
     lineWidth?: number;
+    operatorLinebreak?: 'after' | 'before';
+    trailingNewline?: boolean;
     [key: string]: unknown;
   };
   linter?: {
@@ -105,11 +111,13 @@ interface BiomeJsonConfig {
   };
   formatter?: {
     enabled?: boolean;
+    expand?: 'auto' | 'always' | 'never';
     indentStyle?: 'tab' | 'space';
     indentWidth?: number;
     lineEnding?: 'lf' | 'crlf' | 'cr' | 'auto';
     lineWidth?: number;
     trailingCommas?: 'none' | 'all';
+    trailingNewline?: boolean;
   };
   linter?: {
     enabled?: boolean;
@@ -126,6 +134,7 @@ interface BiomeCssConfig {
     lineEnding?: 'lf' | 'crlf' | 'cr' | 'auto';
     lineWidth?: number;
     quoteStyle?: 'single' | 'double';
+    trailingNewline?: boolean;
   };
   linter?: {
     enabled?: boolean;
@@ -233,6 +242,7 @@ interface OxfmtConfig {
   endOfLine?: 'lf' | 'crlf' | 'cr';
   singleAttributePerLine?: boolean;
   objectWrap?: 'preserve' | 'collapse';
+  experimentalOperatorPosition?: 'start' | 'end';
   insertFinalNewline?: boolean;
   embeddedLanguageFormatting?: 'auto' | 'off';
   htmlWhitespaceSensitivity?: 'css' | 'strict' | 'ignore';
@@ -306,6 +316,7 @@ interface MigrationOptions {
   delete?: boolean;
   noBackup?: boolean;
   updateScripts?: boolean;
+  dom?: boolean;
   verbose?: boolean;
   typeAware?: boolean;
   typeCheck?: boolean;

package/dist/src/index.mjs

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

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

@@ -373,7 +373,14 @@ const BiomeFormatterConfigSchema = IncludeFieldsSchema.extend({
 	]).optional(),
 	lineWidth: z.number().int().optional(),
 	attributePosition: z.enum(["auto", "multiline"]).optional(),
-	bracketSpacing: z.boolean().optional()
+	bracketSpacing: z.boolean().optional(),
+	bracketSameLine: z.boolean().optional(),
+	expand: z.enum([
+		"auto",
+		"always",
+		"never"
+	]).optional(),
+	trailingNewline: z.boolean().optional()
 }).passthrough();
 const BiomeJavaScriptFormatterSchema = z.object({
 	enabled: z.boolean().optional(),
@@ -389,6 +396,11 @@ const BiomeJavaScriptFormatterSchema = z.object({
 	arrowParentheses: z.enum(["always", "asNeeded"]).optional(),
 	bracketSameLine: z.boolean().optional(),
 	bracketSpacing: z.boolean().optional(),
+	expand: z.enum([
+		"auto",
+		"always",
+		"never"
+	]).optional(),
 	indentStyle: z.enum(["tab", "space"]).optional(),
 	indentWidth: z.number().int().optional(),
 	lineEnding: z.enum([
@@ -397,7 +409,9 @@ const BiomeJavaScriptFormatterSchema = z.object({
 		"cr",
 		"auto"
 	]).optional(),
-	lineWidth: z.number().int().optional()
+	lineWidth: z.number().int().optional(),
+	operatorLinebreak: z.enum(["after", "before"]).optional(),
+	trailingNewline: z.boolean().optional()
 }).passthrough();
 const BiomeJavaScriptConfigSchema = z.object({
 	parser: z.object({
@@ -415,6 +429,11 @@ const BiomeJsonConfigSchema = z.object({
 	}).passthrough().optional(),
 	formatter: z.object({
 		enabled: z.boolean().optional(),
+		expand: z.enum([
+			"auto",
+			"always",
+			"never"
+		]).optional(),
 		indentStyle: z.enum(["tab", "space"]).optional(),
 		indentWidth: z.number().int().optional(),
 		lineEnding: z.enum([
@@ -424,7 +443,8 @@ const BiomeJsonConfigSchema = z.object({
 			"auto"
 		]).optional(),
 		lineWidth: z.number().int().optional(),
-		trailingCommas: z.enum(["none", "all"]).optional()
+		trailingCommas: z.enum(["none", "all"]).optional(),
+		trailingNewline: z.boolean().optional()
 	}).passthrough().optional(),
 	linter: z.object({ enabled: z.boolean().optional() }).passthrough().optional()
 }).passthrough();
@@ -441,7 +461,8 @@ const BiomeCssConfigSchema = z.object({
 			"auto"
 		]).optional(),
 		lineWidth: z.number().int().optional(),
-		quoteStyle: z.enum(["single", "double"]).optional()
+		quoteStyle: z.enum(["single", "double"]).optional(),
+		trailingNewline: z.boolean().optional()
 	}).passthrough().optional(),
 	linter: z.object({ enabled: z.boolean().optional() }).passthrough().optional()
 }).passthrough();
@@ -692,6 +713,7 @@ function generateESLintFormatterBridgeSuggestions() {
 //#region src/oxfmt-overrides.ts
 const EXPLICIT_OXFMT_OPTION_KEYS$1 = [
 	"objectWrap",
+	"experimentalOperatorPosition",
 	"insertFinalNewline",
 	"embeddedLanguageFormatting",
 	"htmlWhitespaceSensitivity",
@@ -731,11 +753,13 @@ const CSS_EXTENSIONS = [
 ];
 const JSON_FORMATTER_KEYS = /* @__PURE__ */ new Set([
 	"enabled",
+	"expand",
 	"indentStyle",
 	"indentWidth",
 	"lineEnding",
 	"lineWidth",
 	"trailingCommas",
+	"trailingNewline",
 	...EXPLICIT_OXFMT_OPTION_KEYS$1,
 	...Object.keys(LEGACY_EXPLICIT_OXFMT_OPTION_ALIASES$1)
 ]);
@@ -746,9 +770,25 @@ const CSS_FORMATTER_KEYS = /* @__PURE__ */ new Set([
 	"lineEnding",
 	"lineWidth",
 	"quoteStyle",
+	"trailingNewline",
 	...EXPLICIT_OXFMT_OPTION_KEYS$1,
 	...Object.keys(LEGACY_EXPLICIT_OXFMT_OPTION_ALIASES$1)
 ]);
+/**
+* Biome's `expand` and Oxfmt's `objectWrap` agree on two of three modes: Biome's `auto`
+* (expand when the literal already has a newline after `{`) is Oxfmt's `preserve`, and
+* Biome's `never` is Oxfmt's `collapse`. Biome's `always` has no Oxfmt counterpart.
+*/
+function mapBiomeExpandToObjectWrap(expand, label, reporter) {
+	if (expand === "auto") return "preserve";
+	if (expand === "never") return "collapse";
+	if (expand === "always") reporter.loss(`Biome ${label}.expand "always" has no Oxfmt equivalent; Oxfmt's objectWrap only offers "preserve" and "collapse", so objects and arrays that fit on one line will not be forced to expand.`);
+}
+/** Biome places the operator after or before the break; Oxfmt names the same two positions. */
+function mapBiomeOperatorLinebreakToOxfmt(operatorLinebreak) {
+	if (operatorLinebreak === "after") return "end";
+	if (operatorLinebreak === "before") return "start";
+}
 function generateOxfmtOverrides(biomeOverrides, reporter) {
 	if (!biomeOverrides || biomeOverrides.length === 0) return [];
 	const oxfmtOverrides = [];
@@ -792,7 +832,11 @@ function mapBaseFormatterOptions(formatter, reporter) {
 	if (formatter.indentWidth !== void 0) options.tabWidth = formatter.indentWidth;
 	if (formatter.lineEnding !== void 0) options.endOfLine = formatter.lineEnding;
 	if (formatter.bracketSpacing !== void 0) options.bracketSpacing = formatter.bracketSpacing;
+	if (formatter.bracketSameLine !== void 0) options.bracketSameLine = formatter.bracketSameLine;
 	if (formatter.attributePosition !== void 0) options.singleAttributePerLine = formatter.attributePosition === "multiline";
+	const objectWrap = mapBiomeExpandToObjectWrap(formatter.expand, "formatter", reporter);
+	if (objectWrap) options.objectWrap = objectWrap;
+	if (formatter.trailingNewline !== void 0) options.insertFinalNewline = formatter.trailingNewline;
 	if (formatter.formatWithErrors) reporter.warn("Biome's formatWithErrors option is not supported in Oxfmt overrides");
 	applyExplicitFormatterOptionPassThrough$1([formatter], options, reporter);
 	return options;
@@ -812,6 +856,12 @@ function mapJavaScriptFormatterOptions(jsFormatter, reporter) {
 	if (jsFormatter.arrowParentheses !== void 0) options.arrowParens = jsFormatter.arrowParentheses === "always" ? "always" : "avoid";
 	if (jsFormatter.bracketSpacing !== void 0) options.bracketSpacing = jsFormatter.bracketSpacing;
 	if (jsFormatter.bracketSameLine !== void 0) options.bracketSameLine = jsFormatter.bracketSameLine;
+	if (jsFormatter.attributePosition !== void 0) options.singleAttributePerLine = jsFormatter.attributePosition === "multiline";
+	const objectWrap = mapBiomeExpandToObjectWrap(jsFormatter.expand, "javascript.formatter", reporter);
+	if (objectWrap) options.objectWrap = objectWrap;
+	const operatorPosition = mapBiomeOperatorLinebreakToOxfmt(jsFormatter.operatorLinebreak);
+	if (operatorPosition) options.experimentalOperatorPosition = operatorPosition;
+	if (jsFormatter.trailingNewline !== void 0) options.insertFinalNewline = jsFormatter.trailingNewline;
 	applyExplicitFormatterOptionPassThrough$1([jsFormatter], options, reporter);
 	return options;
 }
@@ -824,6 +874,9 @@ function mapJsonFormatterOptions(jsonFormatter, reporter) {
 	if (jsonFormatter.indentWidth !== void 0) options.tabWidth = jsonFormatter.indentWidth;
 	if (jsonFormatter.lineEnding !== void 0) options.endOfLine = jsonFormatter.lineEnding;
 	if (jsonFormatter.trailingCommas !== void 0) options.trailingComma = jsonFormatter.trailingCommas === "none" ? "none" : "all";
+	const objectWrap = mapBiomeExpandToObjectWrap(jsonFormatter.expand, "json.formatter", reporter);
+	if (objectWrap) options.objectWrap = objectWrap;
+	if (jsonFormatter.trailingNewline !== void 0) options.insertFinalNewline = jsonFormatter.trailingNewline;
 	applyExplicitFormatterOptionPassThrough$1([jsonFormatter], options, reporter);
 	return options;
 }
@@ -836,6 +889,7 @@ function mapCssFormatterOptions(cssFormatter, reporter) {
 	if (cssFormatter.indentWidth !== void 0) options.tabWidth = cssFormatter.indentWidth;
 	if (cssFormatter.lineEnding !== void 0) options.endOfLine = cssFormatter.lineEnding;
 	if (cssFormatter.quoteStyle !== void 0) options.singleQuote = cssFormatter.quoteStyle === "single";
+	if (cssFormatter.trailingNewline !== void 0) options.insertFinalNewline = cssFormatter.trailingNewline;
 	applyExplicitFormatterOptionPassThrough$1([cssFormatter], options, reporter);
 	return options;
 }
@@ -878,6 +932,7 @@ function patternTargetsExtension(pattern, extensions) {
 //#region src/formatter-mapper.ts
 const EXPLICIT_OXFMT_OPTION_KEYS = [
 	"objectWrap",
+	"experimentalOperatorPosition",
 	"insertFinalNewline",
 	"embeddedLanguageFormatting",
 	"htmlWhitespaceSensitivity",
@@ -906,6 +961,9 @@ const GLOBAL_FORMATTER_KEYS = /* @__PURE__ */ new Set([
 	"lineWidth",
 	"attributePosition",
 	"bracketSpacing",
+	"bracketSameLine",
+	"expand",
+	"trailingNewline",
 	...EXPLICIT_OXFMT_OPTION_KEYS,
 	...Object.keys(LEGACY_EXPLICIT_OXFMT_OPTION_ALIASES)
 ]);
@@ -919,10 +977,13 @@ const JAVASCRIPT_FORMATTER_KEYS = /* @__PURE__ */ new Set([
 	"arrowParentheses",
 	"bracketSameLine",
 	"bracketSpacing",
+	"expand",
 	"indentStyle",
 	"indentWidth",
 	"lineEnding",
 	"lineWidth",
+	"operatorLinebreak",
+	"trailingNewline",
 	...EXPLICIT_OXFMT_OPTION_KEYS,
 	...Object.keys(LEGACY_EXPLICIT_OXFMT_OPTION_ALIASES)
 ]);
@@ -1010,9 +1071,13 @@ function mapFormatterOptions(formatter, oxfmtConfig, reporter) {
 	oxfmtConfig.arrowParens = "always";
 	const bracketSpacing = formatter?.bracketSpacing;
 	if (bracketSpacing !== void 0) oxfmtConfig.bracketSpacing = bracketSpacing;
+	if (formatter?.bracketSameLine !== void 0) oxfmtConfig.bracketSameLine = formatter.bracketSameLine;
 	const attributePosition = formatter?.attributePosition;
 	if (attributePosition === "multiline") oxfmtConfig.singleAttributePerLine = true;
 	else if (attributePosition === "auto") oxfmtConfig.singleAttributePerLine = false;
+	const objectWrap = mapBiomeExpandToObjectWrap(formatter?.expand, "formatter", reporter);
+	if (objectWrap) oxfmtConfig.objectWrap = objectWrap;
+	if (formatter?.trailingNewline !== void 0) oxfmtConfig.insertFinalNewline = formatter.trailingNewline;
 	if (formatter?.formatWithErrors) reporter.warn("Biome's formatWithErrors option is not supported in Oxfmt");
 }
 function mapIgnorePatterns$1(biomeConfig, oxfmtConfig, additionalIgnorePatterns) {
@@ -1290,6 +1355,40 @@ const OXLINT_CATEGORIES = [
 	"style",
 	"suspicious"
 ];
+/**
+* The React Compiler rules Oxlint activates for ESLint's `react-hooks/recommended` preset.
+*
+* 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.
+*
+* @see https://oxc.rs/blog/2026-08-18-react-compiler-support
+*/
+const REACT_COMPILER_RECOMMENDED_RULES = [
+	"react/error-boundaries",
+	"react/globals",
+	"react/immutability",
+	"react/incompatible-library",
+	"react/preserve-manual-memoization",
+	"react/purity",
+	"react/refs",
+	"react/set-state-in-effect",
+	"react/set-state-in-render",
+	"react/static-components",
+	"react/unsupported-syntax",
+	"react/use-memo"
+];
+/**
+* Mappings where the Oxlint rule covers only part of what the Biome rule checked. The note
+* is reported once per migration so the narrowing is visible rather than silent.
+*/
+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`
+};
 const BIOME_TO_OXLINT_RULE_MAP = {
 	noAccessKey: "jsx-a11y/no-access-key",
 	noAdjacentSpacesInRegex: "no-regex-spaces",
@@ -1311,6 +1410,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noBaseToString: "typescript/no-base-to-string",
 	noBeforeInteractiveScriptOutsideDocument: "nextjs/no-before-interactive-script-outside-document",
 	noBitwiseOperators: "no-bitwise",
+	noBlankTarget: "react/jsx-no-target-blank",
 	noCatchAssign: "no-ex-assign",
 	noChildrenProp: "react/no-children-prop",
 	noClassAssign: "no-class-assign",
@@ -1321,6 +1421,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 		"typescript/no-require-imports",
 		"typescript/no-var-requires"
 	],
+	noComponentHookFactories: "react/no-unstable-nested-components",
 	noCompareNegZero: "no-compare-neg-zero",
 	noConfusingLabels: "no-labels",
 	noConfusingVoidType: "typescript/no-invalid-void-type",
@@ -1358,6 +1459,8 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noEqualsToNull: "no-eq-null",
 	noExcessiveClassesPerFile: "max-classes-per-file",
 	noExcessiveCognitiveComplexity: "complexity",
+	noExcessiveLinesPerFile: "max-lines",
+	noExcessiveLinesPerFunction: "max-lines-per-function",
 	noExcessiveNestedCallbacks: "max-nested-callbacks",
 	noExplicitAny: "typescript/no-explicit-any",
 	noExtendNative: "no-extend-native",
@@ -1369,7 +1472,10 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noForEach: "unicorn/no-array-for-each",
 	noFunctionAssign: "no-func-assign",
 	noGlobalAssign: "no-global-assign",
+	noGlobalDirnameFilename: "unicorn/prefer-module",
 	noGlobalEval: "no-eval",
+	noGlobalIsFinite: "unicorn/prefer-number-properties",
+	noGlobalIsNan: "unicorn/prefer-number-properties",
 	noGlobalObjectCalls: "no-obj-calls",
 	noHeaderScope: "jsx-a11y/scope",
 	noHeadElement: "nextjs/no-head-element",
@@ -1389,6 +1495,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noIrregularWhitespace: "no-irregular-whitespace",
 	noInteractiveElementToNoninteractiveRole: "jsx-a11y/no-interactive-element-to-noninteractive-role",
 	noInvalidNewBuiltin: "no-new-native-nonconstructor",
+	noJsRestrictedProperties: "no-restricted-properties",
 	noJsxLiterals: "react/jsx-no-literals",
 	noJsxNamespace: "react/no-namespace",
 	noLabelWithoutControl: "jsx-a11y/label-has-associated-control",
@@ -1403,6 +1510,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noMultilineString: "no-multi-str",
 	noMultiStr: "no-multi-str",
 	noNegationElse: "no-negated-condition",
+	noNegationInEqualityCheck: "unicorn/no-negation-in-equality-check",
 	noNewSymbol: "no-new-native-nonconstructor",
 	noNodejsModules: "import/no-nodejs-modules",
 	noNamespace: "typescript/no-namespace",
@@ -1426,12 +1534,14 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noProto: "no-proto",
 	noPrototypeBuiltins: "no-prototype-builtins",
 	noRedeclare: "no-redeclare",
+	noReactPropAssignments: "react/immutability",
 	noRedundantAlt: "jsx-a11y/img-redundant-alt",
 	noRedundantRoles: "jsx-a11y/no-redundant-roles",
 	noReactStringRefs: "react/no-string-refs",
 	noDuplicateTestHooks: ["jest/no-duplicate-hooks", "vitest/no-duplicate-hooks"],
 	noConditionalExpect: ["jest/no-conditional-expect", "vitest/no-conditional-expect"],
 	noExcessiveNestedTestSuites: ["jest/max-nested-describe", "vitest/max-nested-describe"],
+	noExportsInTest: "jest/no-export",
 	noIdenticalTestTitle: ["jest/no-identical-title", "vitest/no-identical-title"],
 	noMisplacedAssertion: ["jest/no-standalone-expect", "vitest/no-standalone-expect"],
 	noRenderReturnValue: "react/no-render-return-value",
@@ -1469,6 +1579,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noUnreachable: "no-unreachable",
 	noUnreachableSuper: "constructor-super",
 	noUnsafeDeclarationMerging: "typescript/no-unsafe-declaration-merging",
+	noUnsafeTypeAssertion: "typescript/no-unsafe-type-assertion",
 	noUnsafeFinally: "no-unsafe-finally",
 	noUnsafeNegation: "no-unsafe-negation",
 	noUnsafeOptionalChaining: "no-unsafe-optional-chaining",
@@ -1479,8 +1590,10 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noUnusedVariables: "no-unused-vars",
 	noUnwantedPolyfillio: "nextjs/no-unwanted-polyfillio",
 	noUselessCatch: "no-useless-catch",
+	noUselessContinue: "no-continue",
 	noUselessCatchBinding: "unicorn/prefer-optional-catch-binding",
 	noUselessConstructor: "no-useless-constructor",
+	noUselessElse: "no-else-return",
 	noUselessEmptyExport: "typescript/no-useless-empty-export",
 	noUselessEscapeInRegex: "no-useless-escape",
 	noUselessEscapeInString: "no-useless-escape",
@@ -1497,6 +1610,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noUselessTypeConstraint: "typescript/no-unnecessary-type-constraint",
 	noUselessTypeConversion: "typescript/no-unnecessary-type-conversion",
 	noUselessUndefined: "unicorn/no-useless-undefined",
+	noUselessUndefinedInitialization: "unicorn/no-useless-undefined",
 	noVoid: "no-void",
 	noVar: "no-var",
 	noVoidElementsWithChildren: "react/void-dom-elements-no-children",
@@ -1537,6 +1651,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	useConsistentMethodSignatures: "typescript/method-signature-style",
 	useConsistentTypeDefinitions: "typescript/consistent-type-definitions",
 	useConsistentMemberAccessibility: "typescript/explicit-member-accessibility",
+	useConsistentObjectDefinitions: "object-shorthand",
 	useConsistentTestIt: ["jest/consistent-test-it", "vitest/consistent-test-it"],
 	useConst: "prefer-const",
 	useDateNow: "unicorn/prefer-date-now",
@@ -1551,6 +1666,8 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	useErrorMessage: "unicorn/error-message",
 	useExpect: ["jest/expect-expect", "vitest/expect-expect"],
 	useExplicitLengthCheck: "unicorn/explicit-length-check",
+	useExplicitReturnType: "typescript/explicit-function-return-type",
+	useExplicitType: "typescript/explicit-function-return-type",
 	useExponentiationOperator: "prefer-exponentiation-operator",
 	useExportsLast: "import/exports-last",
 	useExportType: "typescript/consistent-type-exports",
@@ -1573,6 +1690,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	useHookAtTopLevel: "react/rules-of-hooks",
 	useIframeSandbox: "react/iframe-missing-sandbox",
 	useIframeTitle: "jsx-a11y/iframe-has-title",
+	useImportExtensions: "import/extensions",
 	useImportsFirst: "import/first",
 	useImportType: "typescript/consistent-type-imports",
 	useIncludes: "typescript/prefer-includes",
@@ -1602,6 +1720,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	useParseIntRadix: "radix",
 	useReadonlyClassProperties: "typescript/prefer-readonly",
 	useReactFunctionComponentDefinition: "react/function-component-definition",
+	useReactCompiler: REACT_COMPILER_RECOMMENDED_RULES,
 	useReactFunctionComponents: "react/prefer-function-component",
 	useReduceTypeParameter: "typescript/prefer-reduce-type-parameter",
 	useRegexLiterals: "prefer-regex-literals",
@@ -1611,6 +1730,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	useSelfClosingElements: "react/self-closing-comp",
 	useShorthandAssign: "operator-assignment",
 	useShorthandFunctionType: "typescript/prefer-function-type",
+	useSingleVarDeclarator: "one-var",
 	useSimplifiedLogicExpression: "unicorn/prefer-logical-operator-over-ternary",
 	useSpread: "prefer-spread",
 	useSpreadOverApply: "prefer-spread",
@@ -1639,6 +1759,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	useYield: "require-yield"
 };
 const WARNED_UNMAPPED_RULES_BY_REPORTER = /* @__PURE__ */ new WeakMap();
+const WARNED_PARTIAL_MAPPINGS_BY_REPORTER = /* @__PURE__ */ new WeakMap();
 const WARNED_UNSUPPORTED_SEVERITIES_BY_REPORTER = /* @__PURE__ */ new WeakMap();
 const OXLINT_SEVERITY_NORMALIZATION = {
 	allow: "off",
@@ -1663,6 +1784,20 @@ function mapBiomeRuleOptionsToOxlintSeverity(biomeName, severity, biomeSeverity,
 	if (biomeName === "noExcessiveNestedCallbacks") return [severity, { max: options && isNonNegativeInteger(options.max) ? options.max : 5 }];
 	if (biomeName === "useErrorCause") return [severity, { requireCatchParameter: options && typeof options.requireCatchParameter === "boolean" ? options.requireCatchParameter : true }];
 	if (biomeName === "useMaxParams") return [severity, { max: options && isNonNegativeInteger(options.max) ? options.max : 4 }];
+	if (biomeName === "noExcessiveLinesPerFile") return [severity, {
+		max: options && isNonNegativeInteger(options.maxLines) ? options.maxLines : 300,
+		skipBlankLines: options?.skipBlankLines === true
+	}];
+	if (biomeName === "noExcessiveLinesPerFunction") return [severity, {
+		max: options && isNonNegativeInteger(options.maxLines) ? options.maxLines : 50,
+		skipBlankLines: options?.skipBlankLines === true,
+		IIFEs: options?.skipIifes !== true
+	}];
+	if (biomeName === "useSingleVarDeclarator") return [severity, "never"];
+	if (biomeName === "useImportExtensions") {
+		if (options?.extensionMappings !== void 0 || options?.forceJsExtensions !== void 0) reporter.loss("Biome rule useImportExtensions options \"extensionMappings\" and \"forceJsExtensions\" are not supported by Oxlint import/extensions; the rule requires an extension without rewriting it.");
+		return [severity, "ignorePackages"];
+	}
 	if (biomeName === "noTsIgnore") return [severity, {
 		"ts-ignore": true,
 		"ts-expect-error": false,
@@ -1714,6 +1849,22 @@ function mapBiomeRuleOptionsToOxlintSeverity(biomeName, severity, biomeSeverity,
 			{ requireReturnForObjectLiteral: options.requireForObjectLiteral }
 		] : [severity, mode];
 	}
+	if (biomeName === "noJsRestrictedProperties") {
+		const { entries } = options;
+		if (!Array.isArray(entries) || !entries.every(isRecord)) return severity;
+		return [severity, ...entries];
+	}
+	if (biomeName === "useConsistentObjectDefinitions") {
+		const { syntax } = options;
+		return syntax === "shorthand" ? [severity, "always"] : syntax === "explicit" ? [severity, "never"] : severity;
+	}
+	if (biomeName === "useExplicitReturnType") {
+		const oxlintOptions = {};
+		if (typeof options.allowExpressions === "boolean") oxlintOptions.allowExpressions = options.allowExpressions;
+		if (typeof options.allowIifes === "boolean") oxlintOptions.allowIIFEs = options.allowIifes;
+		if (Array.isArray(options.allowedNames) && options.allowedNames.every((value) => typeof value === "string")) oxlintOptions.allowedNames = options.allowedNames;
+		return Object.keys(oxlintOptions).length > 0 ? [severity, oxlintOptions] : severity;
+	}
 	if (biomeName === "useConsistentMethodSignatures") {
 		const { style } = options;
 		return style === "method" || style === "property" ? [severity, style] : severity;
@@ -1780,10 +1931,24 @@ function mapBiomeRuleSeverity(severity, reporter, biomeRuleName) {
 }
 function mapBiomeRuleToOxlintRules(biomeName, reporter) {
 	const mapped = BIOME_TO_OXLINT_RULE_MAP[biomeName];
-	if (mapped) return [...new Set((Array.isArray(mapped) ? mapped : [mapped]).map((ruleName) => normalizeOxlintRuleName(ruleName)))];
+	if (mapped) {
+		const partialMappingNote = PARTIAL_RULE_MAPPING_NOTES[biomeName];
+		if (partialMappingNote) warnPartialMappingOnce(biomeName, partialMappingNote, reporter);
+		return [...new Set((Array.isArray(mapped) ? mapped : [mapped]).map((ruleName) => normalizeOxlintRuleName(ruleName)))];
+	}
 	warnUnmappedRuleOnce(biomeName, reporter);
 	return [];
 }
+function warnPartialMappingOnce(biomeName, note, reporter) {
+	let warnedRules = WARNED_PARTIAL_MAPPINGS_BY_REPORTER.get(reporter);
+	if (!warnedRules) {
+		warnedRules = /* @__PURE__ */ new Set();
+		WARNED_PARTIAL_MAPPINGS_BY_REPORTER.set(reporter, warnedRules);
+	}
+	if (warnedRules.has(biomeName)) return;
+	warnedRules.add(biomeName);
+	reporter.loss(note);
+}
 function warnUnmappedRuleOnce(biomeName, reporter) {
 	let warnedRules = WARNED_UNMAPPED_RULES_BY_REPORTER.get(reporter);
 	if (!warnedRules) {
@@ -2121,15 +2286,19 @@ async function updatePackageJson(projectDir, reporter, dryRun, options = {}) {
 		summary.found = true;
 		let modified = false;
 		const updateScriptsEnabled = options.updateScripts ?? false;
+		const domModeEnabled = options.dom ?? false;
 		const removeBiomeAllowed = options.removeBiome ?? false;
 		const typeAwareProfile = options.typeAwareProfile ?? "standard";
 		const typeCheckEnabled = options.typeCheck ?? typeAwareProfile === "strict";
 		const typeAwareEnabled = options.typeAware ?? (typeCheckEnabled || typeAwareProfile === "strict");
-		const needsTypeAwareDependency = typeAwareEnabled || typeCheckEnabled;
+		const needsTypeAwareDependency = typeAwareEnabled || typeCheckEnabled || domModeEnabled;
 		const fixStrategy = options.fixStrategy ?? "safe";
 		const oxlintCommand = buildConfiguredCommand("oxlint", packageJsonPath, options.oxlintConfigPath);
 		const oxfmtCommand = buildConfiguredCommand("oxfmt", packageJsonPath, options.oxfmtConfigPath);
-		if (updateScriptsEnabled && packageJson.scripts) modified = updateScripts(packageJson.scripts, reporter, summary.scriptsUpdated, {
+		if (domModeEnabled) {
+			packageJson.scripts ??= {};
+			modified = applyDomScriptPreset(packageJson.scripts, summary.scriptsUpdated, oxlintCommand, oxfmtCommand) || modified;
+		} else if (updateScriptsEnabled && packageJson.scripts) modified = updateScripts(packageJson.scripts, reporter, summary.scriptsUpdated, {
 			typeAwareEnabled,
 			typeCheckEnabled,
 			fixStrategy,
@@ -2204,6 +2373,32 @@ async function detectLockfile(packageRoot, dependenciesChanged) {
 		};
 	}
 }
+function applyDomScriptPreset(scripts, updates, oxlintCommand, oxfmtCommand) {
+	let modified = false;
+	const preset = {
+		check: `${oxlintCommand} . && ${oxfmtCommand} --check .`,
+		"check:fix": `${oxlintCommand} --fix . && ${oxfmtCommand} --write .`,
+		format: `${oxfmtCommand} --write .`,
+		"format:check": `${oxfmtCommand} --check .`,
+		lint: `${oxlintCommand} -f github . > lint.md 2>&1`,
+		"lint:fix": `${oxlintCommand} -f stylish --fix .`,
+		"lint:fix-unsafe": `${oxlintCommand} -f stylish --react-plugin --import-plugin --react-perf-plugin --nextjs-plugin --type-aware --type-check --vitest-plugin --fix --fix-suggestions --fix-dangerously .`,
+		"check:fix-suggestions": `${oxlintCommand} -f stylish --react-plugin --import-plugin --react-perf-plugin --nextjs-plugin --type-aware --type-check --vitest-plugin --fix --fix-suggestions . && ${oxfmtCommand} --write .`,
+		"type-check": "tsc --noEmit"
+	};
+	for (const [scriptName, scriptValue] of Object.entries(preset)) {
+		const before = scripts[scriptName];
+		if (before === scriptValue) continue;
+		scripts[scriptName] = scriptValue;
+		updates.push({
+			name: scriptName,
+			before: before ?? "<missing>",
+			after: scriptValue
+		});
+		modified = true;
+	}
+	return modified;
+}
 function updateScripts(scripts, reporter, updates, options) {
 	let modified = false;
 	const lintBase = buildLintBaseCommand(options.oxlintCommand, options.typeAwareEnabled, options.typeCheckEnabled);
@@ -2810,6 +3005,7 @@ async function runMigration(options, reporter, biomeConfigPath) {
 			const packageJsonErrorCount = reporter.getErrors().length;
 			packageJsonSummary = await updatePackageJson(projectDir, reporter, false, {
 				updateScripts: options.updateScripts,
+				dom: options.dom,
 				removeBiome: cleanupAllowed,
 				typeAware: typeAwareEnabled,
 				typeCheck: typeCheckEnabled,
@@ -2838,6 +3034,7 @@ async function runMigration(options, reporter, biomeConfigPath) {
 			const packageJsonErrorCount = reporter.getErrors().length;
 			packageJsonSummary = await updatePackageJson(projectDir, reporter, true, {
 				updateScripts: options.updateScripts,
+				dom: options.dom,
 				removeBiome: cleanupAllowed,
 				typeAware: typeAwareEnabled,
 				typeCheck: typeCheckEnabled,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "biome-to-oxc",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Migrate from Biome to Oxc ecosystem (oxlint + oxfmt + oxlint-tsgolint)",
   "keywords": [
     "biome",
@@ -32,6 +32,24 @@
     "types": "./dist/src/index.d.mts",
     "import": "./dist/src/index.mjs"
   },
+  "scripts": {
+    "test": "vitest",
+    "test:run": "vitest --run",
+    "test:coverage": "vitest --run --coverage",
+    "format": "oxfmt --write .",
+    "format:check": "oxfmt --check .",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "lint:fix-unsafe": "oxlint --import-plugin --node-plugin --type-aware --type-check --vitest-plugin --fix --fix-suggestions --fix-dangerously .",
+    "check:fix-suggestions": "oxlint --import-plugin --node-plugin --type-aware --type-check --vitest-plugin --fix --fix-suggestions . && oxfmt --write .",
+    "typecheck": "tsc --noEmit",
+    "docs:sync": "node scripts/sync-rule-inventories.ts",
+    "docs:check": "node scripts/sync-rule-inventories.ts --check",
+    "check": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm docs:check && pnpm test:run",
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "prepublishOnly": "pnpm check && pnpm build"
+  },
   "dependencies": {
     "commander": "15.0.0",
     "jsonc-parser": "next",
@@ -40,34 +58,20 @@
   },
   "devDependencies": {
     "@arethetypeswrong/core": "^0.18.5",
-    "@biomejs/biome": "^2.5.7",
+    "@biomejs/biome": "^2.5.9",
     "@types/node": "^26.2.0",
-    "@vitest/coverage-v8": "^4.1.10",
-    "oxfmt": "^0.63.0",
-    "oxlint": "^1.78.0",
+    "@vitest/coverage-v8": "^4.1.11",
+    "oxfmt": "^0.64.0",
+    "oxlint": "^1.79.0",
     "oxlint-tsgolint": "^7.0.2001",
-    "publint": "^0.3.23",
+    "publint": "^0.3.24",
     "tsdown": "^0.22.14",
-    "typescript": "^7.0.2",
-    "vitest": "^4.1.10"
+    "typescript": "next",
+    "vitest": "^4.1.11"
   },
   "engines": {
     "node": ">=24.19.0",
-    "pnpm": ">=11.21.0"
+    "pnpm": ">=11.22.0"
   },
-  "scripts": {
-    "test": "vitest",
-    "test:run": "vitest --run",
-    "test:coverage": "vitest --run --coverage",
-    "format": "oxfmt --write .",
-    "format:check": "oxfmt --check .",
-    "lint": "oxlint .",
-    "lint:fix": "oxlint --fix .",
-    "lint:fix-unsafe": "oxlint --import-plugin --node-plugin --type-aware --type-check --vitest-plugin --fix --fix-suggestions --fix-dangerously .",
-    "check:fix-suggestions": "oxlint --import-plugin --node-plugin --type-aware --type-check --vitest-plugin --fix --fix-suggestions . && oxfmt --write .",
-    "typecheck": "tsc --noEmit",
-    "check": "pnpm format:check && pnpm lint && pnpm typecheck && pnpm test:run",
-    "build": "tsdown",
-    "dev": "tsdown --watch"
-  }
-}
+  "packageManager": "pnpm@11.22.0"
+}