eslint-plugin-greasemonkey 1.8.2 → 1.8.4

package/README.md

@@ -6,7 +6,7 @@
     <img alt="[Latest Build]" src="https://img.shields.io/npm/v/eslint-plugin-greasemonkey?logo=icinga&style=for-the-badge&label=Latest%20Build&color=32fcee"></a>
 <a href="#license">
     <img alt="[License: MIT]" src="https://img.shields.io/badge/License-MIT-f1f20a.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
-<a>
+<a target="_blank" href="https://getnpmstats.com/?package=eslint-plugin-greasemonkey&range=last-year&interval=monthly">
     <img src="https://img.shields.io/npm/dm/eslint-plugin-greasemonkey?style=for-the-badge&logo=npm&color=black"></a>
 <a target="_blank" href="https://eslint.org/">
     <img alt="[Requires ESLint >=9.0.0]" src="https://img.shields.io/badge/Requires-ESLint_%3E%3D9.0.0-4B32C3?style=for-the-badge&logo=eslint"></a>
@@ -52,7 +52,7 @@ export default [
 ]
 ```
 
-Available bundles: `recommended`, `strict`, `problem`, `tampermonkey`, `violentmonkey`, `greasemonkey`, `scriptcat`, `adguard`
+Available bundles: `recommended`, `strict` (everything), `problem` (deterministic bugs only), `tampermonkey`, `violentmonkey`, `greasemonkey`, `scriptcat`, `adguard`
 
 **Note:** Rule config is either a severity string (`'off'`, `'warn'`, `'error'`) or an array `[severity, options]` when the rule accepts options.
 
@@ -82,7 +82,7 @@ Available bundles: `recommended`, `strict`, `problem`, `tampermonkey`, `violentm
 
 <summary>Enforces a preferred order for metadata keys.</summary>
 
-#### Options
+<h4 id="meta-order-options">Options</h4>
 
 - `order` (default `[]`) – metadata keys in custom order (e.g. `['license', 'namespace']`) to selectively override built-in order with
 
