cspell 10.3.6 → 10.4.0

package/README.md

@@ -19,7 +19,7 @@ Please show your support through one of the following sites:
 ## Features
 
 - Spell Checks Code -- Parses code into words before checking them against the dictionaries.
-  - Supports CamelCase, snake\_case, and compoundwords naming styles.
+  - Supports CamelCase, snake_case, and compoundwords naming styles.
 - Self contained -- does not depend upon OS libraries like Hunspell or Aspell. Nor does it depend upon online services.
 - Fast -- checks 1000's of lines of code in seconds.
 - Programming Language Specific Dictionaries -- Has dedicated support for:
@@ -102,108 +102,130 @@ The `lint` command is used for spell checking files.
 cspell lint --help
 ```
 
+Help, and the tables from `cspell trace` and `cspell dictionaries`, fit the width of your terminal. To use a different
+width, set the `COLUMNS` environment variable:
+
+```sh
+COLUMNS=60 cspell lint --help
+```
+
 ### Options
 
 <!--- @@inject: static/help-lint.txt --->
 
 ```
-Usage: cspell lint [options] [globs...] [file://<path> ...] [stdin[://<path>]]
+Usage: cspell lint [options] [globs...] [file://<path> ...]
+                   [stdin[://<path>]]
 
 Patterns:
  - [globs...]            Glob Patterns
  - [stdin]               Read from "stdin" assume text file.
- - [stdin://<path>]      Read from "stdin", use <path> for file type and config.
+ - [stdin://<path>]      Read stdin; <path> sets file type and config.
  - [file://<path>]       Check the file at <path>
 
 Examples:
     cspell .                        Recursively check all files.
     cspell lint .                   The same as "cspell ."
-    cspell "*.js"                   Check all .js files in the current directory
+    cspell "*.js"                   Check .js files in this directory
     cspell "**/*.js"                Check all .js files recursively
     cspell "src/**/*.js"            Only check .js under src
     cspell "**/*.txt" "**/*.js"     Check both .js and .txt files.
     cspell "**/*.{txt,js,md}"       Check .txt, .js, and .md files.
     cat LICENSE | cspell stdin      Check stdin
-    cspell stdin://docs/doc.md      Check stdin as if it was "./docs/doc.md"
+    cspell stdin://docs/doc.md      Check stdin as "./docs/doc.md"
 
 Check spelling
 
 Options:
-  -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. Add more than one -v for increased
-                                 verbosity.
-  --locale <locale>              Set language locales. i.e. "en,fr" for English
-                                 and French, or "en-GB" for British English.
+  -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. Add more than one
+                                 -v for increased verbosity.
+  --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...].
-  --force-check                  Force the --file or --file-list documents to be
-                                 checked even if it would normally be excluded.
+  -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...].
+  --force-check                  Force the --file or --file-list
+                                 documents to be checked even if it
+                                 would normally be excluded.
+  --follow-symlinks              Allow checking --file and --file-list
+                                 documents referenced by symbolic links.
   --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.
+  --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.
+  --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-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.
+  --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.
+  --glob-symlinks                Follow symbolic links 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.
+  --gitignore-root <path>        Prevent searching for .gitignore files
+                                 past root.
   --validate-directives          Validate in-document CSpell directives.
-  --max-file-size <size>         Prevent checking large files. i.e 1MB, 50KB,
-                                 1GB
+  --max-file-size <size>         Prevent checking large files. i.e 1MB,
+                                 50KB, 1GB
   --color                        Force color.
   --no-color                     Turn off color.
-  --no-default-configuration     Do not load the default configuration and
-                                 dictionaries.
+  --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")
+  --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
@@ -226,7 +248,7 @@ More Examples:
 
     cspell "/*.md" --no-must-find-files --files $FILES
         Only spell check the "/*.md" files in $FILES,
-        where $FILES is a shell variable that contains the list of files.
+        where $FILES is a shell variable containing the list of files.
 
     cspell --help --verbose
         Show all options including hidden options.
@@ -275,26 +297,32 @@ Usage: cspell trace [options] [words...]
 Trace words -- Search for words in the configuration and dictionaries.
 
 Options:
-  -c, --config <cspell.json>  Configuration file to use.  By default cspell
-                              looks for cspell.json in the current directory.
-  --locale <locale>           Set language locales. i.e. "en,fr" for English and
-                              French, or "en-GB" for British English.
-  --language-id <language>    Use programming language. i.e. "php" or "scala".
+  -c, --config <cspell.json>  Configuration file to use.  By default
+                              cspell looks for cspell.json in the
+                              current directory.
+  --locale <locale>           Set language locales. i.e. "en,fr" for
+                              English and French, or "en-GB" for British
+                              English.
+  --language-id <language>    Use programming language. i.e. "php" or
+                              "scala".
   --allow-compound-words      Turn on allowCompoundWords
   --no-allow-compound-words   Turn off allowCompoundWords
-  --ignore-case               Ignore case and accents when searching for words.
-  --no-ignore-case            Do not ignore case and accents when searching for
+  --ignore-case               Ignore case and accents when searching for
                               words.
-  --dictionary <name>         Enable a dictionary by name. Can be used multiple
-                              times.
-  --no-dictionary <name>      Disable 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.)
+  --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.
+  --no-dictionary <name>      Disable 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.)
   --stdin                     Read words from stdin.
   --all                       Show all dictionaries.
-  --only-found                Show only dictionaries that have the words.
+  --only-found                Show only dictionaries that have the
+                              words.
   --color                     Force color.
   --no-color                  Turn off color.
   --no-default-configuration  Do not load the default configuration and
@@ -343,7 +371,7 @@ CSpell needs Node 22 and above.
 
 ## How it works
 
-The concept is simple: split camelCase and snake\_case words before checking them against a list of known words.
+The concept is simple: split camelCase and snake_case words before checking them against a list of known words.
 
 - `camelCase` -> `camel case`
 - `HTMLInput` -> `html input`
@@ -704,7 +732,7 @@ The spell checker includes a set of default dictionaries.
 
 ### General Dictionaries
 
-- **en\_US** - Derived from Hunspell US English words.
+- **en_US** - Derived from Hunspell US English words.
 - **en-gb** - Derived from Hunspell GB English words.
 - **companies** - List of well known companies
 - **softwareTerms** - Software Terms and concepts like "coroutine", "debounce", "tree", etc.

package/dist/esm/app.d.ts

@@ -1,18 +1,18 @@
-import { i as LinterCliOptions } from "./options-DlXe327y.js";
+import { i as LinterCliOptions } from "./options-D5lC3IZu.js";
 import { Command } from "commander";
 //#region src/util/errors.d.ts
-declare class CheckFailed extends Error {
+export declare class CheckFailed extends Error {
   readonly exitCode: number;
   constructor(message: string, exitCode?: number);
 }
-declare class ApplicationError extends Error {
+export declare class ApplicationError extends Error {
   readonly exitCode: number;
   readonly cause?: Error | undefined;
   constructor(message: string, exitCode?: number, cause?: Error | undefined);
 }
 //#endregion
 //#region src/app.d.mts
-declare function run(command?: Command, argv?: string[]): Promise<void>;
+export declare function run(command?: Command, argv?: string[]): Promise<void>;
 //#endregion
-export { ApplicationError, CheckFailed, type LinterCliOptions as Options, run };
+export type { LinterCliOptions as Options };
 //# sourceMappingURL=app.d.ts.map

package/dist/esm/app.js

@@ -1,4 +1,4 @@
-import { C as ApplicationError, S as width, T as console, _ as padLeft, a as parseApplicationFeatureFlags, b as pruneAnsiTextEnd, c as listDictionaries, d as validateUnitSize, f as unindent, g as tableToLines, i as lint, l as ReportChoicesAll, m as npmPackage, n as checkText, o as suggestions, p as DEFAULT_CACHE_LOCATION, r as createInit, s as trace, t as IncludeExcludeFlag, u as cvtLinterCliCommandOptionsToLinterCliOptions, v as padWidth, w as CheckFailed, x as pruneAnsiTextStart, y as ansiWidth } from "./application-yI9NNGsb.js";
+import { C as ApplicationError, S as width, T as console, _ as padLeft, a as parseApplicationFeatureFlags, b as pruneAnsiTextEnd, c as listDictionaries, d as validateUnitSize, f as unindent, g as tableToLines, i as lint, l as ReportChoicesAll, m as npmPackage, n as checkText, o as suggestions, p as DEFAULT_CACHE_LOCATION, r as createInit, s as trace, t as IncludeExcludeFlag, u as cvtLinterCliCommandOptionsToLinterCliOptions, v as padWidth, w as CheckFailed, x as pruneAnsiTextStart, y as ansiWidth } from "./application-IkKZuulS.js";
 import { Link } from "cspell-lib";
 import chalk from "chalk";
 import * as iPath from "node:path";
@@ -97,6 +97,19 @@ function crOpt(name, description, parseArg, defaultValue) {
 	return option;
 }
 //#endregion
+//#region src/util/outputWidth.ts
+/**
+* The width to format output for.
+* `COLUMNS` wins when it is a positive integer, otherwise the width of the stream if it has one.
+*/
+function getOutputWidth(stream = process.stdout, env = process.env) {
+	return parseColumns(env.COLUMNS) || stream.columns || void 0;
+}
+function parseColumns(value) {
+	if (!value || !/^\s*\d+\s*$/.test(value)) return void 0;
+	return Number.parseInt(value, 10) || void 0;
+}
+//#endregion
 //#region src/emitters/helpers.ts
 function trimMidPath(s, w, sep) {
 	if (s.length <= w) return s;
@@ -170,7 +183,7 @@ function calcListDictsResultsReport(results, options) {
 		table: tableToLines({
 			header,
 			rows,
-			terminalWidth: options.lineWidth || process.stdout.columns || maxWidth$1,
+			terminalWidth: options.lineWidth || getOutputWidth() || maxWidth$1,
 			deliminator: " ",
 			maxColumnWidths: {
 				locales: 12,
@@ -337,24 +350,25 @@ function commandLink(prog) {
 //#endregion
 //#region src/commandLint.ts
 const usage = `\
-[options] [globs...] [file://<path> ...] [stdin[://<path>]]
+[options] [globs...] [file://<path> ...]
+                   [stdin[://<path>]]
 
 Patterns:
  - [globs...]            Glob Patterns
  - [stdin]               Read from "stdin" assume text file.
- - [stdin://<path>]      Read from "stdin", use <path> for file type and config.
+ - [stdin://<path>]      Read stdin; <path> sets file type and config.
  - [file://<path>]       Check the file at <path>
 
 Examples:
     cspell .                        Recursively check all files.
     cspell lint .                   The same as "cspell ."
-    cspell "*.js"                   Check all .js files in the current directory
+    cspell "*.js"                   Check .js files in this directory
     cspell "**/*.js"                Check all .js files recursively
     cspell "src/**/*.js"            Only check .js under src
     cspell "**/*.txt" "**/*.js"     Check both .js and .txt files.
     cspell "**/*.{txt,js,md}"       Check .txt, .js, and .md files.
     cat LICENSE | cspell stdin      Check stdin
-    cspell stdin://docs/doc.md      Check stdin as if it was "./docs/doc.md"\
+    cspell stdin://docs/doc.md      Check stdin as "./docs/doc.md"\
 `;
 const advanced = `
 More Examples:
@@ -375,7 +389,7 @@ More Examples:
 
     cspell "/*.md" --no-must-find-files --files $FILES
         Only spell check the "/*.md" files in $FILES,
-        where $FILES is a shell variable that contains the list of files.
+        where $FILES is a shell variable containing the list of files.
 
     cspell --help --verbose
         Show all options including hidden options.
@@ -386,10 +400,10 @@ References:
 `;
 function commandLint(prog, opts) {
 	const spellCheckCommand = prog.command("lint", opts);
-	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.", void 0).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$1).option("-v, --verbose", "Display more information about the files being checked. Add more than one -v for increased verbosity.", increaseVerbosity, 0).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\"").addOption(crOpt("--languageId <file-type>", "Alias of \"--language-id\". Force programming language for unknown extensions. i.e. \"php\" or \"scala\"").hideHelp()).option("--words-only", "Only output the words not found in the dictionaries.").addOption(crOpt("--wordsOnly", "Only output the words not found in the dictionaries.").hideHelp()).option("-u, --unique", "Only output the first instance of a word not found in the dictionaries.").option("-e, --exclude <glob>", "Exclude files matching the glob pattern. This option can be used multiple times to add multiple globs. ", collect$1).option("--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.", collect$1).option("--file [file...]", "Specify files to spell check. They are filtered by the [globs...].", collect$1).addOption(crOpt("--files [file...]", "Alias of \"--file\". Files to spell check.", collect$1).hideHelp()).option("--force-check", "Force the --file or --file-list documents to be checked even if it would normally be excluded.").option("--no-issues", "Do not show the spelling errors.").option("--no-progress", "Turn off progress messages").option("--no-summary", "Turn off summary message in console.").option("-s, --silent", "Silent mode, suppress error messages.").option("--no-exit-code", "Do not return an exit code if issues are found.").addOption(crOpt("--quiet", "Only show spelling issues or errors.").implies({
+	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.", void 0).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$1).option("-v, --verbose", "Display more information about the files being checked. Add more than one -v for increased verbosity.", increaseVerbosity, 0).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\"").addOption(crOpt("--languageId <file-type>", "Alias of \"--language-id\". Force programming language for unknown extensions. i.e. \"php\" or \"scala\"").hideHelp()).option("--words-only", "Only output the words not found in the dictionaries.").addOption(crOpt("--wordsOnly", "Only output the words not found in the dictionaries.").hideHelp()).option("-u, --unique", "Only output the first instance of a word not found in the dictionaries.").option("-e, --exclude <glob>", "Exclude files matching the glob pattern. This option can be used multiple times to add multiple globs. ", collect$1).option("--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.", collect$1).option("--file [file...]", "Specify files to spell check. They are filtered by the [globs...].", collect$1).addOption(crOpt("--files [file...]", "Alias of \"--file\". Files to spell check.", collect$1).hideHelp()).option("--force-check", "Force the --file or --file-list documents to be checked even if it would normally be excluded.").option("--follow-symlinks", "Allow checking --file and --file-list documents referenced by symbolic links.").addOption(crOpt("--no-follow-symlinks", "Skip documents referenced by symbolic links.").default(void 0).hideHelp()).option("--no-issues", "Do not show the spelling errors.").option("--no-progress", "Turn off progress messages").option("--no-summary", "Turn off summary message in console.").option("-s, --silent", "Silent mode, suppress error messages.").option("--no-exit-code", "Do not return an exit code if issues are found.").addOption(crOpt("--quiet", "Only show spelling issues or errors.").implies({
 		summary: false,
 		progress: false
-	})).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.").option("--show-context", "Show the surrounding text around an issue.").option("--show-suggestions", "Show spelling suggestions.").addOption(crOpt("--no-show-suggestions", "Do not show spelling suggestions or fixes.").default(void 0)).addOption(crOpt("--must-find-files", "Error if no files are found.").default(true).hideHelp()).option("--no-must-find-files", "Do not error if no files are found.").addOption(crOpt("--legacy", "Legacy output").hideHelp()).addOption(crOpt("--local <local>", "Deprecated -- Use: --locale").hideHelp()).option("--cache", "Use cache to only check changed files.").option("--no-cache", "Do not use cache.").option("--cache-reset", "Reset the cache file.").addOption(crOpt("--cache-strategy <strategy>", "Strategy to use for detecting changed files.").choices(["content", "metadata"]).default("content")).option("--cache-location <path>", `Path to the cache file or directory. (default: "${DEFAULT_CACHE_LOCATION}")`).option("--dot", "Include files and directories starting with `.` (period) when matching globs.").option("--gitignore", "Ignore files matching glob patterns found in .gitignore files.").option("--no-gitignore", "Do NOT use .gitignore files.").option("--gitignore-root <path>", "Prevent searching for .gitignore files past root.", collect$1).option("--validate-directives", "Validate in-document CSpell directives.").addOption(crOpt("--no-validate-directives", "Do not validate in-document CSpell directives.").hideHelp()).option("--max-file-size <size>", "Prevent checking large files. i.e 1MB, 50KB, 1GB").addOption(crOpt("--color", "Force color.").default(void 0)).addOption(crOpt("--no-color", "Turn off color.").default(void 0)).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("--dictionary <name>", "Enable a dictionary by name.", collect$1).addOption(crOpt("--no-dictionary <name>", "Disable a dictionary by name. Can be used multiple times.", prefixCollect("!")).hideHelp()).option("--disable-dictionary <name>", "Disable a dictionary by name.", collect$1).option("--reporter <module|path>", "Specify one or more reporters to use.", collect$1).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()).usage(usage).addHelpText("after", augmentCommandHelp).arguments("[globs...]").action(action);
+	})).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.").option("--show-context", "Show the surrounding text around an issue.").option("--show-suggestions", "Show spelling suggestions.").addOption(crOpt("--no-show-suggestions", "Do not show spelling suggestions or fixes.").default(void 0)).addOption(crOpt("--must-find-files", "Error if no files are found.").default(true).hideHelp()).option("--no-must-find-files", "Do not error if no files are found.").addOption(crOpt("--legacy", "Legacy output").hideHelp()).addOption(crOpt("--local <local>", "Deprecated -- Use: --locale").hideHelp()).option("--cache", "Use cache to only check changed files.").option("--no-cache", "Do not use cache.").option("--cache-reset", "Reset the cache file.").addOption(crOpt("--cache-strategy <strategy>", "Strategy to use for detecting changed files.").choices(["content", "metadata"]).default("content")).option("--cache-location <path>", `Path to the cache file or directory. (default: "${DEFAULT_CACHE_LOCATION}")`).option("--dot", "Include files and directories starting with `.` (period) when matching globs.").option("--glob-symlinks", "Follow symbolic links when matching globs.").addOption(crOpt("--no-glob-symlinks", "Do not follow symbolic links when matching globs.").default(void 0).hideHelp()).option("--gitignore", "Ignore files matching glob patterns found in .gitignore files.").option("--no-gitignore", "Do NOT use .gitignore files.").option("--gitignore-root <path>", "Prevent searching for .gitignore files past root.", collect$1).option("--validate-directives", "Validate in-document CSpell directives.").addOption(crOpt("--no-validate-directives", "Do not validate in-document CSpell directives.").hideHelp()).option("--max-file-size <size>", "Prevent checking large files. i.e 1MB, 50KB, 1GB").addOption(crOpt("--color", "Force color.").default(void 0)).addOption(crOpt("--no-color", "Turn off color.").default(void 0)).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("--dictionary <name>", "Enable a dictionary by name.", collect$1).addOption(crOpt("--no-dictionary <name>", "Disable a dictionary by name. Can be used multiple times.", prefixCollect("!")).hideHelp()).option("--disable-dictionary <name>", "Disable a dictionary by name.", collect$1).option("--reporter <module|path>", "Specify one or more reporters to use.", collect$1).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()).usage(usage).addHelpText("after", augmentCommandHelp).arguments("[globs...]").action(action);
 	return spellCheckCommand;
 }
 async function action(fileGlobs, cliOptions) {
@@ -408,7 +422,12 @@ async function action(fileGlobs, cliOptions) {
 		this.outputHelp();
 		throw new CheckFailed("outputHelp", 1);
 	}
-	if (result.errors || mustFindFiles && !result.files) throw new CheckFailed("check failed", 1);
+	if (result.errors) throw new CheckFailed("check failed", 1);
+	const skippedFiles = result.skippedFiles || 0;
+	if (mustFindFiles && result.files <= skippedFiles) {
+		if (!options.silent) console.error(`No files found to check${skippedFiles ? ` (${skippedFiles} skipped)` : ""}.`);
+		throw new CheckFailed("no files found", 1);
+	}
 	if (result.issues) throw new CheckFailed("check failed", useExitCode ? 1 : 0);
 }
 function helpIssueTemplate(opts) {
@@ -449,17 +468,29 @@ function helpIssueTemplate(opts) {
 * @returns
 */
 function augmentCommandHelp(context) {
+	return lintHelpAfterOptions(context.command, "Hidden Options:");
+}
+/**
+* The extra lint help for `cspell --help`.
+* The program answers `--help` before the lint options are parsed, so parse them from its arguments.
+* @param context - the program's help context.
+* @param lintCommand - the lint command.
+*/
+function lintHelpForProgram(context, lintCommand) {
+	lintCommand.parseOptions(context.command.args);
+	return lintHelpAfterOptions(lintCommand, `Hidden options for "${lintCommand.name()}":`);
+}
+function lintHelpAfterOptions(command, hiddenOptionsHeading) {
 	const output = [];
-	const command = context.command;
 	const opts = command.opts();
 	const showHidden = !!opts.verbose;
 	const hiddenHelp = [];
 	const help = command.createHelp();
-	help.helpWidth = process.stdout.columns || 80;
+	help.helpWidth = getOutputWidth() || 80;
 	const hiddenOptions = command.options.filter((opt) => opt.hidden && showHidden);
 	const flagColWidth = Math.max(...command.options.map((opt) => opt.flags.length), 0);
 	for (const options of hiddenOptions) {
-		if (!hiddenHelp.length) hiddenHelp.push("\nHidden Options:");
+		if (!hiddenHelp.length) hiddenHelp.push("\n" + hiddenOptionsHeading);
 		hiddenHelp.push(help.formatItem(options.flags, flagColWidth, options.description, help));
 	}
 	output.push(...hiddenHelp, advanced);
@@ -592,7 +623,7 @@ function calcTraceResultsReport(word, found, results, options) {
 		table: tableToLines({
 			header,
 			rows,
-			terminalWidth: options.lineWidth || process.stdout.columns || maxWidth,
+			terminalWidth: options.lineWidth || getOutputWidth() || maxWidth,
 			deliminator: " "
 		}).map((line) => line.trimEnd()).join("\n"),
 		errors: emitErrors(results).join("\n")
@@ -728,9 +759,15 @@ async function run(command, argv) {
 	const prog = command || program;
 	const args = argv || process.argv;
 	prog.exitOverride();
+	prog.configureOutput({
+		getOutHelpWidth: () => getOutputWidth(process.stdout) ?? 80,
+		getErrHelpWidth: () => getOutputWidth(process.stderr) ?? 80
+	});
+	prog.configureHelp({ minWidthToWrap: 20 });
 	prog.version(npmPackage.version).description("Spelling Checker for Code").name("cspell");
 	if (!satisfies(process.versions.node, npmPackage.engines.node)) throw new ApplicationError(`Unsupported NodeJS version (${process.versions.node}); ${npmPackage.engines.node} is required`);
-	addGlobalOptionsToAction(commandLint(prog, { isDefault: true }));
+	const lintCommand = addGlobalOptionsToAction(commandLint(prog, { isDefault: true }));
+	prog.addHelpText("after", (context) => defaultCommandOptionsHelp(context, lintCommand) + lintHelpForProgram(context, lintCommand));
 	addGlobalOptionsToAction(commandTrace(prog));
 	addGlobalOptionsToAction(commandCheck(prog));
 	addGlobalOptionsToAction(commandSuggestion(prog));
@@ -741,6 +778,18 @@ async function run(command, argv) {
 	prog.exitOverride();
 	await prog.parseAsync(args);
 }
+/**
+* `cspell --help` is answered by the program, not the default command,
+* so list the default command's options here.
+*/
+function defaultCommandOptionsHelp(context, defaultCommand) {
+	const helper = defaultCommand.createHelp();
+	helper.prepareContext({ helpWidth: getOutputWidth(context.error ? process.stderr : process.stdout) ?? 80 });
+	const termWidth = helper.longestOptionTermLength(defaultCommand, helper);
+	const items = helper.visibleOptions(defaultCommand).filter((option) => option.long !== "--help").map((option) => helper.formatItem(helper.styleOptionTerm(helper.optionTerm(option)), termWidth, helper.styleOptionDescription(helper.optionDescription(option)), helper));
+	const heading = `Options for "${defaultCommand.name()}" (the default command):`;
+	return "\n" + helper.formatItemList(heading, items, helper).join("\n");
+}
 //#endregion
 export { ApplicationError, CheckFailed, run };
 

package/dist/esm/{application-094uTsvC.d.ts → application-CFfMlhE_.d.ts}

@@ -1,4 +1,4 @@
-import { a as SuggestionOptions, i as LinterCliOptions, n as DictionariesOptions, o as TraceOptions, r as LegacyOptions, t as BaseOptions } from "./options-DlXe327y.js";
+import { a as SuggestionOptions, i as LinterCliOptions, n as DictionariesOptions, o as TraceOptions, r as LegacyOptions, t as BaseOptions } from "./options-D5lC3IZu.js";
 import { CheckTextInfo, FeatureFlags, IncludeExcludeFlag, SuggestionsForWordResult, TraceResult, TraceWordResult } from "cspell-lib";
 import { CSpellReporter, RunResult } from "@cspell/cspell-types";
 //#region src/config/options.d.ts
@@ -106,7 +106,15 @@ interface ListDictionariesResult {
 declare function listDictionaries(options: DictionariesOptions): Promise<ListDictionariesResult[]>;
 //#endregion
 //#region src/application.d.mts
-type AppError = NodeJS.ErrnoException;
+/**
+ * The same shape as `NodeJS.ErrnoException`, declared here so the published types do not need `@types/node`.
+ */
+interface AppError extends Error {
+  errno?: number | undefined;
+  code?: string | undefined;
+  path?: string | undefined;
+  syscall?: string | undefined;
+}
 declare function lint(fileGlobs: string[], options: LinterCliOptions, reporter?: CSpellReporter): Promise<RunResult>;
 declare function trace(words: string[], options: TraceOptions): AsyncIterableIterator<TraceWordResult>;
 type CheckTextResult = CheckTextInfo;
@@ -116,4 +124,4 @@ declare function createInit(options: InitOptions): Promise<void>;
 declare function parseApplicationFeatureFlags(flags: string[] | undefined): FeatureFlags;
 //#endregion
 export { checkText as a, parseApplicationFeatureFlags as c, listDictionaries as d, TraceResult as i, suggestions as l, CheckTextResult as n, createInit as o, IncludeExcludeFlag as r, lint as s, AppError as t, trace as u };
-//# sourceMappingURL=application-094uTsvC.d.ts.map
+//# sourceMappingURL=application-CFfMlhE_.d.ts.map

package/dist/esm/{application-yI9NNGsb.js → application-IkKZuulS.js}

@@ -24,7 +24,7 @@ import { dynamicImport } from "@cspell/dynamic-import";
 import crypto from "node:crypto";
 import streamConsumers from "node:stream/consumers";
 import { getStat, readFileText, toURL } from "cspell-io";
-import { glob } from "tinyglobby";
+import { glob, isDynamicPattern } from "tinyglobby";
 import * as readline from "node:readline";
 import { parse, stringify } from "flatted";
 //#region src/console.ts
@@ -119,6 +119,107 @@ function toApplicationError(e, message) {
 	return new ApplicationError(message ?? err.message, void 0, err);
 }
 //#endregion
+//#region src/formatIssue.ts
+function formatIssue(io, templateStr, issue, maxIssueTextWidth) {
+	function clean(t) {
+		return t.replace(/\s+/, " ");
+	}
+	const { uri = "", filename, row, col, text, context = issue.line, offset } = issue;
+	const textLen = issue.length ?? text.length;
+	const contextLeft = clean(context.text.slice(0, offset - context.offset));
+	const contextRight = clean(context.text.slice(offset + textLen - context.offset));
+	const contextFull = clean(context.text);
+	const padContext = " ".repeat(Math.max(maxIssueTextWidth - text.length, 0));
+	const rowText = row.toString();
+	const colText = col.toString();
+	const padRowCol = " ".repeat(Math.max(1, 8 - (rowText.length + colText.length)));
+	const suggestions = formatSuggestions(io, issue);
+	const msg = issue.message || (issue.isFlagged ? "Forbidden word" : "Unknown word");
+	const messageColored = issue.isFlagged ? `{yellow ${msg}}` : msg;
+	const substitutions = {
+		$col: colText,
+		$contextFull: contextFull,
+		$contextLeft: contextLeft,
+		$contextRight: contextRight,
+		$filename: filename,
+		$padContext: padContext,
+		$padRowCol: padRowCol,
+		$row: rowText,
+		$suggestions: suggestions,
+		$text: text,
+		$uri: uri,
+		$quickFix: formatQuickFix(io, issue),
+		$message: msg,
+		$messageColored: messageColored
+	};
+	const t = templateStr.replaceAll("$messageColored", messageColored);
+	return substitute(makeTemplate(io.chalk)(t), substitutions).trimEnd();
+}
+function formatSuggestions(io, issue) {
+	if (issue.suggestionsEx) return issue.suggestionsEx.map((sug) => sug.isPreferred ? io.chalk.italic(io.chalk.bold(sug.wordAdjustedToMatchCase || sug.word)) + "*" : sug.wordAdjustedToMatchCase || sug.word).join(", ");
+	if (issue.suggestions) return issue.suggestions.join(", ");
+	return "";
+}
+function formatQuickFix(io, issue) {
+	if (!issue.suggestionsEx?.length) return "";
+	const preferred = issue.suggestionsEx.filter((sug) => sug.isPreferred).map((sug) => sug.wordAdjustedToMatchCase || sug.word);
+	if (!preferred.length) return "";
+	return `fix: (${preferred.map((w) => io.chalk.italic(io.chalk.yellow(w))).join(", ")})`;
+}
+function substitute(text, substitutions) {
+	const subs = [];
+	for (const [match, replaceWith] of Object.entries(substitutions)) {
+		const len = match.length;
+		for (let i = text.indexOf(match); i >= 0; i = text.indexOf(match, i)) {
+			const end = i + len;
+			const reg = /\b/y;
+			reg.lastIndex = end;
+			if (reg.test(text)) subs.push([
+				i,
+				end,
+				replaceWith
+			]);
+			i = end;
+		}
+	}
+	subs.sort((a, b) => a[0] - b[0]);
+	let i = 0;
+	function sub(r) {
+		const [a, b, t] = r;
+		const prefix = text.slice(i, a);
+		i = b;
+		return prefix + t;
+	}
+	return subs.map(sub).join("") + text.slice(i);
+}
+function checkTemplate(template) {
+	const chalk = new Chalk();
+	const chalkTemplate = makeTemplate(chalk);
+	const substitutions = {
+		$col: "<col>",
+		$contextFull: "<contextFull>",
+		$contextLeft: "<contextLeft>",
+		$contextRight: "<contextRight>",
+		$filename: "<filename>",
+		$padContext: "<padContext>",
+		$padRowCol: "<padRowCol>",
+		$row: "<row>",
+		$suggestions: "<suggestions>",
+		$text: "<text>",
+		$uri: "<uri>",
+		$quickFix: "<quickFix>",
+		$message: "<message>",
+		$messageColored: "<messageColored>"
+	};
+	try {
+		const problems = [...substitute(chalkTemplate(template), substitutions).matchAll(/\$[a-z]+/gi)].map((m) => m[0]);
+		if (problems.length) throw new Error(`Unresolved template variable${problems.length > 1 ? "s" : ""}: ${problems.map((v) => `'${v}'`).join(", ")}`);
+		return true;
+	} catch (e) {
+		return new ApplicationError(e instanceof Error ? e.message : `${e}`);
+	}
+}
+//#endregion
 //#region src/util/perfMeasurements.ts
 function getPerfMeasurements() {
 	const measurements = performance.getEntriesByType("measure");
@@ -805,109 +906,10 @@ function extractNotableBySelfTimeInGroup(measurements) {
 	if (highest) notable.add(highest);
 	return notable;
 }
-function formatIssue(io, templateStr, issue, maxIssueTextWidth) {
-	function clean(t) {
-		return t.replace(/\s+/, " ");
-	}
-	const { uri = "", filename, row, col, text, context = issue.line, offset } = issue;
-	const textLen = issue.length ?? text.length;
-	const contextLeft = clean(context.text.slice(0, offset - context.offset));
-	const contextRight = clean(context.text.slice(offset + textLen - context.offset));
-	const contextFull = clean(context.text);
-	const padContext = " ".repeat(Math.max(maxIssueTextWidth - text.length, 0));
-	const rowText = row.toString();
-	const colText = col.toString();
-	const padRowCol = " ".repeat(Math.max(1, 8 - (rowText.length + colText.length)));
-	const suggestions = formatSuggestions(io, issue);
-	const msg = issue.message || (issue.isFlagged ? "Forbidden word" : "Unknown word");
-	const messageColored = issue.isFlagged ? `{yellow ${msg}}` : msg;
-	const substitutions = {
-		$col: colText,
-		$contextFull: contextFull,
-		$contextLeft: contextLeft,
-		$contextRight: contextRight,
-		$filename: filename,
-		$padContext: padContext,
-		$padRowCol: padRowCol,
-		$row: rowText,
-		$suggestions: suggestions,
-		$text: text,
-		$uri: uri,
-		$quickFix: formatQuickFix(io, issue),
-		$message: msg,
-		$messageColored: messageColored
-	};
-	const t = templateStr.replaceAll("$messageColored", messageColored);
-	return substitute(makeTemplate(io.chalk)(t), substitutions).trimEnd();
-}
-function formatSuggestions(io, issue) {
-	if (issue.suggestionsEx) return issue.suggestionsEx.map((sug) => sug.isPreferred ? io.chalk.italic(io.chalk.bold(sug.wordAdjustedToMatchCase || sug.word)) + "*" : sug.wordAdjustedToMatchCase || sug.word).join(", ");
-	if (issue.suggestions) return issue.suggestions.join(", ");
-	return "";
-}
-function formatQuickFix(io, issue) {
-	if (!issue.suggestionsEx?.length) return "";
-	const preferred = issue.suggestionsEx.filter((sug) => sug.isPreferred).map((sug) => sug.wordAdjustedToMatchCase || sug.word);
-	if (!preferred.length) return "";
-	return `fix: (${preferred.map((w) => io.chalk.italic(io.chalk.yellow(w))).join(", ")})`;
-}
-function substitute(text, substitutions) {
-	const subs = [];
-	for (const [match, replaceWith] of Object.entries(substitutions)) {
-		const len = match.length;
-		for (let i = text.indexOf(match); i >= 0; i = text.indexOf(match, i)) {
-			const end = i + len;
-			const reg = /\b/y;
-			reg.lastIndex = end;
-			if (reg.test(text)) subs.push([
-				i,
-				end,
-				replaceWith
-			]);
-			i = end;
-		}
-	}
-	subs.sort((a, b) => a[0] - b[0]);
-	let i = 0;
-	function sub(r) {
-		const [a, b, t] = r;
-		const prefix = text.slice(i, a);
-		i = b;
-		return prefix + t;
-	}
-	return subs.map(sub).join("") + text.slice(i);
-}
 function assertCheckTemplate(template) {
 	const r = checkTemplate(template);
 	if (r instanceof Error) throw r;
 }
-function checkTemplate(template) {
-	const chalk = new Chalk();
-	const chalkTemplate = makeTemplate(chalk);
-	const substitutions = {
-		$col: "<col>",
-		$contextFull: "<contextFull>",
-		$contextLeft: "<contextLeft>",
-		$contextRight: "<contextRight>",
-		$filename: "<filename>",
-		$padContext: "<padContext>",
-		$padRowCol: "<padRowCol>",
-		$row: "<row>",
-		$suggestions: "<suggestions>",
-		$text: "<text>",
-		$uri: "<uri>",
-		$quickFix: "<quickFix>",
-		$message: "<message>",
-		$messageColored: "<messageColored>"
-	};
-	try {
-		const problems = [...substitute(chalkTemplate(template), substitutions).matchAll(/\$[a-z]+/gi)].map((m) => m[0]);
-		if (problems.length) throw new Error(`Unresolved template variable${problems.length > 1 ? "s" : ""}: ${problems.map((v) => `'${v}'`).join(", ")}`);
-		return true;
-	} catch (e) {
-		return new ApplicationError(e instanceof Error ? e.message : `${e}`);
-	}
-}
 //#endregion
 //#region src/config/adjustConfig.ts
 async function fileExists(url) {
@@ -1200,7 +1202,9 @@ const environmentKeys = {
 	CSPELL_ENABLE_DICTIONARY_LOG_FIELDS: "CSPELL_ENABLE_DICTIONARY_LOG_FIELDS",
 	CSPELL_GLOB_ROOT: "CSPELL_GLOB_ROOT",
 	CSPELL_CONFIG_PATH: "CSPELL_CONFIG_PATH",
-	CSPELL_DEFAULT_CONFIG_PATH: "CSPELL_DEFAULT_CONFIG_PATH"
+	CSPELL_DEFAULT_CONFIG_PATH: "CSPELL_DEFAULT_CONFIG_PATH",
+	CSPELL_FOLLOW_SYMLINKS: "CSPELL_FOLLOW_SYMLINKS",
+	CSPELL_GLOB_SYMLINKS: "CSPELL_GLOB_SYMLINKS"
 };
 function setEnvironmentVariable(key, value) {
 	process.env[key] = value;
@@ -1230,7 +1234,7 @@ try {
 const pkgDir = _dirname;
 const npmPackage = {
 	name: "cspell",
-	version: "10.3.6",
+	version: "10.4.0",
 	engines: { node: ">=22.18.0" }
 };
 //#endregion
@@ -1465,7 +1469,7 @@ async function globP(pattern, options) {
 		dot,
 		ignore,
 		absolute: true,
-		followSymbolicLinks: false,
+		followSymbolicLinks: options?.followSymlinks ?? false,
 		expandDirectories: false
 	});
 	const compare = new Intl.Collator("en").compare;
@@ -2322,6 +2326,48 @@ async function readConfigHandleError(filename) {
 	}
 }
 //#endregion
+//#region src/util/symlinks.ts
+function createSymlinkChecker(root) {
+	const rootPath = path$1.resolve(root);
+	const cache = /* @__PURE__ */ new Map();
+	function isSymlink(filename) {
+		let found = cache.get(filename);
+		if (!found) {
+			found = promises.lstat(filename).then((s) => s.isSymbolicLink(), () => false);
+			cache.set(filename, found);
+		}
+		return found;
+	}
+	async function isReachedThroughSymlink(filename) {
+		if (filename === "stdin" || isStdinUrl(filename)) return false;
+		const absFilename = path$1.resolve(rootPath, filename);
+		const rel = path$1.relative(rootPath, absFilename);
+		if (!rel) return false;
+		if (rel === ".." || rel.startsWith(".." + path$1.sep) || path$1.isAbsolute(rel)) return isSymlink(absFilename);
+		let current = rootPath;
+		for (const segment of rel.split(path$1.sep)) {
+			current = path$1.join(current, segment);
+			if (await isSymlink(current)) return true;
+		}
+		return false;
+	}
+	async function isGlobReachedThroughSymlink(pattern) {
+		const segments = pattern.split("/");
+		const fixed = [];
+		for (const segment of segments) {
+			if (isDynamicPattern(segment)) break;
+			fixed.push(segment);
+		}
+		const base = fixed.join("/");
+		if (!base) return false;
+		return isReachedThroughSymlink(path$1.resolve(rootPath, base));
+	}
+	return {
+		isReachedThroughSymlink,
+		isGlobReachedThroughSymlink
+	};
+}
+//#endregion
 //#region src/util/timer.ts
 function getTimeMeasurer() {
 	const timer = createPerfTimer("timer");
@@ -2721,13 +2767,30 @@ function prefetch(fileToProcess, cfg) {
 	const reportIssueOptions = extractReporterIssueOptions(cfg.config);
 	async function fetch() {
 		const getElapsedTimeMs = getTimeMeasurer();
+		if (!cfg.followSymlinks && await cfg.symlinks.isReachedThroughSymlink(filename)) {
+			const skipReason = "referenced by a symbolic link, use --follow-symlinks to check it";
+			if (cfg.forceCheck) return {
+				skip: true,
+				skipReason,
+				error: new LinterError(`File ${skipReason}: "${filename}"`)
+			};
+			return {
+				skip: true,
+				skipReason: cfg.verbose ? skipReason : void 0
+			};
+		}
 		const cachedResult = await cfg.cache.getCachedLintResults(filename);
 		if (cachedResult) return { fileResult: {
 			...cachedResult,
 			elapsedTimeMs: getElapsedTimeMs()
 		} };
 		const uri = filenameToUri(filename, cfg.root).href;
-		const checkResult = await shouldCheckDocument({ uri }, { forceCheck: cfg.forceCheck }, cfg.config);
+		const { languageId, locale } = cfg;
+		const checkResult = await shouldCheckDocument({
+			uri,
+			languageId,
+			locale
+		}, { forceCheck: cfg.forceCheck }, cfg.config);
 		if (!checkResult.shouldCheck) return {
 			skip: true,
 			skipReason: checkResult.reason || "Ignored by configuration."
@@ -2759,6 +2822,11 @@ async function processFiles(files, options) {
 		root: options.cfg.root,
 		maxFileSize: options.cfg.maxFileSize,
 		forceCheck: !!options.cfg.options.forceCheck,
+		symlinks: options.symlinks ?? createSymlinkChecker(options.cfg.root),
+		followSymlinks: !!options.followSymlinks,
+		verbose: options.verboseLevel > 0,
+		languageId: options.cfg.options.languageId || void 0,
+		locale: options.cfg.locale || void 0,
 		config: options.configInfo.config,
 		cache
 	};
@@ -2794,17 +2862,24 @@ async function processFiles(files, options) {
 		if (fetchResult instanceof Error) throw fetchResult;
 		const fileNum = sequence + 1;
 		reporter.emitProgressBegin(filename, fileNum, pf.sequenceSize ?? sequence);
-		if (fetchResult?.skip) return {
-			filename,
-			sequence,
-			sequenceSize,
-			result: {
+		if (fetchResult?.skip) {
+			const result = {
 				...emptyResult,
 				fileInfo: { filename },
 				elapsedTimeMs: getElapsedTimeMs(),
 				skippedReason: fetchResult.skipReason
+			};
+			if (fetchResult.error) {
+				new ReportItemCollector(result).error("Linter:", fetchResult.error);
+				result.errors = 1;
 			}
-		};
+			return {
+				filename,
+				sequence,
+				sequenceSize,
+				result
+			};
+		}
 		return {
 			filename,
 			sequence,
@@ -2860,7 +2935,7 @@ function runResult(init = {}) {
 	};
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.148.0/helpers/esm/usingCtx.js
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/usingCtx.js
 function _usingCtx() {
 	var r = "function" == typeof SuppressedError ? SuppressedError : function(r, e) {
 		var n = Error();
@@ -2969,7 +3044,8 @@ async function runLint(cfg) {
 					...cfg.options,
 					version
 				}, root);
-				const filesToCheck = await determineFilesToCheck(configInfo, cfg, reporter, globInfo);
+				const symlinks = createSymlinkChecker(root);
+				const filesToCheck = await determineFilesToCheck(configInfo, cfg, reporter, globInfo, symlinks);
 				const processFilesOptions = {
 					chalk,
 					configInfo,
@@ -2979,7 +3055,9 @@ async function runLint(cfg) {
 					configErrors,
 					userSettings: configInfo.config,
 					lintReporter: reporter,
-					cacheSettings
+					cacheSettings,
+					symlinks,
+					followSymlinks: filesToCheck.followSymlinks
 				};
 				const result = await processFiles(filesToCheck.files, processFilesOptions);
 				if (configErrorCount && cfg.options.exitCode !== false) result.errors ||= configErrorCount;
@@ -3060,10 +3138,11 @@ function filesToProcess(files) {
 		sequenceSize
 	}));
 }
-async function determineFilesToCheck(configInfo, cfg, reporter, globInfo) {
+async function determineFilesToCheck(configInfo, cfg, reporter, globInfo, symlinks) {
 	const result = {
 		files: [],
-		numFiles: 0
+		numFiles: 0,
+		followSymlinks: false
 	};
 	function countFiles(fnKeep) {
 		if (!fnKeep) return () => {
@@ -3081,6 +3160,13 @@ async function determineFilesToCheck(configInfo, cfg, reporter, globInfo) {
 	async function determineFilesToCheckFromCliFiles() {
 		const { fileLists } = cfg;
 		const hasFileLists = !!fileLists.length;
+		const followSymlinks = cfg.options.followSymlinks ?? truthy(getEnvironmentVariable("CSPELL_FOLLOW_SYMLINKS"));
+		result.followSymlinks = followSymlinks;
+		const keepSymlinks = (fn) => followSymlinks ? fn : async (file) => await symlinks.isReachedThroughSymlink(file) || fn(file);
+		if (!followSymlinks) for (const fileList of fileLists) {
+			if (fileList === "stdin") continue;
+			if (await symlinks.isReachedThroughSymlink(path$1.resolve(fileList))) throw new ApplicationError(`Error reading file list from: "${fileList}". It is referenced by a symbolic link, use --follow-symlinks to read it.`);
+		}
 		const { gitIgnore, allGlobs, excludeGlobs, normalizedExcludes } = globInfo;
 		const { root } = cfg;
 		const globsToExcludeRaw = [...configInfo.config.ignorePaths || [], ...excludeGlobs];
@@ -3100,8 +3186,8 @@ async function determineFilesToCheck(configInfo, cfg, reporter, globInfo) {
 		if (enableGlobDot !== void 0) globOptions.dot = enableGlobDot;
 		const includeFilterCountSkipped = countFiles(cfg.options.forceCheck && !cfg.fileGlobs.length ? () => true : createIncludeFileFilterFn(allGlobs, root, enableGlobDot));
 		const rawCliFiles = cfg.files?.map((file) => resolveFilename(file, root)).filter(includeFilterCountSkipped);
-		const cliFiles = cfg.options.mustFindFiles ? rawCliFiles : rawCliFiles && pipeAsync(rawCliFiles, opFilterAsync(isFile));
-		const foundFiles = hasFileLists ? concatAsyncIterables(cliFiles, await useFileLists(fileLists, includeFilterCountSkipped)) : cliFiles || [];
+		const cliFiles = cfg.options.mustFindFiles ? rawCliFiles : rawCliFiles && pipeAsync(rawCliFiles, opFilterAsync(keepSymlinks(isFile)));
+		const foundFiles = hasFileLists ? concatAsyncIterables(cliFiles, await useFileLists(fileLists, includeFilterCountSkipped, keepSymlinks(isNotDir))) : cliFiles || [];
 		const opFilterExcludedFiles = opFilter(filterOutExcludedFilesFn(globMatcher));
 		const filtered = !cfg.options.forceCheck && gitIgnore ? await gitIgnore.filterOutIgnored(foundFiles) : foundFiles;
 		return isAsyncIterable(filtered) ? pipeAsync(filtered, opFilterExcludedFiles, filesToProcessAsync) : filesToProcess(pipe(filtered, opFilterExcludedFiles));
@@ -3124,8 +3210,19 @@ async function determineFilesToCheck(configInfo, cfg, reporter, globInfo) {
 		};
 		const enableGlobDot = cfg.enableGlobDot ?? configInfo.config.enableGlobDot;
 		if (enableGlobDot !== void 0) globOptions.dot = enableGlobDot;
+		const globSymlinks = cfg.options.globSymlinks ?? truthy(getEnvironmentVariable("CSPELL_GLOB_SYMLINKS"));
+		globOptions.followSymlinks = globSymlinks;
+		result.followSymlinks = globSymlinks;
 		const opFilterExcludedFiles = opFilter(filterOutExcludedFilesFn(globMatcher));
-		const foundFiles = await findFiles(fileGlobs, globOptions);
+		const globsToSearch = [];
+		for (const glob of fileGlobs) {
+			if (!globSymlinks && await symlinks.isGlobReachedThroughSymlink(glob)) {
+				if (calcVerboseLevel(cfg.options) > 0) reporter.info(`Glob not searched: "${glob}" goes through a symbolic link.`, MessageTypes$1.Info);
+				continue;
+			}
+			globsToSearch.push(glob);
+		}
+		const foundFiles = await findFiles(globsToSearch, globOptions);
 		const filtered = gitIgnore ? await gitIgnore.filterOutIgnored(foundFiles) : foundFiles;
 		return isAsyncIterable(filtered) ? pipeAsync(filtered, opFilterExcludedFiles, filesToProcessAsync, opFilter(countFiles())) : filesToProcess(pipe(filtered, opFilterExcludedFiles)).filter(countFiles());
 	}
@@ -3192,9 +3289,9 @@ async function generateGitIgnore(roots) {
 	}
 	return new GitIgnore(root?.map((p) => path$1.resolve(p)));
 }
-async function useFileLists(fileListFiles, filterFiles) {
+async function useFileLists(fileListFiles, filterFiles, filterNotDir) {
 	const files = readFileListFiles(fileListFiles);
-	return pipeAsync(files, opFilter(filterFiles), opFilterAsync(isNotDir));
+	return pipeAsync(files, opFilter(filterFiles), opFilterAsync(filterNotDir));
 }
 function createIncludeFileFilterFn(includeGlobPatterns, root, dot) {
 	if (!includeGlobPatterns?.length) return () => true;
@@ -3569,4 +3666,4 @@ function parseApplicationFeatureFlags(flags) {
 //#endregion
 export { ApplicationError as C, width as S, console as T, padLeft as _, parseApplicationFeatureFlags as a, pruneAnsiTextEnd as b, listDictionaries as c, validateUnitSize as d, unindent as f, tableToLines as g, getReporter as h, lint as i, ReportChoicesAll as l, npmPackage as m, checkText as n, suggestions as o, DEFAULT_CACHE_LOCATION as p, createInit as r, trace as s, IncludeExcludeFlag as t, cvtLinterCliCommandOptionsToLinterCliOptions as u, padWidth as v, CheckFailed as w, pruneAnsiTextStart as x, ansiWidth as y };
 
-//# sourceMappingURL=application-yI9NNGsb.js.map
+//# sourceMappingURL=application-IkKZuulS.js.map

package/dist/esm/application.d.ts

@@ -1,2 +1,2 @@
-import { a as checkText, c as parseApplicationFeatureFlags, d as listDictionaries, i as TraceResult, l as suggestions, n as CheckTextResult, o as createInit, r as IncludeExcludeFlag, s as lint, t as AppError, u as trace } from "./application-094uTsvC.js";
+import { a as checkText, c as parseApplicationFeatureFlags, d as listDictionaries, i as TraceResult, l as suggestions, n as CheckTextResult, o as createInit, r as IncludeExcludeFlag, s as lint, t as AppError, u as trace } from "./application-CFfMlhE_.js";
 export { AppError, CheckTextResult, IncludeExcludeFlag, type TraceResult, checkText, createInit, lint, listDictionaries, parseApplicationFeatureFlags, suggestions, trace };

package/dist/esm/application.js

@@ -1,2 +1 @@
-import { a as parseApplicationFeatureFlags, c as listDictionaries, i as lint, n as checkText, o as suggestions, r as createInit, s as trace, t as IncludeExcludeFlag } from "./application-yI9NNGsb.js";
-export { IncludeExcludeFlag, checkText, createInit, lint, listDictionaries, parseApplicationFeatureFlags, suggestions, trace };
+export { t as IncludeExcludeFlag, n as checkText, r as createInit, i as lint, c as listDictionaries, a as parseApplicationFeatureFlags, o as suggestions, s as trace } from "./application-IkKZuulS.js";

package/dist/esm/index.d.ts

@@ -1,12 +1,21 @@
-import { i as LinterCliOptions, o as TraceOptions, s as FinalizedReporter, t as BaseOptions } from "./options-DlXe327y.js";
-import { a as checkText, c as parseApplicationFeatureFlags, d as listDictionaries, i as TraceResult, l as suggestions, n as CheckTextResult, o as createInit, r as IncludeExcludeFlag, s as lint, t as AppError, u as trace } from "./application-094uTsvC.js";
-import "chalk";
+import { i as LinterCliOptions, o as TraceOptions, s as FinalizedReporter, t as BaseOptions } from "./options-D5lC3IZu.js";
+import { a as checkText, c as parseApplicationFeatureFlags, d as listDictionaries, i as TraceResult, l as suggestions, n as CheckTextResult, o as createInit, r as IncludeExcludeFlag, s as lint, t as AppError, u as trace } from "./application-CFfMlhE_.js";
 import { CSpellReporter, ReporterConfiguration } from "@cspell/cspell-types";
-import { WriteStream } from "node:tty";
 export * from "@cspell/cspell-types";
 //#region src/console.d.ts
 type Log = (format?: any, ...params: any[]) => void;
-type IOStream = NodeJS.WritableStream & Pick<WriteStream, "isTTY" | "rows" | "columns"> & Pick<Partial<WriteStream>, "hasColors" | "clearLine" | "getColorDepth">;
+/**
+ * The parts of an output stream, such as `process.stdout`, that the console uses.
+ */
+interface IOStream {
+  write(chunk: string): boolean;
+  isTTY: boolean;
+  rows: number;
+  columns: number;
+  hasColors?(count?: number): boolean;
+  clearLine?(dir: -1 | 0 | 1, callback?: () => void): boolean;
+  getColorDepth?(env?: object): number;
+}
 interface IConsole {
   readonly log: Log;
   readonly error: Log;
@@ -43,5 +52,5 @@ interface ReporterOptions extends Pick<LinterCliOptions, "color" | "debug" | "is
 }
 declare function getReporter(options: ReporterOptions, config?: CSpellReporterConfiguration): FinalizedReporter;
 //#endregion
-export { AppError, type BaseOptions, type LinterCliOptions as CSpellApplicationOptions, type CSpellReporterConfiguration, type CSpellReporterModule, CheckTextResult, IncludeExcludeFlag, type TraceOptions, type TraceResult, checkText, createInit, getReporter as getDefaultReporter, lint, listDictionaries, parseApplicationFeatureFlags, suggestions, trace };
+export { type AppError, type BaseOptions, type LinterCliOptions as CSpellApplicationOptions, type CSpellReporterConfiguration, type CSpellReporterModule, type CheckTextResult, IncludeExcludeFlag, type TraceOptions, type TraceResult, checkText, createInit, getReporter as getDefaultReporter, lint, listDictionaries, parseApplicationFeatureFlags, suggestions, trace };
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.js

@@ -1,3 +1,2 @@
-import { a as parseApplicationFeatureFlags, c as listDictionaries, h as getReporter, i as lint, n as checkText, o as suggestions, r as createInit, s as trace, t as IncludeExcludeFlag } from "./application-yI9NNGsb.js";
+export { t as IncludeExcludeFlag, n as checkText, r as createInit, h as getDefaultReporter, i as lint, c as listDictionaries, a as parseApplicationFeatureFlags, o as suggestions, s as trace } from "./application-IkKZuulS.js";
 export * from "@cspell/cspell-types";
-export { IncludeExcludeFlag, checkText, createInit, getReporter as getDefaultReporter, lint, listDictionaries, parseApplicationFeatureFlags, suggestions, trace };

package/dist/esm/{options-DlXe327y.d.ts → options-D5lC3IZu.d.ts}

@@ -119,6 +119,23 @@ interface LinterOptions extends Omit<BaseOptions, "config">, Omit<CacheOptions,
    * Files must be found and processed otherwise it is considered an error.
    */
   mustFindFiles?: boolean;
+  /**
+   * Allow checking `--file` and `--file-list` documents referenced by symbolic links.
+   * By default, a file that is a symbolic link, or is in a linked directory, is skipped.
+   * Glob searches are controlled by {@link LinterOptions.globSymlinks}.
+   *
+   * When not set, the `CSPELL_FOLLOW_SYMLINKS` environment variable is used.
+   * @default false
+   */
+  followSymlinks?: boolean | undefined;
+  /**
+   * Follow symbolic links when matching globs.
+   * By default, glob searches skip files that are symbolic links and don't search linked directories.
+   *
+   * When not set, the `CSPELL_GLOB_SYMLINKS` environment variable is used.
+   * @default false
+   */
+  globSymlinks?: boolean | undefined;
   /**
    * List of dictionary names to use.
    */
@@ -407,4 +424,4 @@ interface CSpellConfigFile {
 }
 //#endregion
 export { SuggestionOptions as a, LinterCliOptions as i, DictionariesOptions as n, TraceOptions as o, LegacyOptions as r, FinalizedReporter as s, BaseOptions as t };
-//# sourceMappingURL=options-DlXe327y.d.ts.map
+//# sourceMappingURL=options-D5lC3IZu.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cspell",
-  "version": "10.3.6",
+  "version": "10.4.0",
   "description": "A Spelling Checker for Code!",
   "publishConfig": {
     "access": "public",
@@ -72,9 +72,9 @@
   "scripts": {
     "build": "tsdown && pnpm build:tsc",
     "build:readme": "pnpm build:readme:help",
-    "build:readme:help": "pnpm build:readme:help:lint && pnpm build:readme:help:trace && inject-markdown README.md && prettier -w README.md",
-    "build:readme:help:lint": "./bin.mjs lint --help > static/help-lint.txt",
-    "build:readme:help:trace": "./bin.mjs trace --help > static/help-trace.txt",
+    "build:readme:help": "pnpm build:readme:help:lint && pnpm build:readme:help:trace && inject-markdown --allow-outside-root ../.. README.md && prettier -w README.md",
+    "build:readme:help:lint": "COLUMNS=72 ./bin.mjs lint --help > static/help-lint.txt",
+    "build:readme:help:trace": "COLUMNS=72 ./bin.mjs trace --help > static/help-trace.txt",
     "build:tsc": "tsc -p .",
     "clean": "shx rm -rf dist temp coverage \"*.tsbuildInfo\"",
     "clean-build": "pnpm run clean && pnpm run build",
@@ -90,23 +90,23 @@
     "watch:tsc": "tsc -p . -w"
   },
   "dependencies": {
-    "@cspell/cspell-json-reporter": "10.3.6",
-    "@cspell/cspell-performance-monitor": "10.3.6",
-    "@cspell/cspell-pipe": "10.3.6",
-    "@cspell/cspell-types": "10.3.6",
-    "@cspell/cspell-worker": "10.3.6",
-    "@cspell/dynamic-import": "10.3.6",
-    "@cspell/url": "10.3.6",
-    "ansi-regex": "^6.3.0",
-    "chalk": "^6.0.0",
-    "chalk-template": "^1.1.2",
+    "@cspell/cspell-json-reporter": "10.4.0",
+    "@cspell/cspell-performance-monitor": "10.4.0",
+    "@cspell/cspell-pipe": "10.4.0",
+    "@cspell/cspell-types": "10.4.0",
+    "@cspell/cspell-worker": "10.4.0",
+    "@cspell/dynamic-import": "10.4.0",
+    "@cspell/url": "10.4.0",
+    "ansi-regex": "^6.4.0",
+    "chalk": "^6.0.1",
+    "chalk-template": "^1.1.3",
     "commander": "^15.0.0",
-    "cspell-config-lib": "10.3.6",
-    "cspell-dictionary": "10.3.6",
-    "cspell-gitignore": "10.3.6",
-    "cspell-glob": "10.3.6",
-    "cspell-io": "10.3.6",
-    "cspell-lib": "10.3.6",
+    "cspell-config-lib": "10.4.0",
+    "cspell-dictionary": "10.4.0",
+    "cspell-gitignore": "10.4.0",
+    "cspell-glob": "10.4.0",
+    "cspell-io": "10.4.0",
+    "cspell-lib": "10.4.0",
     "flatted": "^3.4.4",
     "semver": "^7.8.5",
     "tinyglobby": "^0.2.17"
@@ -120,5 +120,5 @@
   "engines": {
     "node": ">=22.18.0"
   },
-  "gitHead": "8559198ccfcac2f745911db1ffe2ee62c17cba49"
+  "gitHead": "7e2bbb5e866c827ac5d2cf6b84bf3e1a016d0823"
 }