cspell 10.4.0-alpha.1 → 10.4.1

package/README.md

@@ -12,7 +12,7 @@ If our spell checkers save you time, please consider supporting their developmen
 
 Please show your support through one of the following sites:
 
-[![GitHub Sponsor](https://cspell.org/img/sponsor/github-sponsor-176px.png)](https://github.com/sponsors/streetsidesoftware) [![PayPal](https://cspell.org/img/sponsor/paypal-176px.png)](https://www.paypal.com/donate/?hosted_button_id=26LNBP2Q6MKCY) [![Open Collective](https://cspell.org/img/sponsor/open-collective-176px.png)](https://opencollective.com/cspell) [![CSpell](https://cspell.org/img/sponsor/cspell-176px.png)](https://streetsidesoftware.com/sponsor/)
+[![GitHub Sponsor](https://cspell.org/img/sponsor/github-sponsor-176px.png)](https://github.com/sponsors/streetsidesoftware) [![PayPal](https://cspell.org/img/sponsor/paypal-176px.png)](https://www.paypal.com/donate/?hosted_button_id=26LNBP2Q6MKCY) [![Open Collective](https://cspell.org/img/sponsor/open-collective-176px.png)](https://opencollective.com/cspell) [![CSpell](https://cspell.org/img/sponsor/cspell-176px.png)](https://streetsidesoftware.com/sponsor/)
 
 <!--- @@inject-end: ../../static/sponsor.md --->
 

package/dist/esm/app.d.ts

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

package/dist/esm/app.js

@@ -1,10 +1,11 @@
-import { C as ApplicationError, S as width, T as console, _ as padLeft, a as parseApplicationFeatureFlags, b as pruneAnsiTextEnd, c as listDictionaries, d as validateUnitSize, f as unindent, g as tableToLines, i as lint, l as ReportChoicesAll, m as npmPackage, n as checkText, o as suggestions, p as DEFAULT_CACHE_LOCATION, r as createInit, s as trace, t as IncludeExcludeFlag, u as cvtLinterCliCommandOptionsToLinterCliOptions, v as padWidth, w as CheckFailed, x as pruneAnsiTextStart, y as ansiWidth } from "./application-DRa52DKq.js";
+import { C as CheckFailed, S as ApplicationError, _ as padWidth, a as parseApplicationFeatureFlags, b as pruneAnsiTextStart, c as listDictionaries, d as validateUnitSize, f as DEFAULT_CACHE_LOCATION, g as padLeft, h as tableToLines, i as lint, l as ReportChoicesAll, n as checkText, o as suggestions, p as npmPackage, r as createInit, s as trace, t as IncludeExcludeFlag, u as cvtLinterCliCommandOptionsToLinterCliOptions, v as ansiWidth, w as console, x as width, y as pruneAnsiTextEnd } from "./application-9lyhPNzW.js";
 import { Link } from "cspell-lib";
 import chalk from "chalk";
 import * as iPath from "node:path";
+import { unindent } from "@streetsidesoftware/unindent";
 import { Option, program } from "commander";
 import { satisfies } from "semver";
-//#region src/commandCheck.ts
+// src/commandCheck.ts
 function commandCheck(prog) {
 	return prog.command("check <files...>").description("Spell check file(s) and display the result. The full file is displayed in color.").option("-c, --config <cspell.json>", "Configuration file to use.  By default cspell looks for cspell.json in the current directory.").option("--validate-directives", "Validate in-document CSpell directives.").option("--no-validate-directives", "Do not validate in-document CSpell directives.").option("--no-color", "Turn off color.").option("--color", "Force color").option("--json", "Output results in JSON format.").option("--no-exit-code", "Do not return an exit code if issues are found.").addOption(new Option("--default-configuration", "Load the default configuration and dictionaries.").hideHelp()).addOption(new Option("--no-default-configuration", "Do not load the default configuration and dictionaries.")).action(async (files, options) => {
 		const useExitCode = options.exitCode ?? true;
@@ -59,8 +60,7 @@ async function processRequestJSON(files, options) {
 function isErrNoEnt(error) {
 	return error?.code === "ENOENT";
 }
-//#endregion
-//#region src/commandHelpers.ts
+// src/commandHelpers.ts
 /**
 * Collects string values into an array.
 * @param value the new value(s) to collect.
@@ -96,8 +96,7 @@ function crOpt(name, description, parseArg, defaultValue) {
 	if (defaultValue !== void 0) option.default(defaultValue);
 	return option;
 }
-//#endregion
-//#region src/util/outputWidth.ts
+// src/util/outputWidth.ts
 /**
 * The width to format output for.
 * `COLUMNS` wins when it is a positive integer, otherwise the width of the stream if it has one.
@@ -109,8 +108,7 @@ function parseColumns(value) {
 	if (!value || !/^\s*\d+\s*$/.test(value)) return void 0;
 	return Number.parseInt(value, 10) || void 0;
 }
-//#endregion
-//#region src/emitters/helpers.ts
+// src/emitters/helpers.ts
 function trimMidPath(s, w, sep) {
 	if (s.length <= w) return s;
 	const parts = s.split(sep);
@@ -161,8 +159,7 @@ function formatDictionaryLocation(dictSource, maxWidth, { cwd, dictionaryPathFor
 	relPath = isNodeModule ? relPath.slice(idxNodeModule) : relPath;
 	return trimMidPath(relPath.length < dictSource.length ? relPath : dictSource, maxWidth, iPath.sep);
 }
-//#endregion
-//#region src/emitters/dictionaryListEmitter.ts
+// src/emitters/dictionaryListEmitter.ts
 const maxWidth$1 = 120;
 function emitListDictionariesResults(results, options) {
 	const report = calcListDictsResultsReport(results, options);
@@ -232,8 +229,7 @@ function dictTableRowToTableRow(row) {
 function colorize$1(fn) {
 	return (s) => s ? fn(s) : "";
 }
-//#endregion
-//#region src/emitters/DictionaryPathFormat.ts
+// src/emitters/DictionaryPathFormat.ts
 const formats = {
 	full: true,
 	hide: true,
@@ -244,16 +240,14 @@ function isDictionaryPathFormat(value) {
 	if (!value || typeof value !== "string") return false;
 	return value in formats;
 }
-//#endregion
-//#region src/util/canUseColor.ts
+// src/util/canUseColor.ts
 function canUseColor(colorOption) {
 	if (colorOption !== void 0) return colorOption;
 	if (!("NO_COLOR" in process.env)) return void 0;
 	if (!process.env["NO_COLOR"] || process.env["NO_COLOR"] === "false") return void 0;
 	return false;
 }
-//#endregion
-//#region src/commandDictionaries.ts
+// src/commandDictionaries.ts
 function commandDictionaries(prog) {
 	return prog.command("dictionaries").description(`List dictionaries`).option("-c, --config <cspell.json>", "Configuration file to use.  By default cspell looks for cspell.json in the current directory.").addOption(crOpt("--path-format <format>", "Configure how to display the dictionary path.").choices([
 		"hide",
@@ -271,20 +265,18 @@ function commandDictionaries(prog) {
 		});
 	});
 }
-//#endregion
-//#region src/commandInit.ts
+// src/commandInit.ts
 function commandInit(prog) {
-	return prog.command("init").description("Initialize a CSpell configuration file.").addOption(crOpt("-c, --config <path>", "Path to the CSpell configuration file. Conflicts with --output and --format.").conflicts(["output", "format"])).option("-o, --output <path>", "Define where to write file.").addOption(crOpt("--format <format>", "Define the format of the file.").choices([
+	return prog.command("init").description("Initialize a CSpell configuration file.").addOption(crOpt("-c, --config <path>", "Path to the CSpell configuration file. Defaults to the one in the current directory. Conflicts with --output and --format.").conflicts(["output", "format"])).option("-o, --output <path>", "Define where to write a new file instead of using an existing config.").addOption(crOpt("--format <format>", "Define the format of a new file. Default: yaml.").choices([
 		"yaml",
 		"yml",
 		"json",
 		"jsonc"
-	]).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) => {
+	])).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 })).addOption(crOpt("--schema", "Add or update the schema reference. Default for a config with no settings.").default(void 0)).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);
 	});
 }
-//#endregion
-//#region src/link.ts
+// src/link.ts
 const listGlobalImports = Link.listGlobalImports;
 const addPathsToGlobalImports = Link.addPathsToGlobalImports;
 const removePathsFromGlobalImports = Link.removePathsFromGlobalImports;
@@ -324,8 +316,7 @@ function addPathsToGlobalImportsResultToTable(results) {
 		rows: results.resolvedSettings.map(toColumns)
 	};
 }
-//#endregion
-//#region src/commandLink.ts
+// src/commandLink.ts
 function commandLink(prog) {
 	const linkCommand = prog.command("link").description("Link dictionaries and other settings to the cspell global config.");
 	linkCommand.command("list", { isDefault: true }).alias("ls").description("List currently linked configurations.").action(async () => {
@@ -347,8 +338,7 @@ function commandLink(prog) {
 	});
 	return linkCommand;
 }
-//#endregion
-//#region src/commandLint.ts
+// src/commandLint.ts
 const usage = `\
 [options] [globs...] [file://<path> ...]
                    [stdin[://<path>]]
@@ -468,8 +458,20 @@ function helpIssueTemplate(opts) {
 * @returns
 */
 function augmentCommandHelp(context) {
+	return lintHelpAfterOptions(context.command, "Hidden Options:");
+}
+/**
+* The extra lint help for `cspell --help`.
+* The program answers `--help` before the lint options are parsed, so parse them from its arguments.
+* @param context - the program's help context.
+* @param lintCommand - the lint command.
+*/
+function lintHelpForProgram(context, lintCommand) {
+	lintCommand.parseOptions(context.command.args);
+	return lintHelpAfterOptions(lintCommand, `Hidden options for "${lintCommand.name()}":`);
+}
+function lintHelpAfterOptions(command, hiddenOptionsHeading) {
 	const output = [];
-	const command = context.command;
 	const opts = command.opts();
 	const showHidden = !!opts.verbose;
 	const hiddenHelp = [];
@@ -478,7 +480,7 @@ function augmentCommandHelp(context) {
 	const hiddenOptions = command.options.filter((opt) => opt.hidden && showHidden);
 	const flagColWidth = Math.max(...command.options.map((opt) => opt.flags.length), 0);
 	for (const options of hiddenOptions) {
-		if (!hiddenHelp.length) hiddenHelp.push("\nHidden Options:");
+		if (!hiddenHelp.length) hiddenHelp.push("\n" + hiddenOptionsHeading);
 		hiddenHelp.push(help.formatItem(options.flags, flagColWidth, options.description, help));
 	}
 	output.push(...hiddenHelp, advanced);
@@ -491,8 +493,7 @@ function validateMaxFileSize(size) {
 function increaseVerbosity(_dummyValue, previous) {
 	return previous + 1;
 }
-//#endregion
-//#region src/emitters/suggestionsEmitter.ts
+// src/emitters/suggestionsEmitter.ts
 const regExpRTL = /([ \u0591-\u07FF\uFB1D-\uFDFD\uFE70-\uFEFC]+)/g;
 function reverseRtlText(s) {
 	return s.replaceAll(regExpRTL, (s) => [...s].reverse().join(""));
@@ -556,8 +557,7 @@ function formatWordSingle(s) {
 	word = s.isPreferred ? chalk.yellow(word + " *") : word;
 	return word;
 }
-//#endregion
-//#region src/commandSuggestion.ts
+// src/commandSuggestion.ts
 function collect(value, previous) {
 	value = value.replace(/^=/, "");
 	if (!previous) return [value];
@@ -588,8 +588,7 @@ function mergeArrays(a, b) {
 	if (b === void 0) return a;
 	return [...a, ...b];
 }
-//#endregion
-//#region src/emitters/traceEmitter.ts
+// src/emitters/traceEmitter.ts
 const maxWidth = 120;
 function emitTraceResults(word, found, results, options) {
 	const report = calcTraceResultsReport(word, found, results, options);
@@ -669,8 +668,7 @@ function calcFoundChar(r) {
 function colorize(fn) {
 	return (s) => s ? fn(s) : "";
 }
-//#endregion
-//#region src/commandTrace.ts
+// 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$1).option("--no-dictionary <name>", "Disable a dictionary by name. Can be used multiple times.", prefixCollect("!")).addOption(new Option("--dictionary-path <format>", "Configure how to display the dictionary path.").choices([
 		"hide",
@@ -725,8 +723,7 @@ function groupBy(items, key) {
 	}
 	return map;
 }
-//#endregion
-//#region src/globalOptions.ts
+// src/globalOptions.ts
 function addGlobalOptionsToAction(command) {
 	command = command.addOption(new Option("-f,--flag <flag:value>", "Declare an execution flag value").hideHelp().argParser(collect$1));
 	return command;
@@ -741,8 +738,7 @@ function addGlobalOptionsAndHooks(command) {
 function processGlobalOptions(options) {
 	parseApplicationFeatureFlags(options.flag);
 }
-//#endregion
-//#region src/app.mts
+// src/app.mts
 async function run(command, argv) {
 	const prog = command || program;
 	const args = argv || process.argv;
@@ -755,7 +751,7 @@ async function run(command, argv) {
 	prog.version(npmPackage.version).description("Spelling Checker for Code").name("cspell");
 	if (!satisfies(process.versions.node, npmPackage.engines.node)) throw new ApplicationError(`Unsupported NodeJS version (${process.versions.node}); ${npmPackage.engines.node} is required`);
 	const lintCommand = addGlobalOptionsToAction(commandLint(prog, { isDefault: true }));
-	prog.addHelpText("after", (context) => defaultCommandOptionsHelp(context, lintCommand));
+	prog.addHelpText("after", (context) => defaultCommandOptionsHelp(context, lintCommand) + lintHelpForProgram(context, lintCommand));
 	addGlobalOptionsToAction(commandTrace(prog));
 	addGlobalOptionsToAction(commandCheck(prog));
 	addGlobalOptionsToAction(commandSuggestion(prog));
@@ -778,7 +774,6 @@ function defaultCommandOptionsHelp(context, defaultCommand) {
 	const heading = `Options for "${defaultCommand.name()}" (the default command):`;
 	return "\n" + helper.formatItemList(heading, items, helper).join("\n");
 }
-//#endregion
 export { ApplicationError, CheckFailed, run };
 
 //# sourceMappingURL=app.js.map

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

@@ -1,7 +1,7 @@
 import { createRequire } from "node:module";
 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, MessageTypes, SuggestionError, Text, checkTextDocument, combineTextAndLanguageSettings, createDictionaryReferenceCollection, createPerfTimer, extractDependencies, extractImportErrors, fileToDocument, getDefaultSettings, getGlobalSettingsAsync, getSystemFeatureFlags, isBinaryFile, isSpellingDictionaryLoadError, mergeSettings, setLogger, shouldCheckDocument, spellCheckDocument, suggestionsForWords, traceWordsAsync } from "cspell-lib";
+import { ENV_CSPELL_GLOB_ROOT, IncludeExcludeFlag, MessageTypes, SuggestionError, Text, checkTextDocument, combineTextAndLanguageSettings, createDictionaryReferenceCollection, createPerfTimer, defaultConfigFilenames, extractDependencies, extractImportErrors, fileToDocument, getDefaultSettings, getGlobalSettingsAsync, getSystemFeatureFlags, isBinaryFile, isSpellingDictionaryLoadError, mergeSettings, setLogger, shouldCheckDocument, spellCheckDocument, suggestionsForWords, traceWordsAsync } from "cspell-lib";
 import assert from "node:assert";
 import { format, formatWithOptions, stripVTControlCharacters } from "node:util";
 import { enablePerformanceMeasurements, getCounters, measurePerf } from "@cspell/cspell-performance-monitor";
@@ -17,6 +17,7 @@ import * as path$1 from "node:path";
 import path, { isAbsolute, posix, relative, resolve, sep } from "node:path";
 import { opMap as opMap$1, pipe } from "@cspell/cspell-pipe/sync";
 import { IssueType, MessageTypes as MessageTypes$1, unknownWordsChoices } from "@cspell/cspell-types";
+import { indent, unindent } from "@streetsidesoftware/unindent";
 import { dictionaryCacheEnableLogging, dictionaryCacheGetLog } from "cspell-dictionary";
 import { GitIgnore, findRepoRoot } from "cspell-gitignore";
 import { GlobMatcher, fileOrGlobToGlob, workaroundPicomatchBug } from "cspell-glob";
@@ -27,7 +28,7 @@ import { getStat, readFileText, toURL } from "cspell-io";
 import { glob, isDynamicPattern } from "tinyglobby";
 import * as readline from "node:readline";
 import { parse, stringify } from "flatted";
-//#region src/console.ts
+// src/console.ts
 var ImplChannel = class {
 	stream;
 	constructor(stream) {
@@ -64,8 +65,7 @@ function getColorLevel(stream) {
 		default: return 0;
 	}
 }
-//#endregion
-//#region src/util/errors.ts
+// src/util/errors.ts
 var CheckFailed = class extends Error {
 	exitCode;
 	constructor(message, exitCode = 1) {
@@ -118,8 +118,7 @@ function toApplicationError(e, message) {
 	const err = toError$1(e);
 	return new ApplicationError(message ?? err.message, void 0, err);
 }
-//#endregion
-//#region src/formatIssue.ts
+// src/formatIssue.ts
 function formatIssue(io, templateStr, issue, maxIssueTextWidth) {
 	function clean(t) {
 		return t.replace(/\s+/, " ");
@@ -219,8 +218,12 @@ function checkTemplate(template) {
 		return new ApplicationError(e instanceof Error ? e.message : `${e}`);
 	}
 }
-//#endregion
-//#region src/util/perfMeasurements.ts
+// src/util/constants.ts
+const UTF8 = "utf8";
+const STDIN = "stdin";
+const STDINProtocol = "stdin:";
+const STDINUrlPrefix = "stdin://";
+// src/util/perfMeasurements.ts
 function getPerfMeasurements() {
 	const measurements = performance.getEntriesByType("measure");
 	const root = {
@@ -287,8 +290,7 @@ function getPerfMeasurements() {
 		m.children.forEach(sortChildren);
 	}
 }
-//#endregion
-//#region src/util/ansi.ts
+// src/util/ansi.ts
 function isAnsiString(s) {
 	return s.includes("\x1B") || s.includes("›");
 }
@@ -442,8 +444,7 @@ function pruneTextStart(str, maxWidth, pad = "…") {
 	}
 	return str;
 }
-//#endregion
-//#region src/util/pad.ts
+// src/util/pad.ts
 function pad(s, w) {
 	const p = padWidth(s, w);
 	if (!p) return s;
@@ -458,8 +459,7 @@ function padLeft(s, w) {
 	if (!p) return s;
 	return s.padStart(p + s.length);
 }
-//#endregion
-//#region src/util/table.ts
+// src/util/table.ts
 function tableToLines(table, deliminator) {
 	const del = deliminator || table.deliminator || " | ";
 	const columnWidths = [];
@@ -554,8 +554,7 @@ function headerDecorator(t) {
 function decorateRowWith(row, ...decorators) {
 	return decorators.reduce((row, decorator) => row.map(decorator), row);
 }
-//#endregion
-//#region src/util/util.ts
+// src/util/util.ts
 const uniqueFn = uniqueFilterFnGenerator;
 function uniqueFilterFnGenerator(extractFn) {
 	const values = /* @__PURE__ */ new Set();
@@ -577,8 +576,7 @@ function clean(src) {
 	for (const key of Object.keys(r)) if (r[key] === void 0) delete r[key];
 	return r;
 }
-//#endregion
-//#region src/cli-reporter.ts
+// src/cli-reporter.ts
 const templateIssue = `{green $filename}:{yellow $row:$col} - $message ({red $text}) $quickFix`;
 const templateIssueNoFix = `{green $filename}:{yellow $row:$col} - $message ({red $text})`;
 const templateIssueWithSuggestions = `{green $filename}:{yellow $row:$col} - $message ({red $text}) Suggestions: {yellow [$suggestions]}`;
@@ -614,10 +612,21 @@ function genIssueEmitter(stdIO, errIO, template, uniqueIssues, reportedIssuesCol
 function nullEmitter() {}
 function relativeUriFilename(uri, rootURL) {
 	const url = toFileURL(uri);
+	if (isStdinWithoutPath(url)) return STDIN;
 	const rel = urlRelative(rootURL, url);
 	if (rel.startsWith("..")) return toFilePathOrHref(url);
 	return rel;
 }
+function absoluteUriFilename(uri, rootURL) {
+	const url = toFileURL(uri, rootURL);
+	return isStdinWithoutPath(url) ? STDIN : toFilePathOrHref(url);
+}
+/**
+* Plain `stdin` is given the current directory as its location, so it has no file name to show.
+*/
+function isStdinWithoutPath(url) {
+	return url.protocol === "stdin:" && url.pathname.endsWith("/");
+}
 function reportProgress(io, p, cwdURL, options) {
 	if (p.type === "ProgressFileComplete") return reportProgressFileComplete(io, p, cwdURL, options);
 	if (p.type === "ProgressFileBegin") return reportProgressFileBegin(io, p, cwdURL);
@@ -700,7 +709,7 @@ function getReporter(options, config) {
 	}
 	const rootURL = toFileDirURL(options.root || process.cwd());
 	function relativeIssue(fn) {
-		const fnFilename = options.relative ? (uri) => relativeUriFilename(uri, rootURL) : (uri) => toFilePathOrHref(toFileURL(uri, rootURL));
+		const fnFilename = options.relative ? (uri) => relativeUriFilename(uri, rootURL) : (uri) => absoluteUriFilename(uri, rootURL);
 		return (i) => {
 			const fullFilename = i.uri ? toFilePathOrHref(toFileURL(i.uri, rootURL)) : "";
 			const filename = i.uri ? fnFilename(i.uri) : "";
@@ -910,8 +919,7 @@ function assertCheckTemplate(template) {
 	const r = checkTemplate(template);
 	if (r instanceof Error) throw r;
 }
-//#endregion
-//#region src/config/adjustConfig.ts
+// src/config/adjustConfig.ts
 async function fileExists(url) {
 	if (url.protocol !== "file:") return false;
 	try {
@@ -1014,8 +1022,7 @@ function addDictionariesToConfigFile(configFile, dictionaries, comment) {
 	}
 	setConfigFieldValue(configFile, "dictionaries", dicts, comment);
 }
-//#endregion
-//#region src/config/config.ts
+// src/config/config.ts
 function applyValuesToConfigFile(config, settings, defaultValues, addComments) {
 	const currentSettings = config.settings || {};
 	for (const [k, entry] of Object.entries(defaultValues)) {
@@ -1029,8 +1036,7 @@ function applyValuesToConfigFile(config, settings, defaultValues, addComments) {
 	}
 	return config;
 }
-//#endregion
-//#region src/config/constants.ts
+// src/config/constants.ts
 const defaultConfig = {
 	$schema: {
 		value: void 0,
@@ -1113,8 +1119,7 @@ const defaultConfig = {
 		comment: " Regular expressions / patterns of text to be included."
 	}
 };
-//#endregion
-//#region src/config/configInit.ts
+// src/config/configInit.ts
 const schemaRef = cspellConfigFileSchema;
 const defaultConfigJson = `\
 {
@@ -1124,23 +1129,73 @@ const defaultConfigYaml = `
 `;
 async function configInit(options) {
 	const rw = createReaderWriter();
-	const configFile = await createConfigFile(rw, determineFileNameURL(options), options);
-	await applyOptionsToConfigFile(configFile, options);
+	const existingConfig = await findExistingConfig(options);
+	const importFile = existingConfig && isCodeConfig(existingConfig) ? existingConfig : void 0;
+	if (importFile && !hasRequestedChange(options)) return;
+	const configFile = await createConfigFile(rw, importFile ? determineFileNameURL({}) : existingConfig ?? determineFileNameURL(options));
+	const hasSettings = !!importFile || Object.keys(configFile.settings).length > 0;
+	await applyOptionsToConfigFile(configFile, withImportFile(options, importFile), hasSettings);
 	await fs.mkdir(new URL("./", configFile.url), { recursive: true });
 	if (options.stdout) console.stdoutChannel.write(rw.serialize(configFile));
 	else await rw.writeConfig(configFile);
 }
-async function applyOptionsToConfigFile(configFile, options) {
+/**
+* Find the config file cspell would load for the current directory, without looking in parent directories.
+* Naming the file or its format with an option means the existing config isn't wanted.
+*/
+async function findExistingConfig(options) {
+	if (options.config || options.output || options.format) return void 0;
+	const cwd = toFileDirURL("./");
+	for (const filename of defaultConfigFilenames) {
+		const url = new URL(filename, cwd);
+		if (await isConfigFile(url)) return url;
+	}
+}
+async function isConfigFile(url) {
+	if (!(await fs.stat(url).catch(() => void 0))?.isFile()) return false;
+	return !url.pathname.endsWith("/package.json") || hasCSpellSection(url);
+}
+async function hasCSpellSection(packageJsonUrl) {
+	try {
+		return typeof JSON.parse(await fs.readFile(packageJsonUrl, "utf8")).cspell === "object";
+	} catch {
+		return false;
+	}
+}
+function isCodeConfig(url) {
+	return /\.[cm]?[jt]s$/.test(url.pathname);
+}
+/**
+* A code config can't be edited, so changes are only possible through a new config file.
+*/
+function hasRequestedChange(options) {
+	return !!(options.locale || options.schema || options.import?.length || options.dictionary?.length);
+}
+function withImportFile(options, importFile) {
+	if (!importFile) return options;
+	const relativePath = "./" + urlRelative(toFileDirURL("./"), importFile);
+	return {
+		...options,
+		import: [relativePath, ...options.import ?? []]
+	};
+}
+async function applyOptionsToConfigFile(configFile, options, hasSettings) {
 	const settings = {};
 	const addComments = options.comments || options.comments === void 0 && !options.removeComments && !configFile.url.pathname.endsWith(".json");
 	if (options.comments === false) configFile.removeAllComments();
-	if (options.schema ?? true) configFile.setSchema(schemaRef);
+	if (options.schema ?? !hasSettings) configFile.setSchema(schemaRef);
 	if (options.locale) settings.language = options.locale;
-	applyValuesToConfigFile(configFile, settings, defaultConfig, addComments);
+	applyValuesToConfigFile(configFile, settings, hasSettings ? withoutDefaultValues(defaultConfig) : defaultConfig, addComments);
 	if (options.import) await addImportsToConfigFile(configFile, options.import, addComments && defaultConfig.import?.comment || void 0);
 	if (options.dictionary) addDictionariesToConfigFile(configFile, options.dictionary, addComments && defaultConfig.dictionaries?.comment || void 0);
 	return configFile;
 }
+function withoutDefaultValues(config) {
+	return Object.fromEntries(Object.entries(config).map(([key, entry]) => [key, {
+		...entry,
+		value: void 0
+	}]));
+}
 function determineFileNameURL(options) {
 	if (options.config) return toFileURL(options.config);
 	const defaultFileName = determineDefaultFileName(options);
@@ -1159,25 +1214,18 @@ function determineDefaultFileName(options) {
 	}
 	throw new Error(`Unsupported format: ${options.format}`);
 }
-function getDefaultContent(options) {
-	switch (options.format) {
-		case void 0:
-		case "yaml": return defaultConfigYaml;
-		case "json":
-		case "jsonc": return defaultConfigJson;
-		default: throw new Error(`Unsupported format: ${options.format}`);
-	}
+function getDefaultContent(url) {
+	return /\.jsonc?$/.test(url.pathname) ? defaultConfigJson : defaultConfigYaml;
 }
-async function createConfigFile(rw, url, options) {
+async function createConfigFile(rw, url) {
 	if (url.pathname.endsWith("package.json")) return rw.readConfig(url);
-	const content = await fs.readFile(url, "utf8").catch(() => getDefaultContent(options));
+	const content = await fs.readFile(url, "utf8").catch(() => getDefaultContent(url));
 	return rw.parse({
 		url,
 		content
 	});
 }
-//#endregion
-//#region src/featureFlags/featureFlags.ts
+// src/featureFlags/featureFlags.ts
 function getFeatureFlags() {
 	return getSystemFeatureFlags();
 }
@@ -1194,8 +1242,7 @@ function parseFeatureFlags(flags, featureFlags = getFeatureFlags()) {
 	}
 	return featureFlags;
 }
-//#endregion
-//#region src/environment.ts
+// src/environment.ts
 const environmentKeys = {
 	CSPELL_ENABLE_DICTIONARY_LOGGING: "CSPELL_ENABLE_DICTIONARY_LOGGING",
 	CSPELL_ENABLE_DICTIONARY_LOG_FILE: "CSPELL_ENABLE_DICTIONARY_LOG_FILE",
@@ -1222,11 +1269,10 @@ function truthy(value) {
 	}
 	return false;
 }
-//#endregion
-//#region src/dirname.ts
+// src/dirname.ts
 let _dirname;
 try {
-	if (typeof import.meta.url !== "string") throw new Error("assert");
+	if (typeof import.meta.url !== "string") throw new TypeError("assert");
 	_dirname = fileURLToPath(new URL(".", import.meta.url));
 } catch {
 	_dirname = __dirname;
@@ -1234,11 +1280,10 @@ try {
 const pkgDir = _dirname;
 const npmPackage = {
 	name: "cspell",
-	version: "10.4.0-alpha.1",
+	version: "10.4.1",
 	engines: { node: ">=22.18.0" }
 };
-//#endregion
-//#region src/reporters/reporters.ts
+// src/reporters/reporters.ts
 function filterFeatureIssues(features, issue, reportOptions) {
 	if (issue.issueType === IssueType.directive) return features?.issueType && reportOptions?.validateDirectives || false;
 	if (features?.unknownWords) return true;
@@ -1438,19 +1483,12 @@ function replayReportItems(reportItemsCollection, reporter) {
 		case "error": reporter.error(...item.payload);
 	}
 }
-//#endregion
-//#region src/util/async.ts
+// src/util/async.ts
 const asyncMap = operators.opMapAsync;
 operators.opFilterAsync;
 const asyncAwait = operators.opAwaitAsync;
 const asyncFlatten = operators.opFlattenAsync;
-//#endregion
-//#region src/util/constants.ts
-const UTF8 = "utf8";
-const STDINProtocol = "stdin:";
-const STDINUrlPrefix = "stdin://";
-//#endregion
-//#region src/util/glob.ts
+// src/util/glob.ts
 const defaultExcludeGlobs = ["node_modules/**"];
 /**
 *
@@ -1573,8 +1611,7 @@ function glob$1(patterns, options) {
 	patterns = typeof patterns === "string" ? workaroundPicomatchBug(patterns) : patterns.map((g) => workaroundPicomatchBug(g));
 	return glob(patterns, options);
 }
-//#endregion
-//#region src/util/stdin.ts
+// src/util/stdin.ts
 async function* readStdin() {
 	const rl = readline.createInterface(process.stdin);
 	try {
@@ -1586,8 +1623,7 @@ async function* readStdin() {
 function isReadlineClosedError(e) {
 	return e instanceof Error && e.message.includes("closed");
 }
-//#endregion
-//#region src/util/stdinUrl.ts
+// src/util/stdinUrl.ts
 function isStdinUrl(url) {
 	if (url instanceof URL) return url.protocol === STDINProtocol;
 	return url.startsWith(STDINProtocol);
@@ -1604,8 +1640,7 @@ function resolveStdinUrl(url, cwd) {
 	const fileUrl = toFileURL(path, cwd);
 	return new URL(fileUrl.toString().replace(/^file:/, STDINProtocol) + (path ? "" : "/"));
 }
-//#endregion
-//#region src/util/fileHelper.ts
+// src/util/fileHelper.ts
 function fileInfoToDocument(fileInfo, languageId, locale) {
 	const { filename, text } = fileInfo;
 	languageId = languageId || void 0;
@@ -1743,8 +1778,7 @@ function relativeToCwd(filename, cwd = process.cwd()) {
 	if (rel.startsWith("..")) return toFilePathOrHref(url);
 	return rel;
 }
-//#endregion
-//#region src/util/cache/file-entry-cache/flatCache.ts
+// src/util/cache/file-entry-cache/flatCache.ts
 var FlatCache = class {
 	cacheFilename;
 	#cache;
@@ -1799,8 +1833,7 @@ var FlatCache = class {
 function loadCacheFile(cachefile) {
 	return new FlatCache(cachefile).load();
 }
-//#endregion
-//#region src/util/cache/file-entry-cache/file-entry-cache.ts
+// src/util/cache/file-entry-cache/file-entry-cache.ts
 async function createFromFile$1(cacheFileUrl, useChecksum, currentWorkingDir) {
 	const fec = new ImplFileEntryCache(await loadCacheFile(cacheFileUrl), useChecksum ?? false, currentWorkingDir);
 	await fec.removeNotFoundFiles();
@@ -1968,13 +2001,11 @@ function normalizePath$1(filePath) {
 	if (path.sep === "/") return filePath;
 	return filePath.split(path.sep).join("/");
 }
-//#endregion
-//#region src/util/cache/fileEntryCache.ts
+// src/util/cache/fileEntryCache.ts
 function createFromFile(cacheFileUrl, useCheckSum, useRelative) {
 	return createFromFile$1(cacheFileUrl, useCheckSum, useRelative ? new URL("./", cacheFileUrl) : void 0);
 }
-//#endregion
-//#region src/util/cache/ObjectCollection.ts
+// src/util/cache/ObjectCollection.ts
 const compare = Intl.Collator().compare;
 var ShallowObjectCollection = class {
 	tree = {};
@@ -1997,8 +2028,7 @@ var ShallowObjectCollection = class {
 		return v;
 	}
 };
-//#endregion
-//#region src/util/cache/DiskCache.ts
+// src/util/cache/DiskCache.ts
 const META_DATA_VERSION_SUFFIX = "-1-" + Object.keys({
 	v: "v",
 	r: "r",
@@ -2046,8 +2076,13 @@ var DiskCache = class {
 		const hasErrors = !!result && (result.errors > 0 || result.configErrors > 0 || result.issues.length > 0);
 		const cached = true;
 		const shouldReadFile = hasErrors;
+		const uri = toFileURL(filename).href;
 		return {
 			...result,
+			issues: result.issues.map((issue) => ({
+				...issue,
+				uri
+			})),
 			elapsedTimeMs: void 0,
 			fileInfo: shouldReadFile ? await readFileInfo(filename) : { filename },
 			cached
@@ -2057,9 +2092,13 @@ var DiskCache = class {
 		const fileDescriptor = await this.fileEntryCache.getFileDescriptor(fileInfo.filename);
 		const meta = fileDescriptor.meta;
 		if (fileDescriptor.notFound || !meta) return;
+		const issues = result.issues.map(({ uri: _, ...issue }) => issue);
 		meta.data = this.objectCollection.get({
 			v: this.version,
-			r: this.normalizeResult(result),
+			r: this.normalizeResult({
+				...result,
+				issues
+			}),
 			d: await this.calcDependencyHashes(dependsUponFiles),
 			...this.optionsKey ? { o: this.optionsKey } : {}
 		});
@@ -2201,8 +2240,7 @@ function normalizePath(filePath) {
 	if (sep === "/") return filePath;
 	return filePath.split(sep).join("/");
 }
-//#endregion
-//#region src/util/cache/DummyCache.ts
+// src/util/cache/DummyCache.ts
 /**
 * Dummy cache implementation that should be usd if caching option is disabled.
 */
@@ -2220,8 +2258,7 @@ var DummyCache = class {
 		return Promise.resolve();
 	}
 };
-//#endregion
-//#region src/util/cache/createCache.ts
+// src/util/cache/createCache.ts
 const DEFAULT_CACHE_LOCATION = ".cspellcache";
 const versionSuffix = "";
 /**
@@ -2285,8 +2322,7 @@ function normalizeVersion(version) {
 	assert(parts.length === 2);
 	return parts.join(".") + versionSuffix;
 }
-//#endregion
-//#region src/util/configFileHelper.ts
+// src/util/configFileHelper.ts
 async function readConfig(configFile, root, stopConfigSearchAt) {
 	configFile ??= getEnvironmentVariable(environmentKeys.CSPELL_CONFIG_PATH);
 	if (configFile) return configFileToConfigInfo(typeof configFile === "string" ? await readConfigHandleError(configFile) : configFile);
@@ -2325,8 +2361,7 @@ async function readConfigHandleError(filename) {
 		};
 	}
 }
-//#endregion
-//#region src/util/symlinks.ts
+// src/util/symlinks.ts
 function createSymlinkChecker(root) {
 	const rootPath = path$1.resolve(root);
 	const cache = /* @__PURE__ */ new Map();
@@ -2367,70 +2402,12 @@ function createSymlinkChecker(root) {
 		isGlobReachedThroughSymlink
 	};
 }
-//#endregion
-//#region src/util/timer.ts
+// src/util/timer.ts
 function getTimeMeasurer() {
 	const timer = createPerfTimer("timer");
 	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/wrap.ts
+// src/util/wrap.ts
 const wrapSep = /\s+|(?<=,)|\.(?=\w)/g;
 function wordWrapAnsiText(str, maxWidth, indent = "", sep = wrapSep) {
 	if (!maxWidth || maxWidth <= 0) return str;
@@ -2465,8 +2442,7 @@ function* joinFragments(fragments) {
 	}
 	if (last) yield last.text;
 }
-//#endregion
-//#region src/util/writeFile.ts
+// src/util/writeFile.ts
 async function writeFileOrStream(filename, data) {
 	switch (filename) {
 		case "stdout":
@@ -2487,8 +2463,7 @@ function writeStream(stream, data) {
 		});
 	});
 }
-//#endregion
-//#region src/util/extractContext.ts
+// src/util/extractContext.ts
 function prefCharIndex(text, offset, count = 1) {
 	if (offset - count < 0) return 0;
 	for (; count > 0 && offset > 0; count--) {
@@ -2541,8 +2516,7 @@ function extractContext(tdo, contextRange) {
 	context.offset += line.offset;
 	return context;
 }
-//#endregion
-//#region src/lint/LinterError.ts
+// src/lint/LinterError.ts
 var LinterError = class extends Error {
 	constructor(message) {
 		super(message);
@@ -2551,8 +2525,7 @@ var LinterError = class extends Error {
 		return this.message;
 	}
 };
-//#endregion
-//#region src/lint/processFile.ts
+// src/lint/processFile.ts
 async function processFile(file, cache, prefetch, processFileOptions) {
 	if (prefetch?.fileResult) return prefetch.fileResult;
 	const { filename } = file;
@@ -2694,8 +2667,7 @@ function reportSpellingResultConfigErrors(reporter, spellResult, processFileOpti
 function countConfigErrors(reporter, configInfo, processFileOptions) {
 	return reportConfigurationErrors(reporter, configInfo.config, processFileOptions);
 }
-//#endregion
-//#region src/util/prefetch.ts
+// src/util/prefetch.ts
 function* prefetchIterable(iterable, size) {
 	assert(size >= 0);
 	const buffer = [];
@@ -2709,8 +2681,7 @@ function* prefetchIterable(iterable, size) {
 	}
 	yield* buffer;
 }
-//#endregion
-//#region src/util/unitNumbers.ts
+// src/util/unitNumbers.ts
 const regexUnitNumber = /^((?:\d+(?:\.\d*)?)|(?:\.\d+))([a-z]*)$/i;
 const unitSizes = {
 	"": 1,
@@ -2752,8 +2723,7 @@ function sizeToNumber(size) {
 	if (p.error) return NaN;
 	return Number.parseFloat(p.digits) * (unitSizes[p.units] || 1);
 }
-//#endregion
-//#region src/lint/processFiles.ts
+// src/lint/processFiles.ts
 const BATCH_FETCH_SIZE = 12;
 function prefetch(fileToProcess, cfg) {
 	const { filename } = fileToProcess;
@@ -2934,8 +2904,7 @@ function runResult(init = {}) {
 		skippedFiles
 	};
 }
-//#endregion
-//#region \0@oxc-project+runtime@0.151.0/helpers/esm/usingCtx.js
+// \0@oxc-project+runtime@0.156.0/helpers/esm/usingCtx.js
 function _usingCtx() {
 	var r = "function" == typeof SuppressedError ? SuppressedError : function(r, e) {
 		var n = Error();
@@ -2990,8 +2959,7 @@ function _usingCtx() {
 		}
 	};
 }
-//#endregion
-//#region src/lint/lint.ts
+// src/lint/lint.ts
 const version = npmPackage.version;
 const { opFilterAsync } = operators;
 async function runLint(cfg) {
@@ -3321,8 +3289,7 @@ function globPattern(g) {
 function calcVerboseLevel(options) {
 	return options.verboseLevel ?? (options.verbose ? 1 : 0);
 }
-//#endregion
-//#region src/lint/LintRequest.ts
+// src/lint/LintRequest.ts
 const defaultContextRange = 20;
 var LintRequest = class {
 	fileGlobs;
@@ -3392,8 +3359,7 @@ function extractUnknownWordsConfig(options) {
 	}
 	return config;
 }
-//#endregion
-//#region src/options.ts
+// src/options.ts
 const ReportChoicesAll = [
 	"all",
 	"simple",
@@ -3414,8 +3380,7 @@ function cvtLinterCliCommandOptionsToLinterCliOptions(options) {
 	}
 	return cliOptions;
 }
-//#endregion
-//#region src/repl/index.ts
+// src/repl/index.ts
 function simpleRepl() {
 	return new SimpleRepl();
 }
@@ -3461,8 +3426,7 @@ var SimpleRepl = class {
 		return { next };
 	}
 };
-//#endregion
-//#region src/dictionaries/listDictionaries.ts
+// src/dictionaries/listDictionaries.ts
 const inlineDictionaries = {
 	"[words]": {
 		name: "[words]",
@@ -3572,8 +3536,7 @@ async function listDictionaries(options) {
 	dictionaryDefinitions.sort((a, b) => a.name.localeCompare(b.name));
 	return [...options.enabled !== false ? extractSpecialDictionaries(config) : [], ...dictionaryDefinitions.map(toListDictionariesResult)];
 }
-//#endregion
-//#region src/application.mts
+// src/application.mts
 function lint(fileGlobs, options, reporter) {
 	options = fixLegacy(options);
 	const unknownWordsConfig = extractUnknownWordsConfig(options);
@@ -3663,7 +3626,6 @@ function registerApplicationFeatureFlags() {
 function parseApplicationFeatureFlags(flags) {
 	return parseFeatureFlags(flags, registerApplicationFeatureFlags());
 }
-//#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 };
+export { CheckFailed as C, ApplicationError as S, padWidth as _, parseApplicationFeatureFlags as a, pruneAnsiTextStart as b, listDictionaries as c, validateUnitSize as d, DEFAULT_CACHE_LOCATION as f, padLeft as g, tableToLines as h, lint as i, ReportChoicesAll as l, getReporter as m, checkText as n, suggestions as o, npmPackage as p, createInit as r, trace as s, IncludeExcludeFlag as t, cvtLinterCliCommandOptionsToLinterCliOptions as u, ansiWidth as v, console as w, width as x, pruneAnsiTextEnd as y };
 
-//# sourceMappingURL=application-DRa52DKq.js.map
+//# sourceMappingURL=application-9lyhPNzW.js.map

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

@@ -1,11 +1,11 @@
-import { a as SuggestionOptions, i as LinterCliOptions, n as DictionariesOptions, o as TraceOptions, r as LegacyOptions, t as BaseOptions } from "./options-D5lC3IZu.js";
+import { a as SuggestionOptions, i as LinterCliOptions, n as DictionariesOptions, o as TraceOptions, r as LegacyOptions, t as BaseOptions } from "./options-Dr5rOq5n.js";
 import { CheckTextInfo, FeatureFlags, IncludeExcludeFlag, SuggestionsForWordResult, TraceResult, TraceWordResult } from "cspell-lib";
 import { CSpellReporter, RunResult } from "@cspell/cspell-types";
-//#region src/config/options.d.ts
 interface BaseConfigOptions {
   /**
    * The path to the configuration file to create / update.
-   * If not provided, a default file name will be used based on the format.
+   * If not provided, the configuration file in the current directory is updated.
+   * If there is none, a default file name will be used based on the format.
    */
   config?: string;
   /**
@@ -35,6 +35,7 @@ interface BaseConfigOptions {
    * Whether to add the schema reference to the configuration file.
    * - `true` - the schema reference will be added / updated.
    * - `false` - no schema reference will be added.
+   * - `undefined` - the schema reference will be added only if the configuration has no settings yet.
    */
   schema?: boolean;
   /**
@@ -51,7 +52,8 @@ interface BaseConfigOptions {
 interface InitOptions extends BaseConfigOptions {
   /**
    * The path where the configuration file will be written, it can be a file path or a URL.
-   * If not provided, a default file name will be used based on the format.
+   * If not provided, the configuration file in the current directory is updated.
+   * If there is none, a default file name will be used based on the format.
    * The default will be `cspell.config.yaml` or `cspell.json` based on the format.
    * @conflicts `config` - If `config` is provided, it will be used instead of `output`.
    */
@@ -62,13 +64,9 @@ interface InitOptions extends BaseConfigOptions {
    */
   format?: "yaml" | "yml" | "json" | "jsonc";
 }
-//#endregion
-//#region src/emitters/suggestionsEmitter.d.ts
 interface TimedSuggestionsForWordResult extends SuggestionsForWordResult {
   elapsedTimeMs?: number;
 }
-//#endregion
-//#region src/dictionaries/listDictionaries.d.ts
 interface ListDictionariesResult {
   /**
    * The name of the dictionary.
@@ -104,8 +102,6 @@ interface ListDictionariesResult {
   fileTypes?: string[] | undefined;
 }
 declare function listDictionaries(options: DictionariesOptions): Promise<ListDictionariesResult[]>;
-//#endregion
-//#region src/application.d.mts
 /**
  * The same shape as `NodeJS.ErrnoException`, declared here so the published types do not need `@types/node`.
  */
@@ -122,6 +118,5 @@ declare function checkText(filename: string, options: BaseOptions & LegacyOption
 declare function suggestions(words: string[], options: SuggestionOptions): AsyncIterable<TimedSuggestionsForWordResult>;
 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-CFfMlhE_.d.ts.map
+//# sourceMappingURL=application-CcaBK3o9.d.ts.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-CFfMlhE_.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-CcaBK3o9.js";
 export { AppError, CheckTextResult, IncludeExcludeFlag, type TraceResult, checkText, createInit, lint, listDictionaries, parseApplicationFeatureFlags, suggestions, trace };

package/dist/esm/application.js

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

package/dist/esm/index.d.ts

@@ -1,8 +1,7 @@
-import { i as LinterCliOptions, o as TraceOptions, s as FinalizedReporter, t as BaseOptions } from "./options-D5lC3IZu.js";
-import { a as checkText, c as parseApplicationFeatureFlags, d as listDictionaries, i as TraceResult, l as suggestions, n as CheckTextResult, o as createInit, r as IncludeExcludeFlag, s as lint, t as AppError, u as trace } from "./application-CFfMlhE_.js";
+import { 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-CcaBK3o9.js";
+import { i as LinterCliOptions, o as TraceOptions, s as FinalizedReporter, t as BaseOptions } from "./options-Dr5rOq5n.js";
 import { CSpellReporter, ReporterConfiguration } from "@cspell/cspell-types";
 export * from "@cspell/cspell-types";
-//#region src/console.d.ts
 type Log = (format?: any, ...params: any[]) => void;
 /**
  * The parts of an output stream, such as `process.stdout`, that the console uses.
@@ -32,8 +31,6 @@ interface Channel {
   printLine: (format?: any, ...params: any[]) => void;
   getColorLevel: () => 0 | 1 | 2 | 3;
 }
-//#endregion
-//#region src/models.d.ts
 type ReporterConsole = IConsole;
 interface CSpellReporterConfiguration extends Readonly<ReporterConfiguration>, Readonly<LinterCliOptions> {
   /**
@@ -45,12 +42,9 @@ interface CSpellReporterConfiguration extends Readonly<ReporterConfiguration>, R
 interface CSpellReporterModule {
   getReporter: <T>(settings: T, config: CSpellReporterConfiguration) => 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" | "verboseLevel" | "wordsOnly"> {
   fileGlobs: string[];
 }
 declare function getReporter(options: ReporterOptions, config?: CSpellReporterConfiguration): FinalizedReporter;
-//#endregion
 export { type AppError, type BaseOptions, type LinterCliOptions as CSpellApplicationOptions, type CSpellReporterConfiguration, type CSpellReporterModule, type CheckTextResult, IncludeExcludeFlag, type TraceOptions, type TraceResult, checkText, createInit, getReporter as getDefaultReporter, lint, listDictionaries, parseApplicationFeatureFlags, suggestions, trace };
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.js

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

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

@@ -2,7 +2,6 @@ import "cspell-lib";
 import { CSpellReporter, CSpellSettings, CacheFormat, CacheStrategy, ReporterConfiguration, RunResult } from "@cspell/cspell-types";
 import { GlobMatcher } from "cspell-glob";
 import "cspell-io";
-//#region src/util/cache/CacheOptions.d.ts
 interface CacheOptions {
   /**
    * The version of `cspell` that made the cache entry.
@@ -35,11 +34,7 @@ interface CacheOptions {
    */
   cacheFormat?: CacheFormat;
 }
-//#endregion
-//#region src/reporters/LintFileResult.d.ts
 type FinalizedReporter = Required<CSpellReporter>;
-//#endregion
-//#region src/options.d.ts
 interface LinterOptions extends Omit<BaseOptions, "config">, Omit<CacheOptions, "version">, ReporterConfiguration {
   /**
    * Display verbose information
@@ -422,6 +417,5 @@ interface CSpellConfigFile {
   url: URL;
   settings: CSpellSettings;
 }
-//#endregion
 export { SuggestionOptions as a, LinterCliOptions as i, DictionariesOptions as n, TraceOptions as o, LegacyOptions as r, FinalizedReporter as s, BaseOptions as t };
-//# sourceMappingURL=options-D5lC3IZu.d.ts.map
+//# sourceMappingURL=options-Dr5rOq5n.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cspell",
-  "version": "10.4.0-alpha.1",
+  "version": "10.4.1",
   "description": "A Spelling Checker for Code!",
   "publishConfig": {
     "access": "public",
@@ -72,7 +72,7 @@
   "scripts": {
     "build": "tsdown && pnpm build:tsc",
     "build:readme": "pnpm build:readme:help",
-    "build:readme:help": "pnpm build:readme:help:lint && pnpm build:readme:help:trace && inject-markdown README.md && prettier -w README.md",
+    "build:readme:help": "pnpm build:readme:help:lint && pnpm build:readme:help:trace && inject-markdown --allow-outside-root ../.. README.md && prettier -w README.md",
     "build:readme:help:lint": "COLUMNS=72 ./bin.mjs lint --help > static/help-lint.txt",
     "build:readme:help:trace": "COLUMNS=72 ./bin.mjs trace --help > static/help-trace.txt",
     "build:tsc": "tsc -p .",
@@ -90,35 +90,36 @@
     "watch:tsc": "tsc -p . -w"
   },
   "dependencies": {
-    "@cspell/cspell-json-reporter": "10.4.0-alpha.1",
-    "@cspell/cspell-performance-monitor": "10.4.0-alpha.1",
-    "@cspell/cspell-pipe": "10.4.0-alpha.1",
-    "@cspell/cspell-types": "10.4.0-alpha.1",
-    "@cspell/cspell-worker": "10.4.0-alpha.1",
-    "@cspell/dynamic-import": "10.4.0-alpha.1",
-    "@cspell/url": "10.4.0-alpha.1",
-    "ansi-regex": "^6.4.0",
+    "@cspell/cspell-json-reporter": "10.4.1",
+    "@cspell/cspell-performance-monitor": "10.4.1",
+    "@cspell/cspell-pipe": "10.4.1",
+    "@cspell/cspell-types": "10.4.1",
+    "@cspell/cspell-worker": "10.4.1",
+    "@cspell/dynamic-import": "10.4.1",
+    "@cspell/url": "10.4.1",
+    "@streetsidesoftware/unindent": "^1.0.1",
+    "ansi-regex": "^6.5.0",
     "chalk": "^6.0.1",
     "chalk-template": "^1.1.3",
     "commander": "^15.0.0",
-    "cspell-config-lib": "10.4.0-alpha.1",
-    "cspell-dictionary": "10.4.0-alpha.1",
-    "cspell-gitignore": "10.4.0-alpha.1",
-    "cspell-glob": "10.4.0-alpha.1",
-    "cspell-io": "10.4.0-alpha.1",
-    "cspell-lib": "10.4.0-alpha.1",
+    "cspell-config-lib": "10.4.1",
+    "cspell-dictionary": "10.4.1",
+    "cspell-gitignore": "10.4.1",
+    "cspell-glob": "10.4.1",
+    "cspell-io": "10.4.1",
+    "cspell-lib": "10.4.1",
     "flatted": "^3.4.4",
-    "semver": "^7.8.5",
+    "semver": "^7.8.6",
     "tinyglobby": "^0.2.17"
   },
   "devDependencies": {
     "@types/micromatch": "^4.0.10",
     "@types/semver": "^7.8.0",
     "micromatch": "^4.0.8",
-    "minimatch": "^9.0.9"
+    "minimatch": "^11.0.4"
   },
   "engines": {
     "node": ">=22.18.0"
   },
-  "gitHead": "628768a6e62b792e628189b41e63e12e5d3d8fe3"
+  "gitHead": "ddb1699a4bfc2766675c2c97412a813d775772eb"
 }