@@ -125,7 +125,18 @@ If you don't care about the order of metadata fields.
 #### See also
 
 - [`meta-spacing`](#meta-spacing)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Accepts eslint --fix" target="_blank" href="https://eslint.org/docs/latest/use/command-line-interface#--fix"><img height=14 alt="[Auto-fixable]" src="https://img.shields.io/badge/Auto--fixable-3b5bdb?style=flat-square" align="middle"></a>
+    <a title="Doesn't prevent bugs" href="#meta-spacing"><img height=14 alt="[Stylistic]" src="https://img.shields.io/badge/Stylistic-af68ff?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#meta-spacing-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 - [`no-invalid-headers`](#no-invalid-headers)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Optimized in tampermonkey config" href="#usage"><img height=14 alt="[Tampermonkey]" src="https://img.shields.io/badge/Tampermonkey-00485b?style=flat-square" align="middle"></a>
+    <a title="Optimized in violentmonkey config" href="#usage"><img height=14 alt="[Violentmonkey]" src="https://img.shields.io/badge/Violentmonkey-f01e07?style=flat-square" align="middle"></a>
+    <a title="Optimized in greasemonkey config" href="#usage"><img height=14 alt="[Greasemonkey]" src="https://img.shields.io/badge/Greasemonkey-6c4d8c?style=flat-square" align="middle"></a>
+    <a title="Optimized in scriptcat config" href="#usage"><img height=14 alt="[ScriptCat]" src="https://img.shields.io/badge/ScriptCat-1296dc?style=flat-square" align="middle"></a>
+    <a title="Optimized in adguard config" href="#usage"><img height=14 alt="[AdGuard]" src="https://img.shields.io/badge/AdGuard-68bd72?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#no-invalid-headers-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -156,7 +167,7 @@ If you don't care about the order of metadata fields.
 
 <summary>Aligns metadata values to the column after the longest key.</summary>
 
-#### Options
+<h4 id="meta-spacing-options">Options</h4>
 
 - `spaces` (default `3`) – minimum spaces after the longest key
 
@@ -197,7 +208,13 @@ If you don't care about visual alignment in metadata blocks.
 #### See also
 
 - [`require-blank-line-after-meta-block`](#require-blank-line-after-meta-block)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Accepts eslint --fix" target="_blank" href="https://eslint.org/docs/latest/use/command-line-interface#--fix"><img height=14 alt="[Auto-fixable]" src="https://img.shields.io/badge/Auto--fixable-3b5bdb?style=flat-square" align="middle"></a>
+    <a title="Doesn't prevent bugs" href="#require-blank-line-after-meta-block"><img height=14 alt="[Stylistic]" src="https://img.shields.io/badge/Stylistic-af68ff?style=flat-square" align="middle"></a>
 - [`require-space-before-meta-key`](#require-space-before-meta-key)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Accepts eslint --fix" target="_blank" href="https://eslint.org/docs/latest/use/command-line-interface#--fix"><img height=14 alt="[Auto-fixable]" src="https://img.shields.io/badge/Auto--fixable-3b5bdb?style=flat-square" align="middle"></a>
+    <a title="Doesn't prevent bugs" href="#require-space-before-meta-key"><img height=14 alt="[Stylistic]" src="https://img.shields.io/badge/Stylistic-af68ff?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -261,7 +278,11 @@ If you intentionally repeat single-value keys.
 #### See also
 
 - [`require-matching-localized-fields`](#require-matching-localized-fields)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#require-matching-localized-fields-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 - [`require-required-fields`](#require-required-fields)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#require-required-fields-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -298,7 +319,7 @@ If you intentionally repeat single-value keys.
 
 <summary>Disallows invalid or unsupported <code>@grant</code> values.</summary>
 
-#### Options
+<h4 id="no-invalid-grants-options">Options</h4>
 
 - `target` (default `'all'`) – manager(s) whose grants to validate against (`'all'`, `'tampermonkey'`, `'violentmonkey'`, `'greasemonkey'`, `'scriptcat'`, `'adguard'`), as a single string or array
 - `allowedGrants` (default `[]`) – additional `@grant` values to allow beyond the built-in list (covering Tampermonkey, Violentmonkey, Greasemonkey, ScriptCat and AdGuard), as a single string or array
@@ -354,7 +375,9 @@ If you don't want `@grant` validation at all. For individual uncovered grants, p
 #### See also
 
 - [`no-missing-grants`](#no-missing-grants)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
 - [`no-unused-grants`](#no-unused-grants)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -391,7 +414,7 @@ If you don't want `@grant` validation at all. For individual uncovered grants, p
 
 <summary>Disallows invalid or unsupported metadata headers.</summary>
 
-#### Options
+<h4 id="no-invalid-headers-options">Options</h4>
 
 - `target` (default `'all'`) – manager(s) whose headers to validate against (`'all'`, `'tampermonkey'`, `'violentmonkey'`, `'greasemonkey'`, `'scriptcat'`, `'adguard'`), as a single string or array
 - `allowedHeaders` (default `[]`) – additional headers to allow (strings or regexes), as a single value or array
@@ -435,7 +458,16 @@ If your script relies heavily on custom headers and you'd rather not maintain `a
 #### See also
 
 - [`no-invalid-grants`](#no-invalid-grants)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Optimized in tampermonkey config" href="#usage"><img height=14 alt="[Tampermonkey]" src="https://img.shields.io/badge/Tampermonkey-00485b?style=flat-square" align="middle"></a>
+    <a title="Optimized in violentmonkey config" href="#usage"><img height=14 alt="[Violentmonkey]" src="https://img.shields.io/badge/Violentmonkey-f01e07?style=flat-square" align="middle"></a>
+    <a title="Optimized in greasemonkey config" href="#usage"><img height=14 alt="[Greasemonkey]" src="https://img.shields.io/badge/Greasemonkey-6c4d8c?style=flat-square" align="middle"></a>
+    <a title="Optimized in scriptcat config" href="#usage"><img height=14 alt="[ScriptCat]" src="https://img.shields.io/badge/ScriptCat-1296dc?style=flat-square" align="middle"></a>
+    <a title="Optimized in adguard config" href="#usage"><img height=14 alt="[AdGuard]" src="https://img.shields.io/badge/AdGuard-68bd72?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#no-invalid-grants-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 - [`valid-field-values`](#valid-field-values)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#valid-field-values-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -492,7 +524,15 @@ If you use APIs through aliases or wrappers that obscure the original call site.
 #### See also
 
 - [`no-invalid-grants`](#no-invalid-grants)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Optimized in tampermonkey config" href="#usage"><img height=14 alt="[Tampermonkey]" src="https://img.shields.io/badge/Tampermonkey-00485b?style=flat-square" align="middle"></a>
+    <a title="Optimized in violentmonkey config" href="#usage"><img height=14 alt="[Violentmonkey]" src="https://img.shields.io/badge/Violentmonkey-f01e07?style=flat-square" align="middle"></a>
+    <a title="Optimized in greasemonkey config" href="#usage"><img height=14 alt="[Greasemonkey]" src="https://img.shields.io/badge/Greasemonkey-6c4d8c?style=flat-square" align="middle"></a>
+    <a title="Optimized in scriptcat config" href="#usage"><img height=14 alt="[ScriptCat]" src="https://img.shields.io/badge/ScriptCat-1296dc?style=flat-square" align="middle"></a>
+    <a title="Optimized in adguard config" href="#usage"><img height=14 alt="[AdGuard]" src="https://img.shields.io/badge/AdGuard-68bd72?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#no-invalid-grants-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 - [`no-unused-grants`](#no-unused-grants)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -549,6 +589,7 @@ If you reference resources through an alias or computed pattern that obscures th
 #### See also
 
 - [`no-unused-resources`](#no-unused-resources)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -602,7 +643,15 @@ If you access the granted API through an alias or computed property rather than
 #### See also
 
 - [`no-invalid-grants`](#no-invalid-grants)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Optimized in tampermonkey config" href="#usage"><img height=14 alt="[Tampermonkey]" src="https://img.shields.io/badge/Tampermonkey-00485b?style=flat-square" align="middle"></a>
+    <a title="Optimized in violentmonkey config" href="#usage"><img height=14 alt="[Violentmonkey]" src="https://img.shields.io/badge/Violentmonkey-f01e07?style=flat-square" align="middle"></a>
+    <a title="Optimized in greasemonkey config" href="#usage"><img height=14 alt="[Greasemonkey]" src="https://img.shields.io/badge/Greasemonkey-6c4d8c?style=flat-square" align="middle"></a>
+    <a title="Optimized in scriptcat config" href="#usage"><img height=14 alt="[ScriptCat]" src="https://img.shields.io/badge/ScriptCat-1296dc?style=flat-square" align="middle"></a>
+    <a title="Optimized in adguard config" href="#usage"><img height=14 alt="[AdGuard]" src="https://img.shields.io/badge/AdGuard-68bd72?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#no-invalid-grants-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 - [`no-missing-grants`](#no-missing-grants)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -656,6 +705,7 @@ If you pass resource names through variables or aliases rather than use them lit
 #### See also
 
 - [`no-missing-resources`](#no-missing-resources)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -707,8 +757,8 @@ If you rely on `@include` patterns that cannot be expressed using `@match`.
 
 #### See also
 
-- <a target="_blank" href="https://www.tampermonkey.net/documentation.php?locale=en&q=include#meta:match">Tampermonkey — `@match`</a>
-- <a target="_blank" href="https://www.tampermonkey.net/documentation.php?locale=en&q=include#meta:include">Tampermonkey — `@include`</a>
+- <img height=12 src="https://www.google.com/s2/favicons?domain=tampermonkey.net&sz=64">&ensp;<a target="_blank" href="https://www.tampermonkey.net/documentation.php?locale=en&q=include#meta:match">Tampermonkey — `@match`</a>
+- <img height=12 src="https://www.google.com/s2/favicons?domain=tampermonkey.net&sz=64">&ensp;<a target="_blank" href="https://www.tampermonkey.net/documentation.php?locale=en&q=include#meta:include">Tampermonkey — `@include`</a>
 
 <div align="center">
 
@@ -771,7 +821,15 @@ If you don't care about visual separation between metadata and code.
 #### See also
 
 - [`meta-order`](#meta-order)
+    <a title="Only included in strict config" href="#usage"><img height=14 alt="[Strict only]" src="https://img.shields.io/badge/Strict_only-ff8c42?style=flat-square" align="middle"></a>
+    <a title="Accepts eslint --fix" target="_blank" href="https://eslint.org/docs/latest/use/command-line-interface#--fix"><img height=14 alt="[Auto-fixable]" src="https://img.shields.io/badge/Auto--fixable-3b5bdb?style=flat-square" align="middle"></a>
+    <a title="Doesn't prevent bugs" href="#meta-order"><img height=14 alt="[Stylistic]" src="https://img.shields.io/badge/Stylistic-af68ff?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#meta-order-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 - [`meta-spacing`](#meta-spacing)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Accepts eslint --fix" target="_blank" href="https://eslint.org/docs/latest/use/command-line-interface#--fix"><img height=14 alt="[Auto-fixable]" src="https://img.shields.io/badge/Auto--fixable-3b5bdb?style=flat-square" align="middle"></a>
+    <a title="Doesn't prevent bugs" href="#meta-spacing"><img height=14 alt="[Stylistic]" src="https://img.shields.io/badge/Stylistic-af68ff?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#meta-spacing-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -825,9 +883,8 @@ If you don't care about ensuring homepage URL compatibility across different man
 
 #### See also
 
-- [`require-update-download-pair`](#require-update-download-pair)
-- <a target="_blank" href="https://www.tampermonkey.net/documentation.php?q=homepage#meta:homepage">Tampermonkey `@homepage`, `@homepageURL`, `@website`, `@source`</a>
-- <a target="_blank" href="https://docs.scriptcat.org/en/docs/dev/meta/#homepage-homepageurl-website">ScriptCat `@homepage`, `@homepageURL`, `@website`</a>
+- <img height=12 src="https://www.google.com/s2/favicons?domain=tampermonkey.net&sz=64">&ensp;<a target="_blank" href="https://www.tampermonkey.net/documentation.php?q=homepage#meta:homepage">Tampermonkey `@homepage`, `@homepageURL`, `@website`, `@source`</a>
+- <img height=12 src="https://www.google.com/s2/favicons?domain=docs.scriptcat.org&sz=64">&ensp;<a target="_blank" href="https://docs.scriptcat.org/en/docs/dev/meta/#homepage-homepageurl-website">ScriptCat `@homepage`, `@homepageURL`, `@website`</a>
 
 <div align="center">
 
@@ -854,7 +911,7 @@ If you don't care about ensuring homepage URL compatibility across different man
 
 <summary>Requires that every <code>@name:xx</code> has a matching <code>@description:xx</code> (and vice versa).</summary>
 
-#### Options
+<h4 id="require-matching-localized-fields-options">Options</h4>
 
 - `ignoreLanguages` (default `[]`) – language code(s) to skip (e.g. `'de'` or `['es', 'fr']`)
 
@@ -896,7 +953,10 @@ If you intentionally provide localized names without descriptions (or vice versa
 #### See also
 
 - [`no-duplicate-keys`](#no-duplicate-keys)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
 - [`require-required-fields`](#require-required-fields)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#require-required-fields-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -923,7 +983,7 @@ If you intentionally provide localized names without descriptions (or vice versa
 
 <summary>Requires essential metadata fields (<code>@name</code>, <code>@version</code> and at least one <code>@match</code> or <code>@include</code>).</summary>
 
-#### Options
+<h4 id="require-required-fields-options">Options</h4>
 
 - `fields` (default `['name', 'version']`) – override the required field list
 - `requireMatchOrInclude` (default `true`) – require `@match` or `@include`
@@ -962,7 +1022,10 @@ If your script is a work-in-progress, or metadata is injected at build time.
 #### See also
 
 - [`no-duplicate-keys`](#no-duplicate-keys)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
 - [`require-matching-localized-fields`](#require-matching-localized-fields)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#require-matching-localized-fields-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -1021,7 +1084,14 @@ If you intentionally use a different prefix style.
 #### See also
 
 - [`meta-spacing`](#meta-spacing)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Accepts eslint --fix" target="_blank" href="https://eslint.org/docs/latest/use/command-line-interface#--fix"><img height=14 alt="[Auto-fixable]" src="https://img.shields.io/badge/Auto--fixable-3b5bdb?style=flat-square" align="middle"></a>
+    <a title="Doesn't prevent bugs" href="#meta-spacing"><img height=14 alt="[Stylistic]" src="https://img.shields.io/badge/Stylistic-af68ff?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#meta-spacing-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 - [`require-blank-line-after-meta-block`](#require-blank-line-after-meta-block)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Accepts eslint --fix" target="_blank" href="https://eslint.org/docs/latest/use/command-line-interface#--fix"><img height=14 alt="[Auto-fixable]" src="https://img.shields.io/badge/Auto--fixable-3b5bdb?style=flat-square" align="middle"></a>
+    <a title="Doesn't prevent bugs" href="#require-blank-line-after-meta-block"><img height=14 alt="[Stylistic]" src="https://img.shields.io/badge/Stylistic-af68ff?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -1048,7 +1118,7 @@ If you intentionally use a different prefix style.
 
 <summary>Requires SRI hashes on <code>@require</code> and <code>@resource</code> URLs.</summary>
 
-#### Options
+<h4 id="require-sri-hashing-options">Options</h4>
 
 - `algorithm` (default `'sha256'`) – SRI hash algorithm(s) to enforce (`'md5'`, `'sha1'`, `'sha256'`, `'sha384'`, `'sha512'`), as a single string or array
 
@@ -1088,10 +1158,8 @@ If you prefer shorter URLs, or don't support users who strictly enforce subresou
 
 #### See also
 
-- [`no-invalid-headers`](#no-invalid-headers)
-- [`require-required-fields`](#require-required-fields)
-- <a target="_blank" href="https://www.tampermonkey.net/documentation.php?q=sri">Tampermonkey — Subresource Integrity</a>
-- <a target="_blank" href="https://docs.scriptcat.org/en/docs/dev/meta/#resource-integrity-verification">ScriptCat — Resource Integrity Verification</a>
+- <img height=12 src="https://www.google.com/s2/favicons?domain=tampermonkey.net&sz=64">&ensp;<a target="_blank" href="https://www.tampermonkey.net/documentation.php?q=sri">Tampermonkey — Subresource Integrity</a>
+- <img height=12 src="https://www.google.com/s2/favicons?domain=docs.scriptcat.org&sz=64">&ensp;<a target="_blank" href="https://docs.scriptcat.org/en/docs/dev/meta/#resource-integrity-verification">ScriptCat — Resource Integrity Verification</a>
 
 <div align="center">
 
@@ -1141,7 +1209,7 @@ If you prefer shorter URLs, or don't support users who strictly enforce subresou
 
 #### When not to use it
 
-If you don't target Tampermonkey, ScriptCat or AdGuard (where `@updateURL` avoids re-downloading the full script on every update check).
+If you don't strictly target Tampermonkey, ScriptCat or AdGuard (where `@updateURL` avoids re-downloading the full script on every update check).
 
 #### Introduced in
 
@@ -1149,9 +1217,8 @@ If you don't target Tampermonkey, ScriptCat or AdGuard (where `@updateURL` avoid
 
 #### See also
 
-- [`require-homepage-pair`](#require-homepage-pair)
-- <a target="_blank" href="https://www.tampermonkey.net/documentation.php?q=update_url#meta:updateURL">Tampermonkey — `@updateURL`</a>
-- <a target="_blank" href="https://docs.scriptcat.org/en/docs/dev/meta/#updateurl">ScriptCat — `@updateURL`</a>
+- <img height=12 src="https://www.google.com/s2/favicons?domain=tampermonkey.net&sz=64">&ensp;<a target="_blank" href="https://www.tampermonkey.net/documentation.php?q=update_url#meta:updateURL">Tampermonkey — `@updateURL`</a>
+- <img height=12 src="https://www.google.com/s2/favicons?domain=docs.scriptcat.org&sz=64">&ensp;<a target="_blank" href="https://docs.scriptcat.org/en/docs/dev/meta/#updateurl">ScriptCat — `@updateURL`</a>
 
 <div align="center">
 
@@ -1222,7 +1289,7 @@ If you intentionally name your userscripts something other than `*.user.js`.
 
 <summary>Validates <code>@version</code> (semver or date format) and URL fields.</summary>
 
-#### Options
+<h4 id="valid-field-values-options">Options</h4>
 
 - `versionType` (default `'semver'`) – version format to enforce (`'semver'`, `'date'`)
 - `allowFutureDate` (default `false`) – allow `@version` dates later than the current date
@@ -1263,7 +1330,21 @@ If you use a custom versioning scheme or URLs that aren't standard.
 #### See also
 
 - [`no-invalid-grants`](#no-invalid-grants)
-- [`no-missing-resources`](#no-missing-resources)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Optimized in tampermonkey config" href="#usage"><img height=14 alt="[Tampermonkey]" src="https://img.shields.io/badge/Tampermonkey-00485b?style=flat-square" align="middle"></a>
+    <a title="Optimized in violentmonkey config" href="#usage"><img height=14 alt="[Violentmonkey]" src="https://img.shields.io/badge/Violentmonkey-f01e07?style=flat-square" align="middle"></a>
+    <a title="Optimized in greasemonkey config" href="#usage"><img height=14 alt="[Greasemonkey]" src="https://img.shields.io/badge/Greasemonkey-6c4d8c?style=flat-square" align="middle"></a>
+    <a title="Optimized in scriptcat config" href="#usage"><img height=14 alt="[ScriptCat]" src="https://img.shields.io/badge/ScriptCat-1296dc?style=flat-square" align="middle"></a>
+    <a title="Optimized in adguard config" href="#usage"><img height=14 alt="[AdGuard]" src="https://img.shields.io/badge/AdGuard-68bd72?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#no-invalid-grants-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
+- [`no-invalid-headers`](#no-invalid-headers)
+    <a title="Included in recommended config" href="#usage"><img height=14 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Optimized in tampermonkey config" href="#usage"><img height=14 alt="[Tampermonkey]" src="https://img.shields.io/badge/Tampermonkey-00485b?style=flat-square" align="middle"></a>
+    <a title="Optimized in violentmonkey config" href="#usage"><img height=14 alt="[Violentmonkey]" src="https://img.shields.io/badge/Violentmonkey-f01e07?style=flat-square" align="middle"></a>
+    <a title="Optimized in greasemonkey config" href="#usage"><img height=14 alt="[Greasemonkey]" src="https://img.shields.io/badge/Greasemonkey-6c4d8c?style=flat-square" align="middle"></a>
+    <a title="Optimized in scriptcat config" href="#usage"><img height=14 alt="[ScriptCat]" src="https://img.shields.io/badge/ScriptCat-1296dc?style=flat-square" align="middle"></a>
+    <a title="Optimized in adguard config" href="#usage"><img height=14 alt="[AdGuard]" src="https://img.shields.io/badge/AdGuard-68bd72?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" href="#no-invalid-headers-options"><img height=14 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
 
 <div align="center">
 
@@ -1283,7 +1364,7 @@ If you use a custom versioning scheme or URLs that aren't standard.
 #### HTML
 
 ```html
-<a href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/#readme">
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/#readme">
     <img height=32 alt="[Linted by eslint-plugin-greasemonkey]" src="https://img.shields.io/badge/Linted_by-eslint--plugin--greasemonkey-black?logo=eslint&logoColor=white&labelColor=464646&style=for-the-badge"></a>
 ```
 
@@ -1317,6 +1398,20 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ## <img height=30 width=29 align="top" src="https://api.iconify.design/bxs/package.svg?color=%232b2b2a"> Related
 
+<!-- eslint-plugin-chrome-extensions -->
+
+### <a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-chrome-extensions/#readme"><img height=15 width=auto src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/e9128375d4/assets/images/icons/eslint/purple/icon16.png"> eslint-plugin-chrome-extensions</a>
+
+<details>
+
+<summary>ESLint rules for Chrome extensions.</summary><br>
+
+> <a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-chrome-extensions/#readme"><img width=555 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-chrome-extensions/0b5e3e49/assets/images/screenshots/vs-code/squiggles.png"></a>
+
+> <a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-chrome-extensions/#installation"><b>Install</b></a> / <a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-chrome-extensions/#readme">Readme</a> / <a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-chrome-extensions/#supported-rules">Supported rules</a>
+
+</details>
+
 <!-- eslint-plugin-constructors -->
 
 ### <a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-constructors/#readme"><img height=15 width=auto src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/e9128375d4/assets/images/icons/eslint/purple/icon16.png"> eslint-plugin-constructors</a>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-greasemonkey",
-  "version": "1.8.2",
+  "version": "1.8.4",
   "description": "ESLint rules for Greasemonkey/Tampermonkey userscripts",
   "type": "module",
   "engines": {
@@ -34,7 +34,6 @@
   ],
   "types": "src/index.d.ts",
   "scripts": {
-    "prepare": "husky",
     "lint": "eslint . --cache && yamllint .",
     "lint:all": "eslint . && yamllint .",
     "lint:fix": "eslint . --fix --cache && yamllint .",
@@ -65,21 +64,20 @@
   "devDependencies": {
     "@e18e/eslint-plugin": "^0.8.1",
     "@eslint/js": "^10.0.1",
-    "@eslint/json": "^2.1.0",
-    "@eslint/markdown": "^8.0.3",
+    "@eslint/json": "^2.1.1",
+    "@eslint/markdown": "^7.5.1",
     "@stylistic/eslint-plugin": "^5.10.0",
-    "eslint": "^10.11.0",
-    "eslint-plugin-constructors": "^1.4.0",
+    "eslint": "^10.12.0",
+    "eslint-plugin-constructors": "^1.4.2",
     "eslint-plugin-eslint-plugin": "^7.6.2",
     "eslint-plugin-import-x": "^4.17.1",
-    "eslint-plugin-n": "^18.4.0",
+    "eslint-plugin-n": "^18.4.1",
     "eslint-plugin-no-secrets": "^2.3.3",
     "eslint-plugin-no-unsanitized": "^4.1.5",
     "eslint-plugin-promise": "^7.3.0",
     "eslint-plugin-regexp": "^3.3.1",
     "eslint-plugin-security": "^4.2.0",
     "globals": "^17.13.0",
-    "husky": "^9.1.7",
     "yamllint-js": "^0.2.4"
   }
 }

package/src/index.js

@@ -22,7 +22,7 @@ import requireUpdateDownloadPair from './rules/require-update-download-pair.js'
 import requireUserJsFilename from './rules/require-user-js-filename.js'
 import validFieldValues from './rules/valid-field-values.js'
 
-import { initDeprecatedAlias } from './utils.js'
+import { bundleRules, initDeprecatedAlias } from './utils.js'
 
 const plugin = {
     rules: {
@@ -57,33 +57,15 @@ for (const entry of Object.entries(oldRules))
 plugin.configs = {
     recommended: {
         plugins: { greasemonkey: plugin },
-        rules: {
-            'greasemonkey/meta-spacing': 'error',
-            'greasemonkey/no-duplicate-keys': 'error',
-            'greasemonkey/no-invalid-grants': 'error',
-            'greasemonkey/no-invalid-headers': 'error',
-            'greasemonkey/no-missing-grants': 'error',
-            'greasemonkey/no-unused-grants': 'error',
-            'greasemonkey/no-missing-resources': 'error',
-            'greasemonkey/no-unused-resources': 'error',
-            'greasemonkey/prefer-match': 'error',
-            'greasemonkey/require-blank-line-after-meta-block': 'error',
-            'greasemonkey/require-matching-localized-fields': 'error',
-            'greasemonkey/require-required-fields': 'error',
-            'greasemonkey/require-space-before-meta-key': 'error',
-            'greasemonkey/require-user-js-filename': 'error',
-            'greasemonkey/valid-field-values': 'error'
-        }
+        rules: bundleRules(plugin.rules, rule => rule.meta.docs.recommended, 'greasemonkey')
     },
     strict: {
         plugins: { greasemonkey: plugin },
-        rules: Object.fromEntries(Object.keys(plugin.rules).map(ruleId => [`greasemonkey/${ruleId}`, 'error']))
+        rules: bundleRules(plugin.rules, () => true, 'greasemonkey')
     },
     problem: {
         plugins: { greasemonkey: plugin },
-        rules: Object.fromEntries(Object.entries(plugin.rules)
-            .filter(([, rule]) => rule.meta.type == 'problem')
-            .map(([ruleId]) => [`greasemonkey/${ruleId}`, 'error']))
+        rules: bundleRules(plugin.rules, rule => rule.meta.type == 'problem', 'greasemonkey')
     }
 }
 

package/src/rules/meta-order.js

@@ -39,13 +39,13 @@ export default {
             properties: {
                 order: {
                     type: 'array', items: { type: 'string' },
-                    description: 'Metadata keys in preferred order; unspecified keys are ignored'
+                    description: 'Metadata keys in preferred order'
                 }
             },
             additionalProperties: false
         }],
         defaultOptions: [{ order: [] }],
-        messages: { wrongOrder: '@{{first}} should appear before @{{second}}' }
+        messages: { wrongOrder: '@{{first}} should appear before @{{second}}.' }
     },
 
     create(context) {

package/src/rules/meta-spacing.js

@@ -22,7 +22,7 @@ export default {
             additionalProperties: false
         }],
         defaultOptions: [{ spaces: 3 }],
-        messages: { misaligned: 'Metadata values should be aligned at column {{column}}' }
+        messages: { misaligned: 'Metadata values should be aligned at column {{column}}.' }
     },
 
     create(context) {

package/src/rules/no-duplicate-keys.js

@@ -14,7 +14,7 @@ export default {
             recommended: true
         },
         schema: [],
-        messages: { dupeKey: 'Duplicate @{{key}}' }
+        messages: { dupeKey: 'Duplicate @{{key}}.' }
     },
 
     create(context) {

package/src/rules/no-invalid-grants.js

@@ -1,6 +1,7 @@
-import { extractMetadata } from '../utils.js'
 import { allAPIs, supportsAPI } from '../data/apis.js'
 
+import { extractMetadata } from '../utils.js'
+
 const managers = ['tampermonkey', 'violentmonkey', 'greasemonkey', 'scriptcat', 'adguard'],
       specialGrants = new Set(['none', 'unsafeWindow', 'window.close', 'window.focus', 'window.onurlchange']),
       allGrants = new Set([...allAPIs, ...specialGrants]),
@@ -37,7 +38,7 @@ export default {
         defaultOptions: [{}],
         messages: {
             invalidGrant: 'Invalid @grant: "{{grant}}"',
-            unsupportedGrant: '"@{{grant}}" is not supported by {{target}} (only by {{supporting}})',
+            unsupportedGrant: '"@{{grant}}" is not supported by {{target}} (only by {{supporting}}).',
             wrongCase: 'Invalid @grant: "{{grant}}" (did you mean "{{suggestion}}"?)'
         }
     },
@@ -46,14 +47,15 @@ export default {
         const options = context.options[0] || {},
               rawTarget = options.target ?? 'all',
               targets = Array.isArray(rawTarget) ? rawTarget : [rawTarget],
-              allowedGrants = [options.allowedGrants ?? []].flat()
+              rawAllowed = options.allowedGrants ?? [],
+              allowedGrants = new Set(Array.isArray(rawAllowed) ? rawAllowed : [rawAllowed])
         return {
             Program() {
                 const metaEntries = extractMetadata(context.sourceCode),
                       grantEntries = metaEntries.filter(entry => entry.key == 'grant')
                 for (const grant of grantEntries) {
                     const grantName = grant.value.trim()
-                    if (specialGrants.has(grantName) || allowedGrants.includes(grantName)) continue
+                    if (specialGrants.has(grantName) || allowedGrants.has(grantName)) continue
                     if (!allGrants.has(grantName)) {
                         const suggestion = sortedGrants.get(grantName.toLowerCase())
                         if (suggestion && suggestion != grantName)

package/src/rules/no-invalid-headers.js

@@ -1,6 +1,7 @@
-import { extractMetadata } from '../utils.js'
 import { managerHeaders, managers, localizedHeaders, validHeaders } from '../data/headers.js'
 
+import { extractMetadata } from '../utils.js'
+
 function parseAllowedPattern(entry) {
     if (typeof entry != 'string' || !entry.startsWith('/')) return null
     const lastSlash = entry.lastIndexOf('/')
@@ -37,8 +38,8 @@ export default {
         }],
         defaultOptions: [{ allowedHeaders: [] }],
         messages: {
-            invalidHeader: 'Invalid header: "@{{header}}"',
-            unsupportedHeader: '"@{{header}}" is not supported by {{target}} (only by {{supporting}})'
+            invalidHeader: 'Invalid header: "@{{header}}".',
+            unsupportedHeader: '"@{{header}}" is not supported by {{target}} (only by {{supporting}}).'
         }
     },
 

package/src/rules/no-missing-grants.js

@@ -1,6 +1,7 @@
-import { extractMetadata } from '../utils.js'
 import { gmLegacyAPIs, gmModernAPIs, scAPIs } from '../data/apis.js'
 
+import { extractMetadata } from '../utils.js'
+
 const apis = new Set([...gmLegacyAPIs, ...gmModernAPIs, ...scAPIs]),
       grantlessAPIs = new Set(['GM_info', 'GM.info']) // always available, no grant required
 
@@ -13,7 +14,7 @@ export default {
             recommended: true
         },
         schema: [],
-        messages: { missingGrant: 'Missing @grant: "{{api}}"' }
+        messages: { missingGrant: 'Missing @grant: "{{api}}".' }
     },
 
     create(context) {

package/src/rules/no-missing-resources.js

@@ -13,8 +13,8 @@ export default {
         },
         schema: [],
         messages: {
-            missingResource: 'Missing @resource: "{{name}}"',
-            noMatchingResource: 'No declared @resource matches `{{pattern}}`'
+            missingResource: 'Missing @resource: "{{name}}".',
+            noMatchingResource: 'No declared @resource matches `{{pattern}}`.'
         }
     },
 

package/src/rules/prefer-match.js

@@ -9,7 +9,7 @@ export default {
             recommended: true
         },
         schema: [],
-        messages: { preferMatch: 'Use @match instead of @include' }
+        messages: { preferMatch: 'Use @match instead of @include.' }
     },
 
     create(context) {

package/src/rules/require-blank-line-after-meta-block.js

@@ -8,7 +8,7 @@ export default {
         },
         fixable: 'whitespace',
         schema: [],
-        messages: { missingBlankLine: 'Missing blank line after metadata block' }
+        messages: { missingBlankLine: 'Missing blank line after metadata block.' }
     },
 
     create(context) {

package/src/rules/require-homepage-pair.js

@@ -10,7 +10,7 @@ export default {
         },
         fixable: 'code',
         schema: [],
-        messages: { missingPair: 'Missing @{{missing}} (required when @{{present}} is used)' }
+        messages: { missingPair: 'Missing @{{missing}} (required when @{{present}} is used).' }
     },
 
     create(context) {

package/src/rules/require-matching-localized-fields.js

@@ -4,7 +4,7 @@ export default {
     meta: {
         type: 'problem',
         docs: {
-            description: 'Require matching localized name and description fields',
+            description: 'Require matching localized @name and @description fields',
             category: 'Possible Errors',
             recommended: true
         },
@@ -22,12 +22,13 @@ export default {
             additionalProperties: false
         }],
         defaultOptions: [{}],
-        messages: { missingPair: 'Missing matching @{{missing}} for @{{present}}' }
+        messages: { missingPair: 'Missing matching @{{missing}} for @{{present}}.' }
     },
 
     create(context) {
         const options = context.options[0] || {},
-              ignoreLanguages = [options.ignoreLanguages ?? []].flat()
+              rawLangs = options.ignoreLanguages ?? [],
+              ignoreLangs = new Set(Array.isArray(rawLangs) ? rawLangs : [rawLangs])
         return {
             Program() {
                 const metaEntries = extractMetadata(context.sourceCode),
@@ -36,14 +37,14 @@ export default {
                       nameLangs = new Set(nameEntries.map(entry => entry.key.split(':')[1])),
                       descLangs = new Set(descEntries.map(entry => entry.key.split(':')[1]))
                 for (const lang of nameLangs)
-                    if (!ignoreLanguages.includes(lang) && !descLangs.has(lang))
+                    if (!ignoreLangs.has(lang) && !descLangs.has(lang))
                         context.report({
                             node: nameEntries.find(entry => entry.key == `name:${lang}`).comment,
                             messageId: 'missingPair',
                             data: { missing: `description:${lang}`, present: `name:${lang}` }
                         })
                 for (const lang of descLangs)
-                    if (!ignoreLanguages.includes(lang) && !nameLangs.has(lang))
+                    if (!ignoreLangs.has(lang) && !nameLangs.has(lang))
                         context.report({
                             node: descEntries.find(entry => entry.key == `description:${lang}`).comment,
                             messageId: 'missingPair',

package/src/rules/require-required-fields.js

@@ -24,7 +24,7 @@ export default {
             additionalProperties: false
         }],
         defaultOptions: [{}],
-        messages: { missingField: 'Missing required metadata field: @{{field}}' }
+        messages: { missingField: 'Missing required metadata field: @{{field}}.' }
     },
 
     create(context) {

package/src/rules/require-space-before-meta-key.js

@@ -12,7 +12,7 @@ export default {
         },
         fixable: 'whitespace',
         schema: [],
-        messages: { badPrefix: '`{{actual}}` should be `// @{{key}}`' }
+        messages: { badPrefix: '`{{actual}}` should be `// @{{key}}`.' }
     },
 
     create(context) {

package/src/rules/require-update-download-pair.js

@@ -9,7 +9,7 @@ export default {
             recommended: false
         },
         schema: [],
-        messages: { missingPair: 'Missing @{{missing}} (required when @{{present}} is used)' }
+        messages: { missingPair: 'Missing @{{missing}} (required when @{{present}} is used).' }
     },
 
     create(context) {

package/src/rules/require-user-js-filename.js

@@ -9,7 +9,7 @@ export default {
             recommended: true
         },
         schema: [],
-        messages: { requireUserJS: 'Userscript filename should end in ".user.js"' }
+        messages: { requireUserJS: 'Userscript filename should end in ".user.js".' }
     },
 
     create(context) {

package/src/rules/valid-field-values.js

@@ -42,17 +42,17 @@ export default {
         }],
         defaultOptions: [{}],
         messages: {
-            invalidVersion: 'Invalid @version: must be a valid {{versionType}} (expected format: {{example}})',
-            futureVersion: 'Invalid @version: date cannot be in the future',
-            invalidURL: 'Invalid URL for @{{field}}',
-            invalidGrant: 'Unknown @grant: "{{grant}}"'
+            invalidVersion: 'Invalid @version: must be a valid {{versionType}} (expected format: {{example}}).',
+            futureVersion: 'Invalid @version: date cannot be in the future.',
+            invalidURL: 'Invalid URL for @{{field}}.',
+            invalidGrant: 'Unknown @grant: "{{grant}}".'
         }
     },
 
     create(context) {
         const options = context.options[0] || {},
               versionType = options.versionType || 'semver',
-              allowedGrants = options.allowedGrants || [],
+              allowedGrants = new Set(options.allowedGrants || []),
               allowFutureDate = options.allowFutureDate ?? false,
               timezone = options.timezone,
               example = versionType == 'semver' ? '1.2.3' : 'YYYY.M.D or YYYY.MM.DD'
@@ -66,7 +66,7 @@ export default {
             Program() {
                 const metaEntries = extractMetadata(context.sourceCode)
                 for (const entry of metaEntries) {
-                    if (entry.key == 'grant' && allowedGrants.length && !allowedGrants.includes(entry.value))
+                    if (entry.key == 'grant' && allowedGrants.size && !allowedGrants.has(entry.value))
                         context.report({ node: entry.comment, messageId: 'invalidGrant', data: { grant: entry.value }})
                     else if (entry.key == 'resource') {
                         const url = entry.value.trim().split(re.whitespace)[1]

package/src/utils.js

@@ -1,5 +1,11 @@
 const re = { whitespace: /\s/ }
 
+export function bundleRules(rules, predicate, pluginName) {
+    return Object.fromEntries(Object.entries(rules)
+        .filter(([, rule]) => predicate(rule))
+        .map(([ruleId]) => [`${pluginName}/${ruleId}`, 'error']))
+}
+
 export function extractMetadata(sourceCode) {
     const comments = sourceCode.getAllComments(),
           metaEntries = []