cspell 9.0.2 → 9.1.0

package/README.md

@@ -132,65 +132,79 @@ Examples:
 Check spelling
 
 Options:
-  -c, --config <cspell.json>   Configuration file to use.  By default cspell
-                               looks for cspell.json in the current directory.
-  -v, --verbose                Display more information about the files being
-                               checked and the configuration.
-  --locale <locale>            Set language locales. i.e. "en,fr" for English
-                               and French, or "en-GB" for British English.
-  --language-id <file-type>    Force programming language for unknown
-                               extensions. i.e. "php" or "scala"
-  --words-only                 Only output the words not found in the
-                               dictionaries.
-  -u, --unique                 Only output the first instance of a word not
-                               found in the dictionaries.
-  -e, --exclude <glob>         Exclude files matching the glob pattern. This
-                               option can be used multiple times to add multiple
-                               globs.
-  --file-list <path or stdin>  Specify a list of files to be spell checked. The
-                               list is filtered against the glob file patterns.
-                               Note: the format is 1 file path per line.
-  --file [file...]             Specify files to spell check. They are filtered
-                               by the [globs...].
-  --no-issues                  Do not show the spelling errors.
-  --no-progress                Turn off progress messages
-  --no-summary                 Turn off summary message in console.
-  -s, --silent                 Silent mode, suppress error messages.
-  --no-exit-code               Do not return an exit code if issues are found.
-  --quiet                      Only show spelling issues or errors.
-  --fail-fast                  Exit after first file with an issue or error.
-  -r, --root <root folder>     Root directory, defaults to current directory.
-  --no-relative                Issues are displayed with absolute path instead
-                               of relative to the root.
-  --show-context               Show the surrounding text around an issue.
-  --show-suggestions           Show spelling suggestions.
-  --no-show-suggestions        Do not show spelling suggestions or fixes.
-  --no-must-find-files         Do not error if no files are found.
-  --cache                      Use cache to only check changed files.
-  --no-cache                   Do not use cache.
-  --cache-reset                Reset the cache file.
-  --cache-strategy <strategy>  Strategy to use for detecting changed files.
-                               (choices: "content", "metadata", default:
-                               "content")
-  --cache-location <path>      Path to the cache file or directory. (default:
-                               ".cspellcache")
-  --dot                        Include files and directories starting with `.`
-                               (period) when matching globs.
-  --gitignore                  Ignore files matching glob patterns found in
-                               .gitignore files.
-  --no-gitignore               Do NOT use .gitignore files.
-  --gitignore-root <path>      Prevent searching for .gitignore files past root.
-  --validate-directives        Validate in-document CSpell directives.
-  --color                      Force color.
-  --no-color                   Turn off color.
-  --no-default-configuration   Do not load the default configuration and
-                               dictionaries.
-  --debug                      Output information useful for debugging
-                               cspell.json files.
-  --reporter <module|path>     Specify one or more reporters to use.
-  --issue-template [template]  Use a custom issue template. See --help
-                               --issue-template for details.
-  -h, --help                   display help for command
+  -c, --config <cspell.json>     Configuration file to use.  By default cspell
+                                 looks for cspell.json in the current directory.
+  --no-config-search             Disable automatic searching for additional
+                                 configuration files in parent directories. Only
+                                 the specified config file (if any) will be
+                                 used.
+  --stop-config-search-at <dir>  Specify a directory at which to stop searching
+                                 for configuration files when walking up from
+                                 the files being checked. Useful for limiting
+                                 config inheritance.
+  -v, --verbose                  Display more information about the files being
+                                 checked and the configuration.
+  --locale <locale>              Set language locales. i.e. "en,fr" for English
+                                 and French, or "en-GB" for British English.
+  --language-id <file-type>      Force programming language for unknown
+                                 extensions. i.e. "php" or "scala"
+  --words-only                   Only output the words not found in the
+                                 dictionaries.
+  -u, --unique                   Only output the first instance of a word not
+                                 found in the dictionaries.
+  -e, --exclude <glob>           Exclude files matching the glob pattern. This
+                                 option can be used multiple times to add
+                                 multiple globs.
+  --file-list <path or stdin>    Specify a list of files to be spell checked.
+                                 The list is filtered against the glob file
+                                 patterns. Note: the format is 1 file path per
+                                 line.
+  --file [file...]               Specify files to spell check. They are filtered
+                                 by the [globs...].
+  --no-issues                    Do not show the spelling errors.
+  --no-progress                  Turn off progress messages
+  --no-summary                   Turn off summary message in console.
+  -s, --silent                   Silent mode, suppress error messages.
+  --no-exit-code                 Do not return an exit code if issues are found.
+  --quiet                        Only show spelling issues or errors.
+  --fail-fast                    Exit after first file with an issue or error.
+  --continue-on-error            Continue processing files even if there is a
+                                 configuration error.
+  -r, --root <root folder>       Root directory, defaults to current directory.
+  --no-relative                  Issues are displayed with absolute path instead
+                                 of relative to the root.
+  --show-context                 Show the surrounding text around an issue.
+  --show-suggestions             Show spelling suggestions.
+  --no-show-suggestions          Do not show spelling suggestions or fixes.
+  --no-must-find-files           Do not error if no files are found.
+  --cache                        Use cache to only check changed files.
+  --no-cache                     Do not use cache.
+  --cache-reset                  Reset the cache file.
+  --cache-strategy <strategy>    Strategy to use for detecting changed files.
+                                 (choices: "content", "metadata", default:
+                                 "content")
+  --cache-location <path>        Path to the cache file or directory. (default:
+                                 ".cspellcache")
+  --dot                          Include files and directories starting with `.`
+                                 (period) when matching globs.
+  --gitignore                    Ignore files matching glob patterns found in
+                                 .gitignore files.
+  --no-gitignore                 Do NOT use .gitignore files.
+  --gitignore-root <path>        Prevent searching for .gitignore files past
+                                 root.
+  --validate-directives          Validate in-document CSpell directives.
+  --color                        Force color.
+  --no-color                     Turn off color.
+  --no-default-configuration     Do not load the default configuration and
+                                 dictionaries.
+  --dictionary <name>            Enable a dictionary by name.
+  --disable-dictionary <name>    Disable a dictionary by name.
+  --reporter <module|path>       Specify one or more reporters to use.
+  --report <level>               Set how unknown words are reported (choices:
+                                 "all", "simple", "typos", "flagged")
+  --issue-template [template]    Use a custom issue template. See --help
+                                 --issue-template for details.
+  -h, --help                     display help for command
 
 More Examples:
 
