@sarj/eslint-plugin 7.1.0 → 8.0.0

package/dist/index.d.cts

@@ -1,5 +1,19 @@
 import * as _typescript_eslint_utils_ts_eslint from '@typescript-eslint/utils/ts-eslint';
 
+/**
+ * @fileoverview _retired — a withdrawn rule name is burned, not recycled, because a consumer's `eslint-disable` comment or suppressions entry still names it.
+ *
+ * Evidence: https://github.com/sarj-ai/standards/blob/main/docs/rules/_retired.md
+ */
+/** Why a name was withdrawn, and in which release. */
+interface RetiredRule {
+    /** The plugin version whose release removed the rule. */
+    readonly removedIn: string;
+    /** One line a consumer can act on: why it went, and what (if anything) replaced it. */
+    readonly reason: string;
+}
+declare const retiredRules: Readonly<Record<string, RetiredRule>>;
+
 /**
  * @fileoverview _comment-wall — the shared judgement behind the comment-VOLUME rules: a run of member comments that mostly re-spell their members is a wall.
  *
@@ -377,7 +391,7 @@ type FlatPreset = {
 declare const plugin: {
     meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "7.1.0";
+        readonly version: "8.0.0";
     };
     rules: {
         "jsdoc-restates-signature": RuleModule;
@@ -565,10 +579,11 @@ declare const plugin: {
             name: string;
         };
     };
+    retiredRules: Readonly<Record<string, RetiredRule>>;
     configs: {
         recommended: FlatPreset;
         strict: FlatPreset;
     };
 };
 
-export { plugin as default, recommendedRules, renamedRules, rules, strictRules };
+export { type RetiredRule, plugin as default, recommendedRules, renamedRules, retiredRules, rules, strictRules };

package/dist/index.d.ts

@@ -1,5 +1,19 @@
 import * as _typescript_eslint_utils_ts_eslint from '@typescript-eslint/utils/ts-eslint';
 
+/**
+ * @fileoverview _retired — a withdrawn rule name is burned, not recycled, because a consumer's `eslint-disable` comment or suppressions entry still names it.
+ *
+ * Evidence: https://github.com/sarj-ai/standards/blob/main/docs/rules/_retired.md
+ */
+/** Why a name was withdrawn, and in which release. */
+interface RetiredRule {
+    /** The plugin version whose release removed the rule. */
+    readonly removedIn: string;
+    /** One line a consumer can act on: why it went, and what (if anything) replaced it. */
+    readonly reason: string;
+}
+declare const retiredRules: Readonly<Record<string, RetiredRule>>;
+
 /**
  * @fileoverview _comment-wall — the shared judgement behind the comment-VOLUME rules: a run of member comments that mostly re-spell their members is a wall.
  *
@@ -377,7 +391,7 @@ type FlatPreset = {
 declare const plugin: {
     meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "7.1.0";
+        readonly version: "8.0.0";
     };
     rules: {
         "jsdoc-restates-signature": RuleModule;
@@ -565,10 +579,11 @@ declare const plugin: {
             name: string;
         };
     };
+    retiredRules: Readonly<Record<string, RetiredRule>>;
     configs: {
         recommended: FlatPreset;
         strict: FlatPreset;
     };
 };
 
-export { plugin as default, recommendedRules, renamedRules, rules, strictRules };
+export { type RetiredRule, plugin as default, recommendedRules, renamedRules, retiredRules, rules, strictRules };