@mkaradeniz/eslint-config 5.10.0 → 5.12.0

package/createConfig.mjs

@@ -0,0 +1,92 @@
+import { baseConfig } from './base.mjs';
+import { nextConfig } from './next.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.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 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 (tanstackQuery) {
+    config.push(...tanstackQueryConfig);
+  }
+  if (turbo) {
+    config.push(...turboConfig);
+  }
+  if (typeof shadcn === 'string') {
+    config.push(...createShadcnConfig(shadcn));
+  }
+
+  return config;
+};

package/noLet.mjs

@@ -0,0 +1,26 @@
+import { baseRules } from './rules/baseRules.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"]',
+};
+
+/**
+ * Bans `let` declarations via `no-restricted-syntax`.
+ *
+ * Accepts an optional source rules object to merge with. Defaults to `baseRules`.
+ * Pass `reactRules` when composing with `reactConfig` or `nextConfig` to preserve their extra selectors.
+ *
+ * @example
+ * import { createNoLetConfig } from '@mkaradeniz/eslint-config/noLet.mjs';
+ * import { reactRules } from '@mkaradeniz/eslint-config/rules/reactRules.mjs';
+ * export default [...nextConfig, ...createNoLetConfig(reactRules)];
+ */
+export const createNoLetConfig = (sourceRules = baseRules) => [
+  {
+    rules: {
+      'no-restricted-syntax': ['warn', ...sourceRules.rules['no-restricted-syntax'].slice(1), noLetRestriction],
+    },
+  },
+];

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@mkaradeniz/eslint-config",
-  "version": "5.10.0",
+  "version": "5.12.0",
   "private": false,
   "files": [
     "base.mjs",
+    "createConfig.mjs",
     "web.mjs",
     "next.mjs",
+    "noLet.mjs",
     "react.mjs",
     "shadcn.mjs",
     "tanstackQuery.mjs",

package/rules/baseRules.mjs

@@ -134,11 +134,6 @@ export const baseRules = {
         message: 'Use envConfigClient or envConfigServer instead of process.env.',
         selector: 'MemberExpression[object.name="process"][property.name="env"]',
       },
-      // {
-      //   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"]',
-      // },
     ],
     'no-return-assign': ['warn'],
     'no-script-url': ['warn'],