@unix/eslint 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 @unix
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @unix/eslint
+
+ESLint flat config for @unix projects.
+
+## Installation
+
+```sh
+pnpm add -D @unix/eslint eslint typescript
+```
+
+If your project only uses JavaScript, `typescript` is not required.
+
+## TypeScript Projects
+
+Create `eslint.config.js` in the project root:
+
+```js
+import config from '@unix/eslint'
+
+export default config
+```
+
+This entry enables the TypeScript rules by default and uses `parserOptions.projectService` to read the project's `tsconfig.json`.
+
+## JavaScript Projects
+
+```js
+import config from '@unix/eslint/js'
+
+export default config
+```
+
+## Extending The Config
+
+Spread the default config and append overrides when you need to adjust rules for specific files:
+
+```js
+import config from '@unix/eslint'
+
+export default [
+  ...config,
+  {
+    files: ['**/*.{test,spec}.{ts,tsx,mts,cts}'],
+    rules: {
+      '@typescript-eslint/no-magic-numbers': 'off',
+    },
+  },
+]
+```
+
+## License
+
+MIT

package/configs/js.js

@@ -0,0 +1,137 @@
+// @ts-check
+import eslint from '@eslint/js'
+import stylistic from '@stylistic/eslint-plugin'
+
+const jsFiles = ['**/*.{js,mjs,cjs,jsx}']
+
+const ignores = [
+  '**/node_modules/**',
+  '**/.git/**',
+  '**/.hg/**',
+  '**/.svn/**',
+  '**/dist/**',
+  '**/build/**',
+  '**/coverage/**',
+  '**/.cache/**',
+  '**/.eslintcache',
+  '**/.next/**',
+  '**/.nuxt/**',
+  '**/.output/**',
+  '**/.svelte-kit/**',
+  '**/.turbo/**',
+  '**/.vite/**',
+  '**/storybook-static/**',
+  '**/tmp/**',
+  '**/temp/**',
+]
+
+const withJsFiles = config => ({
+  ...config,
+  files: jsFiles,
+})
+
+export default [
+  {
+    ignores,
+  },
+  {
+    files: jsFiles,
+    languageOptions: {
+      ecmaVersion: 'latest',
+    },
+  },
+  {
+    ...eslint.configs.recommended,
+    files: jsFiles,
+  },
+  withJsFiles(stylistic.configs['disable-legacy']),
+  withJsFiles(stylistic.configs.recommended),
+  {
+    files: jsFiles,
+    rules: {
+      'func-style': ['error', 'expression', { allowArrowFunctions: true }],
+      'array-callback-return': 'error',
+      'constructor-super': 'error',
+      'for-direction': 'error',
+      'getter-return': 'error',
+      'no-await-in-loop': 'warn',
+      'no-class-assign': 'error',
+      'no-cond-assign': 'error',
+      'no-const-assign': 'error',
+      'no-constant-condition': 'warn',
+      'no-constructor-return': 'error',
+      'no-control-regex': 'error',
+      'no-debugger': 'error',
+      'no-dupe-args': 'error',
+      'no-dupe-class-members': 'error',
+      'no-dupe-else-if': 'error',
+      'no-dupe-keys': 'error',
+      'no-duplicate-case': 'error',
+      'no-duplicate-imports': 'error',
+      'no-empty-character-class': 'error',
+      'no-empty-pattern': 'error',
+      'no-ex-assign': 'error',
+      'no-fallthrough': 'error',
+      'no-func-assign': 'error',
+      'no-import-assign': 'error',
+      'no-inner-declarations': 'error',
+      'no-invalid-regexp': 'error',
+      'no-irregular-whitespace': 'error',
+      'no-loss-of-precision': 'error',
+      'no-self-assign': 'error',
+      'no-self-compare': 'error',
+      'no-setter-return': 'error',
+      'no-sparse-arrays': 'error',
+      'no-template-curly-in-string': 'error',
+      'no-unassigned-vars': 'warn',
+      'no-undef': 'error',
+      'no-unexpected-multiline': 'error',
+      'no-unmodified-loop-condition': 'error',
+      'no-unreachable': 'warn',
+      'no-unsafe-finally': 'error',
+      'no-unsafe-negation': 'warn',
+      'no-unused-private-class-members': 'warn',
+      'no-unused-vars': 'warn',
+      'no-use-before-define': 'error',
+      'no-useless-assignment': 'warn',
+      'require-atomic-updates': 'error',
+      'use-isnan': 'error',
+      'valid-typeof': 'error',
+      'arrow-body-style': ['error', 'as-needed'],
+      'block-scoped-var': 'error',
+      complexity: ['error', 3],
+      'consistent-return': 'off',
+      'default-case': 'error',
+      'default-case-last': 'error',
+      'default-param-last': 'error',
+      'dot-notation': 'off',
+      eqeqeq: 'error',
+      'max-classes-per-file': ['error', 3],
+      'max-depth': ['error', 3],
+      'max-nested-callbacks': ['error', 4],
+      'max-params': ['error', 4],
+      'no-alert': 'error',
+      'no-case-declarations': 'off',
+      'no-console': 'off',
+      'no-delete-var': 'error',
+      'no-div-regex': 'error',
+      'no-implied-eval': 'error',
+      'no-redeclare': 'error',
+      'no-regex-spaces': 'error',
+      'no-useless-return': 'off',
+      'no-var': 'error',
+      'prefer-arrow-callback': 'error',
+      'prefer-rest-params': 'error',
+      'no-else-return': ['error', { allowElseIf: false }],
+      curly: ['error', 'multi'],
+      '@stylistic/array-bracket-newline': ['error', { multiline: true }],
+      '@stylistic/array-element-newline': ['error', { multiline: true }],
+      '@stylistic/arrow-parens': ['error', 'as-needed'],
+      '@stylistic/implicit-arrow-linebreak': ['error', 'beside'],
+      '@stylistic/linebreak-style': ['error', 'unix'],
+      '@stylistic/multiline-comment-style': ['error', 'bare-block'],
+      '@stylistic/no-multiple-empty-lines': ['error', { max: 2, maxEOF: 1 }],
+      '@stylistic/nonblock-statement-body-position': ['error', 'beside'],
+    },
+  },
+]

