@eslint/json 0.4.1 → 0.6.0

package/README.md

@@ -155,6 +155,65 @@ export default [
 -   `no-duplicate-keys` - warns when there are two keys in an object with the same text.
 -   `no-empty-keys` - warns when there is a key in an object that is an empty string or contains only whitespace (note: `package-lock.json` uses empty keys intentionally)
 
+## Configuration Comments
+
+In JSONC and JSON5 files, you can also use [rule configurations comments](https://eslint.org/docs/latest/use/configure/rules#using-configuration-comments) and [disable directives](https://eslint.org/docs/latest/use/configure/rules#disabling-rules).
+
+```jsonc
+/* eslint json/no-empty-keys: "error" */
+
+{
+	"foo": {
+		"": 1, // eslint-disable-line json/no-empty-keys -- We want an empty key here
+	},
+	"bar": {
+		// eslint-disable-next-line json/no-empty-keys -- We want an empty key here too
+		"": 2,
+	},
+	/* eslint-disable json/no-empty-keys -- Empty keys are allowed in the following code as well */
+	"baz": [
+		{
+			"": 3,
+		},
+		{
+			"": 4,
+		},
+	],
+	/* eslint-enable json/no-empty-keys -- re-enable now */
+}
+```
+
+Both line and block comments can be used for all kinds of configuration comments.
+
+## Allowing trailing commas in JSONC
+
+The Microsoft implementation of JSONC optionally allows for trailing commas in objects and arrays (files like `tsconfig.json` have this option enabled by default in Visual Studio Code). To enable trailing commas in JSONC files, use the `allowTrailingCommas` language option, as in this example:
+
+```js
+import json from "@eslint/json";
+
+export default [
+	// lint JSONC files
+	{
+		files: ["**/*.jsonc"],
+		language: "json/jsonc",
+		...json.configs.recommended,
+	},
+
+	// lint JSONC files and allow trailing commas
+	{
+		files: ["**/tsconfig.json", ".vscode/*.json"],
+		language: "json/jsonc",
+		languageOptions: {
+			allowTrailingCommas: true,
+		},
+		...json.configs.recommended,
+	},
+];
+```
+
+**Note:** The `allowTrailingCommas` option is only valid for the `json/jsonc` language.
+
 ## Frequently Asked Questions
 
 ### How does this relate to `eslint-plugin-json` and `eslint-plugin-jsonc`?
@@ -178,11 +237,20 @@ Any other rules that catch potential problems in JSON are welcome to be implemen
 
 Apache 2.0
 
-## Sponsors
-
 <!-- NOTE: This section is autogenerated. Do not manually edit.-->
 <!--sponsorsstart-->
-<!--sponsorsend-->
 
-<!--techsponsorsstart-->
-<!--techsponsorsend-->
+## Sponsors
+
+The following companies, organizations, and individuals support ESLint's ongoing maintenance and development. [Become a Sponsor](https://eslint.org/donate)
+to get your logo on our READMEs and [website](https://eslint.org/sponsors).
+
+<h3>Platinum Sponsors</h3>
+<p><a href="https://automattic.com"><img src="https://images.opencollective.com/automattic/d0ef3e1/logo.png" alt="Automattic" height="128"></a> <a href="https://www.airbnb.com/"><img src="https://images.opencollective.com/airbnb/d327d66/logo.png" alt="Airbnb" height="128"></a></p><h3>Gold Sponsors</h3>
+<p><a href="https://trunk.io/"><img src="https://images.opencollective.com/trunkio/fb92d60/avatar.png" alt="trunk.io" height="96"></a></p><h3>Silver Sponsors</h3>
+<p><a href="https://www.serptriumph.com/"><img src="https://images.opencollective.com/serp-triumph5/fea3074/logo.png" alt="SERP Triumph" height="64"></a> <a href="https://www.jetbrains.com/"><img src="https://images.opencollective.com/jetbrains/fe76f99/logo.png" alt="JetBrains" height="64"></a> <a href="https://liftoff.io/"><img src="https://images.opencollective.com/liftoff/5c4fa84/logo.png" alt="Liftoff" height="64"></a> <a href="https://americanexpress.io"><img src="https://avatars.githubusercontent.com/u/3853301?v=4" alt="American Express" height="64"></a> <a href="https://www.workleap.com"><img src="https://avatars.githubusercontent.com/u/53535748?u=d1e55d7661d724bf2281c1bfd33cb8f99fe2465f&v=4" alt="Workleap" height="64"></a></p><h3>Bronze Sponsors</h3>
+<p><a href="https://cybozu.co.jp/"><img src="https://images.opencollective.com/cybozu/933e46d/logo.png" alt="Cybozu" height="32"></a> <a href="https://www.wordhint.net/"><img src="https://images.opencollective.com/wordhint/be86813/avatar.png" alt="WordHint" height="32"></a> <a href="https://www.crosswordsolver.org/anagram-solver/"><img src="https://images.opencollective.com/anagram-solver/2666271/logo.png" alt="Anagram Solver" height="32"></a> <a href="https://icons8.com/"><img src="https://images.opencollective.com/icons8/7fa1641/logo.png" alt="Icons8" height="32"></a> <a href="https://discord.com"><img src="https://images.opencollective.com/discordapp/f9645d9/logo.png" alt="Discord" height="32"></a> <a href="https://www.gitbook.com"><img src="https://avatars.githubusercontent.com/u/7111340?v=4" alt="GitBook" height="32"></a> <a href="https://nx.dev"><img src="https://avatars.githubusercontent.com/u/23692104?v=4" alt="Nx" height="32"></a> <a href="https://herocoders.com"><img src="https://avatars.githubusercontent.com/u/37549774?v=4" alt="HeroCoders" height="32"></a></p>
+<h3>Technology Sponsors</h3>
+Technology sponsors allow us to use their products and services for free as part of a contribution to the open source ecosystem and our work.
+<p><a href="https://netlify.com"><img src="https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/netlify-icon.svg" alt="Netlify" height="32"></a> <a href="https://algolia.com"><img src="https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/algolia-icon.svg" alt="Algolia" height="32"></a> <a href="https://1password.com"><img src="https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/1password-icon.svg" alt="1Password" height="32"></a></p>
+<!--sponsorsend-->

package/dist/cjs/index.cjs

@@ -24,11 +24,19 @@ var pluginKit = require('@eslint/plugin-kit');
 /** @typedef {import("@eslint/core").TraversalStep} TraversalStep */
 /** @typedef {import("@eslint/core").TextSourceCode} TextSourceCode */
 /** @typedef {import("@eslint/core").VisitTraversalStep} VisitTraversalStep */
+/** @typedef {import("@eslint/core").FileProblem} FileProblem */
+/** @typedef {import("@eslint/core").DirectiveType} DirectiveType */
+/** @typedef {import("@eslint/core").RulesConfig} RulesConfig */
 
 //-----------------------------------------------------------------------------
 // Helpers
 //-----------------------------------------------------------------------------
 
+const commentParser = new pluginKit.ConfigCommentParser();
+
+const INLINE_CONFIG =
+	/^\s*(?:eslint(?:-enable|-disable(?:(?:-next)?-line)?)?)(?:\s|$)/u;
+
 /**
  * A class to represent a step in the traversal process.
  */
@@ -73,6 +81,12 @@ class JSONSourceCode extends pluginKit.TextSourceCodeBase {
 	 */
 	#parents = new WeakMap();
 
+	/**
+	 * Collection of inline configuration comments.
+	 * @type {Array<JSONToken>}
+	 */
+	#inlineConfigComments;
+
 	/**
 	 * The AST of the source code.
 	 * @type {DocumentNode}
@@ -99,6 +113,136 @@ class JSONSourceCode extends pluginKit.TextSourceCodeBase {
 			: [];
 	}
 
+	/**
+	 * Returns the value of the given comment.
+	 * @param {JSONToken} comment The comment to get the value of.
+	 * @returns {string} The value of the comment.
+	 * @throws {Error} When an unexpected comment type is passed.
+	 */
+	#getCommentValue(comment) {
+		if (comment.type === "LineComment") {
+			return this.getText(comment).slice(2); // strip leading `//`
+		}
+
+		if (comment.type === "BlockComment") {
+			return this.getText(comment).slice(2, -2); // strip leading `/*` and trailing `*/`
+		}
+
+		throw new Error(`Unexpected comment type '${comment.type}'`);
+	}
+
+	/**
+	 * Returns an array of all inline configuration nodes found in the
+	 * source code.
+	 * @returns {Array<JSONToken>} An array of all inline configuration nodes.
+	 */
+	getInlineConfigNodes() {
+		if (!this.#inlineConfigComments) {
+			this.#inlineConfigComments = this.comments.filter(comment =>
+				INLINE_CONFIG.test(this.#getCommentValue(comment)),
+			);
+		}
+
+		return this.#inlineConfigComments;
+	}
+
+	/**
+	 * Returns directives that enable or disable rules along with any problems
+	 * encountered while parsing the directives.
+	 * @returns {{problems:Array<FileProblem>,directives:Array<Directive>}} Information
+	 *      that ESLint needs to further process the directives.
+	 */
+	getDisableDirectives() {
+		const problems = [];
+		const directives = [];
+
+		this.getInlineConfigNodes().forEach(comment => {
+			const { label, value, justification } =
+				commentParser.parseDirective(this.#getCommentValue(comment));
+
+			// `eslint-disable-line` directives are not allowed to span multiple lines as it would be confusing to which lines they apply
+			if (
+				label === "eslint-disable-line" &&
+				comment.loc.start.line !== comment.loc.end.line
+			) {
+				const message = `${label} comment should not span multiple lines.`;
+
+				problems.push({
+					ruleId: null,
+					message,
+					loc: comment.loc,
+				});
+				return;
+			}
+
+			switch (label) {
+				case "eslint-disable":
+				case "eslint-enable":
+				case "eslint-disable-next-line":
+				case "eslint-disable-line": {
+					const directiveType = label.slice("eslint-".length);
+
+					directives.push(
+						new pluginKit.Directive({
+							type: /** @type {DirectiveType} */ (directiveType),
+							node: comment,
+							value,
+							justification,
+						}),
+					);
+				}
+
+				// no default
+			}
+		});
+
+		return { problems, directives };
+	}
+
+	/**
+	 * Returns inline rule configurations along with any problems
+	 * encountered while parsing the configurations.
+	 * @returns {{problems:Array<FileProblem>,configs:Array<{config:{rules:RulesConfig},loc:SourceLocation}>}} Information
+	 *      that ESLint needs to further process the rule configurations.
+	 */
+	applyInlineConfig() {
+		const problems = [];
+		const configs = [];
+
+		this.getInlineConfigNodes().forEach(comment => {
+			const { label, value } = commentParser.parseDirective(
+				this.#getCommentValue(comment),
+			);
+
+			if (label === "eslint") {
+				const parseResult = commentParser.parseJSONLikeConfig(value);
+
+				if (parseResult.ok) {
+					configs.push({
+						config: {
+							rules: parseResult.config,
+						},
+						loc: comment.loc,
+					});
+				} else {
+					problems.push({
+						ruleId: null,
+						message:
+							/** @type {{ok: false, error: { message: string }}} */ (
+								parseResult
+							).error.message,
+						loc: comment.loc,
+					});
+				}
+			}
+		});
+
+		return {
+			configs,
+			problems,
+		};
+	}
+
 	/**
 	 * Returns the parent of the given node.
 	 * @param {JSONNode} node The node to get the parent of.
@@ -152,6 +296,10 @@ class JSONSourceCode extends pluginKit.TextSourceCodeBase {
 /** @typedef {import("@eslint/core").Language} Language */
 /** @typedef {import("@eslint/core").OkParseResult<DocumentNode>} OkParseResult */
 /** @typedef {import("@eslint/core").ParseResult<DocumentNode>} ParseResult */
+/**
+ * @typedef {Object} JSONLanguageOptions
+ * @property {boolean} [allowTrailingCommas] Whether to allow trailing commas.
+ */
 
 //-----------------------------------------------------------------------------
 // Exports
@@ -207,26 +355,42 @@ class JSONLanguage {
 		this.#mode = mode;
 	}
 
-	/* eslint-disable class-methods-use-this, no-unused-vars -- Required to complete interface. */
 	/**
 	 * Validates the language options.
-	 * @param {Object} languageOptions The language options to validate.
+	 * @param {JSONLanguageOptions} languageOptions The language options to validate.
 	 * @returns {void}
 	 * @throws {Error} When the language options are invalid.
 	 */
 	validateLanguageOptions(languageOptions) {
-		// no-op
+		if (languageOptions.allowTrailingCommas !== undefined) {
+			if (typeof languageOptions.allowTrailingCommas !== "boolean") {
+				throw new Error(
+					"allowTrailingCommas must be a boolean if provided.",
+				);
+			}
+
+			// we know that allowTrailingCommas is a boolean here
+
+			// only allowed in JSONC mode
+			if (this.#mode !== "jsonc") {
+				throw new Error(
+					"allowTrailingCommas option is only available in JSONC.",
+				);
+			}
+		}
 	}
-	/* eslint-enable class-methods-use-this, no-unused-vars -- Required to complete interface. */
 
 	/**
 	 * Parses the given file into an AST.
 	 * @param {File} file The virtual file to parse.
+	 * @param {{languageOptions: JSONLanguageOptions}} context The options to use for parsing.
 	 * @returns {ParseResult} The result of parsing.
 	 */
-	parse(file) {
+	parse(file, context) {
 		// Note: BOM already removed
 		const text = /** @type {string} */ (file.body);
+		const allowTrailingCommas =
+			context?.languageOptions?.allowTrailingCommas;
 
 		/*
 		 * Check for parsing errors first. If there's a parsing error, nothing
@@ -239,6 +403,7 @@ class JSONLanguage {
 				mode: this.#mode,
 				ranges: true,
 				tokens: true,
+				allowTrailingCommas,
 			});
 
 			return {
@@ -386,7 +551,7 @@ var noEmptyKeys = {
 const plugin = {
 	meta: {
 		name: "@eslint/json",
-		version: "0.4.1", // x-release-please-version
+		version: "0.6.0", // x-release-please-version
 	},
 	languages: {
 		json: new JSONLanguage({ mode: "json" }),

package/dist/cjs/index.d.cts

@@ -7,9 +7,18 @@ export type File = import("@eslint/core").File;
 export type TraversalStep = import("@eslint/core").TraversalStep;
 export type TextSourceCode = import("@eslint/core").TextSourceCode;
 export type VisitTraversalStep = import("@eslint/core").VisitTraversalStep;
+export type FileProblem = import("@eslint/core").FileProblem;
+export type DirectiveType = import("@eslint/core").DirectiveType;
+export type RulesConfig = import("@eslint/core").RulesConfig;
 export type Language = import("@eslint/core").Language;
 export type OkParseResult = import("@eslint/core").OkParseResult<DocumentNode>;
 export type ParseResult = import("@eslint/core").ParseResult<DocumentNode>;
+export type JSONLanguageOptions = {
+    /**
+     * Whether to allow trailing commas.
+     */
+    allowTrailingCommas?: boolean;
+};
 /**
  * @filedescription Functions to fix up rules to provide missing methods on the `context` object.
  * @author Nicholas C. Zakas
@@ -17,6 +26,10 @@ export type ParseResult = import("@eslint/core").ParseResult<DocumentNode>;
 /** @typedef {import("@eslint/core").Language} Language */
 /** @typedef {import("@eslint/core").OkParseResult<DocumentNode>} OkParseResult */
 /** @typedef {import("@eslint/core").ParseResult<DocumentNode>} ParseResult */
+/**
+ * @typedef {Object} JSONLanguageOptions
+ * @property {boolean} [allowTrailingCommas] Whether to allow trailing commas.
+ */
 /**
  * JSON Language Object
  * @implements {Language}
@@ -57,17 +70,20 @@ export class JSONLanguage implements Language {
     visitorKeys: Record<string, string[]>;
     /**
      * Validates the language options.
-     * @param {Object} languageOptions The language options to validate.
+     * @param {JSONLanguageOptions} languageOptions The language options to validate.
      * @returns {void}
      * @throws {Error} When the language options are invalid.
      */
-    validateLanguageOptions(languageOptions: any): void;
+    validateLanguageOptions(languageOptions: JSONLanguageOptions): void;
     /**
      * Parses the given file into an AST.
      * @param {File} file The virtual file to parse.
+     * @param {{languageOptions: JSONLanguageOptions}} context The options to use for parsing.
      * @returns {ParseResult} The result of parsing.
      */
-    parse(file: File): ParseResult;
+    parse(file: File, context: {
+        languageOptions: JSONLanguageOptions;
+    }): ParseResult;
     /**
      * Creates a new `JSONSourceCode` object from the given information.
      * @param {File} file The virtual file to create a `JSONSourceCode` object from.
@@ -101,6 +117,37 @@ export class JSONSourceCode extends TextSourceCodeBase {
      * @type {Array<JSONToken>|undefined}
      */
     comments: Array<JSONToken> | undefined;
+    /**
+     * Returns an array of all inline configuration nodes found in the
+     * source code.
+     * @returns {Array<JSONToken>} An array of all inline configuration nodes.
+     */
+    getInlineConfigNodes(): Array<JSONToken>;
+    /**
+     * Returns directives that enable or disable rules along with any problems
+     * encountered while parsing the directives.
+     * @returns {{problems:Array<FileProblem>,directives:Array<Directive>}} Information
+     *      that ESLint needs to further process the directives.
+     */
+    getDisableDirectives(): {
+        problems: Array<FileProblem>;
+        directives: Array<Directive>;
+    };
+    /**
+     * Returns inline rule configurations along with any problems
+     * encountered while parsing the configurations.
+     * @returns {{problems:Array<FileProblem>,configs:Array<{config:{rules:RulesConfig},loc:SourceLocation}>}} Information
+     *      that ESLint needs to further process the rule configurations.
+     */
+    applyInlineConfig(): {
+        problems: Array<FileProblem>;
+        configs: Array<{
+            config: {
+                rules: RulesConfig;
+            };
+            loc: SourceLocation;
+        }>;
+    };
     /**
      * Returns the parent of the given node.
      * @param {JSONNode} node The node to get the parent of.
@@ -159,19 +206,7 @@ declare namespace plugin {
     let configs: {};
 }
 import { TextSourceCodeBase } from '@eslint/plugin-kit';
-/**
- * @fileoverview The JSONSourceCode class.
- * @author Nicholas C. Zakas
- */
-/** @typedef {import("@humanwhocodes/momoa").DocumentNode} DocumentNode */
-/** @typedef {import("@humanwhocodes/momoa").Node} JSONNode */
-/** @typedef {import("@humanwhocodes/momoa").Token} JSONToken */
-/** @typedef {import("@eslint/core").SourceRange} SourceRange */
-/** @typedef {import("@eslint/core").SourceLocation} SourceLocation */
-/** @typedef {import("@eslint/core").File} File */
-/** @typedef {import("@eslint/core").TraversalStep} TraversalStep */
-/** @typedef {import("@eslint/core").TextSourceCode} TextSourceCode */
-/** @typedef {import("@eslint/core").VisitTraversalStep} VisitTraversalStep */
+import { Directive } from '@eslint/plugin-kit';
 /**
  * A class to represent a step in the traversal process.
  */

package/dist/esm/index.d.ts

@@ -7,9 +7,18 @@ export type File = import("@eslint/core").File;
 export type TraversalStep = import("@eslint/core").TraversalStep;
 export type TextSourceCode = import("@eslint/core").TextSourceCode;
 export type VisitTraversalStep = import("@eslint/core").VisitTraversalStep;
+export type FileProblem = import("@eslint/core").FileProblem;
+export type DirectiveType = import("@eslint/core").DirectiveType;
+export type RulesConfig = import("@eslint/core").RulesConfig;
 export type Language = import("@eslint/core").Language;
 export type OkParseResult = import("@eslint/core").OkParseResult<DocumentNode>;
 export type ParseResult = import("@eslint/core").ParseResult<DocumentNode>;
+export type JSONLanguageOptions = {
+    /**
+     * Whether to allow trailing commas.
+     */
+    allowTrailingCommas?: boolean;
+};
 /**
  * @filedescription Functions to fix up rules to provide missing methods on the `context` object.
  * @author Nicholas C. Zakas
@@ -17,6 +26,10 @@ export type ParseResult = import("@eslint/core").ParseResult<DocumentNode>;
 /** @typedef {import("@eslint/core").Language} Language */
 /** @typedef {import("@eslint/core").OkParseResult<DocumentNode>} OkParseResult */
 /** @typedef {import("@eslint/core").ParseResult<DocumentNode>} ParseResult */
+/**
+ * @typedef {Object} JSONLanguageOptions
+ * @property {boolean} [allowTrailingCommas] Whether to allow trailing commas.
+ */
 /**
  * JSON Language Object
  * @implements {Language}
@@ -57,17 +70,20 @@ export class JSONLanguage implements Language {
     visitorKeys: Record<string, string[]>;
     /**
      * Validates the language options.
-     * @param {Object} languageOptions The language options to validate.
+     * @param {JSONLanguageOptions} languageOptions The language options to validate.
      * @returns {void}
      * @throws {Error} When the language options are invalid.
      */
-    validateLanguageOptions(languageOptions: any): void;
+    validateLanguageOptions(languageOptions: JSONLanguageOptions): void;
     /**
      * Parses the given file into an AST.
      * @param {File} file The virtual file to parse.
+     * @param {{languageOptions: JSONLanguageOptions}} context The options to use for parsing.
      * @returns {ParseResult} The result of parsing.
      */
-    parse(file: File): ParseResult;
+    parse(file: File, context: {
+        languageOptions: JSONLanguageOptions;
+    }): ParseResult;
     /**
      * Creates a new `JSONSourceCode` object from the given information.
      * @param {File} file The virtual file to create a `JSONSourceCode` object from.
@@ -101,6 +117,37 @@ export class JSONSourceCode extends TextSourceCodeBase {
      * @type {Array<JSONToken>|undefined}
      */
     comments: Array<JSONToken> | undefined;
+    /**
+     * Returns an array of all inline configuration nodes found in the
+     * source code.
+     * @returns {Array<JSONToken>} An array of all inline configuration nodes.
+     */
+    getInlineConfigNodes(): Array<JSONToken>;
+    /**
+     * Returns directives that enable or disable rules along with any problems
+     * encountered while parsing the directives.
+     * @returns {{problems:Array<FileProblem>,directives:Array<Directive>}} Information
+     *      that ESLint needs to further process the directives.
+     */
+    getDisableDirectives(): {
+        problems: Array<FileProblem>;
+        directives: Array<Directive>;
+    };
+    /**
+     * Returns inline rule configurations along with any problems
+     * encountered while parsing the configurations.
+     * @returns {{problems:Array<FileProblem>,configs:Array<{config:{rules:RulesConfig},loc:SourceLocation}>}} Information
+     *      that ESLint needs to further process the rule configurations.
+     */
+    applyInlineConfig(): {
+        problems: Array<FileProblem>;
+        configs: Array<{
+            config: {
+                rules: RulesConfig;
+            };
+            loc: SourceLocation;
+        }>;
+    };
     /**
      * Returns the parent of the given node.
      * @param {JSONNode} node The node to get the parent of.
@@ -159,19 +206,7 @@ declare namespace plugin {
     let configs: {};
 }
 import { TextSourceCodeBase } from '@eslint/plugin-kit';
-/**
- * @fileoverview The JSONSourceCode class.
- * @author Nicholas C. Zakas
- */
-/** @typedef {import("@humanwhocodes/momoa").DocumentNode} DocumentNode */
-/** @typedef {import("@humanwhocodes/momoa").Node} JSONNode */
-/** @typedef {import("@humanwhocodes/momoa").Token} JSONToken */
-/** @typedef {import("@eslint/core").SourceRange} SourceRange */
-/** @typedef {import("@eslint/core").SourceLocation} SourceLocation */
-/** @typedef {import("@eslint/core").File} File */
-/** @typedef {import("@eslint/core").TraversalStep} TraversalStep */
-/** @typedef {import("@eslint/core").TextSourceCode} TextSourceCode */
-/** @typedef {import("@eslint/core").VisitTraversalStep} VisitTraversalStep */
+import { Directive } from '@eslint/plugin-kit';
 /**
  * A class to represent a step in the traversal process.
  */

package/dist/esm/index.js

@@ -1,6 +1,6 @@
 // @ts-self-types="./index.d.ts"
 import { iterator, visitorKeys, parse } from '@humanwhocodes/momoa';
-import { TextSourceCodeBase, VisitNodeStep } from '@eslint/plugin-kit';
+import { ConfigCommentParser, TextSourceCodeBase, Directive, VisitNodeStep } from '@eslint/plugin-kit';
 
 /**
  * @fileoverview The JSONSourceCode class.
@@ -21,11 +21,19 @@ import { TextSourceCodeBase, VisitNodeStep } from '@eslint/plugin-kit';
 /** @typedef {import("@eslint/core").TraversalStep} TraversalStep */
 /** @typedef {import("@eslint/core").TextSourceCode} TextSourceCode */
 /** @typedef {import("@eslint/core").VisitTraversalStep} VisitTraversalStep */
+/** @typedef {import("@eslint/core").FileProblem} FileProblem */
+/** @typedef {import("@eslint/core").DirectiveType} DirectiveType */
+/** @typedef {import("@eslint/core").RulesConfig} RulesConfig */
 
 //-----------------------------------------------------------------------------
 // Helpers
 //-----------------------------------------------------------------------------
 
+const commentParser = new ConfigCommentParser();
+
+const INLINE_CONFIG =
+	/^\s*(?:eslint(?:-enable|-disable(?:(?:-next)?-line)?)?)(?:\s|$)/u;
+
 /**
  * A class to represent a step in the traversal process.
  */
@@ -70,6 +78,12 @@ class JSONSourceCode extends TextSourceCodeBase {
 	 */
 	#parents = new WeakMap();
 
+	/**
+	 * Collection of inline configuration comments.
+	 * @type {Array<JSONToken>}
+	 */
+	#inlineConfigComments;
+
 	/**
 	 * The AST of the source code.
 	 * @type {DocumentNode}
@@ -96,6 +110,136 @@ class JSONSourceCode extends TextSourceCodeBase {
 			: [];
 	}
 
+	/**
+	 * Returns the value of the given comment.
+	 * @param {JSONToken} comment The comment to get the value of.
+	 * @returns {string} The value of the comment.
+	 * @throws {Error} When an unexpected comment type is passed.
+	 */
+	#getCommentValue(comment) {
+		if (comment.type === "LineComment") {
+			return this.getText(comment).slice(2); // strip leading `//`
+		}
+
+		if (comment.type === "BlockComment") {
+			return this.getText(comment).slice(2, -2); // strip leading `/*` and trailing `*/`
+		}
+
+		throw new Error(`Unexpected comment type '${comment.type}'`);
+	}
+
+	/**
+	 * Returns an array of all inline configuration nodes found in the
+	 * source code.
+	 * @returns {Array<JSONToken>} An array of all inline configuration nodes.
+	 */
+	getInlineConfigNodes() {
+		if (!this.#inlineConfigComments) {
+			this.#inlineConfigComments = this.comments.filter(comment =>
+				INLINE_CONFIG.test(this.#getCommentValue(comment)),
+			);
+		}
+
+		return this.#inlineConfigComments;
+	}
+
+	/**
+	 * Returns directives that enable or disable rules along with any problems
+	 * encountered while parsing the directives.
+	 * @returns {{problems:Array<FileProblem>,directives:Array<Directive>}} Information
+	 *      that ESLint needs to further process the directives.
+	 */
+	getDisableDirectives() {
+		const problems = [];
+		const directives = [];
+
+		this.getInlineConfigNodes().forEach(comment => {
+			const { label, value, justification } =
+				commentParser.parseDirective(this.#getCommentValue(comment));
+
+			// `eslint-disable-line` directives are not allowed to span multiple lines as it would be confusing to which lines they apply
+			if (
+				label === "eslint-disable-line" &&
+				comment.loc.start.line !== comment.loc.end.line
+			) {
+				const message = `${label} comment should not span multiple lines.`;
+
+				problems.push({
+					ruleId: null,
+					message,
+					loc: comment.loc,
+				});
+				return;
+			}
+
+			switch (label) {
+				case "eslint-disable":
+				case "eslint-enable":
+				case "eslint-disable-next-line":
+				case "eslint-disable-line": {
+					const directiveType = label.slice("eslint-".length);
+
+					directives.push(
+						new Directive({
+							type: /** @type {DirectiveType} */ (directiveType),
+							node: comment,
+							value,
+							justification,
+						}),
+					);
+				}
+
+				// no default
+			}
+		});
+
+		return { problems, directives };
+	}
+
+	/**
+	 * Returns inline rule configurations along with any problems
+	 * encountered while parsing the configurations.
+	 * @returns {{problems:Array<FileProblem>,configs:Array<{config:{rules:RulesConfig},loc:SourceLocation}>}} Information
+	 *      that ESLint needs to further process the rule configurations.
+	 */
+	applyInlineConfig() {
+		const problems = [];
+		const configs = [];
+
+		this.getInlineConfigNodes().forEach(comment => {
+			const { label, value } = commentParser.parseDirective(
+				this.#getCommentValue(comment),
+			);
+
+			if (label === "eslint") {
+				const parseResult = commentParser.parseJSONLikeConfig(value);
+
+				if (parseResult.ok) {
+					configs.push({
+						config: {
+							rules: parseResult.config,
+						},
+						loc: comment.loc,
+					});
+				} else {
+					problems.push({
+						ruleId: null,
+						message:
+							/** @type {{ok: false, error: { message: string }}} */ (
+								parseResult
+							).error.message,
+						loc: comment.loc,
+					});
+				}
+			}
+		});
+
+		return {
+			configs,
+			problems,
+		};
+	}
+
 	/**
 	 * Returns the parent of the given node.
 	 * @param {JSONNode} node The node to get the parent of.
@@ -149,6 +293,10 @@ class JSONSourceCode extends TextSourceCodeBase {
 /** @typedef {import("@eslint/core").Language} Language */
 /** @typedef {import("@eslint/core").OkParseResult<DocumentNode>} OkParseResult */
 /** @typedef {import("@eslint/core").ParseResult<DocumentNode>} ParseResult */
+/**
+ * @typedef {Object} JSONLanguageOptions
+ * @property {boolean} [allowTrailingCommas] Whether to allow trailing commas.
+ */
 
 //-----------------------------------------------------------------------------
 // Exports
@@ -204,26 +352,42 @@ class JSONLanguage {
 		this.#mode = mode;
 	}
 
-	/* eslint-disable class-methods-use-this, no-unused-vars -- Required to complete interface. */
 	/**
 	 * Validates the language options.
-	 * @param {Object} languageOptions The language options to validate.
+	 * @param {JSONLanguageOptions} languageOptions The language options to validate.
 	 * @returns {void}
 	 * @throws {Error} When the language options are invalid.
 	 */
 	validateLanguageOptions(languageOptions) {
-		// no-op
+		if (languageOptions.allowTrailingCommas !== undefined) {
+			if (typeof languageOptions.allowTrailingCommas !== "boolean") {
+				throw new Error(
+					"allowTrailingCommas must be a boolean if provided.",
+				);
+			}
+
+			// we know that allowTrailingCommas is a boolean here
+
+			// only allowed in JSONC mode
+			if (this.#mode !== "jsonc") {
+				throw new Error(
+					"allowTrailingCommas option is only available in JSONC.",
+				);
+			}
+		}
 	}
-	/* eslint-enable class-methods-use-this, no-unused-vars -- Required to complete interface. */
 
 	/**
 	 * Parses the given file into an AST.
 	 * @param {File} file The virtual file to parse.
+	 * @param {{languageOptions: JSONLanguageOptions}} context The options to use for parsing.
 	 * @returns {ParseResult} The result of parsing.
 	 */
-	parse(file) {
+	parse(file, context) {
 		// Note: BOM already removed
 		const text = /** @type {string} */ (file.body);
+		const allowTrailingCommas =
+			context?.languageOptions?.allowTrailingCommas;
 
 		/*
 		 * Check for parsing errors first. If there's a parsing error, nothing
@@ -236,6 +400,7 @@ class JSONLanguage {
 				mode: this.#mode,
 				ranges: true,
 				tokens: true,
+				allowTrailingCommas,
 			});
 
 			return {
@@ -383,7 +548,7 @@ var noEmptyKeys = {
 const plugin = {
 	meta: {
 		name: "@eslint/json",
-		version: "0.4.1", // x-release-please-version
+		version: "0.6.0", // x-release-please-version
 	},
 	languages: {
 		json: new JSONLanguage({ mode: "json" }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eslint/json",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "JSON linting plugin for ESLint",
   "author": "Nicholas C. Zakas",
   "type": "module",
@@ -44,6 +44,7 @@
     "build:dedupe-types": "node tools/dedupe-types.js dist/cjs/index.cjs dist/esm/index.js",
     "build:cts": "node -e \"fs.copyFileSync('dist/esm/index.d.ts', 'dist/cjs/index.d.cts')\"",
     "build": "rollup -c && npm run build:dedupe-types && tsc -p tsconfig.esm.json && npm run build:cts",
+    "build:readme": "node tools/update-readme.js",
     "test:jsr": "npx jsr@latest publish --dry-run",
     "pretest": "npm run build",
     "lint": "eslint",
@@ -61,15 +62,17 @@
   ],
   "license": "Apache-2.0",
   "dependencies": {
-    "@eslint/plugin-kit": "^0.1.0",
-    "@humanwhocodes/momoa": "^3.2.0"
+    "@eslint/plugin-kit": "^0.2.0",
+    "@humanwhocodes/momoa": "^3.3.0"
   },
   "devDependencies": {
-    "@eslint/core": "^0.3.0",
+    "@eslint/core": "^0.6.0",
     "@types/eslint": "^8.56.10",
     "c8": "^9.1.0",
-    "eslint": "^9.6.0",
+    "dedent": "^1.5.3",
+    "eslint": "^9.11.1",
     "eslint-config-eslint": "^11.0.0",
+    "got": "^14.4.2",
     "lint-staged": "^15.2.7",
     "mocha": "^10.4.0",
     "prettier": "^3.3.2",