eslint-plugin-jsdoc 57.2.0 → 58.0.0
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.
- package/dist/buildRejectOrPreferRuleDefinition.cjs +349 -0
- package/dist/buildRejectOrPreferRuleDefinition.cjs.map +1 -0
- package/dist/buildRejectOrPreferRuleDefinition.d.ts +9 -0
- package/dist/cjs/buildRejectOrPreferRuleDefinition.d.ts +8 -0
- package/dist/cjs/rules/checkTypes.d.ts +6 -1
- package/dist/generateRuleTypes.cjs +9 -11
- package/dist/generateRuleTypes.cjs.map +1 -1
- package/dist/index-cjs.cjs +33 -3
- package/dist/index-cjs.cjs.map +1 -1
- package/dist/index-esm.cjs +29 -1
- package/dist/index-esm.cjs.map +1 -1
- package/dist/index-esm.d.ts +28 -2
- package/dist/index.cjs +61 -4
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +28 -2
- package/dist/rules/checkTypes.cjs +73 -379
- package/dist/rules/checkTypes.cjs.map +1 -1
- package/dist/rules/checkTypes.d.ts +6 -1
- package/dist/rules.d.ts +42 -0
- package/package.json +1 -1
- package/src/buildRejectOrPreferRuleDefinition.js +472 -0
- package/src/index-cjs.js +35 -3
- package/src/index-esm.js +36 -1
- package/src/index.js +68 -4
- package/src/rules/checkTypes.js +82 -511
- package/src/rules.d.ts +42 -0
package/src/rules.d.ts
CHANGED
|
@@ -1,4 +1,7 @@
|
|
|
1
1
|
export interface Rules {
|
|
2
|
+
/** Checks that `@access` tags have a valid value. */
|
|
3
|
+
"jsdoc/check-access": [];
|
|
4
|
+
|
|
2
5
|
/** Reports invalid alignment of JSDoc block asterisks. */
|
|
3
6
|
"jsdoc/check-alignment":
|
|
4
7
|
| []
|
|
@@ -90,6 +93,9 @@ export interface Rules {
|
|
|
90
93
|
}
|
|
91
94
|
];
|
|
92
95
|
|
|
96
|
+
/** Reports against syntax not valid for the mode (e.g., Google Closure Compiler in non-Closure mode). */
|
|
97
|
+
"jsdoc/check-syntax": [];
|
|
98
|
+
|
|
93
99
|
/** Reports invalid block tag names. */
|
|
94
100
|
"jsdoc/check-tag-names":
|
|
95
101
|
| []
|
|
@@ -102,6 +108,9 @@ export interface Rules {
|
|
|
102
108
|
}
|
|
103
109
|
];
|
|
104
110
|
|
|
111
|
+
/** Checks that any `@template` names are actually used in the connected `@typedef` or type alias. */
|
|
112
|
+
"jsdoc/check-template-names": [];
|
|
113
|
+
|
|
105
114
|
/** Reports invalid types. */
|
|
106
115
|
"jsdoc/check-types":
|
|
107
116
|
| []
|
|
@@ -188,6 +197,9 @@ export interface Rules {
|
|
|
188
197
|
}
|
|
189
198
|
];
|
|
190
199
|
|
|
200
|
+
/** Reports if JSDoc `import()` statements point to a package which is not listed in `dependencies` or `devDependencies` */
|
|
201
|
+
"jsdoc/imports-as-dependencies": [];
|
|
202
|
+
|
|
191
203
|
/** This rule reports doc comments that only restate their attached name. */
|
|
192
204
|
"jsdoc/informative-docs":
|
|
193
205
|
| []
|
|
@@ -300,6 +312,9 @@ export interface Rules {
|
|
|
300
312
|
}
|
|
301
313
|
];
|
|
302
314
|
|
|
315
|
+
/** Detects and removes extra lines of a blank block description */
|
|
316
|
+
"jsdoc/no-blank-block-descriptions": [];
|
|
317
|
+
|
|
303
318
|
/** Removes empty blocks with nothing but possibly line breaks */
|
|
304
319
|
"jsdoc/no-blank-blocks":
|
|
305
320
|
| []
|
|
@@ -395,6 +410,12 @@ export interface Rules {
|
|
|
395
410
|
}
|
|
396
411
|
];
|
|
397
412
|
|
|
413
|
+
/** Reports use of `any` or `*` type */
|
|
414
|
+
"jsdoc/reject-any-type": [];
|
|
415
|
+
|
|
416
|
+
/** Reports use of `Function` type */
|
|
417
|
+
"jsdoc/reject-function-type": [];
|
|
418
|
+
|
|
398
419
|
/** Requires that each JSDoc line starts with an `*`. */
|
|
399
420
|
"jsdoc/require-asterisk-prefix":
|
|
400
421
|
| []
|
|
@@ -542,6 +563,9 @@ export interface Rules {
|
|
|
542
563
|
}
|
|
543
564
|
];
|
|
544
565
|
|
|
566
|
+
/** Requires a type for `@next` tags */
|
|
567
|
+
"jsdoc/require-next-type": [];
|
|
568
|
+
|
|
545
569
|
/** Requires that all function parameters are documented. */
|
|
546
570
|
"jsdoc/require-param":
|
|
547
571
|
| []
|
|
@@ -621,6 +645,18 @@ export interface Rules {
|
|
|
621
645
|
}
|
|
622
646
|
];
|
|
623
647
|
|
|
648
|
+
/** Requires that all `@typedef` and `@namespace` tags have `@property` when their type is a plain `object`, `Object`, or `PlainObject`. */
|
|
649
|
+
"jsdoc/require-property": [];
|
|
650
|
+
|
|
651
|
+
/** Requires that each `@property` tag has a `description` value. */
|
|
652
|
+
"jsdoc/require-property-description": [];
|
|
653
|
+
|
|
654
|
+
/** Requires that all function `@property` tags have names. */
|
|
655
|
+
"jsdoc/require-property-name": [];
|
|
656
|
+
|
|
657
|
+
/** Requires that each `@property` tag has a `type` value. */
|
|
658
|
+
"jsdoc/require-property-type": [];
|
|
659
|
+
|
|
624
660
|
/** Requires that returns are documented. */
|
|
625
661
|
"jsdoc/require-returns":
|
|
626
662
|
| []
|
|
@@ -718,6 +754,9 @@ export interface Rules {
|
|
|
718
754
|
}
|
|
719
755
|
];
|
|
720
756
|
|
|
757
|
+
/** Requires a type for `@throws` tags */
|
|
758
|
+
"jsdoc/require-throws-type": [];
|
|
759
|
+
|
|
721
760
|
/** Requires yields are documented. */
|
|
722
761
|
"jsdoc/require-yields":
|
|
723
762
|
| []
|
|
@@ -757,6 +796,9 @@ export interface Rules {
|
|
|
757
796
|
}
|
|
758
797
|
];
|
|
759
798
|
|
|
799
|
+
/** Requires a type for `@yields` tags */
|
|
800
|
+
"jsdoc/require-yields-type": [];
|
|
801
|
+
|
|
760
802
|
/** Sorts tags by a specified sequence according to tag name. */
|
|
761
803
|
"jsdoc/sort-tags":
|
|
762
804
|
| []
|