Skip to content

Commit 451db46

Browse files
ota-meshiota-meshi
authored
Add support for flat config (#311)
1 parent 531fddb commit 451db46

20 files changed

+439
-18
lines changed

‎.changeset/famous-countries-applaud.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
"eslint-plugin-jsonc": minor
3+
---
4+
5+
Add support for flat config

‎.devcontainer/devcontainer.json‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,9 +17,9 @@
1717
// Configure tool-specific properties.
1818
"customizations": {
1919
"vscode": {
20-
"extensions": ["dbaeumer.vscode-eslint"],
21-
},
22-
},
20+
"extensions": ["dbaeumer.vscode-eslint"]
21+
}
22+
}
2323

2424
// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
2525
// "remoteUser": "root"

‎.eslintrc.for-vscode.js‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
module.exports = {
2+
extends: [require.resolve("./.eslintrc.js")],
3+
overrides: [
4+
{
5+
files: ["tests/lib/rules/*"],
6+
extends: ["plugin:eslint-rule-tester/recommended-legacy"],
7+
},
8+
],
9+
};

‎.eslintrc.js‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,12 @@ module.exports = {
104104
project: "./tsconfig.json",
105105
},
106106
},
107+
{
108+
files: ["*.md/**", "**/*.md/**"],
109+
rules: {
110+
"n/no-missing-import": "off",
111+
},
112+
},
107113
{
108114
files: ["scripts/**/*.ts", "tests/**/*.ts", "tests-integrations/**/*.ts"],
109115
rules: {
@@ -113,5 +119,16 @@ module.exports = {
113119
"@typescript-eslint/no-misused-promises": "off",
114120
},
115121
},
122+
{
123+
files: ["docs/.vitepress/**/*.*"],
124+
rules: {
125+
"eslint-plugin/require-meta-docs-description": "off",
126+
"eslint-plugin/require-meta-docs-url": "off",
127+
"eslint-plugin/require-meta-type": "off",
128+
"eslint-plugin/prefer-message-ids": "off",
129+
"eslint-plugin/prefer-object-rule": "off",
130+
"eslint-plugin/require-meta-schema": "off",
131+
},
132+
},
116133
],
117134
};

‎.vscode/settings.json‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,9 @@
99
"markdown",
1010
"yaml"
1111
],
12+
"eslint.options": {
13+
"overrideConfigFile": "./.eslintrc.for-vscode.js"
14+
},
1215
"typescript.validate.enable": true,
1316
"javascript.validate.enable": false,
1417
"vetur.validation.script": false,

‎README.md‎

Lines changed: 37 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,43 @@ npm install --save-dev eslint eslint-plugin-jsonc
8989

9090
### Configuration
9191

