@eslinted/core 19.0.3-rc.1 → 19.0.3-rc.3

package/src/factory/index.ts

@@ -163,19 +163,25 @@ export class Factory<
       languageOptions: {
         parser = null,
         globals: global = null,
-        ...languageOptionsStatic
+        ...extraLanguageOptions
       },
       parserOptions: {
         parser: subparser = null,
-        ...parserOptionsStatic
+        ...extraParserOptions
       },
       processor = null,
       language = null,
     } = this.registry[scope];
 
+    function isGlobal(
+      global: string,
+    ): global is keyof typeof globals {
+      return global in globals;
+    }
+
     if (
       global !== null
-      && !(global in globals)
+      && !isGlobal(global)
     )
       throw new ReferenceError(
         "Global does not exist",
@@ -191,36 +197,41 @@ export class Factory<
               name: `linted/${scope as string}/` as const,
               files,
               ignores,
-              languageOptions: {
-                ...languageOptionsStatic,
-                ...global === null
-                  ? {}
-                  : {
-                      globals: globals[global as keyof typeof globals] as Record<string, boolean>,
-                    },
-                ...parser === null
-                  ? {}
-                  : {
-                      parser: this
-                        .parsers[parser],
-                    },
-                ...Object
-                  .keys(parserOptionsStatic)
-                  .length < 1
-                  && subparser === null
-                  ? {}
-                  : {
-                      parserOptions: {
-                        ...parserOptionsStatic,
-                        ...subparser === null
-                          ? {}
-                          : {
-                              parser: this
-                                .parsers[subparser],
+              ...parser === null
+              && global === null
+              && subparser === null
+              && [...Object.keys(extraLanguageOptions)].length === 0
+              && [...Object.keys(extraParserOptions)].length === 0
+                ? {}
+                : {
+                    languageOptions: {
+                      ...extraLanguageOptions,
+                      ...global === null
+                        ? {}
+                        : {
+                            globals: globals[global],
+                          },
+                      ...parser === null
+                        ? {}
+                        : {
+                            parser: this.parsers[parser],
+                          },
+                      ...subparser === null
+                      && [...Object.keys(extraParserOptions)].length === 0
+                        ? {}
+                        : {
+                            parserOptions: {
+                              ...extraParserOptions,
+                              ...subparser === null
+                                ? {}
+                                : {
+                                    parser: this
+                                      .parsers[subparser],
+                                  },
                             },
-                      },
+                          },
                     },
-              },
+                  },
               ...processor === null
                 ? {}
                 : { processor },

package/src/interface/output/configs/scoped/settings.d.ts

@@ -2,7 +2,7 @@ import type { Config } from "../../../config";
 
 export type Settings = {
   name: `linted/${string}`;
-  languageOptions: object;
+  languageOptions?: object;
 } & Pick<
   Config,
   | "files"

package/src/scope/registry/manifests/css.ts

@@ -1,9 +1,9 @@
 export const css = {
   languageOptions: {
-    tolerant: false,
-  },
-  parserOptions: {
-    // DOC: https://github.com/ota-meshi/yaml-eslint-parser?tab=readme-ov-file#advanced-configuration
+    // DOC: https://github.com/eslint/css?tab=readme-ov-file#languages
+    tolerant: false /* @default: true | DOC: https://github.com/eslint/css?tab=readme-ov-file#tolerant-mode */,
+    // customSyntax: {} /* DOC: Tailwind: https://github.com/eslint/css?tab=readme-ov-file#configuring-tailwind-syntax | DOC: https://github.com/eslint/css?tab=readme-ov-file#configuring-custom-syntax */,
   },
+  parserOptions: {},
   language: "css/css",
 };

package/src/scope/registry/manifests/html.ts

@@ -3,7 +3,8 @@ export const html = {
     parser: "html" as const,
   },
   parserOptions: {
-    frontmatter: true /* DOC: https://github.com/yeonjuan/html-eslint/issues/291#issuecomment-2726307803 */,
+    // templateEngineSyntax: {} /* DOC: https://html-eslint.org/docs/integrating-template-engine */,
+    frontmatter: true /* @default: false | DOC: https://html-eslint.org/docs/integrating-template-engine#skip-frontmatter */,
   },
   language: "@html-eslint/html",
 };

package/src/scope/registry/manifests/js.ts

@@ -1,4 +1,8 @@
 export const js = {
-  languageOptions: {},
-  parserOptions: {},
+  languageOptions: {
+    // DOC: https://eslint.org/docs/latest/use/configure/language-options
+  },
+  parserOptions: {
+    // DOC: https://eslint.org/docs/latest/use/configure/language-options#specifying-parser-options
+  },
 };

package/src/scope/registry/manifests/json.ts

@@ -1,7 +1,7 @@
 export const json = {
   languageOptions: {
-    allowTrailingCommas: true,
+    allowTrailingCommas: true /* DOC: https://github.com/eslint/json?tab=readme-ov-file#allowing-trailing-commas-in-jsonc */,
   },
   parserOptions: {},
-  language: "json/jsonc",
+  language: "json/jsonc" /* INFO: `languageOptions.allowTrailingCommas` is only available on language `json/jsonc` */,
 };

package/src/scope/registry/manifests/jsonc.ts

@@ -1,5 +1,9 @@
 export const jsonc = {
-  languageOptions: {},
-  parserOptions: {},
+  languageOptions: {
+    // Inherits `json`
+  },
+  parserOptions: {
+    // Inherits `json`
+  },
   language: "json/jsonc",
 };

package/src/scope/registry/manifests/jsoncc.ts

@@ -1,5 +1,9 @@
 export const jsoncc = {
-  languageOptions: {},
-  parserOptions: {},
+  languageOptions: {
+    // Inherits `jsonc`
+  },
+  parserOptions: {
+    // Inherits `jsonc`
+  },
   language: "json/jsonc",
 };

package/src/scope/registry/manifests/mocha.ts

@@ -3,16 +3,6 @@ export const mocha = {
     globals: "mocha" as const,
   },
   parserOptions: {
-    // MUST BE IDENTICAL TO TS PARSER OPTIONS (eventually see if can inherit)
-    ecmaFeatures: {
-      jsx: false,
-      globalReturn: true,
-    },
-    jsDocParsingMode: "none" /* @default(project): "all" | @default: "none" | "type-info" */,
-    projectService: true /* DOC: https://typescript-eslint.io/packages/parser/#projectservice , DOC: https://typescript-eslint.io/troubleshooting/typed-linting/#project-service-issues */,
-    // tsconfigRootDir: import.meta.dirname /* DOC: https://typescript-eslint.io/packages/parser/#tsconfigrootdir ; see `DOC:(USE-CASE), I am inferring that an aboslute path is needed ; DOC:(Node.js: import.meta): https://nodejs.org/api/esm.html#importmetadirname */,
-    warnOnUnsupportedTypeScriptVersion: false,
-    sourceType: "module",
-    ecmaVersion: 2023,
+    // Inherits `ts`
   },
 };

package/src/scope/registry/manifests/svelte.ts

@@ -5,16 +5,6 @@ export const svelte = {
   parserOptions: {
     parser: "ts" as const,
     extraFileExtensions: [".svelte"],
-    ecmaFeatures: {
-      jsx: false,
-      globalReturn: true,
-    },
-    jsDocParsingMode: "none" /* @default(project): "all" | @default: "none" | "type-info" */,
-    projectService: true /* DOC: https://typescript-eslint.io/packages/parser/#projectservice , DOC: https://typescript-eslint.io/troubleshooting/typed-linting/#project-service-issues */,
-    // tsconfigRootDir: import.meta.dirname /* DOC: https://typescript-eslint.io/packages/parser/#tsconfigrootdir ; see `DOC:(USE-CASE), I am inferring that an aboslute path is needed ; DOC:(Node.js: import.meta): https://nodejs.org/api/esm.html#importmetadirname */,
-    warnOnUnsupportedTypeScriptVersion: false,
-    sourceType: "module",
-    ecmaVersion: 2023,
   },
   processor: "svelte/svelte",
 };

package/src/scope/registry/manifests/ts.ts

@@ -4,16 +4,27 @@ export const ts = {
   },
   parserOptions: {
     // DOC: https://typescript-eslint.io/packages/parser/#configuration
-    // DOC:(USE-CASE): https://typescript-eslint.io/getting-started/typed-linting/
+    // INFO: `parserOptions.projectService` is the modern replacement for the deprecated `parserOptions.project`:
+    // - https://typescript-eslint.io/blog/project-service/
+    // - https://typescript-eslint.io/getting-started/typed-linting/
+    // - https://typescript-eslint.io/troubleshooting/typed-linting/
+
+    // disallowAutomaticSingleRunInference: false /* @default: false */,
+    // cacheLifetime: { glob: 30 } /* { glob: "Infinity" (never) | number | @default: 30 seconds } */,
     ecmaFeatures: {
-      jsx: false,
-      globalReturn: true,
+      // jsx: false /* @default: false */,
+      globalReturn: true /* @default: false */,
     },
-    jsDocParsingMode: "none" /* @default(project): "all" | @default: "none" | "type-info" */,
-    projectService: true /* DOC: https://typescript-eslint.io/packages/parser/#projectservice , DOC: https://typescript-eslint.io/troubleshooting/typed-linting/#project-service-issues */,
-    // tsconfigRootDir: import.meta.dirname /* DOC: https://typescript-eslint.io/packages/parser/#tsconfigrootdir ; see `DOC:(USE-CASE), I am inferring that an aboslute path is needed ; DOC:(Node.js: import.meta): https://nodejs.org/api/esm.html#importmetadirname */,
-    warnOnUnsupportedTypeScriptVersion: false,
-    sourceType: "module",
-    ecmaVersion: 2023,
+    ecmaVersion: 2023 /* number | @default: latest" */,
+    emitDecoratorMetadata: false /* boolean | @default: undefined (inherits tsconfig, which has @default: false) */,
+    experimentalDecorators: false /* boolean | @default: undefined (inherits tsconfig, which has @default: false) */,
+    // extraFileExtensions: [] /* string[] | @default: [] (none) | BUG: https://typescript-eslint.io/troubleshooting/typed-linting/performance/#changes-to-extrafileextensions-with-projectservice */,
+    isolatedDeclarations: false /* boolean | @default: undefined (inherits tsconfig, which has @default: false) */,
+    // jsDocParsingMode: "all" /* type-info | @default(if `parserOptions.project` is set): all | @default: none */,
+    // jsxFragmentName: null /* string | @default: null | INFO: if `parserOptions.project` is set, this will automatically be detected from the compiler. */,
+    // jsxPragma: "React" /* null | string (e.g. "preact") | @default: "React" | INFO: if `parserOptions.project` is set, this will automatically be detected from the compiler. */,
+    // lib: ["es2018"] /* string[] | @default: ["es2018"] | INFO: if `parserOptions.project` is set, this will automatically be detected from the compiler. */,
+    projectService: true /* ProjectServiceOptions (DOC: https://typescript-eslint.io/packages/parser/#projectserviceoptions) | true | @default: false */,
+    warnOnUnsupportedTypeScriptVersion: false /* preference due to nuisance | @default: true */,
   },
 };

package/src/scope/registry/manifests/yml.ts

@@ -4,6 +4,6 @@ export const yml = {
   },
   parserOptions: {
     // DOC: https://github.com/ota-meshi/yaml-eslint-parser?tab=readme-ov-file#advanced-configuration
-    defaultYAMLVersion: "1.2" /* @default: "1.2" | "1.1" */,
+    // defaultYAMLVersion: "1.2" /* "1.1" | @default: "1.2" | DOC: https://github.com/ota-meshi/yaml-eslint-parser?tab=readme-ov-file#parseroptionsdefaultyamlversion */,
   },
 };