biome-to-oxc 3.5.0 → 3.6.0

package/README.md

@@ -427,9 +427,10 @@ npx oxlint --type-aware --type-check
 - Oxfmt is in beta; review formatting changes before replacing the existing formatter
 - Overlapping `overrides` are migrated as-is. Biome and Oxfmt both merge matching overrides field
   by field with later entries winning, so the two agree; a conformance test pins this
-- Type-aware linting is stable as of `oxlint-tsgolint` v7 and requires TypeScript 7; 59 of the 61
-  targeted typescript-eslint rules are currently implemented
-- CSS and JSON formatter overrides are mapped but may need manual review
+- Type-aware linting is stable as of `oxlint-tsgolint` v7 and requires TypeScript 7; 60 of the 62
+  targeted typescript-eslint rules are currently implemented, and Oxlint 1.85 does not yet expose
+  `no-generated-empty-object-type`, so 59 can be enabled
+- CSS, JSON and GraphQL 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

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-Dz7Nl3tJ.mjs";
+import { i as readJsonFile, n as DefaultReporter, r as findClosestPackageJson, t as migrate } from "../src-BN3SXk7r.mjs";
 import { realpath } from "node:fs/promises";
 import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/src/index.d.mts

@@ -11,6 +11,7 @@ export interface BiomeConfig {
   javascript?: BiomeJavaScriptConfig;
   json?: BiomeJsonConfig;
   css?: BiomeCssConfig;
+  graphql?: BiomeGraphqlConfig;
   html?: Record<string, unknown>;
   overrides?: BiomeOverride[];
 }
@@ -164,6 +165,21 @@ export interface BiomeCssConfig {
     enabled?: boolean;
   };
 }