package/configs/ts.js

@@ -0,0 +1,191 @@
+// @ts-check
+import eslint from '@eslint/js'
+import stylistic from '@stylistic/eslint-plugin'
+import tseslint from 'typescript-eslint'
+
+import js from './js.js'
+
+const tsFiles = ['**/*.{ts,mts,cts,tsx}']
+
+const classMemberOrder = [
+  [
+    'protected-static-readonly-field',
+    'protected-static-field',
+    'private-static-readonly-field',
+    'private-static-field',
+    'public-static-readonly-field',
+    'public-static-field',
+    'static-readonly-field',
+    'static-field',
+  ],
+  [
+    'protected-static-method',
+    'private-static-method',
+    'public-static-method',
+    'static-method',
+  ],
+  ['protected-abstract-method', 'public-abstract-method', 'abstract-method'],
+  [
+    'protected-decorated-readonly-field',
+    'protected-instance-readonly-field',
+    'protected-readonly-field',
+    'protected-decorated-field',
+    'protected-instance-field',
+    'protected-field',
+    'constructor',
+    'private-instance-readonly-field',
+    'private-readonly-field',
+    'private-instance-field',
+    'private-field',
+    'public-decorated-readonly-field',
+    'public-instance-readonly-field',
+    'public-readonly-field',
+    'public-decorated-field',
+    'public-instance-field',
+    'public-field',
+    'decorated-readonly-field',
+    'instance-readonly-field',
+    'readonly-field',
+    'decorated-field',
+    'instance-field',
+    'field',
+  ],
+  [
+    'protected-constructor',
+    'private-constructor',
+    'public-constructor',
+    'constructor',
+  ],
+  [
+    'protected-decorated-method',
+    'protected-instance-method',
+    'protected-method',
+    'private-instance-method',
+    'private-method',
+    'public-decorated-method',
+    'public-instance-method',
+    'public-method',
+    'decorated-method',
+    'instance-method',
+    'method',
+  ],
+]
+
+const recommendedTypeChecked = tseslint.configs.recommendedTypeChecked.map(
+  config => ({
+    ...config,
+    files: config.files ?? tsFiles,
+  }),
+)
+
+const withTsFiles = config => ({
+  ...config,
+  files: tsFiles,
+})
+
+export default tseslint.config(
+  ...js,
+  {
+    ...eslint.configs.recommended,
+    files: tsFiles,
+  },
+  ...recommendedTypeChecked,
+  {
+    files: tsFiles,
+    languageOptions: {
+      ecmaVersion: 'latest',
+      parserOptions: {
+        projectService: true,
+      },
+    },
+  },
+  withTsFiles(stylistic.configs['disable-legacy']),
+  withTsFiles(stylistic.configs.recommended),
+  {
+    files: tsFiles,
+    rules: {
+      '@typescript-eslint/consistent-type-assertions': [
+        'warn',
+        { assertionStyle: 'never' },
+      ],
+      '@typescript-eslint/member-ordering': [
+        'error',
+        {
+          classes: {
+            memberTypes: classMemberOrder,
+          },
+        },
+      ],
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/no-floating-promises': 'warn',
+      'func-style': ['error', 'expression', { allowArrowFunctions: true }],
+      'no-else-return': ['error', { allowElseIf: false }],
+      '@typescript-eslint/await-thenable': 'error',
+      '@typescript-eslint/consistent-generic-constructors': ['error', 'constructor'],
+      '@typescript-eslint/consistent-type-exports': 'error',
+      '@typescript-eslint/consistent-type-imports': 'error',
+      'default-param-last': 'off',
+      '@typescript-eslint/default-param-last': 'error',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-member-accessibility': [
+        'error',
+        {
+          accessibility: 'no-public',
+        },
+      ],
+      'max-params': 'off',
+      '@typescript-eslint/max-params': [
+        'error',
+        {
+          countVoidThis: false,
+          max: 4,
+        },
+      ],
+      '@typescript-eslint/no-array-delete': 'error',
+      '@typescript-eslint/no-duplicate-enum-values': 'error',
+      '@typescript-eslint/no-dynamic-delete': 'error',
+      '@typescript-eslint/no-empty-object-type': 'error',
+      '@typescript-eslint/no-extra-non-null-assertion': 'error',
+      '@typescript-eslint/no-for-in-array': 'error',
+      'no-implied-eval': 'off',
+      '@typescript-eslint/no-implied-eval': 'error',
+      'no-magic-numbers': 'off',
+      '@typescript-eslint/no-magic-numbers': 'error',
+      '@typescript-eslint/no-namespace': 'error',
+      '@typescript-eslint/no-non-null-asserted-optional-chain': 'error',
+      '@typescript-eslint/no-non-null-assertion': 'error',
+      'no-shadow': 'off',
+      '@typescript-eslint/no-shadow': 'error',
+      '@typescript-eslint/no-this-alias': 'error',
+      '@typescript-eslint/no-unnecessary-boolean-literal-compare': 'error',
+      '@typescript-eslint/no-unnecessary-condition': 'error',
+      '@typescript-eslint/no-unnecessary-parameter-property-assignment': 'error',
+      '@typescript-eslint/no-unnecessary-template-expression': 'error',
+      '@typescript-eslint/no-unnecessary-type-constraint': 'error',
+      '@typescript-eslint/no-unsafe-argument': 'warn',
+      '@typescript-eslint/no-unsafe-assignment': 'warn',
+      '@typescript-eslint/no-unsafe-call': 'warn',
+      '@typescript-eslint/no-unsafe-member-access': 'warn',
+      '@typescript-eslint/no-unsafe-return': 'error',
+      'no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': 'warn',
+      'no-use-before-define': 'off',
+      '@typescript-eslint/no-use-before-define': 'error',
+      '@typescript-eslint/no-useless-empty-export': 'off',
+      'no-throw-literal': 'off',
+      '@typescript-eslint/only-throw-error': 'error',
+      '@typescript-eslint/prefer-as-const': 'error',
+      'prefer-destructuring': 'off',
+      '@typescript-eslint/prefer-destructuring': 'off',
+      '@typescript-eslint/prefer-find': 'error',
+      '@typescript-eslint/prefer-for-of': 'error',
+      '@typescript-eslint/prefer-includes': 'error',
+      '@typescript-eslint/prefer-nullish-coalescing': 'error',
+      '@typescript-eslint/prefer-optional-chain': 'error',
+      '@typescript-eslint/prefer-regexp-exec': 'error',
+      '@typescript-eslint/prefer-string-starts-ends-with': 'error',
+      '@typescript-eslint/require-array-sort-compare': 'error',
+      '@typescript-eslint/unified-signatures': 'error',
+    },
+  },
+)

