prosebook 0.1.0 → 0.3.0

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","names":["Edit","Element"],"sources":["../src/tools/compile.ts","../src/tools/extract.ts","../src/tools/entry.ts","../src/tools/lock.ts","../src/tools/generate.ts","../src/tools/diff.ts","../src/tools/pseudo.ts","../src/tools/mf2.ts","../src/tools/mf1.ts","../src/tools/syntax.ts","../src/tools/migrate.ts","../src/tools/types.ts","../src/tools/sarif.ts","../src/tools/scan.ts"],"mappings":"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"}
+{"version":3,"file":"tools.d.ts","names":["Edit"],"sources":["../src/tools/scan.ts","../src/tools/extract.ts","../src/tools/entry.ts","../src/tools/lock.ts","../src/tools/generate.ts","../src/tools/diff.ts","../src/tools/pseudo.ts","../src/tools/mf1.ts","../src/tools/syntax.ts","../src/tools/migrate.ts","../src/tools/types.ts","../src/tools/todo.ts","../src/tools/sarif.ts"],"mappings":"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"}

package/dist/tools.js

@@ -1,4 +1,5 @@
-import { A as loadCatalog, B as toMf1, C as compileLocale, D as KEY_PATTERN, E as CatalogError, F as writeMessage, I as intlDate, L as intlNumber, M as whereOf, N as SYNTAX_NAME, O as entryLocation, P as readMessage, R as parseMf2, S as readEntry, T as localeModule, _ as readLock, a as scan, b as applyFixes, c as generate, d as render, f as writeFiles, g as hash, h as emptyLock, i as looksLikeCode, j as previewOf, l as localeEntries, m as pseudoText, n as isReferenced, o as sourceFiles, p as pseudoAst, r as keyRefs, s as catalogSchema, t as hardcodedText, u as localesOf, v as reconcile, w as localeExpression, x as editEntry, y as serializeLock, z as toMf2 } from "./scan-B0tZ7y-D.js";
-import { a as wordDiff, c as draftPlurals, d as syntaxKind, f as typescriptOracle, i as formatDiff, l as planExtract, n as applyMigrate, o as applyExtract, r as planMigrate, s as areaOf, t as SarifReport, u as slugOf } from "./sarif-PkPvsB07.js";
-import { _ as words, a as DEFAULT_KINDS, c as CORE_RULES, d as compileRule, f as definePlugin, g as singularOf, h as sentences, i as resolveConfig, l as HOLE, m as phrase, n as defineConfig, o as DEFAULT_SURFACES, p as lint, r as loadConfig, s as STRICT_LISTS, u as applyEdits } from "./config-CxVMn19f.js";
-export { CORE_RULES, CatalogError, DEFAULT_KINDS, DEFAULT_SURFACES, HOLE, KEY_PATTERN, STRICT_LISTS, SYNTAX_NAME, SarifReport, applyEdits, applyExtract, applyFixes, applyMigrate, areaOf, catalogSchema, compileLocale, compileRule, defineConfig, definePlugin, draftPlurals, editEntry, emptyLock, entryLocation, formatDiff, generate, hardcodedText, hash, intlDate, intlNumber, isReferenced, keyRefs, lint, loadCatalog, loadConfig, localeEntries, localeExpression, localeModule, localesOf, looksLikeCode, parseMf2, phrase, planExtract, planMigrate, previewOf, pseudoAst, pseudoText, readEntry, readLock, readMessage, reconcile, render, resolveConfig, scan, sentences, serializeLock, singularOf, slugOf, sourceFiles, syntaxKind, toMf1, toMf2, typescriptOracle, whereOf, wordDiff, words, writeFiles, writeMessage };
+import { A as writeMessage, C as entryLocation, D as whereOf, E as previewOf, F as toMf1, M as intlNumber, N as parseMf2, O as SYNTAX_NAME, P as toMf2, S as KEY_PATTERN, T as loadCatalog, _ as applyFixes, a as render, b as readEntry, c as pseudoText, d as hash, f as readLock, g as wordDiff, h as formatDiff, i as localesOf, j as intlDate, k as readMessage, l as changeOf, m as serializeLock, n as generate, o as writeFiles, p as reconcile, r as localeEntries, s as pseudoAst, t as catalogSchema, u as emptyLock, v as editEntry, x as CatalogError, y as importTranslations } from "./generate-9pR3i5Bj.js";
+import { a as looksLikeCode, c as unseenReads, d as localeModule, i as keyRefs, l as compileLocale, n as hardcodedText, o as scan, r as isReferenced, s as sourceFiles, t as READERS, u as localeExpression } from "./scan-Bx0_yDSi.js";
+import { a as applyExtract, c as planExtract, d as typescriptOracle, i as planMigrate, l as slugOf, n as todoOf, o as areaOf, r as applyMigrate, s as draftPlurals, t as SarifReport, u as syntaxKind } from "./sarif-CWyTAQ0y.js";
+import { _ as words, a as DEFAULT_KINDS, c as CORE_RULES, d as compileRule, f as definePlugin, g as singularOf, h as sentences, i as resolveConfig, l as HOLE, m as phrase, n as defineConfig, o as DEFAULT_SURFACES, p as lint, r as loadConfig, s as STRICT_LISTS, u as applyEdits } from "./config-BPSmoYel.js";
+export { CORE_RULES, CatalogError, DEFAULT_KINDS, DEFAULT_SURFACES, HOLE, KEY_PATTERN, READERS, STRICT_LISTS, SYNTAX_NAME, SarifReport, applyEdits, applyExtract, applyFixes, applyMigrate, areaOf, catalogSchema, changeOf, compileLocale, compileRule, defineConfig, definePlugin, draftPlurals, editEntry, emptyLock, entryLocation, formatDiff, generate, hardcodedText, hash, importTranslations, intlDate, intlNumber, isReferenced, keyRefs, lint, loadCatalog, loadConfig, localeEntries, localeExpression, localeModule, localesOf, looksLikeCode, parseMf2, phrase, planExtract, planMigrate, previewOf, pseudoAst, pseudoText, readEntry, readLock, readMessage, reconcile, render, resolveConfig, scan, sentences, serializeLock, singularOf, slugOf, sourceFiles, syntaxKind, toMf1, toMf2, todoOf, typescriptOracle, unseenReads, whereOf, wordDiff, words, writeFiles, writeMessage };

package/dist/vite.d.ts

