cspell 9.3.1 → 9.4.0

package/README.md

@@ -146,7 +146,8 @@ Options:
                                  the files being checked. Useful for limiting
                                  config inheritance.
   -v, --verbose                  Display more information about the files being
-                                 checked and the configuration.
+                                 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
@@ -196,6 +197,8 @@ Options:
   --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
   --color                        Force color.
   --no-color                     Turn off color.
   --no-default-configuration     Do not load the default configuration and

package/dist/esm/app.d.ts

@@ -1,4 +1,4 @@
-import { i as LinterCliOptions } from "./options-BeJCICDB.js";
+import { i as LinterCliOptions } from "./options-D_PtlSKK.js";
 import { Command } from "commander";
 
 //#region src/util/errors.d.ts

package/dist/esm/app.js

@@ -1,11 +1,9 @@
-import { a as parseApplicationFeatureFlags, c as listDictionaries, d as npmPackage, h as console, i as lint, l as ReportChoicesAll, m as CheckFailed, n as checkText, o as suggestions, p as ApplicationError, r as createInit, s as trace, t as IncludeExcludeFlag, u as DEFAULT_CACHE_LOCATION } from "./application-D_X0oO_z.js";
-import { Option, program } from "commander";
-import { satisfies } from "semver";
-import chalk from "chalk";
+import { C as console, S as CheckFailed, _ as unindent, a as parseApplicationFeatureFlags, c as listDictionaries, d as ansiWidth, f as pruneAnsiTextEnd, g as validateUnitSize, h as width, i as lint, l as ReportChoicesAll, m as pruneTextEnd, n as checkText, o as suggestions, p as pruneAnsiTextStart, r as createInit, s as trace, t as IncludeExcludeFlag, u as cvtLinterCliCommandOptionsToLinterCliOptions, v as DEFAULT_CACHE_LOCATION, x as ApplicationError, y as npmPackage } from "./application-DCyfKhGm.js";
 import { Link } from "cspell-lib";
-import assert from "node:assert";
-import { stripVTControlCharacters } from "node:util";
+import chalk from "chalk";
 import * as iPath from "node:path";
