@dialexjs/cli 0.9.1 → 0.9.2

package/dist/{project-B27699T2.mjs → project-BTpZGNjh.mjs}

@@ -1,8 +1,8 @@
-import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";
-import { pathToFileURL } from "node:url";
+import fs from "node:fs";
 import { generateCode, parseExpression, parseModule, writeFile } from "magicast";
+import { pathToFileURL } from "node:url";
 import fg from "fast-glob";
 import ignore from "ignore";
 import { argumentSignature, findPlurals, getArguments, isIcuStructured, parseMessage } from "dialexjs/icu";
@@ -10,6 +10,9 @@ import { createHash } from "node:crypto";
 import { DEFAULT_CONFIG } from "dialexjs";
 import { loadConfigSync } from "unconfig";
 import chokidar from "chokidar";
+//#region src/utils/dictionary/types.ts
+const TODO_PREFIX = "[TODO] ";
+//#endregion
 //#region src/utils/ast.ts
 /** Strips `as`, `satisfies` and parentheses around an expression. */
 function unwrapNode(node) {
@@ -31,8 +34,7 @@ function findProperty(obj, key) {
 	return obj.properties.find((p) => isPropLike$1(p) && propertyKeyName(p) === key);
 }
 //#endregion
-//#region src/utils/dictionary-edit.ts
-const TODO_PREFIX = "[TODO] ";
+//#region src/utils/dictionary/ast-helpers.ts
 const IDENTIFIER$1 = /^[A-Za-z_$][\w$]*$/;
 const isPropLike = (p) => p?.type === "ObjectProperty" || p?.type === "Property" || p?.type === "ObjectMethod";
 function stringValue(node) {
@@ -99,6 +101,8 @@ function isStaticallyComplete(localesObj) {
 		return isObjectNode(value) && walk(value);
 	});
 }
