eslint-config-isaacscript 1.0.73 → 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.
Files changed (3) hide show
  1. package/README.md +2 -0
  2. package/jsdoc.js +29 -70
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -4,4 +4,6 @@
4
4
 
5
5
  This is a helper configuration for ESLint that is intended to be used in IsaacScript projects.
6
6
 
7
+ This package is consumed by the [`isaacscript-lint`](https://github.com/IsaacScript/isaacscript-lint) meta-linting package.
8
+
7
9
  Please see the [IsaacScript webpage](https://isaacscript.github.io/) for more information.
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 every rule because by default, the JSDoc rules will only
13
- * affect a subset of AST node types.
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: https://github.com/gajus/eslint-plugin-jsdoc#check-param-names
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: https://github.com/gajus/eslint-plugin-jsdoc#check-values
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: https://github.com/gajus/eslint-plugin-jsdoc#check-values
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: https://github.com/gajus/eslint-plugin-jsdoc#implements-on-classes
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,30 +95,27 @@ module.exports = {
112
95
  // - jsdoc/no-restricted-syntax - Not generally relevant.
113
96
 
114
97
  /**
115
- * Documentation: https://github.com/gajus/eslint-plugin-jsdoc#no-types
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
  */
119
103
  "jsdoc/no-types": [
120
104
  "warn",
121
105
  {
122
- contexts: "any",
106
+ contexts: ["any"],
123
107
  },
124
108
  ],
125
109
 
126
110
  // - jsdoc/no-undefined-types - Not needed in TypeScript.
127
111
 
128
112
  /**
129
- * Documentation: https://github.com/gajus/eslint-plugin-jsdoc#require-asterisk-prefix
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
 
@@ -168,7 +142,7 @@ module.exports = {
168
142
  "jsdoc/require-param-description": [
169
143
  "warn",
170
144
  {
171
- contexts: "any",
145
+ contexts: ["any"],
172
146
  },
173
147
  ],
174
148
 
@@ -181,7 +155,7 @@ module.exports = {
181
155
  "jsdoc/require-param-name": [
182
156
  "warn",
183
157
  {
184
- contexts: "any",
158
+ contexts: ["any"],
185
159
  },
186
160
  ],
187
161
 
@@ -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
- // value.
184
+ // value.
221
185
 
222
186
  /**
223
187
  * Documentation:
@@ -228,7 +192,7 @@ module.exports = {
228
192
  "jsdoc/require-returns-description": [
229
193
  "warn",
230
194
  {
231
- contexts: "any",
195
+ contexts: ["any"],
232
196
  },
233
197
  ],
234
198
 
@@ -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
- // tags.
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
  },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "eslint-config-isaacscript",
3
- "version": "1.0.73",
3
+ "version": "1.0.76",
4
4
  "description": "An ESLint config for IsaacScript projects.",
5
5
  "repository": {
6
6
  "type": "git",