@alextheman/eslint-plugin 5.7.0 → 5.8.0

package/dist/index.cjs

@@ -58,9 +58,9 @@ let eslint_plugin_react_hooks = require("eslint-plugin-react-hooks");
 eslint_plugin_react_hooks = __toESM(eslint_plugin_react_hooks);
 let eslint_plugin_package_json = require("eslint-plugin-package-json");
 eslint_plugin_package_json = __toESM(eslint_plugin_package_json);
-let _eslint_compat = require("@eslint/compat");
 let eslint_plugin_jsdoc = require("eslint-plugin-jsdoc");
 eslint_plugin_jsdoc = __toESM(eslint_plugin_jsdoc);
+let _alextheman_utility_node = require("@alextheman/utility/node");
 
 //#region node_modules/.pnpm/globals@17.3.0/node_modules/globals/globals.json
 var require_globals$1 = /* @__PURE__ */ __commonJSMin(((exports, module) => {
@@ -4087,7 +4087,6 @@ var require_globals = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 
 //#endregion
 //#region src/configs/helpers/restrictedImports/generalRestrictedImports.ts
-var import_globals = /* @__PURE__ */ __toESM(require_globals(), 1);
 const generalRestrictedImports = { patterns: [{
 	group: ["node_modules"],
 	message: "Do not import directly from node_modules."
@@ -4174,7 +4173,7 @@ function fixOnCondition(fixable, fix) {
 //#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.");
+	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 });
 }
 
@@ -4265,6 +4264,7 @@ const testsRestrictedImports = combineRestrictedImports(generalRestrictedImports
 
 //#endregion
 //#region src/configs/internal/tests.ts
+var import_globals = /* @__PURE__ */ __toESM(require_globals(), 1);
 const internalTests = [{
 	files: ["**/*.test.{js,ts}"],
 	languageOptions: { globals: {
@@ -4756,7 +4756,7 @@ const generalPackageJson = [eslint_plugin_package_json.default.configs.recommend
 //#endregion
 //#region src/configs/general/typeScript.ts
 const generalTypeScript = [
-	...(0, _eslint_compat.fixupConfigRules)(typescript_eslint.default.configs.recommended),
+	...typescript_eslint.default.configs.recommended,
 	...generalJavaScript,
 	{
 		files: ["**/*.ts", "**/*.tsx"],
@@ -4926,7 +4926,7 @@ function internalTypeScript(plugin) {
 		name: "@alextheman/internal/typescript",
 		plugins: {
 			"@alextheman": plugin,
-			"@typescript-eslint": (0, _eslint_compat.fixupPluginRules)(typescript_eslint.default.plugin)
+			"@typescript-eslint": typescript_eslint.default.plugin
 		},
 		rules: {
 			"@alextheman/standardise-error-messages": "error",
@@ -4940,22 +4940,6 @@ function internalTypeScript(plugin) {
 	}];
 }
 
-//#endregion
-//#region src/configs/internal/utility.ts
-function internalUtility(plugin) {
-	return [...combinedTypeScriptPackage(plugin), {
-		name: "@alextheman/internal/utility",
-		plugins: {
-			"@typescript-eslint": (0, _eslint_compat.fixupPluginRules)(typescript_eslint.default.plugin),
-			jsdoc: eslint_plugin_jsdoc.default
-		},
-		rules: {
-			"@typescript-eslint/explicit-module-boundary-types": "error",
-			"jsdoc/require-jsdoc": ["error", requireJsdocOptions]
-		}
-	}];
-}
-
 //#endregion
 //#region src/configs/helpers/restrictedImports/eslintPluginRestrictedImports.ts
 const eslintPluginRestrictedImports = combineRestrictedImports(generalRestrictedImports, { paths: [
@@ -5031,6 +5015,37 @@ function internalEslintPluginUtility(plugin) {
 	}];
 }
 
+//#endregion
+//#region src/configs/internal/utility/base.ts
+function internalUtilityBase(plugin) {
+	return [...combinedTypeScriptPackage(plugin), {
+		name: "@alextheman/internal/utility",
+		plugins: {
+			"@typescript-eslint": typescript_eslint.default.plugin,
+			jsdoc: eslint_plugin_jsdoc.default
+		},
+		rules: {
+			"@typescript-eslint/explicit-module-boundary-types": "error",
+			"jsdoc/require-jsdoc": ["error", requireJsdocOptions]
+		}
+	}];
+}
+
+//#endregion
+//#region src/configs/internal/utility/internal.ts
+function internalUtilityRoot$1(plugin) {
+	return [...internalUtilityBase(plugin), { rules: { "jsdoc/require-jsdoc": "off" } }];
+}
+
+//#endregion
+//#region src/configs/internal/utility/root.ts
+function internalUtilityRoot(plugin) {
+	return [...internalUtilityBase(plugin), { rules: { "no-restricted-imports": ["error", combineRestrictedImports(personalRestrictedImports, { patterns: [{
+		group: ["node:"],
+		message: "Do not import node builtins from the root of utility. Please either refactor the usage so that the node builtin is not needed, or move this over to the \"@alextheman/utility/node\" entrypoint."
+	}] })] } }];
+}
+
 //#endregion
 //#region src/configs/combined/typeScript.ts
 function combinedTypeScript(plugin) {
@@ -5096,7 +5111,9 @@ function createAlexPluginConfigs(plugin) {
 			react: internalReact,
 			tests: internalTests,
 			typescript: internalTypeScript(plugin),
-			utility: internalUtility(plugin)
+			utilityBase: internalUtilityBase(plugin),
+			utilityInternal: internalUtilityRoot$1(plugin),
+			utilityRoot: internalUtilityRoot(plugin)
 		},
 		plugin: {
 			base: pluginBase(plugin),
@@ -5434,7 +5451,7 @@ const useNormalizedImports = createRule({
 	create(context) {
 		const { fixable = true } = parseUseNormalizedImportsOptions(context.options[0] ?? { fixable: true });
 		return { ImportDeclaration(node) {
-			const normalizedPath = (0, _alextheman_utility.normalizeImportPath)(node.source.value);
+			const normalizedPath = (0, _alextheman_utility_node.normalizeImportPath)(node.source.value);
 			if (node.source.value !== normalizedPath) return context.report({
 				node,
 				messageId: "pathNotNormalized",
@@ -5500,7 +5517,7 @@ var rules_default = {
 //#endregion
 //#region package.json
 var name = "@alextheman/eslint-plugin";
-var version = "5.7.0";
+var version = "5.8.0";
 
 //#endregion
 //#region src/alexPlugin.ts

package/dist/index.d.cts

@@ -28,7 +28,7 @@ type GetFlattenedConfigNames<ConfigObject extends { [K in keyof ConfigObject]: R
 //#region src/configs/AlexPluginConfigGroup.d.ts
 type GeneralConfig = "javascript" | "typescript" | "react" | "packageJson";
 type PluginConfig = "base" | "tests";
-type InternalConfig = "javascript" | "typescript" | "react" | "tests" | "eslintPluginBase" | "eslintPluginConfigs" | "eslintPluginRules" | "eslintPluginUtility" | "neurosongsBackEnd" | "neurosongsFrontEnd" | "utility" | "alexCLine" | "jsdoc" | "components";
+type InternalConfig = "javascript" | "typescript" | "react" | "tests" | "eslintPluginBase" | "eslintPluginConfigs" | "eslintPluginRules" | "eslintPluginUtility" | "neurosongsBackEnd" | "neurosongsFrontEnd" | "utilityBase" | "utilityRoot" | "utilityInternal" | "alexCLine" | "jsdoc" | "components";
 type CombinedConfig = "javascript" | "typescript" | "react" | "tests" | "typescriptReact" | "javascriptReact" | "typescriptPackage";
 interface AlexPluginConfigObject {
   general: Record<GeneralConfig, Linter.Config[]>;

package/dist/index.d.ts

@@ -28,7 +28,7 @@ type GetFlattenedConfigNames<ConfigObject extends { [K in keyof ConfigObject]: R
 //#region src/configs/AlexPluginConfigGroup.d.ts
 type GeneralConfig = "javascript" | "typescript" | "react" | "packageJson";
 type PluginConfig = "base" | "tests";
-type InternalConfig = "javascript" | "typescript" | "react" | "tests" | "eslintPluginBase" | "eslintPluginConfigs" | "eslintPluginRules" | "eslintPluginUtility" | "neurosongsBackEnd" | "neurosongsFrontEnd" | "utility" | "alexCLine" | "jsdoc" | "components";
+type InternalConfig = "javascript" | "typescript" | "react" | "tests" | "eslintPluginBase" | "eslintPluginConfigs" | "eslintPluginRules" | "eslintPluginUtility" | "neurosongsBackEnd" | "neurosongsFrontEnd" | "utilityBase" | "utilityRoot" | "utilityInternal" | "alexCLine" | "jsdoc" | "components";
 type CombinedConfig = "javascript" | "typescript" | "react" | "tests" | "typescriptReact" | "javascriptReact" | "typescriptPackage";
 interface AlexPluginConfigObject {
   general: Record<GeneralConfig, Linter.Config[]>;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { DataError, camelToKebab, deepCopy, deepFreeze, normalizeImportPath, omitProperties } from "@alextheman/utility";
+import { DataError, camelToKebab, deepCopy, deepFreeze, omitProperties } from "@alextheman/utility";
 import { AST_NODE_TYPES, ESLintUtils } from "@typescript-eslint/utils";
 import z from "zod";
 import js from "@eslint/js";
@@ -15,8 +15,8 @@ import reactPlugin from "eslint-plugin-react";
 import reactRefresh from "eslint-plugin-react-refresh";
 import reactHooksPlugin from "eslint-plugin-react-hooks";
 import packageJson from "eslint-plugin-package-json";
-import { fixupConfigRules, fixupPluginRules } from "@eslint/compat";
 import jsdoc from "eslint-plugin-jsdoc";
+import { normalizeImportPath } from "@alextheman/utility/node";
 
 //#region \0rolldown/runtime.js
 var __create = Object.create;
@@ -4071,7 +4071,6 @@ var require_globals = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 
 //#endregion
 //#region src/configs/helpers/restrictedImports/generalRestrictedImports.ts
-var import_globals = /* @__PURE__ */ __toESM(require_globals(), 1);
 const generalRestrictedImports = { patterns: [{
 	group: ["node_modules"],
 	message: "Do not import directly from node_modules."
@@ -4158,7 +4157,7 @@ function fixOnCondition(fixable, fix) {
 //#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.");
+	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 });
 }
 
@@ -4249,6 +4248,7 @@ const testsRestrictedImports = combineRestrictedImports(generalRestrictedImports
 
 //#endregion
 //#region src/configs/internal/tests.ts
+var import_globals = /* @__PURE__ */ __toESM(require_globals(), 1);
 const internalTests = [{
 	files: ["**/*.test.{js,ts}"],
 	languageOptions: { globals: {
@@ -4740,7 +4740,7 @@ const generalPackageJson = [packageJson.configs.recommended, {
 //#endregion
 //#region src/configs/general/typeScript.ts
 const generalTypeScript = [
-	...fixupConfigRules(tseslint.configs.recommended),
+	...tseslint.configs.recommended,
 	...generalJavaScript,
 	{
 		files: ["**/*.ts", "**/*.tsx"],
@@ -4910,7 +4910,7 @@ function internalTypeScript(plugin) {
 		name: "@alextheman/internal/typescript",
 		plugins: {
 			"@alextheman": plugin,
-			"@typescript-eslint": fixupPluginRules(tseslint.plugin)
+			"@typescript-eslint": tseslint.plugin
 		},
 		rules: {
 			"@alextheman/standardise-error-messages": "error",
@@ -4924,22 +4924,6 @@ function internalTypeScript(plugin) {
 	}];
 }
 
-//#endregion
-//#region src/configs/internal/utility.ts
-function internalUtility(plugin) {
-	return [...combinedTypeScriptPackage(plugin), {
-		name: "@alextheman/internal/utility",
-		plugins: {
-			"@typescript-eslint": fixupPluginRules(tseslint.plugin),
-			jsdoc
-		},
-		rules: {
-			"@typescript-eslint/explicit-module-boundary-types": "error",
-			"jsdoc/require-jsdoc": ["error", requireJsdocOptions]
-		}
-	}];
-}
-
 //#endregion
 //#region src/configs/helpers/restrictedImports/eslintPluginRestrictedImports.ts
 const eslintPluginRestrictedImports = combineRestrictedImports(generalRestrictedImports, { paths: [
@@ -5015,6 +4999,37 @@ function internalEslintPluginUtility(plugin) {
 	}];
 }
 
+//#endregion
+//#region src/configs/internal/utility/base.ts
+function internalUtilityBase(plugin) {
+	return [...combinedTypeScriptPackage(plugin), {
+		name: "@alextheman/internal/utility",
+		plugins: {
+			"@typescript-eslint": tseslint.plugin,
+			jsdoc
+		},
+		rules: {
+			"@typescript-eslint/explicit-module-boundary-types": "error",
+			"jsdoc/require-jsdoc": ["error", requireJsdocOptions]
+		}
+	}];
+}
+
+//#endregion
+//#region src/configs/internal/utility/internal.ts
+function internalUtilityRoot$1(plugin) {
+	return [...internalUtilityBase(plugin), { rules: { "jsdoc/require-jsdoc": "off" } }];
+}
+
+//#endregion
+//#region src/configs/internal/utility/root.ts
+function internalUtilityRoot(plugin) {
+	return [...internalUtilityBase(plugin), { rules: { "no-restricted-imports": ["error", combineRestrictedImports(personalRestrictedImports, { patterns: [{
+		group: ["node:"],
+		message: "Do not import node builtins from the root of utility. Please either refactor the usage so that the node builtin is not needed, or move this over to the \"@alextheman/utility/node\" entrypoint."
+	}] })] } }];
+}
+
 //#endregion
 //#region src/configs/combined/typeScript.ts
 function combinedTypeScript(plugin) {
@@ -5080,7 +5095,9 @@ function createAlexPluginConfigs(plugin) {
 			react: internalReact,
 			tests: internalTests,
 			typescript: internalTypeScript(plugin),
-			utility: internalUtility(plugin)
+			utilityBase: internalUtilityBase(plugin),
+			utilityInternal: internalUtilityRoot$1(plugin),
+			utilityRoot: internalUtilityRoot(plugin)
 		},
 		plugin: {
 			base: pluginBase(plugin),
@@ -5484,7 +5501,7 @@ var rules_default = {
 //#endregion
 //#region package.json
 var name = "@alextheman/eslint-plugin";
-var version = "5.7.0";
+var version = "5.8.0";
 
 //#endregion
 //#region src/alexPlugin.ts

package/dist/utility/index.cjs

@@ -111,7 +111,7 @@ function fixOnCondition(fixable, fix) {
 //#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.");
+	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 });
 }
 

package/dist/utility/index.js

@@ -82,7 +82,7 @@ function fixOnCondition(fixable, fix) {
 //#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.");
+	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 });
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/eslint-plugin",
-  "version": "5.7.0",
+  "version": "5.8.0",
   "description": "A package to provide custom ESLint rules and configs.",
   "repository": {
     "type": "git",
@@ -9,6 +9,7 @@
   "license": "MIT",
   "author": "alextheman",
   "type": "module",
+  "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -29,10 +30,10 @@
     "dist"
   ],
   "dependencies": {
-    "@alextheman/utility": "^4.13.0",
+    "@alextheman/utility": "^5.1.3",
     "@eslint/compat": "^2.0.2",
-    "@typescript-eslint/types": "^8.54.0",
-    "@typescript-eslint/utils": "^8.54.0",
+    "@typescript-eslint/types": "^8.56.0",
+    "@typescript-eslint/utils": "^8.56.0",
     "common-tags": "^1.8.2",
     "prettier": "^3.8.1",
     "zod": "^4.3.6"
@@ -42,19 +43,19 @@
     "@types/common-tags": "^1.8.4",
     "@types/eslint": "^9.6.1",
     "@types/eslint-plugin-jsx-a11y": "^6.10.1",
-    "@types/node": "^25.2.1",
-    "@typescript-eslint/rule-tester": "^8.54.0",
-    "alex-c-line": "^1.23.1",
+    "@types/node": "^25.3.0",
+    "@typescript-eslint/rule-tester": "^8.56.0",
+    "alex-c-line": "^1.28.0",
     "dotenv-cli": "^11.0.0",
-    "eslint": "^10.0.0",
+    "eslint": "^10.0.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jsdoc": "^62.5.3",
+    "eslint-plugin-jsdoc": "^62.7.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
-    "eslint-plugin-n": "^17.23.2",
-    "eslint-plugin-package-json": "^0.88.2",
-    "eslint-plugin-perfectionist": "^5.5.0",
+    "eslint-plugin-n": "^17.24.0",
+    "eslint-plugin-package-json": "^0.89.0",
+    "eslint-plugin-perfectionist": "^5.6.0",
     "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.0.1",
@@ -62,15 +63,15 @@
     "eslint-vitest-rule-tester": "^3.1.0",
     "globals": "^17.3.0",
     "husky": "^9.1.7",
-    "jsdom": "^28.0.0",
+    "jsdom": "^28.1.0",
     "tsdown": "^0.20.3",
     "tsx": "^4.21.0",
-    "typedoc": "^0.28.16",
+    "typedoc": "^0.28.17",
     "typedoc-plugin-markdown": "^4.10.0",
     "typedoc-rhineai-theme": "^1.2.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.54.0",
-    "vite-tsconfig-paths": "^6.0.5",
+    "typescript-eslint": "^8.56.0",
+    "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^4.0.18"
   },
   "peerDependencies": {