cspell-lib 5.19.2 → 5.19.5

package/dist/SpellingDictionary/DictionaryLoader.js

@@ -59,49 +59,50 @@ function __log(msg) {
     debugMode && debugLog.push(msg);
 }
 const dictionaryCache = new Map();
-function loadDictionary(uri, options) {
-    const key = calcKey(uri, options);
+const dictionaryCacheByDef = new Map();
+function getCacheEntry(def) {
+    const defEntry = dictionaryCacheByDef.get(def);
+    if (defEntry) {
+        return defEntry;
+    }
+    const key = calcKey(def);
     const entry = dictionaryCache.get(key);
+    if (entry) {
+        // replace old entry so it can be released.
+        entry.options = def;
+    }
+    return { key, entry };
+}
+function setCacheEntry(key, entry, def) {
+    dictionaryCache.set(key, entry);
+    dictionaryCacheByDef.set(def, { key, entry });
+}
+function loadDictionary(def) {
+    const { key, entry } = getCacheEntry(def);
     if (entry) {
         return entry.pending.then(([dictionary]) => dictionary);
     }
-    const loadedEntry = loadEntry(uri, options);
-    dictionaryCache.set(key, loadedEntry);
+    const loadedEntry = loadEntry(def.path, def);
+    setCacheEntry(key, loadedEntry, def);
     return loadedEntry.pending.then(([dictionary]) => dictionary);
 }
 exports.loadDictionary = loadDictionary;
-function loadDictionarySync(uri, options) {
-    const key = calcKey(uri, options);
-    const entry = dictionaryCache.get(key);
+function loadDictionarySync(def) {
+    const { key, entry } = getCacheEntry(def);
     if ((entry === null || entry === void 0 ? void 0 : entry.dictionary) && entry.loadingState === LoadingState.Loaded) {
-        // if (entry.options.name === 'temp') {
-        //     __log(
-        //         `Cache Found ${entry.options.name}; ts: ${entry.sig.toFixed(2)}; file: ${path.relative(
-        //             process.cwd(),
-        //             entry.uri
-        //         )}`
-        //     );
-        // }
         return entry.dictionary;
     }
-    // if (options.name === 'temp') {
-    //     __log(
-    //         `Cache Miss ${options.name}; ts: ${entry?.sig.toFixed(2) || Date.now()}; file: ${path.relative(
-    //             process.cwd(),
-    //             uri
-    //         )}`
-    //     );
-    // }
-    const loadedEntry = loadEntrySync(uri, options);
-    dictionaryCache.set(key, loadedEntry);
+    const loadedEntry = loadEntrySync(def.path, def);
+    setCacheEntry(key, loadedEntry, def);
     return loadedEntry.dictionary;
 }
 exports.loadDictionarySync = loadDictionarySync;
 const importantOptionKeys = ['name', 'noSuggest', 'useCompounds', 'type'];
-function calcKey(uri, options) {
-    const loaderType = determineType(uri, options);
-    const optValues = importantOptionKeys.map((k) => { var _a; return ((_a = options[k]) === null || _a === void 0 ? void 0 : _a.toString()) || ''; });
-    const parts = [uri, loaderType].concat(optValues);
+function calcKey(def) {
+    const path = def.path;
+    const loaderType = determineType(path, def);
+    const optValues = importantOptionKeys.map((k) => { var _a; return ((_a = def[k]) === null || _a === void 0 ? void 0 : _a.toString()) || ''; });
+    const parts = [path, loaderType].concat(optValues);
     return parts.join('|');
 }
 /**
@@ -136,7 +137,10 @@ async function refreshEntry(entry, maxAge, now) {
         // }
         if (sigMatches && hasChanged) {
             entry.loadingState = LoadingState.Loading;
-            dictionaryCache.set(calcKey(entry.uri, entry.options), loadEntry(entry.uri, entry.options));
+            const key = calcKey(entry.options);
+            const newEntry = loadEntry(entry.uri, entry.options);
+            dictionaryCache.set(key, newEntry);
+            dictionaryCacheByDef.set(entry.options, { key, entry: newEntry });
         }
     }
 }

package/dist/SpellingDictionary/SpellingDictionaryCollection.js

@@ -54,7 +54,7 @@ class SpellingDictionaryCollection {
         return this._suggest(word, suggestOptions);
     }
     _suggest(word, suggestOptions) {
-        const { numSuggestions = (0, Settings_1.getDefaultSettings)().numSuggestions || SpellingDictionaryMethods_1.defaultNumSuggestions, numChanges, ignoreCase, includeTies, timeout, } = suggestOptions;
+        const { numSuggestions = (0, Settings_1.getDefaultSettings)(false).numSuggestions || SpellingDictionaryMethods_1.defaultNumSuggestions, numChanges, ignoreCase, includeTies, timeout, } = suggestOptions;
         const prefixNoCase = cspell_trie_lib_1.CASE_INSENSITIVE_PREFIX;
         const filter = (word, _cost) => {
             return ((ignoreCase || word[0] !== prefixNoCase) &&

package/dist/SpellingDictionary/SpellingDictionaryFromTrie.js

@@ -97,7 +97,7 @@ class SpellingDictionaryFromTrie {
         return this._suggest(word, suggestOptions);
     }
     _suggest(word, suggestOptions) {
-        const { numSuggestions = (0, Settings_1.getDefaultSettings)().numSuggestions || SpellingDictionaryMethods_1.defaultNumSuggestions, numChanges, includeTies, ignoreCase, timeout, } = suggestOptions;
+        const { numSuggestions = (0, Settings_1.getDefaultSettings)(false).numSuggestions || SpellingDictionaryMethods_1.defaultNumSuggestions, numChanges, includeTies, ignoreCase, timeout, } = suggestOptions;
         function filter(_word) {
             return true;
         }

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export * from '@cspell/cspell-types';
 export * from 'cspell-io';
 export { ExcludeFilesGlobMap, ExclusionFunction } from './exclusionHelper';
 export { getLanguagesForExt } from './LanguageIds';
-export { createTextDocument } from './Models/TextDocument';
+export { createTextDocument, updateTextDocument } from './Models/TextDocument';
 export type { CreateTextDocumentParams, TextDocument, TextDocumentLine } from './Models/TextDocument';
 export * from './Settings';
 export { defaultFileName as defaultSettingsFilename } from './Settings';

package/dist/index.js

@@ -26,7 +26,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDictionary = exports.clearCachedFiles = exports.ExclusionHelper = exports.Link = exports.Text = exports.validateText = exports.IncludeExcludeFlag = exports.checkText = exports.resolveFile = exports.setLogger = exports.getLogger = exports.traceWordsAsync = exports.traceWords = exports.DocumentValidator = exports.suggestionsForWords = exports.suggestionsForWord = exports.SuggestionError = exports.SpellingDictionaryLoadError = exports.SpellingDictionaryCollection = exports.refreshDictionaryCache = exports.isSpellingDictionaryLoadError = exports.createSpellingDictionary = exports.CompoundWordsMethod = exports.spellCheckFile = exports.spellCheckDocument = exports.isBinaryFile = exports.fileToDocument = exports.determineFinalDocumentSettings = exports.constructSettingsForText = exports.combineTextAndLanguageSettings = exports.defaultSettingsFilename = exports.createTextDocument = exports.getLanguagesForExt = void 0;
+exports.getDictionary = exports.clearCachedFiles = exports.ExclusionHelper = exports.Link = exports.Text = exports.validateText = exports.IncludeExcludeFlag = exports.checkText = exports.resolveFile = exports.setLogger = exports.getLogger = exports.traceWordsAsync = exports.traceWords = exports.DocumentValidator = exports.suggestionsForWords = exports.suggestionsForWord = exports.SuggestionError = exports.SpellingDictionaryLoadError = exports.SpellingDictionaryCollection = exports.refreshDictionaryCache = exports.isSpellingDictionaryLoadError = exports.createSpellingDictionary = exports.CompoundWordsMethod = exports.spellCheckFile = exports.spellCheckDocument = exports.isBinaryFile = exports.fileToDocument = exports.determineFinalDocumentSettings = exports.constructSettingsForText = exports.combineTextAndLanguageSettings = exports.defaultSettingsFilename = exports.updateTextDocument = exports.createTextDocument = exports.getLanguagesForExt = void 0;
 const ExclusionHelper = __importStar(require("./exclusionHelper"));
 exports.ExclusionHelper = ExclusionHelper;
 const Settings_1 = require("./Settings");
@@ -42,6 +42,7 @@ var LanguageIds_1 = require("./LanguageIds");
 Object.defineProperty(exports, "getLanguagesForExt", { enumerable: true, get: function () { return LanguageIds_1.getLanguagesForExt; } });
 var TextDocument_1 = require("./Models/TextDocument");
 Object.defineProperty(exports, "createTextDocument", { enumerable: true, get: function () { return TextDocument_1.createTextDocument; } });
+Object.defineProperty(exports, "updateTextDocument", { enumerable: true, get: function () { return TextDocument_1.updateTextDocument; } });
 __exportStar(require("./Settings"), exports);
 var Settings_2 = require("./Settings");
 Object.defineProperty(exports, "defaultSettingsFilename", { enumerable: true, get: function () { return Settings_2.defaultFileName; } });

package/dist/suggestions.js

@@ -35,6 +35,7 @@ async function* suggestionsForWords(words, options, settings = {}) {
 }
 exports.suggestionsForWords = suggestionsForWords;
 async function suggestionsForWord(word, options, settings = {}) {
+    var _a;
     const { languageId, locale: language, strict = true, numChanges = 4, numSuggestions = 8, includeTies = true, includeDefaultConfig = true, dictionaries, } = options || {};
     const ignoreCase = !strict;
     async function determineDictionaries(config) {
@@ -56,7 +57,9 @@ async function suggestionsForWord(word, options, settings = {}) {
         };
     }
     await (0, SpellingDictionary_1.refreshDictionaryCache)();
-    const config = includeDefaultConfig ? (0, Settings_1.mergeSettings)((0, Settings_1.getDefaultSettings)(), (0, Settings_1.getGlobalSettings)(), settings) : settings;
+    const config = includeDefaultConfig
+        ? (0, Settings_1.mergeSettings)((0, Settings_1.getDefaultSettings)((_a = settings.loadDefaultConfiguration) !== null && _a !== void 0 ? _a : true), (0, Settings_1.getGlobalSettings)(), settings)
+        : settings;
     const { dictionaryCollection, allDictionaryCollection } = await determineDictionaries(config);
     const opts = { ignoreCase, numChanges, numSuggestions, includeTies };
     const suggestionsByDictionary = dictionaryCollection.dictionaries.map((dict) => dict.suggest(word, opts).map((r) => ({ ...r, dictName: dict.name })));

package/dist/textValidation/determineTextDocumentSettings.js

@@ -41,11 +41,11 @@ const TextDocumentSettings_1 = require("../Settings/TextDocumentSettings");
  * @param settings - The near final settings. Should already be the combination of all configuration files.
  */
 function determineTextDocumentSettings(doc, settings) {
-    var _a;
+    var _a, _b;
     const filename = doc.uri.fsPath;
-    const settingsWithDefaults = (0, Settings_1.mergeSettings)((0, Settings_1.getDefaultSettings)(), (0, Settings_1.getGlobalSettings)(), settings);
+    const settingsWithDefaults = (0, Settings_1.mergeSettings)((0, Settings_1.getDefaultSettings)((_a = settings.loadDefaultConfiguration) !== null && _a !== void 0 ? _a : true), (0, Settings_1.getGlobalSettings)(), settings);
     const fileSettings = (0, Settings_1.calcOverrideSettings)(settingsWithDefaults, filename);
-    const languageIds = ((_a = fileSettings === null || fileSettings === void 0 ? void 0 : fileSettings.languageId) === null || _a === void 0 ? void 0 : _a.length)
+    const languageIds = ((_b = fileSettings === null || fileSettings === void 0 ? void 0 : fileSettings.languageId) === null || _b === void 0 ? void 0 : _b.length)
         ? fileSettings.languageId
         : doc.languageId
             ? doc.languageId

package/dist/textValidation/docValidator.d.ts

@@ -26,6 +26,7 @@ export declare class DocumentValidator {
     private _prepared;
     private _preparations;
     private _preparationTime;
+    private _suggestions;
     /**
      * @param doc - Document to validate
      * @param config - configuration to use (not finalized).
@@ -35,15 +36,19 @@ export declare class DocumentValidator {
     prepareSync(): void;
     prepare(): Promise<void>;
     private _prepareAsync;
+    private _updatePrep;
     /**
      * The amount of time in ms to prepare for validation.
      */
     get prepTime(): number;
     checkText(range: SimpleRange, _text: string, _scope: string[]): ValidationIssue[];
     get document(): TextDocument;
+    updateDocumentText(text: string): void;
     private addPossibleError;
     private catchError;
     private errorCatcherWrapper;
+    private suggest;
+    private genSuggestions;
 }
 export declare type Offset = number;
 export declare type SimpleRange = readonly [Offset, Offset];

package/dist/textValidation/docValidator.js

@@ -6,10 +6,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DocumentValidator = void 0;
 const cspell_pipe_1 = require("@cspell/cspell-pipe");
 const assert_1 = __importDefault(require("assert"));
+const TextDocument_1 = require("../Models/TextDocument");
 const Settings_1 = require("../Settings");
 const configLoader_1 = require("../Settings/configLoader");
 const SpellingDictionary_1 = require("../SpellingDictionary");
 const errors_1 = require("../util/errors");
+const Memorizer_1 = require("../util/Memorizer");
+const simpleCache_1 = require("../util/simpleCache");
 const timer_1 = require("../util/timer");
 const util_1 = require("../util/util");
 const determineTextDocumentSettings_1 = require("./determineTextDocumentSettings");
@@ -26,6 +29,7 @@ class DocumentValidator {
         this._ready = false;
         this.errors = [];
         this._preparationTime = -1;
+        this._suggestions = new simpleCache_1.AutoCache((text) => this.genSuggestions(text), 1000);
         this._document = doc;
         // console.error(`DocumentValidator: ${doc.uri}`);
     }
@@ -50,7 +54,7 @@ class DocumentValidator {
                 ? this.errorCatcherWrapper(() => searchForDocumentConfigSync(this._document, settings, settings))
                 : undefined;
         this.addPossibleError((_a = localConfig === null || localConfig === void 0 ? void 0 : localConfig.__importRef) === null || _a === void 0 ? void 0 : _a.error);
-        const config = localConfig ? (0, Settings_1.mergeSettings)(settings, localConfig) : settings;
+        const config = (0, Settings_1.mergeSettings)(settings, localConfig);
         const docSettings = (0, determineTextDocumentSettings_1.determineTextDocumentSettings)(this._document, config);
         const dict = (0, SpellingDictionary_1.getDictionaryInternalSync)(docSettings);
         const shouldCheck = (_b = docSettings.enabled) !== null && _b !== void 0 ? _b : true;
@@ -60,6 +64,7 @@ class DocumentValidator {
         const segmenter = (0, textValidator_1.mapLineSegmentAgainstRangesFactory)(includeRanges);
         const lineValidator = (0, textValidator_1.lineValidatorFactory)(dict, validateOptions);
         this._preparations = {
+            config,
             dictionary: dict,
             docSettings,
             shouldCheck,
@@ -70,6 +75,7 @@ class DocumentValidator {
         };
         this._ready = true;
         this._preparationTime = timer.elapsed();
+        // console.error(`prepareSync ${this._preparationTime.toFixed(2)}ms`);
     }
     async prepare() {
         if (this._ready)
@@ -90,9 +96,9 @@ class DocumentValidator {
             : useSearchForConfig
                 ? this.catchError(searchForDocumentConfig(this._document, settings, settings))
                 : undefined;
-        const localConfig = await pLocalConfig;
+        const localConfig = (await pLocalConfig) || {};
         this.addPossibleError((_a = localConfig === null || localConfig === void 0 ? void 0 : localConfig.__importRef) === null || _a === void 0 ? void 0 : _a.error);
-        const config = localConfig ? (0, Settings_1.mergeSettings)(settings, localConfig) : settings;
+        const config = (0, Settings_1.mergeSettings)(settings, localConfig);
         const docSettings = (0, determineTextDocumentSettings_1.determineTextDocumentSettings)(this._document, config);
         const dict = await (0, SpellingDictionary_1.getDictionaryInternal)(docSettings);
         const shouldCheck = (_b = docSettings.enabled) !== null && _b !== void 0 ? _b : true;
@@ -102,6 +108,7 @@ class DocumentValidator {
         const segmenter = (0, textValidator_1.mapLineSegmentAgainstRangesFactory)(includeRanges);
         const lineValidator = (0, textValidator_1.lineValidatorFactory)(dict, validateOptions);
         this._preparations = {
+            config,
             dictionary: dict,
             docSettings,
             shouldCheck,
@@ -113,6 +120,31 @@ class DocumentValidator {
         this._ready = true;
         this._preparationTime = timer.elapsed();
     }
+    _updatePrep() {
+        var _a;
+        (0, assert_1.default)(this._preparations);
+        const timer = (0, timer_1.createTimer)();
+        const { config } = this._preparations;
+        const docSettings = (0, determineTextDocumentSettings_1.determineTextDocumentSettings)(this._document, config);
+        const dict = (0, SpellingDictionary_1.getDictionaryInternalSync)(docSettings);
+        const shouldCheck = (_a = docSettings.enabled) !== null && _a !== void 0 ? _a : true;
+        const finalSettings = (0, Settings_1.finalizeSettings)(docSettings);
+        const validateOptions = (0, validator_1.settingsToValidateOptions)(finalSettings);
+        const includeRanges = (0, textValidator_1.calcTextInclusionRanges)(this._document.text, validateOptions);
+        const segmenter = (0, textValidator_1.mapLineSegmentAgainstRangesFactory)(includeRanges);
+        const lineValidator = (0, textValidator_1.lineValidatorFactory)(dict, validateOptions);
+        this._preparations = {
+            config,
+            dictionary: dict,
+            docSettings,
+            shouldCheck,
+            validateOptions,
+            includeRanges,
+            segmenter,
+            lineValidator,
+        };
+        this._preparationTime = timer.elapsed();
+    }
     /**
      * The amount of time in ms to prepare for validation.
      */
@@ -120,7 +152,6 @@ class DocumentValidator {
         return this._preparationTime;
     }
     checkText(range, _text, _scope) {
-        var _a;
         (0, assert_1.default)(this._ready);
         (0, assert_1.default)(this._preparations);
         const { segmenter, lineValidator } = this._preparations;
@@ -143,25 +174,21 @@ class DocumentValidator {
         if (!this.options.generateSuggestions) {
             return issues;
         }
-        const settings = this._preparations.docSettings;
-        const dict = this._preparations.dictionary;
-        const sugOptions = (0, util_1.clean)({
-            compoundMethod: 0,
-            numSuggestions: this.options.numSuggestions,
-            includeTies: false,
-            ignoreCase: !((_a = settings.caseSensitive) !== null && _a !== void 0 ? _a : false),
-            timeout: settings.suggestionsTimeout,
-            numChanges: settings.suggestionNumChanges,
-        });
         const withSugs = issues.map((t) => {
-            const suggestions = dict.suggest(t.text, sugOptions).map((r) => r.word);
-            return { ...t, suggestions };
+            // lazy suggestion calculation.
+            const text = t.text;
+            const suggestions = (0, Memorizer_1.callOnce)(() => this.suggest(text));
+            return Object.defineProperty({ ...t }, 'suggestions', { enumerable: true, get: suggestions });
         });
         return withSugs;
     }
     get document() {
         return this._document;
     }
+    updateDocumentText(text) {
+        (0, TextDocument_1.updateTextDocument)(this._document, [{ text }]);
+        this._updatePrep();
+    }
     addPossibleError(error) {
         if (!error)
             return;
@@ -182,6 +209,24 @@ class DocumentValidator {
         }
         return undefined;
     }
+    suggest(text) {
+        return this._suggestions.get(text);
+    }
+    genSuggestions(text) {
+        var _a;
+        (0, assert_1.default)(this._preparations);
+        const settings = this._preparations.docSettings;
+        const dict = this._preparations.dictionary;
+        const sugOptions = (0, util_1.clean)({
+            compoundMethod: 0,
+            numSuggestions: this.options.numSuggestions,
+            includeTies: false,
+            ignoreCase: !((_a = settings.caseSensitive) !== null && _a !== void 0 ? _a : false),
+            timeout: settings.suggestionsTimeout,
+            numChanges: settings.suggestionNumChanges,
+        });
+        return dict.suggest(text, sugOptions).map((r) => r.word);
+    }
 }
 exports.DocumentValidator = DocumentValidator;
 async function searchForDocumentConfig(document, defaultConfig, pnpSettings) {

package/dist/textValidation/validator.js

@@ -26,6 +26,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkText = exports.IncludeExcludeFlag = exports.settingsToValidateOptions = exports.validateText = exports.diagSource = void 0;
 const Settings = __importStar(require("../Settings"));
 const SpellingDictionary_1 = require("../SpellingDictionary");
+const Memorizer_1 = require("../util/Memorizer");
 const util_1 = require("../util/util");
 const textValidator_1 = require("./textValidator");
 exports.diagSource = 'cSpell Checker';
@@ -46,8 +47,10 @@ async function validateText(text, settings, options = {}) {
         numChanges: settings.suggestionNumChanges,
     });
     const withSugs = issues.map((t) => {
-        const suggestions = dict.suggest(t.text, sugOptions).map((r) => r.word);
-        return { ...t, suggestions };
+        const text = t.text;
+        // lazy suggestion calculation.
+        const suggestions = (0, Memorizer_1.callOnce)(() => dict.suggest(text, sugOptions).map((r) => r.word));
+        return Object.defineProperty({ ...t }, 'suggestions', { enumerable: true, get: suggestions });
     });
     return withSugs;
 }

package/dist/trace.js

@@ -26,6 +26,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.traceWordsAsync = exports.traceWords = void 0;
 const gensequence_1 = require("gensequence");
 const Settings_1 = require("./Settings");
+const CSpellSettingsServer_1 = require("./Settings/CSpellSettingsServer");
 const LanguageSettings_1 = require("./Settings/LanguageSettings");
 const SpellingDictionary_1 = require("./SpellingDictionary");
 const util = __importStar(require("./util/util"));
@@ -50,7 +51,7 @@ async function* traceWordsAsync(words, settings, options) {
         const dictionaries = (settings.dictionaries || [])
             .concat((settings.dictionaryDefinitions || []).map((d) => d.name))
             .filter(util.uniqueFn);
-        const dictSettings = { ...settings, dictionaries };
+        const dictSettings = (0, CSpellSettingsServer_1.toInternalSettings)({ ...settings, dictionaries });
         const dictBase = await (0, SpellingDictionary_1.getDictionaryInternal)(settings);
         const dicts = await (0, SpellingDictionary_1.getDictionaryInternal)(dictSettings);
         const activeDictionaries = dictBase.dictionaries.map((d) => d.name);

package/dist/util/Memorizer.d.ts

@@ -41,10 +41,18 @@ export declare function memorizerKeyBy<F extends (...args: any[]) => any, Args e
  * @param fn - function to memorize
  * @returns a new function.
  */
+export declare function memorizeLastCall<T>(fn: (...p: []) => T): (...p: []) => T;
 export declare function memorizeLastCall<T, K0>(fn: (...p: [K0]) => T): (...p: [K0]) => T;
 export declare function memorizeLastCall<T, K0, K1>(fn: (...p: [K0, K1]) => T): (...p: [K0, K1]) => T;
 export declare function memorizeLastCall<T, K0, K1, K2>(fn: (...p: [K0, K1, K2]) => T): (...p: [K0, K1, K2]) => T;
 export declare function memorizeLastCall<T, K0, K1, K2, K3>(fn: (...p: [K0, K1, K2, K3]) => T): (...p: [K0, K1, K2, K3]) => T;
 export declare function memorizeLastCall<T, K>(fn: (...p: [...K[]]) => T): (...p: [...K[]]) => T;
+/**
+ * calls a function exactly once and always returns the same value.
+ * @param fn - function to call
+ * @returns a new function
+ */
+export declare function callOnce<T>(fn: () => T): () => T;
+export declare function memorizerAll<K extends any[], T>(fn: (...p: K) => T): (...p: K) => T;
 export {};
 //# sourceMappingURL=Memorizer.d.ts.map

package/dist/util/Memorizer.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.memorizeLastCall = exports.memorizerKeyBy = exports.memorizer = void 0;
+exports.memorizerAll = exports.callOnce = exports.memorizeLastCall = exports.memorizerKeyBy = exports.memorizer = void 0;
 const util_1 = require("./util");
 /* eslint-disable @typescript-eslint/no-explicit-any */
 const defaultSize = 50000;
@@ -73,4 +73,62 @@ function memorizeLastCall(fn) {
     };
 }
 exports.memorizeLastCall = memorizeLastCall;
+/**
+ * calls a function exactly once and always returns the same value.
+ * @param fn - function to call
+ * @returns a new function
+ */
+function callOnce(fn) {
+    let last;
+    return () => {
+        if (last) {
+            return last.value;
+        }
+        last = {
+            value: fn(),
+        };
+        return last.value;
+    };
+}
+exports.callOnce = callOnce;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function memorizerAll(fn) {
+    const r = {};
+    function find(p) {
+        var _a;
+        let n = r;
+        for (const k of p) {
+            if (!n)
+                break;
+            n = (_a = n.c) === null || _a === void 0 ? void 0 : _a.get(k);
+        }
+        return n;
+    }
+    function set(p, v) {
+        var _a;
+        let n = r;
+        for (const k of p) {
+            const c = (_a = n.c) === null || _a === void 0 ? void 0 : _a.get(k);
+            if (c) {
+                n = c;
+                continue;
+            }
+            const r = {};
+            n.c = n.c || new Map();
+            n.c.set(k, r);
+            n = r;
+        }
+        n.v = v;
+    }
+    return (...p) => {
+        const f = find(p);
+        if (f && 'v' in f) {
+            return f.v;
+        }
+        const v = fn(...p);
+        set(p, v);
+        return v;
+    };
+}
+exports.memorizerAll = memorizerAll;
 //# sourceMappingURL=Memorizer.js.map

package/dist/util/debugPerf.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Measure and log result.
+ * @param fn - function to measure.
+ * @param message - message to log
+ * @param callback - called when the function has finished.
+ * @returns a function
+ */
+export declare function perfFn<P extends any[], R>(fn: (...args: P) => R, message: string, callback?: (m: string, elapsedMs: number) => void): (...args: P) => R;
+//# sourceMappingURL=debugPerf.d.ts.map

package/dist/util/debugPerf.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.perfFn = void 0;
+const timer_1 = require("./timer");
+/**
+ * Measure and log result.
+ * @param fn - function to measure.
+ * @param message - message to log
+ * @param callback - called when the function has finished.
+ * @returns a function
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function perfFn(fn, message, callback = (message, time) => console.error(`${message}: ${time.toFixed(2)}ms`)) {
+    return (...args) => {
+        const timer = (0, timer_1.createTimer)();
+        const r = fn(...args);
+        callback(message, timer.elapsed());
+        return r;
+    };
+}
+exports.perfFn = perfFn;
+//# sourceMappingURL=debugPerf.js.map

package/dist/util/simpleCache.d.ts

@@ -7,7 +7,8 @@ export declare class SimpleWeakCache<K extends object, T> {
     constructor(size: number);
     has(key: K): boolean;
     get(key: K): T | undefined;
-    set(key: K, value: T): this | undefined;
+    set(key: K, value: T): void;
+    private _set;
     private caches;
     private rotate;
 }
@@ -32,7 +33,8 @@ export declare class SimpleCache<K, T> {
     constructor(size: number);
     has(key: K): boolean;
     get(key: K): T | undefined;
-    set(key: K, value: T): this | undefined;
+    set(key: K, value: T): void;
+    private _set;
     private caches;
     private rotate;
 }

package/dist/util/simpleCache.js

@@ -18,27 +18,29 @@ class SimpleWeakCache {
     }
     get(key) {
         for (const c of this.caches()) {
-            if (c.has(key)) {
-                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                const v = c.get(key);
+            const entry = c.get(key);
+            if (entry) {
                 if (c !== this.L0) {
-                    this.set(key, v);
+                    this._set(key, entry);
                 }
-                return v;
+                return entry.v;
             }
         }
         return undefined;
     }
     set(key, value) {
+        this._set(key, { v: value });
+    }
+    _set(key, entry) {
         if (this.L0.has(key)) {
-            this.L0.set(key, value);
+            this.L0.set(key, entry);
             return this;
         }
         if (this.sizeL0 >= this.size) {
             this.rotate();
         }
         this.sizeL0 += 1;
-        this.L0.set(key, value);
+        this.L0.set(key, entry);
     }
     caches() {
         return [this.L0, this.L1, this.L2];
@@ -90,32 +92,33 @@ class SimpleCache {
     }
     get(key) {
         for (const c of this.caches()) {
-            if (c.has(key)) {
-                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                const v = c.get(key);
+            const entry = c.get(key);
+            if (entry) {
                 if (c !== this.L0) {
-                    this.set(key, v);
+                    this._set(key, entry);
                 }
-                return v;
+                return entry.v;
             }
         }
         return undefined;
     }
     set(key, value) {
+        this._set(key, { v: value });
+    }
+    _set(key, entry) {
         if (this.L0.has(key)) {
-            this.L0.set(key, value);
+            this.L0.set(key, entry);
             return this;
         }
         if (this.L0.size >= this.size) {
             this.rotate();
         }
-        this.L0.set(key, value);
+        this.L0.set(key, entry);
     }
     caches() {
         return [this.L0, this.L1, this.L2];
     }
     rotate() {
-        this.L2.clear();
         this.L2 = this.L1;
         this.L1 = this.L0;
         this.L0 = new Map();

package/dist/util/timer.d.ts

@@ -6,10 +6,21 @@ export interface Timer {
      * timer was created / started.
      */
     elapsed(): number;
+    /**
+     * Calculate the amount of time in ms since the
+     * end of the last lap.
+     */
+    lap(): number;
 }
 export declare function createTimer(hrTimeFn?: HRTimeFn): Timer;
 export declare type HRTimeFn = (time?: HRTime) => HRTime;
 export declare type HRTime = [number, number];
 export declare function toMilliseconds(t: HRTime): number;
 export declare function polyHrTime(time?: HRTime): HRTime;
+export interface LapRecorder {
+    times: [name: string, lapTime: number, totalTime: number][];
+    lap(name: string): void;
+    report(): string[];
+}
+export declare function createLapRecorder(): LapRecorder;
 //# sourceMappingURL=timer.d.ts.map