@mkaradeniz/eslint-config 5.11.0 → 5.13.0

package/createConfig.mjs

@@ -0,0 +1,107 @@
+import { baseConfig } from './base.mjs';
+import { nextConfig } from './next.mjs';
+import { noUtilInComponentRestrictions } from './noUtilInComponent.mjs';
+import { reactConfig } from './react.mjs';
+import { baseRules } from './rules/baseRules.mjs';
+import { reactRules } from './rules/reactRules.mjs';
+import { createShadcnConfig } from './shadcn.mjs';
+import { tanstackQueryConfig } from './tanstackQuery.mjs';
+import { turboConfig } from './turbo.mjs';
+
+const noLetRestriction = {
+  message:
+    'Prefer const + functional patterns (map/filter/reduce/ternary). Extract to a util function if needed. Only disable for: try/catch assignment, iterators/generators, for-await-of accumulation, or closures requiring mutable state (debounce, event handlers).',
+  selector: 'VariableDeclaration[kind="let"]',
+};
+
+const envPrismaFiles = ['**/env.ts', '**/env.client.ts', '**/env.server.ts', '**/prisma/**/seed.ts', '**/prisma.config.ts'];
+
+const instrumentationFiles = ['**/instrumentation.ts', '**/instrumentation-client.ts'];
+
+const stripNoRestrictedSyntaxOverrides = configArray =>
+  configArray.filter(block => !(block.files && block.rules && Array.isArray(block.rules['no-restricted-syntax'])));
+
+const buildMergedNoRestrictedSyntax = options => {
+  const sourceRules = options.base === 'next' || options.base === 'react' ? reactRules : baseRules;
+  const selectors = [...sourceRules.rules['no-restricted-syntax'].slice(1)];
+  if (options.noLet) {
+    selectors.push(noLetRestriction);
+  }
+  return ['warn', ...selectors];
+};
+
+const buildFileOverrideSelectors = merged => merged.slice(1).filter(s => !s.selector?.includes('process'));
+
+/**
+ * Composes ESLint flat config with merged `no-restricted-syntax` so file-scoped overrides (env, prisma, instrumentation) are not clobbered.
+ *
+ * @param options.base - 'base' | 'react' | 'next'
+ * @param options.noLet - Add restriction on `let`. Optional.
+ * @param options.noUtilInComponent - Ban camelCase util functions in `.tsx` files. Optional.
+ * @param options.shadcn - Path to shadcn components for relaxed rules. Optional.
+ * @param options.tanstackQuery - Include TanStack Query config. Optional.
+ * @param options.turbo - Include Turbo config. Optional.
+ */
+export const createConfig = (options = {}) => {
+  const base = options.base ?? 'next';
+  const noLet = options.noLet ?? false;
+  const noUtilInComponent = options.noUtilInComponent ?? false;
+  const shadcn = options.shadcn;
+  const tanstackQuery = options.tanstackQuery ?? false;
+  const turbo = options.turbo ?? false;
+
+  const configByBase = { base: baseConfig, next: nextConfig, react: reactConfig };
+  const baseConfigArray = configByBase[base];
+  const stripped = stripNoRestrictedSyntaxOverrides(baseConfigArray);
+  const mergedNoRestrictedSyntax = buildMergedNoRestrictedSyntax({ base, noLet });
+  const overrideSelectors = buildFileOverrideSelectors(mergedNoRestrictedSyntax);
+  const fileOverrideNoRestrictedSyntax = ['warn', ...overrideSelectors];
+
+  const config = [
+    ...stripped,
+    {
+      rules: {
+        'no-restricted-syntax': mergedNoRestrictedSyntax,
+      },
+    },
+    {
+      files: envPrismaFiles,
+      rules: {
+        'no-restricted-syntax': fileOverrideNoRestrictedSyntax,
+      },
+    },
+  ];
+
+  if (base === 'next') {
+    config.push({
+      files: instrumentationFiles,
+      rules: {
+        'no-restricted-syntax': fileOverrideNoRestrictedSyntax,
+      },
+    });
+  }
+
+  if (noUtilInComponent && (base === 'next' || base === 'react')) {
+    const ignorePatterns = typeof shadcn === 'string' ? [`!${shadcn}/**`] : [];
+
+    config.push({
+      files: ['**/*.tsx'],
+      ignores: ignorePatterns,
+      rules: {
+        'no-restricted-syntax': [...mergedNoRestrictedSyntax, ...noUtilInComponentRestrictions],
+      },
+    });
+  }
+
+  if (tanstackQuery) {
+    config.push(...tanstackQueryConfig);
+  }
+  if (turbo) {
+    config.push(...turboConfig);
+  }
+  if (typeof shadcn === 'string') {
+    config.push(...createShadcnConfig(shadcn));
+  }
+
+  return config;
+};

package/noUtilInComponent.mjs

@@ -0,0 +1,19 @@
+const noUtilInComponentMessage =
+  "Don't define util functions in component files — move to a utils module. Use PascalCase for components and useX for hooks.";
+
+export const noUtilInComponentRestrictions = [
+  {
+    message: noUtilInComponentMessage,
+    selector: 'Program > FunctionDeclaration[id.name=/^[a-z]/]:not([id.name=/^use[A-Z]/])',
+  },
+  {
+    message: noUtilInComponentMessage,
+    selector:
+      'Program > VariableDeclaration > VariableDeclarator[init.type="ArrowFunctionExpression"][id.name=/^[a-z]/]:not([id.name=/^use[A-Z]/])',
+  },
+  {
+    message: noUtilInComponentMessage,
+    selector:
+      'Program > VariableDeclaration > VariableDeclarator[init.type="FunctionExpression"][id.name=/^[a-z]/]:not([id.name=/^use[A-Z]/])',
+  },
+];

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "@mkaradeniz/eslint-config",
-  "version": "5.11.0",
+  "version": "5.13.0",
   "private": false,
   "files": [
     "base.mjs",
+    "createConfig.mjs",
     "web.mjs",
     "next.mjs",
     "noLet.mjs",
+    "noUtilInComponent.mjs",
     "react.mjs",
     "shadcn.mjs",
     "tanstackQuery.mjs",