fix: correct the return type of applyInlineConfig (eslint#281)

* fix: correct the return type of `applyInlineConfig`

* wip: add type test

Author: lumirlumir

src/languages/css-source-code.js

@@ -20,8 +20,8 @@ import { visitorKeys } from "./css-visitor-keys.js";
 //-----------------------------------------------------------------------------
 
 /**
- * @import { CssNode, CssNodePlain, Comment, Lexer, StyleSheetPlain } from "@eslint/css-tree"
- * @import { SourceRange, SourceLocation, FileProblem, DirectiveType, RulesConfig } from "@eslint/core"
+ * @import { CssNode, CssNodePlain, CssLocationRange, Comment, Lexer, StyleSheetPlain } from "@eslint/css-tree"
+ * @import { SourceRange, FileProblem, DirectiveType, RulesConfig } from "@eslint/core"
  * @import { CSSSyntaxElement } from "../types.js"
  * @import { CSSLanguageOptions } from "./css-language.js"
  */
@@ -202,13 +202,13 @@ export class CSSSourceCode extends TextSourceCodeBase {
 	/**
 	 * 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
+	 * @returns {{problems:Array<FileProblem>,configs:Array<{config:{rules:RulesConfig},loc:CssLocationRange}>}} Information
 	 *      that ESLint needs to further process the rule configurations.
 	 */
 	applyInlineConfig() {
 		/** @type {Array<FileProblem>} */
 		const problems = [];
-		/** @type {Array<{config:{rules:RulesConfig},loc:SourceLocation}>} */
+		/** @type {Array<{config:{rules:RulesConfig},loc:CssLocationRange}>} */
 		const configs = [];
 
 		this.getInlineConfigNodes().forEach(comment => {

tests/types/types.test.ts

@@ -51,6 +51,7 @@ import type {
 	ValuePlain,
 	WhiteSpace,
 	CssNodePlain,
+	CssLocationRange,
 } from "@eslint/css-tree";
 import type { CSSRuleDefinition, CSSRuleVisitor } from "@eslint/css/types";
 
@@ -73,6 +74,19 @@ css.configs.recommended.plugins satisfies object;
 	null as AssertAllNamesIn<RecommendedRuleName, RuleName>;
 }
 
+{
+	type ApplyInlineConfigLoc = ReturnType<
+		CSSSourceCode["applyInlineConfig"]
+	>["configs"][0]["loc"];
+
+	// Check that `applyInlineConfig`'s return type includes correct `loc` structure.
+	const loc: ApplyInlineConfigLoc = {
+		source: "source",
+		start: { line: 1, column: 1, offset: 0 },
+		end: { line: 1, column: 1, offset: 0 },
+	};
+}
+
 (): CSSRuleDefinition => ({
 	create({ sourceCode }): CSSRuleVisitor {
 		sourceCode satisfies CSSSourceCode;
@@ -91,6 +105,12 @@ css.configs.recommended.plugins satisfies object;
 			sourceCode.getParent(node) satisfies CssNodePlain | undefined;
 			sourceCode.getAncestors(node) satisfies CssNodePlain[];
 			sourceCode.getText(node) satisfies string;
+			sourceCode.applyInlineConfig().configs[0].loc
+				.source satisfies CssLocationRange["source"];
+			sourceCode.applyInlineConfig().configs[0].loc.start
+				.offset satisfies CssLocationRange["start"]["offset"];
+			sourceCode.applyInlineConfig().configs[0].loc.end
+				.offset satisfies CssLocationRange["end"]["offset"];
 		}
 
 		return {