isaacscript-lint 1.0.73 → 1.0.74

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 (2) hide show
  1. package/README.md +35 -35
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -54,35 +54,7 @@ Because of the advantages of Prettier, we use it on top of the Airbnb config, an
54
54
 
55
55
  Finally, some specific Airbnb rules are disabled, since they don't make much sense in certain contexts. You can see the specific exclusions in the [base.js](https://github.com/IsaacScript/eslint-config-isaacscript/blob/main/base.js) and [mod.js](https://github.com/IsaacScript/eslint-config-isaacscript/blob/main/mod.js) files of the [`eslint-config-isaacscript`](https://github.com/IsaacScript/eslint-config-isaacscript) repository.
56
56
 
57
- In order to avoid running two different tools, we could use [eslint-plugin-prettier](https://github.com/prettier/eslint-plugin-prettier) to run Prettier as an ESLint rule. However, doing this [is not recommended by Prettier](https://prettier.io/docs/en/integrating-with-linters.html). Thus, in order to use `isaacscript-lint`, you should be running both Prettier and ESLint on save. You can accomplish this by
58
-
59
- In conclusion, in order to really auto-format Unfortunately, this means thatInstead of running two different tools, we run Prettier inside of ESLint as a plugin with [`eslint-plugin-prettier`](https://github.com/prettier/eslint-plugin-prettier). Then,
60
-
61
- <br />
62
-
63
- ## Package Documentation
64
-
65
- - [`@typescript-eslint/eslint-plugin`](https://github.com/typescript-eslint/typescript-eslint/tree/master/packages/eslint-plugin) - Required as a peer dependency for `eslint-config-airbnb-typescript`.
66
- - [`@typescript-eslint/parser`](https://github.com/typescript-eslint/typescript-eslint/tree/master/packages/parser) - Required as a peer dependency for `eslint-config-airbnb-typescript`.
67
- - [`cspell`](https://github.com/streetsidesoftware/cspell) - A spell checker for code that is intended to be paired with the [Code Spell Checker VSCode extension](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker).
68
- - [`eslint`](https://github.com/eslint/eslint) - The main linter engine for JavaScript/TypeScript, as explained above.
69
- - [`eslint-config-airbnb-base`](https://github.com/airbnb/javascript/tree/master/packages/eslint-config-airbnb-base) - ESLint rules that conform to the Airbnb style guide.
70
- - [`eslint-config-airbnb-typescript`](https://github.com/iamturns/eslint-config-airbnb-typescript) - Enhances the Airbnb rules with TypeScript support.
71
- - [`eslint-config-isaacscript`](https://github.com/IsaacScript/eslint-config-isaacscript) - Contains the master ESLint configuration.
72
- - [`eslint-config-prettier`](https://github.com/prettier/eslint-config-prettier) - Turns off all rules that conflict with Prettier.
73
- - [`eslint-plugin-eqeqeq-fix`](https://github.com/Zamiell/eslint-plugin-eqeqeq-fix) - A plugin that provides a better [`eqeqeq`](https://eslint.org/docs/rules/eqeqeq) rule.
74
- - [`eslint-plugin-eslint-comments`](https://github.com/mysticatea/eslint-plugin-eslint-comments) - A plugin that provides rules relating to ESLint comments.
75
- - [`eslint-plugin-import`](https://github.com/benmosher/eslint-plugin-import) - Required as a peer dependency for `eslint-config-airbnb-base`.
76
- - [`eslint-plugin-jsdoc`](https://github.com/gajus/eslint-plugin-jsdoc) - A plugin that provides rules for [JSDoc](https://en.wikipedia.org/wiki/JSDoc).
77
- - [`eslint-plugin-no-implicit-map-set-loops`](https://github.com/Zamiell/eslint-plugin-no-implicit-map-set-loops) - A plugin that prevents unsafe iteration.
78
- - [`eslint-plugin-no-template-curly-in-string-fix`](https://github.com/Zamiell/eslint-plugin-no-template-curly-in-string-fix) - A plugin that provides a better [`no-template-curly-in-string`](https://eslint.org/docs/rules/no-template-curly-in-string) rule.
79
- - [`eslint-plugin-no-void-return-type`](https://github.com/Zamiell/eslint-plugin-no-void-return-type) - A plugin that disallows void return types on unexported functions.
80
- - [`eslint-plugin-only-warn`](https://github.com/bfanger/eslint-plugin-only-warn) - A plugin that turns all errors to warnings.
81
- - [`eslint-plugin-prettier`](https://github.com/prettier/eslint-plugin-prettier) - A plugin that runs Prettier as an ESLint rule.
82
- - [`isaacscript-tsconfig`](https://github.com/IsaacScript/isaacscript-tsconfig) - A package that provides a shared TypeScript configuration file. This is included in the linting meta-package for convenience.
83
- - [`prettier`](https://github.com/prettier/prettier) - This is a peer dependency for `eslint-plugin-prettier`.
84
- - [`prettier-plugin-organize-imports`](https://github.com/simonhaenisch/prettier-plugin-organize-imports) - A plugin used because Prettier will not organize imports automatically. (It has no configuration and is automatically applied to Prettier if it is installed.)
85
- - [`ts-prune`](https://github.com/nadeesha/ts-prune) - A tool to look for unused exports, which catchs bugs that the `import/no-unused-modules` rule cannot find.
57
+ In order to avoid running two different tools, we could use [eslint-plugin-prettier](https://github.com/prettier/eslint-plugin-prettier) to run Prettier as an ESLint rule. However, doing this [is not recommended by Prettier](https://prettier.io/docs/en/integrating-with-linters.html). Thus, in order to use `isaacscript-lint`, you should be running both Prettier and ESLint on save. (More info on that is below.)
86
58
 
87
59
  <br />
88
60
 
@@ -147,6 +119,8 @@ Create a `tsconfig.eslint.json` file in the root of your repository:
147
119
  }
148
120
  ```
149
121
 
122
+ <br />
123
+
150
124
  ## Adding or Removing Rules
151
125
 
152
126
  You can add extra rules (or ignore existing rules) by editing the `rules` section of your `eslintrc.js` file. For example:
@@ -181,15 +155,17 @@ Furthermore, you will probably want Prettier and ESLint to be run automatically
181
155
  // These are Visual Studio Code settings that should apply to this particular repository
182
156
  {
183
157
  "[javascript]": {
158
+ "editor.defaultFormatter": "esbenp.prettier-vscode",
159
+ "editor.formatOnSave": true,
184
160
  "editor.codeActionsOnSave": [
185
- "editor.formatOnSave": true,
186
161
  "source.fixAll.eslint",
187
162
  ],
188
163
  },
189
164
 
190
165
  "[typescript]": {
166
+ "editor.defaultFormatter": "esbenp.prettier-vscode",
167
+ "editor.formatOnSave": true,
191
168
  "editor.codeActionsOnSave": [
192
- "editor.formatOnSave": true,
193
169
  "source.fixAll.eslint",
194
170
  ],
195
171
  },
@@ -198,11 +174,11 @@ Furthermore, you will probably want Prettier and ESLint to be run automatically
198
174
 
199
175
  (Create this file if it does not already exist.)
200
176
 
201
- You can also commit this file to your project's repository so that this behavior is automatically inherited by anyone who clones the project.
177
+ You can also commit this file to your project's repository so that this behavior is automatically inherited by anyone who clones the project (and uses VSCode).
202
178
 
203
179
  ### `.vscode/extensions.json`
204
180
 
205
- Optionally, you can also provide a hint to anyone cloning your repository that they should install the two required extensions:
181
+ Optionally, you can also provide a hint to anyone cloning your repository that they should install the required extensions:
206
182
 
207
183
  ```jsonc
208
184
  // These are Visual Studio Code extensions that are intended to be used with this particular
@@ -213,9 +189,33 @@ Optionally, you can also provide a hint to anyone cloning your repository that t
213
189
  "esbenp.prettier-vscode", // The TypeScript formatter
214
190
  "dbaeumer.vscode-eslint", // The TypeScript linter
215
191
  "streetsidesoftware.code-spell-checker", // A spell-checker extension based on cspell
216
- "typescript-to-lua.vscode-typescript-to-lua", // The TypeScriptToLua extension
217
- ]
192
+ ],
218
193
  }
219
194
  ```
220
195
 
221
196
  <br />
197
+
198
+ ## Package Documentation
199
+
200
+ - [`@typescript-eslint/eslint-plugin`](https://github.com/typescript-eslint/typescript-eslint/tree/master/packages/eslint-plugin) - Required as a peer dependency for `eslint-config-airbnb-typescript`.
201
+ - [`@typescript-eslint/parser`](https://github.com/typescript-eslint/typescript-eslint/tree/master/packages/parser) - Required as a peer dependency for `eslint-config-airbnb-typescript`.
202
+ - [`cspell`](https://github.com/streetsidesoftware/cspell) - A spell checker for code that is intended to be paired with the [Code Spell Checker VSCode extension](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker).
203
+ - [`eslint`](https://github.com/eslint/eslint) - The main linter engine for JavaScript/TypeScript, as explained above.
204
+ - [`eslint-config-airbnb-base`](https://github.com/airbnb/javascript/tree/master/packages/eslint-config-airbnb-base) - ESLint rules that conform to the Airbnb style guide.
205
+ - [`eslint-config-airbnb-typescript`](https://github.com/iamturns/eslint-config-airbnb-typescript) - Enhances the Airbnb rules with TypeScript support.
206
+ - [`eslint-config-isaacscript`](https://github.com/IsaacScript/eslint-config-isaacscript) - Contains the master ESLint configuration.
207
+ - [`eslint-config-prettier`](https://github.com/prettier/eslint-config-prettier) - Turns off all rules that conflict with Prettier.
208
+ - [`eslint-plugin-eqeqeq-fix`](https://github.com/Zamiell/eslint-plugin-eqeqeq-fix) - A plugin that provides a better [`eqeqeq`](https://eslint.org/docs/rules/eqeqeq) rule.
209
+ - [`eslint-plugin-eslint-comments`](https://github.com/mysticatea/eslint-plugin-eslint-comments) - A plugin that provides rules relating to ESLint comments.
210
+ - [`eslint-plugin-import`](https://github.com/benmosher/eslint-plugin-import) - Required as a peer dependency for `eslint-config-airbnb-base`.
211
+ - [`eslint-plugin-jsdoc`](https://github.com/gajus/eslint-plugin-jsdoc) - A plugin that provides rules for [JSDoc](https://en.wikipedia.org/wiki/JSDoc).
212
+ - [`eslint-plugin-no-implicit-map-set-loops`](https://github.com/Zamiell/eslint-plugin-no-implicit-map-set-loops) - A plugin that prevents unsafe iteration.
213
+ - [`eslint-plugin-no-template-curly-in-string-fix`](https://github.com/Zamiell/eslint-plugin-no-template-curly-in-string-fix) - A plugin that provides a better [`no-template-curly-in-string`](https://eslint.org/docs/rules/no-template-curly-in-string) rule.
214
+ - [`eslint-plugin-no-void-return-type`](https://github.com/Zamiell/eslint-plugin-no-void-return-type) - A plugin that disallows void return types on unexported functions.
215
+ - [`eslint-plugin-only-warn`](https://github.com/bfanger/eslint-plugin-only-warn) - A plugin that turns all errors to warnings.
216
+ - [`isaacscript-tsconfig`](https://github.com/IsaacScript/isaacscript-tsconfig) - A package that provides a shared TypeScript configuration file. This is included in the linting meta-package for convenience.
217
+ - [`prettier`](https://github.com/prettier/prettier) - This is a peer dependency for `eslint-plugin-prettier`.
218
+ - [`prettier-plugin-organize-imports`](https://github.com/simonhaenisch/prettier-plugin-organize-imports) - A plugin used because Prettier will not organize imports automatically. (It has no configuration and is automatically applied to Prettier if it is installed.)
219
+ - [`ts-prune`](https://github.com/nadeesha/ts-prune) - A tool to look for unused exports, which catchs bugs that the `import/no-unused-modules` rule cannot find.
220
+
221
+ <br />
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "isaacscript-lint",
3
- "version": "1.0.73",
3
+ "version": "1.0.74",
4
4
  "description": "An updatable linting dependency container for IsaacScript projects.",
5
5
  "repository": {
6
6
  "type": "git",
@@ -11,7 +11,7 @@
11
11
  "dependencies": {
12
12
  "@typescript-eslint/eslint-plugin": "^5.6.0",
13
13
  "@typescript-eslint/parser": "^5.6.0",
14
- "cspell": "^5.13.2",
14
+ "cspell": "^5.13.3",
15
15
  "eslint": "^8.4.1",
16
16
  "eslint-config-airbnb-base": "^15.0.0",
17
17
  "eslint-config-airbnb-typescript": "^16.1.0",
@@ -20,12 +20,12 @@
20
20
  "eslint-plugin-eqeqeq-fix": "^1.0.3",
21
21
  "eslint-plugin-eslint-comments": "^3.2.0",
22
22
  "eslint-plugin-import": "^2.25.3",
23
- "eslint-plugin-jsdoc": "^37.1.0",
23
+ "eslint-plugin-jsdoc": "^37.2.0",
24
24
  "eslint-plugin-no-implicit-map-set-loops": "^1.0.3",
25
25
  "eslint-plugin-no-template-curly-in-string-fix": "^1.0.4",
26
26
  "eslint-plugin-no-void-return-type": "^1.0.2",
27
27
  "eslint-plugin-only-warn": "^1.0.3",
28
- "isaacscript-tsconfig": "^1.1.6",
28
+ "isaacscript-tsconfig": "^1.1.7",
29
29
  "prettier": "^2.5.1",
30
30
  "prettier-plugin-organize-imports": "^2.3.4",
31
31
  "ts-prune": "^0.10.2"