Merge pull request #2715 from johanrd/feat/hbs-parser-reexport

feat: re-export hbs parser and document HBS flat-config setup

Author: NullVoxPopuli

README.md

@@ -174,6 +174,36 @@ export default [
 
 `template-lint-migration` mirrors the ember-template-lint `recommended` preset.
 
+### Linting `.hbs` files
+
+ESLint flat config only picks up `.hbs` files when a `files` glob names them. Add a dedicated block so they route to the Handlebars parser:
+
+```js
+// eslint.config.mjs
+import { hbsParser, plugin as emberPlugin } from 'eslint-plugin-ember/recommended';
+
+export default [
+  // ...other blocks...
+  {
+    files: ['app/**/*.hbs'],
+    languageOptions: { parser: hbsParser },
+    plugins: { ember: emberPlugin },
+    rules: {
+      'ember/template-no-bare-strings': 'error',
+      // ...other template rules...
+    },
+  },
+];
+```
+
+Make sure no earlier `@typescript-eslint/parser` block's `files` glob reaches `.hbs` — narrow it to `['**/*.{js,ts,gjs,gts}']` (or similar). Flat config merges rules across every matching block, so even if our HBS block overrides the parser, type-info rules from a matching TS block still layer on and fail with errors like:
+
+> Parsing error: `…` was not found by the project service because the extension for the file (`.hbs`) is non-standard.
+
+or
+
+> Error while loading rule `@typescript-eslint/await-thenable`: You have used a rule which requires type information.
+
 ### Replacing `template-lint-disable` comments
 
 Inline disable directives need to be rewritten to ESLint's syntax, prefixed with `ember/template-`. For now, only two scopes are supported: the next line, or the rest of the file. For example, replace:

eslint.config.js

@@ -224,7 +224,7 @@ module.exports = [
       'import/default': 'off',
       'import/no-named-as-default': 'off',
       'import/no-named-as-default-member': 'off',
-      'import/no-unresalved': 'off',
+      'import/no-unresolved': 'off',
       'import/no-missing-import': 'off',
 
       // vite config format does not match regex

lib/recommended.mjs

@@ -3,9 +3,11 @@ import baseRules from './recommended-rules.js';
 import gjsRules from './recommended-rules-gjs.js';
 import gtsRules from './recommended-rules-gts.js';
 import emberParser from 'ember-eslint-parser';
+import emberHbsParser from 'ember-eslint-parser/hbs';
 
 export const plugin = emberPlugin;
 export const parser = emberParser;
+export const hbsParser = emberHbsParser;
 
 export const base = {
   name: 'ember:base',
@@ -57,6 +59,7 @@ export default {
   // Helpful utility exports
   plugin,
   parser,
+  hbsParser,
   // Recommended config sets
   configs: {
     base,