package/index.js

@@ -0,0 +1,4 @@
+// @ts-check
+export { default } from './configs/ts.js'
+export { default as js } from './configs/js.js'
+export { default as ts } from './configs/ts.js'

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@unix/eslint",
+  "version": "0.1.0",
+  "description": "ESLint config for all @unix projects.",
+  "type": "module",
+  "main": "index.js",
+  "author": "@unix",
+  "prettier": "@unix/prettier",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./js": "./configs/js.js",
+    "./ts": "./configs/ts.js"
+  },
+  "files": [
+    "index.js",
+    "configs",
+    "package.json",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/unix/eslint"
+  },
+  "keywords": [
+    "eslint",
+    "eslint-config",
+    "unix"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "eslint": ">=9.0.0",
+    "typescript": ">=4.8.4 <6.1.0"
+  },
+  "dependencies": {
+    "@eslint/js": "^10.0.1",
+    "@stylistic/eslint-plugin": "^5.10.0",
+    "typescript-eslint": "^8.59.2"
+  },
+  "devDependencies": {
+    "@unix/prettier": "^0.1.0",
+    "prettier": "^3.8.4"
+  },
+  "license": "MIT",
+  "scripts": {
+    "preview": "node scripts/preview.mjs",
+    "release": "pnpm publish --access public --no-git-checks"
+  }
+}