@knapsack/eslint-config-starter 5.0.0--canary.6593.4738696.0 → 5.0.0

package/CHANGELOG.md

@@ -1,3 +1,145 @@
+# v4.89.8 (Fri Feb 20 2026)
+
+### Release Notes
+
+#### KSP-7685: Synthetic Data for Conflict Enrichment/Resolution testing ([#7154](https://github.com/knapsack-labs/app-monorepo/pull/7154))
+
+* **Documentation**
+  * Added synthetic multi-source test fixtures including component documentation, design tokens, and brand guidelines for comprehensive testing coverage.
+
+<!-- end of auto-generated comment: release notes by coderabbit.ai -->
+
+---
+
+#### 🐛 Bug Fix
+
+- merge latest in ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+- Formated pkgs ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+- Merge branch 'latest' into sxa/KSP-7037-tests-v2 ([@sxalexander](https://github.com/sxalexander))
+- replaced removed @typescript-eslint/ban-types with v8 replacement rules ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+- Fixed Lint issue on config starter ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+- Migrated ESLint config to flat config format (ESLint 9) ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+
+#### 🏠 Internal
+
+- KSP-7685: Synthetic Data for Conflict Enrichment/Resolution testing [#7154](https://github.com/knapsack-labs/app-monorepo/pull/7154) ([@sxalexander](https://github.com/sxalexander))
+- KSP-5524 Migrated ESLint config to flat config format (ESLint 9) [#7162](https://github.com/knapsack-labs/app-monorepo/pull/7162) ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+
+#### Authors: 2
+
+- [@EmmanuelVelez](https://github.com/EmmanuelVelez)
+- Sam Alexander ([@sxalexander](https://github.com/sxalexander))
+
+---
+
+# v4.89.7 (Fri Feb 06 2026)
+
+#### 🐛 Bug Fix
+
+- Merge branch 'latest' into feature/ksp-6555-remove-app-client-watchers-for-files-in-data-directory ([@EvanLovely](https://github.com/EvanLovely))
+- resolved some of react-hooks/set-state-in-effect lint errors and enable rule as error ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+- Merge branch 'latest' into feature/ksp-6555-remove-app-client-watchers-for-files-in-data-directory ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+
+#### 🏠 Internal
+
+- KSP-6106 Added consistent-type-imports rule with inline type syntax [#7128](https://github.com/knapsack-labs/app-monorepo/pull/7128) ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+- KSP-7692: expand server actions body size limit [#7097](https://github.com/knapsack-labs/app-monorepo/pull/7097) ([@illepic](https://github.com/illepic))
+- KSP-7623 resolved some of react-hooks/set-state-in-effect lint errors and enab… [#7077](https://github.com/knapsack-labs/app-monorepo/pull/7077) ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+
+#### Authors: 3
+
+- [@EmmanuelVelez](https://github.com/EmmanuelVelez)
+- Christopher Bloom ([@illepic](https://github.com/illepic))
+- Evan Lovely ([@EvanLovely](https://github.com/EvanLovely))
+
+---
+
+# v4.89.6 (Fri Jan 09 2026)
+
+#### 🏠 Internal
+
+- upgrade react eslint plugin [#7067](https://github.com/knapsack-labs/app-monorepo/pull/7067) ([@EvanLovely](https://github.com/EvanLovely))
+
+#### Authors: 1
+
+- Evan Lovely ([@EvanLovely](https://github.com/EvanLovely))
+
+---
+
+# v4.89.4 (Mon Jan 05 2026)
+
+#### 🏠 Internal
+
+- KSP-6086 normalize error and log metadata for api domains [#6997](https://github.com/knapsack-labs/app-monorepo/pull/6997) ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+
+#### Authors: 1
+
+- [@EmmanuelVelez](https://github.com/EmmanuelVelez)
+
+---
+
+# v4.89.3 (Thu Dec 11 2025)
+
+#### 🐛 Bug Fix
+
+- KSP-6536 Fixed align token metrics counting with UI logic for variables and collections [#6778](https://github.com/knapsack-labs/app-monorepo/pull/6778) ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+- Merge branch 'latest' into feature/ksp-6536-metrics-not-computing-tokens-and-variables-correctly ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+- Merge remote-tracking branch 'origin/feature/ksp-6536-metrics-not-computing-tokens-and-variables-correctly' into feature/ksp-6536-metrics-not-computing-tokens-and-variables-correctly ([@EmmanuelVelez](https://github.com/EmmanuelVelez))
+
+#### Authors: 1
+
+- [@EmmanuelVelez](https://github.com/EmmanuelVelez)
+
+---
+
+# v4.89.1 (Wed Dec 10 2025)
+
+#### 🐛 Bug Fix
+
+- Merge remote-tracking branch 'origin/latest' into KSP-6900_mcp_onboarding_pages ([@brittanysmart](https://github.com/brittanysmart))
+
+#### Authors: 1
+
+- Brittany Smart ([@brittanysmart](https://github.com/brittanysmart))
+
+---
+
+# v4.87.9 (Thu Nov 20 2025)
+
+#### 🏠 Internal
+
+- fix(deps): update dependency @types/node to ^20.19.25 [#6803](https://github.com/knapsack-labs/app-monorepo/pull/6803) ([@renovate[bot]](https://github.com/renovate[bot]))
+
+#### Authors: 1
+
+- [@renovate[bot]](https://github.com/renovate[bot])
+
+---
+
+# v4.87.7 (Mon Nov 10 2025)
+
+#### 🏠 Internal
+
+- fix(deps): update typescript [#6863](https://github.com/knapsack-labs/app-monorepo/pull/6863) ([@renovate[bot]](https://github.com/renovate[bot]))
+
+#### Authors: 1
+
+- [@renovate[bot]](https://github.com/renovate[bot])
+
+---
+
+# v4.87.6 (Wed Nov 05 2025)
+
+#### 🏠 Internal
+
+- Add comprehensive testing for remaining frameworks and MUI lib [#6876](https://github.com/knapsack-labs/app-monorepo/pull/6876) ([@mabry1985](https://github.com/mabry1985))
+
+#### Authors: 1
+
+- Josh Mabry ([@mabry1985](https://github.com/mabry1985))
+
+---
+
 # v4.87.4 (Fri Oct 31 2025)
 
 #### 🏠 Internal

package/configs/esm.mjs

@@ -0,0 +1,25 @@
+/**
+ * ESM-specific ESLint configuration
+ */
+import unicorn from 'eslint-plugin-unicorn';
+
+/**
+ * ESM ESLint configuration
+ * @returns {import('eslint').Linter.Config[]}
+ */
+export function createEsmConfig() {
+  return [
+    {
+      plugins: {
+        unicorn,
+      },
+      rules: {
+        'unicorn/prefer-module': 'error',
+        'unicorn/prefer-node-protocol': 'error',
+        'unicorn/prefer-top-level-await': 'error',
+      },
+    },
+  ];
+}
+
+export default createEsmConfig();

package/configs/react.mjs

@@ -0,0 +1,77 @@
+/**
+ * React-specific ESLint configuration
+ */
+import react from 'eslint-plugin-react';
+import reactHooks from 'eslint-plugin-react-hooks';
+import jsxA11y from 'eslint-plugin-jsx-a11y';
+
+/**
+ * React ESLint configuration
+ * @returns {import('eslint').Linter.Config[]}
+ */
+export function createReactConfig() {
+  return [
+    // React recommended config
+    react.configs.flat.recommended,
+    react.configs.flat['jsx-runtime'],
+
+    // React Hooks
+    reactHooks.configs['recommended-latest'],
+
+    // JSX Accessibility
+    jsxA11y.flatConfigs.recommended,
+
+    // Custom React rules
+    {
+      plugins: {
+        react,
+        'react-hooks': reactHooks,
+        'jsx-a11y': jsxA11y,
+      },
+
+      settings: {
+        react: {
+          version: 'detect',
+        },
+      },
+
+      rules: {
+        // JSX A11y
+        'jsx-a11y/anchor-is-valid': ['warn', { aspects: ['invalidHref'] }],
+        'jsx-a11y/href-no-hash': 'off',
+        'jsx-a11y/control-has-associated-label': 'off',
+
+        // React
+        'react/boolean-prop-naming': 'off',
+        'react/destructuring-assignment': 'off',
+        'react/forbid-prop-types': ['error', { forbid: ['any', 'array'] }],
+        'react/no-unknown-property': 'off',
+        'react/prop-types': 'off',
+        'react/function-component-definition': 'off',
+        'react/no-unstable-nested-components': [
+          'error',
+          { allowAsProps: true },
+        ],
+        'react/jsx-key': 'error',
+        'react/no-array-index-key': 'error',
+        'react/no-danger': 'off',
+        'react/jsx-props-no-spreading': 'off',
+        'react/sort-comp': 'off',
+        'react/static-property-placement': ['off', 'static public field'],
+        'react/require-extension': 'off',
+        'react/jsx-filename-extension': [
+          'error',
+          { extensions: ['.tsx', '.jsx'] },
+        ],
+        'react/require-default-props': 'off',
+        'react/no-unused-prop-types': 'off',
+
+        // React Hooks
+        'react-hooks/rules-of-hooks': 'error',
+        'react-hooks/exhaustive-deps': 'error',
+      },
+    },
+  ];
+}
+
+export default createReactConfig();

package/dist/eslint-config-starter-creator.d.ts

@@ -3,7 +3,7 @@ export declare const eslintConfigStarterCreator: import("@knapsack/creator-utils
         type: "boolean";
         title: string;
     };
-    hasAva: {
+    hasEsm: {
         type: "boolean";
         title: string;
     };
@@ -21,7 +21,7 @@ export declare const eslintConfigStarterCreator: import("@knapsack/creator-utils
         type: "boolean";
         title: string;
     };
-    hasAva: {
+    hasEsm: {
         type: "boolean";
         title: string;
     };

package/dist/eslint-config-starter-creator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eslint-config-starter-creator.d.ts","sourceRoot":"","sources":["../src/eslint-config-starter-creator.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+GrC,CAAC"}
+{"version":3,"file":"eslint-config-starter-creator.d.ts","sourceRoot":"","sources":["../src/eslint-config-starter-creator.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8ErC,CAAC"}

package/dist/eslint-config-starter-creator.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.eslintConfigStarterCreator = void 0;
 const creator_utils_1 = require("@knapsack/creator-utils");
 const creator_1 = require("@knapsack/prettier-config/creator");
-const path_1 = require("path");
 const { pkg } = (0, creator_utils_1.findUpPkgJson)(__dirname);
 const pkgName = pkg.name;
 if (typeof pkgName !== 'string') {
@@ -14,11 +13,11 @@ exports.eslintConfigStarterCreator = (0, creator_utils_1.createCreator)({
     getQuestions: async () => ({
         hasReact: {
             type: 'boolean',
-            title: 'Using React?',
+            title: 'Using React? (Note: Add package path to root eslint.config.mjs reactPackages array)',
         },
-        hasAva: {
+        hasEsm: {
             type: 'boolean',
-            title: 'Using Ava for testing?',
+            title: 'Using ESM? (Note: Add package path to root eslint.config.mjs esmPackages array)',
         },
         addNpmScript: {
             type: 'boolean',
@@ -30,67 +29,33 @@ exports.eslintConfigStarterCreator = (0, creator_utils_1.createCreator)({
             default: false,
         },
     }),
-    getTasks: async ({ answers: { hasAva, hasReact, addNpmScript, addIgnore }, config, }) => {
+    getTasks: async ({ answers: { addNpmScript, addIgnore }, config }) => {
         const { dest } = config;
-        const configs = [
-            hasReact && '@knapsack/eslint-config-starter/react',
-            hasAva && '@knapsack/eslint-config-starter/ava',
-            '@knapsack/eslint-config-starter',
-        ].filter(Boolean);
         return [
             {
-                title: 'Add .eslintrc.js',
-                skip: (0, creator_utils_1.hasFileUp)({
-                    cwd: dest,
-                    file: [
-                        '.eslintrc.js',
-                        '.eslintrc.cjs',
-                        '.eslintrc.yaml',
-                        '.eslintrc.yml',
-                        '.eslintrc.json',
-                        '.eslintrc',
-                    ],
-                }) && 'Found pre-existing file',
+                title: 'Note: ESLint uses flat config',
                 task: async (ctx, task) => {
-                    return creator_utils_1.tasks.addFile({
-                        destination: (0, path_1.join)(dest, '.eslintrc.cjs'),
-                        handlePriorFile: 'skip',
-                        contents: `
-module.exports = {
-  extends: [${configs.map((c) => `'${c}'`).join(', ')}],
-  parserOptions: { tsconfigRootDir: __dirname },
-  ignorePatterns: [],
-  rules: {},
-};
-    `,
-                    });
-                },
-            },
-            {
-                title: 'Add .eslintignore',
-                skip: (0, creator_utils_1.hasFileUp)({ file: '.eslintignore' }) && 'Found pre-existing file',
-                task: async (ctx, task) => {
-                    task.output = await creator_utils_1.tasks.addFile({
-                        destination: (0, path_1.join)(dest, '.eslintignore'),
-                        contents: ['dist'],
-                        handlePriorFile: 'skip',
-                    });
+                    task.output = `
+ESLint is configured via the root eslint.config.mjs file.
+No per-package config needed. If this package needs special rules:
+1. Add the package path to the appropriate arrays in eslint.config.mjs:
+   - reactPackages: for React packages
+   - esmPackages: for ESM packages
+2. Add custom overrides in the "PACKAGE-SPECIFIC OVERRIDES" section if needed.
+          `.trim();
                 },
             },
             {
                 title: 'Update package.json with eslint',
-                task: async () => {
-                    var _a;
-                    return creator_utils_1.tasks.updatePkgJson({
-                        dir: dest,
-                        pkg: {
-                            devDependencies: {
-                                [pkgName]: pkg.version,
-                                eslint: (_a = pkg.dependencies) === null || _a === void 0 ? void 0 : _a.eslint,
-                            },
+                task: async () => creator_utils_1.tasks.updatePkgJson({
+                    dir: dest,
+                    pkg: {
+                        devDependencies: {
+                            [pkgName]: pkg.version,
+                            eslint: pkg.dependencies?.eslint,
                         },
-                    });
-                },
+                    },
+                }),
             },
             {
                 title: 'Adding lint npm script to package.json',
@@ -99,7 +64,7 @@ module.exports = {
                     dir: dest,
                     pkg: {
                         scripts: {
-                            lint: 'eslint ./',
+                            lint: 'eslint .',
                         },
                     },
                 }),

package/dist/eslint-config-starter-creator.js.map

@@ -1 +1 @@
-{"version":3,"file":"eslint-config-starter-creator.js","sourceRoot":"","sources":["../src/eslint-config-starter-creator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"eslint-config-starter-creator.js","sourceRoot":"","sources":["../src/eslint-config-starter-creator.ts"],"names":[],"mappings":";;;AAAA,2DAA8E;AAC9E,+DAA0E;AAE1E,MAAM,EAAE,GAAG,EAAE,GAAG,IAAA,6BAAa,EAAC,SAAS,CAAC,CAAC;AACzC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;AACzB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;IAChC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAC9C,CAAC;AAEY,QAAA,0BAA0B,GAAG,IAAA,6BAAa,EAAC;IACtD,EAAE,EAAE,uBAAuB;IAC3B,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACzB,QAAQ,EAAE;YACR,IAAI,EAAE,SAAS;YACf,KAAK,EACH,qFAAqF;SACxF;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,KAAK,EACH,iFAAiF;SACpF;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,kCAAkC;SAC1C;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,2BAA2B;YAClC,OAAO,EAAE,KAAK;SACf;KACF,CAAC;IACF,QAAQ,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QACxB,OAAO;YACL;gBACE,KAAK,EAAE,+BAA+B;gBACtC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;oBACxB,IAAI,CAAC,MAAM,GAAG;;;;;;;WAOb,CAAC,IAAI,EAAE,CAAC;gBACX,CAAC;aACF;YACD;gBACE,KAAK,EAAE,iCAAiC;gBACxC,IAAI,EAAE,KAAK,IAAI,EAAE,CACf,qBAAK,CAAC,aAAa,CAAC;oBAClB,GAAG,EAAE,IAAI;oBACT,GAAG,EAAE;wBACH,eAAe,EAAE;4BACf,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,OAAO;4BACtB,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,MAAM;yBACjC;qBACF;iBACF,CAAC;aACL;YACD;gBACE,KAAK,EAAE,wCAAwC;gBAC/C,IAAI,EAAE,CAAC,YAAY;gBACnB,IAAI,EAAE,KAAK,IAAI,EAAE,CACf,qBAAK,CAAC,aAAa,CAAC;oBAClB,GAAG,EAAE,IAAI;oBACT,GAAG,EAAE;wBACH,OAAO,EAAE;4BACP,IAAI,EAAE,UAAU;yBACjB;qBACF;iBACF,CAAC;aACL;YACD;gBACE,KAAK,EAAE,iBAAiB;gBACxB,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;oBACtB,OAAO,qBAAK,CAAC,aAAa,CAAC;wBACzB,OAAO,EAAE,+BAAqB;wBAC9B,MAAM;wBACN,IAAI;wBACJ,YAAY,EAAE,EAAE,SAAS,EAAE;qBAC5B,CAAC,CAAC;gBACL,CAAC;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/eslint-config-base.js

@@ -56,6 +56,16 @@ module.exports = {
       files: ['*.ts', '*.tsx', '*.mts'],
       extends: ['plugin:@typescript-eslint/recommended'],
       rules: {
+        // Enforce type imports to keep JS bundles small
+        // Uses inline style: `import { type Thing }` instead of `import type { Thing }`
+        // This reduces merge conflicts when adding non-type imports to the same statement
+        '@typescript-eslint/consistent-type-imports': [
+          'error',
+          {
+            prefer: 'type-imports',
+            fixStyle: 'inline-type-imports',
+          },
+        ],
         // @TODO: KSP-4627: re-enable 'jsx-a11y/control-has-associated-label'
         'jsx-a11y/control-has-associated-label': [0],
         '@typescript-eslint/no-explicit-any': [1],

package/eslint.config.mjs

@@ -0,0 +1,227 @@
+/**
+ * @knapsack/eslint-config-starter - ESLint Flat Config
+ *
+ * This is the main ESLint configuration for the Knapsack monorepo.
+ * It uses the new flat config format introduced in ESLint 9.
+ *
+ * @see https://eslint.org/docs/latest/use/configure/configuration-files
+ */
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import prettier from 'eslint-config-prettier';
+import prettierPlugin from 'eslint-plugin-prettier';
+import jsdoc from 'eslint-plugin-jsdoc';
+import promise from 'eslint-plugin-promise';
+import unusedImports from 'eslint-plugin-unused-imports';
+import importX from 'eslint-plugin-import-x';
+import globals from 'globals';
+
+/**
+ * Base ESLint configuration for the Knapsack monorepo
+ * @param {object} options - Configuration options
+ * @param {string} [options.tsconfigRootDir] - Root directory for TypeScript config
+ * @returns {import('eslint').Linter.Config[]}
+ */
+export function createBaseConfig({ tsconfigRootDir } = {}) {
+  return [
+    // Global ignores
+    {
+      ignores: [
+        '**/node_modules/**',
+        '**/dist/**',
+        '**/*.log',
+        '**/Caches/typescript/**',
+        '**/temp/**',
+        '**/.rush/**',
+        '**/coverage/**',
+        '**/.next/**',
+        '**/build/**',
+      ],
+    },
+
+    // Base JavaScript recommended rules
+    js.configs.recommended,
+
+    // TypeScript ESLint recommended rules
+    ...tseslint.configs.recommended,
+
+    // Prettier config (disables conflicting rules)
+    prettier,
+
+    // Main configuration for all files
+    {
+      plugins: {
+        prettier: prettierPlugin,
+        jsdoc,
+        promise,
+        'unused-imports': unusedImports,
+        'import-x': importX,
+      },
+
+      languageOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+        globals: {
+          ...globals.browser,
+          ...globals.node,
+          document: true,
+          window: true,
+          fetch: true,
+        },
+        parserOptions: {
+          ecmaFeatures: {
+            jsx: true,
+          },
+        },
+      },
+
+      settings: {
+        'import-x/resolver': {
+          node: {
+            extensions: ['.js', '.jsx', '.ts', '.tsx'],
+          },
+          typescript: tsconfigRootDir ? { project: tsconfigRootDir } : {},
+        },
+        'import-x/parsers': {
+          '@typescript-eslint/parser': ['.ts', '.tsx'],
+        },
+      },
+
+      rules: {
+        // Prettier
+        'prettier/prettier': 'error',
+
+        // Unused imports
+        'unused-imports/no-unused-imports': 'error',
+        'unused-imports/no-unused-vars': [
+          'warn',
+          {
+            vars: 'all',
+            varsIgnorePattern: '^_',
+            args: 'after-used',
+            argsIgnorePattern: '^_',
+          },
+        ],
+        'no-unused-vars': 'off',
+
+        // General rules (from airbnb/base equivalent)
+        'no-continue': 'off',
+        'no-use-before-define': 'off',
+        'no-restricted-syntax': 'off',
+        'no-return-await': 'off',
+        'arrow-body-style': 'off',
+        'no-await-in-loop': 'off',
+        'no-constant-condition': ['warn', { checkLoops: false }],
+        'consistent-return': 'off',
+        camelcase: 'off',
+        'no-unreachable': 'off',
+        'no-console': 'off',
+        'default-case': 'off',
+        'no-inner-declarations': 'off',
+        'no-param-reassign': ['warn', { props: false }],
+        'no-plusplus': ['error', { allowForLoopAfterthoughts: true }],
+        'no-useless-constructor': 'off',
+        'no-promise-executor-return': 'off',
+        'no-underscore-dangle': 'off',
+        'prefer-arrow-callback': 'off',
+        strict: 'off',
+
+        // JSDoc
+        'jsdoc/check-types': 'error',
+
+        // Import rules
+        'import-x/no-extraneous-dependencies': 'off',
+        'import-x/prefer-default-export': 'off',
+        'import-x/dynamic-import-chunkname': 'off',
+        'import-x/no-dynamic-require': 'off',
+        'import-x/extensions': 'off',
+        'import-x/no-unresolved': 'error',
+
+        // Restricted imports
+        'no-restricted-imports': [
+          'error',
+          {
+            paths: [
+              {
+                name: 'moment',
+                message:
+                  'Please use the data-fns package (https://date-fns.org/) instead of the moment package to manipulate time and dates.',
+              },
+              {
+                name: 'lodash',
+                message:
+                  "Import lodash methods from default exports in subfolders, eg `import thing from 'lodash/thing'",
+              },
+            ],
+            patterns: ['lodash.*'],
+          },
+        ],
+      },
+    },
+
+    // TypeScript-specific configuration
+    {
+      files: ['**/*.ts', '**/*.tsx', '**/*.mts'],
+      languageOptions: {
+        parser: tseslint.parser,
+        parserOptions: {
+          ...(tsconfigRootDir && { tsconfigRootDir }),
+        },
+      },
+      rules: {
+        // Enforce type imports
+        '@typescript-eslint/consistent-type-imports': [
+          'error',
+          {
+            prefer: 'type-imports',
+            fixStyle: 'inline-type-imports',
+          },
+        ],
+        '@typescript-eslint/no-explicit-any': 'warn',
+        '@typescript-eslint/no-unused-vars': 'off',
+        '@typescript-eslint/explicit-function-return-type': 'off',
+        '@typescript-eslint/explicit-module-boundary-types': 'off',
+        'class-methods-use-this': 'off',
+        '@typescript-eslint/class-methods-use-this': [
+          'error',
+          {
+            ignoreOverrideMethods: true,
+            ignoreClassesThatImplementAnInterface: true,
+          },
+        ],
+        '@typescript-eslint/no-empty-function': 'off',
+        'no-unused-expressions': 'off',
+        '@typescript-eslint/no-unused-expressions': [
+          'error',
+          {
+            allowShortCircuit: true,
+            allowTernary: true,
+            enforceForJSX: true,
+          },
+        ],
+        'no-shadow': 'off',
+        '@typescript-eslint/no-shadow': [
+          'error',
+          {
+            ignoreTypeValueShadow: true,
+            ignoreFunctionTypeParameterNameValueShadow: true,
+          },
+        ],
+        '@typescript-eslint/no-inferrable-types': 'error',
+        '@typescript-eslint/no-use-before-define': 'error',
+        '@typescript-eslint/no-require-imports': 'off',
+      },
+    },
+
+    // JavaScript files (allow require)
+    {
+      files: ['**/*.js', '**/*.cjs', '**/*.mjs'],
+      rules: {
+        '@typescript-eslint/no-require-imports': 'off',
+      },
+    },
+  ];
+}
+
+// Default export for direct use
+export default createBaseConfig();

package/package.json

@@ -1,19 +1,16 @@
 {
   "name": "@knapsack/eslint-config-starter",
   "description": "ESlint Config",
-  "version": "5.0.0--canary.6593.4738696.0",
+  "version": "5.0.0",
   "bin": "./bin.js",
-  "main": "eslint-config-base.js",
+  "main": "eslint.config.mjs",
   "exports": {
-    ".": {
-      "require": "./eslint-config-base.js"
-    },
-    "./ava": "./ava.json",
     "./creator": "./dist/eslint-config-starter-creator.js",
-    "./esm": "./esm.json",
+    "./esm": "./configs/esm.mjs",
+    "./legacy": "./eslint-config-base.js",
     "./package": "./package.json",
     "./package.json": "./package.json",
-    "./react": "./react.json"
+    "./react": "./configs/react.mjs"
   },
   "sideEffects": false,
   "scripts": {
@@ -24,30 +21,31 @@
     "start": "tsc --watch"
   },
   "dependencies": {
-    "@knapsack/creator-utils": "5.0.0--canary.6593.4738696.0",
-    "@knapsack/prettier-config": "5.0.0--canary.6593.4738696.0",
-    "@rushstack/eslint-patch": "^1.8.0",
-    "@typescript-eslint/eslint-plugin": "^7.18.0",
-    "@typescript-eslint/parser": "^7.18.0",
-    "eslint": "^8.57.0",
-    "eslint-config-airbnb": "^19.0.4",
-    "eslint-config-prettier": "^8.10.0",
+    "@eslint/compat": "^1.2.5",
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.20.0",
+    "@knapsack/creator-utils": "5.0.0",
+    "@knapsack/prettier-config": "5.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.24.0",
+    "@typescript-eslint/parser": "^8.24.0",
+    "eslint": "^9.20.0",
+    "eslint-config-prettier": "^10.0.1",
     "eslint-import-resolver-typescript": "^3.10.1",
-    "eslint-plugin-ava": "^13.2.0",
-    "eslint-plugin-import": "^2.29.1",
-    "eslint-plugin-jsdoc": "^39.9.1",
-    "eslint-plugin-jsx-a11y": "^6.8.0",
-    "eslint-plugin-prettier": "^4.2.1",
-    "eslint-plugin-promise": "^6.1.1",
-    "eslint-plugin-react": "^7.34.1",
-    "eslint-plugin-react-hooks": "^4.6.0",
-    "eslint-plugin-unicorn": "^51.0.1",
-    "eslint-plugin-unused-imports": "^3.2.0",
-    "typescript": "^5.9.2",
-    "typescript-eslint": "^7.18.0"
+    "eslint-plugin-import-x": "^4.6.1",
+    "eslint-plugin-jsdoc": "^50.6.3",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-prettier": "^5.2.3",
+    "eslint-plugin-promise": "^7.2.1",
+    "eslint-plugin-react": "^7.37.4",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-unicorn": "^57.0.0",
+    "eslint-plugin-unused-imports": "^4.1.4",
+    "globals": "^15.14.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.24.0"
   },
   "devDependencies": {
-    "@types/node": "^20.19.22"
+    "@types/node": "^22.19.11"
   },
   "license": "GPL-2.0-or-later",
   "publishConfig": {
@@ -58,5 +56,5 @@
     "directory": "tools/eslint-config-starter",
     "type": "git"
   },
-  "gitHead": "4738696cd5d75f977543e5484622c251b26db3a4"
+  "gitHead": "31e09ba72245b95bef52e73ce5076de51936286c"
 }

package/.eslintrc

@@ -1,3 +0,0 @@
-{
-  "extends": "./eslint-config-base.js"
-}

package/ava.json

@@ -1,31 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/eslintrc",
-  "plugins": ["ava"],
-  "rules": {
-    "ava/assertion-arguments": "off",
-    "ava/hooks-order": "error",
-    "ava/max-asserts": ["off", 5],
-    "ava/no-async-fn-without-await": "error",
-    "ava/no-cb-test": "off",
-    "ava/no-duplicate-modifiers": "error",
-    "ava/no-identical-title": "error",
-    "ava/no-incorrect-deep-equal": "error",
-    "ava/no-inline-assertions": "error",
-    "ava/no-nested-tests": "error",
-    "ava/no-only-test": "error",
-    "ava/no-skip-assert": "error",
-    "ava/no-skip-test": "off",
-    "ava/no-todo-implementation": "error",
-    "ava/no-todo-test": "warn",
-    "ava/no-unknown-modifiers": "error",
-    "ava/prefer-async-await": "error",
-    "ava/prefer-power-assert": "off",
-    "ava/prefer-t-regex": "error",
-    "ava/test-title": "error",
-    "ava/test-title-format": "off",
-    "ava/use-t": "error",
-    "ava/use-t-well": "error",
-    "ava/use-test": "error",
-    "ava/use-true-false": "error"
-  }
-}

package/esm.json

@@ -1,9 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/eslintrc",
-  "plugins": ["unicorn"],
-  "rules": {
-    "unicorn/prefer-module": "error",
-    "unicorn/prefer-node-protocol": "error",
-    "unicorn/prefer-top-level-await": "error"
-  }
-}

package/react.json

@@ -1,47 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/eslintrc",
-  "plugins": ["react-hooks", "jsx-a11y"],
-  "settings": {
-    "react": {
-      "version": "detect"
-    }
-  },
-  "rules": {
-    "jsx-a11y/anchor-is-valid": [
-      "warn",
-      {
-        "aspects": ["invalidHref"]
-      }
-    ],
-    "jsx-a11y/href-no-hash": "off",
-    "react/boolean-prop-naming": [0],
-    "react/destructuring-assignment": [0],
-    "react/forbid-prop-types": [
-      2,
-      {
-        "forbid": ["any", "array"]
-      }
-    ],
-    "react/no-unknown-property": [0],
-    "react/prop-types": [0],
-    "react/function-component-definition": [0],
-    "react/no-unstable-nested-components": [
-      "error",
-      {
-        "allowAsProps": true
-      }
-    ],
-    "react/jsx-key": [2],
-    "react-hooks/rules-of-hooks": "error",
-    "react-hooks/exhaustive-deps": [2],
-    "react/no-array-index-key": [2],
-    "react/no-danger": [0],
-    "react/jsx-props-no-spreading": [0],
-    "react/sort-comp": [0],
-    "react/static-property-placement": [0, "static public field"],
-    "react/require-extension": [0],
-    "react/jsx-filename-extension": [2, { "extensions": [".tsx", ".jsx"] }],
-    "react/require-default-props": [0],
-    "react/no-unused-prop-types": [0]
-  }
-}