+import { Option, program } from "commander";
+import { satisfies } from "semver";
 
 //#region src/commandCheck.ts
 function commandCheck(prog) {
@@ -77,146 +75,6 @@ function padLeft(s, w) {
 	if (!p) return s;
 	return s.padStart(p + s.length);
 }
-function isAnsiString(s) {
-	return s.includes("\x1B") || s.includes("›");
-}
-function width(s) {
-	assert(!s.includes("\x1B"), "String contains ANSI control characters");
-	return s.replaceAll(/[\u0000-\u001F\u0300-\u036F]/g, "").replaceAll(/[\uD800-\uDBFF][\uDC00-\uDFFF]/g, ".").replaceAll("…", ".").replaceAll(/\p{M}/gu, "").length;
-}
-function ansiWidth(s) {
-	return width(stripVTControlCharacters(s));
-}
-/**
-* Prune the end of a string to fit within a specified width, adding an ellipsis if necessary.
-* @param str - the text to prune - ANSI is not supported
-* @param maxWidth - the maximum width of the text
-* @param pad - the string to use for padding, default is '…'
-* @returns the pruned text
-*/
-function pruneTextEnd(str, maxWidth$2, pad$1 = "…") {
-	if (!maxWidth$2 || maxWidth$2 <= 0) return str;
-	if (str.length <= maxWidth$2) return str;
-	if (isAnsiString(str)) return pruneAnsiTextEnd(str, maxWidth$2, pad$1);
-	const maxWidthWithPad = maxWidth$2 - width(pad$1);
-	const letters = [...str];
-	let len = 0;
-	for (let i = 0; i < letters.length; i++) {
-		const c = letters[i];
-		len += width(c);
-		if (len > maxWidthWithPad) {
-			let j = i + 1;
-			while (j < letters.length && width(letters[j]) === 0) ++j;
-			return j === letters.length ? str : letters.slice(0, i).join("") + pad$1;
-		}
-	}
-	return str;
-}
-/**
-* Prune the start of a string to fit within a specified width, adding an ellipsis if necessary.
-* @param str - the text to prune - ANSI is not supported
-* @param maxWidth - the maximum width of the text
-* @param pad - the string to use for padding, default is '…'
-* @returns the pruned text
-*/
-function pruneTextStart(str, maxWidth$2, pad$1 = "…") {
-	if (!maxWidth$2 || maxWidth$2 <= 0) return str;
-	if (str.length <= maxWidth$2) return str;
-	const maxWidthWithPad = maxWidth$2 - width(pad$1);
-	const letters = [...str];
-	let len = 0;
-	for (let i = letters.length - 1; i >= 1; i--) {
-		const c = letters[i];
-		len += width(c);
-		if (len > maxWidthWithPad) {
-			i += 1;
-			while (i < letters.length && width(letters[i]) === 0) ++i;
-			return pad$1 + letters.slice(i).join("");
-		}
-	}
-	return str;
-}
-const ansi = new RegExp("[\\u001B\\u009B][[\\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\\d\\/\\#&.:=?%@~_]+)*|[a-zA-Z\\d]+(?:;[-a-zA-Z\\d\\/\\#&.:=?%@~_]*)*)?(?:\\u0007|\\u001B\\u005C|\\u009C))|(?:(?:\\d{1,4}(?:;\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]))", "g");
-function parseAnsiStr(str) {
-	const fragments = [];
-	let lastIndex = 0;
-	for (const match of str.matchAll(ansi)) {
-		if (match.index > lastIndex) fragments.push({
-			type: "text",
-			text: str.slice(lastIndex, match.index)
-		});
-		fragments.push({
-			type: "ansi",
-			text: match[0]
-		});
-		lastIndex = match.index + match[0].length;
-	}
-	if (lastIndex < str.length) fragments.push({
-		type: "text",
-		text: str.slice(lastIndex)
-	});
-	return fragments;
-}
-/**
-* Prune the end of a string to fit within a specified width, adding an ellipsis if necessary.
-* @param str - the text to prune - ANSI is supported
-* @param maxWidth - the maximum width of the text
-* @param pad - the string to use for padding, default is '…'
-* @returns the pruned text
-*/
-function pruneAnsiTextEnd(str, maxWidth$2, pad$1 = "…") {
-	if (!maxWidth$2 || maxWidth$2 <= 0) return str;
-	if (str.length <= maxWidth$2) return str;
-	if (ansiWidth(str) <= maxWidth$2) return str;
-	const padWidth$1 = ansiWidth(pad$1);
-	const fragments = parseAnsiStr(str);
-	let remaining = maxWidth$2 - padWidth$1;
-	for (const frag of fragments) {
-		if (frag.type !== "text") continue;
-		if (remaining <= 0) {
-			frag.text = "";
-			continue;
-		}
-		const pruned = pruneTextEnd(frag.text, remaining, pad$1);
-		if (pruned !== frag.text) {
-			frag.text = pruned;
-			remaining = 0;
-			continue;
-		}
-		remaining -= width(frag.text);
-	}
-	return fragments.map((frag) => frag.text).join("");
-}
-/**
-* Prune the start of a string to fit within a specified width, adding an ellipsis if necessary.
-* @param str - the text to prune - ANSI is supported
-* @param maxWidth - the maximum width of the text
-* @param pad - the string to use for padding, default is '…'
-* @returns the pruned text
-*/
-function pruneAnsiTextStart(str, maxWidth$2, pad$1 = "…") {
-	if (!maxWidth$2 || maxWidth$2 <= 0) return str;
-	if (str.length <= maxWidth$2) return str;
-	if (ansiWidth(str) <= maxWidth$2) return str;
-	const padWidth$1 = ansiWidth(pad$1);
-	const fragments = parseAnsiStr(str);
-	let remaining = maxWidth$2 - padWidth$1;
-	for (const frag of fragments.reverse()) {
-		if (frag.type !== "text") continue;
-		if (remaining <= 0) {
-			frag.text = "";
-			continue;
-		}
-		const pruned = pruneTextStart(frag.text, remaining, pad$1);
-		if (pruned !== frag.text) {
-			frag.text = pruned;
-			remaining = 0;
-			continue;
-		}
-		remaining -= width(frag.text);
-	}
-	return fragments.reverse().map((frag) => frag.text).join("");
-}
 
 //#endregion
 //#region src/util/table.ts
@@ -354,13 +212,13 @@ function trimMid(s, w) {
 	const r = Math.ceil((w - 1) / 2);
 	return s.slice(0, l) + "…" + s.slice(-r);
 }
-function formatDictionaryLocation(dictSource, maxWidth$2, { cwd, dictionaryPathFormat: format$1, iPath: iPath$1 }) {
+function formatDictionaryLocation(dictSource, maxWidth$2, { cwd, dictionaryPathFormat: format, iPath: iPath$1 }) {
 	let relPath = cwd ? iPath$1.relative(cwd, dictSource) : dictSource;
 	const idxNodeModule = relPath.lastIndexOf("node_modules");
 	const isNodeModule = idxNodeModule >= 0;
-	if (format$1 === "hide") return "";
-	if (format$1 === "short") return (isNodeModule ? "[node_modules]/" : relPath.startsWith(".." + iPath$1.sep + "..") ? "…/" : relPath.startsWith(".." + iPath$1.sep) ? "../" : "") + iPath$1.basename(dictSource);
-	if (format$1 === "full") return dictSource;
+	if (format === "hide") return "";
+	if (format === "short") return (isNodeModule ? "[node_modules]/" : relPath.startsWith(".." + iPath$1.sep + "..") ? "…/" : relPath.startsWith(".." + iPath$1.sep) ? "../" : "") + iPath$1.basename(dictSource);
+	if (format === "full") return dictSource;
 	relPath = isNodeModule ? relPath.slice(idxNodeModule) : relPath;
 	return trimMidPath(relPath.length < dictSource.length ? relPath : dictSource, maxWidth$2, iPath$1.sep);
 }
@@ -555,60 +413,6 @@ function commandLink(prog) {
 	return linkCommand;
 }
 
-//#endregion
-//#region src/util/unindent.ts
-/**
-* Inject values into a template string.
-* @param {TemplateStringsArray} template
-* @param  {...any} values
-* @returns
-*/
-function _inject(template, ...values) {
-	const strings = template;
-	const adjValues = [];
-	for (let i = 0; i < values.length; ++i) {
-		const prevLines = strings[i].split("\n");
-		const currLine = prevLines[prevLines.length - 1];
-		const padLen = padLength(currLine);
-		const padding = " ".repeat(padLen);
-		const value = `${values[i]}`;
-		let pad$1 = "";
-		const valueLines = [];
-		for (const line of value.split("\n")) {
-			valueLines.push(pad$1 + line);
-			pad$1 = padding;
-		}
-		adjValues.push(valueLines.join("\n"));
-	}
-	return _unindent(String.raw({ raw: strings }, ...adjValues));
-}
-/**
-* Calculate the padding at the start of the string.
-* @param {string} s
-* @returns {number}
-*/
-function padLength(s) {
-	return s.length - s.trimStart().length;
-}
-function unindent(template, ...values) {
-	if (typeof template === "string") return _unindent(template);
-	return _inject(template, ...values);
-}
-/**
-* Remove the left padding from a multi-line string.
-* @param {string} str
-* @returns {string}
-*/
-function _unindent(str) {
-	const lines = str.split("\n");
-	let curPad = str.length;
-	for (const line of lines) {
-		if (!line.trim()) continue;
-		curPad = Math.min(curPad, padLength(line));
-	}
-	return lines.map((line) => line.slice(curPad)).join("\n");
-}
-
 //#endregion
 //#region src/commandLint.ts
 const usage = `\
@@ -661,24 +465,28 @@ 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).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\"").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).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).option("--file [file...]", "Specify files to spell check. They are filtered by the [globs...].", collect).addOption(crOpt("--files [file...]", "Alias of \"--file\". Files to spell check.", collect).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({
+	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).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).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).option("--file [file...]", "Specify files to spell check. They are filtered by the [globs...].", collect).addOption(crOpt("--files [file...]", "Alias of \"--file\". Files to spell check.", collect).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).option("--validate-directives", "Validate in-document CSpell directives.").addOption(crOpt("--no-validate-directives", "Do not validate in-document CSpell directives.").hideHelp()).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).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()).usage(usage).addHelpText("after", augmentCommandHelp).arguments("[globs...]").action(async (fileGlobs, options) => {
-		const useExitCode = options.exitCode ?? true;
-		if (options.skipValidation) options.cache = false;
-		options.color ??= canUseColor(options.color);
-		const { mustFindFiles, fileList, files, file } = options;
-		const result = await lint(fileGlobs, options);
-		if (!fileGlobs.length && !result.files && !result.errors && !fileList && !files?.length && !file?.length) {
-			spellCheckCommand.outputHelp();
-			throw new CheckFailed("outputHelp", 1);
-		}
-		if (result.errors || mustFindFiles && !result.files) throw new CheckFailed("check failed", 1);
-		if (result.issues) throw new CheckFailed("check failed", useExitCode ? 1 : 0);
-	});
+	})).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).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).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()).usage(usage).addHelpText("after", augmentCommandHelp).arguments("[globs...]").action(action);
 	return spellCheckCommand;
 }
+async function action(fileGlobs, cliOptions) {
+	const options = cvtLinterCliCommandOptionsToLinterCliOptions(cliOptions);
+	const useExitCode = options.exitCode ?? true;
+	if (options.skipValidation) options.cache = false;
+	options.color ??= canUseColor(options.color);
+	const maxFileSizeErr = validateMaxFileSize(options.maxFileSize);
+	if (maxFileSizeErr) this.error(`error: invalid option value for --max-file-size: ${maxFileSizeErr}`);
+	const { mustFindFiles, fileList, files, file } = options;
+	const result = await lint(fileGlobs, options);
+	if (!fileGlobs.length && !result.files && !result.errors && !fileList && !files?.length && !file?.length) {
+		this.outputHelp();
+		throw new CheckFailed("outputHelp", 1);
+	}
+	if (result.errors || mustFindFiles && !result.files) throw new CheckFailed("check failed", 1);
+	if (result.issues) throw new CheckFailed("check failed", useExitCode ? 1 : 0);
+}
 function helpIssueTemplate(opts) {
 	if (!("issueTemplate" in opts)) return "";
 	return unindent`
@@ -733,6 +541,13 @@ function augmentCommandHelp(context) {
 	output.push(...hiddenHelp, advanced);
 	return helpIssueTemplate(opts) + output.join("\n");
 }
+function validateMaxFileSize(size) {
+	if (!size) return void 0;
+	return validateUnitSize(size);
+}
+function increaseVerbosity(_dummyValue, previous) {
+	return previous + 1;
+}
 
 //#endregion
 //#region src/emitters/suggestionsEmitter.ts

package/dist/esm/{application-B84gvlDU.d.ts → application-Ce_s5c1d.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-BeJCICDB.js";
+import { a as SuggestionOptions, i as LinterCliOptions, n as DictionariesOptions, o as TraceOptions, r as LegacyOptions, t as BaseOptions } from "./options-D_PtlSKK.js";
 import { CheckTextInfo, FeatureFlags, IncludeExcludeFlag, SuggestionsForWordResult, TraceResult, TraceWordResult } from "cspell-lib";
 import { CSpellReporter, RunResult } from "@cspell/cspell-types";
 
@@ -113,4 +113,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-B84gvlDU.d.ts.map
+//# sourceMappingURL=application-Ce_s5c1d.d.ts.map

package/dist/esm/{application-D_X0oO_z.js → application-DCyfKhGm.js}

@@ -1,11 +1,11 @@
 import { createRequire } from "node:module";
-import chalk, { Chalk } from "chalk";
 import { isAsyncIterable, opFilter, opMap, opTap, operators, pipeAsync, pipeAsync as asyncPipe, toAsyncIterable, toAsyncIterable as mergeAsyncIterables } from "@cspell/cspell-pipe";
 import * as cspell from "cspell-lib";
 import { ENV_CSPELL_GLOB_ROOT, IncludeExcludeFlag, SuggestionError, Text, checkTextDocument, combineTextAndLanguageSettings, createPerfTimer, extractDependencies, extractImportErrors, fileToDocument, getDefaultSettings, getDictionary, getGlobalSettingsAsync, getSystemFeatureFlags, isBinaryFile, isSpellingDictionaryLoadError, mergeSettings, setLogger, shouldCheckDocument, spellCheckDocument, suggestionsForWords, traceWordsAsync } from "cspell-lib";
 import assert from "node:assert";
-import { format, formatWithOptions } from "node:util";
+import { format, formatWithOptions, stripVTControlCharacters } from "node:util";
 import { isUrlLike, toFileDirURL, toFilePathOrHref, toFileURL, urlRelative } from "@cspell/url";
+import chalk, { Chalk } from "chalk";
 import { makeTemplate } from "chalk-template";
 import fs, { stat } from "node:fs/promises";
 import { MutableCSpellConfigFile, createReaderWriter, cspellConfigFileSchema, isCfgArrayNode } from "cspell-config-lib";
@@ -20,11 +20,12 @@ import { GitIgnore, findRepoRoot } from "cspell-gitignore";
 import { GlobMatcher, fileOrGlobToGlob, workaroundPicomatchBug } from "cspell-glob";
 import crypto from "node:crypto";
 import streamConsumers from "node:stream/consumers";
-import { readFileText, toURL } from "cspell-io";
+import { getStat, readFileText, toURL } from "cspell-io";
 import { glob } from "tinyglobby";
 import * as readline from "node:readline";
 import { parse, stringify } from "flatted";
 import { dynamicImport } from "@cspell/dynamic-import";
+import ansiRegex from "ansi-regex";
 
 //#region src/console.ts
 var ImplChannel = class {
@@ -199,9 +200,10 @@ function reportProgressFileComplete(io, p, cwd, options) {
 	const { idx, filename } = determineFilename(io, p, cwd);
 	const { verbose, debug } = options;
 	const time = reportTime(io, p.elapsedTimeMs, !!p.cached);
-	const skipped = p.processed === false ? " skipped" : "";
+	const skippedReason = p.skippedReason ? ` (${p.skippedReason})` : "";
+	const skipped = p.processed === false ? ` skipped${skippedReason}` : "";
 	const hasErrors = p.numErrors ? io.chalk.red` X` : "";
-	const msg = `${idx} ${filename} ${time}${skipped}${hasErrors}${(skipped && (verbose || debug) || hasErrors || isSlow(p.elapsedTimeMs) || io.getColorLevel() < 1 ? "\n" : "") || "\r"}`;
+	const msg = `${idx} ${filename} ${time}${skipped}${hasErrors}${(verbose || debug || hasErrors || isSlow(p.elapsedTimeMs) || io.getColorLevel() < 1 ? "\n" : "") || "\r"}`;
 	io.write(msg);
 }
 function reportTime(io, elapsedTimeMs, cached) {
@@ -275,7 +277,7 @@ function getReporter(options, config) {
 	}
 	const resultEmitter = (result) => {
 		if (!fileGlobs.length && !result.files) return;
-		const { files, issues: issues$1, cachedFiles, filesWithIssues, errors } = result;
+		const { files, issues: issues$1, cachedFiles, filesWithIssues, errors, skippedFiles } = result;
 		const numFilesWithIssues = filesWithIssues.size;
 		if (stderr.getColorLevel() > 0) {
 			stderr.write("\r");
@@ -286,9 +288,11 @@ function getReporter(options, config) {
 			consoleError("Issues found:");
 			issuesCollection.forEach((issue) => consoleError(issue));
 		}
+		const filesChecked = files - (skippedFiles || 0);
 		const cachedFilesText = cachedFiles ? ` (${cachedFiles} from cache)` : "";
+		const skippedFilesText = skippedFiles ? `, skipped: ${skippedFiles}` : "";
 		const withErrorsText = errors ? ` with ${errors} error${errors === 1 ? "" : "s"}` : "";
-		consoleError(`CSpell\u003A Files checked: ${files}${cachedFilesText}, Issues found: ${issues$1} in ${numFilesWithIssues === 1 ? "1 file" : `${numFilesWithIssues} files`}${withErrorsText}.`);
+		consoleError(`CSpell\u003A Files checked: ${filesChecked}${cachedFilesText}${skippedFilesText}, Issues found: ${issues$1} in ${numFilesWithIssues === 1 ? "1 file" : `${numFilesWithIssues} files`}${withErrorsText}.`);
 		if (errorCollection?.length && issues$1 > 5) {
 			consoleError("-------------------------------------------");
 			consoleError("Errors:");
@@ -766,7 +770,7 @@ const pkgDir = _dirname;
 //#endregion
 //#region src/pkgInfo.ts
 const name = "cspell";
-const version$1 = "9.3.1";
+const version$1 = "9.4.0";
 const engines = { node: ">=20" };
 const npmPackage = {
 	name,
@@ -999,6 +1003,11 @@ function readFileInfo(filename, encoding = UTF8, handleNotFound = false) {
 		}) : Promise.reject(new IOError(`Error reading file: "${filename}"`, error));
 	});
 }
+async function getFileSize(filename) {
+	const s = await getStat(filename);
+	if (!(s instanceof Error)) return s.size;
+	throw s;
+}
 function readFile(filename, encoding = UTF8) {
 	return readFileInfo(filename, encoding).then((info) => info.text);
 }
@@ -1376,7 +1385,7 @@ var DiskCache = class {
 			cached
 		};
 	}
-	async setCachedLintResults({ fileInfo, elapsedTimeMs: _, cached: __,...result }, dependsUponFiles) {
+	async setCachedLintResults({ fileInfo, elapsedTimeMs: _, cached: __, ...result }, dependsUponFiles) {
 		const fileDescriptor = await this.fileEntryCache.getFileDescriptor(fileInfo.filename);
 		const meta = fileDescriptor.meta;
 		if (fileDescriptor.notFound || !meta) return;
@@ -1397,7 +1406,7 @@ var DiskCache = class {
 		this.ocCacheFileResult = new ShallowObjectCollection();
 	}
 	normalizeResult(result) {
-		const { issues, processed, errors, configErrors, reportIssueOptions,...rest } = result;
+		const { issues, processed, errors, configErrors, reportIssueOptions, ...rest } = result;
 		if (!Object.keys(rest).length) return this.ocCacheFileResult.get(result);
 		return this.ocCacheFileResult.get({
 			issues,
@@ -1852,6 +1861,7 @@ var LintReporter = class {
 				filename,
 				elapsedTimeMs: result.elapsedTimeMs,
 				processed: result.processed,
+				skippedReason: result.skippedReason,
 				numErrors: numIssues || result.errors,
 				cached: result.cached,
 				perf: result.perf,
@@ -1872,6 +1882,300 @@ function getTimeMeasurer() {
 	return () => timer.elapsed;
 }
 
+//#endregion
+//#region src/util/unindent.ts
+/**
+* Indent each line of a multi-line string.
+* @param str - multi-line string to left pad
+* @param padding - the padding to use for all lines except the first.
+* @param firstLinePadding - optional padding of first line.
+* @returns
+*/
+function indent(str, padding, firstLinePadding = "") {
+	let pad = firstLinePadding;
+	const lines = [];
+	for (const line of str.split("\n")) {
+		lines.push(pad + line);
+		pad = padding;
+	}
+	return lines.join("\n");
+}
+/**
+* Inject values into a template string while keeping indentation of multi-line values.
+* @param template - template string
+* @param values- values to inject
+* @returns the injected string
+*/
+function keepIndent(template, ...values) {
+	const strings = template;
+	const adjValues = [];
+	for (let i = 0; i < values.length; ++i) {
+		const prevLines = strings[i].split("\n");
+		const currLine = prevLines[prevLines.length - 1];
+		const padLen = padLength(currLine);
+		const padding = " ".repeat(padLen);
+		adjValues.push(indent(`${values[i]}`, padding));
+	}
+	return String.raw({ raw: strings }, ...adjValues);
+}
+/**
+* Calculate the padding at the start of the string.
+* @param s - string to evaluate
+* @returns number of padding characters
+*/
+function padLength(s) {
+	return s.length - s.trimStart().length;
+}
+function unindent(templateOrString, ...values) {
+	return unindentString(typeof templateOrString === "string" ? templateOrString : keepIndent(templateOrString, ...values));
+}
+function unindentString(str) {
+	const lines = str.split("\n");
+	let curPad = str.length;
+	for (const line of lines) {
+		if (!line.trim()) continue;
+		curPad = Math.min(curPad, padLength(line));
+	}
+	return lines.map((line) => line.slice(curPad)).join("\n");
+}
+
+//#endregion
+//#region src/util/unitNumbers.ts
+const regexUnitNumber = /^((?:\d+(?:\.\d*)?)|(?:\.\d+))([a-z]*)$/i;
+const unitSizes = {
+	"": 1,
+	b: 1,
+	k: 1024,
+	kb: 1024,
+	m: 1 << 20,
+	mb: 1 << 20,
+	g: 1 << 30,
+	gb: 1 << 30
+};
+function parseUnitSize(size) {
+	const match = size.match(regexUnitNumber);
+	const digits = match?.[1] || "";
+	const units = (match?.[2] || "").toLowerCase();
+	if (!match) return {
+		size,
+		digits,
+		units,
+		error: "Invalid size."
+	};
+	if (!units || units in unitSizes) return {
+		size,
+		digits,
+		units
+	};
+	return {
+		size,
+		digits,
+		units,
+		error: `Unknown units. Valid units are: ${Object.keys(unitSizes).filter(Boolean).join(", ").toUpperCase()}.`
+	};
+}
+function validateUnitSize(size) {
+	return parseUnitSize(size).error;
+}
+function sizeToNumber(size) {
+	const p = parseUnitSize(size);
+	if (p.error) return NaN;
+	return Number.parseFloat(p.digits) * (unitSizes[p.units] || 1);
+}
+
+//#endregion
+//#region src/util/ansi.ts
+function isAnsiString(s) {
+	return s.includes("\x1B") || s.includes("›");
+}
+/**
+*
+* @param s - the string to measure - should NOT contains ANSI codes
+* @param tabWidth -
+* @returns
+*/
+function width(s, tabWidth = 1) {
+	return s.replaceAll("…", ".").replaceAll("	", " ".repeat(tabWidth)).replaceAll(/\p{M}/gu, "").replaceAll(/\p{L}/gu, ".").replaceAll(/[\u0000-\u001F\u0300-\u036F]/g, "").replaceAll(/[\uD800-\uDBFF][\uDC00-\uDFFF]/g, ".").length;
+}
+/**
+* Measure the width of a string containing ANSI control characters.
+* @param s - string to measure with width in characters.
+* @returns the approximate number of screen characters.
+*/
+function ansiWidth(s) {
+	return width(stripVTControlCharacters(s));
+}
+function fragmentString(str, splitOnRegex, sType) {
+	const fragments = [];
+	let lastIndex = 0;
+	for (const match of str.matchAll(new RegExp(splitOnRegex))) {
+		if (match.index > lastIndex) fragments.push({
+			type: "text",
+			text: str.slice(lastIndex, match.index)
+		});
+		fragments.push({
+			type: sType,
+			text: match[0]
+		});
+		lastIndex = match.index + match[0].length;
+	}
+	if (lastIndex < str.length) fragments.push({
+		type: "text",
+		text: str.slice(lastIndex)
+	});
+	return fragments;
+}
+const ansi = ansiRegex();
+function parseAnsiStr(str) {
+	return fragmentString(str, ansi, "ansi");
+}
+/**
+* Prune the end of a string to fit within a specified width, adding an ellipsis if necessary.
+* @param str - the text to prune - ANSI is supported
+* @param maxWidth - the maximum width of the text
+* @param pad - the string to use for padding, default is '…'
+* @returns the pruned text
+*/
+function pruneAnsiTextEnd(str, maxWidth, pad = "…") {
+	if (!maxWidth || maxWidth <= 0) return str;
+	if (str.length <= maxWidth) return str;
+	if (ansiWidth(str) <= maxWidth) return str;
+	const padWidth = ansiWidth(pad);
+	const fragments = parseAnsiStr(str);
+	let remaining = maxWidth - padWidth;
+	for (const frag of fragments) {
+		if (frag.type !== "text") continue;
+		if (remaining <= 0) {
+			frag.text = "";
+			continue;
+		}
+		const pruned = pruneTextEnd(frag.text, remaining, pad);
+		if (pruned !== frag.text) {
+			frag.text = pruned;
+			remaining = 0;
+			continue;
+		}
+		remaining -= width(frag.text);
+	}
+	return fragments.map((frag) => frag.text).join("");
+}
+/**
+* Prune the start of a string to fit within a specified width, adding an ellipsis if necessary.
+* @param str - the text to prune - ANSI is supported
+* @param maxWidth - the maximum width of the text
+* @param pad - the string to use for padding, default is '…'
+* @returns the pruned text
+*/
+function pruneAnsiTextStart(str, maxWidth, pad = "…") {
+	if (!maxWidth || maxWidth <= 0) return str;
+	if (str.length <= maxWidth) return str;
+	if (ansiWidth(str) <= maxWidth) return str;
+	const padWidth = ansiWidth(pad);
+	const fragments = parseAnsiStr(str);
+	let remaining = maxWidth - padWidth;
+	for (const frag of fragments.reverse()) {
+		if (frag.type !== "text") continue;
+		if (remaining <= 0) {
+			frag.text = "";
+			continue;
+		}
+		const pruned = pruneTextStart(frag.text, remaining, pad);
+		if (pruned !== frag.text) {
+			frag.text = pruned;
+			remaining = 0;
+			continue;
+		}
+		remaining -= width(frag.text);
+	}
+	return fragments.reverse().map((frag) => frag.text).join("");
+}
+/**
+* Prune the end of a string to fit within a specified width, adding an ellipsis if necessary.
+* @param str - the text to prune - ANSI is not supported
+* @param maxWidth - the maximum width of the text
+* @param pad - the string to use for padding, default is '…'
+* @returns the pruned text
+*/
+function pruneTextEnd(str, maxWidth, pad = "…") {
+	if (!maxWidth || maxWidth <= 0) return str;
+	if (str.length <= maxWidth) return str;
+	if (isAnsiString(str)) return pruneAnsiTextEnd(str, maxWidth, pad);
+	const maxWidthWithPad = maxWidth - width(pad);
+	const letters = [...str];
+	let len = 0;
+	for (let i = 0; i < letters.length; i++) {
+		const c = letters[i];
+		len += width(c);
+		if (len > maxWidthWithPad) {
+			let j = i + 1;
+			while (j < letters.length && width(letters[j]) === 0) ++j;
+			return j === letters.length ? str : letters.slice(0, i).join("") + pad;
+		}
+	}
+	return str;
+}
+/**
+* Prune the start of a string to fit within a specified width, adding an ellipsis if necessary.
+* @param str - the text to prune - ANSI is not supported
+* @param maxWidth - the maximum width of the text
+* @param pad - the string to use for padding, default is '…'
+* @returns the pruned text
+*/
+function pruneTextStart(str, maxWidth, pad = "…") {
+	if (!maxWidth || maxWidth <= 0) return str;
+	if (str.length <= maxWidth) return str;
+	const maxWidthWithPad = maxWidth - width(pad);
+	const letters = [...str];
+	let len = 0;
+	for (let i = letters.length - 1; i >= 1; i--) {
+		const c = letters[i];
+		len += width(c);
+		if (len > maxWidthWithPad) {
+			i += 1;
+			while (i < letters.length && width(letters[i]) === 0) ++i;
+			return pad + letters.slice(i).join("");
+		}
+	}
+	return str;
+}
+
+//#endregion
+//#region src/util/wrap.ts
+const wrapSep = /\s+|(?<=,)|\.(?=\w)/g;
+function wordWrapAnsiText(str, maxWidth, indent$1 = "", sep$1 = wrapSep) {
+	if (!maxWidth || maxWidth <= 0) return str;
+	if (str.length <= maxWidth) return str;
+	if (str.includes("\n")) return str.split("\n").map((line$1) => wordWrapAnsiText(line$1, maxWidth, indent$1)).join("\n");
+	const fragments = fragmentString(str, sep$1, "sep");
+	const lines = [];
+	let line = "";
+	for (const text of joinFragments(fragments)) {
+		const lineWidth = ansiWidth(line);
+		const textWidth = ansiWidth(text);
+		if (line && lineWidth + textWidth > maxWidth) {
+			if (line) lines.push(line);
+			line = indent$1 + text.trimStart();
+			continue;
+		}
+		line += text;
+	}
+	if (line) lines.push(line);
+	return lines.join("\n");
+}
+function* joinFragments(fragments) {
+	let last;
+	for (const frag of fragments) {
+		if (frag.type === "sep") {
+			if (last) yield last.text;
+			last = frag;
+			continue;
+		}
+		yield last ? last.text + frag.text : frag.text;
+		last = void 0;
+	}
+	if (last) yield last.text;
+}
+
 //#endregion
 //#region src/util/writeFile.ts
 async function writeFileOrStream(filename, data) {
@@ -1903,6 +2207,8 @@ const { opFilterAsync } = operators;
 async function runLint(cfg) {
 	const reporter = new LintReporter(cfg.reporter, cfg.options);
 	const configErrors = /* @__PURE__ */ new Set();
+	const verboseLevel = calcVerboseLevel(cfg.options);
+	const useColor = cfg.options.color ?? true;
 	const timer = getTimeMeasurer();
 	const logDictRequests = truthy(getEnvironmentVariable("CSPELL_ENABLE_DICTIONARY_LOGGING"));
 	if (logDictRequests) _debug.cacheDictionaryEnableLogging(true);
@@ -1915,7 +2221,10 @@ async function runLint(cfg) {
 	function prefetch(filename, configInfo, cache) {
 		if (isBinaryFile$1(filename, cfg.root)) return {
 			filename,
-			result: Promise.resolve({ skip: true })
+			result: Promise.resolve({
+				skip: true,
+				skipReason: "Binary file."
+			})
 		};
 		const reportIssueOptions = extractReporterIssueOptions(configInfo.config);
 		async function fetch$1() {
@@ -1929,7 +2238,18 @@ async function runLint(cfg) {
 				} };
 			}
 			const uri = filenameToUri(filename, cfg.root).href;
-			if (!(await shouldCheckDocument({ uri }, {}, configInfo.config)).shouldCheck) return { skip: true };
+			const checkResult = await shouldCheckDocument({ uri }, {}, configInfo.config);
+			if (!checkResult.shouldCheck) return {
+				skip: true,
+				skipReason: checkResult.reason || "Ignored by configuration."
+			};
+			const maxFileSize = processMaxFileSize(cfg.maxFileSize ?? checkResult.settings.maxFileSize);
+			if (maxFileSize) {
+				if (await getFileSize(filename) > maxFileSize) return {
+					skip: true,
+					skipReason: `File exceeded max file size of ${maxFileSize.toLocaleString()}`
+				};
+			}
 			return {
 				fileInfo: await readFileInfo(filename, void 0, true),
 				reportIssueOptions
@@ -1937,7 +2257,7 @@ async function runLint(cfg) {
 		}
 		return {
 			filename,
-			result: fetch$1()
+			result: fetch$1().catch((e) => toApplicationError(e))
 		};
 	}
 	async function processFile(filename, configInfo, cache, prefetch$1) {
@@ -1978,7 +2298,6 @@ async function runLint(cfg) {
 		const { text } = fileInfo;
 		result.fileInfo = fileInfo;
 		let spellResult = {};
-		reporter.info(`Checking: ${filename}, File type: ${doc.languageId ?? "auto"}, Language: ${doc.locale ?? "default"}`, MessageTypes.Info);
 		try {
 			const { showSuggestions: generateSuggestions, validateDirectives, skipValidation } = cfg.options;
 			const numSuggestions = configInfo.config.numSuggestions ?? 5;
@@ -2000,29 +2319,39 @@ async function runLint(cfg) {
 		const config = spellResult.settingsUsed ?? {};
 		result.reportIssueOptions = mergeReportIssueOptions(spellResult.settingsUsed || configInfo.config, reportIssueOptions);
 		result.configErrors += await reportConfigurationErrors(config);
-		const elapsed$1 = result.elapsedTimeMs;
-		const dictionaries = config.dictionaries || [];
-		reporter.info(`Checked: ${filename}, File type: ${config.languageId}, Language: ${config.language} ... Issues: ${result.issues.length} ${elapsed$1.toFixed(2)}ms`, MessageTypes.Info);
-		reporter.info(`Config file Used: ${spellResult.localConfigFilepath || configInfo.source}`, MessageTypes.Info);
-		reporter.info(`Dictionaries Used: ${dictionaries.join(", ")}`, MessageTypes.Info);
-		if (cfg.options.debug) {
-			const { id: _id, name: _name, __imports, __importRef,...cfg$1 } = config;
-			const debugCfg = {
-				filename,
-				languageId: doc.languageId ?? cfg$1.languageId ?? "default",
-				config: {
-					...cfg$1,
-					source: null
-				},
-				source: spellResult.localConfigFilepath
-			};
-			reporter.debug(JSON.stringify(debugCfg, void 0, 2));
-		}
+		reportCheckResult(result, doc, spellResult, configInfo, config);
 		const dep = calcDependencies(config);
 		await cache.setCachedLintResults(result, dep.files);
 		return result;
 	}
-	function mapIssue({ doc: _,...tdo }) {
+	function reportCheckResult(result, _doc, spellResult, configInfo, config) {
+		const elapsed$1 = result.elapsedTimeMs || 0;
+		const dictionaries = config.dictionaries || [];
+		if (verboseLevel > 1) {
+			const dictsUsed = [...dictionaries].sort().map((name$1) => chalk.green(name$1)).join(", ");
+			const msg = unindent`
+                    File type: ${config.languageId}, Language: ${config.language}, Issues: ${result.issues.length} ${elapsed$1.toFixed(2)}ms
+                    Config file Used: ${relativeToCwd(spellResult.localConfigFilepath || configInfo.source, cfg.root)}
+                    Dictionaries Used:
+                      ${wordWrapAnsiText(dictsUsed, 70)}`;
+			reporter.info(indent(msg, "  "), MessageTypes.Info);
+		}
+		if (cfg.options.debug) {
+			const { enabled, language, languageId, dictionaries: dictionaries$1 } = config;
+			const msg = unindent`\
+                Debug Config: ${formatWithOptions({
+				depth: 2,
+				colors: useColor
+			}, {
+				languageId,
+				enabled,
+				language,
+				dictionaries: dictionaries$1
+			})}`;
+			reporter.debug(msg);
+		}
+	}
+	function mapIssue({ doc: _, ...tdo }) {
 		const context = cfg.showContext ? extractContext(tdo, cfg.showContext) : void 0;
 		return clean({
 			...tdo,
@@ -2054,6 +2383,7 @@ async function runLint(cfg) {
 			const { filename, result: pFetchResult } = pf;
 			const getElapsedTimeMs = getTimeMeasurer();
 			const fetchResult = await pFetchResult;
+			if (fetchResult instanceof Error) throw fetchResult;
 			reporter.emitProgressBegin(filename, index, fileCount ?? index);
 			if (fetchResult?.skip) return {
 				filename,
@@ -2061,7 +2391,8 @@ async function runLint(cfg) {
 				result: {
 					...emptyResult,
 					fileInfo: { filename },
-					elapsedTimeMs: getElapsedTimeMs()
+					elapsedTimeMs: getElapsedTimeMs(),
+					skippedReason: fetchResult.skipReason
 				}
 			};
 			return {
@@ -2082,6 +2413,7 @@ async function runLint(cfg) {
 			const { filename, fileNum, result } = fileP;
 			status.files += 1;
 			status.cachedFiles = (status.cachedFiles || 0) + (result.cached ? 1 : 0);
+			status.skippedFiles = (status.skippedFiles || 0) + (result.processed ? 0 : 1);
 			const numIssues = reporter.emitProgressComplete(filename, fileNum, fileCount ?? fileNum, result);
 			if (numIssues || result.errors) {
 				status.filesWithIssues.add(relativeToCwd(filename, cfg.root));
@@ -2139,14 +2471,14 @@ async function runLint(cfg) {
 		const reporters = cfg.options.reporter ?? configInfo.config.reporters;
 		reporter.config = reporterConfig;
 		await reporter.loadReportersAndFinalize(reporters);
-		setLogger(getLoggerFromReporter(reporter));
+		setLogger(getLoggerFromReporter(reporter, useColor));
 		const globInfo = await determineGlobs(configInfo, cfg);
 		const { fileGlobs, excludeGlobs } = globInfo;
 		const hasFileLists = !!cfg.fileLists.length;
 		if (!fileGlobs.length && !hasFileLists && !cfg.files?.length) return runResult();
 		header(fileGlobs, excludeGlobs);
 		checkGlobs(fileGlobs, reporter);
-		reporter.info(`Config Files Found:\n    ${configInfo.source}\n`, MessageTypes.Info);
+		if (verboseLevel > 1) reporter.info(`Config Files Found:\n    ${relativeToCwd(configInfo.source)}\n`, MessageTypes.Info);
 		const configErrors$1 = await countConfigErrors(configInfo);
 		if (configErrors$1 && cfg.options.exitCode !== false && !cfg.options.continueOnError) return runResult({ errors: configErrors$1 });
 		const { root } = cfg;
@@ -2165,18 +2497,19 @@ async function runLint(cfg) {
 		}
 	}
 	function header(files, cliExcludes) {
+		if (verboseLevel < 2) return;
 		const formattedFiles = files.length > 100 ? [...files.slice(0, 100), "..."] : files;
-		reporter.info(`
-cspell;
-Date: ${(/* @__PURE__ */ new Date()).toUTCString()}
-Options:
-    verbose:   ${yesNo(!!cfg.options.verbose)}
-    config:    ${cfg.configFile || "default"}
-    exclude:   ${cliExcludes.join("\n               ")}
-    files:     ${formattedFiles}
-    wordsOnly: ${yesNo(!!cfg.options.wordsOnly)}
-    unique:    ${yesNo(!!cfg.options.unique)}
-`, MessageTypes.Info);
+		reporter.info(unindent`
+                cspell;
+                Date: ${(/* @__PURE__ */ new Date()).toUTCString()}
+                Options:
+                    verbose:   ${yesNo(!!cfg.options.verbose)}
+                    config:    ${cfg.configFile || "default"}
+                    exclude:   ${wordWrapAnsiText(cliExcludes.join(", "), 60, "  ")}
+                    files:     ${formattedFiles}
+                    wordsOnly: ${yesNo(!!cfg.options.wordsOnly)}
+                    unique:    ${yesNo(!!cfg.options.unique)}
+                `, MessageTypes.Info);
 	}
 }
 function checkGlobs(globs, reporter) {
@@ -2234,13 +2567,13 @@ async function determineFilesToCheck(configInfo, cfg, reporter, globInfo) {
 		const r = globMatcherExclude.matchEx(absFilename);
 		if (r.matched) {
 			const { glob: glob$2, source } = extractGlobSource(r.pattern);
-			reporter.info(`Excluded File: ${path$1.relative(root, absFilename)}; Excluded by ${glob$2} from ${source}`, MessageTypes.Info);
+			if (calcVerboseLevel(cfg.options) > 1) reporter.info(`Excluded File: ${path$1.relative(root, absFilename)}; Excluded by ${glob$2} from ${source}`, MessageTypes.Info);
 		}
 		return r.matched;
 	}
 	function filterOutExcludedFilesFn(globMatcherExclude) {
 		const excludeInfo = globMatcherExclude.patterns.map(extractGlobSource).map(({ glob: glob$2, source }) => `Glob: ${glob$2} from ${source}`).filter(uniqueFn());
-		reporter.info(`Exclusion Globs: \n    ${excludeInfo.join("\n    ")}\n`, MessageTypes.Info);
+		if (calcVerboseLevel(cfg.options) > 1) reporter.info(`Exclusion Globs: \n    ${excludeInfo.join("\n    ")}\n`, MessageTypes.Info);
 		return (filename) => !isExcluded(filename, globMatcherExclude);
 	}
 	return _determineFilesToCheck();
@@ -2265,13 +2598,14 @@ function runResult(init = {}) {
 function yesNo(value) {
 	return value ? "Yes" : "No";
 }
-function getLoggerFromReporter(reporter) {
+function getLoggerFromReporter(reporter, useColor) {
+	const inspectOptions = { colors: useColor };
 	const log = (...params) => {
-		const msg = format(...params);
+		const msg = formatWithOptions(inspectOptions, ...params);
 		reporter.info(msg, "Info");
 	};
 	const error = (...params) => {
-		const msg = format(...params);
+		const msg = formatWithOptions(inspectOptions, ...params);
 		reporter.error(msg, {
 			message: "",
 			name: "error",
@@ -2279,7 +2613,7 @@ function getLoggerFromReporter(reporter) {
 		});
 	};
 	const warn = (...params) => {
-		const msg = format(...params);
+		const msg = formatWithOptions(inspectOptions, ...params);
 		reporter.info(msg, "Warning");
 	};
 	return {
@@ -2333,6 +2667,16 @@ var LinterError = class extends Error {
 		return this.message;
 	}
 };
+function calcVerboseLevel(options) {
+	return options.verboseLevel ?? (options.verbose ? 1 : 0);
+}
+function processMaxFileSize(value) {
+	if (!value) return void 0;
+	if (typeof value === "number") return value;
+	const num = sizeToNumber(value);
+	if (Number.isNaN(num)) throw new ApplicationError(`Invalid max file size: "${value}"`);
+	return num;
+}
 
 //#endregion
 //#region src/lint/LintRequest.ts
@@ -2347,6 +2691,7 @@ var LintRequest = class {
 	fileLists;
 	files;
 	cspellSettingsFromCliOptions;
+	maxFileSize;
 	constructor(fileGlobs, options, reporter) {
 		this.fileGlobs = fileGlobs;
 		this.options = options;
@@ -2370,6 +2715,7 @@ var LintRequest = class {
 			...extractUnknownWordsConfig(options),
 			languageSettings
 		};
+		this.maxFileSize = options.maxFileSize ? sizeToNumber(options.maxFileSize) : void 0;
 	}
 };
 function mergeFiles(a, b) {
@@ -2411,10 +2757,19 @@ const ReportChoicesAll = [
 	"flagged"
 ];
 function fixLegacy(opts) {
-	const { local,...rest } = opts;
+	const { local, ...rest } = opts;
 	if (local && !rest.locale) rest.locale = local;
 	return rest;
 }
+function cvtLinterCliCommandOptionsToLinterCliOptions(options) {
+	const { verbose: verboseLevel, ...optionsRest } = options;
+	const cliOptions = { ...optionsRest };
+	if (verboseLevel) {
+		cliOptions.verboseLevel = verboseLevel;
+		cliOptions.verbose = true;
+	}
+	return cliOptions;
+}
 
 //#endregion
 //#region src/repl/index.ts
@@ -2655,5 +3010,5 @@ function parseApplicationFeatureFlags(flags) {
 }
 
 //#endregion
-export { parseApplicationFeatureFlags as a, listDictionaries as c, npmPackage as d, getReporter as f, console as h, lint as i, ReportChoicesAll as l, CheckFailed as m, checkText as n, suggestions as o, ApplicationError as p, createInit as r, trace as s, IncludeExcludeFlag as t, DEFAULT_CACHE_LOCATION as u };
-//# sourceMappingURL=application-D_X0oO_z.js.map
+export { console as C, CheckFailed as S, unindent as _, parseApplicationFeatureFlags as a, getReporter as b, listDictionaries as c, ansiWidth as d, pruneAnsiTextEnd as f, validateUnitSize as g, width as h, lint as i, ReportChoicesAll as l, pruneTextEnd as m, checkText as n, suggestions as o, pruneAnsiTextStart as p, createInit as r, trace as s, IncludeExcludeFlag as t, cvtLinterCliCommandOptionsToLinterCliOptions as u, DEFAULT_CACHE_LOCATION as v, ApplicationError as x, npmPackage as y };
+//# sourceMappingURL=application-DCyfKhGm.js.map

package/dist/esm/application.d.ts

@@ -1,3 +1,3 @@
-import "./options-BeJCICDB.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-B84gvlDU.js";
+import "./options-D_PtlSKK.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-Ce_s5c1d.js";
 export { AppError, CheckTextResult, IncludeExcludeFlag, TraceResult, checkText, createInit, lint, listDictionaries, parseApplicationFeatureFlags, suggestions, trace };

package/dist/esm/application.js

@@ -1,3 +1,3 @@
-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-D_X0oO_z.js";
+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-DCyfKhGm.js";
 
 export { IncludeExcludeFlag, checkText, createInit, lint, listDictionaries, parseApplicationFeatureFlags, suggestions, trace };

package/dist/esm/index.d.ts

@@ -1,5 +1,5 @@
-import { i as LinterCliOptions, o as TraceOptions, t as BaseOptions } from "./options-BeJCICDB.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-B84gvlDU.js";
+import { i as LinterCliOptions, o as TraceOptions, t as BaseOptions } from "./options-D_PtlSKK.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-Ce_s5c1d.js";
 import "chalk";
 import { CSpellReporter, CSpellSettings, ReporterConfiguration, RunResult } from "@cspell/cspell-types";
 import { WriteStream } from "node:tty";
@@ -42,7 +42,7 @@ interface CSpellReporterModule {
 type FinalizedReporter = Required<CSpellReporter>;
 //#endregion
 //#region src/cli-reporter.d.ts
-interface ReporterOptions extends Pick<LinterCliOptions, "color" | "debug" | "issues" | "issuesSummaryReport" | "legacy" | "progress" | "relative" | "root" | "showContext" | "showPerfSummary" | "showSuggestions" | "silent" | "summary" | "verbose" | "wordsOnly"> {
+interface ReporterOptions extends Pick<LinterCliOptions, "color" | "debug" | "issues" | "issuesSummaryReport" | "legacy" | "progress" | "relative" | "root" | "showContext" | "showPerfSummary" | "showSuggestions" | "silent" | "summary" | "verbose" | "verboseLevel" | "wordsOnly"> {
   fileGlobs: string[];
 }
 declare function getReporter(options: ReporterOptions, config?: CSpellReporterConfiguration): FinalizedReporter;

package/dist/esm/index.js

@@ -1,4 +1,4 @@
-import { a as parseApplicationFeatureFlags, c as listDictionaries, f as getReporter, i as lint, n as checkText, o as suggestions, r as createInit, s as trace, t as IncludeExcludeFlag } from "./application-D_X0oO_z.js";
+import { a as parseApplicationFeatureFlags, b as getReporter, c as listDictionaries, i as lint, n as checkText, o as suggestions, r as createInit, s as trace, t as IncludeExcludeFlag } from "./application-DCyfKhGm.js";
 
 export * from "@cspell/cspell-types"
 

package/dist/esm/{options-BeJCICDB.d.ts → options-D_PtlSKK.d.ts}

@@ -44,6 +44,10 @@ interface LinterOptions extends Omit<BaseOptions, "config">, Omit<CacheOptions,
   */
   verbose?: boolean;
   /**
+  * Level of verbosity (higher number = more verbose).
+  */
+  verboseLevel?: number;
+  /**
   * Show extensive output.
   */
   debug?: boolean;
@@ -142,6 +146,13 @@ interface LinterOptions extends Omit<BaseOptions, "config">, Omit<CacheOptions,
   * Path to configuration file.
   */
   config?: string | CSpellConfigFile;
+  /**
+  * Specify the maximum file size to be checked.
+  * The value can include a units suffix: `KB`, `MB`, `B`, `GB`.
+  * The numeric value can include a decimal.
+  * Example: 1.5MB
+  */
+  maxFileSize?: string | undefined;
 }
 interface TraceOptions extends BaseOptions {
   /**
@@ -387,4 +398,4 @@ interface CSpellConfigFile {
 }
 //#endregion
 export { SuggestionOptions as a, LinterCliOptions as i, DictionariesOptions as n, TraceOptions as o, LegacyOptions as r, BaseOptions as t };
-//# sourceMappingURL=options-BeJCICDB.d.ts.map
+//# sourceMappingURL=options-D_PtlSKK.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cspell",
-  "version": "9.3.1",
+  "version": "9.4.0",
   "description": "A Spelling Checker for Code!",
   "funding": "https://github.com/streetsidesoftware/cspell?sponsor=1",
   "bin": {
@@ -83,20 +83,21 @@
   },
   "homepage": "https://cspell.org/",
   "dependencies": {
-    "@cspell/cspell-json-reporter": "9.3.1",
-    "@cspell/cspell-pipe": "9.3.1",
-    "@cspell/cspell-types": "9.3.1",
-    "@cspell/dynamic-import": "9.3.1",
-    "@cspell/url": "9.3.1",
+    "@cspell/cspell-json-reporter": "9.4.0",
+    "@cspell/cspell-pipe": "9.4.0",
+    "@cspell/cspell-types": "9.4.0",
+    "@cspell/dynamic-import": "9.4.0",
+    "@cspell/url": "9.4.0",
+    "ansi-regex": "^6.2.2",
     "chalk": "^5.6.2",
     "chalk-template": "^1.1.2",
     "commander": "^14.0.2",
-    "cspell-config-lib": "9.3.1",
-    "cspell-dictionary": "9.3.1",
-    "cspell-gitignore": "9.3.1",
-    "cspell-glob": "9.3.1",
-    "cspell-io": "9.3.1",
-    "cspell-lib": "9.3.1",
+    "cspell-config-lib": "9.4.0",
+    "cspell-dictionary": "9.4.0",
+    "cspell-gitignore": "9.4.0",
+    "cspell-glob": "9.4.0",
+    "cspell-io": "9.4.0",
+    "cspell-lib": "9.4.0",
     "fast-json-stable-stringify": "^2.1.0",
     "flatted": "^3.3.3",
     "semver": "^7.7.3",
@@ -112,5 +113,5 @@
     "micromatch": "^4.0.8",
     "minimatch": "^9.0.5"
   },
-  "gitHead": "3f8bf5c88cda393b581957b7f8efc696e432f6f1"
+  "gitHead": "12dba3d8b880384d1401c765cb2186647f5a266f"
 }