@lewishowles/lint-config 0.5.0 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.6.1: 2026-09-21
+
+### Fixes
+
+- `comments/function-documentation`: accept the name the JSDoc gives a destructured object parameter, instead of always expecting `options`.
+
+## 0.6.0: 2026-09-21
+
+### Changes
+
+- Breaking: replace `comments/line-comments`, `comments/max-line-length`, `comments/sentence-punctuation`, `comments/block-comments`, `comments/jsdoc-tag-formatting`, and `comments/placement` with a single `comments/formatting` rule. Remove the old rule IDs from your configuration; `comments.json` already enables `comments/formatting`.
+- Breaking: `base` now reports an error when statements of different kinds, such as a declaration followed by a function call, have no blank line between them, and when consecutive `const` or `let` declarations are separated by a blank line. Run `--fix` once to update existing code.
+- `comments/formatting` moves trailing line comments onto their own line above the code.
+
+### Fixes
+
+- `comments/formatting`: refill comment lines that were wrapped before the 80-column limit.
+- `comments/variable-declarations`: skip the line-comment requirement for `const` declarations assigned to arrow functions or function expressions.
+
 ## 0.5.0: 2026-09-11
 
 ### Changes

package/README.md

@@ -49,7 +49,7 @@ The Vue layer extends `base.json` internally, so you only need to extend `vue.js
 
 ### Comment formatting (optional)
 
-Add the comments layer alongside the base or Vue layer to enforce the comment-formatting rules, variable-declaration documentation, JSDoc on named functions and first-level object methods, documentation directly after each Vue `<script setup>` opening tag, and block comments for runtime `defineProps` properties:
+Add the comments layer alongside the base or Vue layer to enforce the comment-formatting rules, including moving trailing line comments onto their own line, variable-declaration documentation, JSDoc on named functions and first-level object methods, documentation directly after each Vue `<script setup>` opening tag, and block comments for runtime `defineProps` properties:
 
 ```json
 {
@@ -73,7 +73,7 @@ The Vue component rule reads the raw `.vue` file because Oxlint's JS Plugin API
 		}
 	],
 	"rules": {
-		"comments/line-comments": "error"
+		"comments/formatting": "error"
 	}
 }
 ```

package/base.json

@@ -35,13 +35,32 @@
 		"@stylistic/no-confusing-arrow": "error",
 		"@stylistic/padding-line-between-statements": [
 			"error",
-			{ "blankLine": "always", "prev": "const", "next": "let" },
-			{ "blankLine": "always", "prev": "let", "next": "const" },
 			{ "blankLine": "always", "prev": "*", "next": "break" },
 			{ "blankLine": "always", "prev": ["const", "let"], "next": "*" },
+			{ "blankLine": "always", "prev": "*", "next": ["const", "let"] },
 			{ "blankLine": "always", "prev": "*", "next": "return" },
-			{ "blankLine": "any", "prev": "const", "next": "const" },
-			{ "blankLine": "any", "prev": "let", "next": "let" },
+			{
+				"blankLine": "always",
+				"prev": ["block-like", "class", "do", "for", "function", "if", "switch", "try", "while"],
+				"next": "*"
+			},
+			{
+				"blankLine": "always",
+				"prev": "*",
+				"next": ["block-like", "class", "do", "for", "function", "if", "switch", "try", "while"]
+			},
+			{
+				"blankLine": "always",
+				"prev": { "selector": "ExpressionStatement[expression.type=\"AssignmentExpression\"]" },
+				"next": { "selector": "ExpressionStatement[expression.type=\"CallExpression\"]" }
+			},
+			{
+				"blankLine": "always",
+				"prev": { "selector": "ExpressionStatement[expression.type=\"CallExpression\"]" },
+				"next": { "selector": "ExpressionStatement[expression.type=\"AssignmentExpression\"]" }
+			},
+			{ "blankLine": "never", "prev": "const", "next": "const" },
+			{ "blankLine": "never", "prev": "let", "next": "let" },
 			{ "blankLine": "always", "prev": "multiline-const", "next": "*" },
 			{ "blankLine": "always", "prev": "*", "next": "multiline-const" }
 		],

package/comments/plugin.js

@@ -1,12 +1,7 @@
-import blockComments from "./rules/block-comments.js";
 import classDocumentation from "./rules/class-documentation.js";
 import configuredApiCalls from "./rules/configured-api-calls.js";
+import formatting from "./rules/formatting.js";
 import functionDocumentation from "./rules/function-documentation.js";
-import jsdocTagFormatting from "./rules/jsdoc-tag-formatting.js";
-import lineComments from "./rules/line-comments.js";
-import maxLineLength from "./rules/max-line-length.js";
-import placement from "./rules/placement.js";
-import sentencePunctuation from "./rules/sentence-punctuation.js";
 import variableDeclarations from "./rules/variable-declarations.js";
 import vueComponentDocumentation from "./rules/vue-component-documentation.js";
 import vueEmitDocumentation from "./rules/vue-emit-documentation.js";
@@ -15,15 +10,10 @@ import vuePropDocumentation from "./rules/vue-prop-documentation.js";
 export default {
 	meta: { name: "comments" },
 	rules: {
-		"block-comments": blockComments,
 		"class-documentation": classDocumentation,
 		"configured-api-calls": configuredApiCalls,
+		formatting,
 		"function-documentation": functionDocumentation,
-		"jsdoc-tag-formatting": jsdocTagFormatting,
-		"line-comments": lineComments,
-		"max-line-length": maxLineLength,
-		placement,
-		"sentence-punctuation": sentencePunctuation,
 		"variable-declarations": variableDeclarations,
 		"vue-component-documentation": vueComponentDocumentation,
 		"vue-emit-documentation": vueEmitDocumentation,

package/comments/rules/configured-api-calls.js

@@ -118,10 +118,8 @@ export default {
 			 */
 			CallExpression(node) {
 				// Read fresh for every call: createOnce's visitor is shared
-				// across every file
-				// in the run, so caching this at closure-creation time would
-				// freeze the first
-				// file's options.
+				// across every file in the run, so caching this at
+				// closure-creation time would freeze the first file's options.
 				const configuredApis = getConfiguredApis(context);
 
 				if (node.callee.type !== "Identifier" || !configuredApis.has(node.callee.name)) {