@x18n/core 0.0.13 → 0.0.15

package/dist/index.mjs

@@ -138,7 +138,9 @@ function defineConfig(config) {
 }
 //#endregion
 //#region src/errors.ts
-const at = (p) => p.line === void 0 ? p.path : `${p.path}:${p.line}`;
+function at(p) {
+	return p.line === void 0 ? p.path : `${p.path}:${p.line}`;
+}
 /**
 * Every coded error. Groups: 0xxx config, 1xxx plugin, 2xxx discovery and parse,
 * 3xxx scanning, 4xxx edits, 5xxx reviews. `fix` stays static so the docs can show it.
@@ -223,6 +225,22 @@ const errorDefinitions = {
 	X18N4008: {
 		why: (p) => `Invalid edit input: ${p.reason}`,
 		fix: "Check the input shape against the docs."
+	},
+	X18N5001: {
+		why: (p) => `Review file ${p.path} could not be read: ${p.reason}`,
+		fix: "Fix the file against `schema/reviews.json`, or restore it from git."
+	},
+	X18N5003: {
+		why: (p) => `Reviews are not available: ${p.reason}`,
+		fix: "Set `review.enabled` to true, and fix the review file if x18n reports it."
+	},
+	X18N5004: {
+		why: (p) => `Review not found: ${p.id}`,
+		fix: "List review ids with `x18n review list` (agents: the `x18n_reviews` tool)."
+	},
+	X18N5005: {
+		why: (p) => `Review ${p.id} is not an open suggestion`,
+		fix: "Apply only open reviews of type `suggestion`."
 	}
 };
 /** Raise with `throw errors.X18N2002({ path, reason })`. Core has no reporters: surfaces print what they catch. */
@@ -249,6 +267,24 @@ function toErrorInfo(error) {
 	};
 }
 //#endregion
