feat: ESLint-plugin -- Add report option to be able to control the reporting level (matching the CLI): "all", "simple", "typos", "flagged".

packages/cspell-eslint-plugin/src/common/options.cts

@@ -30,6 +30,17 @@ export interface Options extends Check {
      * default false
      */
     debugMode?: boolean;
+    /**
+     * Reporting level for unknown words
+     *
+     * - 'all' - Report all unknown words (default)
+     * - 'simple' - Report unknown words with simple suggestions and flagged words
+     * - 'typos' - Report only common typos and flagged words
+     * - 'flagged' - Report only flagged words
+     *
+     *  default is 'all' unless overridden by CSpell settings
+     */
+    report?: 'all' | 'simple' | 'typos' | 'flagged';
 }
 
 interface DictOptions {
@@ -64,6 +75,7 @@ export type CSpellOptions = Pick<
     | 'includeRegExpList'
     | 'import'
     | 'language'
+    | 'unknownWords'
     | 'words'
 > & {
     dictionaryDefinitions?: DictionaryDefinition[];

packages/cspell-eslint-plugin/src/generated/schema.cts

@@ -354,6 +354,18 @@ export const optionsSchema: Rule.RuleMetaData['schema'] = {
           "markdownDescription": "Current active spelling language. This specifies the language locale to use in choosing the\ngeneral dictionary.\n\nFor example:\n\n- \"en-GB\" for British English.\n- \"en,nl\" to enable both English and Dutch.",
           "type": "string"
         },
+        "unknownWords": {
+          "default": "report-all",
+          "description": "Controls how unknown words are handled.\n\n- `report-all` - Report all unknown words (default behavior)\n- `report-simple` - Report unknown words that have simple spelling errors, typos, and flagged words.\n- `report-common-typos` - Report unknown words that are common typos and flagged words.\n- `report-flagged` - Report unknown words that are flagged.",
+          "enum": [
+            "report-all",
+            "report-simple",
+            "report-common-typos",
+            "report-flagged"
+          ],
+          "markdownDescription": "Controls how unknown words are handled.\n\n- `report-all` - Report all unknown words (default behavior)\n- `report-simple` - Report unknown words that have simple spelling errors, typos, and flagged words.\n- `report-common-typos` - Report unknown words that are common typos and flagged words.\n- `report-flagged` - Report unknown words that are flagged.",
+          "type": "string"
+        },
         "words": {
           "description": "List of words to be considered correct.",
           "items": {
@@ -431,6 +443,17 @@ export const optionsSchema: Rule.RuleMetaData['schema'] = {
       "description": "Number of spelling suggestions to make.",
       "markdownDescription": "Number of spelling suggestions to make.",
       "type": "number"
+    },
+    "report": {
+      "description": "Reporting level for unknown words\n\n- 'all' - Report all unknown words (default)\n- 'simple' - Report unknown words with simple suggestions and flagged words\n- 'typos' - Report only common typos and flagged words\n- 'flagged' - Report only flagged words\n\n default is 'all' unless overridden by CSpell settings",
+      "enum": [
+        "all",
+        "simple",
+        "typos",
+        "flagged"
+      ],
+      "markdownDescription": "Reporting level for unknown words\n\n- 'all' - Report all unknown words (default)\n- 'simple' - Report unknown words with simple suggestions and flagged words\n- 'typos' - Report only common typos and flagged words\n- 'flagged' - Report only flagged words\n\n default is 'all' unless overridden by CSpell settings",
+      "type": "string"
     }
   },
   "required": [

packages/cspell-eslint-plugin/src/plugin/defaultCheckOptions.cts

@@ -24,6 +24,7 @@ export const defaultOptions: RequiredOptions = {
     numSuggestions: 8,
     generateSuggestions: true,
     autoFix: false,
+    report: 'all',
 };
 
 export function normalizeOptions(opts: Options | undefined, cwd: string): WorkerOptions {

packages/cspell-eslint-plugin/src/spellCheckAST/spellCheck.mts

@@ -3,7 +3,7 @@ import assert from 'node:assert';
 import * as path from 'node:path';
 
 import { toFileDirURL, toFileURL } from '@cspell/url';
-import type { CSpellSettings, TextDocument, ValidationIssue } from 'cspell-lib';
+import type { CSpellSettings, TextDocument, UnknownWordsChoices, ValidationIssue } from 'cspell-lib';
 import {
     createTextDocument,
     DocumentValidator,
@@ -155,6 +155,24 @@ function getDocValidator(filename: string, text: string, options: SpellCheckOpti
     return validator;
 }
 
+export type ReportTypes = Exclude<Options['report'], undefined>;
+
+type MapReportToUnknownWordChoices = {
+    [key in ReportTypes]: UnknownWordsChoices;
+};
+
+export const mapReportToUnknownWordChoices: MapReportToUnknownWordChoices = {
+    all: 'report-all',
+    simple: 'report-simple',
+    typos: 'report-common-typos',
+    flagged: 'report-flagged',
+} as const;
+
+function mapReportToUnknownWords(report?: Options['report']): Pick<CSpellSettings, 'unknownWords'> {
+    const unknownWords = report ? mapReportToUnknownWordChoices[report] : undefined;
+    return unknownWords ? { unknownWords } : {};
+}
+
 function calcInitialSettings(options: SpellCheckOptions): CSpellSettings {
     const { customWordListFile, cspell, cwd } = options;
 
@@ -164,6 +182,7 @@ function calcInitialSettings(options: SpellCheckOptions): CSpellSettings {
         words: cspell?.words || [],
         ignoreWords: cspell?.ignoreWords || [],
         flagWords: cspell?.flagWords || [],
+        ...mapReportToUnknownWords(options.report),
     };
 
     if (options.configFile) {

packages/cspell-eslint-plugin/src/spellCheckAST/spellCheck.test.mts

@@ -2,7 +2,23 @@ import 'mocha';
 
 import assert from 'node:assert';
 
-import { spellCheck, type SpellCheckOptions } from './spellCheck.mjs';
+import type { UnknownWordsChoices } from 'cspell-lib';
+
+import type { ReportTypes } from './spellCheck.mjs';
+import { type mapReportToUnknownWordChoices, spellCheck, type SpellCheckOptions } from './spellCheck.mjs';
+
+type MapReportToUnknownWordChoicesConst = typeof mapReportToUnknownWordChoices;
+
+type MapReportToUnknownWordChoicesRev = {
+    [v in keyof MapReportToUnknownWordChoicesConst as MapReportToUnknownWordChoicesConst[v]]: v;
+};
+/**
+ * This function is just used
+ */
+function _mapUnknownWordToReportTypes(k: UnknownWordsChoices, map: MapReportToUnknownWordChoicesRev): ReportTypes {
+    // This will not compile if A new value was added to UnknownWordsChoices and was not added to mapReportToUnknownWordChoices
+    return map[k];
+}
 
 const defaultOptions: SpellCheckOptions = {
     numSuggestions: 8,