prosebook 0.1.0 → 0.3.0

package/dist/scan-Bx0_yDSi.js

@@ -0,0 +1,387 @@
+import { d as staticLiteral, l as placeholderOf, o as numberOptions, r as dateOptions, s as optionArgsOf, t as TYPE$1, u as selectionOf } from "./icu-Dej0mNsF.js";
+import { extname, join, relative } from "node:path";
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { isDateElement, isNumberElement, isTimeElement } from "@formatjs/icu-messageformat-parser";
+import { parseSync } from "oxc-parser";
+// src/tools/compile.ts
+/**
+* Compiles ICU ASTs to JavaScript.
+*
+* A message with no placeholders becomes its string. Any other becomes `(a, h) => …`, where `a` holds
+* the arguments and `h` the locale's helpers (see `runtime/helpers.ts`): a plural is a call picking an
+* arm, a number is a call to a cached `Intl.NumberFormat`. A placeholder without a value, or with one
+* `Intl` refuses, shows as `{name}` and is reported (`h.e`) rather than throwing, so every such
+* message uses `h`. Formatting options are resolved here and
+* hoisted to module constants, so a skeleton costs nothing at runtime and its formatter is built once.
+* Options an argument gives (MF2's `currency=$code`) follow them as an object built per call, and the
+* runtime keeps a formatter per value.
+*/
+/** Module-level constants for formatting options, one per distinct object. */
+var Hoisted = class {
+	byJson = /* @__PURE__ */ new Map();
+	/** `, oN` naming the hoisted options, or nothing when there are none. */
+	arg(options) {
+		if (options === void 0 || Object.keys(options).length === 0) return "";
+		const json = JSON.stringify(options);
+		let name = this.byJson.get(json);
+		if (name === void 0) this.byJson.set(json, name = `o${this.byJson.size}`);
+		return `, ${name}`;
+	}
+	declarations() {
+		return [...this.byJson].map(([json, name]) => `const ${name} = ${json};`);
+	}
+};
+function access(name) {
+	return /^[A-Za-z_$][\w$]*$/.test(name) ? `a.${name}` : `a[${JSON.stringify(name)}]`;
+}
+function nodes(elements, hoisted, pound) {
+	if (elements.length === 0) return "\"\"";
+	const parts = elements.map((el) => node(el, hoisted, pound));
+	return parts.length === 1 ? parts[0] : `[${parts.join(", ")}]`;
+}
+function arms(options, hoisted, pound) {
+	return `{ ${Object.entries(options).map(([arm, option]) => `${JSON.stringify(arm)}: () => ${nodes(option.value, hoisted, pound)}`).join(", ")} }`;
+}
+/** The hoisted options, then the options arguments give as `{ currency: a.code }`, where there are any. */
+function formatting(options, args, hoisted) {
+	const given = Object.entries(args ?? {});
+	const fixed = hoisted.arg(options);
+	if (given.length === 0) return fixed;
+	return `${fixed || ", undefined"}, { ${given.map(([option, { arg }]) => `${option}: ${access(arg)}`).join(", ")} }`;
+}
+/** A string literal, its invisible direction marks escaped so the generated code shows them. */
+function text(value) {
+	return JSON.stringify(value).replace(/[\u2066-\u2069]/g, (c) => `\\u${c.charCodeAt(0).toString(16)}`);
+}
+/**
+* A placeholder's value, or its fallback (`{name}`, reported through `h.e`) where it has none or
+* `Intl` refuses it, between the marks isolating its direction where it has them.
+*/
+function placed(el, name, value) {
+	const { fallback, isolate } = placeholderOf(el, name);
+	const shown = `${value} ?? h.e(${text(fallback)})`;
+	return isolate === void 0 ? shown : `[${text(isolate[0])}, ${shown}, ${text(isolate[1])}]`;
+}
+function node(el, hoisted, pound) {
+	const formatted = (helper, name, options) => placed(el, name, `h.${helper}(${access(name)}${formatting(options, optionArgsOf(el), hoisted)})`);
+	if (isNumberElement(el)) return formatted("n", el.value, numberOptions(el));
+	if (isDateElement(el) || isTimeElement(el)) return formatted("d", el.value, dateOptions(el));
+	switch (el.type) {
+		case TYPE$1.literal: return JSON.stringify(el.value);
+		case TYPE$1.argument: return placed(el, el.value, access(el.value));
+		case TYPE$1.pound:
+			if (pound === null) return "\"#\"";
+			return placed(el, pound.name, `h.n(${access(pound.name)}${pound.offset !== 0 ? ` - ${pound.offset}` : ""})`);
+		case TYPE$1.select: return `h.s(${access(el.value)}, ${arms(el.options, hoisted, pound)})`;
+		case TYPE$1.plural: {
+			const selection = selectionOf(el);
+			const value = access(el.value);
+			const on = selection?.value === "round" ? `Math.round(${value})` : selection?.value === "percent" ? `${value} * 100` : value;
+			const rules = selection === void 0 ? "" : formatting(selection.options, selection.args, hoisted);
+			const own = {
+				name: el.value,
+				offset: el.offset
+			};
+			return `h.p(${on}, ${el.offset}, ${el.pluralType === "ordinal"}, ${arms(el.options, hoisted, own)}${rules})`;
+		}
+		case TYPE$1.tag: return `h.t(a, ${JSON.stringify(el.value)}, ${nodes(el.children, hoisted, pound)})`;
+		default: throw new Error(`prosebook: no compiler for ICU element type ${el.type}`);
+	}
+}
+function message(ast, hoisted) {
+	const literal = staticLiteral(ast);
+	if (literal !== void 0) return JSON.stringify(literal);
+	return `(a, h) => ${nodes(ast, hoisted, null)}`;
+}
+/** One locale's messages as code, keeping only `keep` when given. */
+function compileLocale(entries, keep) {
+	const hoisted = new Hoisted();
+	const rows = [];
+	for (const [key, ast] of entries) {
+		if (keep && !keep(key)) continue;
+		rows.push(`  ${JSON.stringify(key)}: ${message(ast, hoisted)},`);
+	}
+	return {
+		declarations: hoisted.declarations(),
+		rows
+	};
+}
+/** The locale as an ES module whose default export is its messages. */
+function localeModule(compiled, banner, ts) {
+	const head = ts ? `${banner}\nimport type { CompiledMessages } from 'prosebook';\n` : `${banner}\n`;
+	const declarations = ts ? compiled.declarations.map((d) => d.replace(/;$/, " as const;")) : compiled.declarations;
+	const consts = declarations.length > 0 ? `\n${declarations.join("\n")}\n` : "";
+	const close = ts ? "} satisfies CompiledMessages;" : "};";
+	return `${head}${consts}\nexport default {\n${compiled.rows.join("\n")}\n${close}\n`;
+}
+/** The locale as one expression, for a bundler to inline in place of the module. */
+function localeExpression(compiled) {
+	return `(() => {\n${compiled.declarations.join("\n")}\nreturn {\n${compiled.rows.join("\n")}\n};\n})()`;
+}
+// src/tools/scan.ts
+/**
+* What the code says: text a person reads that is still written in a component, and which catalog
+* keys the code names.
+*
+* Key references are found by reading string literals, not by tracing calls, so a key kept in an
+* array or a map still counts, and `nav.${id}` or `'nav.' + id` keeps every key under `nav.`. That
+* errs towards keeping a key, which is the safe direction both for `unused` and for pruning a bundle.
+*/
+const SKIP_DIRS = /* @__PURE__ */ new Set([
+	"node_modules",
+	"dist",
+	"build",
+	"out",
+	"coverage",
+	".git"
+]);
+function sourceFiles(dirs, extensions, skip = []) {
+	const files = [];
+	const visit = (dir) => {
+		let names;
+		try {
+			names = readdirSync(dir);
+		} catch {
+			return;
+		}
+		for (const name of names) {
+			const path = join(dir, name);
+			if (skip.some((s) => path === s || path.startsWith(`${s}/`) || path.startsWith(`${s}\\`))) continue;
+			if (statSync(path).isDirectory()) {
+				if (!SKIP_DIRS.has(name) && !name.startsWith(".")) visit(path);
+			} else if (extensions.includes(extname(name)) && !name.endsWith(".d.ts")) files.push(path);
+		}
+	};
+	for (const dir of dirs) visit(dir);
+	return files.sort();
+}
+const LITERAL_KEY = /(['"`])([a-z0-9][\w-]*(?:\.[\w-]+)+)\1/g;
+const KEY_PREFIX = /(['"`])([a-z0-9][\w-]*(?:\.[\w-]+)*\.)(?:\1|\$\{)/g;
+function keyRefs(code, into = {
+	exact: /* @__PURE__ */ new Set(),
+	prefixes: /* @__PURE__ */ new Set()
+}) {
+	for (const m of code.matchAll(LITERAL_KEY)) into.exact.add(m[2]);
+	for (const m of code.matchAll(KEY_PREFIX)) into.prefixes.add(m[2]);
+	return into;
+}
+function isReferenced(key, refs) {
+	if (refs.exact.has(key)) return true;
+	for (const prefix of refs.prefixes) if (key.startsWith(prefix)) return true;
+	return false;
+}
+/**
+* Text that reads as code rather than prose: one token holding a path, a call, an identifier with an
+* underscore or a dotted name, as in `form.json()` or `src/index.ts`. Trailing punctuation doesn't
+* count, so `Done.` is still prose.
+*/
+function looksLikeCode(text) {
+	const token = text.trim().replace(/[.!?:,…]+$/, "");
+	return token !== "" && !/\s/.test(token) && /[/()_=<>{}[\].]|::/.test(token);
+}
+const NON_PROSE_ELEMENTS = /* @__PURE__ */ new Set([
+	"code",
+	"pre",
+	"kbd",
+	"samp",
+	"script",
+	"style",
+	"svg",
+	"path"
+]);
+const LETTER = /\p{L}/u;
+/** Offsets in `code` as lines and columns, and whether a line is marked `prosebook-ignore`, on it or the line above. */
+function lineIndex(code) {
+	const lines = code.split("\n");
+	const lineStarts = [];
+	let offset = 0;
+	for (const line of lines) {
+		lineStarts.push(offset);
+		offset += line.length + 1;
+	}
+	const position = (at) => {
+		let lo = 0;
+		let hi = lineStarts.length - 1;
+		while (lo < hi) {
+			const mid = lo + hi + 1 >> 1;
+			if (lineStarts[mid] <= at) lo = mid;
+			else hi = mid - 1;
+		}
+		return {
+			line: lo + 1,
+			column: at - lineStarts[lo] + 1
+		};
+	};
+	const ignored = (line) => (lines[line - 1] ?? "").includes("prosebook-ignore") || (lines[line - 2] ?? "").includes("prosebook-ignore");
+	return {
+		position,
+		ignored
+	};
+}
+/** Literal text in JSX that a person reads, where it should be a catalog entry. */
+function hardcodedText(file, code, attributes) {
+	const { program } = parseSync(file, code);
+	const found = [];
+	const { position, ignored } = lineIndex(code);
+	const report = (node, text, where) => {
+		const trimmed = text.replace(/\s+/g, " ").trim();
+		if (!LETTER.test(trimmed) || looksLikeCode(trimmed)) return;
+		const at = position(node.start + Math.max(0, code.slice(node.start, node.end).search(/\S/)));
+		if (ignored(at.line)) return;
+		found.push({
+			file,
+			...at,
+			text: trimmed,
+			where
+		});
+	};
+	const visit = (node, inProse) => {
+		let prose = inProse;
+		if (node.type === "JSXElement") {
+			const opening = node.openingElement;
+			if (opening.name.type === "JSXIdentifier" && NON_PROSE_ELEMENTS.has(opening.name.name ?? "")) prose = false;
+		}
+		if (node.type === "JSXText" && prose) report(node, node.value, "text");
+		if (node.type === "JSXExpressionContainer" && prose) {
+			const expr = node.expression;
+			if (expr.type === "Literal" && typeof expr.value === "string") report(expr, expr.value, "text");
+			if (expr.type === "TemplateLiteral" && expr.expressions.length === 0) report(expr, String(expr.quasis[0]?.value.cooked), "text");
+		}
+		if (node.type === "JSXAttribute") {
+			const name = node.name;
+			const value = node.value;
+			const attr = name.type === "JSXIdentifier" ? name.name ?? "" : "";
+			if (attributes.includes(attr) && value !== null) {
+				if (value.type === "Literal" && typeof value.value === "string") report(value, value.value, attr);
+				if (value.type === "JSXExpressionContainer") {
+					const expr = value.expression;
+					if (expr.type === "Literal" && typeof expr.value === "string") report(expr, expr.value, attr);
+				}
+			}
+			return;
+		}
+		for (const value of Object.values(node)) if (Array.isArray(value)) {
+			for (const child of value) if (isNode(child)) visit(child, prose);
+		} else if (isNode(value)) visit(value, prose);
+	};
+	visit(program, true);
+	return found;
+}
+function isNode(value) {
+	return typeof value === "object" && value !== null && typeof value.type === "string";
+}
+function scan(dirs, extensions, attributes, root, skip = []) {
+	const refs = {
+		exact: /* @__PURE__ */ new Set(),
+		prefixes: /* @__PURE__ */ new Set()
+	};
+	const hardcoded = [];
+	const files = sourceFiles(dirs, extensions, skip);
+	for (const path of files) {
+		const code = readFileSync(path, "utf8");
+		keyRefs(code, refs);
+		if (/\.[jt]sx$/.test(path)) hardcoded.push(...hardcodedText(relative(root, path).replaceAll("\\", "/"), code, attributes));
+	}
+	return {
+		hardcoded,
+		refs,
+		files: files.length
+	};
+}
+/** A copy's methods that take a key first. */
+const READERS = /* @__PURE__ */ new Set(["t", "rich"]);
+const PREFIX = /^[a-z0-9][\w-]*(?:\.[\w-]+)*\.$/;
+const WRAPPERS = /* @__PURE__ */ new Set([
+	"ParenthesizedExpression",
+	"TSAsExpression",
+	"TSSatisfiesExpression",
+	"TSNonNullExpression",
+	"TSTypeAssertion"
+]);
+/** Whether `keyRefs` finds every key an expression can be: a literal, or a template or sum after a key prefix. */
+function keySeen(node) {
+	if (node === void 0) return false;
+	if (WRAPPERS.has(node.type)) return keySeen(node.expression);
+	switch (node.type) {
+		case "Literal": return typeof node.value === "string";
+		case "TemplateLiteral": {
+			const [head] = node.quasis;
+			return node.expressions.length === 0 || PREFIX.test(head?.value.cooked ?? "");
+		}
+		case "BinaryExpression": {
+			const left = node.left;
+			return node.operator === "+" && left.type === "Literal" && typeof left.value === "string" && PREFIX.test(left.value);
+		}
+		case "ConditionalExpression": return keySeen(node.consequent) && keySeen(node.alternate);
+		case "LogicalExpression": return keySeen(node.left) && keySeen(node.right);
+		default: return false;
+	}
+}
+const nameOf = (node) => node?.type === "Identifier" || node?.type === "JSXIdentifier" ? node.name : node?.type === "Literal" ? String(node.value) : void 0;
+/**
+* The reads in a module whose key a pruned build can't see, as in `t(item.key)` or `<Text id={id} />`:
+* the build would leave the message out, and the key would show in its place. A build has no types,
+* so readers are known by name: `t` and `rich` called alone or as methods, and any name imported here,
+* which may be bound to one elsewhere (`aliases`); the caller keeps those whose name turns out to be a
+* reader. `<Text>` counts where it is imported from `prosebook/react`. Lines marked `prosebook-ignore`
+* are skipped.
+*/
+function unseenReads(file, code) {
+	const { program } = parseSync(file, code);
+	const { position, ignored } = lineIndex(code);
+	const unseen = [];
+	const aliases = /* @__PURE__ */ new Set();
+	/** Local name to the name it was imported by. */
+	const imported = /* @__PURE__ */ new Map();
+	const texts = /* @__PURE__ */ new Set();
+	for (const statement of program.body) {
+		if (statement.type !== "ImportDeclaration") continue;
+		for (const s of statement.specifiers) {
+			const name = s.type === "ImportSpecifier" ? nameOf(s.imported) : void 0;
+			const local = nameOf(s.local);
+			if (name === void 0 || local === void 0) continue;
+			if (name === "Text" && statement.source.value === "prosebook/react") texts.add(local);
+			else imported.set(local, name);
+		}
+	}
+	const report = (node, name) => {
+		const at = position(node.start);
+		if (ignored(at.line)) return;
+		const text = code.slice(node.start, node.end).replace(/\s+/g, " ");
+		unseen.push({
+			file,
+			...at,
+			name,
+			code: text.length > 80 ? `${text.slice(0, 77)}...` : text
+		});
+	};
+	const calls = [];
+	const visit = (node) => {
+		if (node.type === "ObjectPattern") {
+			for (const p of node.properties) if (p.type === "Property" && READERS.has(nameOf(p.key) ?? "") && p.value.type === "Identifier") aliases.add(nameOf(p.value));
+		}
+		if (node.type === "CallExpression" && !keySeen(node.arguments[0])) {
+			const callee = node.callee;
+			if (callee.type === "Identifier") calls.push([node, callee.name]);
+			else if (callee.type === "MemberExpression" && !callee.computed && READERS.has(nameOf(callee.property) ?? "")) report(node, nameOf(callee.property));
+		}
+		if (node.type === "JSXOpeningElement" && texts.has(nameOf(node.name) ?? "")) {
+			const value = node.attributes.find((a) => a.type === "JSXAttribute" && nameOf(a.name) === "id")?.value;
+			if (value !== null && value !== void 0 && !keySeen(value.type === "JSXExpressionContainer" ? value.expression : value)) report(node, "Text");
+		}
+		for (const value of Object.values(node)) if (Array.isArray(value)) {
+			for (const child of value) if (isNode(child)) visit(child);
+		} else if (isNode(value)) visit(value);
+	};
+	visit(program);
+	for (const [node, local] of calls) if (READERS.has(local) || aliases.has(local)) report(node, local);
+	else if (imported.has(local)) report(node, imported.get(local));
+	unseen.sort((a, b) => a.line === b.line ? a.column - b.column : a.line - b.line);
+	return {
+		unseen,
+		aliases
+	};
+}
+export { looksLikeCode as a, unseenReads as c, localeModule as d, keyRefs as i, compileLocale as l, hardcodedText as n, scan as o, isReferenced as r, sourceFiles as s, READERS as t, localeExpression as u };
+
+//# sourceMappingURL=scan-Bx0_yDSi.js.map

package/dist/scan-Bx0_yDSi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-Bx0_yDSi.js","names":["TYPE"],"sources":["../src/tools/compile.ts","../src/tools/scan.ts"],"sourcesContent":["/**\n * Compiles ICU ASTs to JavaScript.\n *\n * A message with no placeholders becomes its string. Any other becomes `(a, h) => …`, where `a` holds\n * the arguments and `h` the locale's helpers (see `runtime/helpers.ts`): a plural is a call picking an\n * arm, a number is a call to a cached `Intl.NumberFormat`. A placeholder without a value, or with one\n * `Intl` refuses, shows as `{name}` and is reported (`h.e`) rather than throwing, so every such\n * message uses `h`. Formatting options are resolved here and\n * hoisted to module constants, so a skeleton costs nothing at runtime and its formatter is built once.\n * Options an argument gives (MF2's `currency=$code`) follow them as an object built per call, and the\n * runtime keeps a formatter per value.\n */\nimport { isDateElement, isNumberElement, isTimeElement } from '@formatjs/icu-messageformat-parser';\n\nimport {\n  dateOptions,\n  numberOptions,\n  optionArgsOf,\n  placeholderOf,\n  selectionOf,\n  staticLiteral,\n  TYPE,\n  type MessageFormatElement,\n  type OptionArgs,\n} from './icu.ts';\n\nexport type Entry = readonly [key: string, ast: MessageFormatElement[]];\n\n/** Module-level constants for formatting options, one per distinct object. */\nclass Hoisted {\n  private readonly byJson = new Map<string, string>();\n\n  /** `, oN` naming the hoisted options, or nothing when there are none. */\n  arg(options: object | undefined): string {\n    // `{}` (a bare `:number`) formats as no options do, so it needs no constant.\n    if (options === undefined || Object.keys(options).length === 0) return '';\n    const json = JSON.stringify(options);\n    let name = this.byJson.get(json);\n    if (name === undefined) this.byJson.set(json, (name = `o${this.byJson.size}`));\n    return `, ${name}`;\n  }\n\n  declarations(): string[] {\n    return [...this.byJson].map(([json, name]) => `const ${name} = ${json};`);\n  }\n}\n\nfunction access(name: string): string {\n  return /^[A-Za-z_$][\\w$]*$/.test(name) ? `a.${name}` : `a[${JSON.stringify(name)}]`;\n}\n\n/** The plural a `#` prints the value of. */\ntype Pound = { name: string; offset: number } | null;\n\nfunction nodes(elements: MessageFormatElement[], hoisted: Hoisted, pound: Pound): string {\n  if (elements.length === 0) return '\"\"';\n  const parts = elements.map((el) => node(el, hoisted, pound));\n  return parts.length === 1 ? parts[0]! : `[${parts.join(', ')}]`;\n}\n\nfunction arms(options: Record<string, { value: MessageFormatElement[] }>, hoisted: Hoisted, pound: Pound): string {\n  const body = Object.entries(options).map(([arm, option]) => `${JSON.stringify(arm)}: () => ${nodes(option.value, hoisted, pound)}`);\n  return `{ ${body.join(', ')} }`;\n}\n\n/** The hoisted options, then the options arguments give as `{ currency: a.code }`, where there are any. */\nfunction formatting(options: object | undefined, args: OptionArgs | undefined, hoisted: Hoisted): string {\n  const given = Object.entries(args ?? {});\n  const fixed = hoisted.arg(options);\n  if (given.length === 0) return fixed;\n  return `${fixed || ', undefined'}, { ${given.map(([option, { arg }]) => `${option}: ${access(arg)}`).join(', ')} }`;\n}\n\n/** A string literal, its invisible direction marks escaped so the generated code shows them. */\nfunction text(value: string): string {\n  return JSON.stringify(value).replace(/[\\u2066-\\u2069]/g, (c) => `\\\\u${c.charCodeAt(0).toString(16)}`);\n}\n\n/**\n * A placeholder's value, or its fallback (`{name}`, reported through `h.e`) where it has none or\n * `Intl` refuses it, between the marks isolating its direction where it has them.\n */\nfunction placed(el: MessageFormatElement, name: string, value: string): string {\n  const { fallback, isolate } = placeholderOf(el, name);\n  const shown = `${value} ?? h.e(${text(fallback)})`;\n  return isolate === undefined ? shown : `[${text(isolate[0])}, ${shown}, ${text(isolate[1])}]`;\n}\n\nfunction node(el: MessageFormatElement, hoisted: Hoisted, pound: Pound): string {\n  const formatted = (helper: string, name: string, options: object | undefined) =>\n    placed(el, name, `h.${helper}(${access(name)}${formatting(options, optionArgsOf(el), hoisted)})`);\n  if (isNumberElement(el)) return formatted('n', el.value, numberOptions(el));\n  if (isDateElement(el) || isTimeElement(el)) return formatted('d', el.value, dateOptions(el));\n  switch (el.type) {\n    case TYPE.literal:\n      return JSON.stringify(el.value);\n    case TYPE.argument:\n      return placed(el, el.value, access(el.value));\n    case TYPE.pound:\n      // `#` is its plural's own value less its offset, formatted as a number.\n      if (pound === null) return '\"#\"';\n      return placed(el, pound.name, `h.n(${access(pound.name)}${pound.offset !== 0 ? ` - ${pound.offset}` : ''})`);\n    case TYPE.select:\n      return `h.s(${access(el.value)}, ${arms(el.options, hoisted, pound)})`;\n    case TYPE.plural: {\n      // Read from MF2, a plural selects on the number as formatted, and on what `:integer` and `:percent` make of it.\n      const selection = selectionOf(el);\n      const value = access(el.value);\n      const on = selection?.value === 'round' ? `Math.round(${value})` : selection?.value === 'percent' ? `${value} * 100` : value;\n      const rules = selection === undefined ? '' : formatting(selection.options, selection.args, hoisted);\n      const own = { name: el.value, offset: el.offset };\n      return `h.p(${on}, ${el.offset}, ${el.pluralType === 'ordinal'}, ${arms(el.options, hoisted, own)}${rules})`;\n    }\n    case TYPE.tag:\n      return `h.t(a, ${JSON.stringify(el.value)}, ${nodes(el.children, hoisted, pound)})`;\n    default:\n      throw new Error(`prosebook: no compiler for ICU element type ${(el as MessageFormatElement).type}`);\n  }\n}\n\nfunction message(ast: MessageFormatElement[], hoisted: Hoisted): string {\n  const literal = staticLiteral(ast);\n  if (literal !== undefined) return JSON.stringify(literal);\n  return `(a, h) => ${nodes(ast, hoisted, null)}`;\n}\n\nexport interface CompiledLocale {\n  /** `const oN = {…};` lines the messages refer to. */\n  declarations: string[];\n  /** `\"key\": message,` lines. */\n  rows: string[];\n}\n\n/** One locale's messages as code, keeping only `keep` when given. */\nexport function compileLocale(entries: Iterable<Entry>, keep?: (key: string) => boolean): CompiledLocale {\n  const hoisted = new Hoisted();\n  const rows: string[] = [];\n  for (const [key, ast] of entries) {\n    if (keep && !keep(key)) continue;\n    rows.push(`  ${JSON.stringify(key)}: ${message(ast, hoisted)},`);\n  }\n  return { declarations: hoisted.declarations(), rows };\n}\n\n/** The locale as an ES module whose default export is its messages. */\nexport function localeModule(compiled: CompiledLocale, banner: string, ts: boolean): string {\n  const head = ts ? `${banner}\\nimport type { CompiledMessages } from 'prosebook';\\n` : `${banner}\\n`;\n  // `as const` keeps `style: \"currency\"` a literal, which is what `Intl`'s option types ask for.\n  const declarations = ts ? compiled.declarations.map((d) => d.replace(/;$/, ' as const;')) : compiled.declarations;\n  const consts = declarations.length > 0 ? `\\n${declarations.join('\\n')}\\n` : '';\n  const close = ts ? '} satisfies CompiledMessages;' : '};';\n  return `${head}${consts}\\nexport default {\\n${compiled.rows.join('\\n')}\\n${close}\\n`;\n}\n\n/** The locale as one expression, for a bundler to inline in place of the module. */\nexport function localeExpression(compiled: CompiledLocale): string {\n  return `(() => {\\n${compiled.declarations.join('\\n')}\\nreturn {\\n${compiled.rows.join('\\n')}\\n};\\n})()`;\n}\n","/**\n * What the code says: text a person reads that is still written in a component, and which catalog\n * keys the code names.\n *\n * Key references are found by reading string literals, not by tracing calls, so a key kept in an\n * array or a map still counts, and `nav.${id}` or `'nav.' + id` keeps every key under `nav.`. That\n * errs towards keeping a key, which is the safe direction both for `unused` and for pruning a bundle.\n */\nimport { readdirSync, readFileSync, statSync } from 'node:fs';\nimport { extname, join, relative } from 'node:path';\n\nimport { parseSync } from 'oxc-parser';\n\nconst SKIP_DIRS = new Set(['node_modules', 'dist', 'build', 'out', 'coverage', '.git']);\n\nexport function sourceFiles(dirs: string[], extensions: string[], skip: string[] = []): string[] {\n  const files: string[] = [];\n  const visit = (dir: string) => {\n    let names: string[];\n    try {\n      names = readdirSync(dir);\n    } catch {\n      return;\n    }\n    for (const name of names) {\n      const path = join(dir, name);\n      if (skip.some((s) => path === s || path.startsWith(`${s}/`) || path.startsWith(`${s}\\\\`))) continue;\n      if (statSync(path).isDirectory()) {\n        if (!SKIP_DIRS.has(name) && !name.startsWith('.')) visit(path);\n      } else if (extensions.includes(extname(name)) && !name.endsWith('.d.ts')) {\n        files.push(path);\n      }\n    }\n  };\n  for (const dir of dirs) visit(dir);\n  return files.sort();\n}\n\nexport interface KeyRefs {\n  exact: Set<string>;\n  /** `nav.` from `nav.${id}` or `'nav.' + id`: every key under it may be read. */\n  prefixes: Set<string>;\n}\n\nconst LITERAL_KEY = /(['\"`])([a-z0-9][\\w-]*(?:\\.[\\w-]+)+)\\1/g;\nconst KEY_PREFIX = /(['\"`])([a-z0-9][\\w-]*(?:\\.[\\w-]+)*\\.)(?:\\1|\\$\\{)/g;\n\nexport function keyRefs(code: string, into: KeyRefs = { exact: new Set(), prefixes: new Set() }): KeyRefs {\n  for (const m of code.matchAll(LITERAL_KEY)) into.exact.add(m[2]!);\n  for (const m of code.matchAll(KEY_PREFIX)) into.prefixes.add(m[2]!);\n  return into;\n}\n\nexport function isReferenced(key: string, refs: KeyRefs): boolean {\n  if (refs.exact.has(key)) return true;\n  for (const prefix of refs.prefixes) if (key.startsWith(prefix)) return true;\n  return false;\n}\n\nexport interface Hardcoded {\n  file: string;\n  line: number;\n  column: number;\n  text: string;\n  /** Where it sits: `text`, or the attribute it is the value of. */\n  where: string;\n}\n\ntype Node = { type: string; start: number; end: number; [field: string]: unknown };\n\n/**\n * Text that reads as code rather than prose: one token holding a path, a call, an identifier with an\n * underscore or a dotted name, as in `form.json()` or `src/index.ts`. Trailing punctuation doesn't\n * count, so `Done.` is still prose.\n */\nexport function looksLikeCode(text: string): boolean {\n  const token = text.trim().replace(/[.!?:,…]+$/, '');\n  return token !== '' && !/\\s/.test(token) && /[/()_=<>{}[\\].]|::/.test(token);\n}\n\nconst NON_PROSE_ELEMENTS = new Set(['code', 'pre', 'kbd', 'samp', 'script', 'style', 'svg', 'path']);\nconst LETTER = /\\p{L}/u;\n\n/** Offsets in `code` as lines and columns, and whether a line is marked `prosebook-ignore`, on it or the line above. */\nfunction lineIndex(code: string) {\n  const lines = code.split('\\n');\n  const lineStarts: number[] = [];\n  let offset = 0;\n  for (const line of lines) {\n    lineStarts.push(offset);\n    offset += line.length + 1;\n  }\n  const position = (at: number) => {\n    let lo = 0;\n    let hi = lineStarts.length - 1;\n    while (lo < hi) {\n      const mid = (lo + hi + 1) >> 1;\n      if (lineStarts[mid]! <= at) lo = mid;\n      else hi = mid - 1;\n    }\n    return { line: lo + 1, column: at - lineStarts[lo]! + 1 };\n  };\n  const ignored = (line: number) =>\n    (lines[line - 1] ?? '').includes('prosebook-ignore') || (lines[line - 2] ?? '').includes('prosebook-ignore');\n  return { position, ignored };\n}\n\n/** Literal text in JSX that a person reads, where it should be a catalog entry. */\nexport function hardcodedText(file: string, code: string, attributes: string[]): Hardcoded[] {\n  const { program } = parseSync(file, code);\n  const found: Hardcoded[] = [];\n  const { position, ignored } = lineIndex(code);\n  const report = (node: Node, text: string, where: string) => {\n    const trimmed = text.replace(/\\s+/g, ' ').trim();\n    if (!LETTER.test(trimmed) || looksLikeCode(trimmed)) return;\n    const at = position(node.start + Math.max(0, code.slice(node.start, node.end).search(/\\S/)));\n    if (ignored(at.line)) return;\n    found.push({ file, ...at, text: trimmed, where });\n  };\n\n  const visit = (node: Node, inProse: boolean) => {\n    let prose = inProse;\n    if (node.type === 'JSXElement') {\n      const opening = node.openingElement as Node & { name: Node & { name?: string } };\n      if (opening.name.type === 'JSXIdentifier' && NON_PROSE_ELEMENTS.has(opening.name.name ?? '')) prose = false;\n    }\n    if (node.type === 'JSXText' && prose) report(node, node.value as string, 'text');\n    if (node.type === 'JSXExpressionContainer' && prose) {\n      const expr = node.expression as Node;\n      if (expr.type === 'Literal' && typeof expr.value === 'string') report(expr, expr.value, 'text');\n      if (expr.type === 'TemplateLiteral' && (expr.expressions as Node[]).length === 0)\n        report(expr, String((expr.quasis as { value: { cooked: string } }[])[0]?.value.cooked), 'text');\n    }\n    if (node.type === 'JSXAttribute') {\n      const name = node.name as Node & { name?: string };\n      const value = node.value as Node | null;\n      const attr = name.type === 'JSXIdentifier' ? (name.name ?? '') : '';\n      if (attributes.includes(attr) && value !== null) {\n        if (value.type === 'Literal' && typeof value.value === 'string') report(value, value.value, attr);\n        if (value.type === 'JSXExpressionContainer') {\n          const expr = value.expression as Node;\n          if (expr.type === 'Literal' && typeof expr.value === 'string') report(expr, expr.value, attr);\n        }\n      }\n      return;\n    }\n    for (const value of Object.values(node)) {\n      if (Array.isArray(value)) {\n        for (const child of value) if (isNode(child)) visit(child, prose);\n      } else if (isNode(value)) {\n        visit(value, prose);\n      }\n    }\n  };\n  visit(program as unknown as Node, true);\n  return found;\n}\n\nfunction isNode(value: unknown): value is Node {\n  return typeof value === 'object' && value !== null && typeof (value as Node).type === 'string';\n}\n\nexport interface ScanResult {\n  hardcoded: Hardcoded[];\n  refs: KeyRefs;\n  files: number;\n}\n\nexport function scan(dirs: string[], extensions: string[], attributes: string[], root: string, skip: string[] = []): ScanResult {\n  const refs: KeyRefs = { exact: new Set(), prefixes: new Set() };\n  const hardcoded: Hardcoded[] = [];\n  const files = sourceFiles(dirs, extensions, skip);\n  for (const path of files) {\n    const code = readFileSync(path, 'utf8');\n    keyRefs(code, refs);\n    if (/\\.[jt]sx$/.test(path)) hardcoded.push(...hardcodedText(relative(root, path).replaceAll('\\\\', '/'), code, attributes));\n  }\n  return { hardcoded, refs, files: files.length };\n}\n\n/** A copy's methods that take a key first. */\nexport const READERS = new Set(['t', 'rich']);\n\nexport interface UnseenRead {\n  file: string;\n  line: number;\n  column: number;\n  /** The read as written, on one line. */\n  code: string;\n  /** What it calls: a reader, the name it was imported by, or `Text`. */\n  name: string;\n}\n\nexport interface Reads {\n  /** Reads whose key a build can't see, in calls that may be to a copy's `t` or `rich`. */\n  unseen: UnseenRead[];\n  /** Names a copy's readers are bound to here, as in `const { rich: tRich } = copy`. */\n  aliases: Set<string>;\n}\n\nconst PREFIX = /^[a-z0-9][\\w-]*(?:\\.[\\w-]+)*\\.$/;\nconst WRAPPERS = new Set(['ParenthesizedExpression', 'TSAsExpression', 'TSSatisfiesExpression', 'TSNonNullExpression', 'TSTypeAssertion']);\n\n/** Whether `keyRefs` finds every key an expression can be: a literal, or a template or sum after a key prefix. */\nfunction keySeen(node: Node | undefined): boolean {\n  if (node === undefined) return false;\n  if (WRAPPERS.has(node.type)) return keySeen(node.expression as Node);\n  switch (node.type) {\n    case 'Literal':\n      return typeof node.value === 'string';\n    case 'TemplateLiteral': {\n      const [head] = node.quasis as { value: { cooked: string | null } }[];\n      return (node.expressions as Node[]).length === 0 || PREFIX.test(head?.value.cooked ?? '');\n    }\n    case 'BinaryExpression': {\n      const left = node.left as Node;\n      return node.operator === '+' && left.type === 'Literal' && typeof left.value === 'string' && PREFIX.test(left.value);\n    }\n    case 'ConditionalExpression':\n      return keySeen(node.consequent as Node) && keySeen(node.alternate as Node);\n    case 'LogicalExpression':\n      return keySeen(node.left as Node) && keySeen(node.right as Node);\n    default:\n      return false;\n  }\n}\n\nconst nameOf = (node: Node | undefined): string | undefined =>\n  node?.type === 'Identifier' || node?.type === 'JSXIdentifier'\n    ? (node.name as string)\n    : node?.type === 'Literal'\n      ? String(node.value)\n      : undefined;\n\n/**\n * The reads in a module whose key a pruned build can't see, as in `t(item.key)` or `<Text id={id} />`:\n * the build would leave the message out, and the key would show in its place. A build has no types,\n * so readers are known by name: `t` and `rich` called alone or as methods, and any name imported here,\n * which may be bound to one elsewhere (`aliases`); the caller keeps those whose name turns out to be a\n * reader. `<Text>` counts where it is imported from `prosebook/react`. Lines marked `prosebook-ignore`\n * are skipped.\n */\nexport function unseenReads(file: string, code: string): Reads {\n  const { program } = parseSync(file, code);\n  const { position, ignored } = lineIndex(code);\n  const unseen: UnseenRead[] = [];\n  const aliases = new Set<string>();\n  /** Local name to the name it was imported by. */\n  const imported = new Map<string, string>();\n  const texts = new Set<string>();\n  for (const statement of (program as unknown as Node).body as Node[]) {\n    if (statement.type !== 'ImportDeclaration') continue;\n    for (const s of statement.specifiers as Node[]) {\n      const name = s.type === 'ImportSpecifier' ? nameOf(s.imported as Node) : undefined;\n      const local = nameOf(s.local as Node);\n      if (name === undefined || local === undefined) continue;\n      if (name === 'Text' && (statement.source as Node).value === 'prosebook/react') texts.add(local);\n      else imported.set(local, name);\n    }\n  }\n  const report = (node: Node, name: string) => {\n    const at = position(node.start);\n    if (ignored(at.line)) return;\n    const text = code.slice(node.start, node.end).replace(/\\s+/g, ' ');\n    unseen.push({ file, ...at, name, code: text.length > 80 ? `${text.slice(0, 77)}...` : text });\n  };\n  // Calls by a plain name, kept until every alias in the module is known.\n  const calls: [Node, string][] = [];\n  const visit = (node: Node) => {\n    if (node.type === 'ObjectPattern') {\n      for (const p of node.properties as Node[]) {\n        if (p.type === 'Property' && READERS.has(nameOf(p.key as Node) ?? '') && (p.value as Node).type === 'Identifier')\n          aliases.add(nameOf(p.value as Node)!);\n      }\n    }\n    if (node.type === 'CallExpression' && !keySeen((node.arguments as Node[])[0])) {\n      const callee = node.callee as Node;\n      if (callee.type === 'Identifier') calls.push([node, callee.name as string]);\n      else if (callee.type === 'MemberExpression' && !callee.computed && READERS.has(nameOf(callee.property as Node) ?? ''))\n        report(node, nameOf(callee.property as Node)!);\n    }\n    if (node.type === 'JSXOpeningElement' && texts.has(nameOf(node.name as Node) ?? '')) {\n      const id = (node.attributes as Node[]).find((a) => a.type === 'JSXAttribute' && nameOf(a.name as Node) === 'id');\n      const value = id?.value as Node | null | undefined;\n      if (value !== null && value !== undefined && !keySeen(value.type === 'JSXExpressionContainer' ? (value.expression as Node) : value))\n        report(node, 'Text');\n    }\n    for (const value of Object.values(node)) {\n      if (Array.isArray(value)) {\n        for (const child of value) if (isNode(child)) visit(child);\n      } else if (isNode(value)) {\n        visit(value);\n      }\n    }\n  };\n  visit(program as unknown as Node);\n  for (const [node, local] of calls) {\n    if (READERS.has(local) || aliases.has(local)) report(node, local);\n    else if (imported.has(local)) report(node, imported.get(local)!);\n  }\n  unseen.sort((a, b) => (a.line === b.line ? a.column - b.column : a.line - b.line));\n  return { unseen, aliases };\n}\n"],"mappings":"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"}

package/dist/tools.d.ts

@@ -1,18 +1,61 @@
-import { A as sentences, B as EntryLocation, C as RuleContext, D as definePlugin, E as compileRule, F as KindRule, G as entryLocation, H as Message, I as STRICT_LISTS, J as whereOf, K as loadCatalog, L as Severity, M as words, N as DEFAULT_KINDS, O as lint, P as DEFAULT_SURFACES, R as Catalog, S as Rule, T as applyEdits, U as Problem, V as KEY_PATTERN, W as Translation, Y as MessageFormatElement, _ as HOLE, b as Readings, c as resolveConfig, d as CheckRule, f as ConditionalRule, g as Finding, h as ExistenceRule, i as ResolvedConfig, j as singularOf, k as phrase, l as CORE_RULES, m as Edit, o as defineConfig, p as CoreRule, q as previewOf, r as ProsebookConfig, s as loadConfig, u as CapitalizationRule, v as OccurrenceRule, w as SubstitutionRule, x as Report, y as Plugin, z as CatalogError } from "./config-CF7HziDa.js";
-import "@formatjs/icu-messageformat-parser";
-type Entry = readonly [key: string, ast: MessageFormatElement[]];
-interface CompiledLocale {
-  /** `const oN = {…};` lines the messages refer to. */
-  declarations: string[];
-  /** `"key": message,` lines. */
-  rows: string[];
+import { $ as loadCatalog, A as RuleContext, B as DEFAULT_KINDS, C as Finding, D as Readings, E as Plugin, F as lint, G as Catalog, H as KindRule, I as phrase, J as KEY_PATTERN, K as CatalogError, L as sentences, M as applyEdits, N as compileRule, O as Report, P as definePlugin, Q as entryLocation, R as singularOf, S as ExistenceRule, T as OccurrenceRule, U as STRICT_LISTS, V as DEFAULT_SURFACES, W as Severity, X as Problem, Y as Message, Z as Translation, _ as CapitalizationRule, a as ResolvedConfig, b as CoreRule, c as loadConfig, d as Mf2Function, et as previewOf, f as intlDate, g as CORE_RULES, h as toMf2, i as ProsebookConfig, j as SubstitutionRule, k as Rule, l as resolveConfig, m as parseMf2, nt as MessageFormatElement, p as intlNumber, q as EntryLocation, r as NativeTarget, s as defineConfig, tt as whereOf, u as Isolate, v as CheckRule, w as HOLE, x as Edit, y as ConditionalRule, z as words } from "./config-DdMkKt_N.js";
+import { a as localeModule, i as localeExpression, n as Entry, r as compileLocale, t as CompiledLocale } from "./compile-xF3F4oIp.js";
+export declare function sourceFiles(dirs: string[], extensions: string[], skip?: string[]): string[];
+interface KeyRefs {
+  exact: Set<string>;
+  /** `nav.` from `nav.${id}` or `'nav.' + id`: every key under it may be read. */
+  prefixes: Set<string>;
+}
+export declare function keyRefs(code: string, into?: KeyRefs): KeyRefs;
+export declare function isReferenced(key: string, refs: KeyRefs): boolean;
+interface Hardcoded {
+  file: string;
+  line: number;
+  column: number;
+  text: string;
+  /** Where it sits: `text`, or the attribute it is the value of. */
+  where: string;
 }
-/** One locale's messages as code, keeping only `keep` when given. */
-export declare function compileLocale(entries: Iterable<Entry>, keep?: (key: string) => boolean): CompiledLocale;
-/** The locale as an ES module whose default export is its messages. */
-export declare function localeModule(compiled: CompiledLocale, banner: string, ts: boolean): string;
-/** The locale as one expression, for a bundler to inline in place of the module. */
-export declare function localeExpression(compiled: CompiledLocale): string;
+/**
+ * Text that reads as code rather than prose: one token holding a path, a call, an identifier with an
+ * underscore or a dotted name, as in `form.json()` or `src/index.ts`. Trailing punctuation doesn't
+ * count, so `Done.` is still prose.
+ */
+export declare function looksLikeCode(text: string): boolean;
+/** Literal text in JSX that a person reads, where it should be a catalog entry. */
+export declare function hardcodedText(file: string, code: string, attributes: string[]): Hardcoded[];
+interface ScanResult {
+  hardcoded: Hardcoded[];
+  refs: KeyRefs;
+  files: number;
+}
+export declare function scan(dirs: string[], extensions: string[], attributes: string[], root: string, skip?: string[]): ScanResult;
+/** A copy's methods that take a key first. */
+export declare const READERS: Set<string>;
+interface UnseenRead {
+  file: string;
+  line: number;
+  column: number;
+  /** The read as written, on one line. */
+  code: string;
+  /** What it calls: a reader, the name it was imported by, or `Text`. */
+  name: string;
+}
+interface Reads {
+  /** Reads whose key a build can't see, in calls that may be to a copy's `t` or `rich`. */
+  unseen: UnseenRead[];
+  /** Names a copy's readers are bound to here, as in `const { rich: tRich } = copy`. */
+  aliases: Set<string>;
+}
+/**
+ * The reads in a module whose key a pruned build can't see, as in `t(item.key)` or `<Text id={id} />`:
+ * the build would leave the message out, and the key would show in its place. A build has no types,
+ * so readers are known by name: `t` and `rich` called alone or as methods, and any name imported here,
+ * which may be bound to one elsewhere (`aliases`); the caller keeps those whose name turns out to be a
+ * reader. `<Text>` counts where it is imported from `prosebook/react`. Lines marked `prosebook-ignore`
+ * are skipped.
+ */
+export declare function unseenReads(file: string, code: string): Reads;
 interface Extraction {
   file: string;
   line: number;
@@ -143,6 +186,21 @@ export declare function applyFixes(config: ResolvedConfig, catalog: Catalog, fin
   fixed: number;
   problems: Problem[];
 };
+interface Imported {
+  /** Keys whose translation was written. */
+  written: string[];
+  /** Keys given back as they were: each still holds, so a stale one can be accepted. */
+  unchanged: string[];
+  /** What was left out, and why. The rest was written regardless. */
+  problems: Problem[];
+}
+/**
+ * Translations into `locale` from `prosebook todo`'s YAML filled in, by a person or a model, each
+ * written to the file its locale and area put it in. Text around a fenced block is left aside, as a
+ * model's reply has it, and an empty value is one left for later. An entry that would break the
+ * catalog is left out with its problem, so a reply with one bad entry still lands the others.
+ */
+export declare function importTranslations(config: ResolvedConfig, locale: string, reply: string): Imported;
 interface Lock {
   version: 2;
   /** Source text by hash: every text some translation is anchored to. */
@@ -163,6 +221,8 @@ interface StaleTranslation {
   /** The translation, made from `was`. */
   translation: string;
 }
+/** What changed in the source of a stale translation, as a word diff, or why that isn't known. */
+export declare function changeOf(stale: StaleTranslation): string;
 interface Reconciled {
   lock: Lock;
   /** Per locale, per key: the translations made from a source that has changed since. */
@@ -211,24 +271,6 @@ export declare function wordDiff(before: string, after: string): DiffPart[];
 export declare function formatDiff(parts: DiffPart[]): string;
 export declare function pseudoText(text: string): string;
 export declare function pseudoAst(ast: MessageFormatElement[]): MessageFormatElement[];
-type Element$1 = MessageFormatElement;
-/** A function as written: `:number minimumFractionDigits=2`. Kept on the styles it produces, to write back. */
-interface Mf2Function {
-  name: string;
-  options: Record<string, string>;
-}
-/** An MF2 message as the element tree. Throws, with the fix, where it can't be read or compiled. */
-export declare function parseMf2(text: string, locale: string): Element$1[];
-/** The `Intl.NumberFormat` options a numeric function formats with. */
-export declare function intlNumber(fn: Mf2Function): Intl.NumberFormatOptions;
-/**
- * The `Intl.DateTimeFormat` options a date or time function formats with. MF2's date and time
- * functions are still a draft; this follows the spec's semantic options as the `messageformat`
- * package does, so a message reads the same in both.
- */
-export declare function intlDate(fn: Mf2Function): Intl.DateTimeFormatOptions;
-/** A message tree as MF2 text. Throws, saying what has no MF2 equivalent, where it can't be written. */
-export declare function toMf2(ast: Element$1[], locale: string): string;
 type Element = MessageFormatElement;
 export declare function toMf1(ast: Element[]): string;
 type MessageFormatVersion = 1 | 2;
@@ -237,7 +279,7 @@ export declare const SYNTAX_NAME: Record<MessageFormatVersion, string>;
  * A message as the element tree. MF2 is read per locale: which variants a value can reach depends
  * on the locale's plural rules (see `matchTree` in mf2.ts).
  */
-export declare function readMessage(version: MessageFormatVersion, text: string, locale: string): MessageFormatElement[];
+export declare function readMessage(version: MessageFormatVersion, text: string, locale: string, isolate?: Isolate): MessageFormatElement[];
 /** A tree as text in the given syntax. Throws, saying what the syntax can't express, where it can't. */
 export declare function writeMessage(version: MessageFormatVersion, ast: MessageFormatElement[], locale: string): string;
 interface Located {
@@ -292,6 +334,13 @@ interface TypeOracle {
 export declare function typescriptOracle(root: string, files: readonly string[]): Promise<TypeOracle | undefined>;
 /** The kind an expression's syntax gives away, where it does: `items.length`, `a * b`, `new Date()`. */
 export declare function syntaxKind(expr: Node): ValueKind | undefined;
+interface Todo {
+  /** How many entries want a translation. */
+  count: number;
+  /** The entries as YAML, by area, with the prompt first when one was asked for. */
+  text: string;
+}
+export declare function todoOf(config: ResolvedConfig, catalog: Catalog, stale: ReadonlyMap<string, StaleTranslation>, locale: string, prompt?: boolean): Todo;
 interface SarifResult {
   /** A rule the report describes, or one of a lint plugin's. */
   rule: string;
@@ -317,35 +366,5 @@ export declare class SarifReport {
   add(result: SarifResult): void;
   toJSON(root: string, tool: SarifTool): object;
 }
-export declare function sourceFiles(dirs: string[], extensions: string[], skip?: string[]): string[];
-interface KeyRefs {
-  exact: Set<string>;
-  /** `nav.` from `nav.${id}` or `'nav.' + id`: every key under it may be read. */
-  prefixes: Set<string>;
-}
-export declare function keyRefs(code: string, into?: KeyRefs): KeyRefs;
-export declare function isReferenced(key: string, refs: KeyRefs): boolean;
-interface Hardcoded {
-  file: string;
-  line: number;
-  column: number;
-  text: string;
-  /** Where it sits: `text`, or the attribute it is the value of. */
-  where: string;
-}
-/**
- * Text that reads as code rather than prose: one token holding a path, a call, an identifier with an
- * underscore or a dotted name, as in `form.json()` or `src/index.ts`. Trailing punctuation doesn't
- * count, so `Done.` is still prose.
- */
-export declare function looksLikeCode(text: string): boolean;
-/** Literal text in JSX that a person reads, where it should be a catalog entry. */
-export declare function hardcodedText(file: string, code: string, attributes: string[]): Hardcoded[];
-interface ScanResult {
-  hardcoded: Hardcoded[];
-  refs: KeyRefs;
-  files: number;
-}
-export declare function scan(dirs: string[], extensions: string[], attributes: string[], root: string, skip?: string[]): ScanResult;
-export { CORE_RULES, type CapitalizationRule, type Catalog, CatalogError, type CheckRule, type CompiledLocale, type ConditionalRule, type CoreRule, DEFAULT_KINDS, DEFAULT_SURFACES, type DiffPart, type Edit, type Entry, type EntryEdit, type EntryFields, type EntryFinding, type EntryLocation, type EntryView, type EntryYaml, type ExistenceRule, type ExtractPlan, type Extraction, type FilePlan, type Finding, type Generated, HOLE, type Hardcoded, KEY_PATTERN, type KeyRefs, type KindRule, type Lock, type Message, type MessageFormatVersion, type Mf2Function, type MigratePlan, type NewEntry, type OccurrenceRule, type Plugin, type Problem, type ProsebookConfig, type Readings, type Report, type ResolvedConfig, type Rule, type RuleContext, STRICT_LISTS, type SarifResult, type SarifTool, type Severity, type Span, type StaleTranslation, type SubstitutionRule, type Translation, type TypeOracle, type ValueKind, applyEdits, compileRule, defineConfig, definePlugin, entryLocation, lint, loadCatalog, loadConfig, phrase, previewOf, resolveConfig, sentences, singularOf, whereOf, words };
+export { CORE_RULES, type CapitalizationRule, type Catalog, CatalogError, type CheckRule, type CompiledLocale, type ConditionalRule, type CoreRule, DEFAULT_KINDS, DEFAULT_SURFACES, type DiffPart, type Edit, type Entry, type EntryEdit, type EntryFields, type EntryFinding, type EntryLocation, type EntryView, type EntryYaml, type ExistenceRule, type ExtractPlan, type Extraction, type FilePlan, type Finding, type Generated, HOLE, type Hardcoded, type Imported, type Isolate, KEY_PATTERN, type KeyRefs, type KindRule, type Lock, type Message, type MessageFormatVersion, type Mf2Function, type MigratePlan, type NativeTarget, type NewEntry, type OccurrenceRule, type Plugin, type Problem, type ProsebookConfig, type Readings, type Reads, type Report, type ResolvedConfig, type Rule, type RuleContext, STRICT_LISTS, type SarifResult, type SarifTool, type Severity, type Span, type StaleTranslation, type SubstitutionRule, type Todo, type Translation, type TypeOracle, type UnseenRead, type ValueKind, applyEdits, compileLocale, compileRule, defineConfig, definePlugin, entryLocation, intlDate, intlNumber, lint, loadCatalog, loadConfig, localeExpression, localeModule, parseMf2, phrase, previewOf, resolveConfig, sentences, singularOf, toMf2, whereOf, words };
 //# sourceMappingURL=tools.d.ts.map