@isentinel/eslint-config 6.0.0-beta.13 → 6.0.0-beta.14

package/dist/cli.mjs

@@ -9,7 +9,7 @@ import path from "node:path";
 import { existsSync, readFileSync } from "fs";
 import { execSync } from "node:child_process";
 //#region package.json
-var version = "6.0.0-beta.13";
+var version = "6.0.0-beta.14";
 var package_default = {
 	name: "@isentinel/eslint-config",
 	version,

package/dist/index.d.mts

@@ -26244,7 +26244,7 @@ type Yoda = [] | [("always" | "never")] | [("always" | "never"), {
   onlyEquality?: boolean;
 }];
 // Names of all the configs
-type ConfigNames = 'isentinel/eslint/comments' | 'isentinel/eslint/comments/src' | 'isentinel/e18e/rules' | 'isentinel/eslint-plugin/setup' | 'isentinel/eslint-plugin/rules' | 'isentinel/flawless/setup' | 'isentinel/flawless/rules' | 'isentinel/flawless/markdown-code' | 'isentinel/flawless/rules-type-aware' | 'isentinel/gitignore' | 'isentinel/ignores' | 'isentinel/imports/rules' | 'isentinel/imports/game' | 'isentinel/javascript/setup' | 'isentinel/javascript/rules' | 'isentinel/jsdoc/setup' | 'isentinel/jsdoc' | 'isentinel/jsonc/setup' | 'isentinel/jsonc/rules' | 'isentinel/jsonc/tsconfig' | 'isentinel/markdown/setup' | 'isentinel/markdown/processor' | 'isentinel/markdown/parser' | 'isentinel/markdown/disables' | 'isentinel/naming/setup' | 'isentinel/naming/ts/rules-type-aware' | 'isentinel/naming/tsx/rules-type-aware' | 'isentinel/node/rules' | 'isentinel/oxfmt/setup' | 'isentinel/oxfmt/javascript' | 'isentinel/oxfmt/typescript' | 'isentinel/oxfmt/css' | 'isentinel/oxfmt/scss' | 'isentinel/oxfmt/less' | 'isentinel/oxfmt/html' | 'isentinel/oxfmt/markdown' | 'isentinel/oxfmt/graphql' | 'isentinel/oxfmt/json' | 'isentinel/oxfmt/yaml' | 'isentinel/package-json/setup' | 'isentinel/package-json' | 'isentinel/package-json/root' | 'isentinel/perfectionist/setup' | 'isentinel/perfectionist' | 'isentinel/perfectionist/jsx' | 'isentinel/pnpm/setup' | 'isentinel/pnpm/package-json' | 'isentinel/pnpm/pnpm-workspace-yaml' | 'isentinel/promise' | 'isentinel/react/setup' | 'isentinel/react/setup/naming' | 'isentinel/react/rules' | 'isentinel/react/type-aware-rules' | 'isentinel/roblox/setup' | 'isentinel/roblox/parser' | 'isentinel/roblox/type-aware-parser' | 'isentinel/roblox' | 'isentinel/roblox/rules-type-aware' | 'isentinel/roblox/format-lua/setup' | 'isentinel/roblox/format-lua' | 'isentinel/small-rules/setup' | 'isentinel/small-rules' | 'isentinel/sonarjs' | 'isentinel/spelling/setup' | 'isentinel/spelling' | 'isentinel/stylistic/setup' | 'isentinel/stylistic' | 'isentinel/test/jest/setup' | 'isentinel/test/jest/rules' | 'isentinel/test/vitest/setup' | 'isentinel/test/vitest/rules' | 'isentinel/toml/setup' | 'isentinel/toml/rules' | 'isentinel/typescript/setup' | 'isentinel/typescript/parser' | 'isentinel/typescript/type-aware-parser' | 'isentinel/typescript/rules' | 'isentinel/typescript/rules-type-aware' | 'isentinel/typescript/erasable-syntax-only' | 'isentinel/unicorn/setup' | 'isentinel/unicorn/rules' | 'isentinel/unicorn/root' | 'isentinel/yaml/setup' | 'isentinel/yaml/rules';
+type ConfigNames = 'isentinel/eslint/comments' | 'isentinel/eslint/comments/src' | 'isentinel/e18e/rules' | 'isentinel/eslint-plugin/setup' | 'isentinel/eslint-plugin/rules' | 'isentinel/flawless/setup' | 'isentinel/flawless/rules' | 'isentinel/flawless/markdown-code' | 'isentinel/flawless/rules-type-aware' | 'isentinel/gitignore' | 'isentinel/ignores' | 'isentinel/imports/rules' | 'isentinel/imports/game' | 'isentinel/javascript/setup' | 'isentinel/javascript/rules' | 'isentinel/jsdoc/setup' | 'isentinel/jsdoc' | 'isentinel/jsonc/setup' | 'isentinel/jsonc/rules' | 'isentinel/jsonc/tsconfig' | 'isentinel/markdown/setup' | 'isentinel/markdown/processor' | 'isentinel/markdown/parser' | 'isentinel/markdown/disables' | 'isentinel/naming/setup' | 'isentinel/naming/ts/rules-type-aware' | 'isentinel/naming/tsx/rules-type-aware' | 'isentinel/node/rules' | 'isentinel/oxfmt/setup' | 'isentinel/oxfmt/javascript' | 'isentinel/oxfmt/typescript' | 'isentinel/oxfmt/css' | 'isentinel/oxfmt/scss' | 'isentinel/oxfmt/less' | 'isentinel/oxfmt/html' | 'isentinel/oxfmt/markdown' | 'isentinel/oxfmt/graphql' | 'isentinel/oxfmt/json' | 'isentinel/oxfmt/yaml' | 'isentinel/package-json/setup' | 'isentinel/package-json' | 'isentinel/package-json/root' | 'isentinel/perfectionist/setup' | 'isentinel/perfectionist' | 'isentinel/perfectionist/jsx' | 'isentinel/pnpm/setup' | 'isentinel/pnpm/package-json' | 'isentinel/pnpm/pnpm-workspace-yaml' | 'isentinel/promise' | 'isentinel/react/setup' | 'isentinel/react/setup/naming' | 'isentinel/react/rules' | 'isentinel/react/type-aware-rules' | 'isentinel/roblox/setup' | 'isentinel/roblox/parser' | 'isentinel/roblox/type-aware-parser' | 'isentinel/roblox' | 'isentinel/roblox/rules-type-aware' | 'isentinel/roblox/format-lua/setup' | 'isentinel/roblox/format-lua' | 'isentinel/small-rules/setup' | 'isentinel/small-rules' | 'isentinel/sonarjs' | 'isentinel/spelling/setup' | 'isentinel/spelling' | 'isentinel/stylistic/setup' | 'isentinel/stylistic' | 'isentinel/test/jest/setup' | 'isentinel/test/jest/rules' | 'isentinel/test/jest/type-tests' | 'isentinel/test/vitest/setup' | 'isentinel/test/vitest/rules' | 'isentinel/test/vitest/type-tests' | 'isentinel/toml/setup' | 'isentinel/toml/rules' | 'isentinel/typescript/setup' | 'isentinel/typescript/parser' | 'isentinel/typescript/type-aware-parser' | 'isentinel/typescript/rules' | 'isentinel/typescript/rules-type-aware' | 'isentinel/typescript/erasable-syntax-only' | 'isentinel/unicorn/setup' | 'isentinel/unicorn/rules' | 'isentinel/unicorn/root' | 'isentinel/yaml/setup' | 'isentinel/yaml/rules';
 //#endregion
 //#region src/utils.d.ts
 type ExtractRuleOptions<T> = T extends Linter.RuleEntry<infer U> ? U : never;
@@ -26761,9 +26761,14 @@ interface OptionsConfig extends OptionsComponentExtensions, OptionsProjectType {
    * Requires installing the optional peer dependencies `oxlint` and
    * `oxlint-tsgolint`.
    *
+   * `"native"` narrows the hand-off to the rules oxlint implements in Rust
+   * (native rules plus the tsgolint type-aware ones): rules that would run in
+   * oxlint as jsPlugins — and formatting — stay in ESLint. Pair it with
+   * `jsPlugins: false` in the oxlint factory, or both engines run them.
+   *
    * @default false
    */
-  oxlint?: boolean;
+  oxlint?: "native" | boolean;
   /**
    * Warn at config-build time when a user config references a rule that
    * oxlint owns in hybrid mode (`oxlint: true`), where the ESLint entry has
@@ -27094,6 +27099,11 @@ declare const GLOB_MISE: Array<string>;
 declare const GLOB_HTML = "**/*.htm{,l}";
 declare const GLOB_XML = "**/*.xml";
 declare const GLOB_GRAPHQL = "**/*.{g,graph}ql";
+/**
+ * Type tests (`expectTypeOf` / `assertType`), run by Vitest's `typecheck`
+ * mode. They are test files, but assert nothing at runtime.
+ */
+declare const GLOB_TYPE_TESTS = "**/*.test-d.{,c,m}[jt]s{,x}";
 declare const GLOB_TESTS: Array<string>;
 declare const GLOB_BUILD_TOOLS: Array<string>;
 declare const GLOB_ALL_SRC: string[];
@@ -27282,4 +27292,4 @@ declare function unicorn({ complementIgnores, nameReplacements, roblox, root: cu
 //#region src/eslint/configs/yaml.d.ts
 declare function yaml({ files, overrides, stylistic }?: OptionsFiles & OptionsOverrides & OptionsStylistic): Promise<Array<TypedFlatConfigItem>>;
 //#endregion
-export { Awaitable, type ConfigNames, type FlatConfigComposer, GLOB_ALL_JSON, GLOB_ALL_SRC, GLOB_BUILD_TOOLS, GLOB_CSS, GLOB_DTS, GLOB_EXCLUDE, GLOB_GRAPHQL, GLOB_HTML, GLOB_JS, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSX, GLOB_LESS, GLOB_LINTABLE_EXTENSIONS, GLOB_LUA, GLOB_MARKDOWN, GLOB_MARKDOWN_BLOCKS, GLOB_MARKDOWN_CODE, GLOB_MARKDOWN_IN_MARKDOWN, GLOB_MISE, GLOB_PACKAGE_JSON, GLOB_PACKAGE_JSON_ROOT, GLOB_POSTCSS, GLOB_ROOT, GLOB_ROOT_SRC, GLOB_SCSS, GLOB_SRC, GLOB_SRC_EXT, GLOB_SRC_EXTENSIONS, GLOB_STYLE, GLOB_TESTS, GLOB_TOML, GLOB_TS, GLOB_TSCONFIG, GLOB_TSX, GLOB_XML, GLOB_YAML, GitignoreOptions, JsdocOptions, NamedFlatConfigItem, NamedOptionsConfig, OptionsComponentExtensions, OptionsConfig, OptionsE18e, OptionsFiles, OptionsFilesTypeAware, OptionsFormatters, OptionsHasRoblox, OptionsHasTypeScript, OptionsIsInEditor, OptionsJest, OptionsOverrides, OptionsOverridesTypeAware, OptionsPnpm, OptionsProjectType, OptionsStylistic, OptionsTestFramework, OptionsTypeScriptErasableOnly, OptionsTypeScriptParserOptions, OptionsTypeScriptWithTypes, OptionsTypescript, OptionsUnicorn, OptionsVitest, type OxfmtOptions, PerfectionistConfig, type PrettierOptions, ReactConfig, Rules, SpellCheckConfig, StylisticConfig, StylisticConfigDefaults, TypedFlatConfigItem, comments, isentinel as default, isentinel, defaultPluginRenaming, disables, e18e, eslintPlugin, flawless, gitignore, ignores$1 as ignores, imports, isInAgentSession, isInEditorEnvironment, isInGitHooksOrLintStaged, javascript, jsdoc, jsonc, loadSmallRulesPlugin, markdown, naming, node, oxfmt, packageJson, perfectionist, pnpm, promise, react, roblox$1 as roblox, smallRules, sonarjs, sortCspell, sortGithubAction, sortMiseToml, sortPnpmWorkspace, sortRojoProject, sortTsconfig, spelling, stylistic$1 as stylistic, test, toml, typescript, unicorn, yaml };
+export { Awaitable, type ConfigNames, type FlatConfigComposer, GLOB_ALL_JSON, GLOB_ALL_SRC, GLOB_BUILD_TOOLS, GLOB_CSS, GLOB_DTS, GLOB_EXCLUDE, GLOB_GRAPHQL, GLOB_HTML, GLOB_JS, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSX, GLOB_LESS, GLOB_LINTABLE_EXTENSIONS, GLOB_LUA, GLOB_MARKDOWN, GLOB_MARKDOWN_BLOCKS, GLOB_MARKDOWN_CODE, GLOB_MARKDOWN_IN_MARKDOWN, GLOB_MISE, GLOB_PACKAGE_JSON, GLOB_PACKAGE_JSON_ROOT, GLOB_POSTCSS, GLOB_ROOT, GLOB_ROOT_SRC, GLOB_SCSS, GLOB_SRC, GLOB_SRC_EXT, GLOB_SRC_EXTENSIONS, GLOB_STYLE, GLOB_TESTS, GLOB_TOML, GLOB_TS, GLOB_TSCONFIG, GLOB_TSX, GLOB_TYPE_TESTS, GLOB_XML, GLOB_YAML, GitignoreOptions, JsdocOptions, NamedFlatConfigItem, NamedOptionsConfig, OptionsComponentExtensions, OptionsConfig, OptionsE18e, OptionsFiles, OptionsFilesTypeAware, OptionsFormatters, OptionsHasRoblox, OptionsHasTypeScript, OptionsIsInEditor, OptionsJest, OptionsOverrides, OptionsOverridesTypeAware, OptionsPnpm, OptionsProjectType, OptionsStylistic, OptionsTestFramework, OptionsTypeScriptErasableOnly, OptionsTypeScriptParserOptions, OptionsTypeScriptWithTypes, OptionsTypescript, OptionsUnicorn, OptionsVitest, type OxfmtOptions, PerfectionistConfig, type PrettierOptions, ReactConfig, Rules, SpellCheckConfig, StylisticConfig, StylisticConfigDefaults, TypedFlatConfigItem, comments, isentinel as default, isentinel, defaultPluginRenaming, disables, e18e, eslintPlugin, flawless, gitignore, ignores$1 as ignores, imports, isInAgentSession, isInEditorEnvironment, isInGitHooksOrLintStaged, javascript, jsdoc, jsonc, loadSmallRulesPlugin, markdown, naming, node, oxfmt, packageJson, perfectionist, pnpm, promise, react, roblox$1 as roblox, smallRules, sonarjs, sortCspell, sortGithubAction, sortMiseToml, sortPnpmWorkspace, sortRojoProject, sortTsconfig, spelling, stylistic$1 as stylistic, test, toml, typescript, unicorn, yaml };

package/dist/index.mjs

@@ -152,10 +152,16 @@ const GLOB_MISE = [
 const GLOB_HTML = "**/*.htm{,l}";
 const GLOB_XML = "**/*.xml";
 const GLOB_GRAPHQL = "**/*.{g,graph}ql";
+/**
+* Type tests (`expectTypeOf` / `assertType`), run by Vitest's `typecheck`
+* mode. They are test files, but assert nothing at runtime.
+*/
+const GLOB_TYPE_TESTS = `**/*.test-d.${GLOB_SRC_EXT}`;
 const GLOB_TESTS = [
 	`**/__tests__/**/*.${GLOB_SRC_EXT}`,
 	`**/*.spec.${GLOB_SRC_EXT}`,
 	`**/*.test.${GLOB_SRC_EXT}`,
+	GLOB_TYPE_TESTS,
 	`**/*.bench.${GLOB_SRC_EXT}`,
 	`**/*.benchmark.${GLOB_SRC_EXT}`
 ];
@@ -4631,6 +4637,21 @@ async function stylistic(options = {}) {
 //#endregion
 //#region src/rules/test.ts
 /**
+* Rules that make no sense in a type test (`*.test-d.ts`): these files assert
+* with `expectTypeOf`/`assertType` at compile time, run no expectations, and
+* name their blocks after the types under test.
+*
+* @param prefix - The test-plugin prefix in use (`jest` or `vitest`).
+* @returns The rule map.
+*/
+function typeTestRules(prefix) {
+	return {
+		[`${prefix}/expect-expect`]: "off",
+		[`${prefix}/prefer-expect-assertions`]: "off",
+		[`${prefix}/prefer-lowercase-title`]: "off"
+	};
+}
+/**
 * Jest-extended rules shared between the ESLint and oxlint factories.
 *
 * @returns The rule map.
@@ -4859,6 +4880,10 @@ async function test({ files = GLOB_TESTS, isInEditor = false, jest = false, over
 				globalPackage: "@rbxts/jest-globals",
 				version: 27
 			} }
+		}, {
+			name: "isentinel/test/jest/type-tests",
+			files: [GLOB_TYPE_TESTS],
+			rules: typeTestRules("jest")
 		});
 	}
 	if (enableVitest) {
@@ -4896,6 +4921,10 @@ async function test({ files = GLOB_TESTS, isInEditor = false, jest = false, over
 				...useJestExtended ? { jest: { globalPackage: "vitest" } } : {},
 				vitest: { typecheck: vitestOptions.typecheck ?? false }
 			}
+		}, {
+			name: "isentinel/test/vitest/type-tests",
+			files: [GLOB_TYPE_TESTS],
+			rules: typeTestRules("vitest")
 		});
 	}
 	return configs;
@@ -15378,6 +15407,17 @@ function isOxlintCovered(rule) {
 	return rule in oxlintRuleMapping || rule in oxcCoveredRules;
 }
 /**
+* Whether the rule only runs in oxlint through a jsPlugin (the original ESLint
+* plugin loaded by oxlint), rather than natively in Rust. Native-only hybrid
+* mode (`oxlint: "native"`) leaves these rules in ESLint.
+*
+* @param rule - The canonical ESLint rule name.
+* @returns Whether the rule runs as an oxlint jsPlugin.
+*/
+function isJsPluginRule(rule) {
+	return oxlintRuleMapping[rule] === "js-plugin";
+}
+/**
 * Whether the rule runs via oxlint-tsgolint (`oxlint --type-aware`); such rules
 * are noise without type information, so they are gated on `typeAware`.
 *
@@ -15398,9 +15438,11 @@ const HYBRID_FORMATTING_RULES = /* @__PURE__ */ new Set(["oxfmt/oxfmt"]);
 * virtual files, so the preset re-enables those rules there.
 *
 * @param configs - The resolved flat config items.
+* @param mode - The hybrid mode; in `native` mode jsPlugin rules and formatting
+*   stay in ESLint, so entries for them are live and not reported.
 */
-function warnDeadMappedRules(configs) {
-	const references = findDeadMappedRules(configs);
+function warnDeadMappedRules(configs, mode) {
+	const references = findDeadMappedRules(configs, mode);
 	if (references.length === 0) return;
 	const lines = references.map(({ config, rule }) => `  - "${rule}" in ${config}`);
 	console.warn(`[@isentinel/eslint-config] These config entries reference rules that oxlint owns in hybrid mode, so they have no effect in ESLint. Move them to oxlint.config.ts (or your oxfmt options) or remove them:\n${lines.join("\n")}`);
@@ -15427,12 +15469,13 @@ function warnMissingTsgolint() {
 * @param typeAware - Whether oxlint runs type-aware (oxlint-tsgolint present).
 *   When `false`, tsgolint rules are kept in ESLint so they do not vanish from
 *   both engines.
+* @param mode - The hybrid mode; `native` keeps jsPlugin rules in ESLint.
 */
-function dropOxlintCoveredRules(configs, typeAware = true) {
+function dropOxlintCoveredRules(configs, typeAware = true, mode = "full") {
 	for (let index = 0; index < configs.length; index += 1) {
 		const config = configs[index];
 		if (config?.name === void 0 || !config.name.startsWith("isentinel/") || config.name.endsWith("/markdown-code") || config.rules === void 0 || targetsMarkdown(config.files)) continue;
-		const dropped = dropCoveredRulesFromConfig(config.rules, typeAware);
+		const dropped = dropCoveredRulesFromConfig(config.rules, typeAware, mode);
 		if (Object.keys(dropped).length === 0) continue;
 		if ((config.ignores ?? []).some((pattern) => typeof pattern === "string" && pattern.includes(".md/"))) continue;
 		configs.splice(index + 1, 0, {
@@ -15443,6 +15486,18 @@ function dropOxlintCoveredRules(configs, typeAware = true) {
 		index += 1;
 	}
 }
+/**
+* Whether oxlint owns the rule in the given hybrid mode (and therefore whether
+* ESLint must drop it).
+*
+* @param rule - The canonical ESLint rule name.
+* @param mode - The hybrid mode.
+* @returns Whether oxlint runs the rule.
+*/
+function isOwnedByOxlint(rule, mode) {
+	if (!isOxlintCovered(rule)) return false;
+	return mode === "full" || !isJsPluginRule(rule);
+}
 function isPresetConfig(config) {
 	return config.name?.startsWith("isentinel/") ?? false;
 }
@@ -15462,22 +15517,22 @@ function targetsMarkdown(files) {
 	const patterns = files.flat();
 	return patterns.length > 0 && patterns.every((pattern) => typeof pattern === "string" && pattern.includes(".md"));
 }
-function findDeadMappedRules(configs) {
+function findDeadMappedRules(configs, mode) {
 	const references = [];
 	for (const config of configs) {
 		if (config.rules === void 0 || isPresetConfig(config) || targetsMarkdown(config.files)) continue;
 		const label = describeConfig(config);
-		for (const [rule, value] of Object.entries(config.rules)) if (value !== void 0 && (isOxlintCovered(rule) || HYBRID_FORMATTING_RULES.has(rule))) references.push({
+		for (const [rule, value] of Object.entries(config.rules)) if (value !== void 0 && (isOwnedByOxlint(rule, mode) || mode === "full" && HYBRID_FORMATTING_RULES.has(rule))) references.push({
 			config: label,
 			rule
 		});
 	}
 	return references;
 }
-function dropCoveredRulesFromConfig(rules, typeAware) {
+function dropCoveredRulesFromConfig(rules, typeAware, mode) {
 	const dropped = {};
 	for (const [rule, value] of Object.entries(rules)) {
-		if (value === void 0 || !isOxlintCovered(rule) || !typeAware && isTsgolintRule(rule)) continue;
+		if (value === void 0 || !isOwnedByOxlint(rule, mode) || !typeAware && isTsgolintRule(rule)) continue;
 		const severity = Array.isArray(value) ? value[0] : value;
 		if (severity === "off" || severity === 0) continue;
 		dropped[rule] = value;
@@ -15662,6 +15717,10 @@ async function isentinel(options, ...userConfigs) {
 	const { autoRenamePlugins = true, componentExts: componentExtensions = [], e18e: enableE18e = true, eslintPlugin: enableEslintPlugin = false, formatters, gitignore: enableGitignore = true, jsdoc: enableJsdoc = true, jsonc: enableJsonc = true, jsx: enableJsx = true, markdown: enableMarkdown = true, oxlint: enableOxlint = false, pnpm: enableCatalogs = findUpSync("pnpm-workspace.yaml") !== void 0, react: enableReact = false, root: customRootGlobs, spellCheck: enableSpellCheck, toml: enableToml = true, yaml: enableYaml = true } = options;
 	const rootGlobs = mergeGlobs(GLOB_ROOT, customRootGlobs);
 	const enableRoblox = options.roblox !== false;
+	const oxlintMode = (() => {
+		if (enableOxlint === false) return "off";
+		return enableOxlint === "native" ? "native" : "full";
+	})();
 	const robloxScopedFiles = typeof options.roblox === "object" && options.roblox.files !== void 0 ? options.roblox.files.flat() : void 0;
 	const hasComplement = !enableRoblox || robloxScopedFiles !== void 0;
 	const needsComplementOverlay = enableRoblox && robloxScopedFiles !== void 0;
@@ -15808,33 +15867,33 @@ async function isentinel(options, ...userConfigs) {
 		componentExts: componentExtensions,
 		type: projectType
 	}));
-	if (enableSpellCheck !== false && !typeAwareOnly) {
+	if (enableSpellCheck !== false) {
 		configs.push(spelling({
 			...resolveSubOptions(options, "spellCheck"),
 			componentExts: componentExtensions,
 			isInEditor
 		}));
-		if (stylisticOptions !== false && enableYaml !== false) configs.push(sortCspell());
+		if (stylisticOptions !== false && enableYaml !== false && !typeAwareOnly) configs.push(sortCspell());
 	}
-	writeHybridStatusForCwd(enableOxlint);
-	if (enableOxlint) configs.push([{
+	writeHybridStatusForCwd(oxlintMode !== "off");
+	if (oxlintMode !== "off") configs.push([{
 		name: "isentinel/oxlint-marker",
 		settings: { "isentinel/oxlint": true }
 	}]);
 	configs.push(disables({ root: rootGlobs }));
-	if (stylisticOptions !== false && !typeAwareOnly) configs.push(oxfmt({
+	if (stylisticOptions !== false) configs.push(oxfmt({
 		componentExts: componentExtensions,
-		formatters: formatters !== false ? formatters : {
+		formatters: typeAwareOnly || formatters === false ? {
 			css: false,
 			graphql: false,
 			html: false,
 			json: false,
 			markdown: false,
 			yaml: false
-		},
+		} : formatters,
 		oxfmtConfigOptions,
 		oxfmtOptions: formatterOptions.oxfmtOptions,
-		oxlint: enableOxlint,
+		oxlint: oxlintMode === "full",
 		prettierOptions: prettierSettings
 	}));
 	if ("files" in options) throw new Error("[@isentinel/eslint-config] The first argument should not contain the \"files\" property as the options are supposed to be global. Place it in the second or later config instead.");
@@ -15849,12 +15908,12 @@ async function isentinel(options, ...userConfigs) {
 		return [...previous, GLOB_MARKDOWN];
 	});
 	if (autoRenamePlugins) composer = composer.renamePlugins(defaultPluginRenaming);
-	if (enableOxlint) {
+	if (oxlintMode !== "off") {
 		const tsgolintAvailable = isPackageExists("oxlint-tsgolint");
 		if (!tsgolintAvailable) warnMissingTsgolint();
 		composer = composer.onResolved((resolved) => {
-			if (options.oxlintWarnDeadRules !== false) warnDeadMappedRules(resolved);
-			dropOxlintCoveredRules(resolved, tsgolintAvailable);
+			if (options.oxlintWarnDeadRules !== false) warnDeadMappedRules(resolved, oxlintMode);
+			dropOxlintCoveredRules(resolved, tsgolintAvailable, oxlintMode);
 		});
 	}
 	if (typeAwareMode !== void 0) composer = composer.onResolved((resolved) => {
@@ -15880,4 +15939,4 @@ async function isentinel(options, ...userConfigs) {
 	return composer;
 }
 //#endregion
-export { GLOB_ALL_JSON, GLOB_ALL_SRC, GLOB_BUILD_TOOLS, GLOB_CSS, GLOB_DTS, GLOB_EXCLUDE, GLOB_GRAPHQL, GLOB_HTML, GLOB_JS, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSX, GLOB_LESS, GLOB_LINTABLE_EXTENSIONS, GLOB_LUA, GLOB_MARKDOWN, GLOB_MARKDOWN_BLOCKS, GLOB_MARKDOWN_CODE, GLOB_MARKDOWN_IN_MARKDOWN, GLOB_MISE, GLOB_PACKAGE_JSON, GLOB_PACKAGE_JSON_ROOT, GLOB_POSTCSS, GLOB_ROOT, GLOB_ROOT_SRC, GLOB_SCSS, GLOB_SRC, GLOB_SRC_EXT, GLOB_SRC_EXTENSIONS, GLOB_STYLE, GLOB_TESTS, GLOB_TOML, GLOB_TS, GLOB_TSCONFIG, GLOB_TSX, GLOB_XML, GLOB_YAML, StylisticConfigDefaults, comments, isentinel as default, isentinel, defaultPluginRenaming, disables, e18e, eslintPlugin, flawless, gitignore, ignores, imports, isInAgentSession, isInEditorEnvironment, isInGitHooksOrLintStaged, javascript, jsdoc, jsonc, loadSmallRulesPlugin, markdown, naming, node, oxfmt, packageJson, perfectionist, pnpm, promise, react, roblox, smallRules, sonarjs, sortCspell, sortGithubAction, sortMiseToml, sortPnpmWorkspace, sortRojoProject, sortTsconfig, spelling, stylistic, test, toml, typescript, unicorn, yaml };
+export { GLOB_ALL_JSON, GLOB_ALL_SRC, GLOB_BUILD_TOOLS, GLOB_CSS, GLOB_DTS, GLOB_EXCLUDE, GLOB_GRAPHQL, GLOB_HTML, GLOB_JS, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSX, GLOB_LESS, GLOB_LINTABLE_EXTENSIONS, GLOB_LUA, GLOB_MARKDOWN, GLOB_MARKDOWN_BLOCKS, GLOB_MARKDOWN_CODE, GLOB_MARKDOWN_IN_MARKDOWN, GLOB_MISE, GLOB_PACKAGE_JSON, GLOB_PACKAGE_JSON_ROOT, GLOB_POSTCSS, GLOB_ROOT, GLOB_ROOT_SRC, GLOB_SCSS, GLOB_SRC, GLOB_SRC_EXT, GLOB_SRC_EXTENSIONS, GLOB_STYLE, GLOB_TESTS, GLOB_TOML, GLOB_TS, GLOB_TSCONFIG, GLOB_TSX, GLOB_TYPE_TESTS, GLOB_XML, GLOB_YAML, StylisticConfigDefaults, comments, isentinel as default, isentinel, defaultPluginRenaming, disables, e18e, eslintPlugin, flawless, gitignore, ignores, imports, isInAgentSession, isInEditorEnvironment, isInGitHooksOrLintStaged, javascript, jsdoc, jsonc, loadSmallRulesPlugin, markdown, naming, node, oxfmt, packageJson, perfectionist, pnpm, promise, react, roblox, smallRules, sonarjs, sortCspell, sortGithubAction, sortMiseToml, sortPnpmWorkspace, sortRojoProject, sortTsconfig, spelling, stylistic, test, toml, typescript, unicorn, yaml };

package/dist/lint-cli.mjs

@@ -36,7 +36,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 //#region package.json
-var version = "6.0.0-beta.13";
+var version = "6.0.0-beta.14";
 /**
 * The real TS/JS-family file extensions {@link GLOB_SRC_EXT} encodes (the glob
 * additionally matches non-existent combinations such as `cjsx`). Kept next to
@@ -3228,7 +3228,7 @@ function resolveIgnoredHelper() {
 * The stderr warning emitted when the resolved ESLint config is not hybrid, so
 * running oxlint too would double-lint every mapped rule. Oxlint is dropped.
 */
-const NON_HYBRID_WARNING = "isentinel-lint: the ESLint config does not enable hybrid mode (`oxlint: true`), so oxlint would re-run rules ESLint already checks. Running ESLint only; enable hybrid mode in your config or pass --oxlint to run oxlint explicitly.\n";
+const NON_HYBRID_WARNING = "isentinel-lint: the ESLint config does not enable hybrid mode (`oxlint: true` or `oxlint: \"native\"`), so oxlint would re-run rules ESLint already checks. Running ESLint only; enable hybrid mode in your config or pass --oxlint to run oxlint explicitly.\n";
 /**
 * The stderr warning emitted when the hybrid status cannot be determined (the
 * probe failed). The run fails open: both engines run, as before.

package/dist/oxlint.d.mts

@@ -23955,9 +23955,14 @@ interface OptionsConfig extends OptionsComponentExtensions, OptionsProjectType {
    * Requires installing the optional peer dependencies `oxlint` and
    * `oxlint-tsgolint`.
    *
+   * `"native"` narrows the hand-off to the rules oxlint implements in Rust
+   * (native rules plus the tsgolint type-aware ones): rules that would run in
+   * oxlint as jsPlugins — and formatting — stay in ESLint. Pair it with
+   * `jsPlugins: false` in the oxlint factory, or both engines run them.
+   *
    * @default false
    */
-  oxlint?: boolean;
+  oxlint?: "native" | boolean;
   /**
    * Warn at config-build time when a user config references a rule that
    * oxlint owns in hybrid mode (`oxlint: true`), where the ESLint entry has
@@ -32097,7 +32102,7 @@ type OxlintOptionsConfig = Omit<OptionsConfig, "autoRenamePlugins" | "flawless"
  * Combines oxlint config fields (`env`, `globals`, `rules`, ...) with the
  * shared preset options and the top-level linter `options` object.
  */
-type OxlintFactoryOptions = Omit<TypedOxlintConfigItem, "files"> & OxlintOptionsConfig & {
+type OxlintFactoryOptions = {
   /**
    * Rule categories to enable at the top level.
    *
@@ -32107,6 +32112,21 @@ type OxlintFactoryOptions = Omit<TypedOxlintConfigItem, "files"> & OxlintOptions
    * enabling one category leaves the rest off.
    */
   categories?: RuleCategories$1;
+  /**
+   * Extra jsPlugins to load, or `false` to run oxlint with native rules
+   * only.
+   *
+   * With `false` the factory drops every rule that would run through a
+   * jsPlugin (spelling, the react and jest families, oxfmt formatting, ...),
+   * leaving oxlint with its Rust rules and — when enabled — the tsgolint
+   * type-aware ones. Pair it with `oxlint: "native"` in the ESLint factory,
+   * which keeps exactly those rules in ESLint.
+   *
+   * `oxlint-comments` is the one exception: it lints the `oxlint-disable`
+   * directives that native rules still need, ESLint cannot run it, and its
+   * rules visit each file once, so it stays loaded.
+   */
+  jsPlugins?: false | NonNullable<TypedOxlintConfigItem["jsPlugins"]>;
   /**
    * Top-level linter options emitted into the generated config
    * (`typeAware`, `typeCheck`, `maxWarnings`, ...).
@@ -32124,7 +32144,7 @@ type OxlintFactoryOptions = Omit<TypedOxlintConfigItem, "files"> & OxlintOptions
    * see no effect from this option.
    */
   oxc?: boolean;
-};
+} & Omit<TypedOxlintConfigItem, "files" | "jsPlugins"> & OxlintOptionsConfig;
 //#endregion
 //#region src/oxlint/factory.d.ts
 /**
@@ -32144,4 +32164,14 @@ type OxlintFactoryOptions = Omit<TypedOxlintConfigItem, "files"> & OxlintOptions
  */
 declare function isentinel<const O extends OxlintFactoryOptions>(factoryOptions?: O & ValidateOxlintOptions<O>, ...userConfigs: Array<TypedOxlintConfigItem>): OxlintConfig$1;
 //#endregion
-export { type DummyRuleMap, type ExternalPluginEntry, type OxlintConfig, OxlintFactoryOptions, OxlintLinterOptions, OxlintNativeRuleName, type OxlintNativeRuleOptions, OxlintOptionsConfig, type OxlintOverride, OxlintPlugin, type OxlintRenamedJsPluginRuleOptions, type OxlintRuleOptions, type OxlintRules, OxlintSettings, type OxlintTarget, type RuleCategories, TypedOxlintConfigItem, isentinel as default, isentinel, isOxlintCovered, oxlintJsPlugins, oxlintRuleMapping, staysInEslint, translateRuleToOxlint };
+//#region src/oxlint/utils.d.ts
+/**
+ * Resolve a jsPlugin specifier, throwing when the package is not installed.
+ *
+ * @param specifier - The plugin package specifier.
+ * @returns The absolute `file://` specifier.
+ * @throws {Error} When the package cannot be resolved.
+ */
+declare function resolveJsPluginSpecifier(specifier: string): string;
+//#endregion
+export { type DummyRuleMap, type ExternalPluginEntry, type OxlintConfig, OxlintFactoryOptions, OxlintLinterOptions, OxlintNativeRuleName, type OxlintNativeRuleOptions, OxlintOptionsConfig, type OxlintOverride, OxlintPlugin, type OxlintRenamedJsPluginRuleOptions, type OxlintRuleOptions, type OxlintRules, OxlintSettings, type OxlintTarget, type RuleCategories, TypedOxlintConfigItem, isentinel as default, isentinel, isOxlintCovered, oxlintJsPlugins, oxlintRuleMapping, resolveJsPluginSpecifier, staysInEslint, translateRuleToOxlint };

package/dist/oxlint.mjs

@@ -978,10 +978,16 @@ const GLOB_SRC = "**/*.{,c,m}[jt]s{,x}";
 const GLOB_JSX = "**/*.{,c,m}jsx";
 const GLOB_TSX = "**/*.{,c,m}tsx";
 const GLOB_DTS = "**/*.d.{,c,m}ts";
+/**
+* Type tests (`expectTypeOf` / `assertType`), run by Vitest's `typecheck`
+* mode. They are test files, but assert nothing at runtime.
+*/
+const GLOB_TYPE_TESTS = `**/*.test-d.${GLOB_SRC_EXT}`;
 const GLOB_TESTS = [
 	`**/__tests__/**/*.${GLOB_SRC_EXT}`,
 	`**/*.spec.${GLOB_SRC_EXT}`,
 	`**/*.test.${GLOB_SRC_EXT}`,
+	GLOB_TYPE_TESTS,
 	`**/*.bench.${GLOB_SRC_EXT}`,
 	`**/*.benchmark.${GLOB_SRC_EXT}`
 ];
@@ -1711,6 +1717,38 @@ function resolveJsPluginSpecifier(specifier) {
 	return resolved;
 }
 /**
+* The dedupe key for a jsPlugin entry (a bare specifier, or a named entry).
+*
+* @param entry - A bare package specifier, or a `{ name, specifier }` entry.
+* @returns The plugin name used to deduplicate registrations.
+*/
+function jsPluginKey(entry) {
+	return typeof entry === "string" ? entry : entry.name;
+}
+/**
+* Drop every rule whose plugin prefix is not registered on the generated
+* config, mutating the overrides in place. Oxlint fails the whole config build
+* on a rule naming an unknown plugin, so entries left behind by a plugin that
+* native-only mode dropped have to go rather than sit inert.
+*
+* Keyed on what is actually registered, so a consumer's own jsPlugin keeps its
+* rules while a preset plugin that is no longer loaded loses them. Unprefixed
+* (core) rules are always kept.
+*
+* @param overrides - The merged overrides (mutated).
+* @param registeredPlugins - Every native plugin and jsPlugin name registered.
+*/
+function stripUnregisteredPluginRules(overrides, registeredPlugins) {
+	for (const override of overrides) {
+		const { rules } = override;
+		if (rules === void 0) continue;
+		for (const rule of Object.keys(rules)) {
+			const slashIndex = rule.indexOf("/");
+			if (slashIndex !== -1 && !registeredPlugins.has(rule.slice(0, slashIndex))) delete rules[rule];
+		}
+	}
+}
+/**
 * Split a canonical (ESLint-named) rule map into oxlint-native rules and
 * jsPlugin rules, translating rule names via the oxlint rule mapping.
 *
@@ -3469,6 +3507,21 @@ function oxlintStylistic(options = {}) {
 //#endregion
 //#region src/rules/test.ts
 /**
+* Rules that make no sense in a type test (`*.test-d.ts`): these files assert
+* with `expectTypeOf`/`assertType` at compile time, run no expectations, and
+* name their blocks after the types under test.
+*
+* @param prefix - The test-plugin prefix in use (`jest` or `vitest`).
+* @returns The rule map.
+*/
+function typeTestRules(prefix) {
+	return {
+		[`${prefix}/expect-expect`]: "off",
+		[`${prefix}/prefer-expect-assertions`]: "off",
+		[`${prefix}/prefer-lowercase-title`]: "off"
+	};
+}
+/**
 * Jest-extended rules shared between the ESLint and oxlint factories.
 *
 * @returns The rule map.
@@ -3690,6 +3743,11 @@ function oxlintTest({ files = GLOB_TESTS, isInEditor = false, jest = false, over
 			globalPackage: "@rbxts/jest-globals",
 			version: 27
 		} }
+	}), ...createOxlintConfigs({
+		name: "isentinel/test/jest/type-tests",
+		files: [GLOB_TYPE_TESTS],
+		keepUnmappedOff: true,
+		rules: typeTestRules("jest")
 	}));
 	if (enableVitest) configs.push(...createOxlintConfigs({
 		name: "isentinel/test/vitest",
@@ -3705,6 +3763,11 @@ function oxlintTest({ files = GLOB_TESTS, isInEditor = false, jest = false, over
 			...vitestOptions.overrides
 		},
 		settings: { vitest: { typecheck: vitestOptions.typecheck ?? false } }
+	}), ...createOxlintConfigs({
+		name: "isentinel/test/vitest/type-tests",
+		files: [GLOB_TYPE_TESTS],
+		keepUnmappedOff: true,
+		rules: typeTestRules("vitest")
 	}));
 	return configs;
 }
@@ -4186,6 +4249,16 @@ const DEFAULT_CATEGORIES = {
 	suspicious: "off"
 };
 /**
+* JsPlugins the preset keeps even under `jsPlugins: false`.
+*
+* `oxlint-comments` lints the `oxlint-disable` directives that native rules
+* still need, and the ESLint side cannot take it over: its rules use oxlint's
+* `createOnce` API, which ESLint rejects. Its rules visit `Program` once per
+* file, so the cost is negligible next to the jsPlugin rule set that native-only
+* mode exists to avoid.
+*/
+const NATIVE_ONLY_JS_PLUGINS = /* @__PURE__ */ new Set(["oxlint-comments"]);
+/**
 * Implementation signature; the public overload above carries the
 * redundant-override validation generics.
 *
@@ -4196,9 +4269,10 @@ const DEFAULT_CATEGORIES = {
 */
 function isentinel(factoryOptions, ...userConfigs) {
 	const options = factoryOptions ?? { name: "isentinel" };
-	const { categories, componentExts: componentExtensions = [], e18e: enableE18e = true, env, eslintPlugin: enableEslintPlugin = false, formatters, gitignore: enableGitignore = true, globals, ignores, jsdoc: enableJsdoc = true, jsx: enableJsx = true, options: linterOptions, oxc: enableOxc = true, react: enableReact = false, root: customRootGlobs, rules = {}, spellCheck: enableSpellCheck, test: enableTest = false } = options;
+	const { categories, componentExts: componentExtensions = [], e18e: enableE18e = true, env, eslintPlugin: enableEslintPlugin = false, formatters, gitignore: enableGitignore = true, globals, ignores, jsdoc: enableJsdoc = true, jsPlugins: userJsPlugins, jsx: enableJsx = true, options: linterOptions, oxc: enableOxc = true, react: enableReact = false, root: customRootGlobs, rules = {}, spellCheck: enableSpellCheck, test: enableTest = false } = options;
 	const rootGlobs = mergeGlobs(GLOB_ROOT, customRootGlobs);
 	const enableRoblox = options.roblox !== false;
+	const nativeOnly = userJsPlugins === false;
 	const robloxScopedFiles = typeof options.roblox === "object" && options.roblox.files !== void 0 ? options.roblox.files.flat() : void 0;
 	const hasComplement = !enableRoblox || robloxScopedFiles !== void 0;
 	const needsComplementOverlay = enableRoblox && robloxScopedFiles !== void 0;
@@ -4344,20 +4418,27 @@ function isentinel(factoryOptions, ...userConfigs) {
 		...gitignorePatterns,
 		...ignores ?? []
 	];
+	/**
+	* Merge a fragment into the accumulated overrides.
+	*
+	* @param config - The fragment to merge.
+	*/
 	function mergeFragment(config) {
+		const fragmentJsPlugins = config.jsPlugins ?? [];
 		const fragmentPlugins = config.plugins ?? [];
 		for (const plugin of fragmentPlugins) nativePlugins.add(plugin);
-		const fragmentJsPlugins = config.jsPlugins ?? [];
-		for (const jsPlugin of fragmentJsPlugins) {
-			const key = typeof jsPlugin === "string" ? jsPlugin : jsPlugin.name;
-			jsPlugins.set(key, jsPlugin);
-		}
+		for (const jsPlugin of fragmentJsPlugins) jsPlugins.set(jsPluginKey(jsPlugin), jsPlugin);
 		if (config.settings) Object.assign(mergedSettings, config.settings);
 		const { name: _name, plugins: _plugins, settings: _settings, ...override } = config;
 		overrides.push(override);
 	}
-	const fragments = configs.flat();
-	for (const fragment of fragments) mergeFragment(fragment);
+	for (const fragment of configs.flat()) {
+		if (nativeOnly && droppedByNativeOnly(fragment)) {
+			if (fragment.settings) Object.assign(mergedSettings, fragment.settings);
+			continue;
+		}
+		mergeFragment(fragment);
+	}
 	if (Object.keys(rules).length > 0) {
 		const optionsFragments = createOxlintConfigs({
 			name: "isentinel/options-rules",
@@ -4365,7 +4446,10 @@ function isentinel(factoryOptions, ...userConfigs) {
 			keepUnmappedOff: true,
 			rules
 		});
-		for (const fragment of optionsFragments) mergeFragment(fragment);
+		for (const fragment of optionsFragments) {
+			const { jsPlugins: _fragmentJsPlugins, ...withoutJsPlugins } = fragment;
+			mergeFragment(nativeOnly ? withoutJsPlugins : fragment);
+		}
 	}
 	if (globals && Object.keys(globals).length > 0) mergeFragment({
 		name: "isentinel/options-globals",
@@ -4373,6 +4457,8 @@ function isentinel(factoryOptions, ...userConfigs) {
 		globals
 	});
 	for (const userConfig of userConfigs) mergeFragment(userConfig);
+	if (Array.isArray(userJsPlugins)) for (const jsPlugin of userJsPlugins) jsPlugins.set(jsPluginKey(jsPlugin), jsPlugin);
+	if (nativeOnly) stripUnregisteredPluginRules(overrides, /* @__PURE__ */ new Set([...nativePlugins, ...jsPlugins.keys()]));
 	if (defaultSeverity) {
 		const severityExcludeRules = /* @__PURE__ */ new Set(["sonar/todo-tag"]);
 		for (const override of overrides) if (override.rules) override.rules = overrideRuleSeverity(override.rules, defaultSeverity, severityExcludeRules);
@@ -4395,5 +4481,16 @@ function isentinel(factoryOptions, ...userConfigs) {
 		settings: mergedSettings
 	});
 }
+/**
+* Whether native-only mode drops a preset fragment: it needs a jsPlugin, and at
+* least one of them is not kept in that mode.
+*
+* @param fragment - The preset fragment.
+* @returns Whether the fragment is dropped.
+*/
+function droppedByNativeOnly(fragment) {
+	const fragmentJsPlugins = fragment.jsPlugins ?? [];
+	return fragmentJsPlugins.length > 0 && fragmentJsPlugins.some((entry) => !NATIVE_ONLY_JS_PLUGINS.has(jsPluginKey(entry)));
+}
 //#endregion
-export { isentinel as default, isentinel, isOxlintCovered, oxlintJsPlugins, oxlintRuleMapping, staysInEslint, translateRuleToOxlint };
+export { isentinel as default, isentinel, isOxlintCovered, oxlintJsPlugins, oxlintRuleMapping, resolveJsPluginSpecifier, staysInEslint, translateRuleToOxlint };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isentinel/eslint-config",
-  "version": "6.0.0-beta.13",
+  "version": "6.0.0-beta.14",
   "description": "iSentinel's ESLint config",
   "keywords": [
     "eslint-config",
@@ -138,7 +138,7 @@
     "typescript": "6.0.3",
     "unplugin-unused": "0.5.7",
     "vitest": "4.1.10",
-    "@isentinel/eslint-config": "6.0.0-beta.13"
+    "@isentinel/eslint-config": "6.0.0-beta.14"
   },
   "peerDependencies": {
     "@vitest/eslint-plugin": "^1.6.4",