@alextheman/eslint-plugin 4.9.2 → 5.0.0

package/dist/index.cjs

@@ -37,6 +37,8 @@ let eslint_config_prettier = require("eslint-config-prettier");
 eslint_config_prettier = __toESM(eslint_config_prettier);
 let eslint_plugin_import = require("eslint-plugin-import");
 eslint_plugin_import = __toESM(eslint_plugin_import);
+let eslint_plugin_n = require("eslint-plugin-n");
+eslint_plugin_n = __toESM(eslint_plugin_n);
 let eslint_plugin_perfectionist = require("eslint-plugin-perfectionist");
 eslint_plugin_perfectionist = __toESM(eslint_plugin_perfectionist);
 let eslint_plugin_prettier = require("eslint-plugin-prettier");
@@ -3477,6 +3479,67 @@ function createRuleSchemaFromZodSchema(schema$1) {
 }
 var createRuleSchemaFromZodSchema_default = createRuleSchemaFromZodSchema;
 
+//#endregion
+//#region src/utility/private/camelToKebab.ts
+function camelToKebab(string) {
+	if (string[0] === string[0].toUpperCase()) throw new _alextheman_utility.DataError(string, "CAMEL_TO_KEBAB_CONVERSION_ERROR", "camelCase string must start with a lowercase letter.");
+	return (0, _alextheman_utility.camelToKebab)(string, { preserveConsecutiveCapitals: false });
+}
+var camelToKebab_default = camelToKebab;
+
+//#endregion
+//#region src/utility/private/createConfigGroup.ts
+function createConfigGroup(group, configs) {
+	const newConfigs = {};
+	for (const key in configs) newConfigs[`${camelToKebab_default(group)}/${camelToKebab_default(key)}`] = configs[key];
+	return newConfigs;
+}
+var createConfigGroup_default = createConfigGroup;
+
+//#endregion
+//#region src/utility/public/flattenConfigs.ts
+/**
+* Takes in a nested group of configs, and returns them flattened according to ESLint config naming conventions.
+*
+* @template ConfigObject - The type of the input config object.
+*
+* @param config - A doubly-nested config object to pass in, where the key of the top-level object is the config group name, and the key of the nested object is the name of the config within the group (e.g. `groupName.configName`).
+*
+* @returns A single-layered object with the key flattened down to be `group-name/config-name`.
+*
+* @example
+*      flattenConfigs<AlexPluginConfigGroup>({
+*          general: {
+*              typeScript: generalTypeScriptConfig,
+*              javaScript: generalJavaScriptConfig,
+*              react: generalReactConfig,
+*              // ...
+*          }
+*          plugin: {
+*              base: pluginBaseConfig,
+*              tests: pluginTestsConfig,
+*              // ...
+*          }
+*      })
+*
+*      // Returns:
+*      {
+*          "general/typescript": generalTypeScriptConfig,
+*          "general/javascript": generalJavaScriptConfig,
+*          "general/react": generalReactConfig,
+*          // ...,
+*          "plugin/base": pluginBaseConfig,
+*          "plugin/tests": pluginTestsConfig
+*          // ...
+*      }
+*/
+function flattenConfigs(config) {
+	const allConfigs = {};
+	for (const configGroupEntries of Object.entries(config)) Object.assign(allConfigs, createConfigGroup_default(...configGroupEntries));
+	return allConfigs;
+}
+var flattenConfigs_default = flattenConfigs;
+
 //#endregion
 //#region src/utility/public/getImportSpecifiersAfterRemoving.ts
 /**
@@ -3605,6 +3668,7 @@ var unusedVarsIgnorePatterns_default = unusedVarsIgnorePatterns;
 const generalJavaScript = [
 	_eslint_js.default.configs.recommended,
 	eslint_config_prettier.default,
+	eslint_plugin_n.default.configs["flat/recommended"],
 	{
 		files: [
 			"**/*.js",