+//#region src/fuzzy.ts
+/** Subsequence match score of `query` in `text`, case-insensitive; higher is better, -1 when it does not match. Substring hits rank above every subsequence. */
+function fuzzyScore(query, text) {
+	const q = query.toLowerCase();
+	const s = text.toLowerCase();
+	const exact = s.indexOf(q);
+	if (exact !== -1) return 2e3 - Math.min(exact, 1e3);
+	let score = 0;
+	let at = -1;
+	for (const char of q) {
+		const next = s.indexOf(char, at + 1);
+		if (next === -1) return -1;
+		score += next === at + 1 ? 2 : 1;
+		at = next;
+	}
+	return score;
+}
+//#endregion
 //#region src/keys.ts
 /** Canonical string form of a key: `ns:a.b.c`, or `a.b.c` without namespace. */
 function joinKey(namespace, path) {
@@ -331,6 +367,40 @@ function pathMatcher(globs) {
 	return (path) => regexes.some((re) => re.test(path));
 }
 //#endregion
+//#region src/library.ts
+/** One plugin holding a library's call specs, regexes, namespace rules, defaults and extraction templates. */
+function createLibraryPlugin(options) {
+	return {
+		name: options.name,
+		async config(draft, ctx) {
+			if (options.namespace) draft.namespace = {
+				...draft.namespace,
+				separator: options.namespace.separator ?? draft.namespace.separator,
+				default: draft.namespace.default ?? options.namespace.default,
+				fromPath: options.namespace.fromPath ?? draft.namespace.fromPath
+			};
+			if (options.resources) draft.resources = [...draft.resources, ...options.resources.filter((spec) => !draft.resources.some((r) => r.pattern === spec.pattern))];
+			if (options.keyStyle && draft.keyStyle === "auto" && !ctx.user.keyStyle) draft.keyStyle = options.keyStyle;
+			draft.usage = {
+				...draft.usage,
+				calls: [...draft.usage.calls, ...options.calls ?? []],
+				regex: [...draft.usage.regex, ...options.regex ?? []],
+				derivedKeys: [...draft.usage.derivedKeys, ...options.derivedKeys ?? []]
+			};
+			await options.extra?.(draft, ctx);
+		},
+		placeholders: options.placeholders,
+		localeFinders: options.finders,
+		normalizeKey: options.normalizeKey,
+		transformResource: options.transformResource,
+		translatePrompt: options.translatePrompt,
+		extractors: options.templates ? [{
+			id: options.name,
+			templates: options.templates
+		}] : void 0
+	};
+}
+//#endregion
 //#region src/locale.ts
 const defaultRegions = {
 	ar: "SA",
@@ -585,8 +655,8 @@ function uniqueById(items, kind) {
 }
 function createRegistry(input, config) {
 	const plugins = sortByEnforce(input);
-	const formats = plugins.flatMap((plugin) => plugin.formats ?? []);
-	const scanners = plugins.flatMap((plugin) => plugin.scanners ?? []);
+	const formats = plugins.flatMap((plugin) => [...plugin.formats ?? [], ...plugin.lazyFormats ?? []]);
+	const scanners = plugins.flatMap((plugin) => [...plugin.scanners ?? [], ...plugin.lazyScanners ?? []]);
 	const finders = [...uniqueById(plugins.flatMap((plugin) => plugin.localeFinders ?? []), "Locale finder").values()];
 	const checks = uniqueById(plugins.flatMap((plugin) => plugin.checks ?? []), "Check");
 	const reporters = uniqueById(plugins.flatMap((plugin) => plugin.reporters ?? []), "Reporter");
@@ -602,8 +672,58 @@ function createRegistry(input, config) {
 		});
 		else byExtension.set(extension, format);
 	}
-	const formatById = (id) => formats.find((format) => format.id === id);
+	const isLazy = (format) => "load" in format;
+	const loaded = new Map(formats.filter((format) => !isLazy(format)).map((format) => [format.id, format]));
+	const loading = /* @__PURE__ */ new Map();
+	const formatById = (id) => loaded.get(id);
+	const formatIdFor = (path, hint) => {
+		if (hint) return hint;
+		const extension = extensionOf(path);
+		return config.formats[extension] ?? byExtension.get(extension)?.id;
+	};
+	const loadFormat = (id) => {
+		const ready = loaded.get(id);
+		if (ready) return Promise.resolve(ready);
+		const lazy = formats.find((format) => format.id === id);
+		if (!lazy || !isLazy(lazy)) return Promise.resolve(void 0);
+		let pending = loading.get(id);
+		if (!pending) {
+			pending = lazy.load().then((mod) => {
+				const format = mod.default().formats?.find((item) => item.id === id && !isLazy(item));
+				if (format) loaded.set(id, format);
+				return format;
+			});
+			loading.set(id, pending);
+		}
+		return pending;
+	};
 	const scannerCache = /* @__PURE__ */ new Map();
+	const loadedScanners = new Map(scanners.filter((scanner) => !("load" in scanner)).map((scanner) => [scanner.id, scanner]));
+	const loadingScanners = /* @__PURE__ */ new Map();
+	const loadScanner = (entry) => {
+		if (!("load" in entry)) return Promise.resolve(entry);
+		const ready = loadedScanners.get(entry.id);
+		if (ready) return Promise.resolve(ready);
+		let pending = loadingScanners.get(entry.id);
+		if (!pending) {
+			pending = entry.load().then((mod) => {
+				const scanner = mod.default().scanners?.find((item) => item.id === entry.id);
+				if (scanner) loadedScanners.set(entry.id, scanner);
+				return scanner;
+			});
+			loadingScanners.set(entry.id, pending);
+		}
+		return pending;
+	};
+	const scannersFor = (path) => {
+		const extension = extensionOf(path);
+		let list = scannerCache.get(extension);
+		if (!list) {
+			list = extension ? scanners.filter((scanner) => scanner.extensions.includes(extension) || scanner.extensions.includes("*")) : [];
+			scannerCache.set(extension, list);
+		}
+		return list;
+	};
 	return {
 		plugins,
 		formats,
@@ -615,22 +735,21 @@ function createRegistry(input, config) {
 		manifests: plugins.flatMap((plugin) => plugin.manifests ?? []),
 		extractors: plugins.flatMap((plugin) => plugin.extractors ?? []),
 		histories: plugins.flatMap((plugin) => plugin.histories ?? []),
+		reviewStores: plugins.flatMap((plugin) => plugin.reviewStores ?? []),
 		conflicts,
 		formatById,
+		formatIdFor,
 		formatFor(path, hint) {
-			if (hint) return formatById(hint);
-			const extension = extensionOf(path);
-			const mapped = config.formats[extension];
-			return mapped ? formatById(mapped) : byExtension.get(extension);
+			const id = formatIdFor(path, hint);
+			return id === void 0 ? void 0 : formatById(id);
 		},
-		scannersFor(path) {
-			const extension = extensionOf(path);
-			let list = scannerCache.get(extension);
-			if (!list) {
-				list = extension ? scanners.filter((scanner) => scanner.extensions.includes(extension) || scanner.extensions.includes("*")) : [];
-				scannerCache.set(extension, list);
-			}
-			return list;
+		async loadFormatFor(path, hint) {
+			const id = formatIdFor(path, hint);
+			return id === void 0 ? void 0 : loadFormat(id);
+		},
+		scannersFor,
+		async loadScannersFor(path) {
+			return (await Promise.all(scannersFor(path).map(loadScanner))).filter((scanner) => scanner !== void 0);
 		}
 	};
 }
@@ -665,7 +784,7 @@ const callSpec = v.strictObject({
 		"accessor"
 	])),
 	key: v.optional(v.union([v.number(), argSource])),
-	namespace: v.optional(argSource),
+	namespace: v.optional(v.union([argSource, v.string()])),
 	keyPrefix: v.optional(argSource),
 	factory: v.optional(v.boolean()),
 	returns: v.optional(strings),
@@ -724,12 +843,18 @@ const checkSetting = v.union([level, v.tuple([level, jsonObject])]);
 const namespaceOptions = v.strictObject({
 	separator: v.optional(v.string()),
 	default: v.optional(v.string()),
+	fallback: v.optional(strings),
+	byFile: v.optional(v.record(v.string(), v.string())),
 	fromPath: v.optional(v.picklist([
 		"dot",
 		"slash",
 		"camel"
 	]))
 });
+const reviewAuthor = v.strictObject({
+	name: v.optional(v.string()),
+	email: v.optional(v.string())
+});
 /** Validates YAML and JSON configs, and the serializable part of TS configs. */
 const ConfigSchema = v.strictObject({
 	$schema: v.optional(v.string()),
@@ -769,6 +894,11 @@ const ConfigSchema = v.strictObject({
 	ignoreKeys: v.optional(strings),
 	glossary: v.optional(v.array(glossaryEntry)),
 	history: v.optional(v.union([v.boolean(), v.record(v.string(), v.union([v.literal(false), v.looseObject({})]))])),
+	review: v.optional(v.strictObject({
+		enabled: v.optional(v.boolean()),
+		file: v.optional(v.string()),
+		author: v.optional(reviewAuthor)
+	})),
 	projects: v.optional(strings)
 });
 const PluginFileSchema = v.strictObject({
@@ -810,6 +940,27 @@ const PluginFileSchema = v.strictObject({
 	}))),
 	extract: v.optional(v.strictObject({ templates: v.optional(extractTemplates) }))
 });
+const reviewComment = v.strictObject({
+	id: v.string(),
+	type: v.picklist([
+		"comment",
+		"approve",
+		"request-change",
+		"suggestion"
+	]),
+	author: v.optional(reviewAuthor),
+	time: v.string(),
+	text: v.optional(v.string()),
+	suggestion: v.optional(v.string()),
+	value: v.optional(v.string()),
+	resolved: v.optional(v.boolean())
+});
+const ReviewFileSchema = v.strictObject({
+	$schema: v.optional(v.string()),
+	x18n: v.literal(1),
+	threads: v.optional(v.record(v.string(), v.record(v.string(), v.array(reviewComment)))),
+	sources: v.optional(v.record(v.string(), v.record(v.string(), v.string())))
+});
 /** Validates data against a schema and returns readable issues instead of throwing. */
 function validate(schema, data) {
 	const result = v.safeParse(schema, data);
@@ -889,6 +1040,28 @@ function placeholderProblems(project, ops) {
 	});
 }
 //#endregion
+//#region src/project/explain.ts
+/** `project.explain()` as the text `x18n doctor` prints. `root` and `configFile` are shown as given. */
+function renderExplanation(e, configFile) {
+	const lines = [
+		`# ${e.name} (${e.root})`,
+		`config: ${configFile ?? "none (detection only)"}`,
+		"presets:"
+	];
+	const applied = e.presets.filter((p) => p.reason === "detected" || p.reason === "listed");
+	lines.push(...applied.map((p) => `  ✓ ${p.name} (${p.reason})`));
+	if (applied.length === 0) lines.push("  none");
+	if (e.presets.length > applied.length) lines.push(`  ${e.presets.length - applied.length} others not applied`);
+	lines.push("finders:");
+	for (const f of e.finders) lines.push(`  ${f.id}: ${f.resources.length} resources`, ...f.resources.slice(0, 20).map((path) => `    ${path}`));
+	lines.push("formats:", ...e.formats.filter((f) => f.resources > 0).map((f) => `  ${f.id} (${f.extensions.join(", ")}): ${f.resources} resources`));
+	lines.push("scanners:", ...e.scanners.map((s) => `  ${s.id} (${s.extensions.join(", ") || "none"}): ${s.files} files`));
+	if (e.conflicts.length) lines.push("conflicts:", ...e.conflicts.map((c) => `  .${c.extension}: ${c.winner} wins over ${c.loser}`));
+	if (e.errors.length) lines.push("errors:", ...e.errors.map((err) => `  ${err.name} ${err.why}`));
+	lines.push("config origins:", ...Object.entries(e.config.origins).map(([key, origin]) => `  ${key}: ${origin}`));
+	return lines.join("\n");
+}
+//#endregion
 //#region src/project/history.ts
 const localChange = { updatedAt: Number.POSITIVE_INFINITY };
 /** A target message is stale when it last changed before its source message. */
