eslint-config-isaacscript 1.0.75 → 1.0.76
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/base.js +1 -1
- package/jsdoc.js +25 -66
- package/package.json +1 -1
package/base.js
CHANGED
package/jsdoc.js
CHANGED
|
@@ -9,8 +9,8 @@ module.exports = {
|
|
|
9
9
|
/**
|
|
10
10
|
* Instead of using the recommended config, we specifically turn on every rule that is useful.
|
|
11
11
|
*
|
|
12
|
-
* We must specify `contexts: ["any"]` for
|
|
13
|
-
*
|
|
12
|
+
* We must specify `contexts: ["any"]` for some rules because by default, only a subset of AST
|
|
13
|
+
* node types will be affected.
|
|
14
14
|
*/
|
|
15
15
|
rules: {
|
|
16
16
|
// - jsdoc/check-access - Not needed in TypeScript.
|
|
@@ -21,16 +21,12 @@ module.exports = {
|
|
|
21
21
|
// not recommended by the plugin.
|
|
22
22
|
|
|
23
23
|
/**
|
|
24
|
-
* Documentation:
|
|
24
|
+
* Documentation:
|
|
25
|
+
* https://github.com/gajus/eslint-plugin-jsdoc#check-param-names
|
|
25
26
|
*
|
|
26
27
|
* Ensures that parameter names in JSDoc match those in the function declaration.
|
|
27
28
|
*/
|
|
28
|
-
"jsdoc/check-param-names":
|
|
29
|
-
"warn",
|
|
30
|
-
{
|
|
31
|
-
contexts: ["any"],
|
|
32
|
-
},
|
|
33
|
-
],
|
|
29
|
+
"jsdoc/check-param-names": "warn",
|
|
34
30
|
|
|
35
31
|
// - jsdoc/check-property-names - Not needed in TypeScript.
|
|
36
32
|
// - jsdoc/check-syntax - Not needed in TypeScript.
|
|
@@ -43,7 +39,6 @@ module.exports = {
|
|
|
43
39
|
"jsdoc/check-tag-names": [
|
|
44
40
|
"warn",
|
|
45
41
|
{
|
|
46
|
-
contexts: ["any"],
|
|
47
42
|
definedTags: [
|
|
48
43
|
// Used by the TypeScript compiler:
|
|
49
44
|
// https://www.typescriptlang.org/tsconfig#stripInternal
|
|
@@ -65,40 +60,28 @@ module.exports = {
|
|
|
65
60
|
// - jsdoc/check-types - Not needed in TypeScript.
|
|
66
61
|
|
|
67
62
|
/**
|
|
68
|
-
* Documentation:
|
|
63
|
+
* Documentation:
|
|
64
|
+
* https://github.com/gajus/eslint-plugin-jsdoc#check-values
|
|
69
65
|
*
|
|
70
66
|
* Validates the content of some uncommon JSDoc tags.
|
|
71
67
|
*/
|
|
72
|
-
"jsdoc/check-values":
|
|
73
|
-
"warn",
|
|
74
|
-
{
|
|
75
|
-
contexts: ["any"],
|
|
76
|
-
},
|
|
77
|
-
],
|
|
68
|
+
"jsdoc/check-values": "warn",
|
|
78
69
|
|
|
79
70
|
/**
|
|
80
|
-
* Documentation:
|
|
71
|
+
* Documentation:
|
|
72
|
+
* https://github.com/gajus/eslint-plugin-jsdoc#check-values
|
|
81
73
|
*
|
|
82
74
|
* Validates that specific tags are never empty.
|
|
83
75
|
*/
|
|
84
|
-
"jsdoc/empty-tags":
|
|
85
|
-
"warn",
|
|
86
|
-
{
|
|
87
|
-
contexts: ["any"],
|
|
88
|
-
},
|
|
89
|
-
],
|
|
76
|
+
"jsdoc/empty-tags": "warn",
|
|
90
77
|
|
|
91
78
|
/**
|
|
92
|
-
* Documentation:
|
|
79
|
+
* Documentation:
|
|
80
|
+
* https://github.com/gajus/eslint-plugin-jsdoc#implements-on-classes
|
|
93
81
|
*
|
|
94
82
|
* Reports issues with incorrect usage of `@implements`.
|
|
95
83
|
*/
|
|
96
|
-
"jsdoc/implements-on-classes":
|
|
97
|
-
"warn",
|
|
98
|
-
{
|
|
99
|
-
contexts: ["any"],
|
|
100
|
-
},
|
|
101
|
-
],
|
|
84
|
+
"jsdoc/implements-on-classes": "warn",
|
|
102
85
|
|
|
103
86
|
// - jsdoc/match-description - Overlaps with `isaacscript/jsdoc-full-sentences`.
|
|
104
87
|
// - jsdoc/match-name - Only needed for projects with specific JSDoc requirements.
|
|
@@ -112,7 +95,8 @@ module.exports = {
|
|
|
112
95
|
// - jsdoc/no-restricted-syntax - Not generally relevant.
|
|
113
96
|
|
|
114
97
|
/**
|
|
115
|
-
* Documentation:
|
|
98
|
+
* Documentation:
|
|
99
|
+
* https://github.com/gajus/eslint-plugin-jsdoc#no-types
|
|
116
100
|
*
|
|
117
101
|
* Disallows types being used on `@param` or `@returns`.
|
|
118
102
|
*/
|
|
@@ -126,16 +110,12 @@ module.exports = {
|
|
|
126
110
|
// - jsdoc/no-undefined-types - Not needed in TypeScript.
|
|
127
111
|
|
|
128
112
|
/**
|
|
129
|
-
* Documentation:
|
|
113
|
+
* Documentation:
|
|
114
|
+
* https://github.com/gajus/eslint-plugin-jsdoc#require-asterisk-prefix
|
|
130
115
|
*
|
|
131
116
|
* Requires that each JSDoc line starts with an `*`.
|
|
132
117
|
*/
|
|
133
|
-
"jsdoc/require-asterisk-prefix":
|
|
134
|
-
"warn",
|
|
135
|
-
{
|
|
136
|
-
contexts: ["any"],
|
|
137
|
-
},
|
|
138
|
-
],
|
|
118
|
+
"jsdoc/require-asterisk-prefix": "warn",
|
|
139
119
|
|
|
140
120
|
// - jsdoc/require-description-complete-sentence - Overlaps with
|
|
141
121
|
// `isaacscript/jsdoc-complete-sentences`.
|
|
@@ -149,13 +129,7 @@ module.exports = {
|
|
|
149
129
|
*
|
|
150
130
|
* Disallow hyphens before parameter descriptions, as it is non-standard syntax.
|
|
151
131
|
*/
|
|
152
|
-
"jsdoc/require-hyphen-before-param-description": [
|
|
153
|
-
"warn",
|
|
154
|
-
"never",
|
|
155
|
-
{
|
|
156
|
-
contexts: ["any"],
|
|
157
|
-
},
|
|
158
|
-
],
|
|
132
|
+
"jsdoc/require-hyphen-before-param-description": ["warn", "never"],
|
|
159
133
|
|
|
160
134
|
// - jsdoc/require-jsdoc - It's overboard for every function to have a JSDoc comment.
|
|
161
135
|
|
|
@@ -195,12 +169,7 @@ module.exports = {
|
|
|
195
169
|
*
|
|
196
170
|
* Requires that each `@property` tag has a description.
|
|
197
171
|
*/
|
|
198
|
-
"jsdoc/require-property-description":
|
|
199
|
-
"warn",
|
|
200
|
-
{
|
|
201
|
-
contexts: ["any"],
|
|
202
|
-
},
|
|
203
|
-
],
|
|
172
|
+
"jsdoc/require-property-description": "warn",
|
|
204
173
|
|
|
205
174
|
/**
|
|
206
175
|
* Documentation:
|
|
@@ -208,16 +177,11 @@ module.exports = {
|
|
|
208
177
|
*
|
|
209
178
|
* Requires that each `@property` tag has a name.
|
|
210
179
|
*/
|
|
211
|
-
"jsdoc/require-property-name":
|
|
212
|
-
"warn",
|
|
213
|
-
{
|
|
214
|
-
contexts: ["any"],
|
|
215
|
-
},
|
|
216
|
-
],
|
|
180
|
+
"jsdoc/require-property-name": "warn",
|
|
217
181
|
|
|
218
182
|
// - jsdoc/require-property-type - Not needed in TypeScript.
|
|
219
183
|
// - jsdoc/require-returns-check - It's overboard for every function to document every return
|
|
220
|
-
//
|
|
184
|
+
// value.
|
|
221
185
|
|
|
222
186
|
/**
|
|
223
187
|
* Documentation:
|
|
@@ -238,7 +202,7 @@ module.exports = {
|
|
|
238
202
|
// - jsdoc/require-yields - It's overboard to document every yield.
|
|
239
203
|
// - jsdoc/require-yields-check - It's overboard to document every yield.
|
|
240
204
|
// - jsdoc/sort-tags - Not very useful since there are typically only `@param` and `@return`
|
|
241
|
-
//
|
|
205
|
+
// tags.
|
|
242
206
|
|
|
243
207
|
/**
|
|
244
208
|
* Documentation:
|
|
@@ -246,12 +210,7 @@ module.exports = {
|
|
|
246
210
|
*
|
|
247
211
|
* Enforces no lines between tags.
|
|
248
212
|
*/
|
|
249
|
-
"jsdoc/tag-lines":
|
|
250
|
-
"warn",
|
|
251
|
-
{
|
|
252
|
-
contexts: ["any"],
|
|
253
|
-
},
|
|
254
|
-
],
|
|
213
|
+
"jsdoc/tag-lines": "warn",
|
|
255
214
|
|
|
256
215
|
// - jsdoc/valid-types - Not needed in TypeScript.
|
|
257
216
|
},
|