@@ -3615,10 +3679,26 @@ const generalJavaScript = [
 		ignores: ["dist"],
 		languageOptions: javaScriptLanguageOptions_default,
 		name: "@alextheman/general/javascript",
-		plugins: { import: eslint_plugin_import.default },
+		plugins: {
+			import: eslint_plugin_import.default,
+			n: eslint_plugin_n.default
+		},
 		rules: {
 			eqeqeq: "error",
 			"import/no-unresolved": "error",
+			"n/file-extension-in-import": [
+				"error",
+				"always",
+				{
+					".js": "never",
+					".jsx": "never",
+					".ts": "never",
+					".tsx": "never"
+				}
+			],
+			"n/no-missing-import": "off",
+			"n/no-path-concat": "error",
+			"n/prefer-node-protocol": "error",
 			"no-cond-assign": "error",
 			"no-console": ["error", { allow: [
 				"warn",
@@ -3950,8 +4030,12 @@ var typeScript_default$2 = generalTypeScript;
 //#endregion
 //#region src/configs/personal/alexCLine.ts
 const personalAlexCLine = [{
-	files: ["src/commands/index.ts"],
+	files: ["src/**/*.ts"],
 	name: "@alextheman/personal/alex-c-line",
+	plugins: { n: eslint_plugin_n.default },
+	rules: { "n/hashbang": "off" }
+}, {
+	files: ["src/commands/index.ts"],
 	plugins: { perfectionist: eslint_plugin_perfectionist.default },
 	rules: { "perfectionist/sort-objects": ["error", sortObjects_default] }
 }];
@@ -3978,7 +4062,8 @@ const personalTypeScriptPackage = [eslint_plugin_jsdoc.default.configs["flat/rec
 		{ tags: ["template"] },
 		{ tags: ["param"] },
 		{ tags: ["throws"] },
-		{ tags: ["returns"] }
+		{ tags: ["returns"] },
+		{ tags: ["example"] }
 	] }],
 	"jsdoc/tag-lines": [
 		"error",
@@ -4197,61 +4282,36 @@ function combinedTypeScriptReact(plugin) {
 }
 var typeScriptReact_default = combinedTypeScriptReact;
 
-//#endregion
-//#region src/utility/private/camelToKebab.ts
-function camelToKebab(string) {
-	return (0, _alextheman_utility.camelToKebab)(string.replace(/[Tt]ypeScript/, "typescript").replace(/[Jj]avaScript/, "javascript"));
-}
-var camelToKebab_default = camelToKebab;
-
-//#endregion
-//#region src/utility/private/createConfigGroup.ts
-function createConfigGroup(group, configs) {
-	const newConfigs = {};
-	for (const key in configs) newConfigs[`${camelToKebab_default(group)}/${camelToKebab_default(key)}`] = configs[key];
-	return newConfigs;
-}
-var createConfigGroup_default = createConfigGroup;
-
-//#endregion
-//#region src/utility/private/createPluginConfigs.ts
-function createPluginConfigs(config) {
-	const allConfigs = {};
-	for (const configGroupEntries of Object.entries(config)) Object.assign(allConfigs, createConfigGroup_default(...configGroupEntries));
-	return allConfigs;
-}
-var createPluginConfigs_default = createPluginConfigs;
-
 //#endregion
 //#region src/configs/index.ts
 function createAlexPluginConfigs(plugin) {
-	return createPluginConfigs_default({
+	return flattenConfigs_default({
 		combined: {
-			javaScript: [...javaScript_default(plugin), ...packageJson_default],
-			javaScriptReact: [...javaScriptReact_default(plugin), ...packageJson_default],
+			javascript: [...javaScript_default(plugin), ...packageJson_default],
+			javascriptReact: [...javaScriptReact_default(plugin), ...packageJson_default],
 			react: [...react_default, ...packageJson_default],
 			tests: [...tests_default(plugin), ...packageJson_default],
-			typeScript: [...typeScript_default(plugin), ...packageJson_default],
-			typeScriptPackage: [...typeScriptPackage_default(plugin), ...packageJson_default],
-			typeScriptReact: [...typeScriptReact_default(plugin), ...packageJson_default]
+			typescript: [...typeScript_default(plugin), ...packageJson_default],
+			typescriptPackage: [...typeScriptPackage_default(plugin), ...packageJson_default],
+			typescriptReact: [...typeScriptReact_default(plugin), ...packageJson_default]
 		},
 		general: {
-			javaScript: javaScript_default$1,
+			javascript: javaScript_default$1,
 			packageJson: packageJson_default,
 			react: react_default$2,
-			typeScript: typeScript_default$2
+			typescript: typeScript_default$2
 		},
 		personal: {
 			alexCLine: alexCLine_default,
 			components: components_default,
 			eslintPlugin: eslintPlugin_default(plugin),
-			javaScript: javaScriptBase_default(plugin),
+			javascript: javaScriptBase_default(plugin),
 			neurosongsBackEnd: neurosongsBackEnd_default,
 			neurosongsFrontEnd: neurosongsFrontEnd_default,
 			react: react_default$1,
 			tests: tests_default$2,
-			typeScript: typeScript_default$1(plugin),
-			typeScriptPackage: typeScriptPackage_default$1,
+			typescript: typeScript_default$1(plugin),
+			typescriptPackage: typeScriptPackage_default$1,
 			utility: utility_default
 		},
 		plugin: {
@@ -4680,7 +4740,7 @@ var rules_default = {
 //#endregion
 //#region package.json
 var name = "@alextheman/eslint-plugin";
-var version = "4.9.2";
+var version = "5.0.0";
 
 //#endregion
 //#region src/alexPlugin.ts
@@ -4706,6 +4766,7 @@ exports.combineRestrictedImports = combineRestrictedImports_default;
 exports.createRuleSchemaFromZodSchema = createRuleSchemaFromZodSchema_default;
 exports.default = src_default;
 exports.fixOnCondition = fixOnCondition_default;
+exports.flattenConfigs = flattenConfigs_default;
 exports.getImportSpecifiersAfterRemoving = getImportSpecifiersAfterRemoving_default;
 exports.parseConsistentTestFunctionOptions = parseConsistentTestFunctionOptions;
 exports.parseNoNamespaceImportsOptions = parseNoNamespaceImportsOptions;

package/dist/index.d.cts

@@ -1,5 +1,4 @@
 import { Linter } from "eslint";
-import { IgnoreCase } from "@alextheman/utility";
 import { Config } from "prettier";
 import * as vite0 from "vite";
 import { VitestEnvironment } from "vitest/node";
@@ -9,24 +8,28 @@ import { TSESTree } from "@typescript-eslint/utils";
 import { JSONSchema4 } from "@typescript-eslint/utils/json-schema";
 
 //#region src/utility/private/camelToKebab.d.ts
-type CamelToKebab<S extends string> = S extends `${IgnoreCase<"J">}avaScript${infer Rest}` ? Rest extends "" ? "javascript" : `javascript${CamelToKebab<Rest>}` : S extends `${IgnoreCase<"T">}ypeScript${infer Rest}` ? Rest extends "" ? "typescript" : `typescript${CamelToKebab<Rest>}` : S extends `${infer Head}${infer Tail}` ? Head extends Lowercase<Head> ? `${Head}${CamelToKebab<Tail>}` : `-${Lowercase<Head>}${CamelToKebab<Tail>}` : S;
+type CamelToKebab<S extends string> = S extends `${infer Head}${infer Tail}` ? Head extends Lowercase<Head> ? `${Head}${CamelToKebab<Tail>}` : `-${Lowercase<Head>}${CamelToKebab<Tail>}` : S;
+//#endregion
+//#region src/utility/public/GetFlattenedConfigNames.d.ts
+type GetFlattenedConfigNames<ConfigObject extends { [K in keyof ConfigObject]: Record<string, Linter.Config[]> }> = { [Group in keyof ConfigObject & string]: `${CamelToKebab<Group>}/${CamelToKebab<keyof ConfigObject[Group] & string>}` }[keyof ConfigObject & string];
 //#endregion
 //#region src/configs/AlexPluginConfigGroup.d.ts
-type GeneralConfig = "javaScript" | "typeScript" | "react" | "packageJson";
+type GeneralConfig = "javascript" | "typescript" | "react" | "packageJson";
 type PluginConfig = "base" | "tests";
-type PersonalConfig = "javaScript" | "typeScript" | "react" | "tests" | "eslintPlugin" | "neurosongsBackEnd" | "neurosongsFrontEnd" | "utility" | "alexCLine" | "typeScriptPackage" | "components";
-type CombinedConfig = "javaScript" | "typeScript" | "react" | "tests" | "typeScriptReact" | "javaScriptReact" | "typeScriptPackage";
-interface AlexPluginConfigGroup {
+type PersonalConfig = "javascript" | "typescript" | "react" | "tests" | "eslintPlugin" | "neurosongsBackEnd" | "neurosongsFrontEnd" | "utility" | "alexCLine" | "typescriptPackage" | "components";
+type CombinedConfig = "javascript" | "typescript" | "react" | "tests" | "typescriptReact" | "javascriptReact" | "typescriptPackage";
+interface AlexPluginConfigObject {
   general: Record<GeneralConfig, Linter.Config[]>;
   plugin: Record<PluginConfig, Linter.Config[]>;
   personal: Record<PersonalConfig, Linter.Config[]>;
   combined: Record<CombinedConfig, Linter.Config[]>;
 }
-type ConfigGroupName = keyof AlexPluginConfigGroup;
-type ConfigKey = { [Group in ConfigGroupName & string]: `${CamelToKebab<Group>}/${CamelToKebab<keyof AlexPluginConfigGroup[Group] & string>}` }[ConfigGroupName & string];
+type AlexConfigGroupName = keyof AlexPluginConfigObject;
+type AlexFlattenedConfigName = GetFlattenedConfigNames<AlexPluginConfigObject>;
+type AlexPluginConfigFlattened = Record<AlexFlattenedConfigName, Linter.Config[]>;
 //#endregion
 //#region src/configs/index.d.ts
-declare function createAlexPluginConfigs(plugin: Readonly<AlexPlugin>): Record<ConfigKey, Linter.Config[]>;
+declare function createAlexPluginConfigs(plugin: Readonly<AlexPlugin>): Record<AlexFlattenedConfigName, Linter.Config[]>;
 //#endregion
 //#region package.d.ts
 declare let name: string;
@@ -269,6 +272,44 @@ declare function combineRestrictedImports(...groups: NoRestrictedImportsOptions[
  */
 declare function createRuleSchemaFromZodSchema(schema: z.ZodType): JSONSchema4[];
 //#endregion
+//#region src/utility/public/flattenConfigs.d.ts
+/**
+ * Takes in a nested group of configs, and returns them flattened according to ESLint config naming conventions.
+ *
+ * @template ConfigObject - The type of the input config object.
+ *
+ * @param config - A doubly-nested config object to pass in, where the key of the top-level object is the config group name, and the key of the nested object is the name of the config within the group (e.g. `groupName.configName`).
+ *
+ * @returns A single-layered object with the key flattened down to be `group-name/config-name`.
+ *
+ * @example
+ *      flattenConfigs<AlexPluginConfigGroup>({
+ *          general: {
+ *              typeScript: generalTypeScriptConfig,
+ *              javaScript: generalJavaScriptConfig,
+ *              react: generalReactConfig,
+ *              // ...
+ *          }
+ *          plugin: {
+ *              base: pluginBaseConfig,
+ *              tests: pluginTestsConfig,
+ *              // ...
+ *          }
+ *      })
+ *
+ *      // Returns:
+ *      {
+ *          "general/typescript": generalTypeScriptConfig,
+ *          "general/javascript": generalJavaScriptConfig,
+ *          "general/react": generalReactConfig,
+ *          // ...,
+ *          "plugin/base": pluginBaseConfig,
+ *          "plugin/tests": pluginTestsConfig
+ *          // ...
+ *      }
+ */
+declare function flattenConfigs<ConfigObject extends { [K in keyof ConfigObject]: Record<string, Linter.Config[]> }>(config: ConfigObject): Record<GetFlattenedConfigNames<ConfigObject>, Linter.Config[]>;
+//#endregion
 //#region src/utility/public/getImportSpecifiersAfterRemoving.d.ts
 /**
  * Returns a comma-separated string of import specifiers, excluding the specified import.
@@ -285,4 +326,4 @@ declare function createRuleSchemaFromZodSchema(schema: z.ZodType): JSONSchema4[]
  */
 declare function getImportSpecifiersAfterRemoving<RuleOptions>(context: Readonly<RuleContext<"message", [RuleOptions]>>, specifiers: TSESTree.ImportClause[], importToRemove: string): string;
 //#endregion
-export { type AlexPlugin, AlexPluginConfigGroup, CombinedConfig, ConfigGroupName, ConfigKey, ConsistentTestFunctionOptions, GeneralConfig, NoNamespaceImportsOptions, NoRelativeImportsOptions, type NoRestrictedImportsOptions, PersonalConfig, PluginConfig, type RestrictedPathImport, type RestrictedPatternImport, RuleFixerFunction, StandardiseErrorMessagesOptions, TestFunction, UseNormalizedImportsOptions, checkCallExpression, combineRestrictedImports, createRuleSchemaFromZodSchema, alexPlugin as default, fixOnCondition, getImportSpecifiersAfterRemoving, parseConsistentTestFunctionOptions, parseNoNamespaceImportsOptions, parseNoRelativeImportsOptions, parseStandardiseErrorMessagesOptions, parseTestFunction, parseUseNormalizedImportsOptions, prettierRules, reactLanguageOptions, sortExports, sortImports, sortObjects, typeScriptLanguageOptions, unusedVarsIgnorePatterns, vitestConfig };
+export { AlexConfigGroupName, AlexFlattenedConfigName, type AlexPlugin, AlexPluginConfigFlattened, AlexPluginConfigObject, CombinedConfig, type GetFlattenedConfigNames as ConfigKey, ConsistentTestFunctionOptions, GeneralConfig, NoNamespaceImportsOptions, NoRelativeImportsOptions, type NoRestrictedImportsOptions, PersonalConfig, PluginConfig, type RestrictedPathImport, type RestrictedPatternImport, RuleFixerFunction, StandardiseErrorMessagesOptions, TestFunction, UseNormalizedImportsOptions, checkCallExpression, combineRestrictedImports, createRuleSchemaFromZodSchema, alexPlugin as default, fixOnCondition, flattenConfigs, getImportSpecifiersAfterRemoving, parseConsistentTestFunctionOptions, parseNoNamespaceImportsOptions, parseNoRelativeImportsOptions, parseStandardiseErrorMessagesOptions, parseTestFunction, parseUseNormalizedImportsOptions, prettierRules, reactLanguageOptions, sortExports, sortImports, sortObjects, typeScriptLanguageOptions, unusedVarsIgnorePatterns, vitestConfig };

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-import { IgnoreCase } from "@alextheman/utility";
 import { TSESTree } from "@typescript-eslint/utils";
 import z from "zod";
 import { Linter } from "eslint";
@@ -9,24 +8,28 @@ import { RuleContext, RuleFix, RuleFixer } from "@typescript-eslint/utils/ts-esl
 import { JSONSchema4 } from "@typescript-eslint/utils/json-schema";
 
 //#region src/utility/private/camelToKebab.d.ts
-type CamelToKebab<S extends string> = S extends `${IgnoreCase<"J">}avaScript${infer Rest}` ? Rest extends "" ? "javascript" : `javascript${CamelToKebab<Rest>}` : S extends `${IgnoreCase<"T">}ypeScript${infer Rest}` ? Rest extends "" ? "typescript" : `typescript${CamelToKebab<Rest>}` : S extends `${infer Head}${infer Tail}` ? Head extends Lowercase<Head> ? `${Head}${CamelToKebab<Tail>}` : `-${Lowercase<Head>}${CamelToKebab<Tail>}` : S;
+type CamelToKebab<S extends string> = S extends `${infer Head}${infer Tail}` ? Head extends Lowercase<Head> ? `${Head}${CamelToKebab<Tail>}` : `-${Lowercase<Head>}${CamelToKebab<Tail>}` : S;
+//#endregion
+//#region src/utility/public/GetFlattenedConfigNames.d.ts
+type GetFlattenedConfigNames<ConfigObject extends { [K in keyof ConfigObject]: Record<string, Linter.Config[]> }> = { [Group in keyof ConfigObject & string]: `${CamelToKebab<Group>}/${CamelToKebab<keyof ConfigObject[Group] & string>}` }[keyof ConfigObject & string];
 //#endregion
 //#region src/configs/AlexPluginConfigGroup.d.ts
-type GeneralConfig = "javaScript" | "typeScript" | "react" | "packageJson";
+type GeneralConfig = "javascript" | "typescript" | "react" | "packageJson";
 type PluginConfig = "base" | "tests";
-type PersonalConfig = "javaScript" | "typeScript" | "react" | "tests" | "eslintPlugin" | "neurosongsBackEnd" | "neurosongsFrontEnd" | "utility" | "alexCLine" | "typeScriptPackage" | "components";
-type CombinedConfig = "javaScript" | "typeScript" | "react" | "tests" | "typeScriptReact" | "javaScriptReact" | "typeScriptPackage";
-interface AlexPluginConfigGroup {
+type PersonalConfig = "javascript" | "typescript" | "react" | "tests" | "eslintPlugin" | "neurosongsBackEnd" | "neurosongsFrontEnd" | "utility" | "alexCLine" | "typescriptPackage" | "components";
+type CombinedConfig = "javascript" | "typescript" | "react" | "tests" | "typescriptReact" | "javascriptReact" | "typescriptPackage";
+interface AlexPluginConfigObject {
   general: Record<GeneralConfig, Linter.Config[]>;
   plugin: Record<PluginConfig, Linter.Config[]>;
   personal: Record<PersonalConfig, Linter.Config[]>;
   combined: Record<CombinedConfig, Linter.Config[]>;
 }
-type ConfigGroupName = keyof AlexPluginConfigGroup;
-type ConfigKey = { [Group in ConfigGroupName & string]: `${CamelToKebab<Group>}/${CamelToKebab<keyof AlexPluginConfigGroup[Group] & string>}` }[ConfigGroupName & string];
+type AlexConfigGroupName = keyof AlexPluginConfigObject;
+type AlexFlattenedConfigName = GetFlattenedConfigNames<AlexPluginConfigObject>;
+type AlexPluginConfigFlattened = Record<AlexFlattenedConfigName, Linter.Config[]>;
 //#endregion
 //#region src/configs/index.d.ts
-declare function createAlexPluginConfigs(plugin: Readonly<AlexPlugin>): Record<ConfigKey, Linter.Config[]>;
+declare function createAlexPluginConfigs(plugin: Readonly<AlexPlugin>): Record<AlexFlattenedConfigName, Linter.Config[]>;
 //#endregion
 //#region package.d.ts
 declare let name: string;
@@ -269,6 +272,44 @@ declare function combineRestrictedImports(...groups: NoRestrictedImportsOptions[
  */
 declare function createRuleSchemaFromZodSchema(schema: z.ZodType): JSONSchema4[];
 //#endregion
+//#region src/utility/public/flattenConfigs.d.ts
+/**
+ * Takes in a nested group of configs, and returns them flattened according to ESLint config naming conventions.
+ *
+ * @template ConfigObject - The type of the input config object.
+ *
+ * @param config - A doubly-nested config object to pass in, where the key of the top-level object is the config group name, and the key of the nested object is the name of the config within the group (e.g. `groupName.configName`).
+ *
+ * @returns A single-layered object with the key flattened down to be `group-name/config-name`.
+ *
+ * @example
+ *      flattenConfigs<AlexPluginConfigGroup>({
+ *          general: {
+ *              typeScript: generalTypeScriptConfig,
+ *              javaScript: generalJavaScriptConfig,
+ *              react: generalReactConfig,
+ *              // ...
+ *          }
+ *          plugin: {
+ *              base: pluginBaseConfig,
+ *              tests: pluginTestsConfig,
+ *              // ...
+ *          }
+ *      })
+ *
+ *      // Returns:
+ *      {
+ *          "general/typescript": generalTypeScriptConfig,
+ *          "general/javascript": generalJavaScriptConfig,
+ *          "general/react": generalReactConfig,
+ *          // ...,
+ *          "plugin/base": pluginBaseConfig,
+ *          "plugin/tests": pluginTestsConfig
+ *          // ...
+ *      }
+ */
+declare function flattenConfigs<ConfigObject extends { [K in keyof ConfigObject]: Record<string, Linter.Config[]> }>(config: ConfigObject): Record<GetFlattenedConfigNames<ConfigObject>, Linter.Config[]>;
+//#endregion
 //#region src/utility/public/getImportSpecifiersAfterRemoving.d.ts
 /**
  * Returns a comma-separated string of import specifiers, excluding the specified import.
@@ -285,4 +326,4 @@ declare function createRuleSchemaFromZodSchema(schema: z.ZodType): JSONSchema4[]
  */
 declare function getImportSpecifiersAfterRemoving<RuleOptions>(context: Readonly<RuleContext<"message", [RuleOptions]>>, specifiers: TSESTree.ImportClause[], importToRemove: string): string;
 //#endregion
-export { type AlexPlugin, AlexPluginConfigGroup, CombinedConfig, ConfigGroupName, ConfigKey, type ConsistentTestFunctionOptions, GeneralConfig, type NoNamespaceImportsOptions, type NoRelativeImportsOptions, type NoRestrictedImportsOptions, PersonalConfig, PluginConfig, type RestrictedPathImport, type RestrictedPatternImport, type RuleFixerFunction, type StandardiseErrorMessagesOptions, type TestFunction, type UseNormalizedImportsOptions, checkCallExpression, combineRestrictedImports, createRuleSchemaFromZodSchema, alexPlugin as default, fixOnCondition, getImportSpecifiersAfterRemoving, parseConsistentTestFunctionOptions, parseNoNamespaceImportsOptions, parseNoRelativeImportsOptions, parseStandardiseErrorMessagesOptions, parseTestFunction, parseUseNormalizedImportsOptions, prettierRules, reactLanguageOptions, sortExports, sortImports, sortObjects, typeScriptLanguageOptions, unusedVarsIgnorePatterns, vitestConfig };
+export { AlexConfigGroupName, AlexFlattenedConfigName, type AlexPlugin, AlexPluginConfigFlattened, AlexPluginConfigObject, CombinedConfig, type GetFlattenedConfigNames as ConfigKey, type ConsistentTestFunctionOptions, GeneralConfig, type NoNamespaceImportsOptions, type NoRelativeImportsOptions, type NoRestrictedImportsOptions, PersonalConfig, PluginConfig, type RestrictedPathImport, type RestrictedPatternImport, type RuleFixerFunction, type StandardiseErrorMessagesOptions, type TestFunction, type UseNormalizedImportsOptions, checkCallExpression, combineRestrictedImports, createRuleSchemaFromZodSchema, alexPlugin as default, fixOnCondition, flattenConfigs, getImportSpecifiersAfterRemoving, parseConsistentTestFunctionOptions, parseNoNamespaceImportsOptions, parseNoRelativeImportsOptions, parseStandardiseErrorMessagesOptions, parseTestFunction, parseUseNormalizedImportsOptions, prettierRules, reactLanguageOptions, sortExports, sortImports, sortObjects, typeScriptLanguageOptions, unusedVarsIgnorePatterns, vitestConfig };

package/dist/index.js

@@ -1,9 +1,10 @@
-import { camelToKebab, deepCopy, deepFreeze, normalizeImportPath, omitProperties } from "@alextheman/utility";
+import { DataError, camelToKebab, deepCopy, deepFreeze, normalizeImportPath, omitProperties } from "@alextheman/utility";
 import { AST_NODE_TYPES, ESLintUtils } from "@typescript-eslint/utils";
 import z from "zod";
 import js from "@eslint/js";
 import prettierConfig from "eslint-config-prettier";
 import importPlugin from "eslint-plugin-import";
+import nodePlugin from "eslint-plugin-n";
 import perfectionist from "eslint-plugin-perfectionist";
 import prettierPlugin from "eslint-plugin-prettier";
 import tseslint from "typescript-eslint";
@@ -3462,6 +3463,67 @@ function createRuleSchemaFromZodSchema(schema$1) {
 }
 var createRuleSchemaFromZodSchema_default = createRuleSchemaFromZodSchema;
 
+//#endregion
+//#region src/utility/private/camelToKebab.ts
+function camelToKebab$1(string) {
+	if (string[0] === string[0].toUpperCase()) throw new DataError(string, "CAMEL_TO_KEBAB_CONVERSION_ERROR", "camelCase string must start with a lowercase letter.");
+	return camelToKebab(string, { preserveConsecutiveCapitals: false });
+}
+var camelToKebab_default = camelToKebab$1;
+
+//#endregion
+//#region src/utility/private/createConfigGroup.ts
+function createConfigGroup(group, configs) {
+	const newConfigs = {};
+	for (const key in configs) newConfigs[`${camelToKebab_default(group)}/${camelToKebab_default(key)}`] = configs[key];
+	return newConfigs;
+}
+var createConfigGroup_default = createConfigGroup;
+
+//#endregion
+//#region src/utility/public/flattenConfigs.ts
+/**
+* Takes in a nested group of configs, and returns them flattened according to ESLint config naming conventions.
+*
+* @template ConfigObject - The type of the input config object.
+*
+* @param config - A doubly-nested config object to pass in, where the key of the top-level object is the config group name, and the key of the nested object is the name of the config within the group (e.g. `groupName.configName`).
+*
+* @returns A single-layered object with the key flattened down to be `group-name/config-name`.
+*
+* @example
+*      flattenConfigs<AlexPluginConfigGroup>({
+*          general: {
+*              typeScript: generalTypeScriptConfig,
+*              javaScript: generalJavaScriptConfig,
+*              react: generalReactConfig,
+*              // ...
+*          }
+*          plugin: {
+*              base: pluginBaseConfig,
+*              tests: pluginTestsConfig,
+*              // ...
+*          }
+*      })
+*
+*      // Returns:
+*      {
+*          "general/typescript": generalTypeScriptConfig,
+*          "general/javascript": generalJavaScriptConfig,
+*          "general/react": generalReactConfig,
+*          // ...,
+*          "plugin/base": pluginBaseConfig,
+*          "plugin/tests": pluginTestsConfig
+*          // ...
+*      }
+*/
+function flattenConfigs(config) {
+	const allConfigs = {};
+	for (const configGroupEntries of Object.entries(config)) Object.assign(allConfigs, createConfigGroup_default(...configGroupEntries));
+	return allConfigs;
+}
+var flattenConfigs_default = flattenConfigs;
+
 //#endregion
 //#region src/utility/public/getImportSpecifiersAfterRemoving.ts
 /**
@@ -3590,6 +3652,7 @@ var unusedVarsIgnorePatterns_default = unusedVarsIgnorePatterns;
 const generalJavaScript = [
 	js.configs.recommended,
 	prettierConfig,
+	nodePlugin.configs["flat/recommended"],
 	{
 		files: [
 			"**/*.js",
@@ -3600,10 +3663,26 @@ const generalJavaScript = [
 		ignores: ["dist"],
 		languageOptions: javaScriptLanguageOptions_default,
 		name: "@alextheman/general/javascript",
-		plugins: { import: importPlugin },
+		plugins: {
+			import: importPlugin,
+			n: nodePlugin
+		},
 		rules: {
 			eqeqeq: "error",
 			"import/no-unresolved": "error",
+			"n/file-extension-in-import": [
+				"error",
+				"always",
+				{
+					".js": "never",
+					".jsx": "never",
+					".ts": "never",
+					".tsx": "never"
+				}
+			],
+			"n/no-missing-import": "off",
+			"n/no-path-concat": "error",
+			"n/prefer-node-protocol": "error",
 			"no-cond-assign": "error",
 			"no-console": ["error", { allow: [
 				"warn",
@@ -3935,8 +4014,12 @@ var typeScript_default$2 = generalTypeScript;
 //#endregion
 //#region src/configs/personal/alexCLine.ts
 const personalAlexCLine = [{
-	files: ["src/commands/index.ts"],
+	files: ["src/**/*.ts"],
 	name: "@alextheman/personal/alex-c-line",
+	plugins: { n: nodePlugin },
+	rules: { "n/hashbang": "off" }
+}, {
+	files: ["src/commands/index.ts"],
 	plugins: { perfectionist },
 	rules: { "perfectionist/sort-objects": ["error", sortObjects_default] }
 }];
@@ -3963,7 +4046,8 @@ const personalTypeScriptPackage = [jsdoc.configs["flat/recommended-typescript-er
 		{ tags: ["template"] },
 		{ tags: ["param"] },
 		{ tags: ["throws"] },
-		{ tags: ["returns"] }
+		{ tags: ["returns"] },
+		{ tags: ["example"] }
 	] }],
 	"jsdoc/tag-lines": [
 		"error",
@@ -4182,61 +4266,36 @@ function combinedTypeScriptReact(plugin) {
 }
 var typeScriptReact_default = combinedTypeScriptReact;
 
-//#endregion
-//#region src/utility/private/camelToKebab.ts
-function camelToKebab$1(string) {
-	return camelToKebab(string.replace(/[Tt]ypeScript/, "typescript").replace(/[Jj]avaScript/, "javascript"));
-}
-var camelToKebab_default = camelToKebab$1;
-
-//#endregion
-//#region src/utility/private/createConfigGroup.ts
-function createConfigGroup(group, configs) {
-	const newConfigs = {};
-	for (const key in configs) newConfigs[`${camelToKebab_default(group)}/${camelToKebab_default(key)}`] = configs[key];
-	return newConfigs;
-}
-var createConfigGroup_default = createConfigGroup;
-
-//#endregion
-//#region src/utility/private/createPluginConfigs.ts
-function createPluginConfigs(config) {
-	const allConfigs = {};
-	for (const configGroupEntries of Object.entries(config)) Object.assign(allConfigs, createConfigGroup_default(...configGroupEntries));
-	return allConfigs;
-}
-var createPluginConfigs_default = createPluginConfigs;
-
 //#endregion
 //#region src/configs/index.ts
 function createAlexPluginConfigs(plugin) {
-	return createPluginConfigs_default({
+	return flattenConfigs_default({
 		combined: {
-			javaScript: [...javaScript_default(plugin), ...packageJson_default],
-			javaScriptReact: [...javaScriptReact_default(plugin), ...packageJson_default],
+			javascript: [...javaScript_default(plugin), ...packageJson_default],
+			javascriptReact: [...javaScriptReact_default(plugin), ...packageJson_default],
 			react: [...react_default, ...packageJson_default],
 			tests: [...tests_default(plugin), ...packageJson_default],
-			typeScript: [...typeScript_default(plugin), ...packageJson_default],
-			typeScriptPackage: [...typeScriptPackage_default(plugin), ...packageJson_default],
-			typeScriptReact: [...typeScriptReact_default(plugin), ...packageJson_default]
+			typescript: [...typeScript_default(plugin), ...packageJson_default],
+			typescriptPackage: [...typeScriptPackage_default(plugin), ...packageJson_default],
+			typescriptReact: [...typeScriptReact_default(plugin), ...packageJson_default]
 		},
 		general: {
-			javaScript: javaScript_default$1,
+			javascript: javaScript_default$1,
 			packageJson: packageJson_default,
 			react: react_default$2,
-			typeScript: typeScript_default$2
+			typescript: typeScript_default$2
 		},
 		personal: {
 			alexCLine: alexCLine_default,
 			components: components_default,
 			eslintPlugin: eslintPlugin_default(plugin),
-			javaScript: javaScriptBase_default(plugin),
+			javascript: javaScriptBase_default(plugin),
 			neurosongsBackEnd: neurosongsBackEnd_default,
 			neurosongsFrontEnd: neurosongsFrontEnd_default,
 			react: react_default$1,
 			tests: tests_default$2,
-			typeScript: typeScript_default$1(plugin),
-			typeScriptPackage: typeScriptPackage_default$1,
+			typescript: typeScript_default$1(plugin),
+			typescriptPackage: typeScriptPackage_default$1,
 			utility: utility_default
 		},
 		plugin: {
@@ -4665,7 +4724,7 @@ var rules_default = {
 //#endregion
 //#region package.json
 var name = "@alextheman/eslint-plugin";
-var version = "4.9.2";
+var version = "5.0.0";
 
 //#endregion
 //#region src/alexPlugin.ts
@@ -4686,4 +4745,4 @@ var alexPlugin_default = alexPlugin;
 var src_default = alexPlugin_default;
 
 //#endregion
-export { checkCallExpression_default as checkCallExpression, combineRestrictedImports_default as combineRestrictedImports, createRuleSchemaFromZodSchema_default as createRuleSchemaFromZodSchema, src_default as default, fixOnCondition_default as fixOnCondition, getImportSpecifiersAfterRemoving_default as getImportSpecifiersAfterRemoving, parseConsistentTestFunctionOptions, parseNoNamespaceImportsOptions, parseNoRelativeImportsOptions, parseStandardiseErrorMessagesOptions, parseTestFunction, parseUseNormalizedImportsOptions, prettierRules_default as prettierRules, reactLanguageOptions_default as reactLanguageOptions, sortExports_default as sortExports, sortImports_default as sortImports, sortObjects_default as sortObjects, typeScriptLanguageOptions_default as typeScriptLanguageOptions, unusedVarsIgnorePatterns_default as unusedVarsIgnorePatterns, vitestConfig_default as vitestConfig };
+export { checkCallExpression_default as checkCallExpression, combineRestrictedImports_default as combineRestrictedImports, createRuleSchemaFromZodSchema_default as createRuleSchemaFromZodSchema, src_default as default, fixOnCondition_default as fixOnCondition, flattenConfigs_default as flattenConfigs, getImportSpecifiersAfterRemoving_default as getImportSpecifiersAfterRemoving, parseConsistentTestFunctionOptions, parseNoNamespaceImportsOptions, parseNoRelativeImportsOptions, parseStandardiseErrorMessagesOptions, parseTestFunction, parseUseNormalizedImportsOptions, prettierRules_default as prettierRules, reactLanguageOptions_default as reactLanguageOptions, sortExports_default as sortExports, sortImports_default as sortImports, sortObjects_default as sortObjects, typeScriptLanguageOptions_default as typeScriptLanguageOptions, unusedVarsIgnorePatterns_default as unusedVarsIgnorePatterns, vitestConfig_default as vitestConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/eslint-plugin",
-  "version": "4.9.2",
+  "version": "5.0.0",
   "description": "A package to provide custom ESLint rules and configs",
   "repository": {
     "type": "git",
@@ -15,7 +15,7 @@
     "dist"
   ],
   "dependencies": {
-    "@alextheman/utility": "^4.0.0",
+    "@alextheman/utility": "^4.1.0",
     "@typescript-eslint/utils": "^8.50.0",
     "common-tags": "^1.8.2",
     "zod": "^4.2.1"
@@ -36,6 +36,7 @@
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-jsdoc": "^61.5.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-n": "^17.23.1",
     "eslint-plugin-package-json": "^0.85.0",
     "eslint-plugin-perfectionist": "^5.0.0",
     "eslint-plugin-prettier": "^5.5.4",
@@ -62,6 +63,7 @@
     "eslint-plugin-import": ">=2.0.0",
     "eslint-plugin-jsdoc": ">=61.5.0",
     "eslint-plugin-jsx-a11y": ">=6.0.0",
+    "eslint-plugin-n": ">=17.23.1",
     "eslint-plugin-package-json": ">=0.85.0",
     "eslint-plugin-perfectionist": ">=4.0.0",
     "eslint-plugin-prettier": ">=5.0.0",