@alextheman/eslint-plugin 5.2.2 → 5.3.0

package/dist/utility/index.cjs

@@ -0,0 +1,209 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let _typescript_eslint_utils = require("@typescript-eslint/utils");
+let _alextheman_utility = require("@alextheman/utility");
+let zod = require("zod");
+zod = __toESM(zod);
+
+//#region src/utility/public/checkCallExpression.ts
+/**
+* Checks if a given node matches the expected object and property names.
+*
+* @category Utility
+*
+* @param node - The node to check.
+* @param objectName - The object name to compare against the node.
+* @param propertyName - The property name to compare against the node.
+*
+* @returns A value of `true` if the given `objectName` and `propertyName` matches those of the node, and `false` otherwise.
+*/
+function checkCallExpression(node, objectName, propertyName) {
+	return node.callee.type === _typescript_eslint_utils.AST_NODE_TYPES.MemberExpression && node.callee.object.type === _typescript_eslint_utils.AST_NODE_TYPES.Identifier && node.callee.object.name === objectName && node.callee.property.type === _typescript_eslint_utils.AST_NODE_TYPES.Identifier && node.callee.property.name === propertyName;
+}
+var checkCallExpression_default = checkCallExpression;
+
+//#endregion
+//#region src/utility/public/combineRestrictedImports.ts
+/**
+* Combines multiple option groups for the native ESLint `no-restricted-imports` rule, without overwriting previous configurations.
+*
+* @category Utility
+*
+* @param groups - Option groups to combine, applied in the order provided.
+*
+* @returns A new object combining all paths and patterns from the given groups, suitable as an option to pass to `no-restricted-imports`.
+*/
+function combineRestrictedImports(...groups) {
+	const paths = [];
+	const patterns = [];
+	for (const group of groups) {
+		if (group.paths) paths.push(...group.paths);
+		if (group.patterns) patterns.push(...group.patterns);
+	}
+	const combinedGroup = {
+		paths,
+		patterns
+	};
+	if (combinedGroup.paths.length === 0) return (0, _alextheman_utility.omitProperties)(combinedGroup, "paths");
+	if (combinedGroup.patterns.length === 0) return (0, _alextheman_utility.omitProperties)(combinedGroup, "patterns");
+	return combinedGroup;
+}
+var combineRestrictedImports_default = combineRestrictedImports;
+
+//#endregion
+//#region src/utility/public/createRuleSchemaFromZodSchema.ts
+/**
+* Converts a Zod schema to a JSON schema for usage in an ESLint rule.
+*
+* @category Utility
+*
+* @param schema - The Zod schema to convert.
+*
+* @returns An array containing the resulting JSON Schema, formatted for ESLint rule schema compatibility.
+*/
+function createRuleSchemaFromZodSchema(schema) {
+	return [(0, _alextheman_utility.omitProperties)(zod.default.toJSONSchema(schema), "$schema")];
+}
+var createRuleSchemaFromZodSchema_default = createRuleSchemaFromZodSchema;
+
+//#endregion
+//#region src/utility/public/fixOnCondition.ts
+/**
+* Returns a rule fixer function to run based on a given condition
+*
+* @category Utility
+*
+* @param fixable - Whether the rule should be treated as fixable or not, and therefore whether the fixer should run.
+* @param fix - The rule fixer function to run.
+*
+* @returns The rule fixer function invoked with the fixer, provided the fixable condition is met.
+*/
+function fixOnCondition(fixable, fix) {
+	return (fixer) => {
+		if (!fixable) return null;
+		return fix(fixer);
+	};
+}
+var fixOnCondition_default = fixOnCondition;
+
+//#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.
+*
+* @category Utility
+*
+* @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
+/**
+* Returns a comma-separated string of import specifiers, excluding the specified import.
+*
+* Useful for auto-fixable rules that remove a specific import from an import statement.
+*
+* @category Utility
+*
+* @template RuleOptions - The type of the RuleOptions from the given context.
+*
+* @param context - The current ESLint rule context.
+* @param specifiers - Array of import clause nodes.
+* @param importToRemove - The import name to remove from the list.
+*
+* @returns A comma-separated string of import specifiers after removing the specified import.
+*/
+function getImportSpecifiersAfterRemoving(context, specifiers, importToRemove) {
+	return specifiers.filter((specifier) => {
+		return !(specifier.imported.name === importToRemove);
+	}).map((specifier) => {
+		return context.sourceCode.getText(specifier);
+	}).join(", ");
+}
+var getImportSpecifiersAfterRemoving_default = getImportSpecifiersAfterRemoving;
+
+//#endregion
+exports.checkCallExpression = checkCallExpression_default;
+exports.combineRestrictedImports = combineRestrictedImports_default;
+exports.createRuleSchemaFromZodSchema = createRuleSchemaFromZodSchema_default;
+exports.fixOnCondition = fixOnCondition_default;
+exports.flattenConfigs = flattenConfigs_default;
+exports.getImportSpecifiersAfterRemoving = getImportSpecifiersAfterRemoving_default;

