.eslintrc.json

{
  "$schema": "https://json.schemastore.org/eslintrc",
  "ignorePatterns": ["node_modules", "dist", "tmp", "__fixtures__", "__generated__", ".direnv", "bin/run.js"],
  "parser": "@typescript-eslint/parser",
  "parserOptions": {
    "project": true
  },
  "plugins": ["@typescript-eslint", "import", "unicorn", "only-warn"],
  "extends": [
    "eslint:recommended",
    "plugin:@typescript-eslint/strict-type-checked",
    "plugin:@typescript-eslint/stylistic-type-checked",
    "plugin:jsdoc/recommended-typescript",
    "plugin:import/recommended",
    "plugin:import/typescript",
    "prettier"
  ],
  "env": {
    "node": true
  },
  "settings": {
    "import/extensions": [".js", ".jsx", ".ts", ".tsx"],
    "import/resolver": {
      "node": true,
      "typescript": true
    }
  },
  "rules": {
    "curly": ["warn", "all"],
    "eqeqeq": ["warn", "smart"],
    "func-style": ["warn", "expression"],
    "max-depth": ["warn", 3],
    "no-unneeded-ternary": ["warn"],
    "object-shorthand": ["warn", "always"],
    "prefer-const": ["warn", { "destructuring": "all" }],
    "quotes": ["warn", "double", { "avoidEscape": true }],
    "spaced-comment": ["warn", "always"],

    "jsdoc/require-hyphen-before-param-description": ["warn"],
    "jsdoc/require-jsdoc": ["warn", { "publicOnly": true }],
    "jsdoc/require-param": ["off"],
    "jsdoc/require-returns": ["off"],
    "jsdoc/tag-lines": ["warn", "never", { "startLines": 1 }],

    "unicorn/consistent-destructuring": ["warn"],
    "unicorn/explicit-length-check": ["warn"],
    "unicorn/filename-case": ["warn", { "case": "kebabCase" }],
    "unicorn/no-null": ["warn"],
    "unicorn/no-object-as-default-parameter": ["warn"],
    "unicorn/prefer-node-protocol": ["warn"],
    "unicorn/template-indent": ["warn"],

    "@typescript-eslint/consistent-type-definitions": ["warn", "type"],
    "@typescript-eslint/consistent-type-imports": ["warn", { "prefer": "type-imports", "fixStyle": "inline-type-imports" }],
    // prettier-ignore
    "@typescript-eslint/explicit-function-return-type": ["warn", { "allowExpressions": true, "allowTypedFunctionExpressions": true, "allowHigherOrderFunctions": true, "allowDirectConstAssertionInArrowFunctions": true, "allowConciseArrowFunctionExpressionsStartingWithVoid": true, "allowFunctionsWithoutTypeParameters": false, "allowedNames": [], "allowIIFEs": false }],
    "@typescript-eslint/member-ordering": ["warn"],
    // prettier-ignore
    "@typescript-eslint/naming-convention": ["warn", { "selector": "memberLike", "modifiers": ["private"], "format": ["camelCase"], "leadingUnderscore": "require" }],
    "@typescript-eslint/no-confusing-void-expression": ["warn", { "ignoreArrowShorthand": true }],
    "@typescript-eslint/no-unused-expressions": ["warn", { "allowTaggedTemplates": true }],
    "@typescript-eslint/no-unused-vars": ["warn", { "varsIgnorePattern": "^_", "argsIgnorePattern": "^_" }],
    "@typescript-eslint/prefer-nullish-coalescing": ["warn", { "ignorePrimitives": { "string": true } }],
    "@typescript-eslint/restrict-template-expressions": ["warn", { "allowNumber": true }]
  },
  "overrides": [
    {
      "files": "src/**",
      "rules": {
        "no-restricted-imports": [
          "warn",
          {
            "paths": [
              {
                "name": "figures",
                "message": "use src/services/output/symbols.ts instead"
              }
            ],
            "patterns": [
              {
                "group": ["/src"],
                "message": "src files must be imported relatively (e.g. ../../src)"
              },
              {
                "group": ["spec/"],
                "message": "src files cannot import spec files"
              }
            ]
          }
        ]
      }
    },
    {
      "files": "src/services/util/**",
      "rules": {
        "no-restricted-imports": [
          "warn",
          {
            "paths": [
              {
                "name": "figures",
                "message": "use src/services/output/symbols.ts instead"
              }
            ],
            "patterns": [
              {
                "group": ["/src"],
                "message": "src files must be imported relatively (e.g. ../../src)"
              },
              {
                "group": ["../"],
                "message": "utilities can only import other utilities"
              }
            ]
          }
        ]
      }
    },
    {
      "files": "spec/**",
      "rules": {
        "no-restricted-imports": [
          "warn",
          {
            "paths": [{ "name": "node:test", "message": "Use 'vitest' instead" }],
            "patterns": [
              {
                "group": ["/src"],
                "message": "src files must be imported relatively (e.g. ../../src)"
              },
              {
                "group": ["/spec"],
                "message": "spec files must be imported relatively (e.g. ../../spec)"
              }
            ]
          }
        ],
        "@typescript-eslint/no-dynamic-delete": "off",
        "@typescript-eslint/no-explicit-any": "off",
        "@typescript-eslint/no-non-null-assertion": "off",
        "@typescript-eslint/no-unnecessary-condition": ["off"],
        "@typescript-eslint/no-unsafe-argument": "off",
        "@typescript-eslint/no-unsafe-assignment": "off",
        "@typescript-eslint/no-unsafe-call": ["off"],
        "@typescript-eslint/no-unsafe-member-access": ["off"],
        "@typescript-eslint/unbound-method": "off",
        "unicorn/template-indent": ["off"]
      }
    }
  ]
}