@cspell/eslint-plugin 6.2.3 → 6.4.0-alpha.0

package/dist/index.d.ts

@@ -77,6 +77,11 @@ interface Check {
      * @default true
      */
     checkComments?: boolean;
+    /**
+     * **Experimental**: Specify a path to a custom word list file. A utf-8 text file with one word per line.
+     * This file is used to present the option to add words.
+     */
+    customWordListFile?: string | undefined;
 }
 
 export { Options, configs, rules };

package/dist/index.js

@@ -1,5 +1,5 @@
 /*!
- * @cspell/eslint-plugin v6.2.2
+ * @cspell/eslint-plugin v6.3.0
  * Copyright 2022 Jason Dent <jason@streetsidesoftware.nl>
  * Released under the MIT License
  * https://github.com/streetsidesoftware/cspell/tree/main/packages/cspell-eslint-plugin#readme
@@ -11,19 +11,77 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var assert = require('assert');
 var cspellLib = require('cspell-lib');
+var path = require('path');
 var util = require('util');
+var fs = require('fs');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
+function _interopNamespace(e) {
+    if (e && e.__esModule) return e;
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n["default"] = e;
+    return Object.freeze(n);
+}
+
 var assert__default = /*#__PURE__*/_interopDefaultLegacy(assert);
+var path__namespace = /*#__PURE__*/_interopNamespace(path);
+var fs__namespace = /*#__PURE__*/_interopNamespace(fs);
+
+const sortFn = new Intl.Collator().compare;
+function addWordToCustomWordList(customWordListPath, word) {
+    const content = readFile(customWordListPath) || '\n';
+    const lineEndingMatch = content.match(/\r?\n/);
+    const lineEnding = (lineEndingMatch === null || lineEndingMatch === void 0 ? void 0 : lineEndingMatch[0]) || '\n';
+    const words = new Set(content
+        .split(/\n/g)
+        .map((a) => a.trim())
+        .filter((a) => !!a));
+    words.add(word);
+    const lines = [...words];
+    lines.sort(sortFn);
+    writeFile(customWordListPath, lines.join(lineEnding) + lineEnding);
+}
+function readFile(file) {
+    try {
+        return fs__namespace.readFileSync(file, 'utf-8');
+    }
+    catch (e) {
+        return undefined;
+    }
+}
+function writeFile(file, content) {
+    makeDir(path__namespace.dirname(file));
+    fs__namespace.writeFileSync(file, content);
+}
+function makeDir(dir) {
+    try {
+        fs__namespace.mkdirSync(dir, { recursive: true });
+    }
+    catch (e) {
+        console.log(e);
+    }
+}
 
 const defaultCheckOptions = {
     checkComments: true,
     checkIdentifiers: true,
     checkStrings: true,
     checkStringTemplates: true,
-    ignoreImports: true,
+    customWordListFile: undefined,
     ignoreImportProperties: true,
+    ignoreImports: true,
 };
 const defaultOptions = {
     ...defaultCheckOptions,
@@ -61,6 +119,10 @@ var properties = {
 		description: "Spell check strings",
 		type: "boolean"
 	},
+	customWordListFile: {
+		description: "**Experimental**: Specify a path to a custom word list file. A utf-8 text file with one word per line. This file is used to present the option to add words.",
+		type: "string"
+	},
 	debugMode: {
 		"default": false,
 		description: "Output debug logs",
@@ -106,6 +168,7 @@ const messages = {
     wordUnknown: 'Unknown word: "{{word}}"',
     wordForbidden: 'Forbidden word: "{{word}}"',
     suggestWord: '{{word}}',
+    addWordToDictionary: 'Add "{{word}}" to {{dictionary}}',
 };
 const meta = {
     docs: {
@@ -157,7 +220,6 @@ function create(context) {
         if (!options.checkStringTemplates)
             return;
         debugNode(node, node.value);
-        // console.log('Template: %o', node.value);
         checkNodeText(node, node.value.cooked || node.value.raw);
     }
     function checkIdentifier(node) {
@@ -273,8 +335,30 @@ function create(context) {
                 fix: fixFactory(word),
             };
         }
+        function createAddWordToDictionaryFix(word) {
+            if (!options.customWordListFile)
+                return undefined;
+            const dictFile = path__namespace.resolve(context.getCwd(), options.customWordListFile);
+            const data = { word, dictionary: path__namespace.basename(dictFile) };
+            const messageId = 'addWordToDictionary';
+            return {
+                messageId,
+                data,
+                fix: (_fixer) => {
+                    // This wrapper is a hack to delay applying the fix until it is actually used.
+                    // But it is not reliable, since ESLint + extension will randomly read the value.
+                    return new WrapFix({ range: [start, end], text: word }, () => {
+                        cspellLib.refreshDictionaryCache(0);
+                        addWordToCustomWordList(dictFile, word);
+                        validator.updateDocumentText(context.getSourceCode().getText());
+                    });
+                },
+            };
+        }
         log('Suggestions: %o', issue.suggestions);
-        const suggest = (_a = issue.suggestions) === null || _a === void 0 ? void 0 : _a.map(createSug);
+        const suggestions = (_a = issue.suggestions) === null || _a === void 0 ? void 0 : _a.map(createSug);
+        const addWordFix = createAddWordToDictionaryFix(issue.text);
+        const suggest = suggestions || addWordFix ? (suggestions || []).concat(addWordFix ? [addWordFix] : []) : undefined;
         const des = {
             messageId,
             data,
@@ -436,26 +520,64 @@ function getDocValidator(context) {
     const doc = getTextDocument(context.getFilename(), text);
     const cachedValidator = docValCache.get(doc);
     if (cachedValidator) {
+        cspellLib.refreshDictionaryCache(0);
         cachedValidator.updateDocumentText(text);
         return cachedValidator;
     }
     const options = normalizeOptions(context.options[0]);
+    const settings = calcInitialSettings(options, context.getCwd());
     isDebugMode = options.debugMode || false;
     isDebugMode && logContext(context);
-    const validator = new cspellLib.DocumentValidator(doc, options, defaultSettings);
+    const validator = new cspellLib.DocumentValidator(doc, options, settings);
     docValCache.set(doc, validator);
     return validator;
 }
+function calcInitialSettings(options, cwd) {
+    if (!options.customWordListFile)
+        return defaultSettings;
+    const dictFile = path__namespace.resolve(cwd, options.customWordListFile);
+    const settings = {
+        ...defaultSettings,
+        dictionaryDefinitions: [{ name: 'eslint-plugin-custom-words', path: dictFile }],
+        dictionaries: ['eslint-plugin-custom-words'],
+    };
+    return settings;
+}
 function getTextDocument(filename, content) {
     var _a;
     if (((_a = cache.lastDoc) === null || _a === void 0 ? void 0 : _a.filename) === filename) {
         return cache.lastDoc.doc;
     }
     const doc = cspellLib.createTextDocument({ uri: filename, content });
-    // console.error(`CreateTextDocument: ${doc.uri}`);
     cache.lastDoc = { filename, doc };
     return doc;
 }
+/**
+ * This wrapper is used to add a
+ */
+class WrapFix {
+    /**
+     *
+     * @param fix - the example Fix
+     * @param onGetText - called when `fix.text` is accessed
+     * @param limit - limit the number of times onGetText is called. Set it to `-1` for infinite.
+     */
+    constructor(fix, onGetText, limit = 1) {
+        this.fix = fix;
+        this.onGetText = onGetText;
+        this.limit = limit;
+    }
+    get range() {
+        return this.fix.range;
+    }
+    get text() {
+        if (this.limit) {
+            this.limit--;
+            this.onGetText();
+        }
+        return this.fix.text;
+    }
+}
 
 exports.configs = configs;
 exports.rules = rules;

package/dist/index.mjs

@@ -1,21 +1,59 @@
 /*!
- * @cspell/eslint-plugin v6.2.2
+ * @cspell/eslint-plugin v6.3.0
  * Copyright 2022 Jason Dent <jason@streetsidesoftware.nl>
  * Released under the MIT License
  * https://github.com/streetsidesoftware/cspell/tree/main/packages/cspell-eslint-plugin#readme
  */
 
 import assert from 'assert';
-import { DocumentValidator, createTextDocument } from 'cspell-lib';
+import { refreshDictionaryCache, DocumentValidator, createTextDocument } from 'cspell-lib';
+import * as path from 'path';
 import { format } from 'util';
+import * as fs from 'fs';
+
+const sortFn = new Intl.Collator().compare;
+function addWordToCustomWordList(customWordListPath, word) {
+    const content = readFile(customWordListPath) || '\n';
+    const lineEndingMatch = content.match(/\r?\n/);
+    const lineEnding = (lineEndingMatch === null || lineEndingMatch === void 0 ? void 0 : lineEndingMatch[0]) || '\n';
+    const words = new Set(content
+        .split(/\n/g)
+        .map((a) => a.trim())
+        .filter((a) => !!a));
+    words.add(word);
+    const lines = [...words];
+    lines.sort(sortFn);
+    writeFile(customWordListPath, lines.join(lineEnding) + lineEnding);
+}
+function readFile(file) {
+    try {
+        return fs.readFileSync(file, 'utf-8');
+    }
+    catch (e) {
+        return undefined;
+    }
+}
+function writeFile(file, content) {
+    makeDir(path.dirname(file));
+    fs.writeFileSync(file, content);
+}
+function makeDir(dir) {
+    try {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    catch (e) {
+        console.log(e);
+    }
+}
 
 const defaultCheckOptions = {
     checkComments: true,
     checkIdentifiers: true,
     checkStrings: true,
     checkStringTemplates: true,
-    ignoreImports: true,
+    customWordListFile: undefined,
     ignoreImportProperties: true,
+    ignoreImports: true,
 };
 const defaultOptions = {
     ...defaultCheckOptions,
@@ -53,6 +91,10 @@ var properties = {
 		description: "Spell check strings",
 		type: "boolean"
 	},
+	customWordListFile: {
+		description: "**Experimental**: Specify a path to a custom word list file. A utf-8 text file with one word per line. This file is used to present the option to add words.",
+		type: "string"
+	},
 	debugMode: {
 		"default": false,
 		description: "Output debug logs",
@@ -98,6 +140,7 @@ const messages = {
     wordUnknown: 'Unknown word: "{{word}}"',
     wordForbidden: 'Forbidden word: "{{word}}"',
     suggestWord: '{{word}}',
+    addWordToDictionary: 'Add "{{word}}" to {{dictionary}}',
 };
 const meta = {
     docs: {
@@ -149,7 +192,6 @@ function create(context) {
         if (!options.checkStringTemplates)
             return;
         debugNode(node, node.value);
-        // console.log('Template: %o', node.value);
         checkNodeText(node, node.value.cooked || node.value.raw);
     }
     function checkIdentifier(node) {
@@ -265,8 +307,30 @@ function create(context) {
                 fix: fixFactory(word),
             };
         }
+        function createAddWordToDictionaryFix(word) {
+            if (!options.customWordListFile)
+                return undefined;
+            const dictFile = path.resolve(context.getCwd(), options.customWordListFile);
+            const data = { word, dictionary: path.basename(dictFile) };
+            const messageId = 'addWordToDictionary';
+            return {
+                messageId,
+                data,
+                fix: (_fixer) => {
+                    // This wrapper is a hack to delay applying the fix until it is actually used.
+                    // But it is not reliable, since ESLint + extension will randomly read the value.
+                    return new WrapFix({ range: [start, end], text: word }, () => {
+                        refreshDictionaryCache(0);
+                        addWordToCustomWordList(dictFile, word);
+                        validator.updateDocumentText(context.getSourceCode().getText());
+                    });
+                },
+            };
+        }
         log('Suggestions: %o', issue.suggestions);
-        const suggest = (_a = issue.suggestions) === null || _a === void 0 ? void 0 : _a.map(createSug);
+        const suggestions = (_a = issue.suggestions) === null || _a === void 0 ? void 0 : _a.map(createSug);
+        const addWordFix = createAddWordToDictionaryFix(issue.text);
+        const suggest = suggestions || addWordFix ? (suggestions || []).concat(addWordFix ? [addWordFix] : []) : undefined;
         const des = {
             messageId,
             data,
@@ -428,26 +492,64 @@ function getDocValidator(context) {
     const doc = getTextDocument(context.getFilename(), text);
     const cachedValidator = docValCache.get(doc);
     if (cachedValidator) {
+        refreshDictionaryCache(0);
         cachedValidator.updateDocumentText(text);
         return cachedValidator;
     }
     const options = normalizeOptions(context.options[0]);
+    const settings = calcInitialSettings(options, context.getCwd());
     isDebugMode = options.debugMode || false;
     isDebugMode && logContext(context);
-    const validator = new DocumentValidator(doc, options, defaultSettings);
+    const validator = new DocumentValidator(doc, options, settings);
     docValCache.set(doc, validator);
     return validator;
 }
+function calcInitialSettings(options, cwd) {
+    if (!options.customWordListFile)
+        return defaultSettings;
+    const dictFile = path.resolve(cwd, options.customWordListFile);
+    const settings = {
+        ...defaultSettings,
+        dictionaryDefinitions: [{ name: 'eslint-plugin-custom-words', path: dictFile }],
+        dictionaries: ['eslint-plugin-custom-words'],
+    };
+    return settings;
+}
 function getTextDocument(filename, content) {
     var _a;
     if (((_a = cache.lastDoc) === null || _a === void 0 ? void 0 : _a.filename) === filename) {
         return cache.lastDoc.doc;
     }
     const doc = createTextDocument({ uri: filename, content });
-    // console.error(`CreateTextDocument: ${doc.uri}`);
     cache.lastDoc = { filename, doc };
     return doc;
 }
+/**
+ * This wrapper is used to add a
+ */
+class WrapFix {
+    /**
+     *
+     * @param fix - the example Fix
+     * @param onGetText - called when `fix.text` is accessed
+     * @param limit - limit the number of times onGetText is called. Set it to `-1` for infinite.
+     */
+    constructor(fix, onGetText, limit = 1) {
+        this.fix = fix;
+        this.onGetText = onGetText;
+        this.limit = limit;
+    }
+    get range() {
+        return this.fix.range;
+    }
+    get text() {
+        if (this.limit) {
+            this.limit--;
+            this.onGetText();
+        }
+        return this.fix.text;
+    }
+}
 
 export { configs, rules };
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "6.2.3",
+  "version": "6.4.0-alpha.0",
   "description": "[WIP] CSpell ESLint plugin",
   "keywords": [
     "cspell",
@@ -60,19 +60,19 @@
     "@rollup/plugin-typescript": "^8.3.3",
     "@types/eslint": "^8.4.5",
     "@types/estree": "^0.0.52",
-    "@types/node": "^18.0.3",
-    "@typescript-eslint/parser": "^5.30.5",
-    "@typescript-eslint/types": "^5.30.5",
-    "@typescript-eslint/typescript-estree": "^5.30.5",
-    "eslint": "^8.19.0",
+    "@types/node": "^18.0.6",
+    "@typescript-eslint/parser": "^5.30.6",
+    "@typescript-eslint/types": "^5.30.6",
+    "@typescript-eslint/typescript-estree": "^5.30.6",
+    "eslint": "^8.20.0",
     "mocha": "^10.0.0",
     "rimraf": "^3.0.2",
-    "rollup": "^2.75.7",
+    "rollup": "^2.77.0",
     "rollup-plugin-dts": "^4.2.2",
     "ts-json-schema-generator": "^1.0.0"
   },
   "dependencies": {
-    "cspell-lib": "^6.2.3"
+    "cspell-lib": "^6.4.0-alpha.0"
   },
-  "gitHead": "39766b5de9d52077dce7e3af0af5f25b6f2d4f6a"
+  "gitHead": "ad84fb5398b1f9c1133187616637efe2f13ea598"
 }