92-
Use `.eslintrc.*` file to configure rules. See also: [https://eslint.org/docs/user-guide/configuring](https://eslint.org/docs/user-guide/configuring).
92+
#### New (ESLint>=v9) Config (Flat Config)
93+
94+
Use `eslint.config.js` file to configure rules. See also: <https://eslint.org/docs/latest/use/configure/configuration-files-new>.
95+
96+
Example **eslint.config.js**:
97+
98+
```mjs
99+
import eslintPluginJsonc from 'eslint-plugin-jsonc';
100+
export default [
101+
// add more generic rule sets here, such as:
102+
// js.configs.recommended,
103+
...eslintPluginJsonc.configs['flat/recommended-with-jsonc'],
104+
{
105+
rules: {
106+
// override/add rules settings here, such as:
107+
// 'jsonc/rule-name': 'error'
108+
}
109+
}
110+
];
111+
```
112+
113+
This plugin provides configs:
114+
115+
- `*.configs['flat/base']` ... Configuration to enable correct JSON parsing.
116+
- `*.configs['flat/recommended-with-json']` ... Recommended configuration for JSON.
117+
- `*.configs['flat/recommended-with-jsonc']` ... Recommended configuration for JSONC.
118+
- `*.configs['flat/recommended-with-json5']` ... Recommended configuration for JSON5.
119+
- `*.configs['flat/prettier']` ... Turn off rules that may conflict with [Prettier](https://prettier.io/).
120+
- `*.configs['flat/all']` ... Enables all rules. It's meant for testing, not for production use because it changes with every minor and major version of the plugin. Use it at your own risk.
121+
122+
This plugin will parse `.json`, `.jsonc` and `.json5` by default using the configuration provided by the plugin (unless you already have a parser configured - see below).
123+
124+
See [the rule list](https://ota-meshi.github.io/eslint-plugin-jsonc/rules/) to get the `rules` that this plugin provides.
125+
126+
#### Legacy Config (ESLint<v9)
127+
128+
Use `.eslintrc.*` file to configure rules. See also: <https://eslint.org/docs/latest/use/configure/>.
93129

94130
Example **.eslintrc.js**:
95131

‎docs/user-guide/index.md‎

Lines changed: 37 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,43 @@ npm install --save-dev eslint eslint-plugin-jsonc
1818

1919
### Configuration
2020

21-
Use `.eslintrc.*` file to configure rules. See also: [https://eslint.org/docs/user-guide/configuring](https://eslint.org/docs/user-guide/configuring).
21+
#### New (ESLint>=v9) Config (Flat Config)
22+
23+
Use `eslint.config.js` file to configure rules. See also: <https://eslint.org/docs/latest/use/configure/configuration-files-new>.
24+
25+
Example **eslint.config.js**:
26+
27+
```mjs
28+
import eslintPluginJsonc from 'eslint-plugin-jsonc';
29+
export default [
30+
// add more generic rule sets here, such as:
31+
// js.configs.recommended,
32+
...eslintPluginJsonc.configs['flat/recommended-with-jsonc'],
33+
{
34+
rules: {
35+
// override/add rules settings here, such as:
36+
// 'jsonc/rule-name': 'error'
37+
}
38+
}
39+
];
40+
```
41+
42+
This plugin provides configs:
43+
44+
- `*.configs['flat/base']` ... Configuration to enable correct JSON parsing.
45+
- `*.configs['flat/recommended-with-json']` ... Recommended configuration for JSON.
46+
- `*.configs['flat/recommended-with-jsonc']` ... Recommended configuration for JSONC.
47+
- `*.configs['flat/recommended-with-json5']` ... Recommended configuration for JSON5.
48+
- `*.configs['flat/prettier']` ... Turn off rules that may conflict with [Prettier](https://prettier.io/).
49+
- `*.configs['flat/all']` ... Enables all rules. It's meant for testing, not for production use because it changes with every minor and major version of the plugin. Use it at your own risk.
50+
51+
This plugin will parse `.json`, `.jsonc` and `.json5` by default using the configuration provided by the plugin (unless you already have a parser configured - see below).
52+
53+
See [the rule list](../rules/index.md) to get the `rules` that this plugin provides.
54+
55+
#### Legacy Config (ESLint<v9)
56+
57+
Use `.eslintrc.*` file to configure rules. See also: <https://eslint.org/docs/latest/use/configure/>.
2258

2359
Example **.eslintrc.js**:
2460

‎lib/configs/flat/all.ts‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
import { rules } from "../../utils/rules";
2+
import base from "./base";
3+
const all: Record<string, string> = {};
4+
for (const rule of rules) {
5+
if (rule.meta.docs.ruleId === "jsonc/sort-array-values") continue;
6+
all[rule.meta.docs.ruleId] = "error";
7+
}
8+
9+
export default [
10+
...base,
11+
{
12+
rules: {
13+
...all,
14+
},
15+
},
16+
];

‎lib/configs/flat/base.ts‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
import type { ESLint } from "eslint";
2+
import * as parser from "jsonc-eslint-parser";
3+
export default [
4+
{
5+
files: [
6+
"*.json",
7+
"**/*.json",
8+
"*.json5",
9+
"**/*.json5",
10+
"*.jsonc",
11+
"**/*.jsonc",
12+
],
13+
plugins: {
14+
get jsonc(): ESLint.Plugin {
15+
// eslint-disable-next-line @typescript-eslint/no-require-imports -- ignore
16+
return require("../../index");
17+
},
18+
},
19+
languageOptions: {
20+
parser,
21+
},
22+
rules: {
23+
// ESLint core rules known to cause problems with JSON.
24+
strict: "off",
25+
"no-unused-expressions": "off",
26+
"no-unused-vars": "off",
27+
},
28+
},
29+
];

‎lib/configs/flat/prettier.ts‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
// IMPORTANT!
2+
// This file has been automatically generated,
3+
// in order to update its content execute "npm run update"
4+
import base from "./base";
5+
export default [
6+
...base,
7+
{
8+
rules: {
9+
// eslint-plugin-jsonc rules
10+
"jsonc/array-bracket-newline": "off",
11+
"jsonc/array-bracket-spacing": "off",
12+
"jsonc/array-element-newline": "off",
13+
"jsonc/comma-dangle": "off",
14+
"jsonc/comma-style": "off",
15+
"jsonc/indent": "off",
16+
"jsonc/key-spacing": "off",
17+
"jsonc/no-floating-decimal": "off",
18+
"jsonc/object-curly-newline": "off",
19+
"jsonc/object-curly-spacing": "off",
20+
"jsonc/object-property-newline": "off",
21+
"jsonc/quote-props": "off",
22+
"jsonc/quotes": "off",
23+
"jsonc/space-unary-ops": "off",
24+
},
25+
},
26+
];

0 commit comments

Comments
 (0)