package/dist/utility/index.d.cts

@@ -0,0 +1,208 @@
+import { TSESTree } from "@typescript-eslint/utils";
+import "typedoc";
+import "typedoc-plugin-markdown";
+import { Linter } from "eslint";
+import { JSONSchema4 } from "@typescript-eslint/utils/json-schema";
+import z from "zod";
+import { RuleContext, RuleFix, RuleFixer } from "@typescript-eslint/utils/ts-eslint";
+
+//#region src/utility/public/checkCallExpression.d.ts
+
+/**
+ * Checks if a given node matches the expected object and property names.
+ *
+ * @category Utility
+ *
+ * @param node - The node to check.
+ * @param objectName - The object name to compare against the node.
+ * @param propertyName - The property name to compare against the node.
+ *
+ * @returns A value of `true` if the given `objectName` and `propertyName` matches those of the node, and `false` otherwise.
+ */
+declare function checkCallExpression(node: TSESTree.CallExpression, objectName: string, propertyName: string): boolean;
+//#endregion
+//#region src/utility/public/NoRestrictedImportsOptions.d.ts
+interface RestrictedPathImportBase {
+  message: string;
+  name: string;
+  allowTypeImports?: boolean;
+}
+interface RestrictedPathImportImportNames extends RestrictedPathImportBase {
+  importNames: string[];
+  allowImportNames?: never;
+}
+interface RestrictedPathImportAllowImportNames extends RestrictedPathImportBase {
+  allowImportNames: string[];
+  importNames?: never;
+}
+type RestrictedPathImport = RestrictedPathImportBase | RestrictedPathImportImportNames | RestrictedPathImportAllowImportNames;
+interface RestrictedPatternImportBase {
+  caseSensitive?: boolean;
+  message: string;
+  allowTypeImports?: boolean;
+}
+interface RestrictedPatternImportGroup extends RestrictedPatternImportBase {
+  group: string[];
+  regex?: never;
+}
+interface RestrictedPatternImportRegex extends RestrictedPatternImportBase {
+  regex: string;
+  group?: never;
+}
+interface RestrictedPatternImportImportNames extends RestrictedPatternImportBase {
+  importNames: string[];
+  allowImportNames?: never;
+  importNamePattern?: never;
+  allowImportNamePattern?: never;
+}
+interface RestrictedPatternImportAllowImportNames extends RestrictedPatternImportBase {
+  importNames?: never;
+  allowImportNames: string[];
+  importNamePattern?: never;
+  allowImportNamePattern?: never;
+}
+interface RestrictedPatternImportImportNamePattern extends RestrictedPatternImportBase {
+  importNames?: never;
+  allowImportNames?: never;
+  importNamePattern: string;
+  allowImportNamePattern?: never;
+}
+interface RestrictedPatternImportAllowImportNamePattern extends RestrictedPatternImportBase {
+  importNames?: never;
+  allowImportNames?: never;
+  importNamePattern?: never;
+  allowImportNamePattern: string;
+}
+type RestrictedPatternImport = RestrictedPatternImportGroup | RestrictedPatternImportRegex | RestrictedPatternImportImportNames | RestrictedPatternImportAllowImportNames | RestrictedPatternImportImportNamePattern | RestrictedPatternImportAllowImportNamePattern;
+interface NoRestrictedImportsOptionsPathsOnly {
+  paths: RestrictedPathImport[];
+  patterns?: never;
+}
+interface NoRestrictedImportsOptionsPatternsOnly {
+  paths?: never;
+  patterns: RestrictedPatternImport[];
+}
+interface NoRestrictedImportsOptionsPathsAndPatterns {
+  paths: RestrictedPathImport[];
+  patterns: RestrictedPatternImport[];
+}
+/**
+ * Options for the built-in ESLint `no-restricted-imports` rule.
+ *
+ *  @category Rule Options
+ */
+type NoRestrictedImportsOptions = NoRestrictedImportsOptionsPathsOnly | NoRestrictedImportsOptionsPatternsOnly | NoRestrictedImportsOptionsPathsAndPatterns;
+//#endregion
+//#region src/utility/public/combineRestrictedImports.d.ts
+/**
+ * Combines multiple option groups for the native ESLint `no-restricted-imports` rule, without overwriting previous configurations.
+ *
+ * @category Utility
+ *
+ * @param groups - Option groups to combine, applied in the order provided.
+ *
+ * @returns A new object combining all paths and patterns from the given groups, suitable as an option to pass to `no-restricted-imports`.
+ */
+declare function combineRestrictedImports(...groups: NoRestrictedImportsOptions[]): NoRestrictedImportsOptions;
+//#endregion
+//#region src/utility/public/createRuleSchemaFromZodSchema.d.ts
+/**
+ * Converts a Zod schema to a JSON schema for usage in an ESLint rule.
+ *
+ * @category Utility
+ *
+ * @param schema - The Zod schema to convert.
+ *
+ * @returns An array containing the resulting JSON Schema, formatted for ESLint rule schema compatibility.
+ */
+declare function createRuleSchemaFromZodSchema(schema: z.ZodType): JSONSchema4[];
+//#endregion
+//#region src/utility/public/fixOnCondition.d.ts
+type RuleFixerFunction = (fixer: RuleFixer) => RuleFix | null;
+/**
+ * Returns a rule fixer function to run based on a given condition
+ *
+ * @category Utility
+ *
+ * @param fixable - Whether the rule should be treated as fixable or not, and therefore whether the fixer should run.
+ * @param fix - The rule fixer function to run.
+ *
+ * @returns The rule fixer function invoked with the fixer, provided the fixable condition is met.
+ */
+declare function fixOnCondition(fixable: boolean, fix: RuleFixerFunction): RuleFixerFunction;
+//#endregion
+//#region src/utility/private/camelToKebab.d.ts
+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
+/**
+ * A helper type to turn the keys of a doubly-nested object into a flattened ESLint config key.
+ *
+ * @category Utility
+ *
+ * @example
+ * ```typescript
+ * type ConfigNames = GetFlattenedConfigNames<{ general: { typescriptReact }}> // "general/typescript-react"
+ * ```
+ */
+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/utility/public/flattenConfigs.d.ts
+/**
+ * Takes in a nested group of configs, and returns them flattened according to ESLint config naming conventions.
+ *
+ * @category Utility
+ *
+ * @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.
+ *
+ * Useful for auto-fixable rules that remove a specific import from an import statement.
+ *
+ * @category Utility
+ *
+ * @template RuleOptions - The type of the RuleOptions from the given context.
+ *
+ * @param context - The current ESLint rule context.
+ * @param specifiers - Array of import clause nodes.
+ * @param importToRemove - The import name to remove from the list.
+ *
+ * @returns A comma-separated string of import specifiers after removing the specified import.
+ */
+declare function getImportSpecifiersAfterRemoving<RuleOptions>(context: Readonly<RuleContext<"message", [RuleOptions]>>, specifiers: TSESTree.ImportClause[], importToRemove: string): string;
+//#endregion
+export { type GetFlattenedConfigNames, type NoRestrictedImportsOptions, checkCallExpression, combineRestrictedImports, createRuleSchemaFromZodSchema, fixOnCondition, flattenConfigs, getImportSpecifiersAfterRemoving };

