tslint.json

{
  "extends": ["rxjs-tslint-rules"],
  "rulesDirectory": [
    "./tools/tslint-rules/",
    "node_modules/vrsource-tslint-rules/rules",
    "node_modules/codelyzer"
  ],
  "rules": {
    "ban-types": [true, ["ReadonlyArray<.+>", "Use 'readonly T[]' instead."]],
    // Disable this flag because of SHA tslint#48b0c597f9257712c7d1f04b55ed0aa60e333f6a
    // TSLint now shows warnings if types for properties are inferred. This rule needs to be
    // disabled because all properties need to have explicit types set to work for Dgeni.
    "no-inferrable-types": false,
    "comment-format": [true, "check-space"],
    "eofline": true,
    "no-construct": true,
    "prefer-literal": [true, "object"],
    "no-duplicate-variable": true,
    "no-eval": true,
    "no-arg": true,
    "no-internal-module": true,
    "no-trailing-whitespace": true,
    "no-shadowed-variable": true,
    "no-unused-expression": true,
    "no-unused-variable": true,
    "no-var-keyword": true,
    "member-access": [true, "no-public"],
    "no-debugger": true,
    "variable-name": [
      true,
      "ban-keywords",
      "check-format",
      "allow-leading-underscore",
      "allow-snake-case"
    ],
    // Bans jasmine helper functions that will prevent the CI from properly running tests.
    "ban": [
      true,
      ["fit"],
      ["fdescribe"],
      ["xit"],
      ["xdescribe"],
      {"name": ["first"], "message": "Use take(1) instead."},
      {"name": ["Object", "assign"], "message": "Use the spread operator instead."},
      {"name": ["*", "asObservable"], "message": "Cast to Observable type instead."},
      {"name": ["*", "removeChild"], "message": "Use `remove` instead instead."},
      {
        "name": ["isDevMode"],
        "message": "Use `typeof ngDevMode === 'undefined' || ngDevMode` instead"
      }
    ],
    // Avoids inconsistent linebreak styles in source files. Forces developers to use LF linebreaks.
    "linebreak-style": [true, "LF"],
    // Namespaces are not allowed, because of Closure compiler.
    "no-namespace": true,
    "jsdoc-format": [true, "check-multiline-start"],
    "no-duplicate-imports": true,
    "await-promise": [true, "PromiseLike"],
    "array-type": [true, "array"],

    // Codelyzer
    "template-banana-in-box": true,
    "contextual-lifecycle": true,
    "contextual-decorator": true,
    "no-output-on-prefix": true,
    "prefer-output-readonly": true,
    "template-no-negated-async": true,
    "use-lifecycle-interface": true,

    // RxJS
    "rxjs-no-unsafe-takeuntil": true,
    "rxjs-no-unsafe-catch": true,

    // Custom Rules
    "ts-loader": true,
    "no-exposed-todo": true,
    "no-type-only-import-export": true,
    "no-private-getters": [true, "^_"],
    "no-undecorated-base-class-di": true,
    "no-undecorated-class-with-angular-features": true,
    "setters-after-getters": true,
    "ng-on-changes-property-access": true,
    "require-breaking-change-version": true,
    "no-nested-ternary": true,
    "prefer-const-enum": true,
    "no-lifecycle-invocation": [true, "**/!(*.spec).ts"],
    "lightweight-tokens": [
      true,
      ["src/**/!(*.spec).ts"],
      // Directionality is always used in Angular Material and therefore does not
      // need a lightweight token. Date Adapter is not very significant and does not
      // need a dedicated token.
      ["Directionality", "DateAdapter"]
    ],
    "no-coercion-members": true,
    "no-host-decorator-in-concrete": [true, "HostBinding", "HostListener"],
    "member-naming": [
      true,
      {
        "private": "^_"
      }
    ],
    "symbol-naming": [true, "^_?[A-Z][a-zA-Z0-9]*$"],
    "validate-decorators": [
      true,
      {
        "Component": {
          "argument": 0,
          "properties": {
            "!host": "\\[class\\]",
            "!preserveWhitespaces": ".*",
            "!styles": ".*",
            "!moduleId": ".*",
            "changeDetection": "\\.OnPush$",
            "encapsulation": "\\.None$"
          }
        },
        "Directive": {
          "argument": 0,
          "properties": {
            "!host": "\\[class\\]"
          }
        },
        "NgModule": {
          "argument": 0,
          "properties": {
            "*": "^(?!\\s*$).+"
          }
        },
        "ContentChildren": {
          "argument": 1,
          "required": true,
          "properties": {
            "descendants": "^(true|false)$"
          }
        }
      },
      "src/!(e2e-app|components-examples|universal-app|dev-app)/**/!(*.spec).ts"
    ],
    "require-license-banner": [
      true,
      "src/!(e2e-app|components-examples|universal-app)/**/!(*.spec).ts",
      "test/benchmarks/**/*.ts"
    ],
    "no-cross-entry-point-relative-imports": [
      true,
      "src/!(e2e-app|components-examples|universal-app|dev-app)/**/!(*.spec).ts",
      "!src/+(cdk|material)/schematics/**/*",
      "!src/cdk/testing/+(private|tests)/**/*",
      "!src/google-maps/testing/**/*"
    ],
    "file-name-casing": [
      true,
      {
        // Exclude custom lint rule files since they have to always be camel-cased and end
        // with "Rule".
        "\\w+Rule.ts": "camel-case",
        ".*": "kebab-case"
      }
    ],
    "no-unescaped-html-tag": true,
    // Ensures that all rxjs imports come only from `rxjs` and `rxjs/operators`.
    "import-blacklist": [true, ["^rxjs(?!$|/operators$).*"]]
  },
  "linterOptions": {
    "exclude": [
      // Exclude the API golden files
      "tools/public_api_guard/**/*.d.ts",
      // Exclude schematic template files and test cases that can't be linted.
      "src/material/schematics/ng-generate/*/files/**/*",
      "src/cdk/schematics/ng-generate/*/files/**/*",
      "src/cdk/schematics/ng-update/test-cases/**/*_input.ts",
      "src/cdk/schematics/ng-update/test-cases/**/*_expected_output.ts",
      "src/material/schematics/ng-update/test-cases/**/*_input.ts",
      "src/material/schematics/ng-update/test-cases/**/*_expected_output.ts",
      // These CLI-generated projects are not necessarily compliant with the lint
      // rules and they should remain as unmodified as possible.
      "integration/ng-add/**/*",
      "integration/ng-add-standalone/**/*",
      "integration/ng-update-v13/**/*"
    ]
  }
}