@cspell/cspell-types 5.14.0 → 5.15.3

package/cspell.schema.json

@@ -2,6 +2,124 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "additionalProperties": false,
   "definitions": {
+    "CacheSettings": {
+      "additionalProperties": false,
+      "properties": {
+        "cacheLocation": {
+          "$ref": "#/definitions/FSPathResolvable",
+          "description": "Path to the cache location. Can be a file or a directory. If none specified `.cspellcache` will be used. Relative paths are relative to the config file in which it is defined.\n\nA prefix of `${cwd}` is replaced with the current working directory."
+        },
+        "cacheStrategy": {
+          "$ref": "#/definitions/CacheStrategy",
+          "default": "metadata",
+          "description": "Strategy to use for detecting changed files, default: metadata"
+        },
+        "useCache": {
+          "default": false,
+          "description": "Store the results of processed files in order to only operate on the changed ones.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "CacheStrategy": {
+      "description": "The Strategy to use to detect if a file has changed.\n- `metadata` - uses the file system timestamp and size to detect changes (fastest).\n- `content` - uses a hash of the file content to check file changes (slower - more accurate).",
+      "enum": [
+        "metadata",
+        "content"
+      ],
+      "type": "string"
+    },
+    "CostMapDefInsDel": {
+      "additionalProperties": false,
+      "properties": {
+        "description": {
+          "description": "A description to describe the purpose of the map.",
+          "type": "string"
+        },
+        "insDel": {
+          "description": "The cost to insert/delete one of the substrings in the map. Note: insert/delete costs are symmetrical.",
+          "type": "number"
+        },
+        "map": {
+          "description": "The set of substrings to map, these are generally single character strings.\n\nMultiple sets can be defined by using a `|` to separate them.\n\nExample: `\"eéê|aåá\"` contains two different sets.\n\nTo add a multi-character substring use `()`.\n\nExample: `\"f(ph)(gh)\"` results in the following set: `f`, `ph`, `gh`.",
+          "type": "string"
+        },
+        "replace": {
+          "description": "The cost to replace of of the substrings in the map with another substring in the map. Example: Map['a', 'i'] This would be the cost to substitute `a` with `i`: Like `bat` to `bit` or the reverse.",
+          "type": "number"
+        },
+        "swap": {
+          "description": "The cost to swap two adjacent substrings found in the map. Example: Map['e', 'i'] This represents the cost to change `ei` to `ie` or the reverse.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "insDel",
+        "map"
+      ],
+      "type": "object"
+    },
+    "CostMapDefReplace": {
+      "additionalProperties": false,
+      "properties": {
+        "description": {
+          "description": "A description to describe the purpose of the map.",
+          "type": "string"
+        },
+        "insDel": {
+          "description": "The cost to insert/delete one of the substrings in the map. Note: insert/delete costs are symmetrical.",
+          "type": "number"
+        },
+        "map": {
+          "description": "The set of substrings to map, these are generally single character strings.\n\nMultiple sets can be defined by using a `|` to separate them.\n\nExample: `\"eéê|aåá\"` contains two different sets.\n\nTo add a multi-character substring use `()`.\n\nExample: `\"f(ph)(gh)\"` results in the following set: `f`, `ph`, `gh`.",
+          "type": "string"
+        },
+        "replace": {
+          "description": "The cost to replace of of the substrings in the map with another substring in the map. Example: Map['a', 'i'] This would be the cost to substitute `a` with `i`: Like `bat` to `bit` or the reverse.",
+          "type": "number"
+        },
+        "swap": {
+          "description": "The cost to swap two adjacent substrings found in the map. Example: Map['e', 'i'] This represents the cost to change `ei` to `ie` or the reverse.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "map",
+        "replace"
+      ],
+      "type": "object"
+    },
+    "CostMapDefSwap": {
+      "additionalProperties": false,
+      "properties": {
+        "description": {
+          "description": "A description to describe the purpose of the map.",
+          "type": "string"
+        },
+        "insDel": {
+          "description": "The cost to insert/delete one of the substrings in the map. Note: insert/delete costs are symmetrical.",
+          "type": "number"
+        },
+        "map": {
+          "description": "The set of substrings to map, these are generally single character strings.\n\nMultiple sets can be defined by using a `|` to separate them.\n\nExample: `\"eéê|aåá\"` contains two different sets.\n\nTo add a multi-character substring use `()`.\n\nExample: `\"f(ph)(gh)\"` results in the following set: `f`, `ph`, `gh`.",
+          "type": "string"
+        },
+        "replace": {
+          "description": "The cost to replace of of the substrings in the map with another substring in the map. Example: Map['a', 'i'] This would be the cost to substitute `a` with `i`: Like `bat` to `bit` or the reverse.",
+          "type": "number"
+        },
+        "swap": {
+          "description": "The cost to swap two adjacent substrings found in the map. Example: Map['e', 'i'] This represents the cost to change `ei` to `ie` or the reverse.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "map",
+        "swap"
+      ],
+      "type": "object"
+    },
     "CustomDictionaryPath": {
       "description": "A File System Path to a dictionary file.",
       "pattern": "^.*\\.txt$",
@@ -57,6 +175,10 @@
           "$ref": "#/definitions/ReplaceMap",
           "description": "Replacement pairs."
         },
+        "suggestionEditCosts": {
+          "$ref": "#/definitions/SuggestionCostsDefs",
+          "description": "Used in making suggestions. The lower the value, the more likely the suggestion will be near the top of the suggestion list.\n\nAdded with `v5.16.0`."
+        },
         "type": {
           "$ref": "#/definitions/DictionaryFileTypes",
           "default": "S",
@@ -115,6 +237,10 @@
           ],
           "description": "Defines the scope for when words will be added to the dictionary. Scope values: `user`, `workspace`, `folder`."
         },
+        "suggestionEditCosts": {
+          "$ref": "#/definitions/SuggestionCostsDefs",
+          "description": "Used in making suggestions. The lower the value, the more likely the suggestion will be near the top of the suggestion list.\n\nAdded with `v5.16.0`."
+        },
         "type": {
           "$ref": "#/definitions/DictionaryFileTypes",
           "default": "S",
@@ -155,6 +281,10 @@
           "$ref": "#/definitions/ReplaceMap",
           "description": "Replacement pairs."
         },
+        "suggestionEditCosts": {
+          "$ref": "#/definitions/SuggestionCostsDefs",
+          "description": "Used in making suggestions. The lower the value, the more likely the suggestion will be near the top of the suggestion list.\n\nAdded with `v5.16.0`."
+        },
         "type": {
           "$ref": "#/definitions/DictionaryFileTypes",
           "default": "S",
@@ -210,8 +340,26 @@
       ],
       "description": "Reference to a dictionary by name. One of:\n-  {@link  DictionaryRef } \n-  {@link  DictionaryNegRef }"
     },
+    "FSPathResolvable": {
+      "$ref": "#/definitions/FsPath",
+      "description": "A File System Path.\n\nSpecial Properties:\n- `${cwd}` prefix - will be replaced with the current working directory.\n- Relative paths are relative to the configuration file."
+    },
+    "FeatureEnableOnly": {
+      "type": "boolean"
+    },
+    "Features": {
+      "additionalProperties": false,
+      "description": "Features are behaviors or settings that can be explicitly configured.",
+      "properties": {
+        "weighted-suggestions": {
+          "$ref": "#/definitions/FeatureEnableOnly",
+          "description": "Enable/disable using weighted suggestions."
+        }
+      },
+      "type": "object"
+    },
     "FsPath": {
-      "description": "A File System Path.",
+      "description": "A File System Path. Relative paths are relative to the configuration file.",
       "type": "string"
     },
     "Glob": {
@@ -596,6 +744,8 @@
     "PredefinedPatterns": {
       "enum": [
         "Base64",
+        "Base64MultiLine",
+        "Base64SingleLine",
         "CStyleComment",
         "CStyleHexValue",
         "CSSHexValue",
@@ -608,7 +758,9 @@
         "PhpHereDoc",
         "PublicKey",
         "RsaCert",
+        "SshRsa",
         "SHA",
+        "HashStrings",
         "SpellCheckerDisable",
         "SpellCheckerDisableBlock",
         "SpellCheckerDisableLine",
@@ -706,6 +858,26 @@
       "description": "Simple Glob string, the root will be globRoot.",
       "type": "string"
     },
+    "SuggestionCostMapDef": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/CostMapDefReplace"
+        },
+        {
+          "$ref": "#/definitions/CostMapDefInsDel"
+        },
+        {
+          "$ref": "#/definitions/CostMapDefSwap"
+        }
+      ],
+      "description": "A WeightedMapDef enables setting weights for edits between related characters and substrings.\n\nMultiple groups can be defined using a `|`. A multi-character substring is defined using `()`.\n\nFor example, in some languages, some letters sound alike.\n\n```ts {   map: 'sc(sh)(sch)(ss)|t(tt)', // two groups.   replace: 50, // Make it 1/2 the cost of a normal edit to replace a `t` with `tt`. } ```\n\nThe following could be used to make inserting, removing, or replacing vowels cheaper. ```ts {   map: 'aeiouy', //.   insDel: 50, // Make it is cheaper to insert or delete a vowel.   replace: 45, // It is even cheaper to replace one with another. } ```\n\nNote: the default edit distance is 100."
+    },
+    "SuggestionCostsDefs": {
+      "items": {
+        "$ref": "#/definitions/SuggestionCostMapDef"
+      },
+      "type": "array"
+    },
     "Version": {
       "anyOf": [
         {
@@ -738,6 +910,10 @@
       "description": "True to enable compound word checking.",
       "type": "boolean"
     },
+    "cache": {
+      "$ref": "#/definitions/CacheSettings",
+      "description": "Define cache settings."
+    },
     "caseSensitive": {
       "default": false,
       "description": "Determines if words must match case and accent rules.\n\n- `false` - Case is ignored and accents can be missing on the entire word.   Incorrect accents or partially missing accents will be marked as incorrect.\n- `true` - Case and accents are enforced.",
@@ -788,6 +964,10 @@
       },
       "type": "array"
     },
+    "features": {
+      "$ref": "#/definitions/Features",
+      "description": "Configure CSpell features.\n\n- Added with `v5.16.0`."
+    },
     "files": {
       "description": "Glob patterns of files to be checked. Glob patterns are relative to the `globRoot` of the configuration file that defines them.",
       "items": {
@@ -817,7 +997,7 @@
       "description": "Tells the spell checker to searching for `.gitignore` files when it reaches a matching root."
     },
     "globRoot": {
-      "$ref": "#/definitions/FsPath",
+      "$ref": "#/definitions/FSPathResolvable",
       "description": "The root to use for glob patterns found in this configuration. Default: location of the configuration file.   For compatibility reasons, config files with version 0.1, the glob root will   default to be `${cwd}`.\n\nUse `globRoot` to define a different location. `globRoot` can be relative to the location of this configuration file. Defining globRoot, does not impact imported configurations.\n\nSpecial Values:\n- `${cwd}` - will be replaced with the current working directory.\n- `.` - will be the location of the containing configuration file."
     },
     "id": {

package/dist/CSpellReporter.d.ts

@@ -36,10 +36,16 @@ export interface ProgressFileComplete extends ProgressBase {
 }
 export declare type ProgressEmitter = (p: ProgressItem | ProgressFileComplete) => void;
 export interface RunResult {
+    /** Number of files processed. */
     files: number;
+    /** Set of files where issues were found. */
     filesWithIssues: Set<string>;
+    /** Number of issues found. */
     issues: number;
+    /** Number of processing errors. */
     errors: number;
+    /** Number files that used results from the cache. */
+    cachedFiles?: number;
 }
 export declare type ResultEmitter = (result: RunResult) => void | Promise<void>;
 export interface CSpellReporter {

package/dist/CSpellSettingsDef.d.ts

@@ -1,3 +1,5 @@
+import { Features } from './features';
+import type { SuggestionCostsDefs } from './suggestionCostsDef';
 export declare type ReplaceEntry = [string, string];
 export declare type ReplaceMap = ReplaceEntry[];
 /**
@@ -18,7 +20,7 @@ export interface CSpellSettingsWithSourceTrace extends CSpellSettings {
     __importRef?: ImportFileRef;
     __imports?: Map<string, ImportFileRef>;
 }
-export interface FileSettings extends ExtendableSettings {
+export interface FileSettings extends ExtendableSettings, CommandLineSettings {
     /**
      * Configuration format version of the settings file.
      * @default "0.2"
@@ -43,7 +45,7 @@ export interface FileSettings extends ExtendableSettings {
      * - `.` - will be the location of the containing configuration file.
      *
      */
-    globRoot?: FsPath;
+    globRoot?: FSPathResolvable;
     /**
      * Glob patterns of files to be checked.
      * Glob patterns are relative to the `globRoot` of the configuration file that defines them.
@@ -86,6 +88,12 @@ export interface FileSettings extends ExtendableSettings {
      * Tells the spell checker to searching for `.gitignore` files when it reaches a matching root.
      */
     gitignoreRoot?: FsPath | FsPath[];
+    /**
+     * Configure CSpell features.
+     *
+     * - Added with `v5.16.0`.
+     */
+    features?: Features;
 }
 export interface ExtendableSettings extends Settings {
     /** Overrides to apply based upon the file path. */
@@ -184,6 +192,42 @@ export interface PnPSettings {
      */
     pnpFiles?: string[];
 }
+/**
+ * The Strategy to use to detect if a file has changed.
+ * - `metadata` - uses the file system timestamp and size to detect changes (fastest).
+ * - `content` - uses a hash of the file content to check file changes (slower - more accurate).
+ */
+export declare type CacheStrategy = 'metadata' | 'content';
+export interface CacheSettings {
+    /**
+     * Store the results of processed files in order to only operate on the changed ones.
+     * @default false
+     */
+    useCache?: boolean;
+    /**
+     * Path to the cache location. Can be a file or a directory.
+     * If none specified `.cspellcache` will be used.
+     * Relative paths are relative to the config file in which it
+     * is defined.
+     *
+     * A prefix of `${cwd}` is replaced with the current working directory.
+     */
+    cacheLocation?: FSPathResolvable;
+    /**
+     * Strategy to use for detecting changed files, default: metadata
+     * @default 'metadata'
+     */
+    cacheStrategy?: CacheStrategy;
+}
+/**
+ * These are settings only used by the command line application.
+ */
+export interface CommandLineSettings {
+    /**
+     * Define cache settings.
+     */
+    cache?: CacheSettings;
+}
 /**
  * To prevent the unwanted execution of untrusted code, WorkspaceTrustSettings
  * are use to set the trust levels.
@@ -341,6 +385,13 @@ export interface DictionaryDefinitionBase {
      * @default "S"
      */
     type?: DictionaryFileTypes;
+    /**
+     * Used in making suggestions. The lower the value, the more likely the suggestion
+     * will be near the top of the suggestion list.
+     *
+     * Added with `v5.16.0`.
+     */
+    suggestionEditCosts?: SuggestionCostsDefs;
 }
 export interface DictionaryDefinitionPreferred extends DictionaryDefinitionBase {
     /** Path to the file. */
@@ -439,7 +490,7 @@ export interface LanguageSettingFilterFieldsDeprecated {
 /** @hidden */
 declare type InternalRegExp = RegExp;
 export declare type Pattern = string | InternalRegExp;
-export declare type PredefinedPatterns = 'Base64' | 'CStyleComment' | 'CStyleHexValue' | 'CSSHexValue' | 'CommitHash' | 'CommitHashLink' | 'Email' | 'EscapeCharacters' | 'HexValues' | 'href' | 'PhpHereDoc' | 'PublicKey' | 'RsaCert' | 'SHA' | 'SpellCheckerDisable' | 'SpellCheckerDisableBlock' | 'SpellCheckerDisableLine' | 'SpellCheckerDisableNext' | 'SpellCheckerIgnoreInDocSetting' | 'string' | 'UnicodeRef' | 'Urls' | 'UUID' | 'Everything';
+export declare type PredefinedPatterns = 'Base64' | 'Base64MultiLine' | 'Base64SingleLine' | 'CStyleComment' | 'CStyleHexValue' | 'CSSHexValue' | 'CommitHash' | 'CommitHashLink' | 'Email' | 'EscapeCharacters' | 'HexValues' | 'href' | 'PhpHereDoc' | 'PublicKey' | 'RsaCert' | 'SshRsa' | 'SHA' | 'HashStrings' | 'SpellCheckerDisable' | 'SpellCheckerDisableBlock' | 'SpellCheckerDisableLine' | 'SpellCheckerDisableNext' | 'SpellCheckerIgnoreInDocSetting' | 'string' | 'UnicodeRef' | 'Urls' | 'UUID' | 'Everything';
 /** This matches the name in a pattern definition. */
 export declare type PatternId = string;
 /** A PatternRef is a Pattern or PatternId. */
@@ -541,8 +592,18 @@ export declare type LanguageIdMultiple = string;
  */
 export declare type LanguageIdMultipleNeg = string;
 export declare type LanguageId = LanguageIdSingle | LanguageIdMultiple | LanguageIdMultipleNeg;
-/** A File System Path. */
+/**
+ * A File System Path. Relative paths are relative to the configuration file.
+ */
 export declare type FsPath = string;
+/**
+ * A File System Path.
+ *
+ * Special Properties:
+ * - `${cwd}` prefix - will be replaced with the current working directory.
+ * - Relative paths are relative to the configuration file.
+ */
+export declare type FSPathResolvable = FsPath;
 /** Trust Security Level. */
 export declare type TrustLevel = 'trusted' | 'untrusted';
 /**

package/dist/configFields.d.ts

@@ -0,0 +1,7 @@
+import type { CSpellUserSettings } from './CSpellSettingsDef';
+export declare type ConfigKeys = Exclude<keyof CSpellUserSettings, '$schema' | 'version' | 'id'>;
+export declare type CSpellUserSettingsFields = {
+    [key in ConfigKeys]: key;
+};
+export declare const ConfigFields: CSpellUserSettingsFields;
+//# sourceMappingURL=configFields.d.ts.map

package/dist/configFields.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigFields = void 0;
+exports.ConfigFields = {
+    allowCompoundWords: 'allowCompoundWords',
+    cache: 'cache',
+    caseSensitive: 'caseSensitive',
+    description: 'description',
+    dictionaries: 'dictionaries',
+    dictionaryDefinitions: 'dictionaryDefinitions',
+    enabled: 'enabled',
+    enabledLanguageIds: 'enabledLanguageIds',
+    enableFiletypes: 'enableFiletypes',
+    enableGlobDot: 'enableGlobDot',
+    features: 'features',
+    files: 'files',
+    flagWords: 'flagWords',
+    gitignoreRoot: 'gitignoreRoot',
+    globRoot: 'globRoot',
+    ignorePaths: 'ignorePaths',
+    ignoreRegExpList: 'ignoreRegExpList',
+    ignoreWords: 'ignoreWords',
+    import: 'import',
+    includeRegExpList: 'includeRegExpList',
+    language: 'language',
+    languageId: 'languageId',
+    languageSettings: 'languageSettings',
+    maxDuplicateProblems: 'maxDuplicateProblems',
+    maxNumberOfProblems: 'maxNumberOfProblems',
+    minWordLength: 'minWordLength',
+    name: 'name',
+    noConfigSearch: 'noConfigSearch',
+    noSuggestDictionaries: 'noSuggestDictionaries',
+    numSuggestions: 'numSuggestions',
+    overrides: 'overrides',
+    patterns: 'patterns',
+    pnpFiles: 'pnpFiles',
+    readonly: 'readonly',
+    reporters: 'reporters',
+    showStatus: 'showStatus',
+    spellCheckDelayMs: 'spellCheckDelayMs',
+    suggestionNumChanges: 'suggestionNumChanges',
+    suggestionsTimeout: 'suggestionsTimeout',
+    useGitignore: 'useGitignore',
+    usePnP: 'usePnP',
+    userWords: 'userWords',
+    words: 'words',
+};
+// export const ConfigKeysNames = Object.values(ConfigKeysByField);
+//# sourceMappingURL=configFields.js.map

package/dist/features.d.ts

@@ -0,0 +1,38 @@
+/**
+ * These are experimental features and are subject to change or removal.
+ */
+export interface FeaturesExperimental {
+    /**
+     * Enable/disable using weighted suggestions.
+     */
+    'weighted-suggestions': FeatureEnableOnly;
+}
+/**
+ * These are the current set of active features
+ */
+export interface FeaturesActive {
+}
+/**
+ * These are feature settings that have been deprecated or moved elsewhere they will have no
+ * effect on the code but are here to prevent schema errors. The will get cleaned out on major versions.
+ */
+export interface FeaturesDeprecated {
+}
+/**
+ * Features are behaviors or settings that can be explicitly configured.
+ */
+export interface Features extends Partial<FeaturesActive>, Partial<FeaturesDeprecated>, Partial<FeaturesExperimental> {
+}
+export declare type Feature = FeatureEnableOnly | FeatureWithConfiguration;
+export declare type FeatureEnableOnly = boolean;
+/**
+ * Feature Configuration.
+ */
+export interface FeatureWithConfiguration {
+    enable: boolean;
+}
+export declare type FeatureNamesKnown = keyof Features;
+export declare type FeatureNamesExperimental = keyof FeaturesExperimental;
+export declare type FeatureNamesActive = keyof FeaturesActive;
+export declare type FeatureNamesDeprecated = keyof FeaturesDeprecated;
+//# sourceMappingURL=features.d.ts.map

package/dist/features.js

@@ -0,0 +1,4 @@
+"use strict";
+/* eslint-disable @typescript-eslint/no-empty-interface */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=features.js.map

package/dist/index.d.ts

@@ -1,4 +1,8 @@
-export * from './CSpellSettingsDef';
+export { ConfigFields } from './configFields';
+export type { CSpellUserSettingsFields } from './configFields';
 export * from './CSpellReporter';
-export * from './TextOffset';
+export * from './CSpellSettingsDef';
+export type { SuggestionCostMapDef, SuggestionCostsDefs } from './suggestionCostsDef';
+export type { TextDocumentOffset, TextOffset } from './TextOffset';
+export type { Features, Feature } from './features';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -10,7 +10,10 @@ 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 });
-__exportStar(require("./CSpellSettingsDef"), exports);
+exports.ConfigFields = void 0;
+// Using old-style of `type` exports because the new style breaks some integrations.
+var configFields_1 = require("./configFields");
+Object.defineProperty(exports, "ConfigFields", { enumerable: true, get: function () { return configFields_1.ConfigFields; } });
 __exportStar(require("./CSpellReporter"), exports);
-__exportStar(require("./TextOffset"), exports);
+__exportStar(require("./CSpellSettingsDef"), exports);
 //# sourceMappingURL=index.js.map

package/dist/suggestionCostsDef.d.ts

@@ -0,0 +1,71 @@
+/**
+ * A WeightedMapDef enables setting weights for edits between related characters and substrings.
+ *
+ * Multiple groups can be defined using a `|`.
+ * A multi-character substring is defined using `()`.
+ *
+ * For example, in some languages, some letters sound alike.
+ *
+ * ```ts
+ * {
+ *   map: 'sc(sh)(sch)(ss)|t(tt)', // two groups.
+ *   replace: 50, // Make it 1/2 the cost of a normal edit to replace a `t` with `tt`.
+ * }
+ * ```
+ *
+ * The following could be used to make inserting, removing, or replacing vowels cheaper.
+ * ```ts
+ * {
+ *   map: 'aeiouy', //.
+ *   insDel: 50, // Make it is cheaper to insert or delete a vowel.
+ *   replace: 45, // It is even cheaper to replace one with another.
+ * }
+ * ```
+ *
+ * Note: the default edit distance is 100.
+ */
+export declare type SuggestionCostMapDef = CostMapDefReplace | CostMapDefInsDel | CostMapDefSwap;
+export declare type SuggestionCostsDefs = SuggestionCostMapDef[];
+interface CostMapDefBase {
+    /**
+     * The set of substrings to map, these are generally single character strings.
+     *
+     * Multiple sets can be defined by using a `|` to separate them.
+     *
+     * Example: `"eéê|aåá"` contains two different sets.
+     *
+     * To add a multi-character substring use `()`.
+     *
+     * Example: `"f(ph)(gh)"` results in the following set: `f`, `ph`, `gh`.
+     */
+    map: string;
+    /** The cost to insert/delete one of the substrings in the map. Note: insert/delete costs are symmetrical. */
+    insDel?: number;
+    /**
+     * The cost to replace of of the substrings in the map with another substring in the map.
+     * Example: Map['a', 'i']
+     * This would be the cost to substitute `a` with `i`: Like `bat` to `bit` or the reverse.
+     */
+    replace?: number;
+    /**
+     * The cost to swap two adjacent substrings found in the map.
+     * Example: Map['e', 'i']
+     * This represents the cost to change `ei` to `ie` or the reverse.
+     */
+    swap?: number;
+    /**
+     * A description to describe the purpose of the map.
+     */
+    description?: string;
+}
+export interface CostMapDefReplace extends CostMapDefBase {
+    replace: number;
+}
+export interface CostMapDefInsDel extends CostMapDefBase {
+    insDel: number;
+}
+export interface CostMapDefSwap extends CostMapDefBase {
+    swap: number;
+}
+export {};
+//# sourceMappingURL=suggestionCostsDef.d.ts.map

package/dist/suggestionCostsDef.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=suggestionCostsDef.js.map

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "5.14.0",
+  "version": "5.15.3",
   "description": "Types for cspell and cspell-lib",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
@@ -19,6 +19,7 @@
     "build-dev": "tsc -p tsconfig.dev.json",
     "build-schema": "ts-json-schema-generator --no-top-ref --path src/CSpellSettingsDef.ts --type CSpellSettings --validation-keywords markdownDescription  --validation-keywords scope --validation-keywords deprecated --validation-keywords deprecationMessage -o  ./cspell.schema.json && cp ./cspell.schema.json ../..",
     "build-docs": "typedoc --out ../../docs/types/cspell-types src/index.ts",
+    "test-build-docs": "typedoc --out ./temp/docs src/index.ts",
     "clean-build": "npm run clean && npm run build",
     "compile": "tsc -p .",
     "test-schema": "ajv -s ./cspell.schema.json -d \"cspell.test.{json,yaml}\" -c ./ajv.config.js",
@@ -49,12 +50,12 @@
   },
   "devDependencies": {
     "ajv-cli": "^5.0.0",
-    "jest": "^27.4.5",
+    "jest": "^27.4.7",
     "rimraf": "^3.0.2",
     "ts-json-schema-generator": "^0.97.0",
-    "typedoc": "^0.22.10",
-    "typedoc-plugin-markdown": "^3.11.8",
+    "typedoc": "0.22.11",
+    "typedoc-plugin-markdown": "^3.11.12",
     "typescript": "^4.5.4"
   },
-  "gitHead": "8c8dfb70479584839e8035094771762f77118667"
+  "gitHead": "8a7c55b7d0b340d3c4e964ba91390a405f2cda2d"
 }