@@ -212,6 +226,9 @@ More Examples:
         Only spell check the "/*.md" files in $FILES,
         where $FILES is a shell variable that contains the list of files.
 
+    cspell --help --verbose
+        Show all options including hidden options.
+
 References:
     https://cspell.org
     https://github.com/streetsidesoftware/cspell
@@ -266,6 +283,8 @@ Options:
   --ignore-case               Ignore case and accents when searching for words.
   --no-ignore-case            Do not ignore case and accents when searching for
                               words.
+  --dictionary <name>         Enable a dictionary by name. Can be used multiple
+                              times.
   --dictionary-path <format>  Configure how to display the dictionary path.
                               (choices: "hide", "short", "long", "full",
                               default: Display most of the path.)

package/dist/esm/app.mjs

@@ -1,6 +1,8 @@
 import { Option as CommanderOption, program } from 'commander';
 import { satisfies as semverSatisfies } from 'semver';
 import { commandCheck } from './commandCheck.js';
+import { commandDictionaries } from './commandDictionaries.js';
+import { commandInit } from './commandInit.js';
 import { commandLink } from './commandLink.js';
 import { commandLint } from './commandLint.js';
 import { commandSuggestion } from './commandSuggestion.js';
@@ -23,22 +25,9 @@ export async function run(command, argv) {
     commandTrace(prog).addOption(optionFlags);
     commandCheck(prog).addOption(optionFlags);
     commandSuggestion(prog).addOption(optionFlags);
+    commandInit(prog).addOption(optionFlags);
     commandLink(prog);
-    /*
-        program
-            .command('init')
-            .description('(Alpha) Initialize a cspell.json file.')
-            .option('-o, --output <cspell.json>', 'define where to write file.')
-            .option('--extends <cspell.json>', 'extend an existing cspell.json file.')
-            .action((options: InitOptions) => {
-                showHelp = false;
-                CSpellApplication.createInit(options).then(
-                    () => process.exit(0),
-                    () => process.exit(1)
-                );
-                console.log('Init');
-            });
-    */
+    commandDictionaries(prog);
     prog.exitOverride();
     await prog.parseAsync(args);
 }