@@ -949,8 +1122,12 @@ function innermost(scopes, range) {
 	return best;
 }
 function createUsageResolver(config, namespaced, normalizers) {
-	const separator = config.namespace.separator;
-	return { resolve(candidate, scopes, path, scanner) {
+	const { separator, fallback } = config.namespace;
+	const byFile = Object.entries(config.namespace.byFile).map(([glob, namespace]) => ({
+		matches: pathMatcher([glob]),
+		namespace
+	}));
+	return { resolve(candidate, scopes, path, scanner, has) {
 		const scope = innermost(scopes, candidate.range);
 		const ctx = { path };
 		let text = candidate.raw;
@@ -961,8 +1138,8 @@ function createUsageResolver(config, namespaced, normalizers) {
 				break;
 			}
 		}
-		const scopeNamespace = candidate.namespace ?? scope?.namespace;
-		const scopePrefix = candidate.keyPrefix ?? scope?.keyPrefix;
+		const scopeNamespace = candidate.namespace ?? scope?.namespace ?? byFile.find((rule) => rule.matches(path))?.namespace;
+		let scopePrefix = candidate.keyPrefix ?? scope?.keyPrefix;
 		let namespace;
 		let explicit = false;
 		if (namespaced) {
@@ -973,10 +1150,17 @@ function createUsageResolver(config, namespaced, normalizers) {
 				text = text.slice(index + separator.length);
 			} else namespace = scopeNamespace ?? config.namespace.default;
 		}
-		if (scopePrefix && !explicit) text = text ? `${scopePrefix}.${text}` : scopePrefix;
+		if (scopePrefix && !explicit) {
+			const prefixed = text ? `${scopePrefix}.${text}` : scopePrefix;
+			const lookup = candidate.dynamic === "prefix" ? prefixed.replace(/\.$/, "") : prefixed;
+			if (candidate.keyPrefix || !scope?.optionalPrefix || has(joinKey(namespace, lookup.split(".")))) text = prefixed;
+			else scopePrefix = void 0;
+		}
+		const keyPath = text === "" ? [] : text.split(".");
 		let key;
 		if (candidate.dynamic === "unknown") key = void 0;
-		else key = joinKey(namespace, text === "" ? [] : text.split("."));
+		else key = joinKey(namespace, keyPath);
+		if (key !== void 0 && namespaced && !explicit && candidate.dynamic === false && !has(key)) key = fallback.map((ns) => joinKey(ns, keyPath)).find(has) ?? key;
 		return {
 			key,
 			raw: candidate.raw,
@@ -1127,7 +1311,7 @@ function computeCoverage(state, options, sourceKeys) {
 			if (value === void 0 || value === "") {
 				if (inherited(key)) continue;
 				(value === void 0 ? missing : empty).push(key);
-			} else if (locale !== sourceLocale && isOutdated(state.history(key, sourceLocale), state.history(key, locale))) outdated.push(key);
+			} else if (locale !== sourceLocale && isOutdated(state.history(key, sourceLocale), state.history(key, locale)) && !state.fresh(key, locale)) outdated.push(key);
 		}
 		return {
 			locale,
@@ -1278,6 +1462,7 @@ function createAnalyzer(options) {
 			localeInfo: options.localeInfo,
 			text: options.text,
 			history: state.history,
+			reviews: state.reviews,
 			*hardStrings() {
 				for (const [path, file] of state.files) for (const hard of file.result.hardStrings ?? []) yield {
 					...hard,
@@ -1305,6 +1490,161 @@ function createAnalyzer(options) {
 	return { analyze };
 }
 //#endregion
+//#region src/project/reviews.ts
+const noReviews = {
+	threads: {},
+	sources: {}
+};
+/** What a review compares: message values as text. */
+function valueText(value) {
+	return value === null ? "" : String(value);
+}
+/** The hash recorded for a source value in `sources`. */
+function sourceHash(value) {
+	return hashText(JSON.stringify(value));
+}
+function reviewState(comments) {
+	const open = comments.filter((comment) => !comment.resolved);
+	const decisive = open.findLast((comment) => comment.type === "approve" || comment.type === "request-change");
+	if (decisive) return decisive.type === "request-change" ? "changes-requested" : decisive.stale ? "stale-approval" : "approved";
+	if (open.some((comment) => comment.type === "suggestion")) return "suggested";
+	return open.length > 0 ? "commented" : void 0;
+}
+/** A short random id that `taken` does not know. */
+function reviewId(taken) {
+	let id;
+	do
+		id = Math.random().toString(36).slice(2, 8);
+	while (id.length < 6 || taken(id));
+	return id;
+}
+function byCode(a, b) {
+	return a < b ? -1 : a > b ? 1 : 0;
+}
+/** Threads in key order, then in the order of `locales`, then any other locale. */
+function listThreads(data, filter, locales, current) {
+	const rank = (locale) => {
+		const i = locales.indexOf(locale);
+		return i < 0 ? locales.length : i;
+	};
+	const out = [];
+	const keys = filter.key === void 0 ? Object.keys(data.threads).sort(byCode) : [filter.key];
+	for (const key of keys) {
+		const byLocale = data.threads[key] ?? {};
+		const codes = Object.keys(byLocale).filter((locale) => filter.locale === void 0 || locale === filter.locale).sort((a, b) => rank(a) - rank(b) || byCode(a, b));
+		for (const locale of codes) {
+			const value = current(key, locale);
+			const comments = byLocale[locale].filter((comment) => !filter.open || !comment.resolved).map((comment) => ({
+				...comment,
+				stale: comment.type === "approve" && comment.value !== void 0 && value !== void 0 && valueText(value) !== comment.value
+			}));
+			if (comments.length > 0) out.push({
+				key,
+				locale,
+				comments,
+				state: reviewState(comments)
+			});
+		}
+	}
+	return out;
+}
+function findReview(data, id) {
+	for (const [key, byLocale] of Object.entries(data.threads)) for (const [locale, comments] of Object.entries(byLocale)) {
+		const comment = comments.find((c) => c.id === id);
+		if (comment) return {
+			key,
+			locale,
+			comment
+		};
+	}
+}
+function sortSection(section) {
+	return Object.fromEntries(Object.entries(section).filter(([, byLocale]) => Object.keys(byLocale).length > 0).sort(([a], [b]) => byCode(a, b)).map(([key, byLocale]) => [key, Object.fromEntries(Object.entries(byLocale).sort(([a], [b]) => byCode(a, b)))]));
+}
+/** Sorted keys and locales, so edits from two branches merge well. */
+function sortReviews(data) {
+	return {
+		threads: sortSection(data.threads),
+		sources: sortSection(data.sources)
+	};
+}
+function rekey(section, from, to) {
+	const { [from]: entry, ...rest } = section;
+	return entry ? {
+		...rest,
+		[to]: entry
+	} : section;
+}
+function without(section, key, locales) {
+	const { [key]: byLocale, ...rest } = section;
+	if (!byLocale || locales === "all") return rest;
+	return {
+		...rest,
+		[key]: Object.fromEntries(Object.entries(byLocale).filter(([locale]) => !locales.includes(locale)))
+	};
+}
+/** Review data being changed by an edit plan. */
+var ReviewDraft = class {
+	data;
+	changed = false;
+	constructor(data) {
+		this.data = data;
+	}
+	update(next) {
+		this.changed = true;
+		this.data = next;
+	}
+	thread(key, locale, comments) {
+		const { threads } = this.data;
+		this.update({
+			...this.data,
+			threads: {
+				...threads,
+				[key]: {
+					...threads[key],
+					[locale]: comments
+				}
+			}
+		});
+	}
+	add(key, locale, comment) {
+		this.thread(key, locale, [...this.data.threads[key]?.[locale] ?? [], comment]);
+	}
+	resolve(id) {
+		const found = findReview(this.data, id);
+		if (found) this.thread(found.key, found.locale, this.data.threads[found.key][found.locale].map((c) => c.id === id ? {
+			...c,
+			resolved: true
+		} : c));
+	}
+	record(key, locale, hash) {
+		const { sources } = this.data;
+		if (sources[key]?.[locale] !== hash) this.update({
+			...this.data,
+			sources: {
+				...sources,
+				[key]: {
+					...sources[key],
+					[locale]: hash
+				}
+			}
+		});
+	}
+	/** Threads and records follow a renamed key. */
+	move(from, to) {
+		if (this.data.threads[from] || this.data.sources[from]) this.update({
+			threads: rekey(this.data.threads, from, to),
+			sources: rekey(this.data.sources, from, to)
+		});
+	}
+	remove(key, locales) {
+		if (this.data.threads[key] || this.data.sources[key]) this.update({
+			threads: without(this.data.threads, key, locales),
+			sources: without(this.data.sources, key, locales)
+		});
+	}
+};
+//#endregion
 //#region src/project/planner.ts
 const safeSegment = /^[\w-]+$/;
 const safeFlat = /^[\w.-]+$/;
@@ -1345,7 +1685,8 @@ function mirrorPath(path, from, to) {
 function importEdit(text, lines) {
 	const missing = lines.filter((line) => !text.includes(line.trim()));
 	if (missing.length === 0) return void 0;
-	const script = /<script\b[^>]*>\r?\n?/.exec(text);
+	const open = /^\s*---\r?\n/.exec(text);
+	const script = (open && /^---\s*$/m.test(text.slice(open[0].length)) ? open : void 0) ?? /<script\b[^>]*>\r?\n?/.exec(text);
 	let at = 0;
 	if (script) at = script.index + script[0].length;
 	else {
@@ -1373,6 +1714,9 @@ var PlanBuilder = class {
 	touched = /* @__PURE__ */ new Set();
 	stateById;
 	config;
+	/** Source values set by this plan, for the source records of targets set after them. */
+	plannedSource = /* @__PURE__ */ new Map();
+	draft;
 	constructor(options, state, answers) {
 		this.options = options;
 		this.state = state;
@@ -1439,7 +1783,9 @@ var PlanBuilder = class {
 		const sourceState = source && this.stateById.get(source.resource);
 		const namespace = namespaced ? this.keyId(key).namespace ?? this.config.namespace.default : sourceState?.resource.namespace;
 		const exists = (path) => resources.some((r) => r.resource.path === path);
-		const resolved = this.options.resolveNew(locale, namespace);
+		const sibling = (r) => r.resource.locale === locale && r.resource.namespace !== void 0 && namespace !== void 0;
+		const model = (sourceState && fits(sourceState) ? sourceState : void 0) ?? resources.find((s) => s.resource.locale === sourceLocale && fits(s)) ?? resources.find(fits) ?? resources.find(sibling);
+		const resolved = this.options.resolveNew(locale, namespace, model?.resource);
 		if (resolved && !exists(resolved)) {
 			const format = this.options.registry.formatFor(resolved);
 			if (format?.serialize) {
@@ -1455,8 +1801,6 @@ var PlanBuilder = class {
 				return target;
 			}
 		}
-		const sibling = (r) => r.resource.locale === locale && r.resource.namespace !== void 0 && namespace !== void 0;
-		const model = (sourceState && fits(sourceState) ? sourceState : void 0) ?? resources.find((s) => s.resource.locale === sourceLocale && fits(s)) ?? resources.find(fits) ?? resources.find(sibling);
 		const format = model && this.options.registry.formatById(model.resource.format);
 		let path = model && mirrorPath(model.resource.path, model.resource.locale, locale);
 		if (model && path && namespace !== void 0 && model.resource.namespace !== void 0 && model.resource.namespace !== namespace) path = mirrorPath(path, model.resource.namespace, namespace);
@@ -1699,6 +2043,7 @@ var PlanBuilder = class {
 		const renamed = keys.includes(op.from) ? /* @__PURE__ */ new Set() : this.renameNode(op.from, op.to);
 		for (const [from, to] of pairs) {
 			this.moveKey(from, to, renamed);
+			this.reviewDraft()?.move(from, to);
 			if (op.usages !== false) this.rewriteUsages(from, to);
 		}
 		if (op.usages === false) return;
@@ -1710,6 +2055,7 @@ var PlanBuilder = class {
 		if (keys.length === 0) throw errors.X18N4006({ key: op.key });
 		for (const key of keys) {
 			this.touched.add(key);
+			this.reviewDraft()?.remove(key, op.locales ?? "all");
 			for (const [locale, list] of this.options.messages(key) ?? []) if (op.locales === void 0 || op.locales === "all" || op.locales.includes(locale)) list.forEach((m) => this.deleteMessage(m));
 			const used = this.options.usageMatches({ key }).filter((match) => !match.possible).length;
 			if (used > 0) this.warnings.push(`"${key}" still has ${used} usage${used === 1 ? "" : "s"}.`);
@@ -1729,13 +2075,75 @@ var PlanBuilder = class {
 			}
 		}
 	}
+	/** The review draft, or undefined when reviews are off. */
+	reviewDraft() {
+		const reviews = this.state.reviews;
+		if (reviews) this.draft ??= new ReviewDraft(reviews.data);
+		return this.draft;
+	}
+	requireReviews() {
+		const draft = this.reviewDraft();
+		if (!draft) throw errors.X18N5003({ reason: this.state.reviewProblem ?? "reviews are off" });
+		return draft;
+	}
+	/** Records the source value a target was written against, once the project keeps a review file. */
+	recordSource(key, locale, force = false) {
+		if (locale === this.state.sourceLocale || !force && this.state.reviews?.text === void 0) return;
+		const source = this.plannedSource.has(key) ? this.plannedSource.get(key) : this.options.message(key, this.state.sourceLocale)?.value;
+		if (source !== void 0) this.reviewDraft()?.record(key, locale, sourceHash(source));
+	}
+	review(op) {
+		const draft = this.requireReviews();
+		if (!this.options.messages(op.key)) throw errors.X18N4006({ key: op.key });
+		if (!this.state.locales.includes(op.locale)) throw errors.X18N4008({ reason: `unknown locale "${op.locale}"` });
+		if (op.review === "suggestion" && op.suggestion === void 0) throw errors.X18N4008({ reason: "a suggestion needs a value" });
+		const current = this.options.message(op.key, op.locale)?.value;
+		this.touched.add(op.key);
+		draft.add(op.key, op.locale, {
+			id: op.id,
+			type: op.review,
+			...op.author && { author: op.author },
+			time: op.time,
+			...op.text !== void 0 && { text: op.text },
+			...op.review === "suggestion" && { suggestion: op.suggestion },
+			...op.review === "approve" && current !== void 0 && { value: valueText(current) }
+		});
+	}
+	applySuggestion(id) {
+		const draft = this.requireReviews();
+		const found = findReview(draft.data, id);
+		if (!found) throw errors.X18N5004({ id });
+		const { key, locale, comment } = found;
+		if (comment.type !== "suggestion" || comment.suggestion === void 0 || comment.resolved) throw errors.X18N5005({ id });
+		this.setValue(key, locale, comment.suggestion);
+		this.recordSource(key, locale, true);
+		draft.resolve(id);
+	}
+	resolveReview(id) {
+		const draft = this.requireReviews();
+		const found = findReview(draft.data, id);
+		if (!found) throw errors.X18N5004({ id });
+		this.touched.add(found.key);
+		draft.resolve(id);
+	}
+	markFresh(op) {
+		this.requireReviews();
+		if (this.options.message(op.key, this.state.sourceLocale) === void 0) throw errors.X18N4006({ key: op.key });
+		const locales = op.locales ?? this.state.locales.filter((locale) => this.options.message(op.key, locale) !== void 0);
+		this.touched.add(op.key);
+		for (const locale of locales) this.recordSource(op.key, locale, true);
+	}
+	set(op) {
+		this.setValue(op.key, op.locale, op.value);
+		if (op.locale === this.state.sourceLocale) this.plannedSource.set(op.key, op.value);
+		else if (op.value !== "") this.recordSource(op.key, op.locale);
+		if (!this.config.write.keepFilled) return;
+		for (const locale of this.state.locales) if (locale !== op.locale && !this.state.fallbacks[locale] && !this.options.message(op.key, locale)) this.setValue(op.key, locale, "");
+	}
 	run(ops) {
 		for (const op of ops) switch (op.type) {
 			case "set":
-				this.setValue(op.key, op.locale, op.value);
-				if (this.config.write.keepFilled) {
-					for (const locale of this.state.locales) if (locale !== op.locale && !this.state.fallbacks[locale] && !this.options.message(op.key, locale)) this.setValue(op.key, locale, "");
-				}
+				this.set(op);
 				break;
 			case "delete":
 				this.delete(op);
@@ -1747,7 +2155,19 @@ var PlanBuilder = class {
 			case "extract":
 				this.extract(op.items);
 				break;
-			case "format": for (const s of this.state.resources) if ((!op.paths || op.paths.includes(s.resource.path)) && !s.resource.readonly && !s.error) this.workFor(this.targetOf(s)).formatOnly = true;
+			case "format":
+				for (const s of this.state.resources) if ((!op.paths || op.paths.includes(s.resource.path)) && !s.resource.readonly && !s.error) this.workFor(this.targetOf(s)).formatOnly = true;
+				break;
+			case "review":
+				this.review(op);
+				break;
+			case "resolve-review":
+				this.resolveReview(op.id);
+				break;
+			case "apply-suggestion":
+				this.applySuggestion(op.id);
+				break;
+			case "mark-fresh": this.markFresh(op);
 		}
 	}
 	/** ---- Changes ---- */
@@ -1856,16 +2276,52 @@ var PlanBuilder = class {
 			});
 			texts.set(path, text);
 		}
+		const review = this.reviewChange();
+		if (review) {
+			changes.push(review);
+			texts.set(review.path, this.state.reviews?.text);
+		}
 		return {
 			changes,
 			texts
 		};
 	}
+	reviewChange() {
+		const reviews = this.state.reviews;
+		if (!reviews || !this.draft?.changed) return void 0;
+		const next = reviews.store.serialize(sortReviews(this.draft.data));
+		if (reviews.text === void 0) return {
+			type: "create",
+			path: reviews.file,
+			content: next
+		};
+		return next === reviews.text ? void 0 : {
+			type: "edit",
+			path: reviews.file,
+			edits: diffText(reviews.text, next)
+		};
+	}
 };
 function createPlanner(options) {
 	const texts = /* @__PURE__ */ new Map();
-	function planWith(ops, answers) {
+	/** Gives new reviews an id and a time, so planning again (after decisions) writes the same comments. */
+	function withReviewIds(ops, data) {
+		const used = /* @__PURE__ */ new Set();
+		const time = (/* @__PURE__ */ new Date()).toISOString();
+		return ops.map((op) => {
+			if (op.type !== "review" || op.id !== void 0 && op.time !== void 0) return op;
+			const id = op.id ?? reviewId((id) => used.has(id) || findReview(data, id) !== void 0);
+			used.add(id);
+			return {
+				...op,
+				id,
+				time: op.time ?? time
+			};
+		});
+	}
+	function planWith(input, answers) {
 		const state = options.state();
+		const ops = withReviewIds(input, state.reviews?.data ?? noReviews);
 		const builder = new PlanBuilder(options, state, answers);
 		builder.run(ops);
 		const result = builder.changes();
@@ -1965,7 +2421,8 @@ function buildPrompt(project, kind, to, options, extra) {
 	const from = project.sourceLocale;
 	const match = typeof options.keys === "string" ? keyMatcher([options.keys]) : void 0;
 	const list = Array.isArray(options.keys) ? new Set(options.keys) : void 0;
-	const stale = (key) => isOutdated(project.history(key, from), project.history(key, to));
+	const outdated = new Set(project.analyze().coverage.find((c) => c.locale === to)?.outdated);
+	const stale = (key) => outdated.has(key);
 	const candidates = project.keys({ namespace: options.namespace }).filter((key) => {
 		if (match && !match(key)) return false;
 		if (list && !list.has(key)) return false;
@@ -2020,7 +2477,11 @@ function buildPrompt(project, kind, to, options, extra) {
 		`Write a JSON file \`{ "${to}": { "<key>": "<translation>" } }\` and run \`x18n apply <file> --json\`, or run \`x18n set <key> --locale ${to} --value <text>\` per key.`,
 		`Then run \`x18n check --only placeholder-mismatch,invalid-syntax --locale ${to} --json\` and fix the reported keys.`,
 		nextCursor ? `${candidates.length - end} more keys remain: \`x18n prompt translate --to ${to} --cursor ${nextCursor}\`.` : `To find more work: \`x18n keys --missing ${to} --json --limit 50\`.`
-	] : [`Fix wrong translations with \`x18n set <key> --locale ${to} --value <text>\`, then list what you changed and why.`, `Then run \`x18n check --only placeholder-mismatch,invalid-syntax --locale ${to} --json\`.`];
+	] : project.reviewFile === void 0 ? [`Fix wrong translations with \`x18n set <key> --locale ${to} --value <text>\`, then list what you changed and why.`, `Then run \`x18n check --only placeholder-mismatch,invalid-syntax --locale ${to} --json\`.`] : [
+		`Leave fixes for a human to accept: \`x18n review suggest <key> --locale ${to} --value <text> --text <why>\`. Keep every placeholder in the value.`,
+		`For a problem without a clear fix, run \`x18n review request-change <key> --locale ${to} --text <why>\`.`,
+		`Then list what you reviewed; \`x18n review list --locale ${to} --open\` shows the open reviews.`
+	];
 	return {
 		kind,
 		project: project.name,
@@ -2102,6 +2563,10 @@ function createProject(options) {
 	let usageEligible = () => false;
 	let resourceIndex;
 	let resolved = /* @__PURE__ */ new WeakMap();
+	const reviewFile = config.review.file;
+	let reviewText;
+	let reviewData = noReviews;
+	let reviewError;
 	const normalizers = registry.plugins.flatMap((plugin) => plugin.normalizeKey ? [plugin.normalizeKey] : []);
 	const transforms = registry.plugins.flatMap((plugin) => plugin.transformResource ? [plugin.transformResource] : []);
 	const localeInfoHooks = registry.plugins.flatMap((plugin) => plugin.localeInfo ? [plugin.localeInfo] : []);
@@ -2138,6 +2603,44 @@ function createProject(options) {
 		const form = formOf(key);
 		return !form || categoriesOf(localeInfo(locale), form.type).includes(form.category);
 	}
+	const reviewStore = config.review.enabled ? registry.reviewStores.at(-1) : void 0;
+	async function loadReviews() {
+		if (!reviewStore) return;
+		reviewText = await host.readFile(reviewFile);
+		reviewError = void 0;
+		reviewData = noReviews;
+		if (reviewText === void 0) return;
+		try {
+			reviewData = reviewStore.parse(reviewText);
+		} catch (error) {
+			reviewError = errors.X18N5001({
+				path: reviewFile,
+				reason: error instanceof Error ? error.message : String(error),
+				cause: error
+			});
+		}
+	}
+	/** Reviews the planner may change: none while the file cannot be read, so a write never drops what is in it. */
+	function reviewSource() {
+		return reviewStore && !reviewError ? {
+			store: reviewStore,
+			file: reviewFile,
+			text: reviewText,
+			data: reviewData
+		} : void 0;
+	}
+	function reviewProblem() {
+		return reviewError?.message ?? (config.review.enabled ? "no review store is registered" : "`review.enabled` is false");
+	}
+	function reviews(filter = {}) {
+		return listThreads(reviewData, filter, locales, (key, locale) => message(key, locale)?.value);
+	}
+	/** A target recorded as written against the current source value. */
+	function fresh(key, locale) {
+		const recorded = reviewData.sources[key]?.[locale];
+		const source = message(key, sourceLocale)?.value;
+		return recorded !== void 0 && source !== void 0 && recorded === sourceHash(source);
+	}
 	async function discover() {
 		const ctx = {
 			host,
@@ -2265,6 +2768,22 @@ function createProject(options) {
 		if (state.error) return void 0;
 		return new Map([...walkLeaves(state.tree)].map((leaf) => [keyFor(state.resource, leaf.path), leaf.value]));
 	}
+	/** A path for a new resource, from the locale finders. */
+	function newResourcePath(locale, namespace, model) {
+		const ctx = {
+			host,
+			config,
+			extensions: [...new Set(registry.formats.flatMap((format) => format.extensions))]
+		};
+		for (const finder of registry.finders) {
+			const path = finder.resolveNew?.({
+				locale,
+				namespace,
+				model
+			}, ctx);
+			if (path) return path;
+		}
+	}
 	async function loadResources(candidates, reread) {
 		const next = /* @__PURE__ */ new Map();
 		const paths = [...new Set(candidates.map((c) => c.path))];
@@ -2276,6 +2795,7 @@ function createProject(options) {
 			}
 		}));
 		namespaced = config.namespace.separator !== "." && candidates.some((c) => c.namespace !== void 0);
+		await Promise.all(candidates.map((candidate) => registry.loadFormatFor(candidate.path, candidate.format)));
 		for (const candidate of candidates) {
 			const text = fileTexts.get(candidate.path);
 			if (text === void 0) continue;
@@ -2296,6 +2816,11 @@ function createProject(options) {
 		resolver = createUsageResolver(config, namespaced, normalizers);
 		resolved = /* @__PURE__ */ new WeakMap();
 		resourceIndex = void 0;
+		const namespaces = /* @__PURE__ */ new Set([void 0, ...[...resourceStates.values()].map((state) => state.resource.namespace)]);
+		await Promise.all([...namespaces].map((namespace) => {
+			const path = newResourcePath(sourceLocale, namespace, void 0);
+			return path ? registry.loadFormatFor(path) : void 0;
+		}));
 	}
 	async function scanOne(file) {
 		const usages = [];
@@ -2303,7 +2828,7 @@ function createProject(options) {
 		const keySlots = [];
 		const hardStrings = [];
 		const calls = config.usage.calls.filter((spec) => ![spec.callee].flat().some((name) => config.usage.ignoreCallees.includes(name)));
-		for (const scanner of registry.scannersFor(file.path)) {
+		for (const scanner of await registry.loadScannersFor(file.path)) {
 			const result = await scanner.scan(file, {
 				config,
 				calls
@@ -2470,12 +2995,13 @@ function createProject(options) {
 		};
 	}
 	function buildIndex() {
-		resourceIndex ??= buildResourceIndex();
+		const { messages, parents, derived } = resourceIndex ??= buildResourceIndex();
+		const has = (key) => messages.has(key) || parents.has(key) || derived.has(key);
 		const usages = [];
 		for (const [path, state] of [...files].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) {
 			let list = resolved.get(state);
 			if (!list) {
-				list = state.result.usages.map((candidate) => resolver.resolve(candidate, state.result.scopes ?? [], path, "scanner"));
+				list = state.result.usages.map((candidate) => resolver.resolve(candidate, state.result.scopes ?? [], path, "scanner", has));
 				resolved.set(state, list);
 			}
 			usages.push(...list);
@@ -2571,7 +3097,10 @@ function createProject(options) {
 				error: s.error,
 				path
 			}] : []),
-			discoveryErrors,
+			discoveryErrors: [...discoveryErrors, ...reviewError ? [{
+				error: reviewError,
+				path: reviewFile
+			}] : []],
 			messages: idx().messages,
 			parents: idx().parents,
 			usages: idx().usages,
@@ -2579,7 +3108,9 @@ function createProject(options) {
 			prefixUsages: idx().prefixUsages,
 			derived: idx().derived,
 			files,
-			history: history.get
+			history: history.get,
+			fresh,
+			reviews
 		}),
 		basesOf,
 		formOf,
@@ -2605,6 +3136,29 @@ function createProject(options) {
 		}
 		return list.sort();
 	}
+	function search(query, options = {}) {
+		if (!query) return [];
+		const lower = query.toLowerCase();
+		const score = (value) => !options.exact || value.toLowerCase().includes(lower) ? fuzzyScore(query, value) : -1;
+		const found = [];
+		for (const key of idx().messages.keys()) {
+			let best;
+			for (const locale of locales) {
+				const leaf = message(key, locale)?.value;
+				if (leaf === void 0 || leaf === null) continue;
+				const value = String(leaf);
+				const s = score(value);
+				if (s >= 0 && (!best || s > best.score)) best = {
+					key,
+					locale,
+					value,
+					score: s
+				};
+			}
+			if (best) found.push(best);
+		}
+		return found.sort((a, b) => b.score - a.score || a.value.length - b.value.length || a.key.localeCompare(b.key));
+	}
 	function get(key) {
 		const { messages, keyPaths } = idx();
 		const byLocale = messages.get(key);
@@ -2618,7 +3172,8 @@ function createProject(options) {
 			messages: list,
 			missing: locales.filter((locale) => !byLocale.has(locale) && needs(key, locale)),
 			usages: usageMatches({ key }),
-			diagnostics: analyzer.analyze().diagnostics.filter((d) => d.key === key)
+			diagnostics: analyzer.analyze().diagnostics.filter((d) => d.key === key),
+			reviews: reviews({ key })
 		};
 	}
 	function keyAt(path, offset) {
@@ -2672,6 +3227,10 @@ function createProject(options) {
 			conflicts: registry.conflicts,
 			errors: [
 				...discoveryErrors,
+				...reviewError ? [{
+					error: reviewError,
+					path: reviewFile
+				}] : [],
 				...resources.flatMap((state) => state.error ? [{
 					error: state.error,
 					path: state.resource.path
@@ -2701,15 +3260,24 @@ function createProject(options) {
 		collect(idx());
 		return [...out];
 	}
+	/** Reloads the review file and returns the keys whose reviews or records it had or has. */
+	async function reloadReviews() {
+		const keysOf = (data) => [...Object.keys(data.threads), ...Object.keys(data.sources)];
+		const old = keysOf(reviewData);
+		await loadReviews();
+		return [...old, ...keysOf(reviewData)];
+	}
 	let current = Promise.resolve();
 	async function update(events) {
 		const run = current.then(async () => {
 			if (events.length === 0) return void 0;
 			const before = idx();
 			const paths = new Set(events.map((event) => event.path));
+			const reviewKeys = paths.has(reviewFile) ? await reloadReviews() : [];
 			const resourcePaths = new Set([...resourceStates.values()].map((state) => state.resource.path));
-			const maybeResource = (path) => !resourcePaths.has(path) && registry.formatFor(path) !== void 0 && !usageEligible(path);
-			const structural = events.some((event) => event.type !== "change" || maybeResource(event.path));
+			const maybeResource = (path) => path !== reviewFile && !resourcePaths.has(path) && registry.formatIdFor(path) !== void 0 && !usageEligible(path);
+			const blockPaths = new Set([...resourceStates.values()].filter((state) => state.resource.block).map((state) => state.resource.path));
+			const structural = events.some((event) => event.type !== "change" || maybeResource(event.path) || blockPaths.has(event.path));
 			if (structural || [...paths].some((path) => resourcePaths.has(path))) await loadResources(structural ? await discover() : [...resourceStates.values()].map((state) => ({
 				...state.resource,
 				format: state.resource.format === "unknown" ? void 0 : state.resource.format
@@ -2721,7 +3289,7 @@ function createProject(options) {
 			const change = {
 				revision,
 				paths: [...paths],
-				keys: touchedKeys(paths, before)
+				keys: [.../* @__PURE__ */ new Set([...touchedKeys(paths, before), ...reviewKeys])]
 			};
 			emit(change);
 			return change;
@@ -2740,7 +3308,9 @@ function createProject(options) {
 			fallbacks,
 			namespaced,
 			resources: [...resourceStates.values()],
-			fileTexts
+			fileTexts,
+			reviews: reviewSource(),
+			reviewProblem: reviewProblem()
 		}),
 		message: (key, locale) => message(key, locale),
 		messages: (key) => idx().messages.get(key),
@@ -2750,24 +3320,12 @@ function createProject(options) {
 		text: (path) => fileTexts.get(path) ?? files.get(path)?.text,
 		basesOf,
 		toStored: (target, path) => storedPathOf(target)(path),
-		resolveNew(locale, namespace) {
-			const ctx = {
-				host,
-				config,
-				extensions: [...new Set(registry.formats.flatMap((format) => format.extensions))]
-			};
-			for (const finder of registry.finders) {
-				const path = finder.resolveNew?.({
-					locale,
-					namespace
-				}, ctx);
-				if (path) return path;
-			}
-		},
+		resolveNew: newResourcePath,
 		update
 	});
 	const ready = (async () => {
-		await loadResources(await discover(), "all");
+		const candidates = await discover();
+		await Promise.all([loadResources(candidates, "all"), loadReviews()]);
 		await scanAll();
 		revision++;
 	})();
@@ -2796,6 +3354,7 @@ function createProject(options) {
 		placeholderSyntaxes: registry.placeholders,
 		extractTemplates: [...(config.extract.templates ?? []).map((template) => typeof template === "string" ? { template } : template), ...registry.extractors.flatMap((extractor) => extractor.templates)],
 		keys,
+		search,
 		get,
 		message,
 		parseKey(input) {
@@ -2838,13 +3397,18 @@ function createProject(options) {
 		},
 		history: history.get,
 		valueAt: history.valueAt,
+		reviews,
+		reviewFile: reviewStore && reviewFile,
+		async reviewAuthor() {
+			return config.review.author ?? await host.identity?.();
+		},
 		prompt: (kind, locale, promptOptions = {}) => buildPrompt(project, kind, locale, promptOptions, {
 			config,
 			hooks: registry.plugins.flatMap((plugin) => plugin.translatePrompt ? [plugin.translatePrompt] : [])
 		}),
 		explain,
 		localeInfo,
-		text: (path) => fileTexts.get(path) ?? files.get(path)?.text,
+		text: (path) => fileTexts.get(path) ?? files.get(path)?.text ?? (path === reviewFile ? reviewText : void 0),
 		owns: (path) => fileTexts.has(path) || files.has(path) || usageEligible(path),
 		plan: (ops) => planner.plan(ops),
 		apply: (plan, applyOptions) => planner.apply(plan, applyOptions?.answers ?? {}),
@@ -2894,6 +3458,8 @@ function defaultDraft() {
 		namespace: {
 			separator: ".",
 			default: void 0,
+			fallback: [],
+			byFile: {},
 			fromPath: "dot"
 		},
 		usage: {
@@ -2916,6 +3482,11 @@ function defaultDraft() {
 		ignoreKeys: [],
 		glossary: [],
 		history: { providers: [] },
+		review: {
+			enabled: true,
+			file: ".x18n/reviews.yml",
+			author: void 0
+		},
 		pluginConfigs: {}
 	};
 }
@@ -2977,6 +3548,11 @@ function applyLayer(draft, layer, origin, origins) {
 		draft.namespace = {
 			separator: layer.namespace.separator ?? draft.namespace.separator,
 			default: layer.namespace.default ?? draft.namespace.default,
+			fallback: layer.namespace.fallback ?? draft.namespace.fallback,
+			byFile: {
+				...draft.namespace.byFile,
+				...layer.namespace.byFile
+			},
 			fromPath: layer.namespace.fromPath ?? draft.namespace.fromPath
 		};
 		mark("namespace");
@@ -3038,6 +3614,14 @@ function applyLayer(draft, layer, origin, origins) {
 		};
 		mark("history");
 	}
+	if (layer.review !== void 0) {
+		draft.review = {
+			enabled: layer.review.enabled ?? draft.review.enabled,
+			file: layer.review.file ?? draft.review.file,
+			author: layer.review.author ?? draft.review.author
+		};
+		mark("review");
+	}
 	if (layer.pluginConfigs !== void 0) {
 		draft.pluginConfigs = {
 			...draft.pluginConfigs,
@@ -3081,8 +3665,8 @@ function createLoader(options) {
 		if (option === false || option === void 0) return void 0;
 		if (typeof option === "object" && !Array.isArray(option)) return option;
 		const [specifier, pluginOptions] = typeof option === "string" ? [option, void 0] : [option[0], option[1]];
-		const factory = options.builtins.presets[specifier];
-		if (factory) return factory(pluginOptions);
+		const entry = options.builtins.presets[specifier];
+		if (entry) return (await entry.load()).default(pluginOptions);
 		if (!options.loadPlugin) throw errors.X18N1003({ preset: specifier });
 		return options.loadPlugin(specifier, pluginOptions);
 	};
@@ -3118,7 +3702,17 @@ async function expandPresets(presets, userPlugins, listed, detectCtx) {
 		name: preset.name,
 		reason: "after-exclusive"
 	});
-	else stopped = await flatten(preset, listed);
+	else if ("entry" in preset) {
+		const applies = listed || (preset.entry.detect ? await preset.entry.detect(detectCtx) : false);
+		explanations.push({
+			name: preset.name,
+			reason: applies ? listed ? "listed" : "detected" : "not-detected"
+		});
+		if (!applies) continue;
+		const loaded = (await preset.entry.load()).default();
+		for (const child of loaded.plugins) await flatten(child, false);
+		stopped = preset.entry.exclusive === true || loaded.exclusive === true;
+	} else stopped = await flatten(preset, listed);
 	for (const plugin of userPlugins) await flatten(plugin, true);
 	return {
 		plugins,
@@ -3141,7 +3735,10 @@ async function resolveConfig(options) {
 	const userPlugins = await loadAll(load, [...options.parent?.plugins ?? [], ...user.plugins ?? []]);
 	const presetOption = user.presets ?? options.parent?.presets ?? "auto";
 	const auto = presetOption === "auto";
-	const presets = auto ? Object.values(builtins.presets).map((factory) => factory()) : (await loadAll(load, presetOption)).map((item) => isPreset(item) ? item : {
+	const presets = auto ? Object.entries(builtins.presets).map(([name, entry]) => ({
+		name,
+		entry
+	})) : (await loadAll(load, presetOption)).map((item) => isPreset(item) ? item : {
 		name: item.name,
 		plugins: [item]
 	});
@@ -3182,4 +3779,4 @@ async function resolveConfig(options) {
 	};
 }
 //#endregion
-export { ConfigSchema, PluginFileSchema, applyMessageOps, applyTextEdits, buildTree, contractVersion, createLineIndex, createMemoryHost, createOverlayHost, createPlaceholderComparer, createProject, createRegistry, defineConfig, definePlugin, definePreset, diffText, envelope, errors, extensionOf, globToRegExp, hashText, isJsonObject, isKeyUnder, isMessageLeaf, isMessageTree, isPreset, isX18nError, joinKey, keyMatcher, localeSpellingKey, parseLocaleInfo, parseMessageBatch, pathId, pathMatcher, placeholderProblems, rangeContains, renderPrompt, replaceKeyPrefix, resolveConfig, sortTree, splitKey, toErrorInfo, toWireDiagnostic, toWireRange, validate, walkLeaves };
+export { ConfigSchema, PluginFileSchema, ReviewFileSchema, applyMessageOps, applyTextEdits, buildTree, contractVersion, createLibraryPlugin, createLineIndex, createMemoryHost, createOverlayHost, createPlaceholderComparer, createProject, createRegistry, defineConfig, definePlugin, definePreset, diffText, envelope, errors, extensionOf, fuzzyScore, globToRegExp, hashText, isJsonObject, isKeyUnder, isMessageLeaf, isMessageTree, isPreset, isX18nError, joinKey, keyMatcher, localeSpellingKey, parseLocaleInfo, parseMessageBatch, pathId, pathMatcher, placeholderProblems, rangeContains, renderExplanation, renderPrompt, replaceKeyPrefix, resolveConfig, sortTree, splitKey, toErrorInfo, toWireDiagnostic, toWireRange, validate, walkLeaves };