@dev-pi2pie/word-counter 0.1.5-canary.4 → 0.1.5

package/dist/esm/bin.mjs

@@ -2,12 +2,12 @@
 
 import { createRequire } from "node:module";
 import { Command, Option } from "commander";
+import { readFile, readdir, stat } from "node:fs/promises";
+import { basename, dirname, extname, join, relative, resolve, sep, win32 } from "node:path";
 import { closeSync, createWriteStream, existsSync, mkdirSync, openSync, readFileSync, statSync } from "node:fs";
-import { basename, dirname, extname, join, relative, resolve, sep } from "node:path";
 import os from "node:os";
 import { parseDocument } from "yaml";
 import { fileURLToPath } from "node:url";
-import { readFile, readdir, stat } from "node:fs/promises";
 //#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -31,6 +31,884 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
+//#region src/cli/config/schema.ts
+const CONFIG_FILE_BASENAME = "wc-intl-seg.config";
+const CONFIG_FORMAT_PRIORITY = [
+	"toml",
+	"jsonc",
+	"json"
+];
+CONFIG_FORMAT_PRIORITY.map((format) => `${CONFIG_FILE_BASENAME}.${format}`);
+const CONFIG_DETECTOR_VALUES = ["regex", "wasm"];
+const CONFIG_CONTENT_GATE_MODE_VALUES = [
+	"default",
+	"strict",
+	"loose",
+	"off"
+];
+const CONFIG_PATH_MODE_VALUES = ["auto", "manual"];
+const CONFIG_PROGRESS_MODE_VALUES = [
+	"auto",
+	"on",
+	"off"
+];
+const CONFIG_LOG_LEVEL_VALUES = ["info", "debug"];
+const CONFIG_LOG_VERBOSITY_VALUES = ["compact", "verbose"];
+const CONFIG_TOTAL_OF_VALUES = [
+	"words",
+	"emoji",
+	"symbols",
+	"punctuation",
+	"whitespace"
+];
+//#endregion
+//#region src/cli/config/discover.ts
+async function fileExists(path) {
+	try {
+		return (await stat(path)).isFile();
+	} catch {
+		return false;
+	}
+}
+function createIgnoredSiblingNote(scope, selectedPath, ignoredSiblingPaths) {
+	if (ignoredSiblingPaths.length === 0) return;
+	return [`Using ${scope} config file "${selectedPath}".`, `Ignoring lower-priority sibling config files: ${ignoredSiblingPaths.join(", ")}.`].join(" ");
+}
+function resolveUserConfigDirectory(options = {}) {
+	return resolveUserConfigDirectories(options)[0]?.directory;
+}
+function resolveUserConfigDirectories(options = {}) {
+	const platform = options.platform ?? process.platform;
+	const env = options.env ?? process.env;
+	const homeDir = env.HOME ?? env.USERPROFILE;
+	if (platform === "win32") {
+		const candidates = [];
+		if (homeDir) candidates.push({
+			directory: win32.join(homeDir, ".config"),
+			kind: "primary"
+		});
+		if (env.APPDATA) candidates.push({
+			directory: env.APPDATA,
+			kind: "legacy-windows"
+		});
+		return candidates;
+	}
+	if (platform === "darwin") {
+		const candidates = [];
+		if (env.XDG_CONFIG_HOME) candidates.push({
+			directory: env.XDG_CONFIG_HOME,
+			kind: "primary"
+		});
+		if (homeDir) {
+			candidates.push({
+				directory: join(homeDir, ".config"),
+				kind: "primary"
+			});
+			candidates.push({
+				directory: join(homeDir, "Library", "Application Support"),
+				kind: "legacy-macos"
+			});
+		}
+		return candidates;
+	}
+	const directory = env.XDG_CONFIG_HOME ?? (homeDir ? join(homeDir, ".config") : void 0);
+	return directory ? [{
+		directory,
+		kind: "primary"
+	}] : [];
+}
+async function discoverConfigFileInDirectory(directory, scope) {
+	const existing = [];
+	for (const format of CONFIG_FORMAT_PRIORITY) {
+		const path = join(directory, `${CONFIG_FILE_BASENAME}.${format}`);
+		if (await fileExists(path)) existing.push({
+			format,
+			path
+		});
+	}
+	if (existing.length === 0) return;
+	const selected = existing[0];
+	const ignoredSiblingPaths = existing.slice(1).map((item) => item.path);
+	const note = createIgnoredSiblingNote(scope, selected.path, ignoredSiblingPaths);
+	return {
+		scope,
+		directory,
+		path: selected.path,
+		format: selected.format,
+		ignoredSiblingPaths,
+		notes: note ? [note] : []
+	};
+}
+async function discoverConfigFiles(options = {}) {
+	const cwd = options.cwd ?? process.cwd();
+	const userDirectories = resolveUserConfigDirectories(options);
+	const currentWorkingDirectory = await discoverConfigFileInDirectory(cwd, "cwd");
+	let user;
+	const discoveredFallbackUsers = [];
+	for (const candidate of userDirectories) {
+		const discovered = await discoverConfigFileInDirectory(candidate.directory, "user");
+		if (!discovered) continue;
+		if (!user) {
+			user = discovered;
+			if (candidate.kind === "legacy-macos") user.notes.push(`Using legacy macOS user config location "${discovered.directory}". Migrate this config to "${resolveUserConfigDirectory(options)}" to follow the current default path.`);
+			if (candidate.kind === "legacy-windows") user.notes.push(`Using legacy Windows user config location "${discovered.directory}". Migrate this config to "${resolveUserConfigDirectory(options)}" to follow the current default path.`);
+			continue;
+		}
+		discoveredFallbackUsers.push(discovered);
+	}
+	if (user) for (const fallback of discoveredFallbackUsers) user.notes.push(`Ignoring fallback user config file "${fallback.path}" because a higher-priority user config file was found at "${user.path}".`);
+	return {
+		...user ? { user } : {},
+		...currentWorkingDirectory ? { cwd: currentWorkingDirectory } : {}
+	};
+}
+//#endregion
+//#region src/cli/config/apply.ts
+function withConfigQuietSkips(currentQuietSkips, skippedFiles) {
+	if (skippedFiles === void 0) return currentQuietSkips;
+	return skippedFiles ? false : true;
+}
+function applyConfigToCountOptions(options, config, sources) {
+	const next = { ...options };
+	if (!sources.detector && config.detector !== void 0) next.detector = config.detector;
+	if (!sources.contentGate && config.contentGate?.mode !== void 0) next.contentGate = config.contentGate.mode;
+	if (!sources.pathMode && config.path?.mode !== void 0) next.pathMode = config.path.mode;
+	if (!sources.recursive && config.path?.recursive !== void 0) next.recursive = config.path.recursive;
+	next.pathDetectBinary = config.path?.detectBinary ?? next.pathDetectBinary ?? true;
+	if (!sources.includeExt && config.path?.includeExtensions !== void 0) next.includeExt = [...config.path.includeExtensions];
+	if (!sources.excludeExt && config.path?.excludeExtensions !== void 0) next.excludeExt = [...config.path.excludeExtensions];
+	if (!sources.totalOf && config.output?.totalOf !== void 0) next.totalOf = [...config.output.totalOf];
+	if (!sources.debug && config.logging?.level !== void 0) next.debug = config.logging.level === "debug";
+	const debugEnabled = next.debug === true;
+	if (debugEnabled && !sources.verbose && config.logging?.verbosity !== void 0) next.verbose = config.logging.verbosity === "verbose";
+	if (debugEnabled && !sources.debugReport && config.reporting?.debugReport?.path !== void 0) next.debugReport = config.reporting.debugReport.path;
+	const debugReportEnabled = next.debugReport !== void 0 && next.debugReport !== false;
+	if (debugEnabled && debugReportEnabled && !sources.debugReportTee && config.reporting?.debugReport?.tee !== void 0) next.debugReportTee = config.reporting.debugReport.tee;
+	if (!sources.progress && config.progress?.mode !== void 0) next.progressMode = config.progress.mode;
+	if (!sources.quietSkips) next.quietSkips = withConfigQuietSkips(next.quietSkips, config.reporting?.skippedFiles);
+	return next;
+}
+function applyConfigToInspectInvocation(validated, config) {
+	const next = {
+		...validated,
+		includeExt: [...validated.includeExt],
+		excludeExt: [...validated.excludeExt],
+		sources: { ...validated.sources }
+	};
+	const detectorFromConfig = config.inspect?.detector ?? config.detector;
+	if (!next.sources.detector && detectorFromConfig !== void 0) next.detector = detectorFromConfig;
+	const contentGateFromConfig = config.inspect?.contentGate?.mode ?? config.contentGate?.mode;
+	if (!next.sources.contentGate && contentGateFromConfig !== void 0) next.contentGateMode = contentGateFromConfig;
+	if (!next.sources.pathMode && config.path?.mode !== void 0) next.pathMode = config.path.mode;
+	if (!next.sources.recursive && config.path?.recursive !== void 0) next.recursive = config.path.recursive;
+	next.pathDetectBinary = config.path?.detectBinary ?? next.pathDetectBinary ?? true;
+	if (!next.sources.includeExt && config.path?.includeExtensions !== void 0) next.includeExt = [...config.path.includeExtensions];
+	if (!next.sources.excludeExt && config.path?.excludeExtensions !== void 0) next.excludeExt = [...config.path.excludeExtensions];
+	return next;
+}
+//#endregion
+//#region src/cli/total-of.ts
+const TOTAL_OF_PARTS = Object.freeze([
+	"words",
+	"emoji",
+	"symbols",
+	"punctuation",
+	"whitespace"
+]);
+const TOTAL_OF_PART_ALIASES = {
+	word: "words",
+	words: "words",
+	emoji: "emoji",
+	emojis: "emoji",
+	symbol: "symbols",
+	symbols: "symbols",
+	punction: "punctuation",
+	punctuation: "punctuation",
+	whitespace: "whitespace"
+};
+function createTotalOfCounts() {
+	return {
+		words: 0,
+		emoji: 0,
+		symbols: 0,
+		punctuation: 0,
+		whitespace: 0
+	};
+}
+function collectNonWordCounts(target, nonWords) {
+	if (!nonWords) return;
+	target.emoji += nonWords.counts.emoji;
+	target.symbols += nonWords.counts.symbols;
+	target.punctuation += nonWords.counts.punctuation;
+	target.whitespace += nonWords.counts.whitespace ?? 0;
+}
+function collectFromWordCounterResult(result) {
+	const counts = createTotalOfCounts();
+	counts.words += result.counts?.words ?? result.total;
+	if (result.breakdown.mode === "collector") {
+		collectNonWordCounts(counts, result.breakdown.nonWords);
+		return counts;
+	}
+	for (const item of result.breakdown.items) collectNonWordCounts(counts, item.nonWords);
+	return counts;
+}
+function collectTotalOfCounts(result) {
+	if (!("section" in result)) return collectFromWordCounterResult(result);
+	const counts = createTotalOfCounts();
+	for (const item of result.items) {
+		const itemCounts = collectFromWordCounterResult(item.result);
+		for (const part of TOTAL_OF_PARTS) counts[part] += itemCounts[part];
+	}
+	return counts;
+}
+function parseTotalOfToken(token) {
+	const canonical = TOTAL_OF_PART_ALIASES[token.trim().toLowerCase()];
+	if (canonical) return canonical;
+	throw new Error(`Invalid --total-of part: ${token}. Allowed: ${TOTAL_OF_PARTS.join(", ")}.`);
+}
+function parseTotalOfOption(value) {
+	const rawTokens = value.split(",").map((token) => token.trim()).filter((token) => token.length > 0);
+	if (rawTokens.length === 0) throw new Error(`Invalid --total-of value: "${value}". Use comma-separated parts from: ${TOTAL_OF_PARTS.join(", ")}.`);
+	const parts = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const token of rawTokens) {
+		const parsed = parseTotalOfToken(token);
+		if (seen.has(parsed)) continue;
+		seen.add(parsed);
+		parts.push(parsed);
+	}
+	return parts;
+}
+function requiresNonWordCollection(parts) {
+	if (!parts || parts.length === 0) return false;
+	return parts.some((part) => part !== "words");
+}
+function requiresWhitespaceCollection(parts) {
+	if (!parts || parts.length === 0) return false;
+	return parts.includes("whitespace");
+}
+function resolveTotalOfOverride(result, parts) {
+	if (!parts || parts.length === 0) return;
+	const counts = collectTotalOfCounts(result);
+	let total = 0;
+	for (const part of parts) total += counts[part];
+	return {
+		parts: [...parts],
+		total
+	};
+}
+function formatTotalOfParts(parts) {
+	return parts.join(", ");
+}
+//#endregion
+//#region src/cli/config/errors.ts
+var ConfigValidationError = class extends Error {
+	sourceLabel;
+	path;
+	constructor(sourceLabel, path, message) {
+		const suffix = path.length > 0 ? ` at "${path.join(".")}"` : "";
+		super(`Invalid config in ${sourceLabel}${suffix}: ${message}`);
+		this.name = "ConfigValidationError";
+		this.sourceLabel = sourceLabel;
+		this.path = [...path];
+	}
+};
+var ConfigParseError = class extends Error {
+	sourceLabel;
+	format;
+	constructor(sourceLabel, format, message) {
+		super(`Invalid ${format.toUpperCase()} config in ${sourceLabel}: ${message}`);
+		this.name = "ConfigParseError";
+		this.sourceLabel = sourceLabel;
+		this.format = format;
+	}
+};
+//#endregion
+//#region src/cli/config/normalize.ts
+function isRecord$1(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function createConfigError(sourceLabel, path, message) {
+	return new ConfigValidationError(sourceLabel, path, message);
+}
+function ensureObject$1(value, sourceLabel, path) {
+	if (value === void 0) return;
+	if (!isRecord$1(value)) throw createConfigError(sourceLabel, path, "expected an object.");
+	return value;
+}
+function rejectUnknownKeys(value, allowedKeys, sourceLabel, path) {
+	for (const key of Object.keys(value)) if (!allowedKeys.includes(key)) throw createConfigError(sourceLabel, [...path, key], "unknown key.");
+}
+function parseBoolean(value, sourceLabel, path) {
+	if (value === void 0) return;
+	if (typeof value !== "boolean") throw createConfigError(sourceLabel, path, "expected a boolean.");
+	return value;
+}
+function parseString(value, sourceLabel, path) {
+	if (value === void 0) return;
+	if (typeof value !== "string") throw createConfigError(sourceLabel, path, "expected a string.");
+	return value;
+}
+function parseStringArray(value, sourceLabel, path) {
+	if (value === void 0) return;
+	if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) throw createConfigError(sourceLabel, path, "expected an array of strings.");
+	return [...value];
+}
+function parseEnum(value, allowedValues, sourceLabel, path) {
+	if (value === void 0) return;
+	if (typeof value !== "string" || !allowedValues.includes(value)) throw createConfigError(sourceLabel, path, `expected one of: ${allowedValues.map((item) => `"${item}"`).join(", ")}.`);
+	return value;
+}
+function parseTotalOf(value, sourceLabel, path) {
+	if (value === void 0) return;
+	if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) throw createConfigError(sourceLabel, path, "expected an array of strings.");
+	const parts = [];
+	for (const item of value) {
+		const parsed = parseEnum(item, CONFIG_TOTAL_OF_VALUES, sourceLabel, path);
+		if (parsed && !parts.includes(parsed)) parts.push(parsed);
+	}
+	return parts;
+}
+function normalizeInspectConfig(value, sourceLabel) {
+	const section = ensureObject$1(value, sourceLabel, ["inspect"]);
+	if (!section) return;
+	rejectUnknownKeys(section, ["detector", "contentGate"], sourceLabel, ["inspect"]);
+	const detector = parseEnum(section.detector, CONFIG_DETECTOR_VALUES, sourceLabel, ["inspect", "detector"]);
+	const contentGateSection = ensureObject$1(section.contentGate, sourceLabel, ["inspect", "contentGate"]);
+	if (contentGateSection) rejectUnknownKeys(contentGateSection, ["mode"], sourceLabel, ["inspect", "contentGate"]);
+	const mode = parseEnum(contentGateSection?.mode, CONFIG_CONTENT_GATE_MODE_VALUES, sourceLabel, [
+		"inspect",
+		"contentGate",
+		"mode"
+	]);
+	const normalized = {};
+	if (detector !== void 0) normalized.detector = detector;
+	if (mode !== void 0) normalized.contentGate = { mode };
+	return Object.keys(normalized).length > 0 ? normalized : void 0;
+}
+function normalizeContentGateConfig(value, sourceLabel) {
+	const section = ensureObject$1(value, sourceLabel, ["contentGate"]);
+	if (!section) return;
+	rejectUnknownKeys(section, ["mode"], sourceLabel, ["contentGate"]);
+	const mode = parseEnum(section.mode, CONFIG_CONTENT_GATE_MODE_VALUES, sourceLabel, ["contentGate", "mode"]);
+	return mode === void 0 ? void 0 : { mode };
+}
+function normalizePathConfig(value, sourceLabel) {
+	const section = ensureObject$1(value, sourceLabel, ["path"]);
+	if (!section) return;
+	rejectUnknownKeys(section, [
+		"mode",
+		"recursive",
+		"includeExtensions",
+		"excludeExtensions",
+		"detectBinary"
+	], sourceLabel, ["path"]);
+	const mode = parseEnum(section.mode, CONFIG_PATH_MODE_VALUES, sourceLabel, ["path", "mode"]);
+	const recursive = parseBoolean(section.recursive, sourceLabel, ["path", "recursive"]);
+	const includeExtensions = parseStringArray(section.includeExtensions, sourceLabel, ["path", "includeExtensions"]);
+	const excludeExtensions = parseStringArray(section.excludeExtensions, sourceLabel, ["path", "excludeExtensions"]);
+	const detectBinary = parseBoolean(section.detectBinary, sourceLabel, ["path", "detectBinary"]);
+	const normalized = {};
+	if (mode !== void 0) normalized.mode = mode;
+	if (recursive !== void 0) normalized.recursive = recursive;
+	if (includeExtensions !== void 0) normalized.includeExtensions = includeExtensions;
+	if (excludeExtensions !== void 0) normalized.excludeExtensions = excludeExtensions;
+	if (detectBinary !== void 0) normalized.detectBinary = detectBinary;
+	return Object.keys(normalized).length > 0 ? normalized : void 0;
+}
+function normalizeProgressConfig(value, sourceLabel) {
+	const section = ensureObject$1(value, sourceLabel, ["progress"]);
+	if (!section) return;
+	rejectUnknownKeys(section, ["mode"], sourceLabel, ["progress"]);
+	const mode = parseEnum(section.mode, CONFIG_PROGRESS_MODE_VALUES, sourceLabel, ["progress", "mode"]);
+	return mode === void 0 ? void 0 : { mode };
+}
+function normalizeOutputConfig(value, sourceLabel) {
+	const section = ensureObject$1(value, sourceLabel, ["output"]);
+	if (!section) return;
+	rejectUnknownKeys(section, ["totalOf"], sourceLabel, ["output"]);
+	const totalOf = parseTotalOf(section.totalOf, sourceLabel, ["output", "totalOf"]);
+	return totalOf === void 0 ? void 0 : { totalOf };
+}
+function normalizeReportingConfig(value, sourceLabel) {
+	const section = ensureObject$1(value, sourceLabel, ["reporting"]);
+	if (!section) return;
+	rejectUnknownKeys(section, ["skippedFiles", "debugReport"], sourceLabel, ["reporting"]);
+	const skippedFiles = parseBoolean(section.skippedFiles, sourceLabel, ["reporting", "skippedFiles"]);
+	const debugReportSection = ensureObject$1(section.debugReport, sourceLabel, ["reporting", "debugReport"]);
+	if (debugReportSection) rejectUnknownKeys(debugReportSection, ["path", "tee"], sourceLabel, ["reporting", "debugReport"]);
+	const path = parseString(debugReportSection?.path, sourceLabel, [
+		"reporting",
+		"debugReport",
+		"path"
+	]);
+	const tee = parseBoolean(debugReportSection?.tee, sourceLabel, [
+		"reporting",
+		"debugReport",
+		"tee"
+	]);
+	const normalized = {};
+	if (skippedFiles !== void 0) normalized.skippedFiles = skippedFiles;
+	if (path !== void 0 || tee !== void 0) {
+		normalized.debugReport = {};
+		if (path !== void 0) normalized.debugReport.path = path;
+		if (tee !== void 0) normalized.debugReport.tee = tee;
+	}
+	return Object.keys(normalized).length > 0 ? normalized : void 0;
+}
+function normalizeLoggingConfig(value, sourceLabel) {
+	const section = ensureObject$1(value, sourceLabel, ["logging"]);
+	if (!section) return;
+	rejectUnknownKeys(section, ["level", "verbosity"], sourceLabel, ["logging"]);
+	const level = parseEnum(section.level, CONFIG_LOG_LEVEL_VALUES, sourceLabel, ["logging", "level"]);
+	const verbosity = parseEnum(section.verbosity, CONFIG_LOG_VERBOSITY_VALUES, sourceLabel, ["logging", "verbosity"]);
+	const normalized = {};
+	if (level !== void 0) normalized.level = level;
+	if (verbosity !== void 0) normalized.verbosity = verbosity;
+	return Object.keys(normalized).length > 0 ? normalized : void 0;
+}
+function normalizeWordCounterConfig(value, sourceLabel) {
+	const root = ensureObject$1(value, sourceLabel, []);
+	if (!root) throw createConfigError(sourceLabel, [], "expected a root object.");
+	rejectUnknownKeys(root, [
+		"detector",
+		"contentGate",
+		"inspect",
+		"path",
+		"progress",
+		"output",
+		"reporting",
+		"logging"
+	], sourceLabel, []);
+	const detector = parseEnum(root.detector, CONFIG_DETECTOR_VALUES, sourceLabel, ["detector"]);
+	const contentGate = normalizeContentGateConfig(root.contentGate, sourceLabel);
+	const inspect = normalizeInspectConfig(root.inspect, sourceLabel);
+	const path = normalizePathConfig(root.path, sourceLabel);
+	const progress = normalizeProgressConfig(root.progress, sourceLabel);
+	const output = normalizeOutputConfig(root.output, sourceLabel);
+	const reporting = normalizeReportingConfig(root.reporting, sourceLabel);
+	const logging = normalizeLoggingConfig(root.logging, sourceLabel);
+	const normalized = {};
+	if (detector !== void 0) normalized.detector = detector;
+	if (contentGate !== void 0) normalized.contentGate = contentGate;
+	if (inspect !== void 0) normalized.inspect = inspect;
+	if (path !== void 0) normalized.path = path;
+	if (progress !== void 0) normalized.progress = progress;
+	if (output !== void 0) normalized.output = output;
+	if (reporting !== void 0) normalized.reporting = reporting;
+	if (logging !== void 0) normalized.logging = logging;
+	return normalized;
+}
+//#endregion
+//#region src/cli/config/env.ts
+function parseBooleanEnv(name, value) {
+	if (value === void 0) return;
+	const normalized = value.trim().toLowerCase();
+	if (normalized === "1" || normalized === "true" || normalized === "yes" || normalized === "on") return true;
+	if (normalized === "0" || normalized === "false" || normalized === "no" || normalized === "off") return false;
+	throw new Error(`Invalid value for ${name}: ${value}`);
+}
+function parseCommaSeparatedEnv(value) {
+	if (value === void 0) return;
+	const tokens = value.split(",").map((token) => token.trim()).filter((token) => token.length > 0);
+	return tokens.length > 0 ? tokens : [];
+}
+function resolveEnvConfig(env = process.env) {
+	const pathMode = env.WORD_COUNTER_PATH_MODE;
+	const recursive = parseBooleanEnv("WORD_COUNTER_RECURSIVE", env.WORD_COUNTER_RECURSIVE);
+	const includeExtensions = parseCommaSeparatedEnv(env.WORD_COUNTER_INCLUDE_EXT);
+	const excludeExtensions = parseCommaSeparatedEnv(env.WORD_COUNTER_EXCLUDE_EXT);
+	const skippedFiles = parseBooleanEnv("WORD_COUNTER_REPORT_SKIPS", env.WORD_COUNTER_REPORT_SKIPS);
+	const totalOfRaw = env.WORD_COUNTER_TOTAL_OF;
+	const contentGateMode = env.WORD_COUNTER_CONTENT_GATE;
+	const progressMode = env.WORD_COUNTER_PROGRESS;
+	const logLevel = env.WORD_COUNTER_LOG_LEVEL;
+	const logVerbosity = env.WORD_COUNTER_LOG_VERBOSITY;
+	const debugReportPath = env.WORD_COUNTER_DEBUG_REPORT;
+	const debugReportTee = parseBooleanEnv("WORD_COUNTER_DEBUG_REPORT_TEE", env.WORD_COUNTER_DEBUG_REPORT_TEE);
+	const config = {};
+	if (pathMode !== void 0 || recursive !== void 0 || includeExtensions !== void 0 || excludeExtensions !== void 0) {
+		config.path = {};
+		if (pathMode !== void 0) config.path.mode = pathMode;
+		if (recursive !== void 0) config.path.recursive = recursive;
+		if (includeExtensions !== void 0) config.path.includeExtensions = includeExtensions;
+		if (excludeExtensions !== void 0) config.path.excludeExtensions = excludeExtensions;
+	}
+	if (progressMode !== void 0) config.progress = { mode: progressMode };
+	if (totalOfRaw !== void 0) config.output = { totalOf: parseTotalOfOption(totalOfRaw) };
+	if (contentGateMode !== void 0) {
+		config.contentGate = { mode: contentGateMode };
+		config.inspect = {
+			...config.inspect,
+			contentGate: { mode: contentGateMode }
+		};
+	}
+	if (skippedFiles !== void 0 || debugReportPath !== void 0 || debugReportTee !== void 0) {
+		config.reporting = {};
+		if (skippedFiles !== void 0) config.reporting.skippedFiles = skippedFiles;
+		if (debugReportPath !== void 0 || debugReportTee !== void 0) {
+			config.reporting.debugReport = {};
+			if (debugReportPath !== void 0) config.reporting.debugReport.path = debugReportPath;
+			if (debugReportTee !== void 0) config.reporting.debugReport.tee = debugReportTee;
+		}
+	}
+	if (logLevel !== void 0 || logVerbosity !== void 0) {
+		config.logging = {};
+		if (logLevel !== void 0) config.logging.level = logLevel;
+		if (logVerbosity !== void 0) config.logging.verbosity = logVerbosity;
+	}
+	return normalizeWordCounterConfig(config, "environment variables");
+}
+//#endregion
+//#region src/cli/config/merge.ts
+function mergeSection(base, override) {
+	if (!base) return override ? { ...override } : void 0;
+	if (!override) return { ...base };
+	return {
+		...base,
+		...override
+	};
+}
+function mergeNestedSection(base, override, nestedKey) {
+	const merged = mergeSection(base, override);
+	if (!merged) return;
+	const baseRecord = base;
+	const overrideRecord = override;
+	const baseNested = baseRecord?.[nestedKey];
+	const overrideNested = overrideRecord?.[nestedKey];
+	if (typeof baseNested === "object" && baseNested !== null && typeof overrideNested === "object" && overrideNested !== null) return {
+		...merged,
+		[nestedKey]: {
+			...baseNested,
+			...overrideNested
+		}
+	};
+	return merged;
+}
+function mergeWordCounterConfig(base, override) {
+	return {
+		...base,
+		...override,
+		...base.inspect || override.inspect ? { inspect: mergeSection(base.inspect, override.inspect) } : {},
+		...base.path || override.path ? { path: mergeSection(base.path, override.path) } : {},
+		...base.progress || override.progress ? { progress: mergeSection(base.progress, override.progress) } : {},
+		...base.output || override.output ? { output: mergeSection(base.output, override.output) } : {},
+		...base.reporting || override.reporting ? { reporting: mergeNestedSection(base.reporting, override.reporting, "debugReport") } : {},
+		...base.logging || override.logging ? { logging: mergeSection(base.logging, override.logging) } : {}
+	};
+}
+//#endregion
+//#region src/cli/config/jsonc.ts
+function isEscaped(text, index) {
+	let backslashCount = 0;
+	for (let cursor = index - 1; cursor >= 0 && text[cursor] === "\\"; cursor -= 1) backslashCount += 1;
+	return backslashCount % 2 === 1;
+}
+function stripJsonComments(text) {
+	let result = "";
+	let inString = false;
+	let inLineComment = false;
+	let inBlockComment = false;
+	for (let index = 0; index < text.length; index += 1) {
+		const current = text[index] ?? "";
+		const next = text[index + 1] ?? "";
+		if (inLineComment) {
+			if (current === "\n") {
+				inLineComment = false;
+				result += current;
+			}
+			continue;
+		}
+		if (inBlockComment) {
+			if (current === "*" && next === "/") {
+				inBlockComment = false;
+				index += 1;
+			}
+			continue;
+		}
+		if (inString) {
+			result += current;
+			if (current === "\"" && !isEscaped(text, index)) inString = false;
+			continue;
+		}
+		if (current === "\"") {
+			inString = true;
+			result += current;
+			continue;
+		}
+		if (current === "/" && next === "/") {
+			inLineComment = true;
+			index += 1;
+			continue;
+		}
+		if (current === "/" && next === "*") {
+			inBlockComment = true;
+			index += 1;
+			continue;
+		}
+		result += current;
+	}
+	if (inBlockComment) throw new Error("Unterminated block comment in JSONC config.");
+	return result;
+}
+//#endregion
+//#region src/cli/config/toml-tokens.ts
+function stripInlineComment$1(line) {
+	let inSingle = false;
+	let inDouble = false;
+	for (let index = 0; index < line.length; index += 1) {
+		const current = line[index] ?? "";
+		const previous = line[index - 1] ?? "";
+		if (current === "'" && !inDouble) {
+			inSingle = !inSingle;
+			continue;
+		}
+		if (current === "\"" && !inSingle && previous !== "\\") {
+			inDouble = !inDouble;
+			continue;
+		}
+		if (current === "#" && !inSingle && !inDouble) return line.slice(0, index);
+	}
+	return line;
+}
+function splitPath(path, rawLine) {
+	const parts = path.split(".").map((part) => part.trim());
+	if (parts.some((part) => part.length === 0)) throw new Error(`Invalid TOML key: ${rawLine}`);
+	return parts;
+}
+function tokenizeTomlLine(rawLine, currentTable) {
+	const line = stripInlineComment$1(rawLine).trim();
+	if (!line) return;
+	const tableMatch = line.match(/^\[([A-Za-z0-9_.-]+)]$/);
+	if (tableMatch) return {
+		kind: "table",
+		path: splitPath(tableMatch[1] ?? "", rawLine),
+		rawLine
+	};
+	const separatorIndex = line.indexOf("=");
+	if (separatorIndex <= 0) throw new Error(`Invalid TOML assignment: ${rawLine}`);
+	const rawKey = line.slice(0, separatorIndex).trim();
+	const rawValue = line.slice(separatorIndex + 1).trim();
+	if (!rawKey || !rawValue) throw new Error(`Invalid TOML assignment: ${rawLine}`);
+	return {
+		kind: "assignment",
+		keyPath: [...currentTable, ...splitPath(rawKey, rawLine)],
+		rawValue,
+		rawLine
+	};
+}
+function tokenizeTomlConfig(text) {
+	const tokens = [];
+	let currentTable = [];
+	for (const rawLine of text.split(/\r?\n/)) {
+		const token = tokenizeTomlLine(rawLine, currentTable);
+		if (!token) continue;
+		if (token.kind === "table") {
+			currentTable = token.path;
+			tokens.push(token);
+			continue;
+		}
+		tokens.push(token);
+	}
+	return tokens;
+}
+//#endregion
+//#region src/cli/config/toml.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseTomlString(rawValue) {
+	if (rawValue.length < 2) throw new Error(`Invalid TOML string value: ${rawValue}`);
+	const quote = rawValue[0];
+	const inner = rawValue.slice(1, -1);
+	if (quote === "'") return inner;
+	return inner.replace(/\\(["\\bfnrt])/g, (_match, escaped) => {
+		switch (escaped) {
+			case "\"": return "\"";
+			case "\\": return "\\";
+			case "b": return "\b";
+			case "f": return "\f";
+			case "n": return "\n";
+			case "r": return "\r";
+			case "t": return "	";
+			default: return escaped;
+		}
+	});
+}
+function splitTomlArrayItems(rawValue) {
+	const items = [];
+	let buffer = "";
+	let inSingle = false;
+	let inDouble = false;
+	for (let index = 0; index < rawValue.length; index += 1) {
+		const current = rawValue[index] ?? "";
+		const previous = rawValue[index - 1] ?? "";
+		if (current === "'" && !inDouble) {
+			inSingle = !inSingle;
+			buffer += current;
+			continue;
+		}
+		if (current === "\"" && !inSingle && previous !== "\\") {
+			inDouble = !inDouble;
+			buffer += current;
+			continue;
+		}
+		if (current === "," && !inSingle && !inDouble) {
+			items.push(buffer.trim());
+			buffer = "";
+			continue;
+		}
+		buffer += current;
+	}
+	if (buffer.trim().length > 0) items.push(buffer.trim());
+	return items;
+}
+function parseTomlValue(rawValue) {
+	const trimmed = rawValue.trim();
+	if (trimmed === "true") return true;
+	if (trimmed === "false") return false;
+	if (trimmed.startsWith("\"") && trimmed.endsWith("\"") || trimmed.startsWith("'") && trimmed.endsWith("'")) return parseTomlString(trimmed);
+	if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+		const inner = trimmed.slice(1, -1).trim();
+		if (inner.length === 0) return [];
+		return splitTomlArrayItems(inner).map((item) => {
+			const parsed = parseTomlValue(item);
+			if (Array.isArray(parsed)) throw new Error(`Nested TOML arrays are not supported: ${rawValue}`);
+			return parsed;
+		});
+	}
+	throw new Error(`Unsupported TOML value: ${rawValue}`);
+}
+function ensureObject(parent, key) {
+	const existing = parent[key];
+	if (existing === void 0) {
+		const next = {};
+		parent[key] = next;
+		return next;
+	}
+	if (!isRecord(existing)) throw new Error(`Cannot redefine non-table key as table: ${key}`);
+	return existing;
+}
+function setNestedValue(root, keyPath, value) {
+	let target = root;
+	for (let index = 0; index < keyPath.length - 1; index += 1) target = ensureObject(target, keyPath[index] ?? "");
+	const leafKey = keyPath[keyPath.length - 1] ?? "";
+	if (leafKey in target) throw new Error(`Duplicate TOML key: ${keyPath.join(".")}`);
+	target[leafKey] = value;
+}
+function parseTomlConfig(text) {
+	const result = {};
+	for (const token of tokenizeTomlConfig(text)) {
+		if (token.kind === "table") {
+			let tableTarget = result;
+			for (const part of token.path) tableTarget = ensureObject(tableTarget, part);
+			continue;
+		}
+		setNestedValue(result, token.keyPath, parseTomlValue(token.rawValue));
+	}
+	return result;
+}
+//#endregion
+//#region src/cli/config/parse.ts
+function parseJsonConfig(text, sourceLabel, format) {
+	try {
+		return JSON.parse(text);
+	} catch (error) {
+		throw new ConfigParseError(sourceLabel, format, error instanceof Error ? error.message : String(error));
+	}
+}
+function parseConfigText(text, format, sourceLabel) {
+	let parsed;
+	if (format === "json") parsed = parseJsonConfig(text, sourceLabel, "json");
+	else if (format === "jsonc") try {
+		parsed = parseJsonConfig(stripJsonComments(text), sourceLabel, "jsonc");
+	} catch (error) {
+		if (error instanceof ConfigParseError) throw error;
+		throw new ConfigParseError(sourceLabel, "jsonc", error instanceof Error ? error.message : String(error));
+	}
+	else try {
+		parsed = parseTomlConfig(text);
+	} catch (error) {
+		throw new ConfigParseError(sourceLabel, "toml", error instanceof Error ? error.message : String(error));
+	}
+	try {
+		return normalizeWordCounterConfig(parsed, sourceLabel);
+	} catch (error) {
+		if (error instanceof ConfigValidationError) throw error;
+		throw new ConfigParseError(sourceLabel, format, error instanceof Error ? error.message : String(error));
+	}
+}
+async function loadConfigFile(path, format) {
+	let text;
+	try {
+		text = await readFile(path, "utf8");
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		throw new Error(`Failed to read config file (${path}): ${message}`);
+	}
+	return {
+		format,
+		path,
+		config: parseConfigText(text, format, path)
+	};
+}
+//#endregion
+//#region src/cli/config/resolve.ts
+async function resolveWordCounterConfig(options = {}) {
+	const discovered = await discoverConfigFiles(options);
+	const filesToLoad = [discovered.user, discovered.cwd].filter((item) => item !== void 0);
+	const loadedFiles = await Promise.all(filesToLoad.map(async (item) => {
+		return {
+			...await loadConfigFile(item.path, item.format),
+			notes: item.notes
+		};
+	}));
+	let config = {};
+	const files = [];
+	const notes = [];
+	for (const loaded of loadedFiles) {
+		config = mergeWordCounterConfig(config, loaded.config);
+		files.push({
+			path: loaded.path,
+			format: loaded.format,
+			config: loaded.config
+		});
+		notes.push(...loaded.notes);
+	}
+	config = mergeWordCounterConfig(config, resolveEnvConfig(options.env));
+	return {
+		config,
+		files,
+		notes
+	};
+}
+//#endregion
+//#region src/cli/config/sources.ts
+function isCliOptionSource(program, optionName) {
+	return program.getOptionValueSource(optionName) === "cli";
+}
+function deriveCountCliSources(program) {
+	return {
+		detector: isCliOptionSource(program, "detector"),
+		contentGate: isCliOptionSource(program, "contentGate"),
+		pathMode: isCliOptionSource(program, "pathMode"),
+		recursive: isCliOptionSource(program, "recursive"),
+		includeExt: isCliOptionSource(program, "includeExt"),
+		excludeExt: isCliOptionSource(program, "excludeExt"),
+		totalOf: isCliOptionSource(program, "totalOf"),
+		debug: isCliOptionSource(program, "debug"),
+		verbose: isCliOptionSource(program, "verbose"),
+		debugReport: isCliOptionSource(program, "debugReport"),
+		debugReportTee: isCliOptionSource(program, "debugReportTee") || isCliOptionSource(program, "debugTee"),
+		progress: isCliOptionSource(program, "progress"),
+		quietSkips: isCliOptionSource(program, "quietSkips")
+	};
+}
+function deriveInitialCountProgressMode(program, rawProgressValue) {
+	if (!isCliOptionSource(program, "progress")) return "auto";
+	return rawProgressValue ? "on" : "off";
+}
+//#endregion
 //#region src/cli/debug/channel.ts
 const DEBUG_EVENT_SCHEMA_VERSION = 1;
 const NOOP_CLOSE = async () => {};