+//#endregion
+//#region src/utils/dictionary/io.ts
 /**
 * Parses dictionary source text (for example an unsaved editor buffer). Returns `undefined` when
 * the file does not have an editable shape; throws on syntax errors.
@@ -134,6 +138,8 @@ async function saveDictionaryFile(df) {
 		if (!text.endsWith("\n")) fs.writeFileSync(df.file, text + "\n", "utf-8");
 	}
 }
+//#endregion
+//#region src/utils/dictionary/read.ts
 function listLocales(df) {
 	return df.localesObj.properties.filter(isPropLike).map(propertyKeyName).filter((k) => k !== void 0);
 }
@@ -184,6 +190,13 @@ function getString(df, locale, path) {
 	const prop = getProp(df, locale, path);
 	return prop && prop.type !== "ObjectMethod" ? stringValue(prop.value) : void 0;
 }
+/** Leaf paths of a runtime dictionary value (plain objects recurse; everything else is a leaf). */
+function flattenPaths(value, prefix = []) {
+	if (value && typeof value === "object" && !Array.isArray(value)) return Object.entries(value).flatMap(([k, v]) => flattenPaths(v, [...prefix, k]));
+	return prefix.length > 0 ? [prefix] : [];
+}
+//#endregion
+//#region src/utils/dictionary/write.ts
 function ensureLocale(df, locale) {
 	let obj = localeObject(df, locale);
 	if (!obj) {
@@ -245,11 +258,8 @@ function copyLeaf(df, fromLocale, toLocale, path, mapString) {
 	}
 	return true;
 }
-/** Leaf paths of a runtime dictionary value (plain objects recurse; everything else is a leaf). */
-function flattenPaths(value, prefix = []) {
-	if (value && typeof value === "object" && !Array.isArray(value)) return Object.entries(value).flatMap(([k, v]) => flattenPaths(v, [...prefix, k]));
-	return prefix.length > 0 ? [prefix] : [];
-}
+//#endregion
+//#region src/utils/dictionary/locations.ts
 const toRange = (loc) => loc ? {
 	start: {
 		line: loc.start.line - 1,
@@ -279,6 +289,153 @@ function getLeafSource(df, locale, path) {
 	return generateCode(prop.type === "ObjectMethod" ? prop : prop.value).code;
 }
 //#endregion
+//#region src/analysis/cache.ts
+function createAnalysisCache() {
+	return {
+		dictionaries: /* @__PURE__ */ new Map(),
+		sources: /* @__PURE__ */ new Map(),
+		gitignore: /* @__PURE__ */ new Map()
+	};
+}
+/** Forget the cached `.gitignore` rules, for example after a `.gitignore` file changed. */
+function clearGitignore(cache) {
+	cache.gitignore.clear();
+}
+function stampOf(file) {
+	try {
+		const stat = fs.statSync(file);
+		return `${stat.mtimeMs}:${stat.size}`;
+	} catch {
+		return;
+	}
+}
+//#endregion
+//#region src/analysis/load-dictionary.ts
+function fromSyntaxTree(df) {
+	const locales = listLocales(df);
+	const leaves = /* @__PURE__ */ new Map();
+	for (const locale of locales) {
+		const entries = /* @__PURE__ */ new Map();
+		for (const leaf of listLeaves(df, locale)) entries.set(leaf.path.join("."), {
+			kind: leaf.kind,
+			value: leaf.value
+		});
+		leaves.set(locale, entries);
+	}
+	return {
+		name: df.name,
+		locales,
+		leaves,
+		df
+	};
+}
+async function fromRuntime(file) {
+	try {
+		const mod = await import(`${pathToFileURL(file).href}?t=${Date.now()}_${Math.random()}`);
+		const definition = mod.default || mod;
+		if (!definition || typeof definition !== "object" || !definition.dictionary) return {
+			ok: false,
+			level: "error",
+			code: "invalid-dictionary",
+			message: "Default export does not appear to be a valid defineDictionary output."
+		};
+		const dictionary = definition.dictionary;
+		const leaves = /* @__PURE__ */ new Map();
+		const invalid = [];
+		for (const [locale, content] of Object.entries(dictionary)) {
+			if (!content || typeof content !== "object") {
+				invalid.push(locale);
+				continue;
+			}
+			const entries = /* @__PURE__ */ new Map();
+			for (const leafPath of flattenPaths(content)) {
+				let value = content;
+				for (const segment of leafPath) value = value?.[segment];
+				entries.set(leafPath.join("."), typeof value === "string" ? {
+					kind: "string",
+					value
+				} : { kind: typeof value === "function" ? "function" : "other" });
+			}
+			leaves.set(locale, entries);
+		}
+		if (invalid.length > 0) return {
+			ok: false,
+			level: "error",
+			code: "invalid-locale",
+			message: invalid.map((l) => `Locale "${l}" content is empty or invalid.`).join("\n")
+		};
+		return {
+			ok: true,
+			data: {
+				name: String(definition.name ?? ""),
+				locales: [...leaves.keys()],
+				leaves
+			}
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			level: "error",
+			code: "invalid-dictionary",
+			message: `Failed to import dictionary: ${error.message || String(error)}`
+		};
+	}
+}
+function fromParsed(parsed) {
+	try {
+		const df = parsed();
+		if (df?.complete && df.name) return {
+			ok: true,
+			data: fromSyntaxTree(df)
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			level: "error",
+			code: "invalid-dictionary",
+			message: `Failed to parse dictionary: ${error.message}`
+		};
+	}
+}
+const UNANALYZABLE = {
+	ok: false,
+	level: "info",
+	code: "unanalyzable",
+	message: "This dictionary uses spreads, computed keys, imported values, or a computed name, so it cannot be analyzed statically."
+};
+/** Reads a dictionary from its syntax tree. Never runs project code. */
+function loadDictionaryDataStatic(file) {
+	return fromParsed(() => parseDictionaryText(file, fs.readFileSync(file, "utf-8"))) ?? UNANALYZABLE;
+}
+async function loadDictionaryData(file, runtime) {
+	const parsed = fromParsed(() => parseDictionaryText(file, fs.readFileSync(file, "utf-8")));
+	if (parsed?.ok) return parsed;
+	if (runtime) return fromRuntime(file);
+	return parsed ?? UNANALYZABLE;
+}
+async function cachedDictionary(file, runtime, cache) {
+	const stamp = cache ? stampOf(file) : void 0;
+	const hit = stamp ? cache.dictionaries.get(file) : void 0;
+	if (hit && hit.stamp === stamp) return hit.loaded;
+	const loaded = await loadDictionaryData(file, runtime);
+	if (cache && stamp) cache.dictionaries.set(file, {
+		stamp,
+		loaded
+	});
+	return loaded;
+}
+function cachedDictionaryStatic(file, cache) {
+	const stamp = cache ? stampOf(file) : void 0;
+	const hit = stamp ? cache.dictionaries.get(file) : void 0;
+	if (hit && hit.stamp === stamp) return hit.loaded;
+	const loaded = loadDictionaryDataStatic(file);
+	if (cache && stamp) cache.dictionaries.set(file, {
+		stamp,
+		loaded
+	});
+	return loaded;
+}
+//#endregion
 //#region src/utils/files.ts
 /** Folders that never hold project dictionaries or sources, in every scanner. */
 const BUILTIN_IGNORE = [
@@ -523,22 +680,7 @@ function lockFor(root, sourceLocale) {
 	};
 }
 //#endregion
-//#region src/analysis.ts
-function lintLevel(setting) {
-	const level = Array.isArray(setting) ? setting[0] : setting;
-	return level === "off" || level === "warn" || level === "error" ? level : void 0;
-}
-function createAnalysisCache() {
-	return {
-		dictionaries: /* @__PURE__ */ new Map(),
-		sources: /* @__PURE__ */ new Map(),
-		gitignore: /* @__PURE__ */ new Map()
-	};
-}
-/** Forget the cached `.gitignore` rules, for example after a `.gitignore` file changed. */
-function clearGitignore(cache) {
-	cache.gitignore.clear();
-}
+//#region src/analysis/source-scan.ts
 const DEFAULT_SOURCE_GLOB = "**/*.{ts,tsx,js,jsx,mjs,cjs,vue,svelte,astro,mdx}";
 /** `getDictionary("x")`, `useDictionary("x")`, `@DialexDictionary("x")` */
 const DICTIONARY_CALL = /\b(?:getDictionary|useDictionary|DialexDictionary)\(\s*(["'`])([^"'`$\n]+)\1/dg;
@@ -694,138 +836,6 @@ function positionAt(starts, offset) {
 		column: offset - starts[low]
 	};
 }
-function fromSyntaxTree(df) {
-	const locales = listLocales(df);
-	const leaves = /* @__PURE__ */ new Map();
-	for (const locale of locales) {
-		const entries = /* @__PURE__ */ new Map();
-		for (const leaf of listLeaves(df, locale)) entries.set(leaf.path.join("."), {
-			kind: leaf.kind,
-			value: leaf.value
-		});
-		leaves.set(locale, entries);
-	}
-	return {
-		name: df.name,
-		locales,
-		leaves,
-		df
-	};
-}
-async function fromRuntime(file) {
-	try {
-		const mod = await import(`${pathToFileURL(file).href}?t=${Date.now()}_${Math.random()}`);
-		const definition = mod.default || mod;
-		if (!definition || typeof definition !== "object" || !definition.dictionary) return {
-			ok: false,
-			level: "error",
-			code: "invalid-dictionary",
-			message: "Default export does not appear to be a valid defineDictionary output."
-		};
-		const dictionary = definition.dictionary;
-		const leaves = /* @__PURE__ */ new Map();
-		const invalid = [];
-		for (const [locale, content] of Object.entries(dictionary)) {
-			if (!content || typeof content !== "object") {
-				invalid.push(locale);
-				continue;
-			}
-			const entries = /* @__PURE__ */ new Map();
-			for (const leafPath of flattenPaths(content)) {
-				let value = content;
-				for (const segment of leafPath) value = value?.[segment];
-				entries.set(leafPath.join("."), typeof value === "string" ? {
-					kind: "string",
-					value
-				} : { kind: typeof value === "function" ? "function" : "other" });
-			}
-			leaves.set(locale, entries);
-		}
-		if (invalid.length > 0) return {
-			ok: false,
-			level: "error",
-			code: "invalid-locale",
-			message: invalid.map((l) => `Locale "${l}" content is empty or invalid.`).join("\n")
-		};
-		return {
-			ok: true,
-			data: {
-				name: String(definition.name ?? ""),
-				locales: [...leaves.keys()],
-				leaves
-			}
-		};
-	} catch (error) {
-		return {
-			ok: false,
-			level: "error",
-			code: "invalid-dictionary",
-			message: `Failed to import dictionary: ${error.message || String(error)}`
-		};
-	}
-}
-function fromParsed(parsed) {
-	try {
-		const df = parsed();
-		if (df?.complete && df.name) return {
-			ok: true,
-			data: fromSyntaxTree(df)
-		};
-	} catch (error) {
-		return {
-			ok: false,
-			level: "error",
-			code: "invalid-dictionary",
-			message: `Failed to parse dictionary: ${error.message}`
-		};
-	}
-}
-const UNANALYZABLE = {
-	ok: false,
-	level: "info",
-	code: "unanalyzable",
-	message: "This dictionary uses spreads, computed keys, imported values, or a computed name, so it cannot be analyzed statically."
-};
-/** Reads a dictionary from its syntax tree. Never runs project code. */
-function loadDictionaryDataStatic(file) {
-	return fromParsed(() => parseDictionaryText(file, fs.readFileSync(file, "utf-8"))) ?? UNANALYZABLE;
-}
-async function loadDictionaryData(file, runtime) {
-	const parsed = fromParsed(() => parseDictionaryText(file, fs.readFileSync(file, "utf-8")));
-	if (parsed?.ok) return parsed;
-	if (runtime) return fromRuntime(file);
-	return parsed ?? UNANALYZABLE;
-}
-function stampOf(file) {
-	try {
-		const stat = fs.statSync(file);
-		return `${stat.mtimeMs}:${stat.size}`;
-	} catch {
-		return;
-	}
-}
-async function cachedDictionary(file, runtime, cache) {
-	const stamp = cache ? stampOf(file) : void 0;
-	const hit = stamp ? cache.dictionaries.get(file) : void 0;
-	if (hit && hit.stamp === stamp) return hit.loaded;
-	const loaded = await loadDictionaryData(file, runtime);
-	if (cache && stamp) cache.dictionaries.set(file, {
-		stamp,
-		loaded
-	});
-	return loaded;
-}
-function cachedDictionaryStatic(file, cache) {
-	const stamp = cache ? stampOf(file) : void 0;
-	const hit = stamp ? cache.dictionaries.get(file) : void 0;
-	if (hit && hit.stamp === stamp) return hit.loaded;
-	const loaded = loadDictionaryDataStatic(file);
-	if (cache && stamp) cache.dictionaries.set(file, {
-		stamp,
-		loaded
-	});
-	return loaded;
-}
 function scanSource(text) {
 	const starts = lineStarts(text);
 	const rangeOf = (start, end) => ({
@@ -842,6 +852,12 @@ function scanSource(text) {
 		inline
 	};
 }
+//#endregion
+//#region src/analysis/steps.ts
+function lintLevel(setting) {
+	const level = Array.isArray(setting) ? setting[0] : setting;
+	return level === "off" || level === "warn" || level === "error" ? level : void 0;
+}
 /**
 * The analysis itself, written once. It yields a `LoadRequest` for every dictionary so that a
 * synchronous driver (`analyzeProjectSync`) and an asynchronous one (`analyzeProject`, which may
@@ -1086,6 +1102,8 @@ function* analysisSteps(options) {
 		inlineDictionaries: [...inline]
 	};
 }
+//#endregion
+//#region src/analysis/index.ts
 /** Analyzes a project. With `runtime: true`, dictionaries the syntax tree cannot describe are imported. */
 async function analyzeProject(options) {
 	const steps = analysisSteps(options);
@@ -1721,7 +1739,7 @@ function relativeImportExtension(root) {
 	return resolution === "node16" || resolution === "nodenext" ? ".js" : "";
 }
 //#endregion
-//#region src/commands/generate.ts
+//#region src/commands/generate/render.ts
 /** The folder, next to `dialex.generated.ts`, that holds the per-locale modules. */
 const LOCALES_DIR = "dialex.locales";
 const safeName = (text) => text.replace(/[^A-Za-z0-9._-]/g, "_");
@@ -1841,6 +1859,58 @@ export default dictionaries;
 		notes
 	};
 }
+//#endregion
+//#region src/commands/generate/watch.ts
+const WATCH_IGNORED = /(^|[\\/])(node_modules|dist|\.next|\.nuxt|\.output|\.turbo|\.git|dialex\.locales)([\\/]|$)/;
+const CONFIG_FILE = /(^|[\\/])(dialex|i18n)\.config\.[cm]?[jt]s(on)?$/;
+/**
+* Regenerates when a dictionary or config file is added, edited or removed. chokidar 4+ no longer
+* understands globs, so this watches the project directory and decides for itself which events
+* matter, using the same `include` glob as `generate`.
+*/
+function startGenerateWatcher(root, options, regenerate, delay = 100, log = (message) => logger.info(message)) {
+	const dictionaryFiles = () => new Set(renderGenerated(root, options).files);
+	let known = dictionaryFiles();
+	let outputs = /* @__PURE__ */ new Set();
+	let timer;
+	const trigger = () => {
+		if (timer) clearTimeout(timer);
+		timer = setTimeout(() => {
+			regenerate();
+			try {
+				known = dictionaryFiles();
+				const rendered = renderGenerated(root, options);
+				outputs = /* @__PURE__ */ new Set([rendered.outputPath, rendered.dtsPath]);
+			} catch {}
+		}, delay);
+	};
+	const gitIgnored = createGitignoreFilter(root);
+	const watcher = chokidar.watch(root, {
+		ignoreInitial: true,
+		ignored: (file) => WATCH_IGNORED.test(file) || gitIgnored(path.resolve(root, file))
+	});
+	watcher.on("all", (event, filePath) => {
+		const file = path.resolve(root, filePath);
+		if (outputs.has(file)) return;
+		const isConfig = CONFIG_FILE.test(file);
+		if (event === "change") {
+			if (!known.has(file) && !isConfig) return;
+		} else if (event === "add" || event === "unlink") {
+			let now;
+			try {
+				now = dictionaryFiles();
+			} catch {
+				return;
+			}
+			if (!(now.size !== known.size || [...now].some((f) => !known.has(f))) && !isConfig) return;
+		} else return;
+		log(`[${event}] ${path.relative(root, file)} changed, regenerating...`);
+		trigger();
+	});
+	return watcher;
+}
+//#endregion
+//#region src/commands/generate/write.ts
 function writeIfChanged(file, content) {
 	if ((fs.existsSync(file) ? fs.readFileSync(file, "utf-8") : "") === content) return;
 	fs.mkdirSync(path.dirname(file), { recursive: true });
@@ -1868,6 +1938,8 @@ function generateDictionaries(root, options = {}) {
 		notes: rendered.notes
 	};
 }
+//#endregion
+//#region src/commands/generate/index.ts
 async function runGenerate(options = {}) {
 	const root = options.cwd || process.cwd();
 	const quiet = options.json === true;
@@ -1904,54 +1976,6 @@ async function runGenerate(options = {}) {
 		startGenerateWatcher(root, options, doGenerate);
 	}
 }
-const WATCH_IGNORED = /(^|[\\/])(node_modules|dist|\.next|\.nuxt|\.output|\.turbo|\.git|dialex\.locales)([\\/]|$)/;
-const CONFIG_FILE = /(^|[\\/])(dialex|i18n)\.config\.[cm]?[jt]s(on)?$/;
-/**
-* Regenerates when a dictionary or config file is added, edited or removed. chokidar 4+ no longer
-* understands globs, so this watches the project directory and decides for itself which events
-* matter, using the same `include` glob as `generate`.
-*/
-function startGenerateWatcher(root, options, regenerate, delay = 100, log = (message) => logger.info(message)) {
-	const dictionaryFiles = () => new Set(renderGenerated(root, options).files);
-	let known = dictionaryFiles();
-	let outputs = /* @__PURE__ */ new Set();
-	let timer;
-	const trigger = () => {
-		if (timer) clearTimeout(timer);
-		timer = setTimeout(() => {
-			regenerate();
-			try {
-				known = dictionaryFiles();
-				const rendered = renderGenerated(root, options);
-				outputs = /* @__PURE__ */ new Set([rendered.outputPath, rendered.dtsPath]);
-			} catch {}
-		}, delay);
-	};
-	const gitIgnored = createGitignoreFilter(root);
-	const watcher = chokidar.watch(root, {
-		ignoreInitial: true,
-		ignored: (file) => WATCH_IGNORED.test(file) || gitIgnored(path.resolve(root, file))
-	});
-	watcher.on("all", (event, filePath) => {
-		const file = path.resolve(root, filePath);
-		if (outputs.has(file)) return;
-		const isConfig = CONFIG_FILE.test(file);
-		if (event === "change") {
-			if (!known.has(file) && !isConfig) return;
-		} else if (event === "add" || event === "unlink") {
-			let now;
-			try {
-				now = dictionaryFiles();
-			} catch {
-				return;
-			}
-			if (!(now.size !== known.size || [...now].some((f) => !known.has(f))) && !isConfig) return;
-		} else return;
-		log(`[${event}] ${path.relative(root, file)} changed, regenerating...`);
-		trigger();
-	});
-	return watcher;
-}
 //#endregion
 //#region src/utils/project.ts
 async function loadDictionaries(root, config) {
@@ -2006,6 +2030,6 @@ async function loadStaticProject(root, configFile) {
 /** `home` + `["nav", "about"]` -> `home.nav.about` */
 const toKey = (dictionary, keyPath) => [dictionary, ...keyPath].join(".");
 //#endregion
-export { SOURCE_BUILTIN_IGNORE as A, listLocales as B, isStale as C, record as D, readLock as E, dictionaryLocation as F, saveDictionaryFile as G, locationOf as H, getLeafSource as I, setString as K, getString as L, scanFiles as M, TODO_PREFIX as N, writeLock as O, copyLeaf as P, hasPath as R, hashSource as S, lockPath as T, parseDictionaryText as U, loadDictionaryFile as V, renderDictionaryFile as W, createAnalysisCache as _, renderGenerated as a, scanText as b, DEFAULT_STATIC_CONFIG as c, resolveDialexConfig as d, logger as f, clearGitignore as g, analyzeProjectSync as h, generateDictionaries as i, createGitignoreFilter as j, BUILTIN_IGNORE as k, parseStaticConfig as l, analyzeProject as m, loadStaticProject as n, runGenerate as o, DEFAULT_SOURCE_GLOB as p, toKey as r, startGenerateWatcher as s, loadProject as t, readStaticConfig as u, relativeFile as v, lockFor as w, LOCK_FILE as x, scanReferences as y, listLeaves as z };
+export { scanFiles as A, listLeaves as B, lockPath as C, BUILTIN_IGNORE as D, writeLock as E, locationOf as F, saveDictionaryFile as G, loadDictionaryFile as H, copyLeaf as I, TODO_PREFIX as K, setString as L, createAnalysisCache as M, dictionaryLocation as N, SOURCE_BUILTIN_IGNORE as O, getLeafSource as P, getString as R, lockFor as S, record as T, parseDictionaryText as U, listLocales as V, renderDictionaryFile as W, scanReferences as _, generateDictionaries as a, hashSource as b, DEFAULT_STATIC_CONFIG as c, resolveDialexConfig as d, logger as f, DEFAULT_SOURCE_GLOB as g, relativeFile as h, runGenerate as i, clearGitignore as j, createGitignoreFilter as k, parseStaticConfig as l, analyzeProjectSync as m, loadStaticProject as n, startGenerateWatcher as o, analyzeProject as p, toKey as r, renderGenerated as s, loadProject as t, readStaticConfig as u, scanText as v, readLock as w, isStale as x, LOCK_FILE as y, hasPath as z };
 
-//# sourceMappingURL=project-B27699T2.mjs.map
+//# sourceMappingURL=project-BTpZGNjh.mjs.map