@layerzerolabs/eslint-configuration 0.0.73

package/base.js

@@ -0,0 +1,190 @@
+const typescriptEslint = require('@typescript-eslint/eslint-plugin');
+const onlyWarn = require('eslint-plugin-only-warn');
+const simpleImportSort = require('eslint-plugin-simple-import-sort');
+const tsParser = require('@typescript-eslint/parser');
+const globals = require('globals');
+const espree = require('espree');
+const js = require('@eslint/js');
+const turboConfigModule = require('eslint-config-turbo/flat');
+const turboConfig = turboConfigModule.default || turboConfigModule;
+const prettierConfig = require('eslint-config-prettier/flat');
+
+// Rules that work for both JavaScript and TypeScript
+const commonRules = {
+    'no-constant-condition': 'off',
+    'no-empty': 'off',
+    'no-unused-vars': 'off',
+    'no-redeclare': 'off',
+
+    'simple-import-sort/imports': [
+        'warn',
+        {
+            groups: [
+                ['^\\u0000'],
+                ['^@?\\w'],
+                ['^@(layerzerolabs|ui-internal|web3-ui-internal)/'],
+                ['^@/'],
+                ['^\\.'],
+            ],
+        },
+    ],
+
+    'simple-import-sort/exports': 'warn',
+};
+
+// Rules that require TypeScript type information (only for .ts/.tsx files)
+const typescriptRules = {
+    '@typescript-eslint/no-unused-vars': [
+        'warn',
+        {
+            argsIgnorePattern: '^_',
+            varsIgnorePattern: '^_',
+            caughtErrors: 'all',
+            caughtErrorsIgnorePattern: '^_',
+        },
+    ],
+
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/no-non-null-assertion': 'off',
+    '@typescript-eslint/no-empty-interface': 'off',
+
+    '@typescript-eslint/consistent-type-imports': [
+        'warn',
+        {
+            prefer: 'type-imports',
+        },
+    ],
+
+    '@typescript-eslint/no-floating-promises': 'warn',
+};
+
+module.exports = [
+    // ESLint recommended rules
+    js.configs.recommended,
+
+    // Turbo config (flat config format) - spread if array, otherwise include directly
+    ...(Array.isArray(turboConfig) ? turboConfig : [turboConfig]),
+
+    // Prettier config
+    prettierConfig,
+
+    // Base configuration (common rules for all files)
+    {
+        plugins: {
+            '@typescript-eslint': typescriptEslint,
+            'only-warn': onlyWarn,
+            'simple-import-sort': simpleImportSort,
+        },
+
+        languageOptions: {
+            globals: {
+                ...globals.node,
+            },
+        },
+
+        rules: {
+            ...commonRules,
+        },
+    },
+
+    // Global ignores
+    {
+        ignores: [
+            '**/node_modules/',
+            '**/dist/',
+            '**/build/',
+            '**/.next/',
+            '**/.turbo/',
+            '**/coverage/',
+            '**/.eslintrc.*',
+            '**/eslint.config.*',
+            '**/tsup.config.*',
+            '**/vitest.config.ts',
+            '**/wagmi*.config.ts',
+            '**/cdk.out/',
+            '**/bin/',
+            '**/vm-tooling/docker/',
+            '**/tooling-configs/eslint/**',
+            '**/*.hbs',
+            '**/generated/**',
+            '**/generated-artifacts/**',
+            '**/generated-tron/**',
+            '**/generated-tron-artifacts/**',
+            '**/generated-zk/**',
+            '**/generated-zk-artifacts/**',
+            '**/generated_artifacts/**',
+        ],
+    },
+
+    // TypeScript files
+    {
+        files: ['**/*.ts', '**/*.tsx'],
+
+        languageOptions: {
+            parser: tsParser,
+            parserOptions: {
+                project: true,
+            },
+        },
+        rules: {
+            ...typescriptRules,
+        },
+    },
+
+    // JavaScript files
+    {
+        files: ['**/*.js', '**/*.jsx'],
+
+        languageOptions: {
+            parser: espree,
+            ecmaVersion: 'latest',
+            sourceType: 'module',
+            parserOptions: {},
+        },
+    },
+
+    // Config files and CommonJS files
+    {
+        files: ['**/*.config.{js,ts}', '**/*.cjs'],
+
+        languageOptions: {
+            globals: {
+                ...globals.node,
+            },
+
+            parserOptions: {
+                project: null,
+            },
+        },
+
+        rules: {
+            'no-undef': 'off',
+            '@typescript-eslint/no-var-requires': 'off',
+            '@typescript-eslint/explicit-function-return-type': 'off',
+            '@typescript-eslint/no-floating-promises': 'off',
+            '@typescript-eslint/consistent-type-imports': 'off',
+        },
+    },
+
+    // Test files
+    {
+        files: ['**/*.test.*', '**/*.spec.*', '**/tests/**', '**/test/**'],
+
+        languageOptions: {
+            parserOptions: {
+                project: null,
+            },
+        },
+
+        rules: {
+            'no-console': 'off',
+            '@typescript-eslint/no-explicit-any': 'off',
+            '@typescript-eslint/no-non-null-assertion': 'off',
+            '@typescript-eslint/consistent-type-imports': 'off',
+            '@typescript-eslint/no-floating-promises': 'off',
+            'turbo/no-undeclared-env-vars': 'off',
+        },
+    },
+];

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@layerzerolabs/eslint-configuration",
+  "version": "0.0.73",
+  "private": false,
+  "exports": {
+    "./base": "./base.js",
+    "./next": "./next.js",
+    "./node": "./node.js",
+    "./server": "./server.js",
+    "./react-base": "./react-base.js",
+    "./react-internal": "./react-internal.js"
+  },
+  "files": [
+    "base.js",
+    "next.js",
+    "node.js",
+    "server.js",
+    "react-base.js",
+    "react-internal.js"
+  ],
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.37.0",
+    "@next/eslint-plugin-next": "15.1.3",
+    "@typescript-eslint/eslint-plugin": "^8.31.1",
+    "@typescript-eslint/parser": "^8.31.1",
+    "@vercel/style-guide": "6.0.0",
+    "eslint-config-prettier": "^10.1.2",
+    "eslint-config-turbo": "^2.5.8",
+    "eslint-plugin-only-warn": "1.1.0",
+    "eslint-plugin-simple-import-sort": "12.1.1",
+    "espree": "^10.3.0",
+    "globals": "^16.4.0"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/react-base.js

