eslint-plugin-greasemonkey 1.5.2 → 1.6.0

package/README.md

@@ -46,7 +46,7 @@ export default [
         rules: {
             ...greasemonkey.configs.recommended.rules,
             'greasemonkey/no-unused-resources': 'off',  // selectively disable rule
-            'greasemonkey/meta-spacing': ['error', 2]   // selectively tweak rule
+            'greasemonkey/meta-spacing': ['error', { spaces: 2 }]  // selectively tweak rule
         }
     }
 ]
@@ -73,7 +73,7 @@ Avaialble bundles: `recommended`, `strict`, `tampermonkey`, `violentmonkey`, `gr
         <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 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">
+    <a title="Accepts array w/ options" href="#usage">
         <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%23meta-order">
@@ -86,7 +86,7 @@ Avaialble bundles: `recommended`, `strict`, `tampermonkey`, `violentmonkey`, `gr
 
 #### Options
 
-- `string[]` (default `[]`) – metadata keys in custom order
+- `order` (default `[]`) – metadata keys in custom order
 
 #### <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
 
@@ -148,7 +148,7 @@ If you don't care about the order of metadata fields.
         <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 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">
+    <a title="Accepts array w/ options" href="#usage">
         <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%23meta-spacing">
@@ -161,12 +161,12 @@ If you don't care about the order of metadata fields.
 
 #### Options
 
-- `number` (default `3`) – minimum spaces after the longest key
+- `spaces` (default `3`) – minimum spaces 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/gray.svg" align="bottom"> Incorrect code
 
 ```diff
-  /* eslint greasemonkey/meta-spacing: ['error', 1] */
+  /* eslint greasemonkey/meta-spacing: ['error', { spaces: 1 }] */
   
   // ==UserScript==
 ! // @name My Script
@@ -178,7 +178,7 @@ If you don't care about the order of metadata fields.
 #### <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/meta-spacing: ['error', 1] */
+  /* eslint greasemonkey/meta-spacing: ['error', { spaces: 1 }] */
   
   // ==UserScript==
 - // @name My Script
@@ -276,11 +276,11 @@ If you intentionally repeat single-value keys.
 
 </details>
 
-<h3 id="no-invalid-grants">
+<h3 id="no-invalid-grants"><a deprecated id="valid-grants"></a>
     <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">
+    <a title="Accepts array w/ options" href="#usage">
         <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">
@@ -363,7 +363,7 @@ If you don't want `@grant` validation at all. For individual uncovered grants, p
     <code>no-invalid-headers</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">
+    <a title="Accepts array w/ options" href="#usage">
         <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-headers">
@@ -376,7 +376,7 @@ If you don't want `@grant` validation at all. For individual uncovered grants, p
 
 #### Options
 
-- `target` (default `'all'`) – manager(s) whose headers to validate against (`'all'`, `'tampermonkey'`, `'violentmonkey'`, `'greasemonkey'`), as a single string or array
+- `target` (default `'all'`) – manager(s) whose headers to validate against (`'all'`, `'tampermonkey'`, `'violentmonkey'`, `'greasemonkey'`, `'scriptcat'`), as a single string or array
 - `allowedHeaders` (default `[]`) – additional headers to allow (strings or regexes), as a single value 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
@@ -701,7 +701,7 @@ If you rely on `@include` patterns that cannot be expressed using `@match`.
 
 </details>
 
-<h3 id="require-blank-line-after-meta-block">
+<h3 id="require-blank-line-after-meta-block"><a deprecated id="require-meta-newline"></a>
     <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>
@@ -822,7 +822,7 @@ If your target manager does not fall back to `@namespace` when a homepage key is
     <code>require-matching-localized-fields</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">
+    <a title="Accepts array w/ options" href="#usage">
         <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-matching-localized-fields">
@@ -891,7 +891,7 @@ If you intentionally provide localized names without descriptions (or vice versa
     <code>require-required-fields</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">
+    <a title="Accepts array w/ options" href="#usage">
         <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-required-fields">
@@ -900,16 +900,17 @@ If you intentionally provide localized names without descriptions (or vice versa
 
 <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>
+<summary>Requires essential metadata fields (<code>@name</code>, <code>@version</code> and at least one <code>@match</code> or <code>@include</code>by default).</summary>
 
 #### Options
 
 - `fields` (default `['name', 'version']`) – override the required field list
+- `requireMatchOrInclude` (default `true`) – require `@match` or `@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"> Incorrect code
 
 ```diff
-  /* eslint greasemonkey/require-required-fields: ['error', { fields: ['name', 'version', 'match'] }] */
+  /* eslint greasemonkey/require-required-fields: ['error', { fields: ['name', 'version', 'license'] }] */
   
   // ==UserScript==
   // @name      My Script
@@ -919,11 +920,12 @@ If you intentionally provide localized names without descriptions (or vice versa
 #### <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/require-required-fields: ['error', { fields: ['name', 'version', 'match'] }] */
+  /* eslint greasemonkey/require-required-fields: ['error', { fields: ['name', 'version', 'license'] }] */
   
   // ==UserScript==
   // @name      My Script
 + // @version   1.0.0
++ // @license   MIT
 + // @match     https://example.com/*
   // ==/UserScript==
 ```
