@jsse/eslint-config 0.9.2 → 0.9.3

package/dist/index.js

@@ -2,7 +2,6 @@ import { n as __exportAll, r as __toESM, t as __commonJSMin } from "./rolldown-r
 import { t as FIXABLE_RULES_MAP } from "./fixable-rules-map-dNndx2ig.js";
 import { builtinModules, createRequire } from "node:module";
 import process$1 from "node:process";
-import Debug from "debug";
 import pluginE18e from "@e18e/eslint-plugin";
 import pluginEslintComments from "@eslint-community/eslint-plugin-eslint-comments";
 import pluginTs from "@typescript-eslint/eslint-plugin";
@@ -10,6 +9,7 @@ import * as parserTs from "@typescript-eslint/parser";
 import pluginAntfu from "eslint-plugin-antfu";
 import pluginDeMorgan from "eslint-plugin-de-morgan";
 import pluginImportLite from "eslint-plugin-import-lite";
+import pluginJsdoc from "eslint-plugin-jsdoc";
 import pluginN from "eslint-plugin-n";
 import pluginPerfectionist from "eslint-plugin-perfectionist";
 import pluginPnpm from "eslint-plugin-pnpm";
@@ -18,6 +18,17 @@ import pluginUnicorn from "eslint-plugin-unicorn";
 import pluginUnusedImports from "eslint-plugin-unused-imports";
 import createCommand from "eslint-plugin-command/config";
 import eslintjs from "@eslint/js";
+import "@eslint-react/eslint-plugin";
+import "@eslint/markdown";
+import "@stylistic/eslint-plugin";
+import "@vitest/eslint-plugin";
+import "eslint-node-test";
+import "eslint-plugin-jsonc";
+import "eslint-plugin-no-only-tests";
+import "eslint-plugin-react-hooks";
+import "eslint-plugin-react-refresh";
+import "jsonc-eslint-parser";
+import Debug from "debug";
 import { mergeProcessors, processorPassThrough } from "eslint-merge-processors";
 import tseslint from "typescript-eslint";
 import fs, { realpathSync, statSync } from "node:fs";
@@ -28,7 +39,7 @@ import assert from "node:assert";
 import v8 from "node:v8";
 import { format, inspect } from "node:util";
 //#region src/_generated/version.ts
