cspell 9.3.2 → 9.6.0

package/README.md

@@ -12,13 +12,13 @@ A Spell Checker for Code!
 
 <!--- @@inject: ../../static/sponsor.md --->
 
-- [![GitHub Sponsors](https://img.shields.io/badge/-black?style=social&logo=githubsponsors&label=GitHub%20Sponsor%3A%20Street%20Side%20Software)](https://github.com/sponsors/streetsidesoftware)
-- [![PayPal](https://img.shields.io/badge/-black?style=social&logo=paypal&label=PayPal%20Donate%3A%20Street%20Side%20Software)](https://www.paypal.com/donate/?hosted_button_id=26LNBP2Q6MKCY)
-- [![Open Collective](https://img.shields.io/badge/-black?style=social&logo=opencollective&label=Open%20Collective%3A%20CSpell)](https://opencollective.com/cspell)
+[![GitHub Sponsors](https://img.shields.io/badge/-Street_Side_Software-black?style=for-the-badge&logo=githubsponsors&label=GitHub%20Sponsor%3A)](https://github.com/sponsors/streetsidesoftware)
 
-<!---
-- [![Patreon](https://img.shields.io/badge/-black?style=social&logo=patreon&label=Patreon%3A%20Street%20Side%20Software)](https://patreon.com/streetsidesoftware)
-  --->
+[![Open Collective](https://img.shields.io/badge/-CSpell-black?style=for-the-badge&logo=opencollective&label=Open%20Collective%3A)](https://opencollective.com/cspell)
+
+[![Street Side Software](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fstreetsidesoftware%2Fcspell%2Frefs%2Fheads%2Fmain%2Fstatic%2Fcspell-badge.json)](https://streetsidesoftware.com/sponsor/)
+
+[![PayPal](https://img.shields.io/badge/-Street_Side_Software-black?style=for-the-badge&logo=paypal&label=PayPal%20Donate%3A)](https://www.paypal.com/donate/?hosted_button_id=26LNBP2Q6MKCY)
 
 <!--- @@inject-end: ../../static/sponsor.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
@@ -566,6 +569,9 @@ _cspell_'s behavior can be controlled through a config file. By default it looks
 - `cspell.config.js`
 - `cspell.config.cjs`
 - `cspell.config.mjs`
+- `cspell.config.ts`
+- `cspell.config.cts`
+- `cspell.config.mts`
 - `cspell.config.json`
 - `cspell.config.yaml`
 - `cspell.config.yml`

package/dist/cjs/commonJsApi.cjs

@@ -0,0 +1,8 @@
+let _cspell_cspell_types = require("@cspell/cspell-types");
+
+Object.defineProperty(exports, 'defineConfig', {
+  enumerable: true,
+  get: function () {
+    return _cspell_cspell_types.defineConfig;
+  }
+});

package/dist/cjs/commonJsApi.d.cts

@@ -0,0 +1,2 @@
+import { defineConfig } from "@cspell/cspell-types";
+export { defineConfig };

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-CGIx5L0D.js";
-import { Option, program } from "commander";
-import { satisfies } from "semver";
-import chalk from "chalk";
+import { C as CheckFailed, S as ApplicationError, _ as padLeft, a as parseApplicationFeatureFlags, b as pruneAnsiTextStart, 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 console, x as width, y as pruneAnsiTextEnd } from "./application-BJHh60xM.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) {
@@ -42,7 +40,7 @@ function commandCheck(prog) {
 * @param previous the previous values.
 * @returns the new values appended to the previous values.
 */
-function collect(value, previous) {
+function collect$1(value, previous) {
 	const values = Array.isArray(value) ? value : [value];
 	return previous ? [...previous, ...values] : values;
 }
@@ -61,257 +59,6 @@ function crOpt(name, description, parseArg, defaultValue) {
 	return option;
 }
 
-//#endregion
-//#region src/util/pad.ts
-function pad(s, w) {
-	const p = padWidth(s, w);
-	if (!p) return s;
-	return s.padEnd(p + s.length);
-}
-function padWidth(s, target) {
-	const sWidth = ansiWidth(s);
-	return Math.max(target - sWidth, 0);
-}
-function padLeft(s, w) {
-	const p = padWidth(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
-function tableToLines(table, deliminator) {
-	const del = deliminator || table.deliminator || " | ";
-	const columnWidths = [];
-	const maxColumnWidthsMap = table.maxColumnWidths || {};
-	const { header, rows } = table;
-	const simpleHeader = header.map((col) => Array.isArray(col) ? col[1] : col);
-	const columnFieldNames = header.map((col) => Array.isArray(col) ? col[0] : col);
-	const maxColumnWidths = columnFieldNames.map((field, idx) => maxColumnWidthsMap[field] ?? maxColumnWidthsMap[idx]);
-	function getCell(row, col) {
-		return getCellFromRow(rows[row], col);
-	}
-	function getCellFromRow(row, col) {
-		if (!row) return void 0;
-		if (Array.isArray(row)) return row[col];
-		return row[columnFieldNames[col]];
-	}
-	function rowToCells(row) {
-		if (Array.isArray(row)) return row;
-		return columnFieldNames.map((fieldName) => row[fieldName]);
-	}
-	function getText(col, maxWidth$2) {
-		return !col ? "" : typeof col === "string" ? pruneTextEnd(col, maxWidth$2) : col(maxWidth$2);
-	}
-	function getRCText(row, col, maxWidth$2) {
-		return getText(getCell(row, col), maxWidth$2);
-	}
-	function recordHeaderWidths(header$1) {
-		header$1.forEach((col, idx) => {
-			columnWidths[idx] = Math.max(ansiWidth(col), columnWidths[idx] || 0);
-		});
-	}
-	function recordColWidths() {
-		for (let rowIndex = 0; rowIndex < rows.length; rowIndex++) for (let colIndex = 0; colIndex < columnFieldNames.length; colIndex++) columnWidths[colIndex] = Math.max(ansiWidth(getRCText(rowIndex, colIndex, void 0)), columnWidths[colIndex] || 0);
-	}
-	function justifyRow(c, i) {
-		return pad(c, columnWidths[i]);
-	}
-	function toHeaderLine(header$1) {
-		return decorateRowWith(header$1.map((c, i) => getText(c, columnWidths[i])), justifyRow, headerDecorator).join(del);
-	}
-	function toLine(row) {
-		return decorateRowWith(rowToCells(row).map((c, i) => getText(c, columnWidths[i])), justifyRow).join(del);
-	}
-	function* process$1() {
-		yield toHeaderLine(simpleHeader);
-		yield* rows.map(toLine);
-	}
-	function sumColumnWidths() {
-		return columnWidths.reduce((sum, width$1) => sum + width$1, 0);
-	}
-	function adjustColWidths() {
-		for (let i = 0; i < columnWidths.length; i++) {
-			const mw = maxColumnWidths[i];
-			if (!mw) continue;
-			columnWidths[i] = Math.min(columnWidths[i], mw);
-		}
-		if (!table.terminalWidth) return;
-		const dWidth = (columnWidths.length - 1) * ansiWidth(del);
-		const lineWidth = table.terminalWidth - dWidth;
-		if (lineWidth <= columnWidths.length * 2) {
-			const fixedWidth = Math.max(Math.min(...columnWidths), 5);
-			for (let i = 0; i < columnWidths.length; i++) columnWidths[i] = fixedWidth;
-			return;
-		}
-		if (columnWidths.length === 1) {
-			columnWidths[0] = lineWidth;
-			return;
-		}
-		function trimWidestColumn(neededToTrim) {
-			let first = 0;
-			let second = 0;
-			for (let i = 0; i < columnWidths.length; i++) if (columnWidths[i] > columnWidths[first]) {
-				second = first;
-				first = i;
-			} else if (columnWidths[i] > columnWidths[second]) second = i;
-			const diff$1 = Math.max(columnWidths[first] - columnWidths[second], 1);
-			columnWidths[first] -= Math.min(diff$1, neededToTrim);
-		}
-		for (let sum = sumColumnWidths(); sum > lineWidth; sum = sumColumnWidths()) trimWidestColumn(sum - lineWidth);
-	}
-	recordHeaderWidths(simpleHeader);
-	recordColWidths();
-	adjustColWidths();
-	return [...process$1()];
-}
-function headerDecorator(t) {
-	return chalk.bold(chalk.underline(t));
-}
-function decorateRowWith(row, ...decorators) {
-	return decorators.reduce((row$1, decorator) => row$1.map(decorator), row);
-}
-
 //#endregion
 //#region src/emitters/helpers.ts
 function trimMidPath(s, w, sep$1) {
@@ -354,13 +101,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);
 }
@@ -485,7 +232,7 @@ function commandInit(prog) {
 		"yml",
 		"json",
 		"jsonc"
-	]).default("yaml")).option("--import <path|package>", "Import a configuration file or dictionary package.", collect).option("--locale <locale>", "Define the locale to use when spell checking (e.g., en, en-US, de).").addOption(crOpt("--dictionary <dictionary>", "Enable a dictionary. Can be used multiple times.", collect).default(void 0)).addOption(crOpt("--comments", "Add comments to the config file.").default(void 0).hideHelp()).option("--no-comments", "Do not add comments to the config file.").addOption(crOpt("--remove-comments", "Remove all comments from the config file.").implies({ comments: false })).option("--no-schema", "Do not add the schema reference to the config file.").option("--stdout", "Write the configuration to stdout instead of a file.").action((options) => {
+	]).default("yaml")).option("--import <path|package>", "Import a configuration file or dictionary package.", collect$1).option("--locale <locale>", "Define the locale to use when spell checking (e.g., en, en-US, de).").addOption(crOpt("--dictionary <dictionary>", "Enable a dictionary. Can be used multiple times.", collect$1).default(void 0)).addOption(crOpt("--comments", "Add comments to the config file.").default(void 0).hideHelp()).option("--no-comments", "Do not add comments to the config file.").addOption(crOpt("--remove-comments", "Remove all comments from the config file.").implies({ comments: false })).option("--no-schema", "Do not add the schema reference to the config file.").option("--stdout", "Write the configuration to stdout instead of a file.").action((options) => {
 		return createInit(options);
 	});
 }
@@ -555,60 +302,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 +354,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$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("--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$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).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) {
+	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 +430,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
@@ -802,7 +506,7 @@ function formatWordSingle(s) {
 
 //#endregion
 //#region src/commandSuggestion.ts
-function collect$1(value, previous) {
+function collect(value, previous) {
 	value = value.replace(/^=/, "");
 	if (!previous) return [value];
 	return [...previous, value];
@@ -815,7 +519,7 @@ function asNumber(value, prev) {
 }
 function commandSuggestion(prog) {
 	const suggestionCommand = prog.command("suggestions");
-	suggestionCommand.aliases(["sug", "suggest"]).description("Spelling Suggestions for words.").option("-c, --config <cspell.json>", "Configuration file to use.  By default cspell looks for cspell.json in the current directory.").option("--locale <locale>", "Set language locales. i.e. \"en,fr\" for English and French, or \"en-GB\" for British English.").option("--language-id <language>", "Use programming language. i.e. \"php\" or \"scala\".").addOption(new Option("--languageId <language>", "Use programming language. i.e. \"php\" or \"scala\".").hideHelp()).option("-s, --no-strict", "Ignore case and accents when searching for words.").option("--ignore-case", "Alias of --no-strict.").option("--num-changes <number>", "Number of changes allowed to a word", asNumber, 4).option("--num-suggestions <number>", "Number of suggestions", asNumber, 8).option("--no-include-ties", "Force the number of suggested to be limited, by not including suggestions that have the same edit cost.").option("--stdin", "Use stdin for input.").addOption(new Option("--repl", "REPL interface for looking up suggestions.")).option("-v, --verbose", "Show detailed output.", count, 0).option("-d, --dictionary <dictionary name>", "Use the dictionary specified. Only dictionaries specified will be used.", collect$1).option("--dictionaries <dictionary names...>", "Use the dictionaries specified. Only dictionaries specified will be used.").option("--no-color", "Turn off color.").option("--color", "Force color").arguments("[words...]").action(async (words, options) => {
+	suggestionCommand.aliases(["sug", "suggest"]).description("Spelling Suggestions for words.").option("-c, --config <cspell.json>", "Configuration file to use.  By default cspell looks for cspell.json in the current directory.").option("--locale <locale>", "Set language locales. i.e. \"en,fr\" for English and French, or \"en-GB\" for British English.").option("--language-id <language>", "Use programming language. i.e. \"php\" or \"scala\".").addOption(new Option("--languageId <language>", "Use programming language. i.e. \"php\" or \"scala\".").hideHelp()).option("-s, --no-strict", "Ignore case and accents when searching for words.").option("--ignore-case", "Alias of --no-strict.").option("--num-changes <number>", "Number of changes allowed to a word", asNumber, 4).option("--num-suggestions <number>", "Number of suggestions", asNumber, 8).option("--no-include-ties", "Force the number of suggested to be limited, by not including suggestions that have the same edit cost.").option("--stdin", "Use stdin for input.").addOption(new Option("--repl", "REPL interface for looking up suggestions.")).option("-v, --verbose", "Show detailed output.", count, 0).option("-d, --dictionary <dictionary name>", "Use the dictionary specified. Only dictionaries specified will be used.", collect).option("--dictionaries <dictionary names...>", "Use the dictionaries specified. Only dictionaries specified will be used.").option("--no-color", "Turn off color.").option("--color", "Force color").arguments("[words...]").action(async (words, options) => {
 		parseApplicationFeatureFlags(options.flag);
 		options.useStdin = options.stdin;
 		options.dictionaries = mergeArrays(options.dictionaries, options.dictionary);
@@ -917,7 +621,7 @@ function colorize(fn) {
 //#endregion
 //#region src/commandTrace.ts
 function commandTrace(prog) {
-	return prog.command("trace").description(`Trace words -- Search for words in the configuration and dictionaries.`).option("-c, --config <cspell.json>", "Configuration file to use.  By default cspell looks for cspell.json in the current directory.").option("--locale <locale>", "Set language locales. i.e. \"en,fr\" for English and French, or \"en-GB\" for British English.").option("--language-id <language>", "Use programming language. i.e. \"php\" or \"scala\".").addOption(new Option("--languageId <language>", "Use programming language. i.e. \"php\" or \"scala\".").hideHelp()).option("--allow-compound-words", "Turn on allowCompoundWords").addOption(new Option("--allowCompoundWords", "Turn on allowCompoundWords.").hideHelp()).option("--no-allow-compound-words", "Turn off allowCompoundWords").option("--ignore-case", "Ignore case and accents when searching for words.").option("--no-ignore-case", "Do not ignore case and accents when searching for words.").option("--dictionary <name>", "Enable a dictionary by name. Can be used multiple times.", collect).addOption(new Option("--dictionary-path <format>", "Configure how to display the dictionary path.").choices([
+	return prog.command("trace").description(`Trace words -- Search for words in the configuration and dictionaries.`).option("-c, --config <cspell.json>", "Configuration file to use.  By default cspell looks for cspell.json in the current directory.").option("--locale <locale>", "Set language locales. i.e. \"en,fr\" for English and French, or \"en-GB\" for British English.").option("--language-id <language>", "Use programming language. i.e. \"php\" or \"scala\".").addOption(new Option("--languageId <language>", "Use programming language. i.e. \"php\" or \"scala\".").hideHelp()).option("--allow-compound-words", "Turn on allowCompoundWords").addOption(new Option("--allowCompoundWords", "Turn on allowCompoundWords.").hideHelp()).option("--no-allow-compound-words", "Turn off allowCompoundWords").option("--ignore-case", "Ignore case and accents when searching for words.").option("--no-ignore-case", "Do not ignore case and accents when searching for words.").option("--dictionary <name>", "Enable a dictionary by name. Can be used multiple times.", collect$1).addOption(new Option("--dictionary-path <format>", "Configure how to display the dictionary path.").choices([
 		"hide",
 		"short",
 		"long",
@@ -974,7 +678,7 @@ function groupBy(items, key) {
 //#endregion
 //#region src/globalOptions.ts
 function addGlobalOptionsToAction(command) {
-	command = command.addOption(new Option("-f,--flag <flag:value>", "Declare an execution flag value").hideHelp().argParser(collect));
+	command = command.addOption(new Option("-f,--flag <flag:value>", "Declare an execution flag value").hideHelp().argParser(collect$1));
 	return command;
 }
 function addGlobalOptionsAndHooks(command) {