@codfish/eslint-config 0.0.0-PR-124--3ca0d95

package/README.md

@@ -0,0 +1,178 @@
+# @codfish/eslint-config
+
+> Modern ESLint configuration with TypeScript, React, and testing framework support using ESLint v9+ flat config format.
+
+[![version](https://img.shields.io/npm/v/@codfish/eslint-config.svg)](http://npm.im/@codfish/eslint-config)
+[![downloads](https://img.shields.io/npm/dm/@codfish/eslint-config.svg)](http://npm-stat.com/charts.html?package=@codfish/eslint-config&from=2015-08-01)
+[![MIT License](https://img.shields.io/npm/l/@codfish/eslint-config.svg)](http://opensource.org/licenses/MIT)
+[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
+[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+## Table of Contents
+
+- [Features](#features)
+  - [Automatic Configuration](#automatic-configuration)
+- [Installation](#installation)
+- [Usage](#usage)
+  - [Prettier](#prettier)
+  - [With dApps](#with-dapps)
+  - [Docker Configuration](#docker-configuration)
+  - [Blockchain/dApp Configuration](#blockchaindapp-configuration)
+- [Known issues](#known-issues)
+- [Migration from Legacy Config](#migration-from-legacy-config)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+## Features
+
+- **Modern ESLint v9+ flat config**: Uses the new flat configuration format
+- **Dynamic feature detection**: Automatically configures based on your project's dependencies
+- **TypeScript support**: Full TypeScript linting with modern typescript-eslint parser and rules
+- **React ecosystem**: React, React Hooks, and JSX accessibility rules when React is detected
+- **Test framework agnostic**: Supports Jest and Vitest with automatic detection
+- **Prettier integration**: Built-in Prettier configuration with conflict resolution via eslint-config-prettier
+- **ESM architecture**: Built with ECMAScript modules and full TypeScript typing
+- **Docker support**: Optional configuration for dockerized applications
+- **Blockchain/dApp support**: Optional configuration for decentralized applications
+
+### Automatic Configuration
+
+The config automatically detects and configures:
+
+- **React**: Includes React, React Hooks, and JSX a11y rules when `react` is installed
+- **Jest**: Configures Jest-specific rules when `jest` is found in dependencies
+- **Vitest**: Configures Vitest-specific rules when `vitest` is detected
+- **Prettier**: Loads your project's Prettier config or falls back to built-in defaults
+
+## Installation
+
+Install the package and required peer dependencies:
+
+```sh
+npm i -D @codfish/eslint-config eslint@9
+```
+
+## Usage
+
+Create an `eslint.config.js` file in your project root:
+
+```js
+import { defineConfig } from 'eslint/config';
+import codfish from '@codfish/eslint-config';
+
+export default defineConfig([
+  {
+    files: ['**/*.{js,jsx,ts,tsx}'],
+    extends: [codfish],
+    // Your overrides here
+  },
+]);
+```
+
+> [!IMPORTANT] If you get ES module errors, you may need to set the `type` field in your `package.json` to `module` or
+> rename your config file to `eslint.config.mjs`.
+
+### Prettier
+
+Prettier is automatically run through eslint with the [default configuration](./prettier.js). You can optionally add a
+prettier configuration file in the root of your project and it will take precedence over the
+[built-in config](./prettier.js). You can also choose to extend the Prettier config:
+
+**prettier.config.js**
+
+```js
+import codfishConfig from '@codfish/eslint-config/prettier.js';
+
+/**
+ * @see https://prettier.io/docs/en/configuration.html
+ * @type {import("prettier").Config}
+ */
+const config = {
+  ...codfishConfig,
+  // your overrides here
+};
+
+export default config;
+```
+
+### With dApps
+
+Similar to the issues with docker, there may be rules you want to adjust for dApp's. This config will set some globals
+as well as ignore missing build artifact imports. While you obviously need those to run your app, sometimes you might
+want to run the linter in a ci/cd environment and build artifacts might not be present.
+
+**Note**: The dApp config also includes the `import/no-unresolved` rule found in the docker config.
+
+You can also directly import the Prettier config:
+
+```js
+import prettierConfig from '@codfish/eslint-config/prettier';
+export default prettierConfig;
+```
+
+### Docker Configuration
+
+For projects leveraging Docker containers, you may want to disable import resolution errors for `node_modules` if
+packages are only available in the container but you're running the linter locally.
+
+```js
+import codfish from '@codfish/eslint-config';
+import docker from '@codfish/eslint-config/docker';
+
+export default defineConfig(
+  codfish,
+  docker,
+
+  {
+    // Your app-specific overrides
+  },
+);
+```
+
+### Blockchain/dApp Configuration
+
+For decentralized applications that use build artifacts and blockchain globals, use the specialized dApp config:
+
+```js
+import codfish from '@codfish/eslint-config';
+import dappConfig from '@codfish/eslint-config/dapp';
+
+export default defineConfig(
+  codfish,
+  dapp,
+
+  {
+    // Your app-specific overrides
+  },
+);
+```
+
+The dApp configuration provides:
+
+- Blockchain-specific globals (`artifacts`, `contract`, `web3`, etc.)
+- Import resolution handling for smart contract build artifacts
+- Relaxed rules for generated contract files
+
+## Known issues
+
+> https://github.com/francoismassart/eslint-plugin-tailwindcss/issues/149
+
+When building dynamic classes, the auto sorting of tailwind classes can break things so beware.
+
+To avoid this happening you can re-wrap the dynamic class expression like so:
+
+```vue-html
+class="`p-0 ${`tw-border-${accentColor}`}`"
+```
+
+## Migration from Legacy Config
+
+If you're upgrading from an older version that used Airbnb presets:
+
+1. **Update to ESLint v9+**: `npm install --save-dev eslint@9`
+2. **Switch to flat config**: Replace `.eslintrc.js` with `eslint.config.js`
+3. **Use import syntax**: Change from `require()` to `import` statements
+4. **Remove explicit React config**: React support is now automatically detected
+5. **Update scripts**: Ensure your lint script runs `eslint .` (flat config auto-discovery)

package/commitlint.js

@@ -0,0 +1,9 @@
+export default {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'scope-case': [0],
+    'body-max-line-length': [0],
+    'footer-max-line-length': [0],
+    'subject-case': [0],
+  },
+};

package/dapp.js

@@ -0,0 +1,17 @@
+import { defineConfig } from 'eslint/config';
+
+export default defineConfig({
+  name: 'codfish/dapp',
+
+  files: ['**/contracts/**/*.{js,ts}', '**/migrations/**/*.{js,ts}', '**/truffle/**/*.{js,ts}'],
+
+  languageOptions: {
+    globals: {
+      artifacts: 'readonly',
+      assert: 'readonly',
+      contract: 'readonly',
+      deployer: 'readonly',
+      web3: 'readonly',
+    },
+  },
+});

package/dist/commitlint.d.ts

@@ -0,0 +1,12 @@
+declare namespace _default {
+    let _extends: string[];
+    export { _extends as extends };
+    export let rules: {
+        'scope-case': number[];
+        'body-max-line-length': number[];
+        'footer-max-line-length': number[];
+        'subject-case': number[];
+    };
+}
+export default _default;
+//# sourceMappingURL=commitlint.d.ts.map

package/dist/commitlint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commitlint.d.ts","sourceRoot":"","sources":["../commitlint.js"],"names":[],"mappings":""}

package/dist/dapp.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("eslint").Linter.Config<import("eslint").Linter.RulesRecord>[];
+export default _default;
+//# sourceMappingURL=dapp.d.ts.map

package/dist/dapp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dapp.d.ts","sourceRoot":"","sources":["../dapp.js"],"names":[],"mappings":""}

package/dist/docker.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("eslint").Linter.Config<import("eslint").Linter.RulesRecord>[];
+export default _default;
+//# sourceMappingURL=docker.d.ts.map

package/dist/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../docker.js"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("eslint").Linter.Config<import("eslint").Linter.RulesRecord>[];
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.js"],"names":[],"mappings":""}

package/dist/prettier.d.ts

@@ -0,0 +1,7 @@
+export default config;
+/**
+ * @see https://prettier.io/docs/configuration
+ * @type {import("prettier").Config}
+ */
+declare const config: import("prettier").Config;
+//# sourceMappingURL=prettier.d.ts.map

package/dist/prettier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prettier.d.ts","sourceRoot":"","sources":["../prettier.js"],"names":[],"mappings":";AAAA;;;GAGG;AACH,sBAFU,OAAO,UAAU,EAAE,MAAM,CAqBjC"}

package/dist/rules/config-files.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("eslint").Linter.Config<import("eslint").Linter.RulesRecord>[];
+export default _default;
+//# sourceMappingURL=config-files.d.ts.map

package/dist/rules/config-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-files.d.ts","sourceRoot":"","sources":["../../rules/config-files.js"],"names":[],"mappings":""}

package/dist/rules/jest.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("eslint").Linter.Config<import("eslint").Linter.RulesRecord>[];
+export default _default;
+//# sourceMappingURL=jest.d.ts.map

package/dist/rules/jest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.d.ts","sourceRoot":"","sources":["../../rules/jest.js"],"names":[],"mappings":""}

package/dist/rules/react.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("eslint").Linter.Config<import("eslint").Linter.RulesRecord>[];
+export default _default;
+//# sourceMappingURL=react.d.ts.map

package/dist/rules/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../rules/react.js"],"names":[],"mappings":""}

package/dist/rules/vitest.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("eslint").Linter.Config<import("eslint").Linter.RulesRecord>[];
+export default _default;
+//# sourceMappingURL=vitest.d.ts.map

package/dist/rules/vitest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../../rules/vitest.js"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,7 @@
+export function hasLocalConfig(moduleName: any, searchOptions?: {}): boolean;
+export function hasDep(props: any): boolean;
+export function hasDevDep(props: any): boolean;
+export function hasPeerDep(props: any): boolean;
+export function hasAnyDep(args: any): boolean;
+export function ifAnyDep(deps: any, t: any, f: any): any;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../utils.js"],"names":[],"mappings":"AA4BA,6EAKC;AAfgC,4CAA+D;AAA/D,+CAA+D;AAA/D,gDAA+D;AAMzF,8CAA8E;AAE9E,yDAAmE"}

package/docker.js

@@ -0,0 +1,13 @@
+import { defineConfig } from 'eslint/config';
+
+/**
+ * Turns off `import/no-unresolved` errors for node modules in projects using
+ * Docker, to avoid false positives.
+ */
+export default defineConfig({
+  name: 'codfish/docker',
+
+  rules: {
+    'import/no-unresolved': ['error', { ignore: ['^[^.]+'] }],
+  },
+});

package/index.js

@@ -0,0 +1,136 @@
+import js from '@eslint/js';
+import { defineConfig } from 'eslint/config';
+import prettier from 'eslint-plugin-prettier/recommended';
+import simpleImportSortPlugin from 'eslint-plugin-simple-import-sort';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+import prettierBuiltInConfig from './prettier.js';
+import configFilesConfig from './rules/config-files.js';
+import jestConfig from './rules/jest.js';
+import reactConfig from './rules/react.js';
+import vitestConfig from './rules/vitest.js';
+import { hasLocalConfig, ifAnyDep } from './utils.js';
+
+const useBuiltinPrettierConfig = !hasLocalConfig('prettier');
+
+/**
+ * Modern ESLint configuration with dynamic feature detection
+ * Supports TypeScript, React, Jest, Vitest, and Prettier
+ */
+export default defineConfig([
+  // Base JavaScript configuration
+  js.configs.recommended,
+
+  tseslint.configs.recommended,
+
+  // Base configuration for all files
+  {
+    name: 'codfish/base',
+
+    plugins: {
+      'simple-import-sort': simpleImportSortPlugin,
+    },
+
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        ...globals.es2022,
+      },
+    },
+
+    rules: {
+      // Custom Grouping: https://github.com/lydell/eslint-plugin-simple-import-sort#custom-grouping
+      // Examples: https://github.com/lydell/eslint-plugin-simple-import-sort/blob/main/examples/.eslintrc.js
+      'simple-import-sort/imports': [
+        'error',
+        {
+          groups: [
+            // 1. Node.js builtins prefixed with `node:` or node_modules
+            // Exclude relative imports using aliases like `@/` or `@{src|test|tests}` (common ts config paths).
+            ['^node:', '^\\u0000', '^(\\w|@(?!src|tests?\\/)\\w)'],
+            // All local imports:
+            // - Absolute imports and other imports like `@/foo`.
+            // - Anything not matched in another group.
+            // - Anything that starts with a dot.
+            ['^', '^\\.'],
+          ],
+        },
+      ],
+      'simple-import-sort/exports': 'error',
+
+      // 2. Encouraging `lodash-es` imports per file
+      // lodash imports should use `lodash-es` package and should be imported per file.
+      //    E.G: `import get from 'lodash-es/get'`
+      // More details in https://stackoverflow.com/questions/35250500/correct-way-to-import-lodash#answer-35251059
+      'no-restricted-imports': [
+        'error',
+        {
+          paths: [
+            {
+              name: 'lodash',
+              message: "Please use lodash-es direct import E.G: `import get from 'lodash-es/get'`",
+            },
+            {
+              name: 'lodash-es',
+              message: "Please use lodash-es direct import E.G: `import get from 'lodash-es/get'`",
+            },
+          ],
+          patterns: [
+            {
+              group: ['lodash/*'],
+              message: "Please use lodash-es direct import E.G: `import get from 'lodash-es/get'`",
+            },
+          ],
+        },
+      ],
+    },
+  },
+
+  // Custom ignores
+  {
+    name: 'codfish/ignores',
+
+    ignores: [
+      '!.github',
+      '!.vitepress',
+      '**/logs/',
+      'bin/*',
+      '**/dist/',
+      '**/dist-ssr/',
+      '**/cache/',
+      '**/coverage/',
+      'cypress/screenshots/',
+      'cypress/videos/',
+      'storybook-static/',
+    ],
+  },
+
+  // Configuration files (eslint, prettier, etc.)
+  configFilesConfig,
+
+  // React configuration (dynamic)
+  ifAnyDep('react', reactConfig, []),
+
+  // Jest OR Vitest configuration (dynamic)
+  ifAnyDep('jest', jestConfig, []),
+
+  // Vitest configuration (dynamic)
+  ifAnyDep('vitest', vitestConfig, []),
+
+  // Prettier plugin is responsible for running prettier as an ESLint
+  // rule and turning off ESLint rules that might conflict.
+  // IMPORTANT: KEEP THIS LAST TO OVERRIDE ESLINT!
+  prettier,
+
+  {
+    rules: {
+      // Reset prettier rule passing in codfish's prettier config.
+      // IMPORTANT: KEEP THIS LAST TO OVERRIDE PRETTIER PLUGIN!
+      'prettier/prettier': useBuiltinPrettierConfig ? ['error', prettierBuiltInConfig] : 'error',
+    },
+  },
+]);

package/package.json

@@ -0,0 +1,118 @@
+{
+  "name": "@codfish/eslint-config",
+  "version": "0.0.0-PR-124--3ca0d95",
+  "description": "Modern ESLint configuration with TypeScript, React, and testing framework support.",
+  "type": "module",
+  "main": "index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./index.js"
+    },
+    "./prettier": {
+      "types": "./dist/prettier.d.ts",
+      "default": "./prettier.js"
+    },
+    "./dapp": {
+      "types": "./dist/dapp.d.ts",
+      "default": "./dapp.js"
+    },
+    "./docker": {
+      "types": "./dist/docker.d.ts",
+      "default": "./docker.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc --emitDeclarationOnly",
+    "dev": "tsc --watch",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint .",
+    "fix": "prettier --write \"**/*.{json,css,scss,md}\" && npm run lint -- --fix",
+    "prepublishOnly": "npm run build",
+    "prepare": "husky"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codfish/eslint-config.git"
+  },
+  "keywords": [
+    "eslint",
+    "eslintconfig",
+    "config",
+    "codfish",
+    "prettier",
+    "javascript",
+    "styleguide"
+  ],
+  "author": "Chris O'Donnell <chris@codfish.dev> (https://www.codfish.dev)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/codfish/eslint-config-codfish/issues"
+  },
+  "homepage": "https://github.com/codfish/eslint-config-codfish#readme",
+  "peerDependencies": {
+    "eslint": ">= 9"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist",
+    "rules",
+    "index.js",
+    "prettier.js",
+    "dapp.js",
+    "docker.js",
+    "utils.js",
+    "commitlint.js"
+  ],
+  "dependencies": {
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/js": "^9.35.0",
+    "@vitest/eslint-plugin": "^1.3.10",
+    "cosmiconfig": "^9.0.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-jest": "^29.0.1",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "globals": "^16.4.0",
+    "lodash.has": "^4.5.2",
+    "prettier": "^3.6.2",
+    "read-package-up": "^11.0.0"
+  },
+  "devDependencies": {
+    "doctoc": "^2.2.1",
+    "eslint": "^9.35.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.1.6",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.44.0"
+  },
+  "commitlint": {
+    "extends": [
+      "./commitlint"
+    ]
+  },
+  "lint-staged": {
+    "*.{json,yml}": [
+      "prettier --write --config ./prettier.js"
+    ],
+    "*.md": [
+      "prettier --write --config ./prettier.js",
+      "doctoc --title '## Table of Contents'"
+    ]
+  },
+  "volta": {
+    "node": "24.8.0"
+  }
+}

package/prettier.js

@@ -0,0 +1,26 @@
+/**
+ * @see https://prettier.io/docs/configuration
+ * @type {import("prettier").Config}
+ */
+const config = {
+  printWidth: 120,
+  tabWidth: 2,
+  useTabs: false,
+  semi: true,
+  arrowParens: 'avoid',
+  endOfLine: 'lf',
+  htmlWhitespaceSensitivity: 'css',
+  insertPragma: false,
+  jsxSingleQuote: false,
+  quoteProps: 'as-needed',
+  requirePragma: false,
+  singleQuote: true,
+  trailingComma: 'all',
+  bracketSpacing: true,
+  bracketSameLine: false,
+  proseWrap: 'always',
+  vueIndentScriptAndStyle: false,
+  embeddedLanguageFormatting: 'auto',
+};
+
+export default config;

package/rules/config-files.js

@@ -0,0 +1,21 @@
+import { defineConfig } from 'eslint/config';
+
+/**
+ * Configuration files ESLint rules
+ * Allows importing dev dependencies in configuration files
+ */
+export default defineConfig({
+  name: 'codfish/config-files',
+
+  files: [
+    '*.config.{js,ts}',
+    '.eslintrc.{js,ts}',
+    '.prettierrc.{js,ts}',
+    '.commitlintrc.{js,ts}',
+    '.lintstagedrc.{js,ts}',
+  ],
+
+  rules: {
+    'import/no-extraneous-dependencies': 'off',
+  },
+});

package/rules/jest.js

@@ -0,0 +1,24 @@
+import { defineConfig } from 'eslint/config';
+import jest from 'eslint-plugin-jest';
+
+/**
+ * Jest ESLint configuration for flat config format
+ * Includes Jest-specific rules and globals for test files
+ */
+export default defineConfig([
+  {
+    name: 'codfish/jest',
+
+    files: [
+      '**/__tests__/**/*.{js,ts,jsx,tsx}',
+      '**/*.{test,spec}.{js,ts,jsx,tsx}',
+      '**/jest.config.{js,ts}',
+      '**/jest.setup.{js,ts}',
+      '**/setupTests.{js,ts}',
+      '**/testUtils.{js,ts}',
+      'tests/**/*.{js,ts,jsx,tsx}',
+    ],
+
+    ...jest.configs['flat/recommended'],
+  },
+]);

package/rules/react.js

@@ -0,0 +1,39 @@
+import { defineConfig } from 'eslint/config';
+import jsxA11y from 'eslint-plugin-jsx-a11y';
+import react from 'eslint-plugin-react';
+import reactHooks from 'eslint-plugin-react-hooks';
+import globals from 'globals';
+
+/**
+ * React ESLint configuration. Includes React, React Hooks, and JSX accessibility rules.
+ *
+ * - https://github.com/jsx-eslint/eslint-plugin-react
+ * - https://github.com/facebook/react/tree/main/packages/eslint-plugin-react-hooks
+ * - https://github.com/jsx-eslint/eslint-plugin-jsx-a11y
+ */
+export default defineConfig([
+  {
+    name: 'codfish/react',
+
+    files: ['**/*.{js,mjs,cjs,jsx,mjsx,ts,tsx,mtsx}'],
+
+    ...react.configs.flat.recommended,
+    ...jsxA11y.flatConfigs.recommended,
+
+    languageOptions: {
+      globals: {
+        ...globals.serviceworker,
+        ...globals.browser,
+      },
+    },
+  },
+
+  // React Hooks configuration
+  reactHooks.configs['recommended-latest'],
+
+  {
+    rules: {
+      'react-hooks/exhaustive-deps': 'off',
+    },
+  },
+]);

package/rules/vitest.js

@@ -0,0 +1,34 @@
+import vitest from '@vitest/eslint-plugin';
+import { defineConfig } from 'eslint/config';
+import globals from 'globals';
+
+/**
+ * Vitest ESLint configuration for flat config format
+ * Includes Vitest-specific rules and globals for test files
+ */
+export default defineConfig([
+  {
+    files: [
+      '**/*.{spec,test}.{js,ts,jsx,tsx}',
+      '**/tests/**/*.{js,ts,jsx,tsx}',
+      '**/__mocks__/**/*.{js,ts,jsx,tsx}',
+      '**/__tests__/**/*.{js,ts,jsx,tsx}',
+    ],
+
+    ...vitest.configs.recommended,
+
+    name: 'codfish/vitest',
+
+    languageOptions: {
+      globals: {
+        ...vitest.environments.env.globals,
+        ...globals.node,
+      },
+    },
+
+    rules: {
+      'no-console': 'off',
+      'tailwindcss/no-custom-classname': 'off',
+    },
+  },
+]);

package/utils.js

@@ -0,0 +1,34 @@
+/**
+ * Utility Methods
+ *
+ * Credit: Kent C. Dodds
+ *
+ * @see https://github.com/kentcdodds/kcd-scripts/blob/main/src/utils.js
+ */
+import fs from 'node:fs';
+import { cosmiconfigSync } from 'cosmiconfig';
+import has from 'lodash.has';
+import { readPackageUp } from 'read-package-up';
+
+const { packageJson: pkg, path: pkgPath } =
+  (await readPackageUp({
+    cwd: fs.realpathSync(process.cwd()),
+  })) || {};
+
+const hasPkgProp = props => [props].flat().some(prop => has(pkg, prop));
+const hasPkgSubProp = pkgProp => props => hasPkgProp([props].flat().map(p => `${pkgProp}.${p}`));
+
+export const hasDep = hasPkgSubProp('dependencies');
+
+export const hasDevDep = hasPkgSubProp('devDependencies');
+export const hasPeerDep = hasPkgSubProp('peerDependencies');
+export const hasAnyDep = args => [hasDep, hasDevDep, hasPeerDep].some(fn => fn(args));
+
+export const ifAnyDep = (deps, t, f) => (hasAnyDep([deps].flat()) ? t : f);
+
+export function hasLocalConfig(moduleName, searchOptions = {}) {
+  const explorerSync = cosmiconfigSync(moduleName, searchOptions);
+  const result = explorerSync.search(pkgPath || './');
+
+  return result !== null;
+}