@@ -0,0 +1,20 @@
+const baseConfig = require('./base');
+
+/** @type {import("eslint").Linter.Config} */
+module.exports = Object.assign({}, baseConfig, {
+    extends: [...baseConfig.extends, 'plugin:react/recommended', 'plugin:react-hooks/recommended'],
+    plugins: [...baseConfig.plugins, 'react', 'react-hooks'],
+    rules: {
+        ...baseConfig.rules,
+        'react/jsx-key': 'off',
+        'react/prop-types': 'off',
+        'react/react-in-jsx-scope': 'off',
+        'react-hooks/rules-of-hooks': 'error',
+        'react-hooks/exhaustive-deps': 'warn',
+    },
+    settings: {
+        react: {
+            version: 'detect',
+        },
+    },
+});

package/react-internal.js

@@ -0,0 +1,17 @@
+const baseConfig = require('./react-base');
+
+/**
+ * This is a custom ESLint configuration for use with
+ * internal (bundled by their consumer) libraries
+ * that utilize React.
+ */
+/** @type {import("eslint").Linter.Config} */
+module.exports = Object.assign({}, baseConfig, {
+    globals: {
+        React: true,
+        JSX: true,
+    },
+    env: {
+        browser: true,
+    },
+});

package/server.js

@@ -0,0 +1,25 @@
+const baseConfig = require('./base');
+
+/**
+ * This is a custom ESLint configuration for use with Node.js server code.
+ */
+/** @type {import("eslint").Linter.Config} */
+module.exports = Object.assign({}, baseConfig, {
+    env: {
+        node: true,
+        vitest: true,
+    },
+    overrides: [
+        ...baseConfig.overrides,
+        {
+            files: ['**/__tests__/**/*', '**/*.test.*', '**/*.spec.*'],
+            extends: [],
+            rules: {
+                ...baseConfig.rules,
+                'no-console': 'off',
+                '@typescript-eslint/no-explicit-any': 'off',
+                '@typescript-eslint/no-non-null-assertion': 'off',
+            },
+        },
+    ],
+});