@@ -934,7 +936,7 @@ 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)
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases/tag/v1.0.0">v1.0.0</a> (September 9, 2026) as `require-required-fields`
 
 #### See also
 
@@ -1014,7 +1016,7 @@ If you intentionally use a different prefix style.
     <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="Accepts array w/ options" target="_blank" href="https://eslint.org/docs/latest/extend/custom-rules#option-defaults">
+    <a title="Accepts array w/ options" href="#usage">
         <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">
@@ -1180,9 +1182,9 @@ If you intentionally name your userscripts something other than `*.user.js`.
     <code>valid-field-values</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">
+    <a title="Accepts array w/ options" href="#usage">
         <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" 
+    <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-field-values">
         <img height=16 width=21 alt="[Copy rule URL]" src="https://api.iconify.design/mdi/content-copy.svg?color=%23cccccc" align="middle"></a>
 </h3>
@@ -1194,6 +1196,8 @@ If you intentionally name your userscripts something other than `*.user.js`.
 #### Options
 
 - `versionType` (default `'semver'`) – version format to enforce (`'semver'`, `'date'`)
+- `allowFutureDate` (default `false`) – allow `@version` dates later than the current date
+- `timezone` (default `''`) – <a target="_blank" href="https://data.iana.org/time-zones/tzdb/zone1970.tab">IANA timezone</a> used to determine the current date (when omitted, only year/month are enforced)
 
 #### <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
 
@@ -1238,6 +1242,8 @@ If you use a custom versioning scheme or URLs that aren't standard.
 
 </div>
 
+</details>
+
 ---
 
 ## Shield embed
@@ -1303,7 +1309,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 <div align="center">
 
 <picture><source media="(prefers-color-scheme: dark)" srcset="https://cdn.staticdelivr.com/gl/adamlui/js-utils/6b0d399/assets/images/icons/tag/white/icon16.svg"><img height=14 src="https://cdn.staticdelivr.com/gl/adamlui/js-utils/6b0d399/assets/images/icons/tag/dark-gray/icon16.svg"></picture>
