linted 37.0.0-rc.0 → 37.0.0-rc.1

package/.markdownlint.jsonc

@@ -1,5 +1,5 @@
 {
-  // #region v38.1.1
+  // #region v40.0.0
   "$schema": "https://gist.githubusercontent.com/jimmy-zhening-luo/e0d6b5715f0df18bc462f752520bd485/raw",
   "$help": {
     "link": "https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md",
@@ -12,14 +12,14 @@
   "ul-style": false /* MD004 */,
   "list-indent": true /* MD005 */,
   "ul-indent": {
-    "indent": 4,
+    "indent": 2,
   } /* MD007 */,
   "no-trailing-spaces": {
     "br_spaces": 0,
     "strict": true,
   } /* MD009 */,
   "no-hard-tabs": {
-    "spaces_per_tab": 4,
+    "spaces_per_tab": 2,
     "ignore_code_languages": [],
   } /* MD010 */,
   "no-reversed-links": true /* MD011 */,
@@ -94,4 +94,8 @@
   "table-column-count": true /* MD056 */,
   "blanks-around-tables": true /* MD058 */,
   "descriptive-link-text": false /* MD059 */,
+  "table-column-style": {
+    "style": "aligned",
+    "aligned_delimiter": true /* implicitly true when style:aligned */,
+  } /* MD060 */,
 }

package/README.md

@@ -1,4 +1,5 @@
 # [`linted`](https://www.npmjs.com/package/linted)
+
 [![NPM Publish](https://github.com/jimmy-zhening-luo/linted/actions/workflows/RELEASE.yml/badge.svg)](https://github.com/jimmy-zhening-luo/linted/actions/workflows/RELEASE.yml)
 
 > [!CAUTION]
@@ -18,10 +19,11 @@
 ## Languages
 
 ### Web
+
 > [!NOTE]
 > _See language support __[roadmap](#roadmap).___
 
-- __[JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript):__  [`eslint`](https://eslint.org)
+- __[JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript):__ [`eslint`](https://eslint.org)
 - __[TypeScript](https://www.typescriptlang.org):__ [`@typescript-eslint`](https://typescript-eslint.io/) + [`eslint`](https://eslint.org)
 - __[Svelte](https://svelte.dev):__ [`eslint-plugin-svelte`](https://sveltejs.github.io/eslint-plugin-svelte/) + [`@typescript-eslint`](https://typescript-eslint.io/) + [`eslint`](https://eslint.org)
 - __[HTML](https://developer.mozilla.org/en-US/docs/Web/HTML):__ [`@html-eslint`](https://html-eslint.org/)
@@ -34,30 +36,32 @@
 ## Features
 
 ### Zero-Dependency
+
 No need to install 17 plugins and 12 parsers: each language's latest plugin is bundled and configured.
 
 ### Zero-Config
+
 No need to remember each plugin's `parserOptions`; you won't have to do _this_ just to enable Svelte linting:
 
 ```javascript
-    // lint TypeScript blocks in Svelte
-    plugins: {
-      "@typescript-eslint": ts,
-      svelte,
-    },
-    languageOptions: {
-      ecmaVersion: "latest",
-      sourceType: "module",
-      parser: svelteParser,
-      parserOptions: {
-        parser: tsParser,
-        ecmaVersion: "latest",
-        sourceType: "module",
-        project: "tsconfig.json",
-        extraFileExtensions: [".svelte"],
-      },
-    },
-    processor: "svelte/svelte",
+// lint TypeScript blocks in Svelte
+plugins: {
+  "@typescript-eslint": ts,
+  svelte,
+},
+languageOptions: {
+  ecmaVersion: "latest",
+  sourceType: "module",
+  parser: svelteParser,
+  parserOptions: {
+    parser: tsParser,
+    ecmaVersion: "latest",
+    sourceType: "module",
+    project: "tsconfig.json",
+    extraFileExtensions: [".svelte"],
+  },
+},
+processor: "svelte/svelte",
 ```
 
 ### Zero-Arugment API
@@ -96,13 +100,12 @@ linted(
       "src/**/*.ts",
       "*.config.ts",
     ],
-
     // svelte: [],
     // html: [],
 
     /* ...json, jsonc, yml, */
   },
-)
+);
 ```
 
 #### `ignores` _(Global)_
@@ -125,8 +128,8 @@ linted(
 
 ```javascript
 linted(
-  { /** includes **/ },
-  { /** ignores **/ },
+  {/** includes **/},
+  {/** ignores **/},
   {
     /** overrides **/
     overrideJs: {}, /* js rule overrides */
@@ -138,16 +141,17 @@ linted(
       "no-unused-vars": "off", /* example: ESLint base rule */
       "@typescript-eslint/indent": "warn", /* example: TypeScript plugin rule */
     }, /* js rule overrides */
-
     /* ...overrideTs, overrideSvelte, overrideHtml, overrideJson, overrideJsonc, overrideYml, */
   },
-)
+);
 ```
 
 ## Limitation
+
 In __TypeScript__ projects, [`skipLibCheck`](https://www.typescriptlang.org/tsconfig/#skipLibCheck) must be `true`.
 
 ### Enable `skipLibCheck`
+
 By default, `skipLibCheck` is `false`. To set it to `true`:
 
 #### `tsconfig.json`
@@ -170,28 +174,28 @@ tsc --skipLibCheck
 
 1. Install [`eslint`](https://www.npmjs.com/package/eslint) and [`linted`](https://www.npmjs.com/package/linted).
 
-    ```bash
-    npm i -D eslint@^8.57 linted
-    ```
+   ```bash
+   npm i -D eslint@^8.57 linted
+   ```
 
 1. Create `eslint.config.js` in your project root.
 
 1. In `eslint.config.js`:
-    + Import function `linted`.
+   - Import function `linted`.
 
-        ```javascript
-        import linted from "linted";
-        ```
+     ```javascript
+     import linted from "linted";
+     ```
 
-    + Export `linted` with optional [arguments](#total-control-via-optional-arguments):
+   - Export `linted` with optional [arguments](#total-control-via-optional-arguments):
 
-        ```javascript
-        import linted from "linted";
+     ```javascript
+     import linted from "linted";
 
-        export default linted(
-          // ...
-        );
-        ```
+     export default linted(
+       // ...
+     );
+     ```
 
 ---
 
@@ -213,11 +217,11 @@ tsc --skipLibCheck
 
 - Svelte Interaction TBD
 
-    + .svelte-embedded HTML (on top of Svelte HTML rules)
+  - .svelte-embedded HTML (on top of Svelte HTML rules)
 
-    + .html files in Svelte projects (e.g. title not required)
+  - .html files in Svelte projects (e.g. title not required)
 
-    + Should Svelte-Linter handle all .html / HTML-embedded linting for Svelte projects, and HTML-Linter only handles non-Svelte projects?
+  - Should Svelte-Linter handle all .html / HTML-embedded linting for Svelte projects, and HTML-Linter only handles non-Svelte projects?
 
 #### JSON (Custom Schema Validation)
 
@@ -228,6 +232,7 @@ tsc --skipLibCheck
 ## Rule Logic (Advanced)
 
 ### What is `scope`?
+
 Each `scope` maps to a unique `language`:
 
 - __`js`:__ `JavaScript`
@@ -239,6 +244,7 @@ Each `scope` maps to a unique `language`:
 - __`yml`:__ `YAML`
 
 ### Rules
+
 Each `scope` supports:
 
 - all base ESLint rules
@@ -249,6 +255,7 @@ Each `scope` supports:
 - Each `language` has a set of default rules.
 
 #### Language-Aggregate `scope`
+
 A `language` can be an extension of or depend on another `language`.
 
 For example:
@@ -271,53 +278,57 @@ For such a `language`, its `scope`'s default rules are aggregated with the defau
 #### Global Ignores
 
 ##### `.gitignore`
+
 By default, `linted` ignores all files in `.gitignore`. This behavior can be disabled.
 
 ##### `package-lock.json`
+
 `**/*.package-lock.json` is always skipped. _This cannot be overriden._
 
 ##### `ignores`
+
 Additional glob patterns supplied if matched by a file will skip linting that file, even if a scope pattern matches the file.
 
 #### Scoped Includes
+
 Files specified in `scope` are appended to the following default files:
 
 ```javascript
-  {
-    js: [
-      "{src,static}/**/*.{js,mjs,cjs}",
-      "*.{js,mjs,cjs}",
-    ],
-    ts: [
-      "{src,static}/**/*.{ts,mts,cts}",
-      "*.{ts,mts,cts}",
-    ],
-    svelte: ["{src,static}/**/*.svelte"],
-    html: [
-      "{src,static}/**/*.html",
-      "*.html",
-    ],
-    json: [
-      "{src,static}/**/*.json",
-      "*.json",
-    ],
-    jsonc: [
-      "tsconfig.json",
-      "{src,static}/**/*.jsonc",
-      "*.jsonc",
-    ],
-    yml: [
-      ".github/workflows/*.{yml,yaml}",
-      "{src,static}/**/*.{yml,yaml}",
-      "*.{yml,yaml}",
-    ],
-  },
+{
+  js: [
+    "{src,static}/**/*.{js,mjs,cjs}",
+    "*.{js,mjs,cjs}",
+  ],
+  ts: [
+    "{src,static}/**/*.{ts,mts,cts}",
+    "*.{ts,mts,cts}",
+  ],
+  svelte: ["{src,static}/**/*.svelte"],
+  html: [
+    "{src,static}/**/*.html",
+    "*.html",
+  ],
+  json: [
+    "{src,static}/**/*.json",
+    "*.json",
+  ],
+  jsonc: [
+    "tsconfig.json",
+    "{src,static}/**/*.jsonc",
+    "*.jsonc",
+  ],
+  yml: [
+    ".github/workflows/*.{yml,yaml}",
+    "{src,static}/**/*.{yml,yaml}",
+    "*.{yml,yaml}",
+  ],
+},
 ```
 
 #### Scope Conflict
 
 - If a given file matches more than one `scope` glob, then the set of all matching `scope`s' rules are applied to the file.
-- If any rule is specified in more than one `scope` matching a given file, the  specifies a rule, then the highest-precedence `scope`'s rule specification wins.
+- If any rule is specified in more than one `scope` matching a given file, the specifies a rule, then the highest-precedence `scope`'s rule specification wins.
 
 ##### Scope Precedence (low to high)
 
@@ -333,14 +344,17 @@ ignores (global)
 ```
 
 ### Override
+
 Overrides are per-__scope.__
 
 #### Example
+
 `overrideTs` rules apply to files which:
 
 - ✅ ONLY match scope `ts`.
 - ✅ match scope `ts` and any number of lower precedence scopes (e.g. `js`).
   > [!NOTE]
   > `overrideTs` rules do __NOT__ apply to files which:
+  >
   > - TBD
 - ❌ match scope `ts` and at least one higher precedence scope (e.g. `svelte`), even if the higher precedence scope includes `ts` language default rules (e.g. `svelte` includes `ts` default rules, but NOT `overrideTs` rules).

package/dprint.jsonc

@@ -0,0 +1,233 @@
+{
+  "$schema": "https://raw.githubusercontent.com/jimmy-zhening-luo/dprint/refs/heads/main/dprint-schema.json",
+  // $help: https://dprint.dev/config/
+  // $version: 0.5101.0
+  "plugins": [
+    "https://plugins.dprint.dev/typescript-0.95.13.wasm",
+    "https://plugins.dprint.dev/json-0.21.0.wasm",
+    "https://plugins.dprint.dev/markdown-0.20.0.wasm",
+    "https://plugins.dprint.dev/g-plane/markup_fmt-v0.25.3.wasm",
+    "https://plugins.dprint.dev/g-plane/malva-v0.15.1.wasm",
+    "https://plugins.dprint.dev/g-plane/pretty_yaml-v0.5.1.wasm",
+    "https://plugins.dprint.dev/g-plane/pretty_jinja-v0.2.0.wasm",
+    "https://plugins.dprint.dev/roslyn-0.19.1.json@a5daf2404c57680374f255c78f1956916482aa4b4e90825f1a48eb5a7e343b35",
+  ],
+  "excludes": [
+    "**/node_modules/**",
+    "**/*-lock.json",
+    "**/.clasprc.json",
+    "**/dist/**",
+    "**/.svelte-kit/**",
+    "**/.vscode/c_cpp_properties.json",
+  ],
+  "lineWidth": 180,
+  "newLineKind": "lf",
+  "useTabs": false,
+  "indentWidth": 2,
+  "typescript": {
+    // $help: https://dprint.dev/plugins/typescript/
+    // $help: https://dprint.dev/plugins/typescript/config/
+    "locked": true,
+    "lineWidth": 180,
+    "newLineKind": "lf",
+    "useTabs": false,
+    "indentWidth": 2,
+    "ignoreNodeCommentText": "dprint-ignore",
+    "ignoreFileCommentText": "dprint-ignore-file",
+    "quoteStyle": "preferDouble",
+    "quoteProps": "asNeeded",
+    "semiColons": "always",
+    "preferHanging": false,
+    "preferSingleLine": false,
+    "spaceAround": false,
+    "trailingCommas": "onlyMultiLine",
+    "bracePosition": "sameLine",
+    "useBraces": "preferNone",
+    "operatorPosition": "nextLine",
+    "singleBodyPosition": "nextLine",
+    "nextControlFlowPosition": "nextLine",
+    "spaceSurroundingProperties": true,
+    "arrowFunction.useParentheses": "preferNone",
+    "binaryExpression.linePerExpression": true,
+    "binaryExpression.spaceSurroundingBitwiseAndArithmeticOperator": true,
+    "commentLine.forceSpaceAfterSlashes": false,
+    "constructor.spaceBeforeParentheses": true,
+    "constructorType.spaceAfterNewKeyword": false,
+    "constructSignature.spaceAfterNewKeyword": true,
+    "doWhileStatement.spaceAfterWhileKeyword": true,
+    "enumDeclaration.memberSpacing": "newLine",
+    "exportDeclaration.forceMultiLine": "whenMultiple",
+    "exportDeclaration.forceSingleLine": false,
+    "exportDeclaration.sortNamedExports": "maintain",
+    "exportDeclaration.sortTypeOnlyExports": "none",
+    "exportDeclaration.spaceSurroundingNamedExports": true,
+    "forInStatement.spaceAfterForKeyword": true,
+    "forStatement.spaceAfterSemiColons": true,
+    "functionDeclaration.spaceBeforeParentheses": false,
+    "functionExpression.spaceAfterFunctionKeyword": true,
+    "functionExpression.spaceBeforeParentheses": false,
+    "getAccessor.spaceBeforeParentheses": false,
+    "ifStatement.spaceAfterIfKeyword": true,
+    "importDeclaration.forceMultiLine": "whenMultiple",
+    "importDeclaration.forceSingleLine": false,
+    "importDeclaration.sortNamedImports": "maintain",
+    "importDeclaration.sortTypeOnlyImports": "none",
+    "importDeclaration.spaceSurroundingNamedImports": true,
+    "memberExpression.linePerExpression": true,
+    "method.spaceBeforeParentheses": false,
+    "module.sortExportDeclarations": "maintain",
+    "module.sortImportDeclarations": "maintain",
+    "setAccessor.spaceBeforeParentheses": false,
+    "taggedTemplate.spaceBeforeLiteral": false,
+    "typeAnnotation.spaceBeforeColon": false,
+    "typeAssertion.spaceBeforeExpression": false,
+    "typeLiteral.separatorKind": "semiColon",
+    "whileStatement.spaceAfterWhileKeyword": true,
+  },
+  "roslyn": {
+    // $help: https://learn.microsoft.com/en-us/dotnet/api/microsoft.codeanalysis.csharp.formatting.csharpformattingoptions#properties
+    // DOC:[source] https://github.com/dotnet/roslyn/blob/main/src/Workspaces/CSharp/Portable/Formatting/CSharpFormattingOptions.cs
+    "csharp.indentBlock": true,
+    "csharp.indentBraces": false,
+    "csharp.indentSwitchSection": true,
+    "csharp.indentSwitchCaseSection": true,
+    "csharp.indentSwitchCaseSectionWhenBlock": true,
+    "csharp.newLineForElse": true,
+    "csharp.newLineForCatch": true,
+    "csharp.newLineForFinally": true,
+    "csharp.labelPositioning": "LeftMost" /* 0 */,
+    "csharp.newLineForClausesInQuery": true,
+    "csharp.spaceAfterCast": false,
+    "csharp.newLineForMembersInAnonymousTypes": true,
+    "csharp.newLineForMembersInObjectInit": true,
+    "csharp.newLinesForBracesInAccessors": true,
+    "csharp.newLinesForBracesInAnonymousMethods": true,
+    "csharp.newLinesForBracesInControlBlocks": true,
+    "csharp.newLinesForBracesInLambdaExpressionBody": true,
+    "csharp.newLinesForBracesInMethods": true,
+    "csharp.newLinesForBracesInTypes": true,
+    "csharp.newLinesForBracesInAnonymousTypes": true,
+    "csharp.newLinesForBracesInObjectCollectionArrayInitializers": true,
+    "csharp.newLinesForBracesInProperties": true,
+    "csharp.spaceBetweenEmptyMethodCallParentheses": false,
+    "csharp.spaceAfterColonInBaseTypeDeclaration": true,
+    "csharp.spaceAfterComma": true,
+    "csharp.spaceAfterDot": false,
+    "csharp.spaceAfterControlFlowStatementKeyword": true,
+    "csharp.spaceAfterMethodCallName": false,
+    "csharp.spaceAfterSemicolonsInForStatement": true,
+    "csharp.spaceBeforeColonInBaseTypeDeclaration": true,
+    "csharp.spaceBeforeComma": false,
+    "csharp.spaceBeforeDot": false,
+    "csharp.spaceBeforeSemicolonsInForStatement": false,
+    "csharp.spaceBetweenEmptySquareBrackets": false,
+    "csharp.spaceBeforeOpenSquareBracket": false,
+    "csharp.spaceBetweenEmptyMethodDeclarationParentheses": false,
+    "csharp.spacesIgnoreAroundVariableDeclaration": false,
+    "csharp.spaceWithinCastParentheses": false,
+    "csharp.spaceWithinExpressionParentheses": false,
+    "csharp.spaceWithinMethodCallParentheses": false,
+    "csharp.spaceWithinMethodDeclarationParenthesis": false,
+    "csharp.spaceWithinOtherParentheses": false,
+    "csharp.spaceWithinSquareBrackets": false,
+    "csharp.spacingAfterMethodDeclarationName": false,
+    "csharp.spacingAroundBinaryOperator": "Single" /* 0 */,
+    "csharp.wrappingKeepStatementsOnSingleLine": true,
+    "csharp.wrappingPreserveSingleLine": true,
+  },
+  "json": {
+    // $help: https://dprint.dev/plugins/json/config/
+    "locked": true,
+    "lineWidth": 80,
+    "newLineKind": "lf",
+    "useTabs": false,
+    "indentWidth": 2,
+    "ignoreNodeCommentText": "dprint-ignore",
+    "commentLine.forceSpaceAfterSlashes": true,
+    "preferSingleLine": false,
+    "trailingCommas": "maintain",
+    "array.preferSingleLine": false,
+    "object.preferSingleLine": false,
+  },
+  "markdown": {
+    // $help: https://dprint.dev/plugins/markdown/config/
+    "locked": true,
+    "lineWidth": 180,
+    "newLineKind": "lf",
+    "textWrap": "maintain",
+    "emphasisKind": "underscores",
+    "strongKind": "underscores",
+    "ignoreDirective": "dprint-ignore",
+    "ignoreFileDirective": "dprint-ignore-file",
+    "ignoreStartDirective": "dprint-ignore-start",
+    "ignoreEndDirective": "dprint-ignore-end",
+  },
+  "markup": {
+    // $help: https://markup-fmt.netlify.app/
+    "printWidth": 180,
+    "useTabs": false,
+    "indentWidth": 2,
+    "lineBreak": "lf",
+    "quotes": "double",
+    "formatComments": true,
+    "scriptIndent": true,
+    "styleIndent": true,
+    "closingBracketSameLine": false,
+    "closingTagLineBreakForEmpty": "fit",
+    "maxAttrsPerLine": 1,
+    "preferAttrsSingleLine": false,
+    "singleAttrSameLine": true,
+    "whitespaceSensitivity": "css",
+    "doctypeKeywordCase": "upper",
+    "strictSvelteAttr": false,
+    "svelteAttrShorthand": true,
+    "svelteDirectiveShorthand": true,
+    "scriptFormatter": "dprint",
+    "ignoreCommentDirective": "dprint-ignore",
+    "ignoreFileCommentDirective": "dprint-ignore-file",
+  },
+  "malva": {
+    // $help: https://malva.netlify.app/config/index.html
+    "printWidth": 180,
+    "useTabs": false,
+    "indentWidth": 2,
+    "lineBreak": "lf",
+    "hexCase": "lower",
+    "hexColorLength": "short",
+    "quotes": "preferDouble",
+    "operatorLinebreak": "after",
+    "blockSelectorLinebreak": "always",
+    "omitNumberLeadingZero": false,
+    "trailingComma": true,
+    "formatComments": true,
+    "alignComments": true,
+    "linebreakInPseudoParens": true,
+    "declarationOrder": null,
+    "declarationOrderGroupBy": "nonDeclaration",
+    "singleLineBlockThreshold": 1,
+    "keyframeSelectorNotation": "keyword",
+    "attrValueQuotes": "always",
+    "preferSingleLine": false,
+    "singleLineTopLevelDeclarations": false,
+    "selectorOverrideCommentDirective": "malva-selector-override",
+    "ignoreCommentDirective": "dprint-ignore",
+    "ignoreFileCommentDirective": "dprint-ignore-file",
+  },
+  "yaml": {
+    // $help: https://pretty-yaml.netlify.app/
+    "printWidth": 180,
+    "indentWidth": 2,
+    "lineBreak": "lf",
+    "quotes": "preferDouble",
+    "trailingComma": true,
+    "formatComments": false,
+    "indentBlockSequenceInMap": true,
+    "braceSpacing": false,
+    "bracketSpacing": false,
+    "dashSpacing": "oneSpace",
+    "preferSingleLine": false,
+    "trimTrailingWhitespaces": true,
+    "trimTrailingZero": true,
+    "ignoreCommentDirective": "dprint-ignore",
+  },
+}

package/package.json

@@ -3,7 +3,7 @@
   "$schema": "https://json.schemastore.org/package",
   "$help": "https://docs.npmjs.com/cli/configuring-npm/package-json",
   "name": "linted",
-  "version": "37.0.0-rc.0",
+  "version": "37.0.0-rc.1",
   "repository": "github:jimmy-zhening-luo/linted",
   "description": "ESLint mono-plugin bundler with strict, opinionated defaults for JavaScript, TypeScript, Svelte, HTML, Tailwind/CSS, JSON, JSONC, YAML, and Mocha.",
   "keywords": [
@@ -59,9 +59,10 @@
   "dependencies": {
     "@eslint/css": "0.14.1",
     "@eslint/json": "0.14.0",
-    "@eslinted/core": "32.1.12",
-    "@eslinted/defaults": "19.0.0-rc.0",
+    "@eslinted/core": "32.1.13",
+    "@eslinted/defaults": "19.0.2",
     "@html-eslint/eslint-plugin": "0.52.1",
+    "@stylistic/eslint-plugin": "5.6.1",
     "eslint-plugin-jsonc": "2.21.0",
     "eslint-plugin-yml": "1.19.1",
     "typescript-eslint": "^8.51.0"