@@ -333,6 +1211,7 @@ async function countBatchInputsWithWorkerJobs(filePaths, options) {
 			section: options.section,
 			detectorMode: options.detectorMode ?? "regex",
 			wcOptions: options.wcOptions,
+			detectBinary: options.detectBinary ?? true,
 			preserveCollectorSegments: options.preserveCollectorSegments,
 			detectorEvidence: options.detectorEvidence,
 			debugVerbosity: options.debugVerbosity,
@@ -354,8 +1233,12 @@ async function countBatchInputsWithWorkerJobs(filePaths, options) {
 }
 //#endregion
 //#region src/cli/doctor/checks.ts
-const REQUIRED_NODE_RANGE = ">=20";
-const REQUIRED_NODE_MAJOR = 20;
+const REQUIRED_NODE_RANGE = ">=22.18.0";
+const REQUIRED_NODE_VERSION = {
+	major: 22,
+	minor: 18,
+	patch: 0
+};
 const SAMPLE_TEXT = "Hello 世界";
 function normalizePackageVersion(value) {
 	const trimmed = value?.trim();
@@ -368,22 +1251,35 @@ function deriveBuildChannel(packageVersion) {
 	if (channel === "alpha" || channel === "beta" || channel === "rc" || channel === "canary") return channel;
 	return "stable";
 }
-function parseNodeMajor(version) {
-	const match = /^v?(\d+)(?:\.\d+){0,2}(?:[-+].*)?$/.exec(version.trim());
+function parseNodeVersion(version) {
+	const match = /^v?(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:[-+].*)?$/.exec(version.trim());
 	if (!match) return null;
 	const major = Number.parseInt(match[1] ?? "", 10);
-	return Number.isFinite(major) ? major : null;
+	const minor = Number.parseInt(match[2] ?? "0", 10);
+	const patch = Number.parseInt(match[3] ?? "0", 10);
+	if (!Number.isFinite(major) || !Number.isFinite(minor) || !Number.isFinite(patch)) return null;
+	return {
+		major,
+		minor,
+		patch
+	};
+}
+function meetsRequiredNodeVersion(version) {
+	if (!version) return false;
+	if (version.major !== REQUIRED_NODE_VERSION.major) return version.major > REQUIRED_NODE_VERSION.major;
+	if (version.minor !== REQUIRED_NODE_VERSION.minor) return version.minor > REQUIRED_NODE_VERSION.minor;
+	return version.patch >= REQUIRED_NODE_VERSION.patch;
 }
 function resolveRuntimeSummary(overrides = {}) {
-	const packageVersion = normalizePackageVersion(overrides.packageVersion ?? "0.1.5-canary.4");
+	const packageVersion = normalizePackageVersion(overrides.packageVersion ?? "0.1.5");
 	const nodeVersion = overrides.nodeVersion ?? process.version;
-	const major = parseNodeMajor(nodeVersion);
+	const parsedNodeVersion = parseNodeVersion(nodeVersion);
 	return {
 		packageVersion,
 		buildChannel: deriveBuildChannel(packageVersion),
 		requiredNodeRange: REQUIRED_NODE_RANGE,
 		nodeVersion,
-		meetsProjectRequirement: major !== null && major >= REQUIRED_NODE_MAJOR,
+		meetsProjectRequirement: meetsRequiredNodeVersion(parsedNodeVersion),
 		platform: overrides.platform ?? process.platform,
 		arch: overrides.arch ?? process.arch
 	};
@@ -3698,100 +4594,6 @@ async function resolveBatchFilePaths(pathInputs, options) {
 	};
 }
 //#endregion
-//#region src/cli/total-of.ts
-const TOTAL_OF_PARTS = Object.freeze([
-	"words",
-	"emoji",
-	"symbols",
-	"punctuation",
-	"whitespace"
-]);
-const TOTAL_OF_PART_ALIASES = {
-	word: "words",
-	words: "words",
-	emoji: "emoji",
-	emojis: "emoji",
-	symbol: "symbols",
-	symbols: "symbols",
-	punction: "punctuation",
-	punctuation: "punctuation",
-	whitespace: "whitespace"
-};
-function createTotalOfCounts() {
-	return {
-		words: 0,
-		emoji: 0,
-		symbols: 0,
-		punctuation: 0,
-		whitespace: 0
-	};
-}
-function collectNonWordCounts(target, nonWords) {
-	if (!nonWords) return;
-	target.emoji += nonWords.counts.emoji;
-	target.symbols += nonWords.counts.symbols;
-	target.punctuation += nonWords.counts.punctuation;
-	target.whitespace += nonWords.counts.whitespace ?? 0;
-}
-function collectFromWordCounterResult(result) {
-	const counts = createTotalOfCounts();
-	counts.words += result.counts?.words ?? result.total;
-	if (result.breakdown.mode === "collector") {
-		collectNonWordCounts(counts, result.breakdown.nonWords);
-		return counts;
-	}
-	for (const item of result.breakdown.items) collectNonWordCounts(counts, item.nonWords);
-	return counts;
-}
-function collectTotalOfCounts(result) {
-	if (!("section" in result)) return collectFromWordCounterResult(result);
-	const counts = createTotalOfCounts();
-	for (const item of result.items) {
-		const itemCounts = collectFromWordCounterResult(item.result);
-		for (const part of TOTAL_OF_PARTS) counts[part] += itemCounts[part];
-	}
-	return counts;
-}
-function parseTotalOfToken(token) {
-	const canonical = TOTAL_OF_PART_ALIASES[token.trim().toLowerCase()];
-	if (canonical) return canonical;
-	throw new Error(`Invalid --total-of part: ${token}. Allowed: ${TOTAL_OF_PARTS.join(", ")}.`);
-}
-function parseTotalOfOption(value) {
-	const rawTokens = value.split(",").map((token) => token.trim()).filter((token) => token.length > 0);
-	if (rawTokens.length === 0) throw new Error(`Invalid --total-of value: "${value}". Use comma-separated parts from: ${TOTAL_OF_PARTS.join(", ")}.`);
-	const parts = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const token of rawTokens) {
-		const parsed = parseTotalOfToken(token);
-		if (seen.has(parsed)) continue;
-		seen.add(parsed);
-		parts.push(parsed);
-	}
-	return parts;
-}
-function requiresNonWordCollection(parts) {
-	if (!parts || parts.length === 0) return false;
-	return parts.some((part) => part !== "words");
-}
-function requiresWhitespaceCollection(parts) {
-	if (!parts || parts.length === 0) return false;
-	return parts.includes("whitespace");
-}
-function resolveTotalOfOverride(result, parts) {
-	if (!parts || parts.length === 0) return;
-	const counts = collectTotalOfCounts(result);
-	let total = 0;
-	for (const part of parts) total += counts[part];
-	return {
-		parts: [...parts],
-		total
-	};
-}
-function formatTotalOfParts(parts) {
-	return parts.join(", ");
-}
-//#endregion
 //#region src/cli/runtime/options.ts
 function hasPathInput(pathValues) {
 	return Array.isArray(pathValues) && pathValues.length > 0;
@@ -3929,10 +4731,10 @@ function selectInspectText(input, section) {
 	if (section === "frontmatter") return parsed.frontmatter ?? "";
 	return parsed.content;
 }
-async function loadSingleInspectInput(path, textTokens, section) {
+async function loadSingleInspectInput(path, textTokens, section, detectBinary = true) {
 	if (path) try {
 		const buffer = await readFile(path);
-		if (isProbablyBinary(buffer)) throw new Error("binary file");
+		if (detectBinary && isProbablyBinary(buffer)) throw new Error("binary file");
 		return {
 			text: selectInspectText(buffer.toString("utf8"), section),
 			sourceType: "path",
@@ -3986,7 +4788,7 @@ async function loadInspectBatchInputs(pathInputs, options) {
 			});
 			continue;
 		}
-		if (isProbablyBinary(buffer)) {
+		if (options.pathDetectBinary && isProbablyBinary(buffer)) {
 			if (entry.source === "direct") failures.push({
 				path: entry.path,
 				reason: "binary file"
@@ -4165,13 +4967,14 @@ const INSPECT_HELP_LINES = [
 	"inspect detector behavior without count output",
 	"",
 	"Options:",
-	"  --detector <mode>  inspect detector mode (wasm, regex) (default: wasm)",
+	"  -d, --detector <mode>  inspect detector mode (wasm, regex) (default: regex)",
 	"  --content-gate <mode>  content gate mode (default, strict, loose, off) (default: default)",
 	"  --view <view>      inspect view (pipeline, engine) (default: pipeline)",
 	"  -f, --format <format>  inspect output format (standard, json) (default: standard)",
 	"  --pretty          pretty print inspect JSON output",
 	"  --section <section>  inspect section selector (all, frontmatter, content) (default: all)",
 	"  --path-mode <mode>  path resolution mode for --path inputs (auto, manual) (default: auto)",
+	"  --recursive        enable recursive directory traversal for --path directories",
 	"  --no-recursive     disable recursive directory traversal for --path directories",
 	"  --include-ext <exts>  comma-separated extensions to include during directory scanning",
 	"  --exclude-ext <exts>  comma-separated extensions to exclude during directory scanning",
@@ -4185,7 +4988,7 @@ function printInspectHelp() {
 //#endregion
 //#region src/cli/inspect/parse.ts
 function parseDetector(rawValue) {
-	if (rawValue === void 0) return "wasm";
+	if (rawValue === void 0) return "regex";
 	if (rawValue === "wasm" || rawValue === "regex") return rawValue;
 	return null;
 }
@@ -4212,13 +5015,10 @@ function parsePathMode(rawValue) {
 function isSupportedInspectSectionMode(value) {
 	return value === "all" || value === "frontmatter" || value === "content";
 }
-function isInvalidInspectDetectorViewCombination(detector, view) {
-	return view === "engine" && detector === "regex";
-}
 function validateInspectInvocation(argv) {
 	const inspectIndex = argv.findIndex((token, index) => index >= 2 && token === "inspect");
 	const tokens = inspectIndex >= 0 ? argv.slice(inspectIndex + 1) : [];
-	let detector = "wasm";
+	let detector = "regex";
 	let contentGateMode = "default";
 	let view = "pipeline";
 	let format = "standard";
@@ -4231,6 +5031,14 @@ function validateInspectInvocation(argv) {
 	const excludeExt = [];
 	let regex;
 	const textTokens = [];
+	const sources = {
+		detector: false,
+		contentGate: false,
+		pathMode: false,
+		recursive: false,
+		includeExt: false,
+		excludeExt: false
+	};
 	let expects = null;
 	let positionalMode = false;
 	const consumeValue = (kind, value) => {
@@ -4238,6 +5046,7 @@ function validateInspectInvocation(argv) {
 			const parsed = parseDetector(value);
 			if (parsed === null) return "`--detector` must be `wasm` or `regex`.";
 			detector = parsed;
+			sources.detector = true;
 			return null;
 		}
 		if (kind === "view") {
@@ -4250,6 +5059,7 @@ function validateInspectInvocation(argv) {
 			const parsed = parseContentGateMode(value);
 			if (parsed === null) return "`--content-gate` must be `default`, `strict`, `loose`, or `off`.";
 			contentGateMode = parsed;
+			sources.contentGate = true;
 			return null;
 		}
 		if (kind === "format") {
@@ -4268,6 +5078,7 @@ function validateInspectInvocation(argv) {
 			const parsed = parsePathMode(value);
 			if (parsed === null) return "`--path-mode` must be `auto` or `manual`.";
 			pathMode = parsed;
+			sources.pathMode = true;
 			return null;
 		}
 		if (kind === "path") {
@@ -4276,10 +5087,12 @@ function validateInspectInvocation(argv) {
 		}
 		if (kind === "includeExt") {
 			includeExt.push(value);
+			sources.includeExt = true;
 			return null;
 		}
 		if (kind === "excludeExt") {
 			excludeExt.push(value);
+			sources.excludeExt = true;
 			return null;
 		}
 		if (regex !== void 0) return "`--regex` can only be provided once.";
@@ -4308,16 +5121,22 @@ function validateInspectInvocation(argv) {
 			positionalMode = true;
 			continue;
 		}
+		if (token === "--recursive") {
+			recursive = true;
+			sources.recursive = true;
+			continue;
+		}
 		if (token === "--no-recursive") {
 			recursive = false;
+			sources.recursive = true;
 			continue;
 		}
 		if (token === "--pretty") {
 			pretty = true;
 			continue;
 		}
-		if (token === "--detector" || token === "--content-gate" || token === "--view" || token === "--format" || token === "-f" || token === "--section" || token === "--path-mode" || token === "--path" || token === "-p" || token === "--include-ext" || token === "--exclude-ext" || token === "--regex") {
-			expects = token === "-p" ? "path" : token === "--content-gate" ? "contentGate" : token === "-f" ? "format" : token === "--path-mode" ? "pathMode" : token === "--include-ext" ? "includeExt" : token === "--exclude-ext" ? "excludeExt" : token.slice(2);
+		if (token === "--detector" || token === "-d" || token === "--content-gate" || token === "--view" || token === "--format" || token === "-f" || token === "--section" || token === "--path-mode" || token === "--path" || token === "-p" || token === "--include-ext" || token === "--exclude-ext" || token === "--regex") {
+			expects = token === "-p" ? "path" : token === "-d" ? "detector" : token === "--content-gate" ? "contentGate" : token === "-f" ? "format" : token === "--path-mode" ? "pathMode" : token === "--include-ext" ? "includeExt" : token === "--exclude-ext" ? "excludeExt" : token.slice(2);
 			continue;
 		}
 		if (token.startsWith("--detector=") || token.startsWith("--content-gate=") || token.startsWith("--view=") || token.startsWith("--format=") || token.startsWith("--section=") || token.startsWith("--path-mode=") || token.startsWith("--path=") || token.startsWith("--include-ext=") || token.startsWith("--exclude-ext=") || token.startsWith("--regex=")) {
@@ -4354,10 +5173,6 @@ function validateInspectInvocation(argv) {
 		ok: false,
 		message: "No inspect input provided. Pass text or use --path."
 	};
-	if (isInvalidInspectDetectorViewCombination(detector, view)) return {
-		ok: false,
-		message: "`--view engine` requires `--detector wasm`."
-	};
 	return {
 		ok: true,
 		detector,
@@ -4367,12 +5182,14 @@ function validateInspectInvocation(argv) {
 		pretty,
 		section,
 		pathMode,
+		pathDetectBinary: true,
 		recursive,
 		includeExt,
 		excludeExt,
 		...regex !== void 0 ? { regex } : {},
 		paths,
-		textTokens
+		textTokens,
+		sources
 	};
 }
 //#endregion
@@ -4400,25 +5217,52 @@ async function runSingleInspect(validated, input) {
 function isExplicitInspectInvocation(argv) {
 	return argv[2] === "inspect";
 }
-async function executeInspectCommand({ argv }) {
-	const validated = validateInspectInvocation(argv);
-	if (!validated.ok) {
-		console.error(import_picocolors.default.red(`error: ${validated.message}`));
+function emitConfigNotes$1(notes) {
+	for (const note of notes) {
+		const warningLine = note.startsWith("Warning:") ? note : `Warning: ${note}`;
+		console.error(import_picocolors.default.yellow(warningLine));
+	}
+}
+async function executeInspectCommand({ argv, runtime }) {
+	const parsed = validateInspectInvocation(argv);
+	if (!parsed.ok) {
+		console.error(import_picocolors.default.red(`error: ${parsed.message}`));
 		process.exitCode = 1;
 		return;
 	}
-	if (validated.help) {
+	if (parsed.help) {
 		printInspectHelp();
 		process.exitCode = 0;
 		return;
 	}
+	let validated = parsed;
+	try {
+		const resolvedConfig = await resolveWordCounterConfig({
+			env: runtime?.env,
+			cwd: runtime?.cwd
+		});
+		validated = applyConfigToInspectInvocation(validated, resolvedConfig.config);
+		emitConfigNotes$1(resolvedConfig.notes);
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		console.error(import_picocolors.default.red(`error: ${message}`));
+		process.exitCode = 1;
+		return;
+	}
+	if (validated.view === "engine" && validated.detector === "regex") {
+		console.error(import_picocolors.default.red("error: `--view engine` requires `--detector wasm`."));
+		process.exitCode = 1;
+		return;
+	}
 	try {
 		if (validated.paths.length === 0) {
-			await runSingleInspect(validated, await loadSingleInspectInput(void 0, validated.textTokens, validated.section));
+			const input = await loadSingleInspectInput(void 0, validated.textTokens, validated.section);
+			await runSingleInspect(validated, input);
 			return;
 		}
 		const loaded = await loadInspectBatchInputs(validated.paths, {
 			pathMode: validated.pathMode,
+			pathDetectBinary: validated.pathDetectBinary,
 			recursive: validated.recursive,
 			includeExt: validated.includeExt,
 			excludeExt: validated.excludeExt,
@@ -4484,7 +5328,7 @@ function parseJobsOption(value) {
 	return parsed;
 }
 function configureProgramOptions(program, parseMode) {
-	program.addOption(new Option("-m, --mode <mode>", "breakdown mode").choices(MODE_CHOICES).argParser(parseMode).default("chunk")).addOption(new Option("-f, --format <format>", "output format").choices(FORMAT_CHOICES).default("standard")).addOption(new Option("--section <section>", "document section mode").choices(SECTION_CHOICES).default("all")).addOption(new Option("--detector <mode>", "locale detector mode").choices(DETECTOR_CHOICES).default("regex")).addOption(new Option("--content-gate <mode>", "detector content gate policy mode (default, strict, loose, off)").choices(CONTENT_GATE_CHOICES)).addOption(new Option("--path-mode <mode>", "path resolution mode: auto (default) expands directories; manual treats --path values as literal files").choices(PATH_MODE_CHOICES).default("auto")).option("--latin-language <language>", "hint a language tag for Latin script text").option("--latin-tag <tag>", "hint a BCP 47 tag for Latin script text").option("--latin-locale <locale>", "legacy alias of --latin-language").option("--latin-hint <tag>=<pattern>", "add a custom Latin hint rule (repeatable)", collectLatinHintValue, []).option("--latin-hints-file <path>", "load custom Latin hint rules from a JSON file").option("--no-default-latin-hints", "disable built-in Latin hint rules").option("--han-language <language>", "hint a language tag for Han script text").option("--han-tag <tag>", "hint a BCP 47 tag for Han script text").option("--non-words", "collect emoji, symbols, and punctuation (excludes whitespace)").option("--include-whitespace", "include whitespace counts (implies --non-words; same as --misc)").option("--misc", "collect non-words plus whitespace (alias for --include-whitespace)").option("--total-of <parts>", "override total composition (comma-separated): words,emoji,symbols,punctuation,whitespace", parseTotalOfOption).option("--pretty", "pretty print JSON output", false).option("--debug", "enable debug diagnostics on stderr").option("--verbose", "emit verbose per-file debug diagnostics (requires --debug)").option("--detector-evidence", "emit per-window detector evidence on the debug stream (requires --debug and --detector wasm)").option("--debug-report [path]", "write debug diagnostics to a report file").option("--debug-report-tee", "mirror debug diagnostics to both report file and stderr").option("--debug-tee", "alias of --debug-report-tee").option("--merged", "show merged aggregate output (default)").option("--per-file", "show per-file output plus merged summary").option("--jobs <n>", "batch jobs in --path mode (1=async main-thread, >1=worker load+count)", parseJobsOption, 1).option("--print-jobs-limit", "print host jobs-limit JSON and exit (must be used alone)").option("--no-progress", "disable batch progress indicator").option("--keep-progress", "keep final batch progress line visible in standard mode").option("--no-recursive", "disable recursive directory traversal").option("--quiet-warnings", "suppress non-fatal warning diagnostics").option("--quiet-skips", "suppress debug skip output and per-file json skipped field").option("--include-ext <exts>", "comma-separated extensions to include during directory scanning", collectExtensionOption, []).option("--exclude-ext <exts>", "comma-separated extensions to exclude during directory scanning", collectExtensionOption, []).option("--regex <pattern>", "regex filter for directory-scanned paths (applies to --path directories only)").option("-p, --path <path>", "read input from file or directory (directories expand in auto mode by default)", collectPathValue, []).argument("[text...]", "text to count").showHelpAfterError();
+	program.addOption(new Option("-m, --mode <mode>", "breakdown mode").choices(MODE_CHOICES).argParser(parseMode).default("chunk")).addOption(new Option("-f, --format <format>", "output format").choices(FORMAT_CHOICES).default("standard")).addOption(new Option("--section <section>", "document section mode").choices(SECTION_CHOICES).default("all")).addOption(new Option("-d, --detector <mode>", "locale detector mode").choices(DETECTOR_CHOICES).default("regex")).addOption(new Option("--content-gate <mode>", "detector content gate policy mode (default, strict, loose, off)").choices(CONTENT_GATE_CHOICES)).addOption(new Option("--path-mode <mode>", "path resolution mode: auto (default) expands directories; manual treats --path values as literal files").choices(PATH_MODE_CHOICES).default("auto")).option("--latin-language <language>", "hint a language tag for Latin script text").option("--latin-tag <tag>", "hint a BCP 47 tag for Latin script text").option("--latin-locale <locale>", "legacy alias of --latin-language").option("--latin-hint <tag>=<pattern>", "add a custom Latin hint rule (repeatable)", collectLatinHintValue, []).option("--latin-hints-file <path>", "load custom Latin hint rules from a JSON file").option("--no-default-latin-hints", "disable built-in Latin hint rules").option("--han-language <language>", "hint a language tag for Han script text").option("--han-tag <tag>", "hint a BCP 47 tag for Han script text").option("--non-words", "collect emoji, symbols, and punctuation (excludes whitespace)").option("--include-whitespace", "include whitespace counts (implies --non-words; same as --misc)").option("--misc", "collect non-words plus whitespace (alias for --include-whitespace)").option("--total-of <parts>", "override total composition (comma-separated): words,emoji,symbols,punctuation,whitespace", parseTotalOfOption).option("--pretty", "pretty print JSON output", false).option("--debug", "enable debug diagnostics on stderr").option("--verbose", "emit verbose per-file debug diagnostics (requires --debug)").option("--detector-evidence", "emit per-window detector evidence on the debug stream (requires --debug and --detector wasm)").option("--debug-report [path]", "write debug diagnostics to a report file").option("--debug-report-tee", "mirror debug diagnostics to both report file and stderr").option("--debug-tee", "alias of --debug-report-tee").option("--merged", "show merged aggregate output (default)").option("--per-file", "show per-file output plus merged summary").option("--jobs <n>", "batch jobs in --path mode (1=async main-thread, >1=worker load+count)", parseJobsOption, 1).option("--print-jobs-limit", "print host jobs-limit JSON and exit (must be used alone)").option("--progress", "enable batch progress indicator").option("--no-progress", "disable batch progress indicator").option("--keep-progress", "keep final batch progress line visible in standard mode").option("--recursive", "enable recursive directory traversal").option("--no-recursive", "disable recursive directory traversal").option("--quiet-warnings", "suppress non-fatal warning diagnostics").option("--quiet-skips", "suppress debug skip output and per-file json skipped field").option("--include-ext <exts>", "comma-separated extensions to include during directory scanning", collectExtensionOption, []).option("--exclude-ext <exts>", "comma-separated extensions to exclude during directory scanning", collectExtensionOption, []).option("--regex <pattern>", "regex filter for directory-scanned paths (applies to --path directories only)").option("-p, --path <path>", "read input from file or directory (directories expand in auto mode by default)", collectPathValue, []).argument("[text...]", "text to count").showHelpAfterError();
 }
 //#endregion
 //#region src/cli/program/version.ts
@@ -4518,7 +5362,7 @@ function normalizeVersion(value) {
 	return trimmed;
 }
 function resolvePackageVersion(options = {}) {
-	const embeddedVersion = normalizeVersion(options.embeddedVersion ?? "0.1.5-canary.4");
+	const embeddedVersion = normalizeVersion(options.embeddedVersion ?? "0.1.5");
 	if (embeddedVersion) return embeddedVersion;
 	const maxLevels = options.maxLevels ?? 8;
 	const resolveFromPath = options.resolveFromPath ?? resolveVersionFromPath;
@@ -4759,8 +5603,7 @@ function finalizeBatchSummaryFromFileResults(files, section, wcOptions, options
 //#region src/cli/batch/jobs/queue.ts
 async function runBoundedQueue(total, requestedJobs, worker) {
 	if (total === 0) return [];
-	const safeRequestedJobs = Number.isFinite(requestedJobs) ? Math.floor(requestedJobs) : 1;
-	const concurrency = Math.max(1, Math.min(total, safeRequestedJobs));
+	const concurrency = Math.max(1, Math.min(total, Number.isFinite(requestedJobs) ? Math.floor(requestedJobs) : 1));
 	const results = Array.from({ length: total });
 	let nextIndex = 0;
 	const runWorker = async () => {
@@ -4794,7 +5637,7 @@ async function readBatchInput(path, options) {
 			reason: `not readable: ${error instanceof Error ? error.message : String(error)}`
 		};
 	}
-	if (isProbablyBinary(buffer)) return {
+	if (options.detectBinary && isProbablyBinary(buffer)) return {
 		type: "skip",
 		path,
 		reason: "binary file"
@@ -4815,7 +5658,8 @@ async function countBatchInputsWithJobs(filePaths, options) {
 	const entries = await runBoundedQueue(filePaths.length, options.jobs, async (index) => {
 		const loaded = await readBatchInput(filePaths[index], {
 			requestedJobs: options.jobs,
-			limits
+			limits,
+			detectBinary: options.detectBinary ?? true
 		});
 		if (loaded.type === "skip") {
 			completed += 1;
@@ -5068,6 +5912,7 @@ async function runBatchCount(options) {
 				section: options.section,
 				detectorMode: options.wcOptions.detector ?? "regex",
 				wcOptions: options.wcOptions,
+				detectBinary: options.detectBinary,
 				preserveCollectorSegments: options.preserveCollectorSegments,
 				detectorEvidence: options.detectorEvidence,
 				debugVerbosity: options.debug.verbosity,
@@ -5095,6 +5940,7 @@ async function runBatchCount(options) {
 				section: options.section,
 				detectorMode: options.wcOptions.detector ?? "regex",
 				wcOptions: options.wcOptions,
+				detectBinary: options.detectBinary,
 				preserveCollectorSegments: options.preserveCollectorSegments,
 				detectorEvidence: options.detectorEvidence,
 				debugVerbosity: options.debug.verbosity,
@@ -5110,6 +5956,7 @@ async function runBatchCount(options) {
 				section: options.section,
 				detectorMode: options.wcOptions.detector ?? "regex",
 				wcOptions: options.wcOptions,
+				detectBinary: options.detectBinary,
 				preserveCollectorSegments: options.preserveCollectorSegments,
 				detectorEvidence: options.detectorEvidence,
 				debugVerbosity: options.debug.verbosity,
@@ -5394,13 +6241,14 @@ async function executeBatchCount({ argv, options, runtime, resolved, debug, teeE
 		pathInputs: options.path ?? [],
 		batchOptions,
 		extensionFilter,
+		detectBinary: options.pathDetectBinary,
 		section: options.section,
 		wcOptions: resolved.wcOptions,
 		preserveCollectorSegments: options.format === "json",
 		detectorEvidence: Boolean(options.detectorEvidence),
 		debug,
 		progressReporter: createBatchProgressReporter({
-			enabled: options.format === "standard" && options.progress,
+			enabled: options.format === "standard" && options.progressMode !== "off",
 			stream: runtime.stderr ?? process.stderr,
 			clearOnFinish: !(mirrorDebugToTerminal || options.keepProgress)
 		}),
@@ -5603,6 +6451,12 @@ async function executeSingleCount({ textTokens, options, resolved, debug }) {
 }
 //#endregion
 //#region src/command.ts
+function emitConfigNotes(notes) {
+	for (const note of notes) {
+		const warningLine = note.startsWith("Warning:") ? note : `Warning: ${note}`;
+		console.error(import_picocolors.default.yellow(warningLine));
+	}
+}
 async function runCli(argv = process.argv, runtime = {}) {
 	if (isExplicitDoctorInvocation(argv)) {
 		await executeDoctorCommand({
@@ -5612,7 +6466,10 @@ async function runCli(argv = process.argv, runtime = {}) {
 		return;
 	}
 	if (isExplicitInspectInvocation(argv)) {
-		await executeInspectCommand({ argv });
+		await executeInspectCommand({
+			argv,
+			runtime
+		});
 		return;
 	}
 	const program = new Command();
@@ -5623,8 +6480,8 @@ async function runCli(argv = process.argv, runtime = {}) {
 	};
 	program.name("word-counter").description("Locale-aware word counting powered by Intl.Segmenter.").version(getFormattedVersionLabel(), "-v, --version", "output the version number").addHelpText("after", "\nCommands:\n  inspect [options] [text...]  inspect detector behavior without count output\n  doctor [options]             report runtime diagnostics for this host");
 	configureProgramOptions(program, parseMode);
-	program.action(async (textTokens, options) => {
-		if (options.printJobsLimit) {
+	program.action(async (textTokens, rawOptions) => {
+		if (rawOptions.printJobsLimit) {
 			try {
 				validateStandalonePrintJobsLimitUsage(argv);
 			} catch (error) {
@@ -5635,6 +6492,23 @@ async function runCli(argv = process.argv, runtime = {}) {
 			console.log(JSON.stringify(resolveBatchJobsLimit()));
 			return;
 		}
+		let options = {
+			...rawOptions,
+			pathDetectBinary: rawOptions.pathDetectBinary ?? true,
+			progressMode: deriveInitialCountProgressMode(program, rawOptions.progress)
+		};
+		try {
+			const resolvedConfig = await resolveWordCounterConfig({
+				env: runtime.env,
+				cwd: runtime.cwd
+			});
+			options = applyConfigToCountOptions(options, resolvedConfig.config, deriveCountCliSources(program));
+			if (!options.quietWarnings) emitConfigNotes(resolvedConfig.notes);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			program.error(import_picocolors.default.red(message));
+			return;
+		}
 		const debugEnabled = Boolean(options.debug);
 		const debugReportPath = resolveDebugReportPathOption(options.debugReport);
 		const debugReportEnabled = options.debugReport !== void 0 && options.debugReport !== false;