@slango.configs/eslint 1.0.30 → 1.1.0

package/.turbo/turbo-lint.log

@@ -1,4 +1,4 @@
 
-> @slango.configs/eslint@1.0.30 lint /home/runner/work/slango/slango/configs/eslint
+> @slango.configs/eslint@1.1.0 lint /home/runner/work/slango/slango/configs/eslint
 > eslint . --max-warnings 0
 

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @slango.configs/eslint
 
+## 1.1.0
+
+### Minor Changes
+
+- ce8f03a: feat: allow configurable perfectionist rule strictness levels via options object with validation.
+
+## 1.0.31
+
+### Patch Changes
+
+- 450ff4b: Dependencies bump
+
 ## 1.0.30
 
 ### Patch Changes

package/README.md

@@ -34,6 +34,23 @@ Unless you want to override the default configuration, you can simply extend the
 export { default } from '@slango.configs/eslint/{preset-you-wish-to-use}.js';
 ```
 
+### Perfectionist rule strictness
+
+Perfectionist sorting rules can be configured with three levels of strictness:
+
+- `off` – disables all perfectionist sorting rules
+- `relaxed` – only enforces module sorting (default)
+- `strict` – enforces sorting for modules, enums, object types and objects
+
+To use a custom level, import the corresponding creator and pass an options object. Passing an unknown option or an invalid level throws an error:
+
+```js
+// eslint.config.js
+import { createTypescriptConfig } from '@slango.configs/eslint/typescript.js';
+
+export default createTypescriptConfig({ perfectionist: 'strict' });
+```
+
 ## Things to take into account (and possibly review)
 
 - At the time of writing eslint-config-next is not compatible with eslint 9, thus @eslint/compat and @eslint/eslintrc are used

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slango.configs/eslint",
-  "version": "1.0.30",
+  "version": "1.1.0",
   "private": false,
   "description": "Slango eslint configs",
   "type": "module",
@@ -12,8 +12,8 @@
     "@eslint/compat": "1.3.2",
     "@eslint/eslintrc": "3.3.1",
     "@eslint/js": "9.33.0",
-    "@next/eslint-plugin-next": "15.4.6",
-    "eslint-config-next": "15.4.6",
+    "@next/eslint-plugin-next": "15.4.7",
+    "eslint-config-next": "15.4.7",
     "eslint-config-prettier": "10.1.8",
     "eslint-import-resolver-typescript": "4.4.4",
     "eslint-plugin-import-x": "4.16.1",
@@ -23,7 +23,7 @@
     "eslint-plugin-react-refresh": "0.4.20",
     "eslint-plugin-regexp": "2.10.0",
     "globals": "16.3.0",
-    "typescript-eslint": "8.39.1"
+    "typescript-eslint": "8.40.0"
   },
   "peerDependencies": {
     "eslint": "^9.33.0"

package/src/common.js

@@ -23,11 +23,55 @@ export const commonConfigs = (files) =>
     regexPluginConfigs['flat/recommended'],
   ].map((config) => ({ ...config, files }));
 
-export const commonRules = {
-  'perfectionist/sort-enums': 'off',
-  'perfectionist/sort-modules': ['error', { partitionByNewLine: true }],
-  'perfectionist/sort-object-types': 'off',
-  'perfectionist/sort-objects': 'off',
+const sortModulesRule = ['error', { partitionByNewLine: true }];
+
+export const perfectionistLevels = {
+  off: {
+    'perfectionist/sort-enums': 'off',
+    'perfectionist/sort-modules': 'off',
+    'perfectionist/sort-object-types': 'off',
+    'perfectionist/sort-objects': 'off',
+  },
+  relaxed: {
+    'perfectionist/sort-enums': 'off',
+    'perfectionist/sort-modules': sortModulesRule,
+    'perfectionist/sort-object-types': 'off',
+    'perfectionist/sort-objects': 'off',
+  },
+  strict: {
+    'perfectionist/sort-enums': 'error',
+    'perfectionist/sort-modules': sortModulesRule,
+    'perfectionist/sort-object-types': 'error',
+    'perfectionist/sort-objects': 'error',
+  },
+};
+
+const defaultOptions = { perfectionist: 'relaxed' };
+
+export const normalizeOptions = (options = {}) => {
+  if (options === null || typeof options !== 'object' || Array.isArray(options)) {
+    throw new Error('options must be an object');
+  }
+
+  const { perfectionist = defaultOptions.perfectionist, ...rest } = options;
+
+  if (!Object.hasOwn(perfectionistLevels, perfectionist)) {
+    throw new Error(
+      `Invalid perfectionist level "${perfectionist}". Expected one of: ${Object.keys(perfectionistLevels).join(', ')}`,
+    );
+  }
+
+  const unknown = Object.keys(rest);
+  if (unknown.length > 0) {
+    throw new Error(`Unknown option(s): ${unknown.join(', ')}`);
+  }
+
+  return { perfectionist };
+};
+
+export const commonRules = (options) => {
+  const { perfectionist } = normalizeOptions(options);
+  return perfectionistLevels[perfectionist];
 };
 
 export const typescriptConfigs = (files) => [

package/src/presets/javascript-node.js

@@ -1,35 +1,43 @@
 import globals from 'globals';
 
-import { commonConfigs, commonRules, globs, ignorePatterns } from '../common.js';
+import { commonConfigs, commonRules, globs, ignorePatterns, normalizeOptions } from '../common.js';
 
-export const baseJavascriptConfig = {
-  files: [globs.javascript],
-  languageOptions: {
-    globals: {
-      ...globals.node,
+export const baseJavascriptConfig = (options = {}) => {
+  const opts = normalizeOptions(options);
+  return {
+    files: [globs.javascript],
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+      parserOptions: {
+        ecmaVersion: 'latest',
+      },
     },
-    parserOptions: {
-      ecmaVersion: 'latest',
+    name: '@slango.configs/eslint/javascript-node',
+    rules: {
+      'import-x/first': 'error',
+      'import-x/no-anonymous-default-export': 'error',
+      ...commonRules(opts),
     },
-  },
-  name: '@slango.configs/eslint/javascript-node',
-  rules: {
-    'import-x/first': 'error',
-    'import-x/no-anonymous-default-export': 'error',
-    ...commonRules,
-  },
-  settings: {
-    //  eslint-import-resolver-node does not seem to play well with monorepo/pattern exports
-    'import-x/resolver': {
-      typescript: true,
+    settings: {
+      //  eslint-import-resolver-node does not seem to play well with monorepo/pattern exports
+      'import-x/resolver': {
+        typescript: true,
+      },
     },
-  },
+  };
 };
 
-const javascriptNode = [
-  ...commonConfigs(globs.javascript),
-  baseJavascriptConfig,
-  { ignores: ignorePatterns },
-];
+export const createJavascriptNodeConfig = (options = {}) => {
+  const opts = normalizeOptions(options);
+  return [
+    ...commonConfigs(globs.javascript),
+    baseJavascriptConfig(opts),
+    { ignores: ignorePatterns },
+  ];
+};
+
+const javascriptNode = createJavascriptNodeConfig();
 
 export default javascriptNode;

package/src/presets/typescript-browser.js

@@ -1,27 +1,39 @@
 import globals from 'globals';
 import tsEslint from 'typescript-eslint';
 
-import { globs, typescriptConfigs } from '../common.js';
-import javascriptNode from './javascript-node.js';
+import { globs, normalizeOptions, typescriptConfigs } from '../common.js';
+import { createJavascriptNodeConfig } from './javascript-node.js';
 import { baseTypescriptConfig } from './typescript.js';
 
-export const browserTypescriptBrowserConfig = {
-  ...baseTypescriptConfig,
-  languageOptions: {
-    ...baseTypescriptConfig.languageOptions,
-    ecmaVersion: 2022,
-    globals: {
-      ...baseTypescriptConfig.languageOptions.globals,
-      ...globals['2022'],
-      ...globals.browser,
+export const browserTypescriptBrowserConfig = (options = {}) => {
+  const opts = normalizeOptions(options);
+  const base = baseTypescriptConfig(opts);
+  return {
+    ...base,
+    languageOptions: {
+      ...base.languageOptions,
+      ecmaVersion: 2022,
+      globals: {
+        ...base.languageOptions.globals,
+        ...globals['2022'],
+        ...globals.browser,
+      },
     },
-  },
-  name: '@slango.configs/eslint/typescript-browser',
+    name: '@slango.configs/eslint/typescript-browser',
+  };
 };
 
-const typescriptBrowserConfig = [
-  ...javascriptNode,
-  ...tsEslint.config(...typescriptConfigs(globs.typescript), browserTypescriptBrowserConfig),
-];
+export const createTypescriptBrowserConfig = (options = {}) => {
+  const opts = normalizeOptions(options);
+  return [
+    ...createJavascriptNodeConfig(opts),
+    ...tsEslint.config(
+      ...typescriptConfigs(globs.typescript),
+      browserTypescriptBrowserConfig(opts),
+    ),
+  ];
+};
+
+const typescriptBrowserConfig = createTypescriptBrowserConfig();
 
 export default typescriptBrowserConfig;

package/src/presets/typescript-isomorphic.js

@@ -1,25 +1,37 @@
 import globals from 'globals';
 import tsEslint from 'typescript-eslint';
 
-import { globs, typescriptConfigs } from '../common.js';
-import javascriptNode from './javascript-node.js';
+import { globs, normalizeOptions, typescriptConfigs } from '../common.js';
+import { createJavascriptNodeConfig } from './javascript-node.js';
 import { browserTypescriptBrowserConfig } from './typescript-browser.js';
 
-export const isomorphicTypescriptBrowserConfig = {
-  ...browserTypescriptBrowserConfig,
-  languageOptions: {
-    ...browserTypescriptBrowserConfig.languageOptions,
-    globals: {
-      ...browserTypescriptBrowserConfig.languageOptions.globals,
-      ...globals.node,
+export const isomorphicTypescriptBrowserConfig = (options = {}) => {
+  const opts = normalizeOptions(options);
+  const browserConfig = browserTypescriptBrowserConfig(opts);
+  return {
+    ...browserConfig,
+    languageOptions: {
+      ...browserConfig.languageOptions,
+      globals: {
+        ...browserConfig.languageOptions.globals,
+        ...globals.node,
+      },
     },
-  },
-  name: '@slango.configs/eslint/typescript-isomorphic',
+    name: '@slango.configs/eslint/typescript-isomorphic',
+  };
 };
 
-const typescriptIsomorphicConfig = [
-  ...javascriptNode,
-  ...tsEslint.config(...typescriptConfigs(globs.typescript), isomorphicTypescriptBrowserConfig),
-];
+export const createTypescriptIsomorphicConfig = (options = {}) => {
+  const opts = normalizeOptions(options);
+  return [
+    ...createJavascriptNodeConfig(opts),
+    ...tsEslint.config(
+      ...typescriptConfigs(globs.typescript),
+      isomorphicTypescriptBrowserConfig(opts),
+    ),
+  ];
+};
+
+const typescriptIsomorphicConfig = createTypescriptIsomorphicConfig();
 
 export default typescriptIsomorphicConfig;

package/src/presets/typescript-next.js

@@ -5,9 +5,9 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import tsEslint from 'typescript-eslint';
 
-import { globs, typescriptConfigs } from '../common.js';
+import { globs, normalizeOptions, typescriptConfigs } from '../common.js';
 import { getTsConfigFile } from '../utils.js';
-import javascriptNode from './javascript-node.js';
+import { createJavascriptNodeConfig } from './javascript-node.js';
 import { browserTypescriptBrowserConfig } from './typescript-browser.js';
 
 const project = getTsConfigFile();
@@ -31,26 +31,33 @@ const patchedConfig = fixupConfigRules([...compat.extends('next/core-web-vitals'
   }),
 );
 
-const typescriptNextConfig = [
-  ...javascriptNode,
-  ...tsEslint.config(
-    ...typescriptConfigs(globs.typescript),
-    {
-      ...browserTypescriptBrowserConfig,
-      languageOptions: {
-        ...browserTypescriptBrowserConfig.languageOptions,
-        globals: {
-          ...browserTypescriptBrowserConfig.languageOptions.globals,
-          process: true,
-          NodeJS: 'readonly',
+export const createTypescriptNextConfig = (options = {}) => {
+  const opts = normalizeOptions(options);
+  const browserConfig = browserTypescriptBrowserConfig(opts);
+
+  return [
+    ...createJavascriptNodeConfig(opts),
+    ...tsEslint.config(
+      ...typescriptConfigs(globs.typescript),
+      {
+        ...browserConfig,
+        languageOptions: {
+          ...browserConfig.languageOptions,
+          globals: {
+            ...browserConfig.languageOptions.globals,
+            process: true,
+            NodeJS: 'readonly',
+          },
         },
       },
-    },
-    ...patchedConfig,
-    {
-      ignores: ['.next/*'],
-    },
-  ),
-];
+      ...patchedConfig,
+      {
+        ignores: ['.next/*'],
+      },
+    ),
+  ];
+};
+
+const typescriptNextConfig = createTypescriptNextConfig();
 
 export default typescriptNextConfig;

package/src/presets/typescript-node.js

@@ -1,25 +1,31 @@
 import globals from 'globals';
 import tsEslint from 'typescript-eslint';
 
-import { globs, typescriptConfigs } from '../common.js';
-import javascriptNode from './javascript-node.js';
+import { globs, normalizeOptions, typescriptConfigs } from '../common.js';
+import { createJavascriptNodeConfig } from './javascript-node.js';
 import { baseTypescriptConfig } from './typescript.js';
 
-const nodeTypescriptConfig = {
-  ...baseTypescriptConfig,
-  languageOptions: {
-    ...baseTypescriptConfig.languageOptions,
-    globals: {
-      ...baseTypescriptConfig.languageOptions.globals,
-      ...globals.node,
+export const createTypescriptNodeConfig = (options = {}) => {
+  const opts = normalizeOptions(options);
+  const base = baseTypescriptConfig(opts);
+  const nodeTypescriptConfig = {
+    ...base,
+    languageOptions: {
+      ...base.languageOptions,
+      globals: {
+        ...base.languageOptions.globals,
+        ...globals.node,
+      },
     },
-  },
-  name: '@slango.configs/eslint/typescript-node',
+    name: '@slango.configs/eslint/typescript-node',
+  };
+
+  return [
+    ...createJavascriptNodeConfig(opts),
+    ...tsEslint.config(...typescriptConfigs(globs.typescript), nodeTypescriptConfig),
+  ];
 };
 
-const typescriptNodeConfig = [
-  ...javascriptNode,
-  ...tsEslint.config(...typescriptConfigs(globs.typescript), nodeTypescriptConfig),
-];
+const typescriptNodeConfig = createTypescriptNodeConfig();
 
 export default typescriptNodeConfig;

package/src/presets/typescript-react.js

@@ -3,28 +3,40 @@ import reactRefresh from 'eslint-plugin-react-refresh';
 import globals from 'globals';
 import tsEslint from 'typescript-eslint';
 
-import { globs, typescriptConfigs } from '../common.js';
-import javascriptNode from './javascript-node.js';
+import { globs, normalizeOptions, typescriptConfigs } from '../common.js';
+import { createJavascriptNodeConfig } from './javascript-node.js';
 import { browserTypescriptBrowserConfig } from './typescript-browser.js';
 import { baseTypescriptConfig } from './typescript.js';
 
-export const reactTypescriptBrowserConfig = {
-  ...baseTypescriptConfig,
-  languageOptions: {
-    ...baseTypescriptConfig.languageOptions,
-    globals: {
-      ...baseTypescriptConfig.languageOptions.globals,
-      ...globals.browser,
+export const reactTypescriptBrowserConfig = (options = {}) => {
+  const opts = normalizeOptions(options);
+  const base = baseTypescriptConfig(opts);
+  return {
+    ...base,
+    languageOptions: {
+      ...base.languageOptions,
+      globals: {
+        ...base.languageOptions.globals,
+        ...globals.browser,
+      },
     },
-  },
-  name: '@slango.configs/eslint/typescript-react',
+    name: '@slango.configs/eslint/typescript-react',
+  };
 };
 
-const typescriptReactConfig = [
-  ...javascriptNode,
-  reactHooks.configs['recommended-latest'],
-  reactRefresh.configs.recommended,
-  ...tsEslint.config(...typescriptConfigs(globs.typescript), browserTypescriptBrowserConfig),
-];
+export const createTypescriptReactConfig = (options = {}) => {
+  const opts = normalizeOptions(options);
+  return [
+    ...createJavascriptNodeConfig(opts),
+    reactHooks.configs['recommended-latest'],
+    reactRefresh.configs.recommended,
+    ...tsEslint.config(
+      ...typescriptConfigs(globs.typescript),
+      browserTypescriptBrowserConfig(opts),
+    ),
+  ];
+};
+
+const typescriptReactConfig = createTypescriptReactConfig();
 
 export default typescriptReactConfig;

package/src/presets/typescript.js

@@ -1,36 +1,51 @@
 import { dirname } from 'node:path';
 import tsEslint from 'typescript-eslint';
 
-import { commonConfigs, commonRules, globs, ignorePatterns, typescriptConfigs } from '../common.js';
+import {
+  commonConfigs,
+  commonRules,
+  globs,
+  ignorePatterns,
+  normalizeOptions,
+  typescriptConfigs,
+} from '../common.js';
 import { getTsConfigFile } from '../utils.js';
-import javascriptNode, { baseJavascriptConfig } from './javascript-node.js';
+import { baseJavascriptConfig, createJavascriptNodeConfig } from './javascript-node.js';
 
 const project = getTsConfigFile();
 
-export const baseTypescriptConfig = {
-  ...baseJavascriptConfig,
-  extends: [...commonConfigs(globs.typescript)],
-  files: [globs.typescript],
-  languageOptions: {
-    parserOptions: {
-      project,
-      tsconfigRootDir: dirname(project),
+export const baseTypescriptConfig = (options = {}) => {
+  const opts = normalizeOptions(options);
+  return {
+    ...baseJavascriptConfig(opts),
+    extends: [...commonConfigs(globs.typescript)],
+    files: [globs.typescript],
+    languageOptions: {
+      parserOptions: {
+        project,
+        tsconfigRootDir: dirname(project),
+      },
     },
-  },
-  name: '@slango.configs/eslint/typescript',
-  rules: {
-    // Allow destructuring (to remove unused properties)
-    '@typescript-eslint/no-unused-vars': ['error', { ignoreRestSiblings: true }],
-    // Disable as @typescript-eslint/no-unused-vars is used (and no-unused-vars has issues with enums)
-    'no-unused-vars': 'off',
-    ...commonRules,
-  },
+    name: '@slango.configs/eslint/typescript',
+    rules: {
+      // Allow destructuring (to remove unused properties)
+      '@typescript-eslint/no-unused-vars': ['error', { ignoreRestSiblings: true }],
+      // Disable as @typescript-eslint/no-unused-vars is used (and no-unused-vars has issues with enums)
+      'no-unused-vars': 'off',
+      ...commonRules(opts),
+    },
+  };
+};
+
+export const createTypescriptConfig = (options = {}) => {
+  const opts = normalizeOptions(options);
+  return [
+    ...createJavascriptNodeConfig(opts),
+    ...tsEslint.config(...typescriptConfigs(globs.typescript), baseTypescriptConfig(opts)),
+    { ignores: ignorePatterns },
+  ];
 };
 
-const typescriptConfig = [
-  ...javascriptNode,
-  ...tsEslint.config(...typescriptConfigs(globs.typescript), baseTypescriptConfig),
-  { ignores: ignorePatterns },
-];
+const typescriptConfig = createTypescriptConfig();
 
 export default typescriptConfig;