-<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases"><b>Latest releases</b></a> / <a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/issues/new">Report a bug</a> / <a target="_blank" href="https://npmx.dev/org/adamlui">More packages by author</a> / [Back to top ↑](#top)
+<a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/releases"><b>Latest releases</b></a> / <a target="_blank" href="https://codeberg.org/adamlui/eslint-plugin-greasemonkey/issues/new">Report a bug</a> / <a target="_blank" href="https://www.npmjs.com/~adamlui">More packages by author</a> / [Back to top ↑](#top)
 
 </div>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-greasemonkey",
-  "version": "1.5.2",
+  "version": "1.6.0",
   "description": "ESLint rules for Greasemonkey/Tampermonkey userscripts",
   "type": "module",
   "engines": {
@@ -63,7 +63,7 @@
     "eslint": ">=9.0.0"
   },
   "devDependencies": {
-    "@e18e/eslint-plugin": "^0.8.0",
+    "@e18e/eslint-plugin": "^0.8.1",
     "@eslint/js": "^10.0.1",
     "@eslint/json": "^2.1.0",
     "@eslint/markdown": "^8.0.3",

package/src/data/deprecations.js

@@ -1,6 +1,8 @@
+// Delete a line to end support
+
 export const rules = { // old: new
-    'require-meta-newline': 'require-blank-line-after-meta-block', // 2026-9-13
-    'valid-grants': 'no-invalid-grants'
+    'valid-grants': 'no-invalid-grants', // 2026-9-16 announced removal @ v2
+    'require-meta-newline': 'require-blank-line-after-meta-block' // 2026-9-13 announced removal @ v2
 }
 
 export default { rules }

package/src/data/headers.js

@@ -6,17 +6,23 @@ export const universalHeaders = new Set([
 ])
 
 export const managerHeaders = new Map([
-    ['inject-into',     ['violentmonkey']],
-    ['top-level-await', ['violentmonkey']],
-    ['user-agent',      ['tampermonkey']],
-    ['run-in',          ['tampermonkey']],
+    ['run-in',          ['tampermonkey', 'scriptcat']],
+    ['nocompat',        ['tampermonkey']],
     ['sandbox',         ['tampermonkey']],
+    ['user-agent',      ['tampermonkey']],
     ['webRequest',      ['tampermonkey']],
-    ['nocompat',        ['tampermonkey']]
+    ['inject-into',     ['violentmonkey', 'scriptcat']],
+    ['top-level-await', ['violentmonkey']],
+    ['background',      ['scriptcat']],
+    ['crontab',         ['scriptcat']],
+    ['definition',      ['scriptcat']],
+    ['early-start',     ['scriptcat']],
+    ['require-css',     ['scriptcat']],
+    ['storageName',     ['scriptcat']]
 ])
 
 export const localizedHeaders = ['name', 'description', 'antifeature']
-export const managers = ['tampermonkey', 'violentmonkey', 'greasemonkey']
+export const managers = ['tampermonkey', 'violentmonkey', 'greasemonkey', 'scriptcat']
 export const validHeaders = new Map()
 
 validHeaders.set('all', new Set([...universalHeaders, ...managerHeaders.keys()]))

package/src/index.js

@@ -22,6 +22,8 @@ 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'
+
 const plugin = {
     rules: {
         'meta-order': metaOrder,
@@ -49,16 +51,8 @@ const plugin = {
 for (const [ruleId, rule] of Object.entries(plugin.rules))
     rule.meta.docs.url = `https://codeberg.org/adamlui/eslint-plugin-greasemonkey/#${ruleId}`
 
-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 },
-            deprecated: { message: `Use \`${newName}\` instead.`, replacedBy: [{ rule: { name: newName }}] }
-        }
-    }
-}
+for (const entry of Object.entries(oldRules))
+    initDeprecatedAlias(plugin, entry)
 
 plugin.configs = {
     recommended: {
@@ -93,7 +87,8 @@ for (const manager of ['tampermonkey', 'violentmonkey', 'greasemonkey', 'scriptc
         rules: {
             ...plugin.configs.recommended.rules,
             'greasemonkey/no-invalid-grants': ['error', { target: manager }],
-            'greasemonkey/no-invalid-headers': ['error', { target: manager }]
+            'greasemonkey/no-invalid-headers': ['error', { target: manager }],
+            ...(manager == 'tampermonkey' && { 'greasemonkey/require-update-download-pair': 'error' })
         }
     }
 

package/src/rules/meta-order.js

@@ -35,16 +35,31 @@ export default {
         },
         fixable: 'code',
         schema: [{
-            type: 'array',
-            items: { type: 'string' },
-            description: 'Metadata keys in preferred order; unspecified keys are ignored'
+            oneOf: [
+                {
+                    type: 'array', items: { type: 'string' },
+                    description: 'Metadata keys in preferred order; unspecified keys are ignored'
+                },
+                {
+                    type: 'object',
+                    properties: {
+                        order: {
+                            type: 'array', items: { type: 'string' },
+                            description: 'Metadata keys in preferred order; unspecified keys are ignored'
+                        }
+                    },
+                    additionalProperties: false,
+                    description: 'Options for metadata key ordering'
+                }
+            ]
         }],
         defaultOptions: [[]],
         messages: { wrongOrder: '@{{first}} should appear before @{{second}}' }
     },
 
     create(context) {
-        const custom = context.options[0] ?? [],
+        const option = context.options[0] ?? [],
+              custom = Array.isArray(option) ? option : option.order ?? [],
               master = custom.length ? defaultOrder.filter(key => !custom.includes(key)) : defaultOrder
         return {
             Program() {

package/src/rules/meta-spacing.js

@@ -11,13 +11,32 @@ export default {
             recommended: true
         },
         fixable: 'whitespace',
-        schema: [{ type: 'number', description: 'Minimum spaces after the longest key (default 3)' }],
+        schema: [{
+            oneOf: [
+                {
+                    type: 'number',
+                    description: 'Minimum spaces after the longest key (default 3)'
+                },
+                {
+                    type: 'object',
+                    properties: {
+                        spaces: {
+                            type: 'number',
+                            description: 'Minimum spaces after the longest key (default 3)'
+                        }
+                    },
+                    additionalProperties: false,
+                    description: 'Options for metadata spacing'
+                }
+            ]
+        }],
         defaultOptions: [3],
         messages: { misaligned: 'Metadata values should be aligned at column {{column}}' }
     },
 
     create(context) {
-        const minSpaces = context.options[0] ?? 3
+        const option = context.options[0] ?? 3,
+              minSpaces = typeof option == 'number' ? option : option.spaces ?? 3
         return {
             Program() {
                 const sourceCode = context.sourceCode,

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

@@ -15,6 +15,10 @@ export default {
                     type: 'array',
                     items: { type: 'string' },
                     description: 'Required metadata fields (default: name, version)'
+                },
+                requireMatchOrInclude: {
+                    type: 'boolean',
+                    description: 'Require a match or include metadata field (default: true)'
                 }
             },
             additionalProperties: false
@@ -25,7 +29,8 @@ export default {
 
     create(context) {
         const options = context.options[0] || {},
-              requiredFields = options.fields || ['name', 'version']
+              requiredFields = options.fields || ['name', 'version'],
+              requireMatchOrInclude = options.requireMatchOrInclude ?? true
         return {
             Program(node) {
                 const metaEntries = extractMetadata(context.sourceCode),
@@ -33,7 +38,7 @@ export default {
                 for (const field of requiredFields)
                     if (!keys.has(field))
                         context.report({ node, messageId: 'missingField', data: { field }})
-                if (!metaEntries.some(entry => ['include', 'match'].includes(entry.key)))
+                if (requireMatchOrInclude && !['include', 'match'].some(field => keys.has(field)))
                     context.report({ node, messageId: 'missingField', data: { field: 'match or include' }})
             }
         }

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

@@ -28,6 +28,14 @@ export default {
                     type: 'array',
                     items: { type: 'string' },
                     description: 'Allowed @grant values to check against; if empty, no grant validation'
+                },
+                allowFutureDate: {
+                    type: 'boolean',
+                    description: 'Allow @version dates later than the current date (default: false)'
+                },
+                timezone: {
+                    type: 'string',
+                    description: 'IANA timezone for determining the current date (when omitted, only year and month are checked)'
                 }
             },
             additionalProperties: false
@@ -35,6 +43,7 @@ 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}}"'
         }
@@ -44,7 +53,15 @@ export default {
         const options = context.options[0] || {},
               versionType = options.versionType || 'semver',
               allowedGrants = options.allowedGrants || [],
+              allowFutureDate = options.allowFutureDate ?? false,
+              timezone = options.timezone,
               example = versionType == 'semver' ? '1.2.3' : 'YYYY.M.D or YYYY.MM.DD'
+        const now = timezone
+            ? Object.fromEntries(new Intl.DateTimeFormat('en', {
+                timeZone: timezone, year: 'numeric', month: 'numeric', day: 'numeric'
+            }).formatToParts().filter(({ type }) => ['year', 'month', 'day'].includes(type))
+                .map(({ type, value }) => [type, Number(value)]))
+            : { year: new Date().getUTCFullYear(), month: new Date().getUTCMonth() +1 }
         return {
             Program() {
                 const metaEntries = extractMetadata(context.sourceCode)
@@ -66,9 +83,15 @@ export default {
                         const isValid = versionType == 'semver' ? re.semVer.test(entry.value)
                                       : versionType == 'date' ? re.dateVer.test(entry.value)
                                       : false
+                        const [year, month, day] = versionType == 'date' ? entry.value.split('.').map(Number) : []
                         if (!isValid)
                             context.report({
                                 node: entry.comment, messageId: 'invalidVersion', data: { versionType, example }})
+                        else if (versionType == 'date' && !allowFutureDate && (
+                            year > now.year || year == now.year && month > now.month
+                                || timezone && year == now.year && month == now.month && day > now.day
+                        ))
+                            context.report({ node: entry.comment, messageId: 'futureVersion' })
                     }
                 }
             }

package/src/utils.js

@@ -1,3 +1,5 @@
+const re = { whitespace: /\s/ }
+
 export function extractMetadata(sourceCode) {
     const comments = sourceCode.getAllComments(),
           metaEntries = []
@@ -7,17 +9,55 @@ export function extractMetadata(sourceCode) {
         if (!inMetaBlock && text == '==UserScript==') inMetaBlock = true
         else if (inMetaBlock && text == '==/UserScript==') break
         else if (inMetaBlock && text.startsWith('@')) { // capture entry
-            const spaceIdx = text.indexOf(' ')
-            if (spaceIdx > 1) { // need space after key
-                const key = text.slice(1, spaceIdx).trim(),
-                      value = text.slice(spaceIdx +1).trim()
-                metaEntries.push({ key, value, comment, line: comment.loc.start.line })
-            }
+            const spaceIdx = text.search(re.whitespace),
+                  key = spaceIdx == -1 ? text.slice(1).trim() : text.slice(1, spaceIdx).trim(),
+                  value = spaceIdx == -1 ? '' : text.slice(spaceIdx +1).trim()
+            if (key) metaEntries.push({ key, value, comment, line: comment.loc.start.line })
         }
     }
     return metaEntries
 }
 
+export function initDeprecatedAlias(plugin, [oldName, alias]) { /* eslint-disable security/detect-object-injection */
+    const entries = typeof alias == 'string' ? [[alias, null]] // old: new
+        : Array.isArray(alias) ? alias.flatMap(entry =>
+            typeof entry == 'string' ? [[entry, null]] : Object.entries(entry)) // old: [new, ...]
+        : Object.entries(alias) // old: { new: { old-option: new-option }}
+    const newNames = entries.filter(([name]) => name != oldName).map(([name]) => name),
+          newRule = plugin.rules[newNames[0] || oldName]
+    plugin.rules[oldName] = {
+        ...newRule,
+        meta: {
+            ...newRule.meta,
+            schema: typeof alias == 'string' ? newRule.meta.schema : [{ type: 'object' }],
+            docs: { ...newRule.meta.docs, recommended: false },
+            deprecated: {
+                message: `Use ${newNames.map(name => `\`${name}\``).join(', ')} instead.`,
+                replacedBy: newNames.map(name => ({ rule: { name }}))
+            }
+        },
+        create(context) {
+            const oldOptions = context.options[0]
+            return Object.assign({}, ...entries.map(([name, mapping]) => {
+                const newRule = plugin.rules[name]
+                const options = mapping ? {
+                    ...oldOptions,
+                    ...Object.fromEntries(Object.entries(mapping).map(([oldKey, newKey]) => // old: new
+                        [newKey, oldOptions?.[oldKey] ?? (newKey == 'reverseDefault' ? true : newKey)]))
+                } : oldOptions
+                const aliasContext = new Proxy({}, {
+                    get(_, property) {
+                        if (property == 'options') return [options]
+                        const val = context[property]
+                        return typeof val == 'function' ? val.bind(context) : val
+                    }
+                })
+                return newRule.create(aliasContext)
+            }))
+        }
+    }
+} /* eslint-enable security/detect-object-injection */
+
 export function resolveTemplate(node) {
     if (node.type == 'ConditionalExpression') {
         const branches = [node.consequent, node.alternate].map(resolveTemplate)