cspell 10.3.5 → 10.4.0-alpha.1

package/dist/esm/{application-CdcDwTFc.js → application-DRa52DKq.js}

@@ -24,7 +24,7 @@ import { dynamicImport } from "@cspell/dynamic-import";
 import crypto from "node:crypto";
 import streamConsumers from "node:stream/consumers";
 import { getStat, readFileText, toURL } from "cspell-io";
-import { glob } from "tinyglobby";
+import { glob, isDynamicPattern } from "tinyglobby";
 import * as readline from "node:readline";
 import { parse, stringify } from "flatted";
 //#region src/console.ts
@@ -119,6 +119,107 @@ function toApplicationError(e, message) {
 	return new ApplicationError(message ?? err.message, void 0, err);
 }
 //#endregion
+//#region src/formatIssue.ts
+function formatIssue(io, templateStr, issue, maxIssueTextWidth) {
+	function clean(t) {
+		return t.replace(/\s+/, " ");
+	}
+	const { uri = "", filename, row, col, text, context = issue.line, offset } = issue;
+	const textLen = issue.length ?? text.length;
+	const contextLeft = clean(context.text.slice(0, offset - context.offset));
+	const contextRight = clean(context.text.slice(offset + textLen - context.offset));
+	const contextFull = clean(context.text);
+	const padContext = " ".repeat(Math.max(maxIssueTextWidth - text.length, 0));
+	const rowText = row.toString();
+	const colText = col.toString();
+	const padRowCol = " ".repeat(Math.max(1, 8 - (rowText.length + colText.length)));
+	const suggestions = formatSuggestions(io, issue);
+	const msg = issue.message || (issue.isFlagged ? "Forbidden word" : "Unknown word");
+	const messageColored = issue.isFlagged ? `{yellow ${msg}}` : msg;
+	const substitutions = {
+		$col: colText,
+		$contextFull: contextFull,
+		$contextLeft: contextLeft,
+		$contextRight: contextRight,
+		$filename: filename,
+		$padContext: padContext,
+		$padRowCol: padRowCol,
+		$row: rowText,
+		$suggestions: suggestions,
+		$text: text,
+		$uri: uri,
+		$quickFix: formatQuickFix(io, issue),
+		$message: msg,
+		$messageColored: messageColored
+	};
+	const t = templateStr.replaceAll("$messageColored", messageColored);
+	return substitute(makeTemplate(io.chalk)(t), substitutions).trimEnd();
+}
+function formatSuggestions(io, issue) {
+	if (issue.suggestionsEx) return issue.suggestionsEx.map((sug) => sug.isPreferred ? io.chalk.italic(io.chalk.bold(sug.wordAdjustedToMatchCase || sug.word)) + "*" : sug.wordAdjustedToMatchCase || sug.word).join(", ");
+	if (issue.suggestions) return issue.suggestions.join(", ");
+	return "";
+}
+function formatQuickFix(io, issue) {
+	if (!issue.suggestionsEx?.length) return "";
+	const preferred = issue.suggestionsEx.filter((sug) => sug.isPreferred).map((sug) => sug.wordAdjustedToMatchCase || sug.word);
+	if (!preferred.length) return "";
+	return `fix: (${preferred.map((w) => io.chalk.italic(io.chalk.yellow(w))).join(", ")})`;
+}
+function substitute(text, substitutions) {
+	const subs = [];
+	for (const [match, replaceWith] of Object.entries(substitutions)) {
+		const len = match.length;
+		for (let i = text.indexOf(match); i >= 0; i = text.indexOf(match, i)) {
+			const end = i + len;
+			const reg = /\b/y;
+			reg.lastIndex = end;
+			if (reg.test(text)) subs.push([
+				i,
+				end,
+				replaceWith
+			]);
+			i = end;
+		}
+	}
+	subs.sort((a, b) => a[0] - b[0]);
+	let i = 0;
+	function sub(r) {
+		const [a, b, t] = r;
+		const prefix = text.slice(i, a);
+		i = b;
+		return prefix + t;
+	}
+	return subs.map(sub).join("") + text.slice(i);
+}
+function checkTemplate(template) {
+	const chalk = new Chalk();
+	const chalkTemplate = makeTemplate(chalk);
+	const substitutions = {
+		$col: "<col>",
+		$contextFull: "<contextFull>",
+		$contextLeft: "<contextLeft>",
+		$contextRight: "<contextRight>",
+		$filename: "<filename>",
+		$padContext: "<padContext>",
+		$padRowCol: "<padRowCol>",
+		$row: "<row>",
+		$suggestions: "<suggestions>",
+		$text: "<text>",
+		$uri: "<uri>",
+		$quickFix: "<quickFix>",
+		$message: "<message>",
+		$messageColored: "<messageColored>"
+	};
+	try {
+		const problems = [...substitute(chalkTemplate(template), substitutions).matchAll(/\$[a-z]+/gi)].map((m) => m[0]);
+		if (problems.length) throw new Error(`Unresolved template variable${problems.length > 1 ? "s" : ""}: ${problems.map((v) => `'${v}'`).join(", ")}`);
+		return true;
+	} catch (e) {
+		return new ApplicationError(e instanceof Error ? e.message : `${e}`);
+	}
+}
+//#endregion
 //#region src/util/perfMeasurements.ts
 function getPerfMeasurements() {
 	const measurements = performance.getEntriesByType("measure");
@@ -563,6 +664,9 @@ function getReporter(options, config) {
 		filesCached: 0,
 		accumulatedTimeMs: 0,
 		startTime: performance.now(),
+		firstFileStartTime: 0,
+		lastFileEndTime: 0,
+		betweenFilesTimeMs: 0,
 		perf: Object.create(null)
 	};
 	const noColor = options.color === false;
@@ -637,13 +741,19 @@ function getReporter(options, config) {
 			errorCollection.forEach((error) => consoleError(error));
 		}
 		if (options.showPerfSummary) {
-			const elapsedTotal = performance.now() - perfStats.startTime;
+			const now = performance.now();
+			const elapsedTotal = now - perfStats.startTime;
+			const setupTime = (perfStats.firstFileStartTime || now) - perfStats.startTime;
+			const otherTime = elapsedTotal - setupTime - perfStats.accumulatedTimeMs - perfStats.betweenFilesTimeMs;
 			consoleError("-------------------------------------------");
 			consoleError("Performance Summary:");
 			consoleError(`  Files Processed : ${perfStats.filesProcessed.toString().padStart(11)}`);
 			consoleError(`  Files Skipped   : ${perfStats.filesSkipped.toString().padStart(11)}`);
 			consoleError(`  Files Cached    : ${perfStats.filesCached.toString().padStart(11)}`);
+			consoleError(`  Setup Time      : ${setupTime.toFixed(2).padStart(9)}ms`);
 			consoleError(`  Processing Time : ${perfStats.accumulatedTimeMs.toFixed(2).padStart(9)}ms`);
+			consoleError(`  Between Files   : ${perfStats.betweenFilesTimeMs.toFixed(2).padStart(9)}ms`);
+			consoleError(`  Other Time      : ${otherTime.toFixed(2).padStart(9)}ms`);
 			consoleError(`  Total Time      : ${elapsedTotal.toFixed(2).padStart(9)}ms`);
 			const tableStats = {
 				title: chalk.bold("Perf Stats:"),
@@ -755,7 +865,15 @@ function getReporter(options, config) {
 	}
 	function progress(p) {
 		if (!silent && showProgress) reportProgress(stderr, p, rootURL, options);
-		if (p.type === "ProgressFileComplete") collectPerfStats(p);
+		if (p.type === "ProgressFileBegin") {
+			const now = performance.now();
+			perfStats.firstFileStartTime ||= now;
+			if (perfStats.lastFileEndTime) perfStats.betweenFilesTimeMs += now - perfStats.lastFileEndTime;
+		}
+		if (p.type === "ProgressFileComplete") {
+			perfStats.lastFileEndTime = performance.now();
+			collectPerfStats(p);
+		}
 	}
 	return {
 		issue: relativeIssue(silent || !issues ? nullEmitter : genIssueEmitter(stdio, stderr, issueTemplate, uniqueIssues, issuesCollection)),
@@ -764,7 +882,7 @@ function getReporter(options, config) {
 		debug: emitters.Debug,
 		progress,
 		result: !silent && summary ? resultEmitter : nullEmitter,
-		features: void 0
+		features: { issueType: true }
 	};
 }
 function extractNotableBySelfTimeInGroup(measurements) {
@@ -788,109 +906,10 @@ function extractNotableBySelfTimeInGroup(measurements) {
 	if (highest) notable.add(highest);
 	return notable;
 }
-function formatIssue(io, templateStr, issue, maxIssueTextWidth) {
-	function clean(t) {
-		return t.replace(/\s+/, " ");
-	}
-	const { uri = "", filename, row, col, text, context = issue.line, offset } = issue;
-	const textLen = issue.length ?? text.length;
-	const contextLeft = clean(context.text.slice(0, offset - context.offset));
-	const contextRight = clean(context.text.slice(offset + textLen - context.offset));
-	const contextFull = clean(context.text);
-	const padContext = " ".repeat(Math.max(maxIssueTextWidth - text.length, 0));
-	const rowText = row.toString();
-	const colText = col.toString();
-	const padRowCol = " ".repeat(Math.max(1, 8 - (rowText.length + colText.length)));
-	const suggestions = formatSuggestions(io, issue);
-	const msg = issue.message || (issue.isFlagged ? "Forbidden word" : "Unknown word");
-	const messageColored = issue.isFlagged ? `{yellow ${msg}}` : msg;
-	const substitutions = {
-		$col: colText,
-		$contextFull: contextFull,
-		$contextLeft: contextLeft,
-		$contextRight: contextRight,
-		$filename: filename,
-		$padContext: padContext,
-		$padRowCol: padRowCol,
-		$row: rowText,
-		$suggestions: suggestions,
-		$text: text,
-		$uri: uri,
-		$quickFix: formatQuickFix(io, issue),
-		$message: msg,
-		$messageColored: messageColored
-	};
-	const t = templateStr.replaceAll("$messageColored", messageColored);
-	return substitute(makeTemplate(io.chalk)(t), substitutions).trimEnd();
-}
-function formatSuggestions(io, issue) {
-	if (issue.suggestionsEx) return issue.suggestionsEx.map((sug) => sug.isPreferred ? io.chalk.italic(io.chalk.bold(sug.wordAdjustedToMatchCase || sug.word)) + "*" : sug.wordAdjustedToMatchCase || sug.word).join(", ");
-	if (issue.suggestions) return issue.suggestions.join(", ");
-	return "";
-}
-function formatQuickFix(io, issue) {
-	if (!issue.suggestionsEx?.length) return "";
-	const preferred = issue.suggestionsEx.filter((sug) => sug.isPreferred).map((sug) => sug.wordAdjustedToMatchCase || sug.word);
-	if (!preferred.length) return "";
-	return `fix: (${preferred.map((w) => io.chalk.italic(io.chalk.yellow(w))).join(", ")})`;
-}
-function substitute(text, substitutions) {
-	const subs = [];
-	for (const [match, replaceWith] of Object.entries(substitutions)) {
-		const len = match.length;
-		for (let i = text.indexOf(match); i >= 0; i = text.indexOf(match, i)) {
-			const end = i + len;
-			const reg = /\b/y;
-			reg.lastIndex = end;
-			if (reg.test(text)) subs.push([
-				i,
-				end,
-				replaceWith
-			]);
-			i = end;
-		}
-	}
-	subs.sort((a, b) => a[0] - b[0]);
-	let i = 0;
-	function sub(r) {
-		const [a, b, t] = r;
-		const prefix = text.slice(i, a);
-		i = b;
-		return prefix + t;
-	}
-	return subs.map(sub).join("") + text.slice(i);
-}
 function assertCheckTemplate(template) {
 	const r = checkTemplate(template);
 	if (r instanceof Error) throw r;
 }
-function checkTemplate(template) {
-	const chalk = new Chalk();
-	const chalkTemplate = makeTemplate(chalk);
-	const substitutions = {
-		$col: "<col>",
-		$contextFull: "<contextFull>",
-		$contextLeft: "<contextLeft>",
-		$contextRight: "<contextRight>",
-		$filename: "<filename>",
-		$padContext: "<padContext>",
-		$padRowCol: "<padRowCol>",
-		$row: "<row>",
-		$suggestions: "<suggestions>",
-		$text: "<text>",
-		$uri: "<uri>",
-		$quickFix: "<quickFix>",
-		$message: "<message>",
-		$messageColored: "<messageColored>"
-	};
-	try {
-		const problems = [...substitute(chalkTemplate(template), substitutions).matchAll(/\$[a-z]+/gi)].map((m) => m[0]);
-		if (problems.length) throw new Error(`Unresolved template variable${problems.length > 1 ? "s" : ""}: ${problems.map((v) => `'${v}'`).join(", ")}`);
-		return true;
-	} catch (e) {
-		return new ApplicationError(e instanceof Error ? e.message : `${e}`);
-	}
-}
 //#endregion
 //#region src/config/adjustConfig.ts
 async function fileExists(url) {
@@ -1183,7 +1202,9 @@ const environmentKeys = {
 	CSPELL_ENABLE_DICTIONARY_LOG_FIELDS: "CSPELL_ENABLE_DICTIONARY_LOG_FIELDS",
 	CSPELL_GLOB_ROOT: "CSPELL_GLOB_ROOT",
 	CSPELL_CONFIG_PATH: "CSPELL_CONFIG_PATH",
-	CSPELL_DEFAULT_CONFIG_PATH: "CSPELL_DEFAULT_CONFIG_PATH"
+	CSPELL_DEFAULT_CONFIG_PATH: "CSPELL_DEFAULT_CONFIG_PATH",
+	CSPELL_FOLLOW_SYMLINKS: "CSPELL_FOLLOW_SYMLINKS",
+	CSPELL_GLOB_SYMLINKS: "CSPELL_GLOB_SYMLINKS"
 };
 function setEnvironmentVariable(key, value) {
 	process.env[key] = value;
@@ -1213,7 +1234,7 @@ try {
 const pkgDir = _dirname;
 const npmPackage = {
 	name: "cspell",
-	version: "10.3.5",
+	version: "10.4.0-alpha.1",
 	engines: { node: ">=22.18.0" }
 };
 //#endregion
@@ -1351,7 +1372,7 @@ var LintReporter = class {
 		});
 	}
 	emitProgressComplete(filename, fileNum, fileCount, result) {
-		const numIssues = result.issues.filter((issue) => filterFeatureIssues({}, issue, result.reportIssueOptions)).length;
+		const numIssues = result.issues.filter((issue) => filterFeatureIssues({ issueType: true }, issue, result.reportIssueOptions)).length;
 		for (const reporter of this.#reporters) {
 			const progress = clean({
 				type: "ProgressFileComplete",
@@ -1448,7 +1469,7 @@ async function globP(pattern, options) {
 		dot,
 		ignore,
 		absolute: true,
-		followSymbolicLinks: false,
+		followSymbolicLinks: options?.followSymlinks ?? false,
 		expandDirectories: false
 	});
 	const compare = new Intl.Collator("en").compare;
@@ -1992,18 +2013,20 @@ var DiskCache = class {
 	cspellVersion;
 	useUniversalCache;
 	fileEntryCache;
+	optionsKey;
 	cacheDir;
 	dependencyCache = /* @__PURE__ */ new Map();
 	dependencyCacheTree = {};
 	objectCollection = new ShallowObjectCollection();
 	ocCacheFileResult = new ShallowObjectCollection();
 	version;
-	constructor(cacheFileLocation, useCheckSum, cspellVersion, useUniversalCache, fileEntryCache) {
+	constructor(cacheFileLocation, useCheckSum, cspellVersion, useUniversalCache, fileEntryCache, optionsKey) {
 		this.cacheFileLocation = cacheFileLocation;
 		this.useCheckSum = useCheckSum;
 		this.cspellVersion = cspellVersion;
 		this.useUniversalCache = useUniversalCache;
 		this.fileEntryCache = fileEntryCache;
+		this.optionsKey = optionsKey;
 		this.cacheDir = fileURLToPath(new URL("./", cacheFileLocation));
 		this.version = calcVersion(cspellVersion);
 	}
@@ -2014,7 +2037,8 @@ var DiskCache = class {
 		const data = meta?.data;
 		const result = data?.r;
 		const versionMatches = this.version === data?.v;
-		if (fileDescriptor.notFound || fileDescriptor.changed || !meta || !result || !versionMatches || !await this.checkDependencies(data.d)) return;
+		const optionsMatch = this.optionsKey === data?.o;
+		if (fileDescriptor.notFound || fileDescriptor.changed || !meta || !result || !versionMatches || !optionsMatch || !await this.checkDependencies(data.d)) return;
 		const dd = { ...data };
 		if (dd.d) dd.d = setTreeEntry(this.dependencyCacheTree, dd.d);
 		dd.r = dd.r && this.normalizeResult(dd.r);
@@ -2036,7 +2060,8 @@ var DiskCache = class {
 		meta.data = this.objectCollection.get({
 			v: this.version,
 			r: this.normalizeResult(result),
-			d: await this.calcDependencyHashes(dependsUponFiles)
+			d: await this.calcDependencyHashes(dependsUponFiles),
+			...this.optionsKey ? { o: this.optionsKey } : {}
 		});
 	}
 	async reconcile() {
@@ -2138,8 +2163,8 @@ async function getDependencyForUrl(remoteUrl) {
 		};
 	}
 }
-async function createDiskCache(cacheFileLocation, useCheckSum, cspellVersion, useUniversalCache) {
-	return new DiskCache(cacheFileLocation, useCheckSum, cspellVersion, useUniversalCache, await createFromFile(cacheFileLocation, useCheckSum, useUniversalCache));
+async function createDiskCache(cacheFileLocation, useCheckSum, cspellVersion, useUniversalCache, optionsKey) {
+	return new DiskCache(cacheFileLocation, useCheckSum, cspellVersion, useUniversalCache, await createFromFile(cacheFileLocation, useCheckSum, useUniversalCache), optionsKey);
 }
 function getTreeEntry(tree, keys) {
 	let r = tree;
@@ -2208,7 +2233,7 @@ async function createCache(options) {
 	const useChecksum = cacheStrategy === "content";
 	const version = normalizeVersion(options.version);
 	const useUniversal = options.cacheFormat === "universal";
-	const cache = useCache ? await createDiskCache(location, useChecksum, version, useUniversal) : new DummyCache();
+	const cache = useCache ? await createDiskCache(location, useChecksum, version, useUniversal, options.optionsKey) : new DummyCache();
 	if (reset) await cache.reset();
 	return cache;
 }
@@ -2220,6 +2245,8 @@ async function calcCacheSettings(config, cacheOptions, root) {
 	const cacheFormat = cacheOptions.cacheFormat ?? cs.cacheFormat ?? "universal";
 	const optionals = {};
 	if (cacheOptions.cacheReset) optionals.reset = true;
+	const optionsKey = calcOptionsKey(cacheOptions);
+	if (optionsKey) optionals.optionsKey = optionsKey;
 	return {
 		...optionals,
 		useCache,
@@ -2229,6 +2256,17 @@ async function calcCacheSettings(config, cacheOptions, root) {
 		cacheFormat
 	};
 }
+function calcOptionsKey(cacheOptions) {
+	const { languageId, locale, report, showSuggestions, validateDirectives } = cacheOptions;
+	const set = Object.entries({
+		languageId: languageId || void 0,
+		locale: locale || void 0,
+		report: report || void 0,
+		showSuggestions,
+		validateDirectives
+	}).filter(([, value]) => value !== void 0);
+	return set.length ? JSON.stringify(Object.fromEntries(set)) : void 0;
+}
 async function resolveCacheLocation(cacheLocation) {
 	try {
 		if ((await stat(cacheLocation)).isFile()) return cacheLocation;
@@ -2288,6 +2326,48 @@ async function readConfigHandleError(filename) {
 	}
 }
 //#endregion
+//#region src/util/symlinks.ts
+function createSymlinkChecker(root) {
+	const rootPath = path$1.resolve(root);
+	const cache = /* @__PURE__ */ new Map();
+	function isSymlink(filename) {
+		let found = cache.get(filename);
+		if (!found) {
+			found = promises.lstat(filename).then((s) => s.isSymbolicLink(), () => false);
+			cache.set(filename, found);
+		}
+		return found;
+	}
+	async function isReachedThroughSymlink(filename) {
+		if (filename === "stdin" || isStdinUrl(filename)) return false;
+		const absFilename = path$1.resolve(rootPath, filename);
+		const rel = path$1.relative(rootPath, absFilename);
+		if (!rel) return false;
+		if (rel === ".." || rel.startsWith(".." + path$1.sep) || path$1.isAbsolute(rel)) return isSymlink(absFilename);
+		let current = rootPath;
+		for (const segment of rel.split(path$1.sep)) {
+			current = path$1.join(current, segment);
+			if (await isSymlink(current)) return true;
+		}
+		return false;
+	}
+	async function isGlobReachedThroughSymlink(pattern) {
+		const segments = pattern.split("/");
+		const fixed = [];
+		for (const segment of segments) {
+			if (isDynamicPattern(segment)) break;
+			fixed.push(segment);
+		}
+		const base = fixed.join("/");
+		if (!base) return false;
+		return isReachedThroughSymlink(path$1.resolve(rootPath, base));
+	}
+	return {
+		isReachedThroughSymlink,
+		isGlobReachedThroughSymlink
+	};
+}
+//#endregion
 //#region src/util/timer.ts
 function getTimeMeasurer() {
 	const timer = createPerfTimer("timer");
@@ -2687,13 +2767,30 @@ function prefetch(fileToProcess, cfg) {
 	const reportIssueOptions = extractReporterIssueOptions(cfg.config);
 	async function fetch() {
 		const getElapsedTimeMs = getTimeMeasurer();
+		if (!cfg.followSymlinks && await cfg.symlinks.isReachedThroughSymlink(filename)) {
+			const skipReason = "referenced by a symbolic link, use --follow-symlinks to check it";
+			if (cfg.forceCheck) return {
+				skip: true,
+				skipReason,
+				error: new LinterError(`File ${skipReason}: "${filename}"`)
+			};
+			return {
+				skip: true,
+				skipReason: cfg.verbose ? skipReason : void 0
+			};
+		}
 		const cachedResult = await cfg.cache.getCachedLintResults(filename);
 		if (cachedResult) return { fileResult: {
 			...cachedResult,
 			elapsedTimeMs: getElapsedTimeMs()
 		} };
 		const uri = filenameToUri(filename, cfg.root).href;
-		const checkResult = await shouldCheckDocument({ uri }, { forceCheck: cfg.forceCheck }, cfg.config);
+		const { languageId, locale } = cfg;
+		const checkResult = await shouldCheckDocument({
+			uri,
+			languageId,
+			locale
+		}, { forceCheck: cfg.forceCheck }, cfg.config);
 		if (!checkResult.shouldCheck) return {
 			skip: true,
 			skipReason: checkResult.reason || "Ignored by configuration."
@@ -2725,6 +2822,11 @@ async function processFiles(files, options) {
 		root: options.cfg.root,
 		maxFileSize: options.cfg.maxFileSize,
 		forceCheck: !!options.cfg.options.forceCheck,
+		symlinks: options.symlinks ?? createSymlinkChecker(options.cfg.root),
+		followSymlinks: !!options.followSymlinks,
+		verbose: options.verboseLevel > 0,
+		languageId: options.cfg.options.languageId || void 0,
+		locale: options.cfg.locale || void 0,
 		config: options.configInfo.config,
 		cache
 	};
@@ -2760,17 +2862,24 @@ async function processFiles(files, options) {
 		if (fetchResult instanceof Error) throw fetchResult;
 		const fileNum = sequence + 1;
 		reporter.emitProgressBegin(filename, fileNum, pf.sequenceSize ?? sequence);
-		if (fetchResult?.skip) return {
-			filename,
-			sequence,
-			sequenceSize,
-			result: {
+		if (fetchResult?.skip) {
+			const result = {
 				...emptyResult,
 				fileInfo: { filename },
 				elapsedTimeMs: getElapsedTimeMs(),
 				skippedReason: fetchResult.skipReason
+			};
+			if (fetchResult.error) {
+				new ReportItemCollector(result).error("Linter:", fetchResult.error);
+				result.errors = 1;
 			}
-		};
+			return {
+				filename,
+				sequence,
+				sequenceSize,
+				result
+			};
+		}
 		return {
 			filename,
 			sequence,
@@ -2826,7 +2935,7 @@ function runResult(init = {}) {
 	};
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.148.0/helpers/esm/usingCtx.js
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/usingCtx.js
 function _usingCtx() {
 	var r = "function" == typeof SuppressedError ? SuppressedError : function(r, e) {
 		var n = Error();
@@ -2935,7 +3044,8 @@ async function runLint(cfg) {
 					...cfg.options,
 					version
 				}, root);
-				const filesToCheck = await determineFilesToCheck(configInfo, cfg, reporter, globInfo);
+				const symlinks = createSymlinkChecker(root);
+				const filesToCheck = await determineFilesToCheck(configInfo, cfg, reporter, globInfo, symlinks);
 				const processFilesOptions = {
 					chalk,
 					configInfo,
@@ -2945,7 +3055,9 @@ async function runLint(cfg) {
 					configErrors,
 					userSettings: configInfo.config,
 					lintReporter: reporter,
-					cacheSettings
+					cacheSettings,
+					symlinks,
+					followSymlinks: filesToCheck.followSymlinks
 				};
 				const result = await processFiles(filesToCheck.files, processFilesOptions);
 				if (configErrorCount && cfg.options.exitCode !== false) result.errors ||= configErrorCount;
@@ -3026,10 +3138,11 @@ function filesToProcess(files) {
 		sequenceSize
 	}));
 }
-async function determineFilesToCheck(configInfo, cfg, reporter, globInfo) {
+async function determineFilesToCheck(configInfo, cfg, reporter, globInfo, symlinks) {
 	const result = {
 		files: [],
-		numFiles: 0
+		numFiles: 0,
+		followSymlinks: false
 	};
 	function countFiles(fnKeep) {
 		if (!fnKeep) return () => {
@@ -3047,6 +3160,13 @@ async function determineFilesToCheck(configInfo, cfg, reporter, globInfo) {
 	async function determineFilesToCheckFromCliFiles() {
 		const { fileLists } = cfg;
 		const hasFileLists = !!fileLists.length;
+		const followSymlinks = cfg.options.followSymlinks ?? truthy(getEnvironmentVariable("CSPELL_FOLLOW_SYMLINKS"));
+		result.followSymlinks = followSymlinks;
+		const keepSymlinks = (fn) => followSymlinks ? fn : async (file) => await symlinks.isReachedThroughSymlink(file) || fn(file);
+		if (!followSymlinks) for (const fileList of fileLists) {
+			if (fileList === "stdin") continue;
+			if (await symlinks.isReachedThroughSymlink(path$1.resolve(fileList))) throw new ApplicationError(`Error reading file list from: "${fileList}". It is referenced by a symbolic link, use --follow-symlinks to read it.`);
+		}
 		const { gitIgnore, allGlobs, excludeGlobs, normalizedExcludes } = globInfo;
 		const { root } = cfg;
 		const globsToExcludeRaw = [...configInfo.config.ignorePaths || [], ...excludeGlobs];
@@ -3066,8 +3186,8 @@ async function determineFilesToCheck(configInfo, cfg, reporter, globInfo) {
 		if (enableGlobDot !== void 0) globOptions.dot = enableGlobDot;
 		const includeFilterCountSkipped = countFiles(cfg.options.forceCheck && !cfg.fileGlobs.length ? () => true : createIncludeFileFilterFn(allGlobs, root, enableGlobDot));
 		const rawCliFiles = cfg.files?.map((file) => resolveFilename(file, root)).filter(includeFilterCountSkipped);
-		const cliFiles = cfg.options.mustFindFiles ? rawCliFiles : rawCliFiles && pipeAsync(rawCliFiles, opFilterAsync(isFile));
-		const foundFiles = hasFileLists ? concatAsyncIterables(cliFiles, await useFileLists(fileLists, includeFilterCountSkipped)) : cliFiles || [];
+		const cliFiles = cfg.options.mustFindFiles ? rawCliFiles : rawCliFiles && pipeAsync(rawCliFiles, opFilterAsync(keepSymlinks(isFile)));
+		const foundFiles = hasFileLists ? concatAsyncIterables(cliFiles, await useFileLists(fileLists, includeFilterCountSkipped, keepSymlinks(isNotDir))) : cliFiles || [];
 		const opFilterExcludedFiles = opFilter(filterOutExcludedFilesFn(globMatcher));
 		const filtered = !cfg.options.forceCheck && gitIgnore ? await gitIgnore.filterOutIgnored(foundFiles) : foundFiles;
 		return isAsyncIterable(filtered) ? pipeAsync(filtered, opFilterExcludedFiles, filesToProcessAsync) : filesToProcess(pipe(filtered, opFilterExcludedFiles));
@@ -3090,8 +3210,19 @@ async function determineFilesToCheck(configInfo, cfg, reporter, globInfo) {
 		};
 		const enableGlobDot = cfg.enableGlobDot ?? configInfo.config.enableGlobDot;
 		if (enableGlobDot !== void 0) globOptions.dot = enableGlobDot;
+		const globSymlinks = cfg.options.globSymlinks ?? truthy(getEnvironmentVariable("CSPELL_GLOB_SYMLINKS"));
+		globOptions.followSymlinks = globSymlinks;
+		result.followSymlinks = globSymlinks;
 		const opFilterExcludedFiles = opFilter(filterOutExcludedFilesFn(globMatcher));
-		const foundFiles = await findFiles(fileGlobs, globOptions);
+		const globsToSearch = [];
+		for (const glob of fileGlobs) {
+			if (!globSymlinks && await symlinks.isGlobReachedThroughSymlink(glob)) {
+				if (calcVerboseLevel(cfg.options) > 0) reporter.info(`Glob not searched: "${glob}" goes through a symbolic link.`, MessageTypes$1.Info);
+				continue;
+			}
+			globsToSearch.push(glob);
+		}
+		const foundFiles = await findFiles(globsToSearch, globOptions);
 		const filtered = gitIgnore ? await gitIgnore.filterOutIgnored(foundFiles) : foundFiles;
 		return isAsyncIterable(filtered) ? pipeAsync(filtered, opFilterExcludedFiles, filesToProcessAsync, opFilter(countFiles())) : filesToProcess(pipe(filtered, opFilterExcludedFiles)).filter(countFiles());
 	}
@@ -3158,9 +3289,9 @@ async function generateGitIgnore(roots) {
 	}
 	return new GitIgnore(root?.map((p) => path$1.resolve(p)));
 }
-async function useFileLists(fileListFiles, filterFiles) {
+async function useFileLists(fileListFiles, filterFiles, filterNotDir) {
 	const files = readFileListFiles(fileListFiles);
-	return pipeAsync(files, opFilter(filterFiles), opFilterAsync(isNotDir));
+	return pipeAsync(files, opFilter(filterFiles), opFilterAsync(filterNotDir));
 }
 function createIncludeFileFilterFn(includeGlobPatterns, root, dot) {
 	if (!includeGlobPatterns?.length) return () => true;
@@ -3227,6 +3358,7 @@ var LintRequest = class {
 		}];
 		this.cspellSettingsFromCliOptions = {
 			...noConfigSearch !== void 0 ? { noConfigSearch } : {},
+			...options.validateDirectives !== void 0 ? { validateDirectives: options.validateDirectives } : {},
 			...extractUnknownWordsConfig(options),
 			languageSettings
 		};
@@ -3534,4 +3666,4 @@ function parseApplicationFeatureFlags(flags) {
 //#endregion
 export { ApplicationError as C, width as S, console as T, padLeft as _, parseApplicationFeatureFlags as a, pruneAnsiTextEnd as b, listDictionaries as c, validateUnitSize as d, unindent as f, tableToLines as g, getReporter as h, lint as i, ReportChoicesAll as l, npmPackage as m, checkText as n, suggestions as o, DEFAULT_CACHE_LOCATION as p, createInit as r, trace as s, IncludeExcludeFlag as t, cvtLinterCliCommandOptionsToLinterCliOptions as u, padWidth as v, CheckFailed as w, pruneAnsiTextStart as x, ansiWidth as y };
 
-//# sourceMappingURL=application-CdcDwTFc.js.map
+//# sourceMappingURL=application-DRa52DKq.js.map

package/dist/esm/application.d.ts

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

package/dist/esm/application.js

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