package/dist/esm/application.d.mts

@@ -1,7 +1,9 @@
 import type { CSpellReporter, RunResult } from '@cspell/cspell-types';
 import type { CheckTextInfo, FeatureFlags, TraceWordResult } from 'cspell-lib';
+import { type InitOptions } from './config/index.js';
 import type { TimedSuggestionsForWordResult } from './emitters/suggestionsEmitter.js';
 import type { BaseOptions, LegacyOptions, LinterCliOptions, SuggestionOptions, TraceOptions } from './options.js';
+export { listDictionaries } from './dictionaries/index.js';
 export type { TraceResult } from 'cspell-lib';
 export { IncludeExcludeFlag } from 'cspell-lib';
 export type AppError = NodeJS.ErrnoException;
@@ -10,6 +12,6 @@ export declare function trace(words: string[], options: TraceOptions): AsyncIter
 export type CheckTextResult = CheckTextInfo;
 export declare function checkText(filename: string, options: BaseOptions & LegacyOptions): Promise<CheckTextResult>;
 export declare function suggestions(words: string[], options: SuggestionOptions): AsyncIterable<TimedSuggestionsForWordResult>;
-export declare function createInit(): Promise<void>;
+export declare function createInit(options: InitOptions): Promise<void>;
 export declare function parseApplicationFeatureFlags(flags: string[] | undefined): FeatureFlags;
 //# sourceMappingURL=application.d.mts.map

package/dist/esm/application.mjs

@@ -1,9 +1,10 @@
 import { opMap, opTap, pipeAsync, toAsyncIterable } from '@cspell/cspell-pipe';
 import { checkTextDocument, getDefaultSettings, getGlobalSettingsAsync, mergeSettings, SuggestionError, suggestionsForWords, traceWordsAsync, } from 'cspell-lib';
 import { getReporter } from './cli-reporter.js';
+import { configInit } from './config/index.js';
 import { console } from './console.js';
 import { getFeatureFlags, parseFeatureFlags } from './featureFlags/index.js';
-import { LintRequest, runLint } from './lint/index.js';
+import { extractUnknownWordsConfig, LintRequest, runLint } from './lint/index.js';
 import { fixLegacy } from './options.js';
 import { simpleRepl } from './repl/index.js';
 import { readConfig } from './util/configFileHelper.js';
@@ -12,11 +13,14 @@ import { finalizeReporter } from './util/reporters.js';
 import { readStdin } from './util/stdin.js';
 import { getTimeMeasurer } from './util/timer.js';
 import * as util from './util/util.js';
