.hintrc

/**
 * Webhint does not support workspaces; the configuration file must be in root.
 * https://github.com/webhintio/hint/issues/3651
 */
{
  // "$schema": "https://raw.githubusercontent.com/webhintio/hint/main/packages/hint/src/lib/config/config-schema.json",
  "connector": {
    "name": "./dist/utils/webhint-puppeteer-connector.js"
    /*
    Enable and configure options when they're confirmed not to crash.
    "options": {
      "headless": true,
      "ignoreHTTPSErrors": false,
      "puppeteerOptions": {
        "detached": true,
        "dumpio": true
      },
      "waitUntil": "networkidle0"
    }
    */
  },
  "extends": [
    "accessibility",
    "development",
    "progressive-web-apps",
    "web-recommended"
  ],
  "formatters": [
    "codeframe",
    "./dist/utils/webhint-html-formatter.js",
    "./dist/utils/webhint-json-formatter.js",
    // "stylish", // This is just a worse version of `codeframe`.
    "summary"
  ],
  "hints": {
    "apple-touch-icons": "error",
    "axe/aria": "off",
    "axe/color": [
      "error",
      // https://webhint.io/docs/user-guide/hints/hint-axe/color/
      [
        "link-in-text-block"
      ]
    ],
    "axe/forms": [
      "error",
      // https://webhint.io/docs/user-guide/hints/hint-axe/forms/#additional-rules-off-by-default
      [
        "label-title-only"
      ]
    ],
    "axe/keyboard": "off",
    "axe/language": "error",
    "axe/name-role-value": [
      "error",
      // https://webhint.io/docs/user-guide/hints/hint-axe/name-role-value/#additional-rules-off-by-default
      [
        "empty-heading"
      ]
    ],
    "axe/parsing": "error",
    "axe/semantics": [
      "error",
      // https://webhint.io/docs/user-guide/hints/hint-axe/semantics/#additional-rules-off-by-default
      [
        "heading-order",
        "label-content-name-mismatch",
        "landmark-banner-is-top-level",
        "landmark-complementary-is-top-level",
        "landmark-contentinfo-is-top-level",
        "landmark-main-is-top-level",
        "landmark-no-duplicate-banner",
        "landmark-no-duplicate-contentinfo",
        "landmark-no-duplicate-main",
        "landmark-one-main",
        "landmark-unique",
        "p-as-heading",
        "page-has-heading-one"
      ]
    ],
    "axe/sensory-and-visual-cues": [
      "error",
      // https://webhint.io/docs/user-guide/hints/hint-axe/sensory-and-visual-cues/#additional-rules-off-by-default
      [
        "meta-viewport",
        "meta-viewport-large"
      ]
    ],
    "axe/structure": [
      "error",
      // https://webhint.io/docs/user-guide/hints/hint-axe/structure/#additional-rules-off-by-default
      [
        "css-orientation-lock",
        "frame-tested",
        "hidden-content"
      ]
    ],
    "axe/tables": [
      "error",
      // https://webhint.io/docs/user-guide/hints/hint-axe/tables/#additional-rules-off-by-default
      [
        "scope-attr-valid",
        "table-duplicate-name",
        "table-fake-caption",
        "td-has-header"
      ]
    ],
    "axe/text-alternatives": [
      "error",
      // https://webhint.io/docs/user-guide/hints/hint-axe/text-alternatives/#additional-rules-off-by-default
      [
        "frame-title-unique",
        "image-redundant-alt",
        "svg-img-alt"
      ]
    ],
    "axe/time-and-media": [
      "error",
      // https://webhint.io/docs/user-guide/hints/hint-axe/time-and-media/#additional-rules-off-by-default
      [
        "no-autoplay-audio"
      ]
    ],
    "babel-config/is-valid": "error",
    "button-type": "error",
    "compat-api/css": [
      "error",
      {
        "ignore": [
          "backdrop-filter",
          "text-size-adjust: none"
        ]
      }
    ],
    "compat-api/html": [
      "error",
      {
        "ignore": [
          "meta[name=theme-color]",
          "search"
        ]
      }
    ],
    "content-type": "error",
    "create-element-svg": "error",
    "css-prefix-order": "error",
    "detect-css-reflows/composite": "error",
    "detect-css-reflows/layout": "error",
    "detect-css-reflows/paint": "error",
    "disown-opener": "error",
    "doctype": "off",
    "highest-available-document-mode": "error",
    "html-checker": "off",
    "http-cache": "error",
    "http-compression": "error",
    // TODO: Reenable this once the Microsoft Edge Tools VS Code extension can find the dependency.
    // "https-only": "error",
    // Env: webhint_hints_image-optimization-cloudinary_1_apiSecret
    "image-optimization-cloudinary": "off",
    "leading-dot-classlist": "error",
    "manifest-app-name": "error",
    "manifest-exists": "error",
    "manifest-file-extension": "error",
    "manifest-is-valid": "error",
    "meta-charset-utf-8": "error",
    /**
     * Webhint incorrectly flags multiple theme colors.
     * https://github.com/webhintio/hint/issues/6001
     */
    "meta-theme-color": "off",
    "meta-viewport": "error",
    // TODO: Reenable this once the Microsoft Edge Tools VS Code extension can find the dependency.
    // "minified-js": "error",
    "no-bom": "error",
    // TODO: Reenable this once the Microsoft Edge Tools VS Code extension can find the dependency.
    // "no-broken-links": "error",
    "no-disallowed-headers": "error",
    "no-friendly-error-pages": "error",
    "no-html-only-headers": "error",
    "no-http-redirects": "error",
    // Inline styles are beneficial when an elements has ~1 unique property.
    "no-inline-styles": "off",
    // TODO: Reenable this once the Microsoft Edge Tools VS Code extension can find the dependency.
    // "no-p3p": "error",
    "no-protocol-relative-urls": "error",
    "no-vulnerable-javascript-libraries": "error",
    // TODO: Reenable this once the Microsoft Edge Tools VS Code extension can find the dependency.
    // "performance-budget": "error",
    "scoped-svg-styles": "error",
    "sri": [
      "error",
      {
        "originCriteria": "all"
      }
    ],
    "ssllabs": "error",
    "strict-transport-security": "error",
    "stylesheet-limit": "off",
    "typescript-config/import-helpers": "error",
    /**
     * TypeScript already handles configuration file validation. Webhint's
     * validation contains inaccuracies, like "generateCpuProfile, mapRoot,
     * sourceRoot, and tsBuildInfoFile must be 'string'" despite `null` being a
     * valid value.
     */
    "typescript-config/is-valid": "off",
    /**
     * Removing comments as part of a separate minification step is
     * recommended instead. https://github.com/webhintio/hint/issues/4839
     */
    "typescript-config/no-comments": "off",
    "typescript-config/strict": "error",
    "typescript-config/target": "error",
    "validate-set-cookie-header": "error",
    "webpack-config/config-exists": "off",
    "webpack-config/is-installed": "off",
    "webpack-config/is-valid": "error",
    "webpack-config/module-esnext-typescript": "error",
    "webpack-config/modules-false-babel": "error",
    "webpack-config/no-devtool-in-prod": "error",
    "x-content-type-options": "error"
  },
  "parsers": [
    "babel-config",
    "css",
    "html",
    "javascript",
    "jsx",
    "manifest",
    "package-json",
    "sass",
    "typescript",
    "typescript-config",
    "webpack-config"
  ]
}