prosebook 0.1.0 → 0.2.0

package/dist/{scan-B0tZ7y-D.js → scan-Ch2BfIUD.js}

@@ -1,4 +1,4 @@
-import { C as numberOptions, D as walk, E as tagsOf, S as formatsOf, T as staticLiteral, b as dateOptions, p as lint, u as applyEdits, v as TYPE$1, w as parseMessage$1, x as formatProblems, y as argsOf } from "./config-CxVMn19f.js";
+import { C as numberOptions, D as walk, E as tagsOf, S as formatsOf, T as staticLiteral, b as dateOptions, p as lint, u as applyEdits, v as TYPE$1, w as parseMessage$1, x as formatProblems, y as argsOf } from "./config-D--RITk2.js";
 import { dirname, extname, join, relative, resolve } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { LineCounter, Scalar, isMap, isScalar, parse, parseDocument } from "yaml";
@@ -1569,7 +1569,8 @@ function previewOf(message) {
 *
 * 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`. Formatting options are resolved here and
+* arm, a number is a call to a cached `Intl.NumberFormat`. One that calls no helper is `(a) => …`, so
+* the generated TypeScript passes `noUnusedParameters`. Formatting options are resolved here and
 * hoisted to module constants, so a skeleton costs nothing at runtime and its formatter is built once.
 */
 /** Module-level constants for formatting options, one per distinct object. */
@@ -1615,9 +1616,18 @@ function node(el, hoisted, pound) {
 		default: throw new Error(`prosebook: no compiler for ICU element type ${el.type}`);
 	}
 }
+/** Whether the message calls a helper: everything but literals and plain placeholders does. */
+function usesHelpers(ast) {
+	let uses = false;
+	walk(ast, (el) => {
+		if (el.type !== TYPE$1.literal && el.type !== TYPE$1.argument) uses = true;
+	});
+	return uses;
+}
 function message(ast, hoisted) {
 	const literal = staticLiteral(ast);
-	return literal === void 0 ? `(a, h) => ${nodes(ast, hoisted, null)}` : JSON.stringify(literal);
+	if (literal !== void 0) return JSON.stringify(literal);
+	return `(${usesHelpers(ast) ? "a, h" : "a"}) => ${nodes(ast, hoisted, null)}`;
 }
 /** One locale's messages as code, keeping only `keep` when given. */
 function compileLocale(entries, keep) {
@@ -2143,67 +2153,69 @@ function catalogLiteral(config, locales, ext) {
 }
 /** The JSON Schema an editor reads to complete and explain catalog entries. */
 function catalogSchema(config) {
+	const shorthand = {
+		type: "string",
+		description: `The message, in ${SYNTAX_NAME[config.messageFormat]}, with nothing said about it.`
+	};
+	const entry = {
+		type: "object",
+		required: [config.source, ...config.require],
+		additionalProperties: false,
+		properties: {
+			[config.source]: {
+				type: "string",
+				description: `The message, in ${SYNTAX_NAME[config.messageFormat]}.`
+			},
+			kind: {
+				description: "What sort of string it is.",
+				oneOf: Object.entries(config.kinds).map(([k, r]) => ({
+					const: k,
+					description: r.doc
+				}))
+			},
+			surface: {
+				description: "Where the string sits.",
+				oneOf: Object.entries(config.surfaces).map(([k, d]) => ({
+					const: k,
+					description: d
+				}))
+			},
+			context: {
+				type: "string",
+				description: "One sentence telling a translator where the string appears and what it answers to."
+			},
+			args: {
+				type: "object",
+				description: "What each placeholder holds.",
+				additionalProperties: { type: "string" }
+			},
+			fragment: {
+				type: "boolean",
+				description: "Completes something beside it rather than standing as a sentence."
+			},
+			comment: {
+				type: "string",
+				description: "A change asked of whoever edits the entry next. Make it, then delete the comment."
+			},
+			remove: {
+				type: "boolean",
+				description: "Asks for the entry to go: delete it, its translations and the code that reads it."
+			},
+			allow: {
+				type: "object",
+				description: "Lint rules this entry is exempt from, each with the reason.",
+				propertyNames: { enum: Object.keys(config.lint.rules) },
+				additionalProperties: { type: "string" }
+			}
+		}
+	};
 	return {
 		$schema: "https://json-schema.org/draft/2020-12/schema",
 		title: "prosebook catalog",
 		description: "Generated by `prosebook generate` from the config. Do not edit.",
 		type: "object",
 		propertyNames: { pattern: "^[a-z0-9]+(?:[-_][a-z0-9]+)*(?:\\.[a-z0-9]+(?:[-_][a-z0-9]+)*)+$" },
-		additionalProperties: { oneOf: [{
-			type: "string",
-			description: `The message, in ${SYNTAX_NAME[config.messageFormat]}, with nothing said about it.`
-		}, {
-			type: "object",
-			required: [config.source, ...config.require],
-			additionalProperties: false,
-			properties: {
-				[config.source]: {
-					type: "string",
-					description: `The message, in ${SYNTAX_NAME[config.messageFormat]}.`
-				},
-				kind: {
-					description: "What sort of string it is.",
-					oneOf: Object.entries(config.kinds).map(([k, r]) => ({
-						const: k,
-						description: r.doc
-					}))
-				},
-				surface: {
-					description: "Where the string sits.",
-					oneOf: Object.entries(config.surfaces).map(([k, d]) => ({
-						const: k,
-						description: d
-					}))
-				},
-				context: {
-					type: "string",
-					description: "One sentence telling a translator where the string appears and what it answers to."
-				},
-				args: {
-					type: "object",
-					description: "What each placeholder holds.",
-					additionalProperties: { type: "string" }
-				},
-				fragment: {
-					type: "boolean",
-					description: "Completes something beside it rather than standing as a sentence."
-				},
-				comment: {
-					type: "string",
-					description: "A change asked of whoever edits the entry next. Make it, then delete the comment."
-				},
-				remove: {
-					type: "boolean",
-					description: "Asks for the entry to go: delete it, its translations and the code that reads it."
-				},
-				allow: {
-					type: "object",
-					description: "Lint rules this entry is exempt from, each with the reason.",
-					propertyNames: { enum: Object.keys(config.lint.rules) },
-					additionalProperties: { type: "string" }
-				}
-			}
-		}] }
+		additionalProperties: config.require.length === 0 ? { oneOf: [shorthand, entry] } : entry
 	};
 }
 /** Everything `generate` writes, in memory. */
@@ -2352,10 +2364,8 @@ const NON_PROSE_ELEMENTS = /* @__PURE__ */ new Set([
 	"path"
 ]);
 const LETTER = /\p{L}/u;
-/** 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 = [];
+/** 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;
@@ -2377,6 +2387,16 @@ function hardcodedText(file, code, attributes) {
 		};
 	};
 	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;
@@ -2442,6 +2462,100 @@ function scan(dirs, extensions, attributes, root, skip = []) {
 		files: files.length
 	};
 }
-export { loadCatalog as A, toMf1 as B, compileLocale as C, KEY_PATTERN as D, CatalogError as E, writeMessage as F, intlDate as I, intlNumber as L, whereOf as M, SYNTAX_NAME as N, entryLocation as O, readMessage as P, parseMf2 as R, readEntry as S, localeModule as T, readLock as _, scan as a, applyFixes as b, generate as c, render as d, writeFiles as f, hash as g, emptyLock as h, looksLikeCode as i, previewOf as j, entryLocator as k, localeEntries as l, pseudoText as m, isReferenced as n, sourceFiles as o, pseudoAst as p, keyRefs as r, catalogSchema as s, hardcodedText as t, localesOf as u, reconcile as v, localeExpression as w, editEntry as x, serializeLock as y, toMf2 as z };
+/** 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 { entryLocation as A, parseMf2 as B, editEntry as C, localeModule as D, localeExpression as E, SYNTAX_NAME as F, toMf1 as H, readMessage as I, writeMessage as L, loadCatalog as M, previewOf as N, CatalogError as O, whereOf as P, intlDate as R, applyFixes as S, compileLocale as T, toMf2 as V, emptyLock as _, looksLikeCode as a, reconcile as b, unseenReads as c, localeEntries as d, localesOf as f, pseudoText as g, pseudoAst as h, keyRefs as i, entryLocator as j, KEY_PATTERN as k, catalogSchema as l, writeFiles as m, hardcodedText as n, scan as o, render as p, isReferenced as r, sourceFiles as s, READERS as t, generate as u, hash as v, readEntry as w, serializeLock as x, readLock as y, intlNumber as z };
 
-//# sourceMappingURL=scan-B0tZ7y-D.js.map
+//# sourceMappingURL=scan-Ch2BfIUD.js.map