-const VERSION = "0.9.2";
+const VERSION = "0.9.3";
 //#endregion
 //#region src/globs.ts
 var globs_exports = /* @__PURE__ */ __exportAll({
@@ -139,232 +150,6 @@ const GLOB_EXCLUDE = [
 	"**/yarn.lock"
 ];
 //#endregion
-//#region src/lager.ts
-var import_picocolors = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
-	let p = process || {}, argv = p.argv || [], env = p.env || {};
-	let isColorSupported = !(!!env.NO_COLOR || argv.includes("--no-color")) && (!!env.FORCE_COLOR || argv.includes("--color") || p.platform === "win32" || (p.stdout || {}).isTTY && env.TERM !== "dumb" || !!env.CI);
-	let formatter = (open, close, replace = open) => (input) => {
-		let string = "" + input, index = string.indexOf(close, open.length);
-		return ~index ? open + replaceClose(string, close, replace, index) + close : open + string + close;
-	};
-	let replaceClose = (string, close, replace, index) => {
-		let result = "", cursor = 0;
-		do {
-			result += string.substring(cursor, index) + replace;
-			cursor = index + close.length;
-			index = string.indexOf(close, cursor);
-		} while (~index);
-		return result + string.substring(cursor);
-	};
-	let createColors = (enabled = isColorSupported) => {
-		let f = enabled ? formatter : () => String;
-		return {
-			isColorSupported: enabled,
-			reset: f("\x1B[0m", "\x1B[0m"),
-			bold: f("\x1B[1m", "\x1B[22m", "\x1B[22m\x1B[1m"),
-			dim: f("\x1B[2m", "\x1B[22m", "\x1B[22m\x1B[2m"),
-			italic: f("\x1B[3m", "\x1B[23m"),
-			underline: f("\x1B[4m", "\x1B[24m"),
-			inverse: f("\x1B[7m", "\x1B[27m"),
-			hidden: f("\x1B[8m", "\x1B[28m"),
-			strikethrough: f("\x1B[9m", "\x1B[29m"),
-			black: f("\x1B[30m", "\x1B[39m"),
-			red: f("\x1B[31m", "\x1B[39m"),
-			green: f("\x1B[32m", "\x1B[39m"),
-			yellow: f("\x1B[33m", "\x1B[39m"),
-			blue: f("\x1B[34m", "\x1B[39m"),
-			magenta: f("\x1B[35m", "\x1B[39m"),
-			cyan: f("\x1B[36m", "\x1B[39m"),
-			white: f("\x1B[37m", "\x1B[39m"),
-			gray: f("\x1B[90m", "\x1B[39m"),
-			bgBlack: f("\x1B[40m", "\x1B[49m"),
-			bgRed: f("\x1B[41m", "\x1B[49m"),
-			bgGreen: f("\x1B[42m", "\x1B[49m"),
-			bgYellow: f("\x1B[43m", "\x1B[49m"),
-			bgBlue: f("\x1B[44m", "\x1B[49m"),
-			bgMagenta: f("\x1B[45m", "\x1B[49m"),
-			bgCyan: f("\x1B[46m", "\x1B[49m"),
-			bgWhite: f("\x1B[47m", "\x1B[49m"),
-			blackBright: f("\x1B[90m", "\x1B[39m"),
-			redBright: f("\x1B[91m", "\x1B[39m"),
-			greenBright: f("\x1B[92m", "\x1B[39m"),
-			yellowBright: f("\x1B[93m", "\x1B[39m"),
-			blueBright: f("\x1B[94m", "\x1B[39m"),
-			magentaBright: f("\x1B[95m", "\x1B[39m"),
-			cyanBright: f("\x1B[96m", "\x1B[39m"),
-			whiteBright: f("\x1B[97m", "\x1B[39m"),
-			bgBlackBright: f("\x1B[100m", "\x1B[49m"),
-			bgRedBright: f("\x1B[101m", "\x1B[49m"),
-			bgGreenBright: f("\x1B[102m", "\x1B[49m"),
-			bgYellowBright: f("\x1B[103m", "\x1B[49m"),
-			bgBlueBright: f("\x1B[104m", "\x1B[49m"),
-			bgMagentaBright: f("\x1B[105m", "\x1B[49m"),
-			bgCyanBright: f("\x1B[106m", "\x1B[49m"),
-			bgWhiteBright: f("\x1B[107m", "\x1B[49m")
-		};
-	};
-	module.exports = createColors();
-	module.exports.createColors = createColors;
-})))(), 1);
-const dbg = Debug("jsse:eslint-config");
-const WARN_LABEL = import_picocolors.default.yellow("[[@jsse/eslint-config::WARN]]");
-function enableDbg() {
-	const currentNamespaces = Debug.namespaces;
-	const current = typeof currentNamespaces === "string" ? currentNamespaces : void 0;
-	Debug.enable([current, "jsse:eslint-config"].filter((ns) => ns !== void 0).join(","));
-	dbg("Debugging enabled for @jsse/eslint-config");
-}
-const warn = (...args) => {
-	const msg = args.map((arg) => {
-		if (typeof arg === "string") return arg;
-		if (arg instanceof Error) return arg.message;
-		try {
-			return JSON.stringify(arg, void 0, 2);
-		} catch (_e) {
-			return String(arg);
-		}
-	}).join(" ");
-	console.warn(`${WARN_LABEL} ${msg}`);
-};
-//#endregion
-//#region src/utils.ts
-function isPromiseLike(value) {
-	return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
-}
-function flattenConfigs(configs) {
-	return configs.flatMap((config) => Array.isArray(config) ? config : [config]);
-}
-async function resolveAndFlattenConfigs(configs) {
-	return flattenConfigs(await Promise.all(configs.map((config) => Promise.resolve(config))));
-}
-/**
-* Combine array and non-array configs into a single array.
-* @param configs configs to combine and flatten
-* @returns combined configs as a flattened array
-*/
-function combineAsync(...configs) {
-	if (configs.every((config) => !isPromiseLike(config))) return flattenConfigs(configs);
-	return resolveAndFlattenConfigs(configs);
-}
-function renameRules(rules, from, to) {
-	if (from === to) return rules;
-	return Object.fromEntries(Object.entries(rules).map(([key, value]) => {
-		if (key.startsWith(from)) return [to + key.slice(from.length), value];
-		return [key, value];
-	}));
-}
-async function interopDefault(m) {
-	const resolved = await m;
-	return resolved.default || resolved;
-}
-function isCI() {
-	return !!process$1.env.CI;
-}
-function isInEditor() {
-	return !!((process$1.env.VSCODE_PID || process$1.env.JETBRAINS_IDE) && !isCI());
-}
-/**
-* Make an array of strings unique maintaining order.
-* @param strings strings to make unique
-* @returns unique strings
-*/
-function uniqueStrings(...strings) {
-	const set = /* @__PURE__ */ new Set();
-	for (const item of strings) if (typeof item === "string") set.add(item);
-	else for (const str of item) set.add(str);
-	return [...set];
-}
-function matchesRulePrefix(ruleName, rulePrefixes) {
-	return rulePrefixes.some((prefix) => ruleName.startsWith(`${prefix}/`));
-}
-function scopeTypeScriptRules(configs, options) {
-	dbg("scoping rules with prefixes %O to files: %O", options.rulePrefixes, options.files);
-	const { files, rulePrefixes } = options;
-	const normalizedPrefixes = uniqueStrings(rulePrefixes).filter(Boolean);
-	if (normalizedPrefixes.length === 0) return configs;
-	const cfgs = configs.flatMap((config) => {
-		if (config.files || config.rules === void 0) return [config];
-		const entries = Object.entries(config.rules);
-		const tsRuleEntries = entries.filter(([ruleName]) => matchesRulePrefix(ruleName, normalizedPrefixes));
-		if (tsRuleEntries.length === 0) return [config];
-		if (tsRuleEntries.length === entries.length) return [{
-			...config,
-			files
-		}];
-		const nonTsRuleEntries = entries.filter(([ruleName]) => !matchesRulePrefix(ruleName, normalizedPrefixes));
-		return [{
-			...config,
-			rules: Object.fromEntries(nonTsRuleEntries)
-		}, {
-			...config,
-			files,
-			name: config.name ? `${config.name}/typescript` : void 0,
-			rules: Object.fromEntries(tsRuleEntries)
-		}];
-	});
-	dbg("scoped rules with prefixes %O to files: %O", normalizedPrefixes, files);
-	return cfgs;
-}
-const parserPlain = {
-	meta: { name: "parser-plain" },
-	parseForESLint: (code) => ({
-		ast: {
-			body: [],
-			comments: [],
-			loc: {
-				end: code.length,
-				start: 0
-			},
-			range: [0, code.length],
-			tokens: [],
-			type: "Program"
-		},
-		scopeManager: void 0,
-		services: { isPlain: true },
-		visitorKeys: { Program: [] }
-	})
-};
-function turnOffRules(configs, off, debug) {
-	if (off.length > 0) {
-		dbg("turning off rules: %O", off);
-		const currentlyActiveRules = /* @__PURE__ */ new Set();
-		for (const config of configs) {
-			const cfgRules = Object.keys(config.rules ?? {});
-			for (const rule of cfgRules) currentlyActiveRules.add(rule);
-		}
-		for (const rule of off) {
-			if (currentlyActiveRules.has(rule)) continue;
-			const msg = `Rule \`${rule}\` is not active in the current config, you can remove it from the off list`;
-			dbg(msg);
-			if (debug) warn(msg);
-		}
-		for (const config of configs) {
-			const cfgRules = config.rules;
-			if (cfgRules) {
-				for (const rule of off) if (cfgRules[rule] !== void 0 && cfgRules[rule] !== "off" && cfgRules[rule] !== 0) cfgRules[rule] = "off";
-			}
-		}
-		dbg("finished turning off rules");
-	}
-	return configs;
-}
-const TYPESCRIPT_ESLINT_PREFIX = "@typescript-eslint/";
-function replaceTypescriptEslintPrefixInplace(items, tsPrefix) {
-	for (const [key, value] of Object.entries(items)) {
-		if (!key.startsWith(TYPESCRIPT_ESLINT_PREFIX)) continue;
-		delete items[key];
-		items[`${tsPrefix}/${key.slice(19)}`] = value;
-	}
-}
-//#endregion
-//#region src/plugins.ts
-async function importPluginMarkdown() {
-	return { pluginMarkdown: await interopDefault(import("@eslint/markdown")) };
-}
-async function importPluginStylistic() {
-	return { pluginStylistic: await interopDefault(import("@stylistic/eslint-plugin")) };
-}
-//#endregion
 //#region src/configs/antfu.ts
 const antfu = (options) => {
 	return [{
@@ -4763,79 +4548,295 @@ function javascriptSelectedRules() {
 		yoda: ["error", "never"]
 	};
 }
-const javascript = (options) => {
-	const { isInEditor = false, overrides = {}, reportUnusedDisableDirectives = true } = options ?? {};
-	return [{
-		files: GLOB_CODE,
-		languageOptions: {
-			ecmaVersion: 2022,
-			globals: {
-				...import_globals.default.browser,
-				...import_globals.default.es2021,
-				...import_globals.default.node,
-				document: "readonly",
-				navigator: "readonly",
-				window: "readonly"
-			},
-			parserOptions: {
-				ecmaFeatures: { jsx: true },
-				ecmaVersion: 2022,
-				sourceType: "module"
+const javascript = (options) => {
+	const { overrides = {}, reportUnusedDisableDirectives = true } = options ?? {};
+	return [{
+		files: GLOB_CODE,
+		languageOptions: {
+			ecmaVersion: 2022,
+			globals: {
+				...import_globals.default.browser,
+				...import_globals.default.es2021,
+				...import_globals.default.node,
+				document: "readonly",
+				navigator: "readonly",
+				window: "readonly"
+			},
+			parserOptions: {
+				ecmaFeatures: { jsx: true },
+				ecmaVersion: 2022,
+				sourceType: "module"
+			},
+			sourceType: "module"
+		},
+		linterOptions: { reportUnusedDisableDirectives },
+		name: "jsse/javascript",
+		rules: {
+			...eslintjs.configs.recommended.rules,
+			...javascriptSelectedRules(),
+			...overrides
+		}
+	}, {
+		files: [`scripts/${GLOB_JS}`, `cli.${GLOB_JS_SRC_EXT}`],
+		name: "jsse/scripts-overrides",
+		rules: { "no-console": "off" }
+	}];
+};
+//#endregion
+//#region src/configs/jsdoc.ts
+const jsdoc = (options) => {
+	return [{
+		files: GLOB_CODE,
+		name: "jsse/jsdoc",
+		plugins: { jsdoc: pluginJsdoc },
+		rules: {
+			"jsdoc/check-access": "warn",
+			"jsdoc/check-alignment": "warn",
+			"jsdoc/check-param-names": "warn",
+			"jsdoc/check-property-names": "warn",
+			"jsdoc/check-types": "warn",
+			"jsdoc/empty-tags": "warn",
+			"jsdoc/implements-on-classes": "warn",
+			"jsdoc/multiline-blocks": "warn",
+			"jsdoc/no-defaults": "warn",
+			"jsdoc/no-multi-asterisks": "warn",
+			"jsdoc/require-param-name": "warn",
+			"jsdoc/require-property": "warn",
+			"jsdoc/require-property-description": "warn",
+			"jsdoc/require-property-name": "warn",
+			"jsdoc/require-returns-check": "warn",
+			"jsdoc/require-returns-description": "warn",
+			"jsdoc/require-yields-check": "warn",
+			"jsdoc/tag-lines": [
+				"warn",
+				"any",
+				{
+					endLines: 0,
+					startLines: null
+				}
+			],
+			...options?.overrides
+		}
+	}];
+};
+//#endregion
+//#region src/lager.ts
+var import_picocolors = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
+	let p = process || {}, argv = p.argv || [], env = p.env || {};
+	let isColorSupported = !(!!env.NO_COLOR || argv.includes("--no-color")) && (!!env.FORCE_COLOR || argv.includes("--color") || p.platform === "win32" || (p.stdout || {}).isTTY && env.TERM !== "dumb" || !!env.CI);
+	let formatter = (open, close, replace = open) => (input) => {
+		let string = "" + input, index = string.indexOf(close, open.length);
+		return ~index ? open + replaceClose(string, close, replace, index) + close : open + string + close;
+	};
+	let replaceClose = (string, close, replace, index) => {
+		let result = "", cursor = 0;
+		do {
+			result += string.substring(cursor, index) + replace;
+			cursor = index + close.length;
+			index = string.indexOf(close, cursor);
+		} while (~index);
+		return result + string.substring(cursor);
+	};
+	let createColors = (enabled = isColorSupported) => {
+		let f = enabled ? formatter : () => String;
+		return {
+			isColorSupported: enabled,
+			reset: f("\x1B[0m", "\x1B[0m"),
+			bold: f("\x1B[1m", "\x1B[22m", "\x1B[22m\x1B[1m"),
+			dim: f("\x1B[2m", "\x1B[22m", "\x1B[22m\x1B[2m"),
+			italic: f("\x1B[3m", "\x1B[23m"),
+			underline: f("\x1B[4m", "\x1B[24m"),
+			inverse: f("\x1B[7m", "\x1B[27m"),
+			hidden: f("\x1B[8m", "\x1B[28m"),
+			strikethrough: f("\x1B[9m", "\x1B[29m"),
+			black: f("\x1B[30m", "\x1B[39m"),
+			red: f("\x1B[31m", "\x1B[39m"),
+			green: f("\x1B[32m", "\x1B[39m"),
+			yellow: f("\x1B[33m", "\x1B[39m"),
+			blue: f("\x1B[34m", "\x1B[39m"),
+			magenta: f("\x1B[35m", "\x1B[39m"),
+			cyan: f("\x1B[36m", "\x1B[39m"),
+			white: f("\x1B[37m", "\x1B[39m"),
+			gray: f("\x1B[90m", "\x1B[39m"),
+			bgBlack: f("\x1B[40m", "\x1B[49m"),
+			bgRed: f("\x1B[41m", "\x1B[49m"),
+			bgGreen: f("\x1B[42m", "\x1B[49m"),
+			bgYellow: f("\x1B[43m", "\x1B[49m"),
+			bgBlue: f("\x1B[44m", "\x1B[49m"),
+			bgMagenta: f("\x1B[45m", "\x1B[49m"),
+			bgCyan: f("\x1B[46m", "\x1B[49m"),
+			bgWhite: f("\x1B[47m", "\x1B[49m"),
+			blackBright: f("\x1B[90m", "\x1B[39m"),
+			redBright: f("\x1B[91m", "\x1B[39m"),
+			greenBright: f("\x1B[92m", "\x1B[39m"),
+			yellowBright: f("\x1B[93m", "\x1B[39m"),
+			blueBright: f("\x1B[94m", "\x1B[39m"),
+			magentaBright: f("\x1B[95m", "\x1B[39m"),
+			cyanBright: f("\x1B[96m", "\x1B[39m"),
+			whiteBright: f("\x1B[97m", "\x1B[39m"),
+			bgBlackBright: f("\x1B[100m", "\x1B[49m"),
+			bgRedBright: f("\x1B[101m", "\x1B[49m"),
+			bgGreenBright: f("\x1B[102m", "\x1B[49m"),
+			bgYellowBright: f("\x1B[103m", "\x1B[49m"),
+			bgBlueBright: f("\x1B[104m", "\x1B[49m"),
+			bgMagentaBright: f("\x1B[105m", "\x1B[49m"),
+			bgCyanBright: f("\x1B[106m", "\x1B[49m"),
+			bgWhiteBright: f("\x1B[107m", "\x1B[49m")
+		};
+	};
+	module.exports = createColors();
+	module.exports.createColors = createColors;
+})))(), 1);
+const dbg = Debug("jsse:eslint-config");
+const WARN_LABEL = import_picocolors.default.yellow("[[@jsse/eslint-config::WARN]]");
+function enableDbg() {
+	const currentNamespaces = Debug.namespaces;
+	const current = typeof currentNamespaces === "string" ? currentNamespaces : void 0;
+	Debug.enable([current, "jsse:eslint-config"].filter((ns) => ns !== void 0).join(","));
+	dbg("Debugging enabled for @jsse/eslint-config");
+}
+const warn = (...args) => {
+	const msg = args.map((arg) => {
+		if (typeof arg === "string") return arg;
+		if (arg instanceof Error) return arg.message;
+		try {
+			return JSON.stringify(arg, void 0, 2);
+		} catch (_e) {
+			return String(arg);
+		}
+	}).join(" ");
+	console.warn(`${WARN_LABEL} ${msg}`);
+};
+//#endregion
+//#region src/utils.ts
+function isPromiseLike(value) {
+	return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
+}
+function flattenConfigs(configs) {
+	return configs.flatMap((config) => Array.isArray(config) ? config : [config]);
+}
+async function resolveAndFlattenConfigs(configs) {
+	return flattenConfigs(await Promise.all(configs.map((config) => Promise.resolve(config))));
+}
+/**
+* Combine array and non-array configs into a single array.
+* @param configs configs to combine and flatten
+* @returns combined configs as a flattened array
+*/
+function combineAsync(...configs) {
+	if (configs.every((config) => !isPromiseLike(config))) return flattenConfigs(configs);
+	return resolveAndFlattenConfigs(configs);
+}
+function renameRules(rules, from, to) {
+	if (from === to) return rules;
+	return Object.fromEntries(Object.entries(rules).map(([key, value]) => {
+		if (key.startsWith(from)) return [to + key.slice(from.length), value];
+		return [key, value];
+	}));
+}
+async function interopDefault(m) {
+	const resolved = await m;
+	return resolved.default || resolved;
+}
+function isCI() {
+	return !!process$1.env.CI;
+}
+function isInEditor() {
+	return !!((process$1.env.VSCODE_PID || process$1.env.JETBRAINS_IDE) && !isCI());
+}
+/**
+* Make an array of strings unique maintaining order.
+* @param strings strings to make unique
+* @returns unique strings
+*/
+function uniqueStrings(...strings) {
+	const set = /* @__PURE__ */ new Set();
+	for (const item of strings) if (typeof item === "string") set.add(item);
+	else for (const str of item) set.add(str);
+	return [...set];
+}
+function matchesRulePrefix(ruleName, rulePrefixes) {
+	return rulePrefixes.some((prefix) => ruleName.startsWith(`${prefix}/`));
+}
+function scopeTypeScriptRules(configs, options) {
+	dbg("scoping rules with prefixes %O to files: %O", options.rulePrefixes, options.files);
+	const { files, rulePrefixes } = options;
+	const normalizedPrefixes = uniqueStrings(rulePrefixes).filter(Boolean);
+	if (normalizedPrefixes.length === 0) return configs;
+	const cfgs = configs.flatMap((config) => {
+		if (config.files || config.rules === void 0) return [config];
+		const entries = Object.entries(config.rules);
+		const tsRuleEntries = entries.filter(([ruleName]) => matchesRulePrefix(ruleName, normalizedPrefixes));
+		if (tsRuleEntries.length === 0) return [config];
+		if (tsRuleEntries.length === entries.length) return [{
+			...config,
+			files
+		}];
+		const nonTsRuleEntries = entries.filter(([ruleName]) => !matchesRulePrefix(ruleName, normalizedPrefixes));
+		return [{
+			...config,
+			rules: Object.fromEntries(nonTsRuleEntries)
+		}, {
+			...config,
+			files,
+			name: config.name ? `${config.name}/typescript` : void 0,
+			rules: Object.fromEntries(tsRuleEntries)
+		}];
+	});
+	dbg("scoped rules with prefixes %O to files: %O", normalizedPrefixes, files);
+	return cfgs;
+}
+const parserPlain = {
+	meta: { name: "parser-plain" },
+	parseForESLint: (code) => ({
+		ast: {
+			body: [],
+			comments: [],
+			loc: {
+				end: code.length,
+				start: 0
 			},
-			sourceType: "module"
+			range: [0, code.length],
+			tokens: [],
+			type: "Program"
 		},
-		linterOptions: { reportUnusedDisableDirectives },
-		name: "jsse/javascript",
-		plugins: { "unused-imports": pluginUnusedImports },
-		rules: {
-			...eslintjs.configs.recommended.rules,
-			...javascriptSelectedRules(),
-			"unused-imports/no-unused-imports": isInEditor ? "off" : "error",
-			"unused-imports/no-unused-vars": ["error", {
-				args: "after-used",
-				argsIgnorePattern: "^_",
-				ignoreRestSiblings: true,
-				vars: "all",
-				varsIgnorePattern: "^_"
-			}],
-			...overrides
-		}
-	}, {
-		files: [`scripts/${GLOB_JS}`, `cli.${GLOB_JS_SRC_EXT}`],
-		name: "jsse/scripts-overrides",
-		rules: { "no-console": "off" }
-	}];
+		scopeManager: void 0,
+		services: { isPlain: true },
+		visitorKeys: { Program: [] }
+	})
 };