+export { listDictionaries } from './dictionaries/index.js';
 export { IncludeExcludeFlag } from 'cspell-lib';
 export function lint(fileGlobs, options, reporter) {
     options = fixLegacy(options);
-    const reporterOptions = { ...options, console };
-    const cfg = new LintRequest(fileGlobs, options, finalizeReporter(reporter) ?? getReporter({ ...options, fileGlobs }, reporterOptions));
+    const unknownWordsConfig = extractUnknownWordsConfig(options);
+    const useOptions = { ...options, ...unknownWordsConfig };
+    const reporterOptions = { ...useOptions, console };
+    const cfg = new LintRequest(fileGlobs, useOptions, finalizeReporter(reporter) ?? getReporter({ ...useOptions, fileGlobs }, reporterOptions));
     return runLint(cfg);
 }
 export async function* trace(words, options) {
@@ -25,7 +29,11 @@ export async function* trace(words, options) {
     const { languageId, locale, allowCompoundWords, ignoreCase } = options;
     const configFile = await readConfig(options.config, undefined);
     const loadDefault = options.defaultConfiguration ?? configFile.config.loadDefaultConfiguration ?? true;
-    const config = mergeSettings(await getDefaultSettings(loadDefault), await getGlobalSettingsAsync(), configFile.config);
+    const additionalSettings = {};
+    if (options.dictionary) {
+        additionalSettings.dictionaries = options.dictionary;
+    }
+    const config = mergeSettings(await getDefaultSettings(loadDefault), await getGlobalSettingsAsync(), configFile.config, additionalSettings);
     yield* traceWordsAsync(iWords, config, util.clean({ languageId, locale, ignoreCase, allowCompoundWords }));
 }
 export async function checkText(filename, options) {
@@ -75,8 +83,8 @@ export async function* suggestions(words, options) {
         process.exitCode = 1;
     }
 }
-export function createInit() {
-    return Promise.reject();
+export function createInit(options) {
+    return configInit(options);
 }
 function registerApplicationFeatureFlags() {
     const ff = getFeatureFlags();

package/dist/esm/cli-reporter.js

@@ -254,13 +254,14 @@ export function getReporter(options, config) {
         debug: emitters.Debug,
         progress,
         result: !silent && summary ? resultEmitter : nullEmitter,
+        features: undefined,
     };
 }
 function formatIssue(io, templateStr, issue, maxIssueTextWidth) {
     function clean(t) {
         return t.replace(/\s+/, ' ');
     }
-    const { uri = '', filename, row, col, text, context, offset } = issue;
+    const { uri = '', filename, row, col, text, context = issue.line, offset } = issue;
     const contextLeft = clean(context.text.slice(0, offset - context.offset));
     const contextRight = clean(context.text.slice(offset + text.length - context.offset));
     const contextFull = clean(context.text);

package/dist/esm/commandConfig.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function commandInit(prog: Command): Command;
+//# sourceMappingURL=commandConfig.d.ts.map

package/dist/esm/commandConfig.js

@@ -0,0 +1,18 @@
+import { collect, crOpt } from './commandHelpers.js';
+import { updateConfig } from './config/updateConfig.js';
+export function commandInit(prog) {
+    const command = prog
+        .command('config')
+        .description('Update a CSpell configuration file.')
+        .option('-c, --config <path>', 'Path to the CSpell configuration file.')
+        .option('--import <path|package>', 'Import a configuration file or dictionary package.', collect)
+        .option('--locale <locale>', 'Define the locale to use when spell checking (e.g., en, en-US, de).')
+        .addOption(crOpt('--dictionary <dictionary>', 'Enable a dictionary.', collect).default(undefined))
+        .addOption(crOpt('--comments', 'Add comments to the config file.').default(undefined).hideHelp())
+        .option('--no-comments', 'Do not add comments to the config file.')
+        .action((options) => {
+        return updateConfig(options);
+    });
+    return command;
+}
+//# sourceMappingURL=commandConfig.js.map

package/dist/esm/commandDictionaries.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function commandDictionaries(prog: Command): Command;
+//# sourceMappingURL=commandDictionaries.d.ts.map

package/dist/esm/commandDictionaries.js

@@ -0,0 +1,40 @@
+import * as App from './application.mjs';
+import { crOpt } from './commandHelpers.js';
+import { emitListDictionariesResults } from './emitters/dictionaryListEmitter.js';
+import { isDictionaryPathFormat } from './emitters/DictionaryPathFormat.js';
+import { canUseColor } from './util/canUseColor.js';
+// interface InitOptions extends Options {}
+export function commandDictionaries(prog) {
+    return prog
+        .command('dictionaries')
+        .description(`List dictionaries`)
+        .option('-c, --config <cspell.json>', 'Configuration file to use.  By default cspell looks for cspell.json in the current directory.')
+        .addOption(crOpt('--path-format <format>', 'Configure how to display the dictionary path.')
+        .choices(['hide', 'short', 'long', 'full'])
+        .default('long', 'Display most of the path.'))
+        .addOption(crOpt('--enabled', 'Show only enabled dictionaries.').default(undefined))
+        .addOption(crOpt('--no-enabled', 'Do not show enabled dictionaries.'))
+        .option('--locale <locale>', 'Set language locales. i.e. "en,fr" for English and French, or "en-GB" for British English.')
+        .option('--file-type <fileType>', 'File type to use. i.e. "html", "golang", or "javascript".')
+        .option('--no-show-location', 'Do not show the location of the dictionary.')
+        .option('--show-file-types', 'Show the file types supported by the dictionary.', false)
+        .addOption(crOpt('--no-show-file-types', 'Do not show the file types supported by the dictionary.').hideHelp())
+        .option('--show-locales', 'Show the language locales supported by the dictionary.', false)
+        .addOption(crOpt('--no-show-locales', 'Do not show the locales supported by the dictionary.').hideHelp())
+        .addOption(crOpt('--color', 'Force color.').default(undefined))
+        .addOption(crOpt('--no-color', 'Turn off color.').default(undefined))
+        .addOption(crOpt('--default-configuration', 'Load the default configuration and dictionaries.').hideHelp())
+        .addOption(crOpt('--no-default-configuration', 'Do not load the default configuration and dictionaries.'))
+        .action(async (options) => {
+        const dictionaryPathFormat = isDictionaryPathFormat(options.pathFormat) ? options.pathFormat : 'long';
+        const useColor = canUseColor(options.color);
+        const listResult = await App.listDictionaries(options);
+        emitListDictionariesResults(listResult, {
+            cwd: process.cwd(),
+            dictionaryPathFormat,
+            color: useColor,
+            options,
+        });
+    });
+}
+//# sourceMappingURL=commandDictionaries.js.map

package/dist/esm/commandHelpers.d.ts

@@ -0,0 +1,18 @@
+import { Option as CommanderOption } from 'commander';
+/**
+ * Collects string values into an array.
+ * @param value the new value(s) to collect.
+ * @param previous the previous values.
+ * @returns the new values appended to the previous values.
+ */
+export declare function collect(value: string | string[], previous: string[] | undefined): string[];
+/**
+ * Create Option - a helper function to create a commander option.
+ * @param name - the name of the option
+ * @param description - the description of the option
+ * @param parseArg - optional function to parse the argument
+ * @param defaultValue - optional default value
+ * @returns CommanderOption
+ */
+export declare function crOpt<T>(name: string, description: string, parseArg?: (value: string, previous: T) => T, defaultValue?: T): CommanderOption;
+//# sourceMappingURL=commandHelpers.d.ts.map

package/dist/esm/commandHelpers.js

@@ -0,0 +1,30 @@
+import { Option as CommanderOption } from 'commander';
+/**
+ * Collects string values into an array.
+ * @param value the new value(s) to collect.
+ * @param previous the previous values.
+ * @returns the new values appended to the previous values.
+ */
+export function collect(value, previous) {
+    const values = Array.isArray(value) ? value : [value];
+    return previous ? [...previous, ...values] : values;
+}
+/**
+ * Create Option - a helper function to create a commander option.
+ * @param name - the name of the option
+ * @param description - the description of the option
+ * @param parseArg - optional function to parse the argument
+ * @param defaultValue - optional default value
+ * @returns CommanderOption
+ */
+export function crOpt(name, description, parseArg, defaultValue) {
+    const option = new CommanderOption(name, description);
+    if (parseArg) {
+        option.argParser(parseArg);
+    }
+    if (defaultValue !== undefined) {
+        option.default(defaultValue);
+    }
+    return option;
+}
+//# sourceMappingURL=commandHelpers.js.map

package/dist/esm/commandInit.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function commandInit(prog: Command): Command;
+//# sourceMappingURL=commandInit.d.ts.map

package/dist/esm/commandInit.js

@@ -0,0 +1,25 @@
+import { createInit } from './application.mjs';
+import { collect, crOpt } from './commandHelpers.js';
+export function commandInit(prog) {
+    const command = prog
+        .command('init')
+        .description('Initialize a CSpell configuration file.')
+        .addOption(crOpt('-c, --config <path>', 'Path to the CSpell configuration file. Conflicts with --output and --format.').conflicts(['output', 'format']))
+        .option('-o, --output <path>', 'Define where to write file.')
+        .addOption(crOpt('--format <format>', 'Define the format of the file.')
+        .choices(['yaml', 'yml', 'json', 'jsonc'])
+        .default('yaml'))
+        .option('--import <path|package>', 'Import a configuration file or dictionary package.', collect)
+        .option('--locale <locale>', 'Define the locale to use when spell checking (e.g., en, en-US, de).')
+        .addOption(crOpt('--dictionary <dictionary>', 'Enable a dictionary. Can be used multiple times.', collect).default(undefined))
+        .addOption(crOpt('--comments', 'Add comments to the config file.').default(undefined).hideHelp())
+        .option('--no-comments', 'Do not add comments to the config file.')
+        .addOption(crOpt('--remove-comments', 'Remove all comments from the config file.').implies({ comments: false }))
+        .option('--no-schema', 'Do not add the schema reference to the config file.')
+        .option('--stdout', 'Write the configuration to stdout instead of a file.')
+        .action((options) => {
+        return createInit(options);
+    });
+    return command;
+}
+//# sourceMappingURL=commandInit.js.map

package/dist/esm/commandLint.js

@@ -1,5 +1,6 @@
-import { Option as CommanderOption } from 'commander';
 import * as App from './application.mjs';
+import { collect, crOpt } from './commandHelpers.js';
+import { ReportChoicesAll } from './options.js';
 import { DEFAULT_CACHE_LOCATION } from './util/cache/index.js';
 import { canUseColor } from './util/canUseColor.js';
 import { CheckFailed } from './util/errors.js';
@@ -46,19 +47,21 @@ More Examples:
         Only spell check the "/*.md" files in $FILES,
         where $FILES is a shell variable that contains the list of files.
 
+    cspell --help --verbose
+        Show all options including hidden options.
+
 References:
     https://cspell.org
     https://github.com/streetsidesoftware/cspell
 `;
-function collect(value, previous) {
-    const values = Array.isArray(value) ? value : [value];
-    return previous ? [...previous, ...values] : values;
-}
 export function commandLint(prog) {
     const spellCheckCommand = prog.command('lint', { isDefault: true });
     spellCheckCommand
         .description('Check spelling')
         .option('-c, --config <cspell.json>', 'Configuration file to use.  By default cspell looks for cspell.json in the current directory.')
+        .addOption(crOpt('--config-search', 'Allow searching for configuration files.', undefined).hideHelp())
+        .option('--no-config-search', 'Disable automatic searching for additional configuration files in parent directories. Only the specified config file (if any) will be used.')
+        .option('--stop-config-search-at <dir>', 'Specify a directory at which to stop searching for configuration files when walking up from the files being checked. Useful for limiting config inheritance.', collect)
         .option('-v, --verbose', 'Display more information about the files being checked and the configuration.')
         .option('--locale <locale>', 'Set language locales. i.e. "en,fr" for English and French, or "en-GB" for British English.')
         .option('--language-id <file-type>', 'Force programming language for unknown extensions. i.e. "php" or "scala"')
@@ -84,6 +87,7 @@ export function commandLint(prog) {
     }))
         .option('--fail-fast', 'Exit after first file with an issue or error.')
         .addOption(crOpt('--no-fail-fast', 'Process all files even if there is an error.').hideHelp())
+        .option('--continue-on-error', 'Continue processing files even if there is a configuration error.')
         .option('-r, --root <root folder>', 'Root directory, defaults to current directory.')
         .addOption(crOpt('--relative', 'Issues are displayed relative to the root.').default(true).hideHelp())
         .option('--no-relative', 'Issues are displayed with absolute path instead of relative to the root.')
@@ -120,17 +124,18 @@ export function commandLint(prog) {
         .addOption(crOpt('--no-color', 'Turn off color.').default(undefined))
         .addOption(crOpt('--default-configuration', 'Load the default configuration and dictionaries.').hideHelp())
         .addOption(crOpt('--no-default-configuration', 'Do not load the default configuration and dictionaries.'))
-        .option('--debug', 'Output information useful for debugging cspell.json files.')
+        .option('--dictionary <name>', 'Enable a dictionary by name.', collect)
+        .option('--disable-dictionary <name>', 'Disable a dictionary by name.', collect)
         .option('--reporter <module|path>', 'Specify one or more reporters to use.', collect)
+        .addOption(crOpt('--report <level>', 'Set how unknown words are reported').choices(ReportChoicesAll))
         .addOption(crOpt('--skip-validation', 'Collect and process documents, but do not spell check.')
         .implies({ cache: false })
         .hideHelp())
         .addOption(crOpt('--issues-summary-report', 'Output a summary of issues found.').hideHelp())
         .addOption(crOpt('--show-perf-summary', 'Output a performance summary report.').hideHelp())
         .option('--issue-template [template]', 'Use a custom issue template. See --help --issue-template for details.')
+        .addOption(crOpt('--debug', 'Output information useful for debugging cspell.json files.').hideHelp())
         // Planned options
-        // .option('--dictionary <dictionary name>', 'Enable a dictionary by name.', collect)
-        // .option('--no-dictionary <dictionary name>', 'Disable a dictionary by name.', collect)
         // .option('--import', 'Import a configuration file.', collect)
         .usage(usage)
         .addHelpText('after', augmentCommandHelp)
@@ -218,22 +223,4 @@ function augmentCommandHelp(context) {
     output.push(...hiddenHelp, advanced);
     return helpIssueTemplate(opts) + output.join('\n');
 }
-/**
- * Create Option - a helper function to create a commander option.
- * @param name - the name of the option
- * @param description - the description of the option
- * @param parseArg - optional function to parse the argument
- * @param defaultValue - optional default value
- * @returns CommanderOption
- */
-function crOpt(name, description, parseArg, defaultValue) {
-    const option = new CommanderOption(name, description);
-    if (parseArg) {
-        option.argParser(parseArg);
-    }
-    if (defaultValue !== undefined) {
-        option.default(defaultValue);
-    }
-    return option;
-}
 //# sourceMappingURL=commandLint.js.map

package/dist/esm/commandTrace.js

@@ -1,5 +1,6 @@
 import { Option as CommanderOption } from 'commander';
 import * as App from './application.mjs';
+import { collect } from './commandHelpers.js';
 import { console } from './console.js';
 import { isDictionaryPathFormat } from './emitters/DictionaryPathFormat.js';
 import { emitTraceResults } from './emitters/traceEmitter.js';
@@ -18,6 +19,7 @@ export function commandTrace(prog) {
         .option('--no-allow-compound-words', 'Turn off allowCompoundWords')
         .option('--ignore-case', 'Ignore case and accents when searching for words.')
         .option('--no-ignore-case', 'Do not ignore case and accents when searching for words.')
+        .option('--dictionary <name>', 'Enable a dictionary by name. Can be used multiple times.', collect)
         .addOption(new CommanderOption('--dictionary-path <format>', 'Configure how to display the dictionary path.')
         .choices(['hide', 'short', 'long', 'full'])
         .default('long', 'Display most of the path.'))

package/dist/esm/config/adjustConfig.d.ts

@@ -0,0 +1,7 @@
+import { CSpellSettings } from '@cspell/cspell-types';
+import { CSpellConfigFile } from 'cspell-config-lib';
+export declare function resolveImports(configFile: CSpellConfigFile, imports: string[]): Promise<string[]>;
+export declare function addImportsToConfigFile(configFile: CSpellConfigFile, imports: string[], comment: string | undefined): Promise<void>;
+export declare function setConfigFieldValue<K extends keyof CSpellSettings>(configFile: CSpellConfigFile, key: K, value: CSpellSettings[K], comment?: string | undefined): void;
+export declare function addDictionariesToConfigFile(configFile: CSpellConfigFile, dictionaries: string[], comment?: string | undefined): void;
+//# sourceMappingURL=adjustConfig.d.ts.map