@@ -1,10 +1,20 @@
-import { r as ProsebookConfig } from "./config-CF7HziDa.js";
+import { t as Prune } from "./bundle-KD-DiiFa.js";
+import { i as ProsebookConfig } from "./config-DdMkKt_N.js";
 import { Plugin } from "vite";
 export interface ProsebookPluginOptions {
-  /** The config, inline. Without it, `prosebook.config.*` at the Vite root is read. */
+  /** The config, inline. Without it, `prosebook.config.*` at `root` is read. */
   config?: ProsebookConfig;
-  /** Ship only the messages the code names. On by default. */
-  prune?: boolean;
+  /**
+   * The folder the config's paths resolve from, and where its file is found: the Vite root when
+   * unset. Apps that share one catalog name its folder, so each build generates the same files.
+   */
+  root?: string;
+  /**
+   * Ship only the messages the code names. `strict`, the default, also fails the build on a read
+   * whose key it can't see, such as `t(item.key)`, which would show the key where its message was
+   * pruned. `loose` prunes without that check; `false` ships every message.
+   */
+  prune?: Prune;
   /** Keys a build always keeps, exactly or as `prefix.*`: for keys built at runtime from data. */
   keep?: string[];
   /** In dev, Alt-click a string on the page to open its entry in the editor. On by default. */

package/dist/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","names":[],"sources":["../src/vite.ts"],"mappings":";;iBA2BiB;;EAEf,SAAS;;EAET;;EAEA;;EAEA;;wBA6Bc,UAAU,UAAS,yBAA8B"}
+{"version":3,"file":"vite.d.ts","names":[],"sources":["../src/vite.ts"],"mappings":";;;iBA8BiB;;EAEf,SAAS;;;;;EAKT;;;;;;EAMA,QAAQ;;EAER;;EAEA;;wBAcc,UAAU,UAAS,yBAA8B"}

package/dist/vite.js

@@ -1,6 +1,9 @@
-import { C as compileLocale, E as CatalogError, O as entryLocation, S as readEntry, c as generate, n as isReferenced, r as keyRefs, w as localeExpression, x as editEntry } from "./scan-B0tZ7y-D.js";
-import { r as loadConfig } from "./config-CxVMn19f.js";
-import { resolve } from "node:path";
+import { a as installInspector, d as unseenOf, i as hotLocale, n as HOT_SET, o as keeper, r as beside, t as HOT_INDEX, u as unseenMessage } from "./bundle-DboItAre.js";
+import { n as generate, x as CatalogError } from "./generate-9pR3i5Bj.js";
+import { c as unseenReads, i as keyRefs, l as compileLocale, u as localeExpression } from "./scan-Bx0_yDSi.js";
+import { r as loadConfig } from "./config-BPSmoYel.js";
+import { n as nodeMiddleware, r as redirect, t as inspectorEndpoints } from "./endpoints-CnUfCkIk.js";
+import { relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 // src/vite.ts
 /**
@@ -14,39 +17,32 @@ import { fileURLToPath } from "node:url";
 * In dev an edit doesn't reload the page: each generated locale module accepts its own update and
 * hands the new messages to every copy (`HotHook`), which re-renders in the locale and state it was in.
 * The index accepts its own too, since its doc comments change with the source text, and reloads the
-* page only when a locale was added or removed. The page also gets the inspector (`inspector.ts`), and
-* the server opens the entry it asks for through Vite's own `/__open-in-editor`, so the editor is
-* whichever Vite already launches.
+* page only when a locale was added or removed. In the browser the index imports the dev module first,
+* which sets up the hooks and the inspector (`inspector.ts`) before any copy exists, so frameworks that
+* render their own HTML (TanStack Start, React Router) get them too. The server opens the entry the
+* inspector asks for through Vite's own `/__open-in-editor`, so the editor is whichever Vite already
+* launches.
 */
 const PLACEHOLDER = /__PROSEBOOK_LOCALE_(\d+)__/g;
+const SCRIPT = /\.[cm]?[jt]sx?$/;
+const DEV = "virtual:prosebook/dev";
 const DEV_ID = "\0prosebook/dev";
-const hotLocale = (locale) => `
-if (import.meta.hot) {
-  import.meta.hot.accept((next) => {
-    const hot = globalThis.__PROSEBOOK_HOT__;
-    if (next === undefined || hot === undefined) return import.meta.hot.invalidate();
-    for (const update of hot) update(${JSON.stringify(locale)}, next.default);
-  });
-}
-`;
-const HOT_INDEX = `
-if (import.meta.hot) {
-  import.meta.hot.accept((next) => {
-    if (next === undefined || next.catalog.locales.join() !== catalog.locales.join()) import.meta.hot.invalidate();
-  });
-}
-`;
 const normalize = (path) => resolve(path).replaceAll("\\", "/");
-const inspectorPath = normalize(fileURLToPath(new URL(`./inspector${import.meta.url.endsWith(".ts") ? ".ts" : ".js"}`, import.meta.url)));
+const inspectorPath = beside(import.meta.url, "inspector");
+const ownDir = normalize(fileURLToPath(new URL(".", import.meta.url)));
 function prosebook(options = {}) {
 	let config;
 	let generated;
 	let building = false;
 	let base = "/";
+	let viteRoot = "";
+	let kept = () => true;
 	let refs = {
 		exact: /* @__PURE__ */ new Set(),
 		prefixes: /* @__PURE__ */ new Set()
 	};
+	const reads = /* @__PURE__ */ new Map();
+	const prune = options.prune ?? "strict";
 	const placeholders = [];
 	const shipped = {
 		total: 0,
@@ -65,27 +61,16 @@ function prosebook(options = {}) {
 		const out = normalize(config.out);
 		return path === `${out}/index.ts` || path === `${out}/index.js`;
 	};
-	const kept = (key) => isReferenced(key, refs) || (options.keep ?? []).some((k) => k.endsWith(".*") ? key.startsWith(k.slice(0, -1)) : k === key);
 	return {
 		name: "prosebook",
 		async configResolved(resolved) {
 			building = resolved.command === "build";
 			base = resolved.base;
-			config = await loadConfig(resolved.root, options.config);
-		},
-		transformIndexHtml() {
-			if (building) return [];
-			return [{
-				tag: "script",
-				attrs: {
-					type: "module",
-					src: `${base}@id/__x00__prosebook/dev`
-				},
-				injectTo: "head-prepend"
-			}];
+			viteRoot = resolved.root;
+			config = await loadConfig(options.root === void 0 ? resolved.root : resolve(resolved.root, options.root), options.config);
 		},
 		resolveId(id) {
-			return id === DEV_ID ? id : null;
+			return id === DEV ? DEV_ID : null;
 		},
 		buildStart() {
 			try {
@@ -97,6 +82,8 @@ function prosebook(options = {}) {
 				exact: /* @__PURE__ */ new Set(),
 				prefixes: /* @__PURE__ */ new Set()
 			};
+			kept = keeper(refs, options.keep);
+			reads.clear();
 			placeholders.length = 0;
 			shipped.total = shipped.kept = 0;
 		},
@@ -108,7 +95,7 @@ function prosebook(options = {}) {
 				if (!path.endsWith(".yaml") || !dirs.some((d) => path.startsWith(`${d}/`))) return;
 				try {
 					generated = generate(config);
-					server.config.logger.info(`prosebook: regenerated from ${path.slice(normalize(config.root).length + 1)}`, { timestamp: true });
+					server.config.logger.info(`prosebook: regenerated from ${relative(config.root, path).replaceAll("\\", "/")}`, { timestamp: true });
 				} catch (e) {
 					server.config.logger.error(describe(e), { timestamp: true });
 					server.ws.send({
@@ -125,92 +112,51 @@ function prosebook(options = {}) {
 			server.watcher.on("add", onChange);
 			server.watcher.on("unlink", onChange);
 			if (options.inspect === false) return;
-			server.middlewares.use((req, res, next) => {
-				const url = new URL(req.url ?? "/", "http://localhost");
-				if (url.pathname !== `${base}__prosebook/open`) return next();
-				const key = url.searchParams.get("key") ?? "";
-				const message = generated?.catalog.messages.find((m) => m.key === key);
-				if (message === void 0) {
-					res.statusCode = 404;
-					res.end(`no entry for "${key}" in the catalog: has it been renamed since the page loaded?`);
-					return;
-				}
-				const locale = url.searchParams.has("catalog") ? void 0 : url.searchParams.get("locale") ?? void 0;
-				const { file, line, column } = entryLocation(config, message, locale);
-				req.url = `${base}__open-in-editor?file=${encodeURIComponent(`${file}:${line}:${column}`)}`;
-				next();
-			});
-			server.middlewares.use((req, res, next) => {
-				const url = new URL(req.url ?? "/", "http://localhost");
-				if (url.pathname !== `${base}__prosebook/entry`) return next();
-				const reply = (status, body) => {
-					res.statusCode = status;
-					res.setHeader("Content-Type", "application/json");
-					res.end(JSON.stringify(body));
-				};
-				const fail = (e) => reply(e instanceof CatalogError ? 409 : 400, { problems: e instanceof CatalogError ? e.problems : [{
-					severity: "error",
-					message: e instanceof Error ? e.message : String(e)
-				}] });
-				if (req.method === "GET") {
-					try {
-						reply(200, readEntry(config, url.searchParams.get("key") ?? ""));
-					} catch (e) {
-						fail(e);
-					}
-					return;
-				}
-				const origin = req.headers.origin;
-				const sameOrigin = origin === void 0 || new URL(origin).host === req.headers.host;
-				if (req.method !== "POST" || !sameOrigin || req.headers["content-type"]?.startsWith("application/json") !== true) {
-					reply(403, { problems: [{
-						severity: "error",
-						message: "edits come from the page, as JSON"
-					}] });
-					return;
-				}
-				let body = "";
-				req.setEncoding("utf8");
-				req.on("data", (chunk) => body += chunk);
-				req.on("end", () => {
-					try {
-						const { key, edit, write } = JSON.parse(body);
-						const result = editEntry(config, key, edit, write === true);
-						reply(result.problems.length > 0 ? 422 : 200, result);
-					} catch (e) {
-						fail(e);
-					}
-				});
-			});
+			const editor = ({ file, line, column }) => redirect(`${base}__open-in-editor?file=${encodeURIComponent(`${file}:${line}:${column}`)}`);
+			server.middlewares.use(nodeMiddleware(inspectorEndpoints(config, {
+				base,
+				open: editor
+			})));
 		},
 		load(id) {
 			if (id === DEV_ID) {
-				const hot = "globalThis.__PROSEBOOK_HOT__ ??= new Set();\n";
-				if (options.inspect === false) return hot;
-				return `import { install } from ${JSON.stringify(inspectorPath)};\n${hot}install(${JSON.stringify({ base })});\n`;
+				if (options.inspect === false) return HOT_SET;
+				return HOT_SET + installInspector(inspectorPath, base);
 			}
-			if (!building || options.prune === false || generated === void 0) return null;
+			if (!building || prune === false || generated === void 0) return null;
 			const locale = localeOf(id);
 			if (locale === void 0) return null;
 			placeholders.push(locale);
 			return `export default __PROSEBOOK_LOCALE_${placeholders.length - 1}__;\n`;
 		},
-		transform(code, id) {
-			if (!building) {
-				const locale = localeOf(id);
-				if (locale !== void 0) return {
-					code: code + hotLocale(locale),
-					map: null
-				};
-				return isIndex(id) ? {
-					code: code + HOT_INDEX,
-					map: null
-				} : null;
+		transform: {
+			order: "pre",
+			handler(code, id, transformOptions) {
+				if (!building) {
+					const locale = localeOf(id);
+					if (locale !== void 0) return {
+						code: code + hotLocale(locale),
+						map: null
+					};
+					if (!isIndex(id)) return null;
+					return {
+						code: (transformOptions?.ssr === true ? "" : `import ${JSON.stringify(DEV)};\n`) + code + HOT_INDEX,
+						map: null
+					};
+				}
+				if (prune === false || id.includes("/node_modules/") || id.startsWith("\0")) return null;
+				if (localeOf(id) !== void 0 || isIndex(id)) return null;
+				keyRefs(code, refs);
+				const path = id.split("?", 1)[0];
+				if (prune === "strict" && SCRIPT.test(path) && !normalize(path).startsWith(`${ownDir}/`)) reads.set(id, unseenReads(path, code));
+				return null;
 			}
-			if (options.prune === false || id.includes("/node_modules/") || id.startsWith("\0")) return null;
-			if (localeOf(id) !== void 0) return null;
-			keyRefs(code, refs);
-			return null;
+		},
+		buildEnd(error) {
+			if (error !== void 0 || prune !== "strict") return;
+			const live = new Set(this.getModuleIds());
+			const unseen = unseenOf([...reads].filter(([id]) => live.has(id)).map(([, r]) => r));
+			if (unseen.length > 0) this.error(unseenMessage(unseen, viteRoot));
 		},
 		renderChunk(code) {
 			if (!code.includes("__PROSEBOOK_LOCALE_") || generated === void 0) return null;

package/dist/vite.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite.js","names":[],"sources":["../src/vite.ts"],"sourcesContent":["/**\n * `prosebook/vite`: the catalog as part of the build.\n *\n * Generates on start and again whenever a catalog or translation file changes, so dev never runs on\n * stale modules and a broken entry shows in the error overlay. A build ships only the messages the\n * code names: each locale module is swapped for its messages less the keys no module references\n * (see `tools/scan.ts` for how a reference is found, and why it errs towards keeping).\n *\n * In dev an edit doesn't reload the page: each generated locale module accepts its own update and\n * hands the new messages to every copy (`HotHook`), which re-renders in the locale and state it was in.\n * The index accepts its own too, since its doc comments change with the source text, and reloads the\n * page only when a locale was added or removed. The page also gets the inspector (`inspector.ts`), and\n * the server opens the entry it asks for through Vite's own `/__open-in-editor`, so the editor is\n * whichever Vite already launches.\n */\nimport { resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { Plugin } from 'vite';\n\nimport { CatalogError, entryLocation } from './tools/catalog.ts';\nimport { compileLocale, localeExpression } from './tools/compile.ts';\nimport { loadConfig, type ProsebookConfig, type ResolvedConfig } from './tools/config.ts';\nimport { editEntry, readEntry, type EntryEdit } from './tools/entry.ts';\nimport { generate, type Generated } from './tools/generate.ts';\nimport { isReferenced, keyRefs, type KeyRefs } from './tools/scan.ts';\n\nexport interface ProsebookPluginOptions {\n  /** The config, inline. Without it, `prosebook.config.*` at the Vite root is read. */\n  config?: ProsebookConfig;\n  /** Ship only the messages the code names. On by default. */\n  prune?: boolean;\n  /** Keys a build always keeps, exactly or as `prefix.*`: for keys built at runtime from data. */\n  keep?: string[];\n  /** In dev, Alt-click a string on the page to open its entry in the editor. On by default. */\n  inspect?: boolean;\n}\n\nconst PLACEHOLDER = /__PROSEBOOK_LOCALE_(\\d+)__/g;\nconst DEV_ID = '\\0prosebook/dev';\n\nconst hotLocale = (locale: string) => `\nif (import.meta.hot) {\n  import.meta.hot.accept((next) => {\n    const hot = globalThis.__PROSEBOOK_HOT__;\n    if (next === undefined || hot === undefined) return import.meta.hot.invalidate();\n    for (const update of hot) update(${JSON.stringify(locale)}, next.default);\n  });\n}\n`;\n\nconst HOT_INDEX = `\nif (import.meta.hot) {\n  import.meta.hot.accept((next) => {\n    if (next === undefined || next.catalog.locales.join() !== catalog.locales.join()) import.meta.hot.invalidate();\n  });\n}\n`;\n\nconst normalize = (path: string) => resolve(path).replaceAll('\\\\', '/');\n\n// Beside this module: the source when run from source, the built file in dist.\nconst inspectorPath = normalize(fileURLToPath(new URL(`./inspector${import.meta.url.endsWith('.ts') ? '.ts' : '.js'}`, import.meta.url)));\n\nexport function prosebook(options: ProsebookPluginOptions = {}): Plugin {\n  let config: ResolvedConfig;\n  let generated: Generated | undefined;\n  let building = false;\n  let base = '/';\n  let refs: KeyRefs = { exact: new Set(), prefixes: new Set() };\n  const placeholders: string[] = [];\n  const shipped = { total: 0, kept: 0 };\n\n  const describe = (e: unknown) => (e instanceof CatalogError ? e.message : e instanceof Error ? (e.stack ?? e.message) : String(e));\n\n  const localeOf = (id: string): string | undefined => {\n    const path = normalize(id.split('?', 1)[0]!);\n    const out = normalize(config.out);\n    if (!path.startsWith(`${out}/`)) return undefined;\n    const name = path.slice(out.length + 1).replace(/\\.[jt]s$/, '');\n    return generated?.entries.has(name) === true ? name : undefined;\n  };\n\n  const isIndex = (id: string) => {\n    const path = normalize(id.split('?', 1)[0]!);\n    const out = normalize(config.out);\n    return path === `${out}/index.ts` || path === `${out}/index.js`;\n  };\n\n  const kept = (key: string) =>\n    isReferenced(key, refs) || (options.keep ?? []).some((k) => (k.endsWith('.*') ? key.startsWith(k.slice(0, -1)) : k === key));\n\n  return {\n    name: 'prosebook',\n\n    async configResolved(resolved) {\n      building = resolved.command === 'build';\n      base = resolved.base;\n      config = await loadConfig(resolved.root, options.config);\n    },\n\n    // First in <head>, so the hot hooks are there before any copy is created.\n    transformIndexHtml() {\n      if (building) return [];\n      return [{ tag: 'script', attrs: { type: 'module', src: `${base}@id/__x00__prosebook/dev` }, injectTo: 'head-prepend' }];\n    },\n\n    resolveId(id) {\n      return id === DEV_ID ? id : null;\n    },\n\n    buildStart() {\n      try {\n        generated = generate(config);\n      } catch (e) {\n        this.error(describe(e));\n      }\n      refs = { exact: new Set(), prefixes: new Set() };\n      placeholders.length = 0;\n      shipped.total = shipped.kept = 0;\n    },\n\n    configureServer(server) {\n      const dirs = [normalize(config.catalog), normalize(config.locales)];\n      server.watcher.add(dirs);\n      const onChange = (file: string) => {\n        const path = normalize(file);\n        if (!path.endsWith('.yaml') || !dirs.some((d) => path.startsWith(`${d}/`))) return;\n        try {\n          generated = generate(config);\n          server.config.logger.info(`prosebook: regenerated from ${path.slice(normalize(config.root).length + 1)}`, { timestamp: true });\n        } catch (e) {\n          server.config.logger.error(describe(e), { timestamp: true });\n          server.ws.send({ type: 'error', err: { message: describe(e), stack: '', plugin: 'prosebook' } });\n        }\n      };\n      server.watcher.on('change', onChange);\n      server.watcher.on('add', onChange);\n      server.watcher.on('unlink', onChange);\n      if (options.inspect === false) return;\n\n      // `?key=cart.items&locale=de`: the translation's entry, or the catalog's with `catalog` or when\n      // the locale has none. Handed on to Vite's `/__open-in-editor`, which comes later in the stack.\n      server.middlewares.use((req, res, next) => {\n        const url = new URL(req.url ?? '/', 'http://localhost');\n        if (url.pathname !== `${base}__prosebook/open`) return next();\n        const key = url.searchParams.get('key') ?? '';\n        const message = generated?.catalog.messages.find((m) => m.key === key);\n        if (message === undefined) {\n          res.statusCode = 404;\n          res.end(`no entry for \"${key}\" in the catalog: has it been renamed since the page loaded?`);\n          return;\n        }\n        const locale = url.searchParams.has('catalog') ? undefined : (url.searchParams.get('locale') ?? undefined);\n        const { file, line, column } = entryLocation(config, message, locale);\n        req.url = `${base}__open-in-editor?file=${encodeURIComponent(`${file}:${line}:${column}`)}`;\n        next();\n      });\n\n      // The inspector's dialog: GET `?key=…` reads an entry in every locale, POST `{ key, edit, write }`\n      // applies an edit (`tools/entry.ts`). A POST writes files, so only the page itself may send one:\n      // same origin, and JSON, which a form on another site can't send without asking first.\n      server.middlewares.use((req, res, next) => {\n        const url = new URL(req.url ?? '/', 'http://localhost');\n        if (url.pathname !== `${base}__prosebook/entry`) return next();\n        const reply = (status: number, body: unknown) => {\n          res.statusCode = status;\n          res.setHeader('Content-Type', 'application/json');\n          res.end(JSON.stringify(body));\n        };\n        const fail = (e: unknown) =>\n          reply(e instanceof CatalogError ? 409 : 400, {\n            problems: e instanceof CatalogError ? e.problems : [{ severity: 'error', message: e instanceof Error ? e.message : String(e) }],\n          });\n        if (req.method === 'GET') {\n          try {\n            reply(200, readEntry(config, url.searchParams.get('key') ?? ''));\n          } catch (e) {\n            fail(e);\n          }\n          return;\n        }\n        const origin = req.headers.origin;\n        const sameOrigin = origin === undefined || new URL(origin).host === req.headers.host;\n        if (req.method !== 'POST' || !sameOrigin || req.headers['content-type']?.startsWith('application/json') !== true) {\n          reply(403, { problems: [{ severity: 'error', message: 'edits come from the page, as JSON' }] });\n          return;\n        }\n        let body = '';\n        req.setEncoding('utf8');\n        req.on('data', (chunk: string) => (body += chunk));\n        req.on('end', () => {\n          try {\n            const { key, edit, write } = JSON.parse(body) as { key: string; edit: EntryEdit; write?: boolean };\n            const result = editEntry(config, key, edit, write === true);\n            reply(result.problems.length > 0 ? 422 : 200, result);\n          } catch (e) {\n            fail(e);\n          }\n        });\n      });\n    },\n\n    load(id) {\n      if (id === DEV_ID) {\n        const hot = 'globalThis.__PROSEBOOK_HOT__ ??= new Set();\\n';\n        if (options.inspect === false) return hot;\n        return `import { install } from ${JSON.stringify(inspectorPath)};\\n${hot}install(${JSON.stringify({ base })});\\n`;\n      }\n      if (!building || options.prune === false || generated === undefined) return null;\n      const locale = localeOf(id);\n      if (locale === undefined) return null;\n      placeholders.push(locale);\n      return `export default __PROSEBOOK_LOCALE_${placeholders.length - 1}__;\\n`;\n    },\n\n    transform(code, id) {\n      if (!building) {\n        const locale = localeOf(id);\n        if (locale !== undefined) return { code: code + hotLocale(locale), map: null };\n        return isIndex(id) ? { code: code + HOT_INDEX, map: null } : null;\n      }\n      if (options.prune === false || id.includes('/node_modules/') || id.startsWith('\\0')) return null;\n      if (localeOf(id) !== undefined) return null;\n      keyRefs(code, refs);\n      return null;\n    },\n\n    renderChunk(code) {\n      if (!code.includes('__PROSEBOOK_LOCALE_') || generated === undefined) return null;\n      const entries = generated.entries;\n      const replaced = code.replace(PLACEHOLDER, (_match, index: string) => {\n        const locale = placeholders[Number(index)]!;\n        const list = entries.get(locale) ?? [];\n        const compiled = compileLocale(list, kept);\n        shipped.total += list.length;\n        shipped.kept += compiled.rows.length;\n        return localeExpression(compiled);\n      });\n      return { code: replaced, map: null };\n    },\n\n    generateBundle() {\n      if (shipped.total === 0) return;\n      this.info(\n        `shipped ${shipped.kept} of ${shipped.total} messages across ${placeholders.length} locale(s); pruned ${shipped.total - shipped.kept} no code names`,\n      );\n    },\n  };\n}\n\nexport default prosebook;\n"],"mappings":"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"}
+{"version":3,"file":"vite.js","names":[],"sources":["../src/vite.ts"],"sourcesContent":["/**\n * `prosebook/vite`: the catalog as part of the build.\n *\n * Generates on start and again whenever a catalog or translation file changes, so dev never runs on\n * stale modules and a broken entry shows in the error overlay. A build ships only the messages the\n * code names: each locale module is swapped for its messages less the keys no module references\n * (see `tools/scan.ts` for how a reference is found, and why it errs towards keeping).\n *\n * In dev an edit doesn't reload the page: each generated locale module accepts its own update and\n * hands the new messages to every copy (`HotHook`), which re-renders in the locale and state it was in.\n * The index accepts its own too, since its doc comments change with the source text, and reloads the\n * page only when a locale was added or removed. In the browser the index imports the dev module first,\n * which sets up the hooks and the inspector (`inspector.ts`) before any copy exists, so frameworks that\n * render their own HTML (TanStack Start, React Router) get them too. The server opens the entry the\n * inspector asks for through Vite's own `/__open-in-editor`, so the editor is whichever Vite already\n * launches.\n */\nimport { relative, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { Plugin } from 'vite';\n\nimport { beside, HOT_INDEX, HOT_SET, hotLocale, installInspector, keeper, unseenMessage, unseenOf, type Prune } from './tools/bundle.ts';\nimport { CatalogError, type EntryLocation } from './tools/catalog.ts';\nimport { compileLocale, localeExpression } from './tools/compile.ts';\nimport { loadConfig, type ProsebookConfig, type ResolvedConfig } from './tools/config.ts';\nimport { inspectorEndpoints, nodeMiddleware, redirect } from './tools/endpoints.ts';\nimport { generate, type Generated } from './tools/generate.ts';\nimport { keyRefs, unseenReads, type KeyRefs, type Reads } from './tools/scan.ts';\n\nexport interface ProsebookPluginOptions {\n  /** The config, inline. Without it, `prosebook.config.*` at `root` is read. */\n  config?: ProsebookConfig;\n  /**\n   * The folder the config's paths resolve from, and where its file is found: the Vite root when\n   * unset. Apps that share one catalog name its folder, so each build generates the same files.\n   */\n  root?: string;\n  /**\n   * Ship only the messages the code names. `strict`, the default, also fails the build on a read\n   * whose key it can't see, such as `t(item.key)`, which would show the key where its message was\n   * pruned. `loose` prunes without that check; `false` ships every message.\n   */\n  prune?: Prune;\n  /** Keys a build always keeps, exactly or as `prefix.*`: for keys built at runtime from data. */\n  keep?: string[];\n  /** In dev, Alt-click a string on the page to open its entry in the editor. On by default. */\n  inspect?: boolean;\n}\n\nconst PLACEHOLDER = /__PROSEBOOK_LOCALE_(\\d+)__/g;\nconst SCRIPT = /\\.[cm]?[jt]sx?$/;\nconst DEV = 'virtual:prosebook/dev';\nconst DEV_ID = '\\0prosebook/dev';\n\nconst normalize = (path: string) => resolve(path).replaceAll('\\\\', '/');\n\nconst inspectorPath = beside(import.meta.url, 'inspector');\n// prosebook's own modules, which read keys handed to them: `<Text>` calls `rich(props.id)`.\nconst ownDir = normalize(fileURLToPath(new URL('.', import.meta.url)));\n\nexport function prosebook(options: ProsebookPluginOptions = {}): Plugin {\n  let config: ResolvedConfig;\n  let generated: Generated | undefined;\n  let building = false;\n  let base = '/';\n  let viteRoot = '';\n  let kept: (key: string) => boolean = () => true;\n  let refs: KeyRefs = { exact: new Set(), prefixes: new Set() };\n  const reads = new Map<string, Reads>();\n  const prune = options.prune ?? 'strict';\n  const placeholders: string[] = [];\n  const shipped = { total: 0, kept: 0 };\n\n  const describe = (e: unknown) => (e instanceof CatalogError ? e.message : e instanceof Error ? (e.stack ?? e.message) : String(e));\n\n  const localeOf = (id: string): string | undefined => {\n    const path = normalize(id.split('?', 1)[0]!);\n    const out = normalize(config.out);\n    if (!path.startsWith(`${out}/`)) return undefined;\n    const name = path.slice(out.length + 1).replace(/\\.[jt]s$/, '');\n    return generated?.entries.has(name) === true ? name : undefined;\n  };\n\n  const isIndex = (id: string) => {\n    const path = normalize(id.split('?', 1)[0]!);\n    const out = normalize(config.out);\n    return path === `${out}/index.ts` || path === `${out}/index.js`;\n  };\n\n  return {\n    name: 'prosebook',\n\n    async configResolved(resolved) {\n      building = resolved.command === 'build';\n      base = resolved.base;\n      viteRoot = resolved.root;\n      config = await loadConfig(options.root === undefined ? resolved.root : resolve(resolved.root, options.root), options.config);\n    },\n\n    resolveId(id) {\n      return id === DEV ? DEV_ID : null;\n    },\n\n    buildStart() {\n      try {\n        generated = generate(config);\n      } catch (e) {\n        this.error(describe(e));\n      }\n      refs = { exact: new Set(), prefixes: new Set() };\n      kept = keeper(refs, options.keep);\n      reads.clear();\n      placeholders.length = 0;\n      shipped.total = shipped.kept = 0;\n    },\n\n    configureServer(server) {\n      const dirs = [normalize(config.catalog), normalize(config.locales)];\n      server.watcher.add(dirs);\n      const onChange = (file: string) => {\n        const path = normalize(file);\n        if (!path.endsWith('.yaml') || !dirs.some((d) => path.startsWith(`${d}/`))) return;\n        try {\n          generated = generate(config);\n          server.config.logger.info(`prosebook: regenerated from ${relative(config.root, path).replaceAll('\\\\', '/')}`, {\n            timestamp: true,\n          });\n        } catch (e) {\n          server.config.logger.error(describe(e), { timestamp: true });\n          server.ws.send({ type: 'error', err: { message: describe(e), stack: '', plugin: 'prosebook' } });\n        }\n      };\n      server.watcher.on('change', onChange);\n      server.watcher.on('add', onChange);\n      server.watcher.on('unlink', onChange);\n      if (options.inspect === false) return;\n\n      // Each entry opens through Vite's own `/__open-in-editor`, so the editor is whichever Vite launches.\n      const editor = ({ file, line, column }: EntryLocation) =>\n        redirect(`${base}__open-in-editor?file=${encodeURIComponent(`${file}:${line}:${column}`)}`);\n      server.middlewares.use(nodeMiddleware(inspectorEndpoints(config, { base, open: editor })));\n    },\n\n    load(id) {\n      if (id === DEV_ID) {\n        if (options.inspect === false) return HOT_SET;\n        return HOT_SET + installInspector(inspectorPath, base);\n      }\n      if (!building || prune === false || generated === undefined) return null;\n      const locale = localeOf(id);\n      if (locale === undefined) return null;\n      placeholders.push(locale);\n      return `export default __PROSEBOOK_LOCALE_${placeholders.length - 1}__;\\n`;\n    },\n\n    // Before other plugins, so a read is found in the source as written: `<Text id>` still JSX, and\n    // the line it is reported at, and its `prosebook-ignore`, where the author wrote them.\n    transform: {\n      order: 'pre',\n      handler(code, id, transformOptions) {\n        if (!building) {\n          const locale = localeOf(id);\n          if (locale !== undefined) return { code: code + hotLocale(locale), map: null };\n          if (!isIndex(id)) return null;\n          // A server render has no page to inspect, and its copies are made per request.\n          const dev = transformOptions?.ssr === true ? '' : `import ${JSON.stringify(DEV)};\\n`;\n          return { code: dev + code + HOT_INDEX, map: null };\n        }\n        if (prune === false || id.includes('/node_modules/') || id.startsWith('\\0')) return null;\n        // The index's `Messages` type names every key, and is read here before its types are stripped.\n        if (localeOf(id) !== undefined || isIndex(id)) return null;\n        keyRefs(code, refs);\n        const path = id.split('?', 1)[0]!;\n        if (prune === 'strict' && SCRIPT.test(path) && !normalize(path).startsWith(`${ownDir}/`)) reads.set(id, unseenReads(path, code));\n        return null;\n      },\n    },\n\n    buildEnd(error) {\n      if (error !== undefined || prune !== 'strict') return;\n      const live = new Set(this.getModuleIds());\n      const unseen = unseenOf([...reads].filter(([id]) => live.has(id)).map(([, r]) => r));\n      if (unseen.length > 0) this.error(unseenMessage(unseen, viteRoot));\n    },\n\n    renderChunk(code) {\n      if (!code.includes('__PROSEBOOK_LOCALE_') || generated === undefined) return null;\n      const entries = generated.entries;\n      const replaced = code.replace(PLACEHOLDER, (_match, index: string) => {\n        const locale = placeholders[Number(index)]!;\n        const list = entries.get(locale) ?? [];\n        const compiled = compileLocale(list, kept);\n        shipped.total += list.length;\n        shipped.kept += compiled.rows.length;\n        return localeExpression(compiled);\n      });\n      return { code: replaced, map: null };\n    },\n\n    generateBundle() {\n      if (shipped.total === 0) return;\n      this.info(\n        `shipped ${shipped.kept} of ${shipped.total} messages across ${placeholders.length} locale(s); pruned ${shipped.total - shipped.kept} no code names`,\n      );\n    },\n  };\n}\n\nexport default prosebook;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,MAAM,cAAc;AACpB,MAAM,SAAS;AACf,MAAM,MAAM;AACZ,MAAM,SAAS;AAEf,MAAM,aAAa,SAAiB,QAAQ,IAAI,CAAC,CAAC,WAAW,MAAM,GAAG;AAEtE,MAAM,gBAAgB,OAAO,YAAY,KAAK,WAAW;AAEzD,MAAM,SAAS,UAAU,cAAc,IAAI,IAAI,KAAK,YAAY,GAAG,CAAC,CAAC;AAErE,SAAgB,UAAU,UAAkC,CAAC,GAAW;CACtE,IAAI;CACJ,IAAI;CACJ,IAAI,WAAW;CACf,IAAI,OAAO;CACX,IAAI,WAAW;CACf,IAAI,aAAuC;CAC3C,IAAI,OAAgB;EAAE,uBAAO,IAAI,IAAI;EAAG,0BAAU,IAAI,IAAI;CAAE;CAC5D,MAAM,wBAAQ,IAAI,IAAmB;CACrC,MAAM,QAAQ,QAAQ,SAAS;CAC/B,MAAM,eAAyB,CAAC;CAChC,MAAM,UAAU;EAAE,OAAO;EAAG,MAAM;CAAE;CAEpC,MAAM,YAAY,MAAgB,aAAa,eAAe,EAAE,UAAU,aAAa,QAAS,EAAE,SAAS,EAAE,UAAW,OAAO,CAAC;CAEhI,MAAM,YAAY,OAAmC;EACnD,MAAM,OAAO,UAAU,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,EAAG;EAC3C,MAAM,MAAM,UAAU,OAAO,GAAG;EAChC,IAAI,CAAC,KAAK,WAAW,GAAG,IAAI,EAAE,GAAG,OAAO,KAAA;EACxC,MAAM,OAAO,KAAK,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,QAAQ,YAAY,EAAE;EAC9D,OAAO,WAAW,QAAQ,IAAI,IAAI,MAAM,OAAO,OAAO,KAAA;CACxD;CAEA,MAAM,WAAW,OAAe;EAC9B,MAAM,OAAO,UAAU,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,EAAG;EAC3C,MAAM,MAAM,UAAU,OAAO,GAAG;EAChC,OAAO,SAAS,GAAG,IAAI,cAAc,SAAS,GAAG,IAAI;CACvD;CAEA,OAAO;EACL,MAAM;EAEN,MAAM,eAAe,UAAU;GAC7B,WAAW,SAAS,YAAY;GAChC,OAAO,SAAS;GAChB,WAAW,SAAS;GACpB,SAAS,MAAM,WAAW,QAAQ,SAAS,KAAA,IAAY,SAAS,OAAO,QAAQ,SAAS,MAAM,QAAQ,IAAI,GAAG,QAAQ,MAAM;EAC7H;EAEA,UAAU,IAAI;GACZ,OAAO,OAAO,MAAM,SAAS;EAC/B;EAEA,aAAa;GACX,IAAI;IACF,YAAY,SAAS,MAAM;GAC7B,SAAS,GAAG;IACV,KAAK,MAAM,SAAS,CAAC,CAAC;GACxB;GACA,OAAO;IAAE,uBAAO,IAAI,IAAI;IAAG,0BAAU,IAAI,IAAI;GAAE;GAC/C,OAAO,OAAO,MAAM,QAAQ,IAAI;GAChC,MAAM,MAAM;GACZ,aAAa,SAAS;GACtB,QAAQ,QAAQ,QAAQ,OAAO;EACjC;EAEA,gBAAgB,QAAQ;GACtB,MAAM,OAAO,CAAC,UAAU,OAAO,OAAO,GAAG,UAAU,OAAO,OAAO,CAAC;GAClE,OAAO,QAAQ,IAAI,IAAI;GACvB,MAAM,YAAY,SAAiB;IACjC,MAAM,OAAO,UAAU,IAAI;IAC3B,IAAI,CAAC,KAAK,SAAS,OAAO,KAAK,CAAC,KAAK,MAAM,MAAM,KAAK,WAAW,GAAG,EAAE,EAAE,CAAC,GAAG;IAC5E,IAAI;KACF,YAAY,SAAS,MAAM;KAC3B,OAAO,OAAO,OAAO,KAAK,+BAA+B,SAAS,OAAO,MAAM,IAAI,CAAC,CAAC,WAAW,MAAM,GAAG,KAAK,EAC5G,WAAW,KACb,CAAC;IACH,SAAS,GAAG;KACV,OAAO,OAAO,OAAO,MAAM,SAAS,CAAC,GAAG,EAAE,WAAW,KAAK,CAAC;KAC3D,OAAO,GAAG,KAAK;MAAE,MAAM;MAAS,KAAK;OAAE,SAAS,SAAS,CAAC;OAAG,OAAO;OAAI,QAAQ;MAAY;KAAE,CAAC;IACjG;GACF;GACA,OAAO,QAAQ,GAAG,UAAU,QAAQ;GACpC,OAAO,QAAQ,GAAG,OAAO,QAAQ;GACjC,OAAO,QAAQ,GAAG,UAAU,QAAQ;GACpC,IAAI,QAAQ,YAAY,OAAO;GAG/B,MAAM,UAAU,EAAE,MAAM,MAAM,aAC5B,SAAS,GAAG,KAAK,wBAAwB,mBAAmB,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG;GAC5F,OAAO,YAAY,IAAI,eAAe,mBAAmB,QAAQ;IAAE;IAAM,MAAM;GAAO,CAAC,CAAC,CAAC;EAC3F;EAEA,KAAK,IAAI;GACP,IAAI,OAAO,QAAQ;IACjB,IAAI,QAAQ,YAAY,OAAO,OAAO;IACtC,OAAO,UAAU,iBAAiB,eAAe,IAAI;GACvD;GACA,IAAI,CAAC,YAAY,UAAU,SAAS,cAAc,KAAA,GAAW,OAAO;GACpE,MAAM,SAAS,SAAS,EAAE;GAC1B,IAAI,WAAW,KAAA,GAAW,OAAO;GACjC,aAAa,KAAK,MAAM;GACxB,OAAO,qCAAqC,aAAa,SAAS,EAAE;EACtE;EAIA,WAAW;GACT,OAAO;GACP,QAAQ,MAAM,IAAI,kBAAkB;IAClC,IAAI,CAAC,UAAU;KACb,MAAM,SAAS,SAAS,EAAE;KAC1B,IAAI,WAAW,KAAA,GAAW,OAAO;MAAE,MAAM,OAAO,UAAU,MAAM;MAAG,KAAK;KAAK;KAC7E,IAAI,CAAC,QAAQ,EAAE,GAAG,OAAO;KAGzB,OAAO;MAAE,OADG,kBAAkB,QAAQ,OAAO,KAAK,UAAU,KAAK,UAAU,GAAG,EAAE,QAC3D,OAAO;MAAW,KAAK;KAAK;IACnD;IACA,IAAI,UAAU,SAAS,GAAG,SAAS,gBAAgB,KAAK,GAAG,WAAW,IAAI,GAAG,OAAO;IAEpF,IAAI,SAAS,EAAE,MAAM,KAAA,KAAa,QAAQ,EAAE,GAAG,OAAO;IACtD,QAAQ,MAAM,IAAI;IAClB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC;IAC9B,IAAI,UAAU,YAAY,OAAO,KAAK,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,WAAW,GAAG,OAAO,EAAE,GAAG,MAAM,IAAI,IAAI,YAAY,MAAM,IAAI,CAAC;IAC/H,OAAO;GACT;EACF;EAEA,SAAS,OAAO;GACd,IAAI,UAAU,KAAA,KAAa,UAAU,UAAU;GAC/C,MAAM,OAAO,IAAI,IAAI,KAAK,aAAa,CAAC;GACxC,MAAM,SAAS,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC;GACnF,IAAI,OAAO,SAAS,GAAG,KAAK,MAAM,cAAc,QAAQ,QAAQ,CAAC;EACnE;EAEA,YAAY,MAAM;GAChB,IAAI,CAAC,KAAK,SAAS,qBAAqB,KAAK,cAAc,KAAA,GAAW,OAAO;GAC7E,MAAM,UAAU,UAAU;GAS1B,OAAO;IAAE,MARQ,KAAK,QAAQ,cAAc,QAAQ,UAAkB;KACpE,MAAM,SAAS,aAAa,OAAO,KAAK;KACxC,MAAM,OAAO,QAAQ,IAAI,MAAM,KAAK,CAAC;KACrC,MAAM,WAAW,cAAc,MAAM,IAAI;KACzC,QAAQ,SAAS,KAAK;KACtB,QAAQ,QAAQ,SAAS,KAAK;KAC9B,OAAO,iBAAiB,QAAQ;IAClC,CACsB;IAAG,KAAK;GAAK;EACrC;EAEA,iBAAiB;GACf,IAAI,QAAQ,UAAU,GAAG;GACzB,KAAK,KACH,WAAW,QAAQ,KAAK,MAAM,QAAQ,MAAM,mBAAmB,aAAa,OAAO,qBAAqB,QAAQ,QAAQ,QAAQ,KAAK,eACvI;EACF;CACF;AACF"}

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "prosebook",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Every string your app shows, in one typed catalog: ICU messages compiled to plain functions, for React and any JavaScript.",
   "keywords": [
+    "bun",
     "i18n",
     "icu",
     "intl",
@@ -10,10 +11,12 @@
     "localization",
     "messageformat",
     "messageformat2",
+    "nextjs",
     "react",
     "translation",
     "typescript",
-    "ux-writing"
+    "ux-writing",
+    "vite"
   ],
   "homepage": "https://gkurt.com/prosebook/",
   "bugs": {
@@ -32,6 +35,9 @@
   "bin": {
     "prosebook": "./dist/cli.js"
   },
+  "workspaces": [
+    "examples/*"
+  ],
   "files": [
     "dist",
     "src",
@@ -59,6 +65,13 @@
         "default": "./dist/react/index.js"
       }
     },
+    "./react/server": {
+      "prosebook@dev": "./src/react/server.ts",
+      "import": {
+        "types": "./dist/react/server.d.ts",
+        "default": "./dist/react/server.js"
+      }
+    },
     "./vite": {
       "prosebook@dev": "./src/vite.ts",
       "import": {
@@ -66,6 +79,20 @@
         "default": "./dist/vite.js"
       }
     },
+    "./next": {
+      "prosebook@dev": "./src/next.ts",
+      "default": {
+        "types": "./dist/next.d.ts",
+        "default": "./dist/next.js"
+      }
+    },
+    "./bun": {
+      "prosebook@dev": "./src/bun.ts",
+      "import": {
+        "types": "./dist/bun.d.ts",
+        "default": "./dist/bun.js"
+      }
+    },
     "./config": {
       "prosebook@dev": "./src/tools/config.ts",
       "import": {
@@ -93,8 +120,9 @@
     "build": "tsdown",
     "prepack": "tsdown",
     "cli": "bun --conditions=prosebook@dev src/cli.ts",
-    "example": "vite examples/react-app",
-    "example:build": "vite build examples/react-app",
+    "example": "tsdown && bun run --cwd examples/vite dev",
+    "examples:generate": "tsdown && bun run --filter 'example-*' generate",
+    "examples:smoke": "bun scripts/smoke.mts",
     "site": "rm -rf _site && mkdir -p _site && cp -R site/* _site/",
     "prepare": "husky",
     "tegami": "bun scripts/tegami.mts"
@@ -111,6 +139,7 @@
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
     "@vitejs/plugin-react": "^6.1.2",
+    "cldr-core": "48",
     "husky": "^9.1.7",
     "lint-staged": "^17.6.0",
     "oxfmt": "^0.75.0",
@@ -124,6 +153,7 @@
     "vite": "^8.3.5"
   },
   "peerDependencies": {
+    "next": ">=16",
     "react": ">=18",
     "typescript": ">=7",
     "vite": ">=6"
@@ -137,6 +167,9 @@
     },
     "typescript": {
       "optional": true
+    },
+    "next": {
+      "optional": true
     }
   },
   "lint-staged": {

package/src/bun.ts

@@ -0,0 +1,132 @@
+/**
+ * `prosebook/bun`: the catalog as part of a Bun build, or of Bun's dev server.
+ *
+ * Generates when the plugin is set up. Given to `Bun.build`, it ships only the messages the code
+ * names: Bun loads a locale module before it has seen the code that reads it, so the keys come from
+ * the source under `scan.dirs` (`tools/bundle.ts`) and each locale loads already pruned. The `bun
+ * build` command reads no plugins, so a build that prunes is a script that calls `Bun.build`.
+ *
+ * Named in bunfig.toml's `[serve.static] plugins`, it serves `Bun.serve`'s bundler instead, which
+ * names no entry points: it regenerates whenever a catalog or translation file changes, and each
+ * locale module accepts its own update and hands the new messages to every copy, as under Vite. The
+ * index starts the inspector on the page too, whose endpoints are `inspector()`'s routes, spread into
+ * `Bun.serve`'s; an entry opens in the editor `Bun.openInEditor` finds.
+ */
+import { readFileSync } from 'node:fs';
+import { basename, resolve } from 'node:path';
+
+import type { BunPlugin } from 'bun';
+
+import {
+  beside,
+  HOT_INDEX,
+  HOT_SET,
+  hotLocale,
+  installInspector,
+  keeper,
+  prunedModule,
+  scanSources,
+  unseenMessage,
+  watchCatalog,
+  type Prune,
+} from './tools/bundle.ts';
+import { CatalogError } from './tools/catalog.ts';
+import { loadConfig, type ProsebookConfig } from './tools/config.ts';
+import { inspectorEndpoints } from './tools/endpoints.ts';
+import { generate } from './tools/generate.ts';
+
+export interface ProsebookBunOptions {
+  /** The config, inline. Without it, `prosebook.config.*` at `root` is read. */
+  config?: ProsebookConfig;
+  /** The folder the config's paths resolve from, and where its file is found: the working directory when unset. */
+  root?: string;
+  /**
+   * In `Bun.build`, ship only the messages the code names. `strict`, the default, also fails the
+   * build on a read whose key it can't see, such as `t(item.key)`. `loose` prunes without that
+   * check; `false` ships every message.
+   */
+  prune?: Prune;
+  /** Keys a build always keeps, exactly or as `prefix.*`: for keys built at runtime from data. */
+  keep?: string[];
+  /** Under the dev server, Alt-click a string on the page to open its entry in the editor. On by default. */
+  inspect?: boolean;
+}
+
+const inspectorPath = beside(import.meta.url, 'inspector');
+
+const describe = (e: unknown) => (e instanceof CatalogError ? e.message : e instanceof Error ? (e.stack ?? e.message) : String(e));
+const escape = (s: string) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
+export function prosebook(options: ProsebookBunOptions = {}): BunPlugin {
+  return {
+    name: 'prosebook',
+    async setup(build) {
+      const config = await loadConfig(resolve(options.root ?? process.cwd()), options.config);
+      let generated = generate(config);
+      // The generated modules, by path as Bun gives it: either separator on Windows.
+      const folder = config.out.split(/[\\/]/).map(escape).join('[\\\\/]');
+      const filter = new RegExp(`^${folder}[\\\\/][^\\\\/]+\\.[jt]s$`);
+      const nameOf = (path: string) => basename(path).replace(/\.[jt]s$/, '');
+
+      if ('entrypoints' in build.config) {
+        const prune = options.prune ?? 'strict';
+        if (prune === false) return;
+        const { refs, unseen } = scanSources(config, prune === 'strict');
+        if (unseen.length > 0) throw new Error(unseenMessage(unseen, config.root));
+        const kept = keeper(refs, options.keep);
+        build.onLoad({ filter }, ({ path }) => {
+          const entries = generated.entries.get(nameOf(path));
+          return entries === undefined ? undefined : { contents: prunedModule(entries, kept), loader: 'js' };
+        });
+        return;
+      }
+
+      const dev = process.env.NODE_ENV !== 'production';
+      const inspector = dev && options.inspect !== false ? installInspector(inspectorPath, '/') : '';
+      if (dev) {
+        watchCatalog(config, () => {
+          try {
+            generated = generate(config);
+          } catch (e) {
+            console.error(describe(e));
+          }
+        });
+      }
+      build.onLoad({ filter }, ({ path }) => {
+        const name = nameOf(path);
+        const loader = path.endsWith('.ts') ? 'ts' : 'js';
+        if (generated.entries.has(name)) return { contents: readFileSync(path, 'utf8') + hotLocale(name), loader };
+        return name === 'index' ? { contents: HOT_SET + inspector + readFileSync(path, 'utf8') + HOT_INDEX, loader } : undefined;
+      });
+    },
+  };
+}
+
+export interface InspectorRoutesOptions {
+  /** The config, inline. Without it, `prosebook.config.*` at `root` is read. */
+  config?: ProsebookConfig;
+  /** The folder the config's paths resolve from, and where its file is found: the working directory when unset. */
+  root?: string;
+}
+
+/**
+ * The inspector's endpoints as `Bun.serve` routes: `routes: { ...inspector(), '/': index }`. For dev
+ * only: they read and write the catalog.
+ */
+export function inspector(options: InspectorRoutesOptions = {}): Record<string, (req: Request) => Promise<Response>> {
+  const handle = inspectorEndpoints(loadConfig(resolve(options.root ?? process.cwd()), options.config), {
+    open: ({ file, line, column }) => {
+      try {
+        Bun.openInEditor(file, { line, column });
+        return new Response(null, { status: 204 });
+      } catch (e) {
+        return new Response(`${e instanceof Error ? e.message : String(e)}: set VISUAL or EDITOR to the editor's command`, { status: 500 });
+      }
+    },
+  });
+  const route = async (req: Request) => (await handle(req)) ?? new Response(null, { status: 404 });
+  return { '/__prosebook/open': route, '/__prosebook/entry': route };
+}
+
+// bunfig.toml names the module, and Bun takes its default export as the plugin.
+export default prosebook();