+export interface BiomeGraphqlConfig {
+  formatter?: {
+    enabled?: boolean;
+    bracketSpacing?: boolean;
+    indentStyle?: 'tab' | 'space';
+    indentWidth?: number;
+    lineEnding?: 'lf' | 'crlf' | 'cr' | 'auto';
+    lineWidth?: number;
+    quoteStyle?: 'single' | 'double';
+    trailingNewline?: boolean;
+  };
+  linter?: {
+    enabled?: boolean;
+  };
+}
 export interface BiomeOverride {
   include?: string[];
   includes?: string[];
@@ -176,6 +192,7 @@ export interface BiomeOverride {
   javascript?: BiomeJavaScriptConfig;
   json?: BiomeJsonConfig;
   css?: BiomeCssConfig;
+  graphql?: BiomeGraphqlConfig;
 }
 export type FixStrategy = 'safe' | 'suggestions' | 'dangerous';
 export type TypeAwareProfile = 'standard' | 'strict';

package/dist/src/index.mjs

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

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

@@ -147,8 +147,8 @@ function generateFeatureSpecificSuggestions(features) {
 	if (features.hasGraphQL) {
 		suggestions.push("");
 		suggestions.push("GraphQL detected:");
-		suggestions.push("  - Consider using graphql-prettier for GraphQL formatting");
-		suggestions.push("  - Oxfmt may support GraphQL in future releases");
+		suggestions.push("  - Oxfmt formats .graphql and .gql files natively");
+		suggestions.push("  - Biome graphql.formatter settings are migrated to an Oxfmt override");
 	}
 	if (features.hasMonorepo) {
 		suggestions.push("");
@@ -310,6 +310,7 @@ const SUPPORTED_TOP_LEVEL_FIELDS = /* @__PURE__ */ new Set([
 	"javascript",
 	"json",
 	"css",
+	"graphql",
 	"html",
 	"overrides"
 ]);
@@ -467,6 +468,24 @@ const BiomeCssConfigSchema = z.object({
 	}).passthrough().optional(),
 	linter: z.object({ enabled: z.boolean().optional() }).passthrough().optional()
 }).passthrough();
+const BiomeGraphqlConfigSchema = z.object({
+	formatter: z.object({
+		enabled: z.boolean().optional(),
+		bracketSpacing: z.boolean().optional(),
+		indentStyle: z.enum(["tab", "space"]).optional(),
+		indentWidth: z.number().int().optional(),
+		lineEnding: z.enum([
+			"lf",
+			"crlf",
+			"cr",
+			"auto"
+		]).optional(),
+		lineWidth: z.number().int().optional(),
+		quoteStyle: z.enum(["single", "double"]).optional(),
+		trailingNewline: z.boolean().optional()
+	}).passthrough().optional(),
+	linter: z.object({ enabled: z.boolean().optional() }).passthrough().optional()
+}).passthrough();
 const BiomeLinterConfigSchema = IncludeFieldsSchema.extend({
 	enabled: z.boolean().optional(),
 	ignore: z.array(z.string()).optional(),
@@ -500,7 +519,8 @@ const BiomeOverrideSchema = z.object({
 	assist: BiomeAssistConfigSchema.optional(),
 	javascript: BiomeJavaScriptConfigSchema.optional(),
 	json: BiomeJsonConfigSchema.optional(),
-	css: BiomeCssConfigSchema.optional()
+	css: BiomeCssConfigSchema.optional(),
+	graphql: BiomeGraphqlConfigSchema.optional()
 }).passthrough();
 const BiomeConfigSchema = z.object({
 	$schema: z.string().optional(),
@@ -526,6 +546,7 @@ const BiomeConfigSchema = z.object({
 	javascript: BiomeJavaScriptConfigSchema.optional(),
 	json: BiomeJsonConfigSchema.optional(),
 	css: BiomeCssConfigSchema.optional(),
+	graphql: BiomeGraphqlConfigSchema.optional(),
 	html: z.record(z.string(), z.unknown()).optional(),
 	overrides: z.array(BiomeOverrideSchema).optional()
 }).passthrough();
@@ -773,6 +794,7 @@ const CSS_EXTENSIONS = [
 	"sass",
 	"less"
 ];
+const GRAPHQL_EXTENSIONS = ["graphql", "gql"];
 const JSON_FORMATTER_KEYS = /* @__PURE__ */ new Set([
 	"enabled",
 	"expand",
@@ -796,6 +818,18 @@ const CSS_FORMATTER_KEYS = /* @__PURE__ */ new Set([
 	...EXPLICIT_OXFMT_OPTION_KEYS$1,
 	...Object.keys(LEGACY_EXPLICIT_OXFMT_OPTION_ALIASES$1)
 ]);
+const GRAPHQL_FORMATTER_KEYS = /* @__PURE__ */ new Set([
+	"enabled",
+	"bracketSpacing",
+	"indentStyle",
+	"indentWidth",
+	"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
@@ -824,6 +858,7 @@ function generateOxfmtOverrides(biomeOverrides, 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);
 		pushScopedOverride(oxfmtOverrides, files, excludeFiles, mapCssFormatterOptions(override.css?.formatter, reporter), reporter, "css.formatter", CSS_EXTENSIONS);
+		pushScopedOverride(oxfmtOverrides, files, excludeFiles, mapGraphqlFormatterOptions(override.graphql?.formatter, reporter), reporter, "graphql.formatter", GRAPHQL_EXTENSIONS);
 	}
 	return oxfmtOverrides;
 }
@@ -916,6 +951,19 @@ function mapCssFormatterOptions(cssFormatter, reporter) {
 	applyExplicitFormatterOptionPassThrough$1([cssFormatter], options, reporter);
 	return options;
 }
+function mapGraphqlFormatterOptions(graphqlFormatter, reporter) {
+	const options = {};
+	if (!graphqlFormatter) return options;
+	warnAboutUnsupportedKeys(graphqlFormatter, GRAPHQL_FORMATTER_KEYS, "graphql.formatter", reporter);
+	if (graphqlFormatter.lineWidth !== void 0) options.printWidth = graphqlFormatter.lineWidth;
+	if (graphqlFormatter.indentStyle !== void 0) options.useTabs = graphqlFormatter.indentStyle === "tab";
+	if (graphqlFormatter.indentWidth !== void 0) options.tabWidth = graphqlFormatter.indentWidth;
+	if (graphqlFormatter.lineEnding !== void 0) options.endOfLine = graphqlFormatter.lineEnding;
+	if (graphqlFormatter.bracketSpacing !== void 0) options.bracketSpacing = graphqlFormatter.bracketSpacing;
+	if (graphqlFormatter.trailingNewline !== void 0) options.insertFinalNewline = graphqlFormatter.trailingNewline;
+	applyExplicitFormatterOptionPassThrough$1([graphqlFormatter], options, reporter);
+	return options;
+}
 function warnAboutUnsupportedKeys(formatter, supportedKeys, label, reporter) {
 	for (const [key, value] of Object.entries(formatter)) {
 		if (value === void 0) continue;
@@ -1033,7 +1081,7 @@ function generateOxfmtConfig(biomeConfig, reporter, options = {}) {
 	warnAboutUnsupportedFormatterKeys(formatter, GLOBAL_FORMATTER_KEYS, "formatter", reporter);
 	warnAboutUnsupportedFormatterKeys(jsFormatter, JAVASCRIPT_FORMATTER_KEYS, "javascript.formatter", reporter);
 	if (formatter?.enabled === false) {
-		if (!(jsFormatter?.enabled === true || biomeConfig.json?.formatter?.enabled === true || biomeConfig.css?.formatter?.enabled === true)) oxfmtConfig.ignorePatterns = ["**/*"];
+		if (!(jsFormatter?.enabled === true || biomeConfig.json?.formatter?.enabled === true || biomeConfig.css?.formatter?.enabled === true || biomeConfig.graphql?.formatter?.enabled === true)) oxfmtConfig.ignorePatterns = ["**/*"];
 		else reporter.loss("Biome global formatting is disabled with a language formatter re-enabled; Oxfmt cannot represent that enable-only selection, so more files will be formatted than Biome formatted.");
 	}
 	const positiveSelectors = [...biomeConfig.files?.include ?? [], ...formatter?.include ?? []];
@@ -1056,6 +1104,10 @@ function generateOxfmtConfig(biomeConfig, reporter, options = {}) {
 		{
 			include: ["**/*.{css,scss,sass,less}"],
 			css: biomeConfig.css
+		},
+		{
+			include: ["**/*.{graphql,gql}"],
+			graphql: biomeConfig.graphql
 		}
 	], reporter);
 	if (languageOverrides.length > 0) oxfmtConfig.overrides = languageOverrides;
@@ -1078,6 +1130,7 @@ function mapDisabledLanguageFormatters(biomeConfig, oxfmtConfig) {
 	if (biomeConfig.javascript?.formatter?.enabled === false) disabledPatterns.push("**/*.{js,jsx,ts,tsx,mjs,mts,cjs,cts}");
 	if (biomeConfig.json?.formatter?.enabled === false) disabledPatterns.push("**/*.{json,jsonc,json5}");
 	if (biomeConfig.css?.formatter?.enabled === false) disabledPatterns.push("**/*.{css,scss,sass,less}");
+	if (biomeConfig.graphql?.formatter?.enabled === false) disabledPatterns.push("**/*.{graphql,gql}");
 	if (disabledPatterns.length > 0) oxfmtConfig.ignorePatterns = [.../* @__PURE__ */ new Set([...oxfmtConfig.ignorePatterns ?? [], ...disabledPatterns])];
 }
 function warnAboutUnsupportedFormatterKeys(formatter, supportedKeys, label, reporter) {
@@ -1284,8 +1337,7 @@ const UNSUPPORTED_BIOME_RULE_GUIDANCE = {
 	noRedundantUseStrict: {
 		nativeAlternatives: ["unicorn/prefer-module"],
 		notes: "No native Oxlint equivalent for redundant `\"use strict\"` directives. For ESM, strict mode is already implicit."
-	},
-	useSingleVarDeclarator: { notes: "No native Oxlint equivalent for enforcing single declarators (ESLint `one-var`). Consider custom JS plugin policy if this is mandatory." }
+	}
 };
 function collectUnsupportedBiomeRules(warnings) {
 	const unsupported = /* @__PURE__ */ new Set();
@@ -1489,7 +1541,10 @@ const REACT_COMPILER_RULES = [
 */
 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.",
+	noInlineStyles: "Biome rule noInlineStyles was mapped to react/forbid-dom-props, which reports the `style` prop on JSX DOM elements but not `style` passed through React.createElement() or written in HTML, Vue, Svelte or Astro templates.",
 	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.",
+	noUnresolvedImports: "Biome rule noUnresolvedImports was mapped to import/named, which reports named imports a JavaScript module does not export but skips TypeScript files entirely and does not report import paths that cannot be resolved.",
+	noUnsafeIframeSandbox: "Biome rule noUnsafeIframeSandbox was mapped to react/iframe-missing-sandbox, which reports `allow-scripts` combined with `allow-same-origin` only when the sandbox value is a plain string attribute, not a `{\"...\"}` or template-literal expression; it also reports iframes with no or an invalid sandbox attribute, which Biome leaves to useIframeSandbox.",
 	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.",
 	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()."
 };
@@ -1608,6 +1663,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noImportCycles: "import/no-cycle",
 	noImplicitCoercions: "no-implicit-coercion",
 	noInnerDeclarations: "no-inner-declarations",
+	noInlineStyles: "react/forbid-dom-props",
 	noImplicitBoolean: "no-implicit-coercion",
 	noImpliedEval: "no-implied-eval",
 	noIncrementDecrement: "no-plusplus",
@@ -1674,6 +1730,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noRestrictedImports: "no-restricted-imports",
 	noRestrictedTypes: "typescript/no-restricted-types",
 	noReturnAssign: "no-return-assign",
+	noReturnInFinally: "promise/no-return-in-finally",
 	noScriptUrl: "no-script-url",
 	noSelfCompare: "no-self-compare",
 	noSelfAssign: "no-self-assign",
@@ -1698,13 +1755,16 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	noUnusedFunctionParameters: "no-unused-vars",
 	noUnusedImports: "no-unused-vars",
 	noUnnecessaryContinue: "no-continue",
+	noUnmodifiedLoopCondition: "no-unmodified-loop-condition",
 	noUnnecessaryConditions: "typescript/no-unnecessary-condition",
 	noUnnecessaryTemplateExpression: "typescript/no-unnecessary-template-expression",
 	noUnreachable: "no-unreachable",
 	noUnreachableSuper: "constructor-super",
+	noUnresolvedImports: "import/named",
 	noUnsafeDeclarationMerging: "typescript/no-unsafe-declaration-merging",
 	noUnsafeTypeAssertion: "typescript/no-unsafe-type-assertion",
 	noUnsafeFinally: "no-unsafe-finally",
+	noUnsafeIframeSandbox: "react/iframe-missing-sandbox",
 	noUnsafeNegation: "no-unsafe-negation",
 	noUnsafeOptionalChaining: "no-unsafe-optional-chaining",
 	noUnsafePlusOperands: "typescript/restrict-plus-operands",
@@ -1772,6 +1832,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	useConsistentBuiltinInstantiation: "no-new-wrappers",
 	useConsistentCurlyBraces: "curly",
 	useConsistentEnumValueType: "typescript/no-mixed-enums",
+	useConsistentFunctionStyle: "func-style",
 	useConsistentMethodSignatures: "typescript/method-signature-style",
 	useConsistentTypeDefinitions: "typescript/consistent-type-definitions",
 	useConsistentMemberAccessibility: "typescript/explicit-member-accessibility",
@@ -1832,6 +1893,7 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	useMathMinMax: "unicorn/prefer-math-min-max",
 	useMaxParams: "max-params",
 	useMediaCaption: "jsx-a11y/media-has-caption",
+	useModernMathApis: "unicorn/prefer-modern-math-apis",
 	useNamedCaptureGroup: "prefer-named-capture-group",
 	useNamespaceKeyword: "typescript/prefer-namespace-keyword",
 	useNodejsImportProtocol: "unicorn/prefer-node-protocol",
@@ -1878,8 +1940,10 @@ const BIOME_TO_OXLINT_RULE_MAP = {
 	useValidAutocomplete: "jsx-a11y/autocomplete-valid",
 	useValidForDirection: "for-direction",
 	useValidLang: "jsx-a11y/lang",
+	useValidTestTitle: ["jest/valid-title", "vitest/valid-title"],
 	useValidTypeof: "valid-typeof",
 	useVarsOnTop: "vars-on-top",
+	useVueBaseImport: "vue/prefer-import-from-vue",
 	useVueConsistentDefinePropsDeclaration: "vue/define-props-declaration",
 	useVueNextTickPromise: "vue/next-tick-style",
 	useYield: "require-yield"
@@ -1920,6 +1984,7 @@ function mapBiomeRuleOptionsToOxlintSeverity(biomeName, severity, biomeSeverity,
 		IIFEs: options?.skipIifes !== true
 	}];
 	if (biomeName === "useSingleVarDeclarator") return [severity, "never"];
+	if (biomeName === "noInlineStyles") return [severity, { forbid: ["style"] }];
 	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"];
@@ -2000,6 +2065,17 @@ function mapBiomeRuleOptionsToOxlintSeverity(biomeName, severity, biomeSeverity,
 		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 === "useConsistentFunctionStyle") {
+		if (options.style !== "declaration") return severity;
+		return [
+			severity,
+			"declaration",
+			{
+				allowArrowFunctions: options.allowArrowFunctions === true,
+				allowTypeAnnotation: true
+			}
+		];
+	}
 	if (biomeName === "useConsistentMethodSignatures") {
 		const { style } = options;
 		return style === "method" || style === "property" ? [severity, style] : severity;
@@ -2025,6 +2101,12 @@ function mapBiomeRuleOptionsToOxlintSeverity(biomeName, severity, biomeSeverity,
 		const namedComponents = options.namedComponents === "functionDeclaration" ? "function-declaration" : options.namedComponents === "functionExpression" ? "function-expression" : options.namedComponents === "arrowFunction" ? "arrow-function" : null;
 		return namedComponents ? [severity, { namedComponents }] : severity;
 	}
+	if (biomeName === "useValidTestTitle") {
+		const { disallowedWords } = options;
+		if (!Array.isArray(disallowedWords) || disallowedWords.length === 0 || !disallowedWords.every((value) => typeof value === "string")) return severity;
+		reporter.loss("Biome rule useValidTestTitle option \"disallowedWords\" was migrated, but Oxlint valid-title stops reporting titles with leading or trailing whitespace once disallowedWords is set.");
+		return [severity, { disallowedWords }];
+	}
 	if (biomeName === "useThisInClassMethods") {
 		const oxlintOptions = {};
 		if (options.ignoreClassesWithImplements === "all" || options.ignoreClassesWithImplements === "public-fields") oxlintOptions.ignoreClassesWithImplements = options.ignoreClassesWithImplements;
@@ -3287,7 +3369,7 @@ async function buildSuggestions({ biomeIgnorePatterns, detectedIntegrations, opt
 		suggestions.push("  pnpm add -D oxlint-tsgolint@latest");
 		suggestions.push(`  ${typeAwareCommand}`);
 		suggestions.push("Type-aware mode uses the tsgolint backend.");
-		suggestions.push("Type-aware linting is stable as of tsgolint v7; it covers 59 of typescript-eslint’s 61 type-aware rules, so check the remaining two if you relied on them.");
+		suggestions.push("Type-aware linting is stable as of tsgolint v7; it implements 60 of typescript-eslint’s 62 type-aware rules, and Oxlint does not yet expose no-generated-empty-object-type, so check those three if you relied on them.");
 		suggestions.push("TypeScript compatibility caveat: migrate deprecated tsconfig options if needed (typescript-go / TS7+ behavior).");
 		suggestions.push(`Resolved type-aware profile: ${typeAwareProfile}`);
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "biome-to-oxc",
-  "version": "3.5.0",
+  "version": "3.6.0",
   "description": "Migrate from Biome to Oxc ecosystem (oxlint + oxfmt + oxlint-tsgolint)",
   "keywords": [
     "biome",
@@ -54,20 +54,20 @@
     "commander": "15.0.0",
     "jsonc-parser": "next",
     "picocolors": "^1.1.1",
-    "zod": "^4.5.4"
+    "zod": "^4.6.5"
   },
   "devDependencies": {
     "@arethetypeswrong/core": "^0.18.5",
-    "@biomejs/biome": "^2.5.11",
-    "@types/node": "^26.4.1",
-    "@vitest/coverage-v8": "^4.1.11",
-    "oxfmt": "^0.66.0",
-    "oxlint": "^1.81.0",
-    "oxlint-tsgolint": "^7.0.2001",
+    "@biomejs/biome": "^2.5.14",
+    "@types/node": "^26.6.3",
+    "@vitest/coverage-v8": "^5.0.2",
+    "oxfmt": "^0.70.0",
+    "oxlint": "^1.85.0",
+    "oxlint-tsgolint": "^7.0.2003",
     "publint": "^0.3.24",
     "tsdown": "rc",
     "typescript": "next",
-    "vitest": "^4.1.11"
+    "vitest": "^5.0.2"
   },
   "engines": {
     "node": ">=24.19.0",