-//#endregion
-//#region src/configs/jsdoc.ts
-const jsdoc = async (options) => {
-	return [{
-		files: GLOB_CODE,
-		name: "jsse/jsdoc",
-		plugins: { jsdoc: await interopDefault(import("eslint-plugin-jsdoc")) },
-		rules: {
-			"jsdoc/check-access": "warn",
-			"jsdoc/check-alignment": "warn",
-			"jsdoc/check-param-names": "warn",
-			"jsdoc/check-property-names": "warn",
-			"jsdoc/check-types": "warn",
-			"jsdoc/empty-tags": "warn",
-			"jsdoc/implements-on-classes": "warn",
-			"jsdoc/multiline-blocks": "warn",
-			"jsdoc/no-defaults": "warn",
-			"jsdoc/no-multi-asterisks": "warn",
-			"jsdoc/require-param-name": "warn",
-			"jsdoc/require-property": "warn",
-			"jsdoc/require-property-description": "warn",
-			"jsdoc/require-property-name": "warn",
-			"jsdoc/require-returns-check": "warn",
-			"jsdoc/require-returns-description": "warn",
-			"jsdoc/require-yields-check": "warn",
-			"jsdoc/tag-lines": "warn",
-			...options?.overrides
+function turnOffRules(configs, off, debug) {
+	if (off.length > 0) {
+		dbg("turning off rules: %O", off);
+		const currentlyActiveRules = /* @__PURE__ */ new Set();
+		for (const config of configs) {
+			const cfgRules = Object.keys(config.rules ?? {});
+			for (const rule of cfgRules) currentlyActiveRules.add(rule);
 		}
-	}];
-};
+		for (const rule of off) {
+			if (currentlyActiveRules.has(rule)) continue;
+			const msg = `Rule \`${rule}\` is not active in the current config, you can remove it from the off list`;
+			dbg(msg);
+			if (debug) warn(msg);
+		}
+		for (const config of configs) {
+			const cfgRules = config.rules;
+			if (cfgRules) {
+				for (const rule of off) if (cfgRules[rule] !== void 0 && cfgRules[rule] !== "off" && cfgRules[rule] !== 0) cfgRules[rule] = "off";
+			}
+		}
+		dbg("finished turning off rules");
+	}
+	return configs;
+}
+const TYPESCRIPT_ESLINT_PREFIX = "@typescript-eslint/";
+function replaceTypescriptEslintPrefixInplace(items, tsPrefix) {
+	for (const [key, value] of Object.entries(items)) {
+		if (!key.startsWith(TYPESCRIPT_ESLINT_PREFIX)) continue;
+		delete items[key];
+		items[`${tsPrefix}/${key.slice(19)}`] = value;
+	}
+}
 //#endregion
 //#region src/configs/jsonc.ts
 async function importParserJsonc() {
@@ -5010,86 +5011,57 @@ function tsPresetRules(props) {
 function typescriptRulesTypeAware() {
 	return {
 		"@typescript-eslint/consistent-type-exports": ["error", { fixMixedExportsWithInlineTypeSpecifier: true }],
-		"dot-notation": "off",
 		"@typescript-eslint/dot-notation": ["error", {
-			allowPattern: "^_",
-			allowKeywords: true
+			allowKeywords: true,
+			allowPattern: "^_"
+		}],
+		"@typescript-eslint/no-floating-promises": ["error", {
+			ignoreIIFE: true,
+			ignoreVoid: true
 		}],
 		"@typescript-eslint/no-import-type-side-effects": "error",
 		"@typescript-eslint/no-unnecessary-qualifier": "error",
 		"@typescript-eslint/require-array-sort-compare": ["error", { ignoreStringArrays: true }],
-		"@typescript-eslint/switch-exhaustiveness-check": "error",
-		"@typescript-eslint/no-floating-promises": ["error", {
-			ignoreVoid: true,
-			ignoreIIFE: true
-		}],
 		"@typescript-eslint/restrict-template-expressions": ["error", {
 			allow: [{
+				from: "lib",
 				name: [
 					"Error",
 					"URL",
 					"URLSearchParams"
-				],
-				from: "lib"
+				]
 			}],
 			allowAny: false,
 			allowBoolean: true,
 			allowNullish: true,
 			allowNumber: true,
 			allowRegExp: true
-		}]
+		}],
+		"@typescript-eslint/switch-exhaustiveness-check": "error",
+		"dot-notation": "off"
 	};
 }
 function typescriptRulesTypeOblivious() {
 	return {
-		eqeqeq: "error",
-		camelcase: "off",
-		yoda: "error",
 		"arrow-parens": "off",
-		"no-console": ["warn", { allow: ["warn", "error"] }],
-		"object-curly-spacing": "off",
-		"@typescript-eslint/no-inferrable-types": "off",
-		"@typescript-eslint/consistent-type-imports": ["error", {
-			prefer: "type-imports",
-			fixStyle: "separate-type-imports"
-		}],
-		"@typescript-eslint/adjacent-overload-signatures": "error",
-		"@typescript-eslint/consistent-type-assertions": "error",
-		"@typescript-eslint/consistent-type-definitions": ["error", "type"],
-		"@typescript-eslint/member-ordering": ["warn", {
-			default: "never",
-			classes: [
-				"field",
-				"constructor",
-				"method"
-			]
-		}],
-		"@typescript-eslint/no-namespace": ["error", {
-			allowDeclarations: false,
-			allowDefinitionFiles: false
-		}],
-		"@typescript-eslint/no-unused-vars": ["warn", {
-			vars: "all",
-			args: "none",
-			argsIgnorePattern: "^_",
-			varsIgnorePattern: "^_",
-			caughtErrorsIgnorePattern: "^_"
-		}],
+		camelcase: "off",
+		"comma-spacing": "off",
+		"default-param-last": "off",
+		"no-bitwise": "off",
+		"no-duplicate-imports": "off",
+		"no-empty-function": "off",
+		"no-loop-func": "off",
+		"no-loss-of-precision": "off",
+		"no-restricted-imports": "off",
 		"no-use-before-define": "off",
-		"@typescript-eslint/no-use-before-define": ["error", {
-			functions: true,
-			classes: true,
-			variables: true,
-			enums: true,
-			typedefs: true
-		}],
-		"@typescript-eslint/prefer-namespace-keyword": "warn",
+		"object-curly-spacing": "off",
 		"accessor-pairs": "error",
+		eqeqeq: "error",
 		"for-direction": "warn",
 		"guard-for-in": "error",
 		"max-lines": ["warn", { max: 2e3 }],
-		"no-bitwise": "off",
 		"no-caller": "error",
+		"no-console": ["warn", { allow: ["warn", "error"] }],
 		"no-constant-condition": "warn",
 		"no-debugger": "warn",
 		"no-empty": "warn",
@@ -5106,6 +5078,14 @@ function typescriptRulesTypeOblivious() {
 		"no-new-func": "error",
 		"no-new-wrappers": "warn",
 		"no-octal-escape": "error",
+		"no-restricted-syntax": [
+			"error",
+			"DebuggerStatement",
+			"LabeledStatement",
+			"WithStatement",
+			"TSEnumDeclaration[const=true]",
+			"TSExportAssignment"
+		],
 		"no-return-assign": "error",
 		"no-script-url": "warn",
 		"no-self-compare": "error",
@@ -5118,17 +5098,36 @@ function typescriptRulesTypeOblivious() {
 		"require-atomic-updates": "error",
 		"require-yield": "warn",
 		strict: ["error", "never"],
-		"comma-spacing": "off",
-		"default-param-last": "off",
+		yoda: "error",
+		"@typescript-eslint/adjacent-overload-signatures": "error",
+		"@typescript-eslint/consistent-type-assertions": ["error", {
+			assertionStyle: "as",
+			objectLiteralTypeAssertions: "allow-as-parameter"
+		}],
+		"@typescript-eslint/consistent-type-definitions": ["error", "type"],
+		"@typescript-eslint/consistent-type-imports": ["error", {
+			fixStyle: "separate-type-imports",
+			prefer: "type-imports"
+		}],
 		"@typescript-eslint/default-param-last": "error",
+		"@typescript-eslint/member-ordering": ["warn", {
+			classes: [
+				"field",
+				"constructor",
+				"method"
+			],
+			default: "never"
+		}],
+		"@typescript-eslint/method-signature-style": ["warn", "property"],
 		"@typescript-eslint/no-dupe-class-members": "error",
-		"no-empty-function": "off",
 		"@typescript-eslint/no-empty-function": "error",
-		"no-loop-func": "off",
+		"@typescript-eslint/no-inferrable-types": "off",
 		"@typescript-eslint/no-loop-func": "error",
-		"no-loss-of-precision": "off",
+		"@typescript-eslint/no-namespace": ["error", {
+			allowDeclarations: false,
+			allowDefinitionFiles: false
+		}],
 		"@typescript-eslint/no-redeclare": "error",
-		"no-restricted-imports": "off",
 		"@typescript-eslint/no-restricted-imports": ["error", { paths: [
 			"error",
 			"domain",
@@ -5139,24 +5138,34 @@ function typescriptRulesTypeOblivious() {
 			"querystring",
 			"colors"
 		] }],
-		"no-duplicate-imports": "off",
-		"@typescript-eslint/method-signature-style": ["warn", "property"],
+		"@typescript-eslint/no-unused-expressions": ["error", {
+			allowShortCircuit: true,
+			allowTaggedTemplates: true,
+			allowTernary: true
+		}],
+		"@typescript-eslint/no-unused-vars": ["warn", {
+			args: "none",
+			argsIgnorePattern: "^_",
+			caughtErrorsIgnorePattern: "^_",
+			vars: "all",
+			varsIgnorePattern: "^_"
+		}],
+		"@typescript-eslint/no-use-before-define": ["error", {
+			classes: true,
+			enums: true,
+			functions: true,
+			typedefs: true,
+			variables: true
+		}],
 		"@typescript-eslint/prefer-literal-enum-member": ["error", { allowBitwiseExpressions: true }],
-		"no-restricted-syntax": [
-			"error",
-			"DebuggerStatement",
-			"LabeledStatement",
-			"WithStatement",
-			"TSEnumDeclaration[const=true]",
-			"TSExportAssignment"
-		]
+		"@typescript-eslint/prefer-namespace-keyword": "warn"
 	};
 }
 function typescriptRules(props) {
 	const normalized = {
 		includeTsEslintPresetRules: true,
-		typeAware: false,
 		strict: false,
+		typeAware: false,
 		...props
 	};
 	if (normalized.presets !== void 0 && normalized.strictProvided) throw new Error("Use either TypeScript `presets` or deprecated `strict`, not both.");
@@ -5177,7 +5186,7 @@ function typescriptRules(props) {
 const markdown = async (options) => {
 	const { componentExts = [], overrides = {} } = options ?? {};
 	const files = [GLOB_MARKDOWN];
-	const { pluginMarkdown } = await importPluginMarkdown();
+	const pluginMarkdown = await interopDefault(import("@eslint/markdown"));
 	const tsRulesOff = Object.fromEntries(Object.keys(typescriptRulesTypeAware()).map((key) => [`@typescript-eslint/${key}`, "off"]));
 	const processor = mergeProcessors([pluginMarkdown.processors.markdown, processorPassThrough]);
 	return [
@@ -6244,15 +6253,23 @@ const sortTsconfig = (options) => {
 };
 //#endregion
 //#region src/configs/stylistic.ts
-function jsxStylistic(indent) {
+function jsxStylistic(indent = 2) {
 	return {
 		"@stylistic/jsx-curly-brace-presence": ["error", { propElementValues: "always" }],
 		"@stylistic/jsx-indent-props": ["error", { indentMode: indent === "tab" ? "tab" : indent }],
 		"@stylistic/jsx-quotes": "error"
 	};
 }
+async function importPluginStylistic() {
+	try {
+		return { pluginStylistic: await interopDefault(import("@stylistic/eslint-plugin")) };
+	} catch (error) {
+		console.error("Failed to import @stylistic/eslint-plugin; `pnpm add -D @stylistic/eslint-plugin`", error);
+		throw error;
+	}
+}
 const stylistic = async (options) => {
-	const { jsx = true, quotes = "double" } = options ?? {};
+	const { jsx = true, overrides: overridesStylistic, quotes = "double" } = options ?? {};
 	const hasIndent = options?.indent !== void 0;
 	const indent = options?.indent ?? 2;
 	const { pluginStylistic } = await importPluginStylistic();
@@ -6271,7 +6288,8 @@ const stylistic = async (options) => {
 					avoidEscape: true
 				}
 			],
-			...jsx && jsxStylistic(indent)
+			...jsx && jsxStylistic(indent),
+			...overridesStylistic
 		}
 	}];
 };
@@ -6484,6 +6502,27 @@ const unicorn = ({ overrides = {}, preset = "recommended" } = {}) => {
 	}];
 };
 //#endregion
+//#region src/configs/unused-imports.ts
+const unusedImports = (options) => {
+	const { isInEditor = false, overrides = {} } = options ?? {};
+	return [{
+		files: GLOB_CODE,
+		name: "jsse/unused-imports",
+		plugins: { "unused-imports": pluginUnusedImports },
+		rules: {
+			"unused-imports/no-unused-imports": isInEditor ? "off" : "error",
+			"unused-imports/no-unused-vars": ["error", {
+				args: "after-used",
+				argsIgnorePattern: "^_",
+				ignoreRestSiblings: true,
+				vars: "all",
+				varsIgnorePattern: "^_"
+			}],
+			...overrides
+		}
+	}];
+};
+//#endregion
 //#region src/configs/vitest.ts
 const vitest = async (options = {}) => {
 	const { overrides = {} } = options;
@@ -6520,7 +6559,6 @@ const yml = async (options) => {
 		languageOptions: { parser: parserYaml },
 		name: "jsse/yaml/rules",
 		rules: {
-			"style/spaced-comment": "off",
 			"yaml/block-mapping": "error",
 			"yaml/block-sequence": "error",
 			"yaml/no-empty-key": "error",
@@ -13170,6 +13208,7 @@ function defaultOptions() {
 		typeAware: false,
 		typescript: typescriptExists,
 		unicorn: true,
+		unusedImports: true,
 		vitest: vitestExists,
 		yaml: false
 	};
@@ -13214,7 +13253,8 @@ const CODE_SCOPED_CFG_NAMES = /* @__PURE__ */ new Set([
 	"jsse/perfectionist",
 	"jsse/prettier/config",
 	"jsse/stylistic",
-	"jsse/unicorn"
+	"jsse/unicorn",
+	"jsse/unused-imports"
 ]);
 function postProcessConfigs(configs, options) {
 	const { componentExts, debug = false, off, rootId = "jsse", tsPrefix, typescript } = options;
@@ -13271,7 +13311,7 @@ async function gitignoreConfig(options) {
 async function jsse(options = {}, ...userConfigs) {
 	const startTime = process$1.hrtime.bigint();
 	const normalizedOptions = normalizeOptions(options);
-	const { antfu: antfuOptions, command: commandOptions, componentExts, debug = false, demorgan: deMorganOptions, e18e: e18eOptions, gitignore: enableGitignore, isInEditor, javascript: javascriptOptions, jsdoc: jsdocOptions, jsonc: enableJsonc, markdown: enableMarkdown, n: nOptions, nodeTest: nodeTestOptions, off, pnpm: pnpmOptions, prettier: enablePrettier, react: enableReact, regexp: enableRegexp, reportUnusedDisableDirectives, rootId, sortGeojson: enableSortGeojson, sortImports: enableSortImports, sortPackageJson: enableSortPackageJson, sortTsconfig: enableSortTsconfig, stylistic: stylisticOptions, tailwind: tailwindOptions, tsPrefix, typescript: typescriptOptions, unicorn: unicornOptions, vitest: enableVitest, yaml: enableYaml } = normalizedOptions;
+	const { antfu: antfuOptions, command: commandOptions, componentExts, debug = false, demorgan: deMorganOptions, e18e: e18eOptions, gitignore: enableGitignore, isInEditor, javascript: javascriptOptions, jsdoc: jsdocOptions, jsonc: enableJsonc, markdown: enableMarkdown, n: nOptions, nodeTest: nodeTestOptions, off, pnpm: pnpmOptions, prettier: enablePrettier, react: enableReact, regexp: enableRegexp, reportUnusedDisableDirectives, rootId, sortGeojson: enableSortGeojson, sortImports: enableSortImports, sortPackageJson: enableSortPackageJson, sortTsconfig: enableSortTsconfig, stylistic: stylisticOptions, tailwind: tailwindOptions, tsPrefix, typescript: typescriptOptions, unicorn: unicornOptions, unusedImports: unusedImportsOptions, vitest: enableVitest, yaml: enableYaml } = normalizedOptions;
 	if (debug || process$1.argv.includes("--debug")) enableDbg();
 	dbg("@jsse/eslint-config debug=true");
 	dbg("@jsse/eslint-config isInEditor: %O", isInEditor);
@@ -13280,10 +13320,13 @@ async function jsse(options = {}, ...userConfigs) {
 	const configs = [];
 	if (enableGitignore) configs.push(gitignoreConfig(enableGitignore));
 	configs.push(ignores(), javascript({
-		isInEditor,
 		...javascriptOptions,
 		reportUnusedDisableDirectives
 	}), eslintComments());
+	if (unusedImportsOptions) configs.push(unusedImports({
+		isInEditor,
+		...typeof unusedImportsOptions === "object" && unusedImportsOptions
+	}));
 	if (nOptions) configs.push(n(typeof nOptions === "object" ? nOptions : void 0));
 	if (jsdocOptions) configs.push(jsdoc(typeof jsdocOptions === "object" ? jsdocOptions : void 0));
 	configs.push(imports({ stylistic: stylisticOptions }));