package/dist/utility/index.d.ts

@@ -0,0 +1,208 @@
+import { TSESTree } from "@typescript-eslint/utils";
+import z from "zod";
+import "typedoc";
+import "typedoc-plugin-markdown";
+import { Linter } from "eslint";
+import { JSONSchema4 } from "@typescript-eslint/utils/json-schema";
+import { RuleContext, RuleFix, RuleFixer } from "@typescript-eslint/utils/ts-eslint";
+
+//#region src/utility/public/checkCallExpression.d.ts
+
+/**
+ * Checks if a given node matches the expected object and property names.
+ *
+ * @category Utility
+ *
+ * @param node - The node to check.
+ * @param objectName - The object name to compare against the node.
+ * @param propertyName - The property name to compare against the node.
+ *
+ * @returns A value of `true` if the given `objectName` and `propertyName` matches those of the node, and `false` otherwise.
+ */
+declare function checkCallExpression(node: TSESTree.CallExpression, objectName: string, propertyName: string): boolean;
+//#endregion
+//#region src/utility/public/NoRestrictedImportsOptions.d.ts
+interface RestrictedPathImportBase {
+  message: string;
+  name: string;
+  allowTypeImports?: boolean;
+}
+interface RestrictedPathImportImportNames extends RestrictedPathImportBase {
+  importNames: string[];
+  allowImportNames?: never;
+}
+interface RestrictedPathImportAllowImportNames extends RestrictedPathImportBase {
+  allowImportNames: string[];
+  importNames?: never;
+}
+type RestrictedPathImport = RestrictedPathImportBase | RestrictedPathImportImportNames | RestrictedPathImportAllowImportNames;
+interface RestrictedPatternImportBase {
+  caseSensitive?: boolean;
+  message: string;
+  allowTypeImports?: boolean;
+}
+interface RestrictedPatternImportGroup extends RestrictedPatternImportBase {
+  group: string[];
+  regex?: never;
+}
+interface RestrictedPatternImportRegex extends RestrictedPatternImportBase {
+  regex: string;
+  group?: never;
+}
+interface RestrictedPatternImportImportNames extends RestrictedPatternImportBase {
+  importNames: string[];
+  allowImportNames?: never;
+  importNamePattern?: never;
+  allowImportNamePattern?: never;
+}
+interface RestrictedPatternImportAllowImportNames extends RestrictedPatternImportBase {
+  importNames?: never;
+  allowImportNames: string[];
+  importNamePattern?: never;
+  allowImportNamePattern?: never;
+}
+interface RestrictedPatternImportImportNamePattern extends RestrictedPatternImportBase {
+  importNames?: never;
+  allowImportNames?: never;
+  importNamePattern: string;
+  allowImportNamePattern?: never;
+}
+interface RestrictedPatternImportAllowImportNamePattern extends RestrictedPatternImportBase {
+  importNames?: never;
+  allowImportNames?: never;
+  importNamePattern?: never;
+  allowImportNamePattern: string;
+}
+type RestrictedPatternImport = RestrictedPatternImportGroup | RestrictedPatternImportRegex | RestrictedPatternImportImportNames | RestrictedPatternImportAllowImportNames | RestrictedPatternImportImportNamePattern | RestrictedPatternImportAllowImportNamePattern;
+interface NoRestrictedImportsOptionsPathsOnly {
+  paths: RestrictedPathImport[];
+  patterns?: never;
+}
+interface NoRestrictedImportsOptionsPatternsOnly {
+  paths?: never;
+  patterns: RestrictedPatternImport[];
+}
+interface NoRestrictedImportsOptionsPathsAndPatterns {
+  paths: RestrictedPathImport[];
+  patterns: RestrictedPatternImport[];
+}
+/**
+ * Options for the built-in ESLint `no-restricted-imports` rule.
+ *
+ *  @category Rule Options
+ */
+type NoRestrictedImportsOptions = NoRestrictedImportsOptionsPathsOnly | NoRestrictedImportsOptionsPatternsOnly | NoRestrictedImportsOptionsPathsAndPatterns;
+//#endregion
+//#region src/utility/public/combineRestrictedImports.d.ts
+/**
+ * Combines multiple option groups for the native ESLint `no-restricted-imports` rule, without overwriting previous configurations.
+ *
+ * @category Utility
+ *
+ * @param groups - Option groups to combine, applied in the order provided.
+ *
+ * @returns A new object combining all paths and patterns from the given groups, suitable as an option to pass to `no-restricted-imports`.
+ */
+declare function combineRestrictedImports(...groups: NoRestrictedImportsOptions[]): NoRestrictedImportsOptions;
+//#endregion
+//#region src/utility/public/createRuleSchemaFromZodSchema.d.ts
+/**
+ * Converts a Zod schema to a JSON schema for usage in an ESLint rule.
+ *
+ * @category Utility
+ *
+ * @param schema - The Zod schema to convert.
+ *
+ * @returns An array containing the resulting JSON Schema, formatted for ESLint rule schema compatibility.
+ */
+declare function createRuleSchemaFromZodSchema(schema: z.ZodType): JSONSchema4[];
+//#endregion
+//#region src/utility/public/fixOnCondition.d.ts
+type RuleFixerFunction = (fixer: RuleFixer) => RuleFix | null;
+/**
+ * Returns a rule fixer function to run based on a given condition
+ *
+ * @category Utility
+ *
+ * @param fixable - Whether the rule should be treated as fixable or not, and therefore whether the fixer should run.
+ * @param fix - The rule fixer function to run.
+ *
+ * @returns The rule fixer function invoked with the fixer, provided the fixable condition is met.
+ */
+declare function fixOnCondition(fixable: boolean, fix: RuleFixerFunction): RuleFixerFunction;
+//#endregion
+//#region src/utility/private/camelToKebab.d.ts
+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
+/**
+ * A helper type to turn the keys of a doubly-nested object into a flattened ESLint config key.
+ *
+ * @category Utility
+ *
+ * @example
+ * ```typescript
+ * type ConfigNames = GetFlattenedConfigNames<{ general: { typescriptReact }}> // "general/typescript-react"
+ * ```
+ */
+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/utility/public/flattenConfigs.d.ts
+/**
+ * Takes in a nested group of configs, and returns them flattened according to ESLint config naming conventions.
+ *
+ * @category Utility
+ *
+ * @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.
+ *
+ * Useful for auto-fixable rules that remove a specific import from an import statement.
+ *
+ * @category Utility
+ *
+ * @template RuleOptions - The type of the RuleOptions from the given context.
+ *
+ * @param context - The current ESLint rule context.
+ * @param specifiers - Array of import clause nodes.
+ * @param importToRemove - The import name to remove from the list.
+ *
+ * @returns A comma-separated string of import specifiers after removing the specified import.
+ */
+declare function getImportSpecifiersAfterRemoving<RuleOptions>(context: Readonly<RuleContext<"message", [RuleOptions]>>, specifiers: TSESTree.ImportClause[], importToRemove: string): string;
+//#endregion
+export { type GetFlattenedConfigNames, type NoRestrictedImportsOptions, checkCallExpression, combineRestrictedImports, createRuleSchemaFromZodSchema, fixOnCondition, flattenConfigs, getImportSpecifiersAfterRemoving };