npm - eslint-plugin-greasemonkey - Versions diffs - 1.5.1 → 1.5.2 - Mend

eslint-plugin-greasemonkey 1.5.1 → 1.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md +286 -147
package/package.json +2 -2
package/src/data/apis.js +0 -1
package/src/data/deprecations.js +5 -2
package/src/index.js +19 -21
package/src/rules/meta-order.js +3 -3
package/src/rules/require-sri-hashing.js +1 -1
/package/src/rules/{valid-grants.js → no-invalid-grants.js} +0 -0

package/README.md CHANGED Viewed

@@ -7,7 +7,8 @@
 <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 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>
+    <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>
+<br><br>
 ESLint rules for Greasemonkey userscripts.
@@ -25,7 +26,12 @@ npm i -D eslint-plugin-greasemonkey
 ---
-## Usage
+<h2 id="usage">
+    Usage
+    <a title="Copy section URL" target="_blank"
+       href="https://copy-to-clipboard.onrender.com/copy/https%3A%2F%2Fcodeberg.org%2Fadamlui%2Feslint-plugin-greasemonkey%2F%23usage">
+        <img height=17 width=22 alt="[Copy section URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="bottom"></a>
+</h2>
 Add a bundled config to your `eslint.config.*js`:
@@ -52,31 +58,12 @@ Avaialble bundles: `recommended`, `strict`, `tampermonkey`, `violentmonkey`, `gr
 ---
-## Supported rules
-| ID | Description | Auto-fixable | Recommended |
-| --- | --- | :-: | :-: |
-| [`meta-order`](#meta-order) | Enforces a preferred order for metadata keys | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> |
-| [`meta-spacing`](#meta-spacing) | Aligns metadata values to the column after the longest key | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`no-duplicate-keys`](#no-duplicate-keys) | Disallows duplicate metadata keys | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`no-invalid-headers`](#no-invalid-headers) | Disallows invalid or unsupported metadata headers | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`no-missing-grants`](#no-missing-grants) | Flags API calls w/o a matching `@grant` | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`no-missing-resources`](#no-missing-resources) | Flags `@resource` references w/o a matching declaration | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`no-unused-grants`](#no-unused-grants) | Flags `@grant` entries whose APIs are never used | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`no-unused-resources`](#no-unused-resources) | Flags `@resource` entries that are never referenced | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`prefer-match`](#prefer-match) | Prefers `@match` over `@include` | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`require-blank-line-after-meta-block`](#require-blank-line-after-meta-block) | Requires a blank line between the metadata and code | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`require-homepage-pair`](#require-homepage-pair) | Requires `@homepage` and `@homepageURL` to be used together | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> |
-| [`require-matching-localized-fields`](#require-matching-localized-fields) | Requires matching localized `@name:xx` / `@description:xx` pairs | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`require-required-fields`](#require-required-fields) | Requires essential metadata fields | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`require-space-before-meta-key`](#require-space-before-meta-key) | Requires exactly one space between `//` and metadata keys | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`require-sri-hashing`](#require-sri-hashing) | Requires SRI hashes for external `@require` URLs | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`require-update-download-pair`](#require-update-download-pair) | Requires `@updateURL` and `@downloadURL` to be used together | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> |
-| [`require-user-js-filename`](#require-user-js-filename) | Requires userscript filenames end in `.user.js` | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`valid-field-values`](#valid-field-values) | Validates `@version` and URL fields | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
-| [`valid-grants`](#valid-grants) | Disallows invalid or unsupported `@grant` values | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> | <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> |
----
+<h2 id="supported-rules">
+    Supported rules
+    <a title="Copy section URL" target="_blank"
+       href="https://copy-to-clipboard.onrender.com/copy/https%3A%2F%2Fcodeberg.org%2Fadamlui%2Feslint-plugin-greasemonkey%2F%23supported-rules">
+        <img height=17 width=22 alt="[Copy section URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="bottom"></a>
+</h2>
 <h3 id="meta-order">
     <code>meta-order</code>
@@ -84,7 +71,7 @@ Avaialble bundles: `recommended`, `strict`, `tampermonkey`, `violentmonkey`, `gr
         <img height=18 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=18 alt="[Auto-fixable]" src="https://img.shields.io/badge/Auto--fixable-e8357a?style=flat-square" align="middle"></a>
-    <a title="Doesn't catch bugs" href="#meta-order">
+    <a title="Doesn't prevent bugs" href="#meta-order">
         <img height=18 alt="[Stylistic]" src="https://img.shields.io/badge/Stylistic-af68ff?style=flat-square" align="middle"></a>
     <a title="Accepts array w/ options" target="_blank" href="https://eslint.org/docs/latest/extend/custom-rules#option-defaults">
         <img height=18 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
@@ -93,18 +80,14 @@ Avaialble bundles: `recommended`, `strict`, `tampermonkey`, `violentmonkey`, `gr
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Enforces a preferred order for metadata keys.
+<details>
+<summary>Enforces a preferred order for metadata keys.</summary>
 #### Options
 - `string[]` (default `[]`) – metadata keys in custom order
-For example:
-```js
-/* eslint greasemonkey/meta-order: ['error', ['run-in', 'inject-into']] */
-```
 #### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect code
 ```diff
@@ -115,12 +98,6 @@ For example:
 ! // @namespace     example.com
   // @author        John Doe
 ! // @license       MIT
-  // @icon          https://example.com/icon.png
-! // @match         https://example.com/*
-  // @grant         GM_setValue
-  // @require       https://example.com/lib.js
-  // @resource      logo https://example.com/logo.png
-! // @connect       example.com
   // ==/UserScript==
 ```
@@ -137,16 +114,6 @@ For example:
 + // @namespace     example.com
 + // @version       1.0.0
 + // @license       MIT
-  // @icon          https://example.com/icon.png
-- // @match         https://example.com/*
-+ // @connect       example.com
-  // @grant         GM_setValue
-- // @require       https://example.com/lib.js
-- // @resource      logo https://example.com/logo.png
-- // @connect       example.com
-+ // @match         https://example.com/*
-+ // @require       https://example.com/lib.js
-+ // @resource      logo https://example.com/logo.png
   // ==/UserScript==
 ```
@@ -154,6 +121,10 @@ For example:
 If you don't care about the order of metadata fields.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.5.0">v1.5.0</a> (September 15, 2026)
 #### See also
 - [`meta-spacing`](#meta-spacing)
@@ -167,13 +138,15 @@ If you don't care about the order of metadata fields.
 ---
+</details>
 <h3 id="meta-spacing">
     <code>meta-spacing</code>
     <a title="Included in recommended config" href="#usage">
         <img height=18 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=18 alt="[Auto-fixable]" src="https://img.shields.io/badge/Auto--fixable-e8357a?style=flat-square" align="middle"></a>
-    <a title="Doesn't catch bugs" href="#meta-spacing">
+    <a title="Doesn't prevent bugs" href="#meta-spacing">
         <img height=18 alt="[Stylistic]" src="https://img.shields.io/badge/Stylistic-af68ff?style=flat-square" align="middle"></a>
     <a title="Accepts array w/ options" target="_blank" href="https://eslint.org/docs/latest/extend/custom-rules#option-defaults">
         <img height=18 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
@@ -182,7 +155,9 @@ If you don't care about the order of metadata fields.
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Aligns metadata values to the column after the longest key.
+<details>
+<summary>Aligns metadata values to the column after the longest key.</summary>
 #### Options
@@ -218,6 +193,10 @@ If you don't care about the order of metadata fields.
 If you don't care about visual alignment in metadata blocks.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.0.0">v1.0.0</a> (September 9, 2026)
 #### See also
 - [`require-blank-line-after-meta-block`](#require-blank-line-after-meta-block)
@@ -231,6 +210,8 @@ If you don't care about visual alignment in metadata blocks.
 ---
+</details>
 <h3 id="no-duplicate-keys">
     <code>no-duplicate-keys</code>
     <a title="Included in recommended config" href="#usage">
@@ -240,7 +221,9 @@ If you don't care about visual alignment in metadata blocks.
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Disallows duplicate metadata keys. Multi-value keys are exempt (`@compatible`, `@connect`, `@description`, `@exclude`, `@exclude-match`, `@grant`, `@homepageURL`, `@include`, `@license`, `@match`, `@require`, `@resource`, `@supportURL`).
+<details>
+<summary>Disallows duplicate single-value metadata keys.</summary>
 #### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect code
@@ -250,6 +233,8 @@ If you don't care about visual alignment in metadata blocks.
 ! // @name      Bar
 ! // @version   1.0.0
 ! // @version   2.0.0
+  // @match     https://a.example.com/*
+  // @match     https://b.example.com/*
   // ==/UserScript==
 ```
@@ -259,12 +244,12 @@ If you don't care about visual alignment in metadata blocks.
   // ==UserScript==
 - // @name      Foo
 - // @name      Bar
++ // @name      My Script
 - // @version   1.0.0
 - // @version   2.0.0
-+ // @name      My Script
 + // @version   1.0.0
-+ // @match     https://a.example.com/*
-+ // @match     https://b.example.com/*
+  // @match     https://a.example.com/*
+  // @match     https://b.example.com/*
   // ==/UserScript==
 ```
@@ -272,6 +257,10 @@ If you don't care about visual alignment in metadata blocks.
 If you intentionally repeat single-value keys.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.2.0">v1.2.0</a> (September 11, 2026)
 #### See also
 - [`require-matching-localized-fields`](#require-matching-localized-fields)
@@ -285,6 +274,91 @@ If you intentionally repeat single-value keys.
 ---
+</details>
+<h3 id="no-invalid-grants">
+    <code>no-invalid-grants</code>
+    <a title="Included in recommended config" href="#usage">
+        <img height=18 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
+    <a title="Accepts array w/ options" target="_blank" href="https://eslint.org/docs/latest/extend/custom-rules#option-defaults">
+        <img height=18 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
+    <a title="Copy rule URL" target="_blank"
+       href="https://copy-to-clipboard.onrender.com/copy/https%3A%2F%2Fcodeberg.org%2Fadamlui%2Feslint-plugin-greasemonkey%2F%23no-invalid-grants">
+        <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
+</h3>
+<details>
+<summary>Disallows invalid or unsupported <code>@grant</code> values.</summary>
+#### Options
+- `target` (default `'all'`) – manager(s) whose grants to validate against (`'all'`, `'tampermonkey'`, `'violentmonkey'`, `'greasemonkey'`, `'scriptcat'`), as a single string or array
+- `allowedGrants` (default `[]`) – additional `@grant` values to allow beyond the built-in list (covering Tampermonkey, Violentmonkey and ScriptCat), as a single string or array
+#### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect code
+```diff
+  /* eslint greasemonkey/no-invalid-grants: ['error', { target: 'tampermonkey' }] */
+  // ==UserScript==
+  // @grant   GM_getTab
+! // @grant   CAT.agent.dom
+  // ==/UserScript==
+  /* eslint greasemonkey/no-invalid-grants: ['error', { target: 'scriptcat' }] */
+  // ==UserScript==
+! // @grant   GM_getTab
+  // @grant   CAT.agent.dom
+  // ==/UserScript==
+```
+#### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> Correct code
+```diff
+  /* eslint greasemonkey/no-invalid-grants: ['error', { target: 'tampermonkey' }] */
+  // ==UserScript==
+  // @grant   GM_getTab
+- // @grant   CAT.agent.dom
+  // ==/UserScript==
+  /* eslint greasemonkey/no-invalid-grants: ['error', { target: 'scriptcat' }] */
+  // ==UserScript==
+- // @grant   GM_getTab
+  // @grant   CAT.agent.dom
+  // ==/UserScript==
+```
+#### When not to use it
+If you don't want `@grant` validation at all. For individual uncovered grants, prefer whitelisting via `allowedGrants` over disabling the rule.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.2.0">v1.2.0</a> (September 11, 2026) as `valid-grants`
+#### Renamed in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.5.2">v1.5.2</a> (September 16, 2026) to `no-invalid-grants`
+#### See also
+- [`no-missing-grants`](#no-missing-grants)
+- [`no-unused-grants`](#no-unused-grants)
+<div align="center">
+[Back to index ↑][epg-rules]
+</div>
+---
+</details>
 <h3 id="no-invalid-headers">
     <code>no-invalid-headers</code>
     <a title="Included in recommended config" href="#usage">
@@ -296,7 +370,9 @@ If you intentionally repeat single-value keys.
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Disallows invalid or unsupported metadata headers.
+<details>
+<summary>Disallows invalid or unsupported metadata headers.</summary>
 #### Options
@@ -334,10 +410,14 @@ If you intentionally repeat single-value keys.
 If your script relies heavily on custom headers and you'd rather not maintain `allowedHeaders`.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.0.0">v1.0.0</a> (September 9, 2026)
 #### See also
+- [`no-invalid-grants`](#no-invalid-grants)
 - [`valid-field-values`](#valid-field-values)
-- [`valid-grants`](#valid-grants)
 <div align="center">
@@ -347,6 +427,8 @@ If your script relies heavily on custom headers and you'd rather not maintain `a
 ---
+</details>
 <h3 id="no-missing-grants">
     <code>no-missing-grants</code>
     <a title="Included in recommended config" href="#usage">
@@ -356,7 +438,9 @@ If your script relies heavily on custom headers and you'd rather not maintain `a
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Flags API calls (e.g. `GM_setValue`, `GM.setValue`, `CAT.agent.dom`) used w/o a matching `@grant` declaration.
+<details>
+<summary>Flags API calls (e.g. <code>GM_setValue</code>, <code>GM.setValue</code>, <code>CAT.agent.dom</code>) used w/o a matching <code>@grant</code> declaration.</summary>
 #### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect code
@@ -383,10 +467,14 @@ If your script relies heavily on custom headers and you'd rather not maintain `a
 If you use APIs through aliases or wrappers that obscure the original call site.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.3.0">v1.3.0</a> (September 12, 2026)
 #### See also
+- [`no-invalid-grants`](#no-invalid-grants)
 - [`no-unused-grants`](#no-unused-grants)
-- [`valid-grants`](#valid-grants)
 <div align="center">
@@ -396,6 +484,8 @@ If you use APIs through aliases or wrappers that obscure the original call site.
 ---
+</details>
 <h3 id="no-missing-resources">
     <code>no-missing-resources</code>
     <a title="Included in recommended config" href="#usage">
@@ -405,7 +495,9 @@ If you use APIs through aliases or wrappers that obscure the original call site.
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Flags `@resource` references via `GM_getResourceText()` or `GM_getResourceURL()` where no matching `@resource` is declared.
+<details>
+<summary>Flags <code>@resource</code> references via <code>GM_getResourceText()</code> or <code>GM_getResourceURL()</code> where no matching <code>@resource</code> is declared.</summary>
 #### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect code
@@ -432,6 +524,10 @@ If you use APIs through aliases or wrappers that obscure the original call site.
 If you reference resources through an alias or computed pattern that obscures the call site.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.4.0">v1.4.0</a> (September 13, 2026)
 #### See also
 - [`no-unused-resources`](#no-unused-resources)
@@ -444,6 +540,8 @@ If you reference resources through an alias or computed pattern that obscures th
 ---
+</details>
 <h3 id="no-unused-grants">
     <code>no-unused-grants</code>
     <a title="Included in recommended config" href="#usage">
@@ -453,7 +551,9 @@ If you reference resources through an alias or computed pattern that obscures th
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Flags `@grant` entries whose APIs are never used in the script.
+<details>
+<summary>Flags <code>@grant</code> entries whose APIs are never used in the script.</summary>
 #### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect code
@@ -477,10 +577,14 @@ If you reference resources through an alias or computed pattern that obscures th
 If you access the granted API through an alias or computed property rather than calling it directly.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.0.0">v1.0.0</a> (September 9, 2026)
 #### See also
+- [`no-invalid-grants`](#no-invalid-grants)
 - [`no-missing-grants`](#no-missing-grants)
-- [`valid-grants`](#valid-grants)
 <div align="center">
@@ -490,6 +594,8 @@ If you access the granted API through an alias or computed property rather than
 ---
+</details>
 <h3 id="no-unused-resources">
     <code>no-unused-resources</code>
     <a title="Included in recommended config" href="#usage">
@@ -499,7 +605,9 @@ If you access the granted API through an alias or computed property rather than
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Flags `@resource` entries that are never referenced via `GM_getResourceText()` or `GM_getResourceURL()`.
+<details>
+<summary>Flags <code>@resource</code> entries that are never referenced via <code>GM_getResourceText()</code>or <code>GM_getResourceURL()</code></summary>
 #### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect code
@@ -523,6 +631,10 @@ If you access the granted API through an alias or computed property rather than
 If you pass resource names through variables or aliases rather than use them literally.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.0.0">v1.0.0</a> (September 9, 2026)
 #### See also
 - [`no-missing-resources`](#no-missing-resources)
@@ -535,6 +647,8 @@ If you pass resource names through variables or aliases rather than use them lit
 ---
+</details>
 <h3 id="prefer-match">
     <code>prefer-match</code>
     <a title="Included in recommended config" href="#usage">
@@ -544,7 +658,9 @@ If you pass resource names through variables or aliases rather than use them lit
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Prefers `@match` over `@include` to align w/ <a target="_blank" href="https://developer.chrome.com/docs/extensions/reference/api/userScripts/">`chrome.userScripts`</a> syntax.
+<details>
+<summary>Prefers <code>@match</code> over <code>@include</code> to align w/ <a target="_blank" href="https://developer.chrome.com/docs/extensions/reference/api/userScripts/"><code>chrome.userScripts</code></a> syntax.</summary>
 #### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect code
@@ -567,6 +683,10 @@ If you pass resource names through variables or aliases rather than use them lit
 If you rely on `@include` patterns that cannot be expressed using `@match`.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.3.0">v1.3.0</a> (September 12, 2026)
 #### See also
 - <a target="_blank" href="https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns">Chrome match patterns</a>
@@ -579,20 +699,24 @@ If you rely on `@include` patterns that cannot be expressed using `@match`.
 ---
+</details>
 <h3 id="require-blank-line-after-meta-block">
     <code>require-blank-line-after-meta-block</code>
     <a title="Included in recommended config" href="#usage">
         <img height=18 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=18 alt="[Auto-fixable]" src="https://img.shields.io/badge/Auto--fixable-e8357a?style=flat-square" align="middle"></a>
-    <a title="Doesn't catch bugs" href="#require-blank-line-after-meta-block">
+    <a title="Doesn't prevent bugs" href="#require-blank-line-after-meta-block">
         <img height=18 alt="[Stylistic]" src="https://img.shields.io/badge/Stylistic-af68ff?style=flat-square" align="middle"></a>
     <a title="Copy rule URL" target="_blank"
        href="https://copy-to-clipboard.onrender.com/copy/https%3A%2F%2Fcodeberg.org%2Fadamlui%2Feslint-plugin-greasemonkey%2F%23require-blank-line-after-meta-block">
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Requires a blank line between the closing `// ==/UserScript==` and the first line of code.
+<details>
+<summary>Requires a blank line between the closing <code>// ==/UserScript==</code> and the first line of code.</summary>
 #### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect code
@@ -617,8 +741,17 @@ If you rely on `@include` patterns that cannot be expressed using `@match`.
 If you don't care about visual separation between metadata and code.
+#### Introduced in
+[v1.3.0](https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.3.0) (September 12, 2026) as `require-meta-newline`
+#### Renamed in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.4.0">v1.4.0</a> (September 13, 2026) to `require-blank-line-after-meta-block`
 #### See also
+- [`meta-order`](#meta-order)
 - [`meta-spacing`](#meta-spacing)
 <div align="center">
@@ -629,6 +762,8 @@ If you don't care about visual separation between metadata and code.
 ---
+</details>
 <h3 id="require-homepage-pair">
     <code>require-homepage-pair</code>
     <a title="Only included in strict config" href="#usage">
@@ -640,7 +775,9 @@ If you don't care about visual separation between metadata and code.
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Requires `@homepage` and `@homepageURL` to be used together.
+<details>
+<summary>Requires <code>@homepage</code> and <code>@homepageURL</code> to be used together.</summary>
 #### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect code
@@ -663,6 +800,10 @@ If you don't care about visual separation between metadata and code.
 If your target manager does not fall back to `@namespace` when a homepage key is missing (which usually produces a broken URL).
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.3.0">v1.3.0</a> (September 12, 2026)
 #### See also
 - [`require-update-download-pair`](#require-update-download-pair)
@@ -675,6 +816,8 @@ If your target manager does not fall back to `@namespace` when a homepage key is
 ---
+</details>
 <h3 id="require-matching-localized-fields">
     <code>require-matching-localized-fields</code>
     <a title="Included in recommended config" href="#usage">
@@ -686,7 +829,9 @@ If your target manager does not fall back to `@namespace` when a homepage key is
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Requires that every `@name:xx` has a matching `@description:xx` (and vice versa).
+<details>
+<summary>Requires that every <code>@name:xx</code> has a matching <code>@description:xx</code> (and vice versa).</summary>
 #### Options
@@ -723,6 +868,10 @@ If your target manager does not fall back to `@namespace` when a homepage key is
 If you intentionally provide localized names without descriptions (or vice versa).
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.0.0">v1.0.0</a> (September 9, 2026)
 #### See also
 - [`no-duplicate-keys`](#no-duplicate-keys)
@@ -736,6 +885,8 @@ If you intentionally provide localized names without descriptions (or vice versa
 ---
+</details>
 <h3 id="require-required-fields">
     <code>require-required-fields</code>
     <a title="Included in recommended config" href="#usage">
@@ -747,7 +898,9 @@ If you intentionally provide localized names without descriptions (or vice versa
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Requires essential metadata fields (`@name`, `@version` by default) and at least one `@match` or `@include`.
+<details>
+<summary>Requires essential metadata fields (<code>@name</code>, <code>@version</code> by default) and at least one <code>@match</code> or <code>@include</code></summary>
 #### Options
@@ -779,6 +932,10 @@ If you intentionally provide localized names without descriptions (or vice versa
 If you use a subset of metadata fields that doesn't match the convention.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.0.0">v1.0.0</a> (September 9, 2026)
 #### See also
 - [`no-duplicate-keys`](#no-duplicate-keys)
@@ -792,20 +949,24 @@ If you use a subset of metadata fields that doesn't match the convention.
 ---
+</details>
 <h3 id="require-space-before-meta-key">
     <code>require-space-before-meta-key</code>
     <a title="Included in recommended config" href="#usage">
         <img height=18 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=18 alt="[Auto-fixable]" src="https://img.shields.io/badge/Auto--fixable-e8357a?style=flat-square" align="middle"></a>
-    <a title="Doesn't catch bugs" href="#require-space-before-meta-key">
+    <a title="Doesn't prevent bugs" href="#require-space-before-meta-key">
         <img height=18 alt="[Stylistic]" src="https://img.shields.io/badge/Stylistic-af68ff?style=flat-square" align="middle"></a>
     <a title="Copy rule URL" target="_blank"
        href="https://copy-to-clipboard.onrender.com/copy/https%3A%2F%2Fcodeberg.org%2Fadamlui%2Feslint-plugin-greasemonkey%2F%23require-space-before-meta-key">
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Requires exactly one space between `//` and metadata keys.
+<details>
+<summary>Requires exactly one space between <code>//</code> and metadata keys.</summary>
 #### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect code
@@ -830,6 +991,10 @@ If you use a subset of metadata fields that doesn't match the convention.
 If you intentionally use a different prefix style.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.3.0">v1.3.0</a> (September 12, 2026)
 #### See also
 - [`meta-spacing`](#meta-spacing)
@@ -843,20 +1008,22 @@ If you intentionally use a different prefix style.
 ---
+</details>
 <h3 id="require-sri-hashing">
     <code>require-sri-hashing</code>
     <a title="Only included in strict config" href="#usage">
         <img height=18 alt="[Strict only]" src="https://img.shields.io/badge/Strict_only-ff8c42?style=flat-square" align="middle"></a>
-    <a title="Doesn't catch bugs" href="#require-sri-hashing">
-        <img height=18 alt="[Stylistic]" src="https://img.shields.io/badge/Stylistic-af68ff?style=flat-square" align="middle"></a>
-    <a title="Accepts object w/ options" target="_blank" href="https://eslint.org/docs/latest/extend/custom-rules#option-defaults">
+    <a title="Accepts array w/ options" target="_blank" href="https://eslint.org/docs/latest/extend/custom-rules#option-defaults">
         <img height=18 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
     <a title="Copy rule URL" target="_blank"
        href="https://copy-to-clipboard.onrender.com/copy/https%3A%2F%2Fcodeberg.org%2Fadamlui%2Feslint-plugin-greasemonkey%2F%23require-sri-hashing">
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Requires SRI hashes on `@require` and `@resource` URLs.
+<details>
+<summary>Requires SRI hashes on <code>@require</code> and <code>@resource</code> URLs.</summary>
 #### Options
@@ -868,8 +1035,9 @@ If you intentionally use a different prefix style.
   /* eslint greasemonkey/require-sri-hashing: ['error', { algorithm: 'sha384' }] */
   // ==UserScript==
-! // @require         https://example.com/library.js#sha256-BASE64HASH
-! // @resource logo   https://example.com/logo.png#sha256-BASE64HASH
+! // @require         https://example.com/library.js
+  // @resource css    https://example.com/styles.css#sha384-h/TTEs...
+! // @resource logo   https://example.com/logo.png#sha256-xUj+3O...
   // ==/UserScript==
 ```
@@ -879,16 +1047,21 @@ If you intentionally use a different prefix style.
   /* eslint greasemonkey/require-sri-hashing: ['error', { algorithm: 'sha384' }] */
   // ==UserScript==
-- // @require         https://example.com/library.js#sha256-BASE64HASH
-- // @resource logo   https://example.com/logo.png#sha256-BASE64HASH
-+ // @require         https://example.com/library.js#sha384-BASE64HASH
-+ // @resource logo   https://example.com/logo.png#sha384-BASE64HASH
+- // @require         https://example.com/library.js
++ // @require         https://example.com/library.js#sha384-fTbBOw...
+  // @resource css    https://example.com/styles.css#sha384-h/TTEs...
+- // @resource logo   https://example.com/logo.png#sha256-xUj+3O...
++ // @resource logo   https://example.com/logo.png#sha384-mQ3Slt...
   // ==/UserScript==
 ```
 #### When not to use it
-If you prefer shorter URLs, or don't support users who enforce subresource integrity validation via manager settings.
+If you prefer shorter URLs, or don't support users who strictly enforce subresource integrity via manager settings.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.5.0">v1.5.0</a> (September 15, 2026)
 #### See also
@@ -902,7 +1075,9 @@ If you prefer shorter URLs, or don't support users who enforce subresource integ
 </div>
-----
+---
+</details>
 <h3 id="require-update-download-pair">
     <code>require-update-download-pair</code>
@@ -913,7 +1088,9 @@ If you prefer shorter URLs, or don't support users who enforce subresource integ
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Requires `@updateURL` and `@downloadURL` to be used together.
+<details>
+<summary>Requires <code>@updateURL</code> and <code>@downloadURL</code> to be used together.</summary>
 #### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect code
@@ -936,6 +1113,10 @@ If you prefer shorter URLs, or don't support users who enforce subresource integ
 If you don't target Tampermonkey (where `@updateURL` avoids re-downloading the full script on every update check).
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.3.0">v1.3.0</a> (September 12, 2026)
 #### See also
 - <a target="_blank" href="https://www.tampermonkey.net/documentation.php?q=update_url#meta:updateURL"><code>@updateURL</code></a>
@@ -949,6 +1130,8 @@ If you don't target Tampermonkey (where `@updateURL` avoids re-downloading the f
 ---
+</details>
 <h3 id="require-user-js-filename">
     <code>require-user-js-filename</code>
     <a title="Included in recommended config" href="#usage">
@@ -958,7 +1141,9 @@ If you don't target Tampermonkey (where `@updateURL` avoids re-downloading the f
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Requires that files containing a userscript metadata block end in `.user.js`.
+<details>
+<summary>Requires files containing <code>// ==UserScript==</code> have names ending in <code>.user.js</code></summary>
 #### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect filename
@@ -977,6 +1162,10 @@ If you don't target Tampermonkey (where `@updateURL` avoids re-downloading the f
 If you intentionally name your userscripts something other than `*.user.js`.
+#### Introduced in
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.2.0">v1.2.0</a> (September 11, 2026)
 <div align="center">
 [Back to index ↑][epg-rules]
@@ -985,6 +1174,8 @@ If you intentionally name your userscripts something other than `*.user.js`.
 ---
+</details>
 <h3 id="valid-field-values">
     <code>valid-field-values</code>
     <a title="Included in recommended config" href="#usage">
@@ -996,7 +1187,9 @@ If you intentionally name your userscripts something other than `*.user.js`.
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
-> Validates `@version` (semver or date format) and URL fields (`@homepage`, `@icon`, `@icon64`, `@require`, `@resource`, `@source`, `@website`, any key ending in `URL` case-insensitively).
+<details>
+<summary>Validates <code>@version</code> (semver or date format) and URL fields.</summary>
 #### Options
@@ -1030,69 +1223,14 @@ If you intentionally name your userscripts something other than `*.user.js`.
 If you use a custom versioning scheme or URLs that aren't standard.
-#### See also
-- [`no-missing-resources`](#no-missing-resources)
-- [`valid-grants`](#valid-grants)
-<div align="center">
-[Back to index ↑][epg-rules]
+#### Introduced in
-</div>
----
-<h3 id="valid-grants">
-    <code>valid-grants</code>
-    <a title="Included in recommended config" href="#usage">
-        <img height=18 alt="[Recommended]" src="https://img.shields.io/badge/Recommended-f1f20a?style=flat-square" align="middle"></a>
-    <a title="Accepts array w/ options" target="_blank" href="https://eslint.org/docs/latest/extend/custom-rules#option-defaults">
-        <img height=18 alt="[Configurable]" src="https://img.shields.io/badge/Configurable-black?style=flat-square" align="middle"></a>
-    <a title="Copy rule URL" target="_blank"
-       href="https://copy-to-clipboard.onrender.com/copy/https%3A%2F%2Fcodeberg.org%2Fadamlui%2Feslint-plugin-greasemonkey%2F%23valid-grants">
-        <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
-</h3>
-> Disallows invalid or unsupported `@grant` values.
-#### Options
-- `target` (default `'all'`) – manager(s) whose grants to validate against (`'all'`, `'tampermonkey'`, `'violentmonkey'`, `'greasemonkey'`, `'scriptcat'`), as a single string or array
-- `allowedGrants` (default `[]`) – additional `@grant` values to allow beyond the built-in list (covering Tampermonkey, Violentmonkey and ScriptCat), as a single string or array
-#### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/gray.svg" align="bottom"> Incorrect code
-```diff
-  /* eslint greasemonkey/valid-grants: ['error', { target: 'tampermonkey' }] */
-  // ==UserScript==
-! // @grant   GM_notificaiton
-! // @grant   CAT.agent.dom
-  // ==/UserScript==
-```
-#### <img width=13 height=13 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/99f14247b2/assets/images/icons/square/with-symbol/green.svg" align="bottom"> Correct code
-```diff
-  /* eslint greasemonkey/valid-grants: ['error', { target: 'tampermonkey' }] */
-  // ==UserScript==
-- // @grant   GM_notificaiton
-+ // @grant   GM_notification
-- // @grant   CAT.agent.dom
-+ // @grant   GM_getTab
-  // ==/UserScript==
-```
-#### When not to use it
-If you don't want `@grant` validation at all. For individual uncovered grants, prefer whitelisting via `allowedGrants` over disabling the rule.
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.0.0">v1.0.0</a> (September 9, 2026)
 #### See also
-- [`no-missing-grants`](#no-missing-grants)
-- [`no-unused-grants`](#no-unused-grants)
+- [`no-invalid-grants`](#no-invalid-grants)
+- [`no-missing-resources`](#no-missing-resources)
 <div align="center">
@@ -1126,6 +1264,7 @@ If you don't want `@grant` validation at all. For individual uncovered grants, p
 <a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-constructors/src/branch/main/docs/LICENSE.md">
     <img height=62 src="https://cdn.staticdelivr.com/gl/adamlui/eslint-plugin-greasemonkey/9e820e5d51/assets/images/logos/mit-license/red-pixelated.png"></a>
+<br><br>
 <details>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-greasemonkey",
-  "version": "1.5.1",
+  "version": "1.5.2",
   "description": "ESLint rules for Greasemonkey/Tampermonkey userscripts",
   "type": "module",
   "engines": {
@@ -69,7 +69,7 @@
     "@eslint/markdown": "^8.0.3",
     "@stylistic/eslint-plugin": "^5.10.0",
     "eslint": "^10.10.0",
-    "eslint-plugin-constructors": "^1.2.0",
+    "eslint-plugin-constructors": "^1.2.2",
     "eslint-plugin-eslint-plugin": "^7.6.2",
     "eslint-plugin-import-x": "^4.17.1",
     "eslint-plugin-n": "^18.3.0",

package/src/data/apis.js CHANGED Viewed

@@ -32,5 +32,4 @@ export function supportsAPI({ manager, api }) {
          : api.startsWith('CAT') ? manager == 'scriptcat'
          : tmAPIs.has(api) ? manager == 'tampermonkey'
          : true
 }

package/src/data/deprecations.js CHANGED Viewed

@@ -1,3 +1,6 @@
-export default { // val = replacement
-    rules: { 'require-meta-newline': 'require-blank-line-after-meta-block' } // 2026-9-13
+export const rules = { // old: new
+    'require-meta-newline': 'require-blank-line-after-meta-block', // 2026-9-13
+    'valid-grants': 'no-invalid-grants'
 }
+export default { rules }

package/src/index.js CHANGED Viewed

@@ -1,8 +1,11 @@
-import aliases from './data/deprecations.js'
+/* eslint-disable security/detect-object-injection -- false positives */
+import { rules as oldRules } from './data/deprecations.js'
 import metaOrder from './rules/meta-order.js'
 import metaSpacing from './rules/meta-spacing.js'
 import noDuplicateKeys from './rules/no-duplicate-keys.js'
+import noInvalidGrants from './rules/no-invalid-grants.js'
 import noInvalidHeaders from './rules/no-invalid-headers.js'
 import noMissingGrants from './rules/no-missing-grants.js'
 import noMissingResources from './rules/no-missing-resources.js'
@@ -18,13 +21,13 @@ import requireSRIhashing from './rules/require-sri-hashing.js'
 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 validGrants from './rules/valid-grants.js'
 const plugin = {
     rules: {
         'meta-order': metaOrder,
         'meta-spacing': metaSpacing,
         'no-duplicate-keys': noDuplicateKeys,
+        'no-invalid-grants': noInvalidGrants,
         'no-invalid-headers': noInvalidHeaders,
         'no-missing-grants': noMissingGrants,
         'no-unused-grants': noUnusedGrants,
@@ -39,27 +42,23 @@ const plugin = {
         'require-sri-hashing': requireSRIhashing,
         'require-update-download-pair': requireUpdateDownloadPair,
         'require-user-js-filename': requireUserJsFilename,
-        'valid-field-values': validFieldValues,
-        'valid-grants': validGrants
+        'valid-field-values': validFieldValues
     }
 }
-const docsURL = 'https://codeberg.org/adamlui/eslint-plugin-greasemonkey/#'
 for (const [ruleId, rule] of Object.entries(plugin.rules))
-    rule.meta.docs.url = docsURL + ruleId
+    rule.meta.docs.url = `https://codeberg.org/adamlui/eslint-plugin-greasemonkey/#${ruleId}`
-// Generate deprecated aliases
-for (const [oldName, newName] of Object.entries(aliases.rules)) { /* eslint-disable security/detect-object-injection */
+for (const [oldName, newName] of Object.entries(oldRules)) {
     const newRule = plugin.rules[newName]
     plugin.rules[oldName] = {
         ...newRule,
         meta: {
-            ...newRule.meta,
-            docs: { ...newRule.meta.docs, recommended: false },
+            ...newRule.meta, docs: { ...newRule.meta.docs, recommended: false },
             deprecated: { message: `Use \`${newName}\` instead.`, replacedBy: [{ rule: { name: newName }}] }
         }
     }
-} /* eslint-enable security/detect-object-injection */
+}
 plugin.configs = {
     recommended: {
@@ -67,6 +66,7 @@ plugin.configs = {
         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',
@@ -78,24 +78,22 @@ plugin.configs = {
             'greasemonkey/require-required-fields': 'error',
             'greasemonkey/require-space-before-meta-key': 'error',
             'greasemonkey/require-user-js-filename': 'error',
-            'greasemonkey/valid-field-values': 'error',
-            'greasemonkey/valid-grants': 'error'
+            'greasemonkey/valid-field-values': 'error'
         }
+    },
+    strict: {
+        plugins: { greasemonkey: plugin },
+        rules: Object.fromEntries(Object.keys(plugin.rules).map(ruleId => [`greasemonkey/${ruleId}`, 'error']))
     }
 }
-plugin.configs.strict = {
-    plugins: { greasemonkey: plugin },
-    rules: Object.fromEntries(Object.keys(plugin.rules).map(ruleId => [`greasemonkey/${ruleId}`, 'error']))
-}
 for (const manager of ['tampermonkey', 'violentmonkey', 'greasemonkey', 'scriptcat'])
-    plugin.configs[manager] = { // eslint-disable-line security/detect-object-injection
+    plugin.configs[manager] = {
         plugins: { greasemonkey: plugin },
         rules: {
             ...plugin.configs.recommended.rules,
-            'greasemonkey/no-invalid-headers': ['error', { target: manager }],
-            'greasemonkey/valid-grants': ['error', { target: manager }]
+            'greasemonkey/no-invalid-grants': ['error', { target: manager }],
+            'greasemonkey/no-invalid-headers': ['error', { target: manager }]
         }
     }

package/src/rules/meta-order.js CHANGED Viewed

@@ -12,8 +12,8 @@ function findViolation(entries, keys) {
               const key = entry.key.split(':', 1)[0]
               return { entry, key, rank: ranks.get(key) }
           }).filter(item => item.rank !== undefined)
-    for (let i = 1; i < known.length; i++) // eslint-disable-next-line security/detect-object-injection
-        if (known[i - 1].rank > known[i].rank) return [known[i - 1], known[i]]
+    for (let i = 1 ; i < known.length ; i++) // eslint-disable-next-line security/detect-object-injection
+        if (known[i -1].rank > known[i].rank) return [known[i -1], known[i]]
 }
 function sortEntries(entries, keys) {
@@ -21,7 +21,7 @@ function sortEntries(entries, keys) {
     return entries.toSorted((a, b) => {
         const aRank = ranks.get(a.key.split(':', 1)[0]),
               bRank = ranks.get(b.key.split(':', 1)[0])
-        return (aRank ?? Infinity) - (bRank ?? Infinity)
+        return ( aRank ?? Infinity ) -( bRank ?? Infinity )
     })
 }

package/src/rules/require-sri-hashing.js CHANGED Viewed

@@ -46,7 +46,7 @@ export default {
                             node: entry.comment, messageId: 'invalidHash',
                             data: {
                                 key: entry.key,
-                                detected: match ? ` Detected ${match[1].toLowerCase()};` : '',
+                                detected: match ? ` Detected ${match[1].toLowerCase()}.` : '',
                                 expected: algorithm
                             }
                         })

/package/src/rules/{valid-grants.js → no-invalid-grants.js} RENAMED Viewed

File without changes