Extract rule: template-no-restricted-invocations

Author: NullVoxPopuli

README.md

@@ -261,6 +261,7 @@ rules in templates can be disabled with eslint directives with mustache or html
 | [template-no-page-title-component](docs/rules/template-no-page-title-component.md)                                 | disallow usage of ember-page-title component                                 |    |    |    |
 | [template-no-positional-data-test-selectors](docs/rules/template-no-positional-data-test-selectors.md)             | disallow positional data-test-* params in curly invocations                  |    |    |    |
 | [template-no-potential-path-strings](docs/rules/template-no-potential-path-strings.md)                             | disallow potential path strings in attribute values                          |    |    |    |
+| [template-no-restricted-invocations](docs/rules/template-no-restricted-invocations.md)                             | disallow certain components, helpers or modifiers from being used            |    |    |    |
 | [template-no-splattributes-with-class](docs/rules/template-no-splattributes-with-class.md)                         | disallow splattributes with class attribute                                  |    |    |    |
 | [template-no-this-in-template-only-components](docs/rules/template-no-this-in-template-only-components.md)         | disallow this in template-only components (gjs/gts)                          |    | 🔧 |    |
 | [template-no-trailing-spaces](docs/rules/template-no-trailing-spaces.md)                                           | disallow trailing whitespace at the end of lines in templates                |    | 🔧 |    |

docs/rules/template-no-restricted-invocations.md

@@ -0,0 +1,77 @@
+# ember/template-no-restricted-invocations
+
+<!-- end auto-generated rule header -->
+
+Disallow certain components, helpers or modifiers from being used.
+
+Use cases include:
+
+- You bring in some addon with helpers or components, but your team deems one or many not suitable and wants to guard against their usage
+- You want to discourage use of a deprecated component
+
+## Examples
+
+Given a config of:
+
+```json
+{ "template-no-restricted-invocations": ["foo-bar"] }
+```
+
+This rule **forbids** the following:
+
+```gjs
+<template>{{foo-bar}}</template>
+```
+
+```gjs
+<template>{{#foo-bar}}{{/foo-bar}}</template>
+```
+
+```gjs
+<template><FooBar /></template>
+```
+
+This rule **allows** the following:
+
+```gjs
+<template>{{baz}}</template>
+```
+
+```gjs
+<template><Baz /></template>
+```
+
+## Configuration
+
+One of these:
+
+- `string[]` - helpers or components to disallow (using kebab-case names like `nested-scope/component-name`)
+- `object[]` - with the following keys:
+  - `names` - `string[]` - helpers or components to disallow
+  - `message` - `string` - custom error message to report for violations
+
+```js
+// .eslintrc.js
+module.exports = {
+  rules: {
+    'ember/template-no-restricted-invocations': [
+      'error',
+      [
+        'foo-bar',
+        {
+          names: ['deprecated-component'],
+          message: 'Use new-component instead',
+        },
+      ],
+    ],
+  },
+};
+```
+
+## Related Rules
+
+- [ember/no-restricted-service-injections](https://github.com/ember-cli/eslint-plugin-ember/blob/master/docs/rules/no-restricted-service-injections.md)
+
+## References
+
+- [emberjs.com - Deprecations](https://guides.emberjs.com/release/deprecations/)