prosebook 0.3.0 → 0.5.0

package/dist/bun.js

@@ -1,9 +1,10 @@
-import { a as installInspector, c as prunedModule, f as watchCatalog, i as hotLocale, l as scanSources, 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 { r as loadConfig } from "./config-BPSmoYel.js";
-import { t as inspectorEndpoints } from "./endpoints-CnUfCkIk.js";
-import { basename, resolve } from "node:path";
+import { C as unseenMessage, S as splitIndex, T as watchCatalog, _ as membersOf, a as areaModule, c as beside, d as hotLocale, f as importingAreas, g as lazyAreas, h as keeper, m as installInspector, n as HOT_INDEX, o as areasNamed, p as inAreas, r as HOT_SET, t as AREA, x as scanSources, y as prunedModule } from "./bundle-Ut6Y2X6N.js";
+import { T as CatalogError, n as generate } from "./generate-CKv86Iki.js";
+import { i as areaGroups, t as inspectorEndpoints } from "./endpoints-Dhgowovz.js";
+import { d as compileLocale, f as localeExpression } from "./scan-C0ap4Mpp.js";
+import { r as loadConfig } from "./config-7T4hX_f7.js";
 import { readFileSync } from "node:fs";
+import { basename, resolve } from "node:path";
 // src/bun.ts
 /**
 * `prosebook/bun`: the catalog as part of a Bun build, or of Bun's dev server.
@@ -18,35 +19,39 @@ import { readFileSync } from "node:fs";
 * 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.
+*
+* With `split`, the page's catalog is split by area as the Vite plugin's is (`tools/bundle.ts`): each
+* source file under `scan.dirs` naming an area's keys imports the area, a module of the plugin's own
+* namespace. Bun has no transform hook, so those files are read here and handed back. A build knows
+* the keys it keeps before it loads anything, so each area loads already pruned, and which areas
+* share a chunk (`tools/chunks.ts`), so a lazy locale's part is a file per group of them.
 */
 const inspectorPath = beside(import.meta.url, "inspector");
+const NAMESPACE = "prosebook-area";
 const describe = (e) => e instanceof CatalogError ? e.message : e instanceof Error ? e.stack ?? e.message : String(e);
 const escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/** A folder's path as a pattern, by either separator: Bun gives paths with either on Windows. */
+const folderPattern = (path) => path.split(/[\\/]/).map(escape).join("[\\\\/]");
 function prosebook(options = {}) {
 	return {
 		name: "prosebook",
 		async setup(build) {
 			const config = await loadConfig(resolve(options.root ?? process.cwd()), options.config);
 			let generated = generate(config);
-			const folder = config.out.split(/[\\/]/).map(escape).join("[\\\\/]");
-			const filter = new RegExp(`^${folder}[\\\\/][^\\\\/]+\\.[jt]s$`);
+			const filter = new RegExp(`^${folderPattern(config.out)}[\\\\/][^\\\\/]+\\.[jt]s$`);
 			const nameOf = (path) => basename(path).replace(/\.[jt]s$/, "");
-			if ("entrypoints" in build.config) {
-				const prune = options.prune ?? "strict";
-				if (prune === false) return;
+			const building = "entrypoints" in build.config;
+			const split = options.split === true;
+			if (building && split && build.config.splitting !== true) throw new Error("prosebook: `split` needs `splitting: true` in Bun.build, or every area ships in the entry chunk");
+			const client = (args) => "side" in args ? args.side === "client" : (build.config.target ?? "browser") === "browser";
+			const prune = options.prune ?? "strict";
+			let kept = () => true;
+			if (building && prune !== false) {
 				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 === void 0 ? void 0 : {
-						contents: prunedModule(entries, kept),
-						loader: "js"
-					};
-				});
-				return;
+				kept = keeper(refs, options.keep);
 			}
-			const dev = process.env.NODE_ENV !== "production";
+			const dev = !building && process.env.NODE_ENV !== "production";
 			const inspector = dev && options.inspect !== false ? installInspector(inspectorPath, "/") : "";
 			if (dev) watchCatalog(config, () => {
 				try {
@@ -55,18 +60,64 @@ function prosebook(options = {}) {
 					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),
+			build.onLoad({ filter }, (args) => {
+				const name = nameOf(args.path);
+				if (name === "index" && split && client(args)) {
+					const index = splitIndex(config, generated, options.keep);
+					return {
+						contents: building ? index : HOT_SET + inspector + index + HOT_INDEX,
+						loader: "js"
+					};
+				}
+				const entries = generated.entries.get(name);
+				if (building) return entries === void 0 || prune === false ? void 0 : {
+					contents: prunedModule(entries, kept),
+					loader: "js"
+				};
+				const loader = args.path.endsWith(".ts") ? "ts" : "js";
+				if (entries !== void 0) return {
+					contents: readFileSync(args.path, "utf8") + hotLocale(name),
 					loader
 				};
 				return name === "index" ? {
-					contents: HOT_SET + inspector + readFileSync(path, "utf8") + HOT_INDEX,
+					contents: HOT_SET + inspector + readFileSync(args.path, "utf8") + HOT_INDEX,
 					loader
 				} : void 0;
 			});
+			if (!split) return;
+			const groups = building ? areaGroups(config, generated, options.keep) : /* @__PURE__ */ new Map();
+			build.onResolve({ filter: new RegExp(`^${escape(AREA)}`) }, ({ path }) => ({
+				path: path.slice(AREA.length),
+				namespace: NAMESPACE
+			}));
+			build.onLoad({
+				filter: /.*/,
+				namespace: NAMESPACE
+			}, ({ path }) => {
+				const [area = "", locale] = path.split("/");
+				if (locale !== void 0) {
+					const entries = inAreas(generated.entries.get(locale) ?? [], membersOf(groups, area));
+					return {
+						contents: prunedModule(entries, kept),
+						loader: "js"
+					};
+				}
+				return {
+					contents: areaModule(config, generated, area, building ? (_locale, entries) => localeExpression(compileLocale(entries, kept)) : void 0, void 0, groups),
+					loader: "js"
+				};
+			});
+			const dirs = config.scan.dirs.map((dir) => folderPattern(resolve(config.root, dir))).join("|");
+			const out = new RegExp(`^${folderPattern(config.out)}[\\\\/]`);
+			build.onLoad({ filter: new RegExp(`^(?:${dirs})[\\\\/].*\\.[cm]?[jt]sx?$`) }, (args) => {
+				if (!client(args) || out.test(args.path) || /[\\/]node_modules[\\/]/.test(args.path)) return void 0;
+				const code = readFileSync(args.path, "utf8");
+				const areas = areasNamed(code, lazyAreas(generated, options.keep));
+				return areas.length === 0 ? void 0 : {
+					contents: importingAreas(code, args.path, areas),
+					loader: args.loader
+				};
+			});
 		}
 	};
 }

package/dist/bun.js.map

@@ -1 +1 @@
-{"version":3,"file":"bun.js","names":[],"sources":["../src/bun.ts"],"sourcesContent":["/**\n * `prosebook/bun`: the catalog as part of a Bun build, or of Bun's dev server.\n *\n * Generates when the plugin is set up. Given to `Bun.build`, it ships only the messages the code\n * names: Bun loads a locale module before it has seen the code that reads it, so the keys come from\n * the source under `scan.dirs` (`tools/bundle.ts`) and each locale loads already pruned. The `bun\n * build` command reads no plugins, so a build that prunes is a script that calls `Bun.build`.\n *\n * Named in bunfig.toml's `[serve.static] plugins`, it serves `Bun.serve`'s bundler instead, which\n * names no entry points: it regenerates whenever a catalog or translation file changes, and each\n * locale module accepts its own update and hands the new messages to every copy, as under Vite. The\n * index starts the inspector on the page too, whose endpoints are `inspector()`'s routes, spread into\n * `Bun.serve`'s; an entry opens in the editor `Bun.openInEditor` finds.\n */\nimport { readFileSync } from 'node:fs';\nimport { basename, resolve } from 'node:path';\n\nimport type { BunPlugin } from 'bun';\n\nimport {\n  beside,\n  HOT_INDEX,\n  HOT_SET,\n  hotLocale,\n  installInspector,\n  keeper,\n  prunedModule,\n  scanSources,\n  unseenMessage,\n  watchCatalog,\n  type Prune,\n} from './tools/bundle.ts';\nimport { CatalogError } from './tools/catalog.ts';\nimport { loadConfig, type ProsebookConfig } from './tools/config.ts';\nimport { inspectorEndpoints } from './tools/endpoints.ts';\nimport { generate } from './tools/generate.ts';\n\nexport interface ProsebookBunOptions {\n  /** The config, inline. Without it, `prosebook.config.*` at `root` is read. */\n  config?: ProsebookConfig;\n  /** The folder the config's paths resolve from, and where its file is found: the working directory when unset. */\n  root?: string;\n  /**\n   * In `Bun.build`, ship only the messages the code names. `strict`, the default, also fails the\n   * build on a read whose key it can't see, such as `t(item.key)`. `loose` prunes without that\n   * 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  /** Under the dev server, Alt-click a string on the page to open its entry in the editor. On by default. */\n  inspect?: boolean;\n}\n\nconst inspectorPath = beside(import.meta.url, 'inspector');\n\nconst describe = (e: unknown) => (e instanceof CatalogError ? e.message : e instanceof Error ? (e.stack ?? e.message) : String(e));\nconst escape = (s: string) => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\nexport function prosebook(options: ProsebookBunOptions = {}): BunPlugin {\n  return {\n    name: 'prosebook',\n    async setup(build) {\n      const config = await loadConfig(resolve(options.root ?? process.cwd()), options.config);\n      let generated = generate(config);\n      // The generated modules, by path as Bun gives it: either separator on Windows.\n      const folder = config.out.split(/[\\\\/]/).map(escape).join('[\\\\\\\\/]');\n      const filter = new RegExp(`^${folder}[\\\\\\\\/][^\\\\\\\\/]+\\\\.[jt]s$`);\n      const nameOf = (path: string) => basename(path).replace(/\\.[jt]s$/, '');\n\n      if ('entrypoints' in build.config) {\n        const prune = options.prune ?? 'strict';\n        if (prune === false) return;\n        const { refs, unseen } = scanSources(config, prune === 'strict');\n        if (unseen.length > 0) throw new Error(unseenMessage(unseen, config.root));\n        const kept = keeper(refs, options.keep);\n        build.onLoad({ filter }, ({ path }) => {\n          const entries = generated.entries.get(nameOf(path));\n          return entries === undefined ? undefined : { contents: prunedModule(entries, kept), loader: 'js' };\n        });\n        return;\n      }\n\n      const dev = process.env.NODE_ENV !== 'production';\n      const inspector = dev && options.inspect !== false ? installInspector(inspectorPath, '/') : '';\n      if (dev) {\n        watchCatalog(config, () => {\n          try {\n            generated = generate(config);\n          } catch (e) {\n            console.error(describe(e));\n          }\n        });\n      }\n      build.onLoad({ filter }, ({ path }) => {\n        const name = nameOf(path);\n        const loader = path.endsWith('.ts') ? 'ts' : 'js';\n        if (generated.entries.has(name)) return { contents: readFileSync(path, 'utf8') + hotLocale(name), loader };\n        return name === 'index' ? { contents: HOT_SET + inspector + readFileSync(path, 'utf8') + HOT_INDEX, loader } : undefined;\n      });\n    },\n  };\n}\n\nexport interface InspectorRoutesOptions {\n  /** The config, inline. Without it, `prosebook.config.*` at `root` is read. */\n  config?: ProsebookConfig;\n  /** The folder the config's paths resolve from, and where its file is found: the working directory when unset. */\n  root?: string;\n}\n\n/**\n * The inspector's endpoints as `Bun.serve` routes: `routes: { ...inspector(), '/': index }`. For dev\n * only: they read and write the catalog.\n */\nexport function inspector(options: InspectorRoutesOptions = {}): Record<string, (req: Request) => Promise<Response>> {\n  const handle = inspectorEndpoints(loadConfig(resolve(options.root ?? process.cwd()), options.config), {\n    open: ({ file, line, column }) => {\n      try {\n        Bun.openInEditor(file, { line, column });\n        return new Response(null, { status: 204 });\n      } catch (e) {\n        return new Response(`${e instanceof Error ? e.message : String(e)}: set VISUAL or EDITOR to the editor's command`, { status: 500 });\n      }\n    },\n  });\n  const route = async (req: Request) => (await handle(req)) ?? new Response(null, { status: 404 });\n  return { '/__prosebook/open': route, '/__prosebook/entry': route };\n}\n\n// bunfig.toml names the module, and Bun takes its default export as the plugin.\nexport default prosebook();\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAsDA,MAAM,gBAAgB,OAAO,YAAY,KAAK,WAAW;AAEzD,MAAM,YAAY,MAAgB,aAAa,eAAe,EAAE,UAAU,aAAa,QAAS,EAAE,SAAS,EAAE,UAAW,OAAO,CAAC;AAChI,MAAM,UAAU,MAAc,EAAE,QAAQ,uBAAuB,MAAM;AAErE,SAAgB,UAAU,UAA+B,CAAC,GAAc;CACtE,OAAO;EACL,MAAM;EACN,MAAM,MAAM,OAAO;GACjB,MAAM,SAAS,MAAM,WAAW,QAAQ,QAAQ,QAAQ,QAAQ,IAAI,CAAC,GAAG,QAAQ,MAAM;GACtF,IAAI,YAAY,SAAS,MAAM;GAE/B,MAAM,SAAS,OAAO,IAAI,MAAM,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,SAAS;GACnE,MAAM,SAAS,IAAI,OAAO,IAAI,OAAO,0BAA0B;GAC/D,MAAM,UAAU,SAAiB,SAAS,IAAI,CAAC,CAAC,QAAQ,YAAY,EAAE;GAEtE,IAAI,iBAAiB,MAAM,QAAQ;IACjC,MAAM,QAAQ,QAAQ,SAAS;IAC/B,IAAI,UAAU,OAAO;IACrB,MAAM,EAAE,MAAM,WAAW,YAAY,QAAQ,UAAU,QAAQ;IAC/D,IAAI,OAAO,SAAS,GAAG,MAAM,IAAI,MAAM,cAAc,QAAQ,OAAO,IAAI,CAAC;IACzE,MAAM,OAAO,OAAO,MAAM,QAAQ,IAAI;IACtC,MAAM,OAAO,EAAE,OAAO,IAAI,EAAE,WAAW;KACrC,MAAM,UAAU,UAAU,QAAQ,IAAI,OAAO,IAAI,CAAC;KAClD,OAAO,YAAY,KAAA,IAAY,KAAA,IAAY;MAAE,UAAU,aAAa,SAAS,IAAI;MAAG,QAAQ;KAAK;IACnG,CAAC;IACD;GACF;GAEA,MAAM,MAAM,QAAQ,IAAI,aAAa;GACrC,MAAM,YAAY,OAAO,QAAQ,YAAY,QAAQ,iBAAiB,eAAe,GAAG,IAAI;GAC5F,IAAI,KACF,aAAa,cAAc;IACzB,IAAI;KACF,YAAY,SAAS,MAAM;IAC7B,SAAS,GAAG;KACV,QAAQ,MAAM,SAAS,CAAC,CAAC;IAC3B;GACF,CAAC;GAEH,MAAM,OAAO,EAAE,OAAO,IAAI,EAAE,WAAW;IACrC,MAAM,OAAO,OAAO,IAAI;IACxB,MAAM,SAAS,KAAK,SAAS,KAAK,IAAI,OAAO;IAC7C,IAAI,UAAU,QAAQ,IAAI,IAAI,GAAG,OAAO;KAAE,UAAU,aAAa,MAAM,MAAM,IAAI,UAAU,IAAI;KAAG;IAAO;IACzG,OAAO,SAAS,UAAU;KAAE,UAAU,UAAU,YAAY,aAAa,MAAM,MAAM,IAAI;KAAW;IAAO,IAAI,KAAA;GACjH,CAAC;EACH;CACF;AACF;;;;;AAaA,SAAgB,UAAU,UAAkC,CAAC,GAAwD;CACnH,MAAM,SAAS,mBAAmB,WAAW,QAAQ,QAAQ,QAAQ,QAAQ,IAAI,CAAC,GAAG,QAAQ,MAAM,GAAG,EACpG,OAAO,EAAE,MAAM,MAAM,aAAa;EAChC,IAAI;GACF,IAAI,aAAa,MAAM;IAAE;IAAM;GAAO,CAAC;GACvC,OAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;EAC3C,SAAS,GAAG;GACV,OAAO,IAAI,SAAS,GAAG,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,EAAE,iDAAiD,EAAE,QAAQ,IAAI,CAAC;EACpI;CACF,EACF,CAAC;CACD,MAAM,QAAQ,OAAO,QAAkB,MAAM,OAAO,GAAG,KAAM,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;CAC/F,OAAO;EAAE,qBAAqB;EAAO,sBAAsB;CAAM;AACnE;AAGA,IAAA,cAAe,UAAU"}
+{"version":3,"file":"bun.js","names":[],"sources":["../src/bun.ts"],"sourcesContent":["/**\n * `prosebook/bun`: the catalog as part of a Bun build, or of Bun's dev server.\n *\n * Generates when the plugin is set up. Given to `Bun.build`, it ships only the messages the code\n * names: Bun loads a locale module before it has seen the code that reads it, so the keys come from\n * the source under `scan.dirs` (`tools/bundle.ts`) and each locale loads already pruned. The `bun\n * build` command reads no plugins, so a build that prunes is a script that calls `Bun.build`.\n *\n * Named in bunfig.toml's `[serve.static] plugins`, it serves `Bun.serve`'s bundler instead, which\n * names no entry points: it regenerates whenever a catalog or translation file changes, and each\n * locale module accepts its own update and hands the new messages to every copy, as under Vite. The\n * index starts the inspector on the page too, whose endpoints are `inspector()`'s routes, spread into\n * `Bun.serve`'s; an entry opens in the editor `Bun.openInEditor` finds.\n *\n * With `split`, the page's catalog is split by area as the Vite plugin's is (`tools/bundle.ts`): each\n * source file under `scan.dirs` naming an area's keys imports the area, a module of the plugin's own\n * namespace. Bun has no transform hook, so those files are read here and handed back. A build knows\n * the keys it keeps before it loads anything, so each area loads already pruned, and which areas\n * share a chunk (`tools/chunks.ts`), so a lazy locale's part is a file per group of them.\n */\nimport { readFileSync } from 'node:fs';\nimport { basename, resolve } from 'node:path';\n\nimport type { BunPlugin } from 'bun';\n\nimport {\n  AREA,\n  areaModule,\n  areasNamed,\n  lazyAreas,\n  beside,\n  HOT_INDEX,\n  HOT_SET,\n  hotLocale,\n  importingAreas,\n  inAreas,\n  installInspector,\n  keeper,\n  membersOf,\n  prunedModule,\n  scanSources,\n  splitIndex,\n  unseenMessage,\n  watchCatalog,\n  type Prune,\n} from './tools/bundle.ts';\nimport { CatalogError } from './tools/catalog.ts';\nimport { areaGroups } from './tools/chunks.ts';\nimport { compileLocale, localeExpression, type Entry } from './tools/compile.ts';\nimport { loadConfig, type ProsebookConfig } from './tools/config.ts';\nimport { inspectorEndpoints } from './tools/endpoints.ts';\nimport { generate } from './tools/generate.ts';\n\nexport interface ProsebookBunOptions {\n  /** The config, inline. Without it, `prosebook.config.*` at `root` is read. */\n  config?: ProsebookConfig;\n  /** The folder the config's paths resolve from, and where its file is found: the working directory when unset. */\n  root?: string;\n  /**\n   * In `Bun.build`, ship only the messages the code names. `strict`, the default, also fails the\n   * build on a read whose key it can't see, such as `t(item.key)`. `loose` prunes without that\n   * check; `false` ships every message.\n   */\n  prune?: Prune;\n  /**\n   * Keys a build always keeps, exactly or as `prefix.*`: for keys built at runtime from data. With\n   * `split`, their areas load with the catalog.\n   */\n  keep?: string[];\n  /**\n   * Split each locale by area in the page, as the Vite plugin's `split` does, so a lazy route loads\n   * only the messages it reads. `Bun.build` needs `splitting: true`. A server's own code loads whole\n   * locales.\n   */\n  split?: boolean;\n  /** Under the dev server, Alt-click a string on the page to open its entry in the editor. On by default. */\n  inspect?: boolean;\n}\n\nconst inspectorPath = beside(import.meta.url, 'inspector');\nconst NAMESPACE = 'prosebook-area';\n\nconst describe = (e: unknown) => (e instanceof CatalogError ? e.message : e instanceof Error ? (e.stack ?? e.message) : String(e));\nconst escape = (s: string) => s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n/** A folder's path as a pattern, by either separator: Bun gives paths with either on Windows. */\nconst folderPattern = (path: string) => path.split(/[\\\\/]/).map(escape).join('[\\\\\\\\/]');\n\nexport function prosebook(options: ProsebookBunOptions = {}): BunPlugin {\n  return {\n    name: 'prosebook',\n    async setup(build) {\n      const config = await loadConfig(resolve(options.root ?? process.cwd()), options.config);\n      let generated = generate(config);\n      // The generated modules, by path as Bun gives it.\n      const filter = new RegExp(`^${folderPattern(config.out)}[\\\\\\\\/][^\\\\\\\\/]+\\\\.[jt]s$`);\n      const nameOf = (path: string) => basename(path).replace(/\\.[jt]s$/, '');\n      const building = 'entrypoints' in build.config;\n      const split = options.split === true;\n      if (building && split && build.config.splitting !== true)\n        throw new Error('prosebook: `split` needs `splitting: true` in Bun.build, or every area ships in the entry chunk');\n      // A full-stack build, one `Bun.build` of a server and the pages it imports, names the side it\n      // loads for (undocumented, and not in Bun's types); any other build is for its target.\n      const client = (args: object) => ('side' in args ? args.side === 'client' : (build.config.target ?? 'browser') === 'browser');\n\n      const prune = options.prune ?? 'strict';\n      let kept: (key: string) => boolean = () => true;\n      if (building && prune !== false) {\n        const { refs, unseen } = scanSources(config, prune === 'strict');\n        if (unseen.length > 0) throw new Error(unseenMessage(unseen, config.root));\n        kept = keeper(refs, options.keep);\n      }\n      const dev = !building && process.env.NODE_ENV !== 'production';\n      const inspector = dev && options.inspect !== false ? installInspector(inspectorPath, '/') : '';\n      if (dev) {\n        watchCatalog(config, () => {\n          try {\n            generated = generate(config);\n          } catch (e) {\n            console.error(describe(e));\n          }\n        });\n      }\n\n      build.onLoad({ filter }, (args) => {\n        const name = nameOf(args.path);\n        if (name === 'index' && split && client(args)) {\n          const index = splitIndex(config, generated, options.keep);\n          return { contents: building ? index : HOT_SET + inspector + index + HOT_INDEX, loader: 'js' };\n        }\n        const entries = generated.entries.get(name);\n        if (building) return entries === undefined || prune === false ? undefined : { contents: prunedModule(entries, kept), loader: 'js' };\n        const loader = args.path.endsWith('.ts') ? 'ts' : 'js';\n        if (entries !== undefined) return { contents: readFileSync(args.path, 'utf8') + hotLocale(name), loader };\n        return name === 'index' ? { contents: HOT_SET + inspector + readFileSync(args.path, 'utf8') + HOT_INDEX, loader } : undefined;\n      });\n      if (!split) return;\n\n      const groups = building ? areaGroups(config, generated, options.keep) : new Map<string, string>();\n      // `cart`, or in a build `cart/de`, a lazy locale's part of the group `cart` leads.\n      build.onResolve({ filter: new RegExp(`^${escape(AREA)}`) }, ({ path }) => ({ path: path.slice(AREA.length), namespace: NAMESPACE }));\n      build.onLoad({ filter: /.*/, namespace: NAMESPACE }, ({ path }) => {\n        const [area = '', locale] = path.split('/');\n        if (locale !== undefined) {\n          const entries = inAreas(generated.entries.get(locale) ?? [], membersOf(groups, area));\n          return { contents: prunedModule(entries, kept), loader: 'js' };\n        }\n        const inline = building ? (_locale: string, entries: Entry[]) => localeExpression(compileLocale(entries, kept)) : undefined;\n        return { contents: areaModule(config, generated, area, inline, undefined, groups), loader: 'js' };\n      });\n      const dirs = config.scan.dirs.map((dir) => folderPattern(resolve(config.root, dir))).join('|');\n      const out = new RegExp(`^${folderPattern(config.out)}[\\\\\\\\/]`);\n      build.onLoad({ filter: new RegExp(`^(?:${dirs})[\\\\\\\\/].*\\\\.[cm]?[jt]sx?$`) }, (args) => {\n        if (!client(args) || out.test(args.path) || /[\\\\/]node_modules[\\\\/]/.test(args.path)) return undefined;\n        const code = readFileSync(args.path, 'utf8');\n        const areas = areasNamed(code, lazyAreas(generated, options.keep));\n        return areas.length === 0 ? undefined : { contents: importingAreas(code, args.path, areas), loader: args.loader };\n      });\n    },\n  };\n}\n\nexport interface InspectorRoutesOptions {\n  /** The config, inline. Without it, `prosebook.config.*` at `root` is read. */\n  config?: ProsebookConfig;\n  /** The folder the config's paths resolve from, and where its file is found: the working directory when unset. */\n  root?: string;\n}\n\n/**\n * The inspector's endpoints as `Bun.serve` routes: `routes: { ...inspector(), '/': index }`. For dev\n * only: they read and write the catalog.\n */\nexport function inspector(options: InspectorRoutesOptions = {}): Record<string, (req: Request) => Promise<Response>> {\n  const handle = inspectorEndpoints(loadConfig(resolve(options.root ?? process.cwd()), options.config), {\n    open: ({ file, line, column }) => {\n      try {\n        Bun.openInEditor(file, { line, column });\n        return new Response(null, { status: 204 });\n      } catch (e) {\n        return new Response(`${e instanceof Error ? e.message : String(e)}: set VISUAL or EDITOR to the editor's command`, { status: 500 });\n      }\n    },\n  });\n  const route = async (req: Request) => (await handle(req)) ?? new Response(null, { status: 404 });\n  return { '/__prosebook/open': route, '/__prosebook/entry': route };\n}\n\n// bunfig.toml names the module, and Bun takes its default export as the plugin.\nexport default prosebook();\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+EA,MAAM,gBAAgB,OAAO,YAAY,KAAK,WAAW;AACzD,MAAM,YAAY;AAElB,MAAM,YAAY,MAAgB,aAAa,eAAe,EAAE,UAAU,aAAa,QAAS,EAAE,SAAS,EAAE,UAAW,OAAO,CAAC;AAChI,MAAM,UAAU,MAAc,EAAE,QAAQ,uBAAuB,MAAM;;AAErE,MAAM,iBAAiB,SAAiB,KAAK,MAAM,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,SAAS;AAEtF,SAAgB,UAAU,UAA+B,CAAC,GAAc;CACtE,OAAO;EACL,MAAM;EACN,MAAM,MAAM,OAAO;GACjB,MAAM,SAAS,MAAM,WAAW,QAAQ,QAAQ,QAAQ,QAAQ,IAAI,CAAC,GAAG,QAAQ,MAAM;GACtF,IAAI,YAAY,SAAS,MAAM;GAE/B,MAAM,SAAS,IAAI,OAAO,IAAI,cAAc,OAAO,GAAG,EAAE,0BAA0B;GAClF,MAAM,UAAU,SAAiB,SAAS,IAAI,CAAC,CAAC,QAAQ,YAAY,EAAE;GACtE,MAAM,WAAW,iBAAiB,MAAM;GACxC,MAAM,QAAQ,QAAQ,UAAU;GAChC,IAAI,YAAY,SAAS,MAAM,OAAO,cAAc,MAClD,MAAM,IAAI,MAAM,iGAAiG;GAGnH,MAAM,UAAU,SAAkB,UAAU,OAAO,KAAK,SAAS,YAAY,MAAM,OAAO,UAAU,eAAe;GAEnH,MAAM,QAAQ,QAAQ,SAAS;GAC/B,IAAI,aAAuC;GAC3C,IAAI,YAAY,UAAU,OAAO;IAC/B,MAAM,EAAE,MAAM,WAAW,YAAY,QAAQ,UAAU,QAAQ;IAC/D,IAAI,OAAO,SAAS,GAAG,MAAM,IAAI,MAAM,cAAc,QAAQ,OAAO,IAAI,CAAC;IACzE,OAAO,OAAO,MAAM,QAAQ,IAAI;GAClC;GACA,MAAM,MAAM,CAAC,YAAY,QAAQ,IAAI,aAAa;GAClD,MAAM,YAAY,OAAO,QAAQ,YAAY,QAAQ,iBAAiB,eAAe,GAAG,IAAI;GAC5F,IAAI,KACF,aAAa,cAAc;IACzB,IAAI;KACF,YAAY,SAAS,MAAM;IAC7B,SAAS,GAAG;KACV,QAAQ,MAAM,SAAS,CAAC,CAAC;IAC3B;GACF,CAAC;GAGH,MAAM,OAAO,EAAE,OAAO,IAAI,SAAS;IACjC,MAAM,OAAO,OAAO,KAAK,IAAI;IAC7B,IAAI,SAAS,WAAW,SAAS,OAAO,IAAI,GAAG;KAC7C,MAAM,QAAQ,WAAW,QAAQ,WAAW,QAAQ,IAAI;KACxD,OAAO;MAAE,UAAU,WAAW,QAAQ,UAAU,YAAY,QAAQ;MAAW,QAAQ;KAAK;IAC9F;IACA,MAAM,UAAU,UAAU,QAAQ,IAAI,IAAI;IAC1C,IAAI,UAAU,OAAO,YAAY,KAAA,KAAa,UAAU,QAAQ,KAAA,IAAY;KAAE,UAAU,aAAa,SAAS,IAAI;KAAG,QAAQ;IAAK;IAClI,MAAM,SAAS,KAAK,KAAK,SAAS,KAAK,IAAI,OAAO;IAClD,IAAI,YAAY,KAAA,GAAW,OAAO;KAAE,UAAU,aAAa,KAAK,MAAM,MAAM,IAAI,UAAU,IAAI;KAAG;IAAO;IACxG,OAAO,SAAS,UAAU;KAAE,UAAU,UAAU,YAAY,aAAa,KAAK,MAAM,MAAM,IAAI;KAAW;IAAO,IAAI,KAAA;GACtH,CAAC;GACD,IAAI,CAAC,OAAO;GAEZ,MAAM,SAAS,WAAW,WAAW,QAAQ,WAAW,QAAQ,IAAI,oBAAI,IAAI,IAAoB;GAEhG,MAAM,UAAU,EAAE,QAAQ,IAAI,OAAO,IAAI,OAAO,IAAI,GAAG,EAAE,IAAI,EAAE,YAAY;IAAE,MAAM,KAAK,MAAM,KAAK,MAAM;IAAG,WAAW;GAAU,EAAE;GACnI,MAAM,OAAO;IAAE,QAAQ;IAAM,WAAW;GAAU,IAAI,EAAE,WAAW;IACjE,MAAM,CAAC,OAAO,IAAI,UAAU,KAAK,MAAM,GAAG;IAC1C,IAAI,WAAW,KAAA,GAAW;KACxB,MAAM,UAAU,QAAQ,UAAU,QAAQ,IAAI,MAAM,KAAK,CAAC,GAAG,UAAU,QAAQ,IAAI,CAAC;KACpF,OAAO;MAAE,UAAU,aAAa,SAAS,IAAI;MAAG,QAAQ;KAAK;IAC/D;IAEA,OAAO;KAAE,UAAU,WAAW,QAAQ,WAAW,MADlC,YAAY,SAAiB,YAAqB,iBAAiB,cAAc,SAAS,IAAI,CAAC,IAAI,KAAA,GACnD,KAAA,GAAW,MAAM;KAAG,QAAQ;IAAK;GAClG,CAAC;GACD,MAAM,OAAO,OAAO,KAAK,KAAK,KAAK,QAAQ,cAAc,QAAQ,OAAO,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG;GAC7F,MAAM,MAAM,IAAI,OAAO,IAAI,cAAc,OAAO,GAAG,EAAE,QAAQ;GAC7D,MAAM,OAAO,EAAE,QAAQ,IAAI,OAAO,OAAO,KAAK,2BAA2B,EAAE,IAAI,SAAS;IACtF,IAAI,CAAC,OAAO,IAAI,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,yBAAyB,KAAK,KAAK,IAAI,GAAG,OAAO,KAAA;IAC7F,MAAM,OAAO,aAAa,KAAK,MAAM,MAAM;IAC3C,MAAM,QAAQ,WAAW,MAAM,UAAU,WAAW,QAAQ,IAAI,CAAC;IACjE,OAAO,MAAM,WAAW,IAAI,KAAA,IAAY;KAAE,UAAU,eAAe,MAAM,KAAK,MAAM,KAAK;KAAG,QAAQ,KAAK;IAAO;GAClH,CAAC;EACH;CACF;AACF;;;;;AAaA,SAAgB,UAAU,UAAkC,CAAC,GAAwD;CACnH,MAAM,SAAS,mBAAmB,WAAW,QAAQ,QAAQ,QAAQ,QAAQ,IAAI,CAAC,GAAG,QAAQ,MAAM,GAAG,EACpG,OAAO,EAAE,MAAM,MAAM,aAAa;EAChC,IAAI;GACF,IAAI,aAAa,MAAM;IAAE;IAAM;GAAO,CAAC;GACvC,OAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;EAC3C,SAAS,GAAG;GACV,OAAO,IAAI,SAAS,GAAG,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,EAAE,iDAAiD,EAAE,QAAQ,IAAI,CAAC;EACpI;CACF,EACF,CAAC;CACD,MAAM,QAAQ,OAAO,QAAkB,MAAM,OAAO,GAAG,KAAM,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;CAC/F,OAAO;EAAE,qBAAqB;EAAO,sBAAsB;CAAM;AACnE;AAGA,IAAA,cAAe,UAAU"}

package/dist/{bundle-KD-DiiFa.d.ts → bundle-CLHY_97D.d.ts}

@@ -1,6 +1,6 @@
-import "./compile-xF3F4oIp.js";
-import "./config-DdMkKt_N.js";
+import "./generate-1BeQAd1O.js";
+import "./config-CzaJJQ60.js";
 /** How a build prunes: `strict` also fails on a read whose key it can't see. */
 type Prune = 'strict' | 'loose' | false;
 export { Prune as t };
-//# sourceMappingURL=bundle-KD-DiiFa.d.ts.map
+//# sourceMappingURL=bundle-CLHY_97D.d.ts.map

package/dist/bundle-CLHY_97D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-CLHY_97D.d.ts","names":[],"sources":["../src/tools/bundle.ts"],"mappings":";;;KAkBY"}

package/dist/bundle-Ut6Y2X6N.js

@@ -0,0 +1,217 @@
+import { a as keyRefs, d as compileLocale, i as isReferenced, l as sourceFiles, n as SFC, p as localeModule, t as READERS, u as unseenReads } from "./scan-C0ap4Mpp.js";
+import { existsSync, readFileSync, watch } from "node:fs";
+import { join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+// src/tools/bundle.ts
+/**
+* What the bundler integrations share: which messages a build ships, the reads that would show a key
+* once their message is pruned, and the code a dev server appends so an edit swaps messages in place.
+*
+* Vite sees every module before it writes a chunk, so it prunes after the fact (`vite.ts`). Next's
+* loaders and Bun's `onLoad` hand over a locale module before the code that reads it has been seen,
+* so they read the source under `scan.dirs` first (`scanSources`) and load the locale already pruned.
+*/
+/** Whether a build keeps a key: some module names it, or `keep` lists it, exactly or as `prefix.*`. */
+function keeper(refs, keep = []) {
+	return (key) => isReferenced(key, refs) || keep.some((k) => k.endsWith(".*") ? key.startsWith(k.slice(0, -1)) : k === key);
+}
+/** The unseen reads that are a copy's: a name only counts once some module binds a reader to it. */
+function unseenOf(reads) {
+	const all = [...reads];
+	const readers = /* @__PURE__ */ new Set([...READERS, ...all.flatMap((r) => [...r.aliases])]);
+	return all.flatMap((r) => r.unseen).filter((u) => u.name === "Text" || readers.has(u.name));
+}
+/** The error a strict build fails with, each read at its path from `root`. */
+function unseenMessage(unseen, root) {
+	const at = (file) => relative(root, file).replaceAll("\\", "/");
+	return [
+		`${unseen.length} read(s) whose key the build can't see, so their messages would be pruned and the key shown instead:`,
+		...unseen.map((u) => `  ${at(u.file)}:${u.line}:${u.column}  ${u.code}`),
+		"Write each key at the read, as a literal or `area.${id}`; or, where every key it reads is written elsewhere or listed in `keep`, mark the line `prosebook-ignore`. `prune: \"loose\"` turns this check off."
+	].join("\n");
+}
+/**
+* Every key the app's source names and, with `strict`, its unseen reads. The generated modules are
+* left out, since they name every key.
+*/
+function scanSources(config, strict) {
+	const refs = {
+		exact: /* @__PURE__ */ new Set(),
+		prefixes: /* @__PURE__ */ new Set()
+	};
+	const reads = [];
+	for (const file of sourceFiles(config.scan.dirs, config.scan.extensions, [config.out])) {
+		const code = readFileSync(file, "utf8");
+		keyRefs(code, refs);
+		if (strict) reads.push(unseenReads(file, code));
+	}
+	return {
+		refs,
+		unseen: unseenOf(reads)
+	};
+}
+/** Calls `change` once a burst of edits to the catalog or its translations settles. Returns the stop. */
+function watchCatalog(config, change) {
+	let timer;
+	const watchers = [config.catalog, config.locales].filter((dir) => existsSync(dir)).map((dir) => watch(dir, { recursive: true }, (_event, file) => {
+		if (file === null || !file.endsWith(".yaml")) return;
+		clearTimeout(timer);
+		timer = setTimeout(change, 50);
+	}));
+	return () => {
+		clearTimeout(timer);
+		for (const w of watchers) w.close();
+	};
+}
+/** `virtual:prosebook/area/cart`, and in a build `…/cart/de`, a lazy locale's part of the group `cart` leads. */
+const AREA = "virtual:prosebook/area/";
+const VIRTUAL = {
+	area: (area, locale) => AREA + area + (locale === void 0 ? "" : `/${locale}`),
+	generated: (path) => path
+};
+/** `path` imported from a module in the folder `from`, as a relative specifier. */
+function relativeImport(from, path) {
+	const to = relative(from, path).replaceAll("\\", "/");
+	return to.startsWith(".") ? to : `./${to}`;
+}
+/** An area's file, or a lazy locale's part of a group, where a bundler without virtual modules finds them. */
+const areaFile = (area, locale) => locale === void 0 ? `${area}.js` : `${area}.${locale}.js`;
+/** The specifiers of area files in `dir`, from a module in the folder `from`. */
+const fileSpecifiers = (from, dir) => ({
+	area: (area, locale) => relativeImport(from, join(dir, areaFile(area, locale))),
+	generated: (path) => relativeImport(from, path)
+});
+const areaOf = (key) => key.slice(0, key.indexOf("."));
+/** The entries of some areas: their keys start with an area's name. */
+const inAreas = (entries, areas) => entries.filter(([key]) => areas.includes(areaOf(key)));
+/** The areas whose lazy locales load from the group `lead` names. */
+const membersOf = (groups, lead) => [...groups].filter(([, g]) => g === lead).map(([area]) => area);
+const areasOf = (generated) => new Set(generated.catalog.messages.map((m) => m.area));
+/** Areas `keep` names, which load with the index of a split catalog, as no module may name their keys. */
+const eagerAreas = (generated, keep = []) => {
+	const known = areasOf(generated);
+	return new Set(keep.map(areaOf).filter((a) => known.has(a)));
+};
+/** The areas that load with the code naming their keys: all but those `keep` loads with the index. */
+const lazyAreas = (generated, keep) => {
+	const eager = eagerAreas(generated, keep);
+	return new Set([...areasOf(generated)].filter((a) => !eager.has(a)));
+};
+/** Which of `areas` the keys `code` names are in. */
+function areasNamed(code, areas) {
+	const named = keyRefs(code);
+	return [...new Set([...named.exact, ...named.prefixes].map(areaOf))].filter((a) => areas.has(a)).toSorted();
+}
+/**
+* `code` importing each of `areas`. At the end, as imports run first wherever they are, so no line
+* moves; in a component file, at the end of its first script.
+*/
+function importingAreas(code, path, areas, specifier = VIRTUAL.area) {
+	const imports = areas.map((a) => `import ${JSON.stringify(specifier(a))};`).join("");
+	if (!SFC.test(path)) return `${code}\n${imports}\n`;
+	const close = code.indexOf("<\/script>");
+	return close === -1 ? `${code}\n<script>${imports}<\/script>\n` : `${code.slice(0, close)};${imports}${code.slice(close)}`;
+}
+/** What a split catalog's areas register under: the generated folder, from the config's. */
+const splitId = (config) => relative(config.root, config.out).replaceAll("\\", "/");
+/** A generated module's path, with forward slashes. */
+const generatedPath = (config, name) => join(config.out, `${name}.${config.language === "ts" ? "ts" : "js"}`).replaceAll("\\", "/");
+/** The index of a split catalog, in the browser: no messages of its own, only the areas `keep` names. */
+function splitIndex(config, generated, keep, where = VIRTUAL) {
+	const locales = [...generated.entries.keys()];
+	const split = {
+		id: splitId(config),
+		areas: [...areasOf(generated)]
+	};
+	return [
+		"import { defineCatalog } from 'prosebook';",
+		...[...eagerAreas(generated, keep)].map((a) => `import ${JSON.stringify(where.area(a))};`),
+		`export const catalog = defineCatalog(${JSON.stringify({
+			source: config.source,
+			locales,
+			messages: {},
+			loaders: {},
+			split
+		})});`,
+		""
+	].join("\n");
+}
+/**
+* An area's module: registers its messages in the locales that ship with it, and loaders for the
+* rest, and waits until every copy holds it. In a build, `inline` writes the first, and each of the
+* rest loads its part of the area's group, shared with the areas `groups` puts beside it, which the
+* copy takes only this area's keys from; in dev, without it, each locale is its generated module
+* whole, so an edit updates it as it would without splitting.
+*/
+function areaModule(config, generated, area, inline, where = VIRTUAL, groups = /* @__PURE__ */ new Map()) {
+	const lines = ["import { addArea } from 'prosebook';"];
+	const messages = [];
+	const loaders = [];
+	for (const [locale, entries] of generated.entries) {
+		const name = JSON.stringify(locale);
+		const own = inAreas(entries, [area]);
+		const whole = JSON.stringify(where.generated(generatedPath(config, locale)));
+		if (locale === config.source || config.bundled.includes(locale)) {
+			if (inline !== void 0) messages.push(`${name}: ${inline(locale, own)}`);
+			else {
+				lines.push(`import m${messages.length} from ${whole};`);
+				messages.push(`${name}: m${messages.length}`);
+			}
+		} else if (inline === void 0) loaders.push(`${name}: () => import(${whole})`);
+		else if (own.length > 0) loaders.push(`${name}: () => import(${JSON.stringify(where.area(groups.get(area) ?? area, locale))})`);
+	}
+	const args = [
+		JSON.stringify(splitId(config)),
+		JSON.stringify(area),
+		`{ ${messages.join(", ")} }`,
+		`{ ${loaders.join(", ")} }`
+	];
+	lines.push(`await addArea(${args.join(", ")});`, "");
+	return lines.join("\n");
+}
+/** A locale's module holding only the keys `kept`, as JavaScript, for a bundler to load in its place. */
+function prunedModule(entries, kept) {
+	return localeModule(compileLocale(entries, kept), "// Pruned by prosebook: only the messages the code names.", false);
+}
+/**
+* Appended to a locale module in dev. Accepts its own update and hands the new messages to every
+* copy (`HotHook`); a page loaded before the hooks existed reloads instead.
+*/
+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);
+  });
+}
+`;
+/** Appended to the index in dev: its doc comments change with every edit; only a new locale reloads. */
+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();
+  });
+}
+`;
+/**
+* A locale module in dev under a bundler that runs it again when it changes, as Turbopack's Fast
+* Refresh does, but has no `import.meta.hot`: each run hands its messages to every copy. The first
+* run finds no copy holding the locale yet, so it changes nothing.
+*/
+const notifyingLocale = (code, locale) => `${code.replace(/^export default /m, "const messages = ")}
+export default messages;
+globalThis.__PROSEBOOK_HOT__?.forEach((update) => update(${JSON.stringify(locale)}, messages));
+`;
+/** Prepended to the index in dev, so the set every copy adds itself to exists before any copy does. */
+const HOT_SET = "globalThis.__PROSEBOOK_HOT__ ??= new Set();\n";
+/**
+* A module of prosebook's own beside the one at `url`, which passes its `import.meta.url`: the source
+* when run from source, the built file in dist.
+*/
+const beside = (url, name) => fileURLToPath(new URL(`./${name}${url.endsWith(".ts") ? ".ts" : ".js"}`, url)).replaceAll("\\", "/");
+/** Code that starts the inspector (`inspector.ts`, imported from `path`) on the page, its endpoints under `base`. */
+const installInspector = (path, base) => `import { install as installInspector } from ${JSON.stringify(path)};\ninstallInspector(${JSON.stringify({ base })});\n`;
+export { unseenMessage as C, splitIndex as S, watchCatalog as T, membersOf as _, areaModule as a, relativeImport as b, beside as c, hotLocale as d, importingAreas as f, lazyAreas as g, keeper as h, areaFile as i, eagerAreas as l, installInspector as m, HOT_INDEX as n, areasNamed as o, inAreas as p, HOT_SET as r, areasOf as s, AREA as t, fileSpecifiers as u, notifyingLocale as v, unseenOf as w, scanSources as x, prunedModule as y };
+
+//# sourceMappingURL=bundle-Ut6Y2X6N.js.map

package/dist/bundle-Ut6Y2X6N.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-Ut6Y2X6N.js","names":[],"sources":["../src/tools/bundle.ts"],"sourcesContent":["/**\n * What the bundler integrations share: which messages a build ships, the reads that would show a key\n * once their message is pruned, and the code a dev server appends so an edit swaps messages in place.\n *\n * Vite sees every module before it writes a chunk, so it prunes after the fact (`vite.ts`). Next's\n * loaders and Bun's `onLoad` hand over a locale module before the code that reads it has been seen,\n * so they read the source under `scan.dirs` first (`scanSources`) and load the locale already pruned.\n */\nimport { existsSync, readFileSync, watch } from 'node:fs';\nimport { join, relative } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { compileLocale, localeModule, type Entry } from './compile.ts';\nimport type { ResolvedConfig } from './config.ts';\nimport type { Generated } from './generate.ts';\nimport { isReferenced, keyRefs, READERS, SFC, sourceFiles, unseenReads, type KeyRefs, type Reads, type UnseenRead } from './scan.ts';\n\n/** How a build prunes: `strict` also fails on a read whose key it can't see. */\nexport type Prune = 'strict' | 'loose' | false;\n\n/** Whether a build keeps a key: some module names it, or `keep` lists it, exactly or as `prefix.*`. */\nexport function keeper(refs: KeyRefs, keep: string[] = []): (key: string) => boolean {\n  return (key) => isReferenced(key, refs) || keep.some((k) => (k.endsWith('.*') ? key.startsWith(k.slice(0, -1)) : k === key));\n}\n\n/** The unseen reads that are a copy's: a name only counts once some module binds a reader to it. */\nexport function unseenOf(reads: Iterable<Reads>): UnseenRead[] {\n  const all = [...reads];\n  const readers = new Set([...READERS, ...all.flatMap((r) => [...r.aliases])]);\n  return all.flatMap((r) => r.unseen).filter((u) => u.name === 'Text' || readers.has(u.name));\n}\n\n/** The error a strict build fails with, each read at its path from `root`. */\nexport function unseenMessage(unseen: UnseenRead[], root: string): string {\n  const at = (file: string) => relative(root, file).replaceAll('\\\\', '/');\n  return [\n    `${unseen.length} read(s) whose key the build can't see, so their messages would be pruned and the key shown instead:`,\n    ...unseen.map((u) => `  ${at(u.file)}:${u.line}:${u.column}  ${u.code}`),\n    'Write each key at the read, as a literal or `area.${id}`; or, where every key it reads is written elsewhere or listed in `keep`, mark the line `prosebook-ignore`. `prune: \"loose\"` turns this check off.',\n  ].join('\\n');\n}\n\nexport interface SourceScan {\n  refs: KeyRefs;\n  unseen: UnseenRead[];\n}\n\n/**\n * Every key the app's source names and, with `strict`, its unseen reads. The generated modules are\n * left out, since they name every key.\n */\nexport function scanSources(config: ResolvedConfig, strict: boolean): SourceScan {\n  const refs: KeyRefs = { exact: new Set(), prefixes: new Set() };\n  const reads: Reads[] = [];\n  for (const file of sourceFiles(config.scan.dirs, config.scan.extensions, [config.out])) {\n    const code = readFileSync(file, 'utf8');\n    keyRefs(code, refs);\n    if (strict) reads.push(unseenReads(file, code));\n  }\n  return { refs, unseen: unseenOf(reads) };\n}\n\n/** Calls `change` once a burst of edits to the catalog or its translations settles. Returns the stop. */\nexport function watchCatalog(config: ResolvedConfig, change: () => void): () => void {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const watchers = [config.catalog, config.locales]\n    .filter((dir) => existsSync(dir))\n    .map((dir) =>\n      watch(dir, { recursive: true }, (_event, file) => {\n        if (file === null || !file.endsWith('.yaml')) return;\n        clearTimeout(timer);\n        timer = setTimeout(change, 50);\n      }),\n    );\n  return () => {\n    clearTimeout(timer);\n    for (const w of watchers) w.close();\n  };\n}\n\n/** `virtual:prosebook/area/cart`, and in a build `…/cart/de`, a lazy locale's part of the group `cart` leads. */\nexport const AREA = 'virtual:prosebook/area/';\n\n/**\n * How a split catalog's modules are imported: an area (`cart`), a lazy locale's part of a group of\n * them, by the group's first area (`cart`, `de`), and a generated module, from its path. Vite's and Bun's are virtual modules (`VIRTUAL`);\n * Turbopack has none, so Next's are files.\n */\nexport interface Specifiers {\n  area: (area: string, locale?: string) => string;\n  generated: (path: string) => string;\n}\n\nexport const VIRTUAL: Specifiers = {\n  area: (area, locale) => AREA + area + (locale === undefined ? '' : `/${locale}`),\n  generated: (path) => path,\n};\n\n/** `path` imported from a module in the folder `from`, as a relative specifier. */\nexport function relativeImport(from: string, path: string): string {\n  const to = relative(from, path).replaceAll('\\\\', '/');\n  return to.startsWith('.') ? to : `./${to}`;\n}\n\n/** An area's file, or a lazy locale's part of a group, where a bundler without virtual modules finds them. */\nexport const areaFile = (area: string, locale?: string) => (locale === undefined ? `${area}.js` : `${area}.${locale}.js`);\n\n/** The specifiers of area files in `dir`, from a module in the folder `from`. */\nexport const fileSpecifiers = (from: string, dir: string): Specifiers => ({\n  area: (area, locale) => relativeImport(from, join(dir, areaFile(area, locale))),\n  generated: (path) => relativeImport(from, path),\n});\n\nexport const areaOf = (key: string) => key.slice(0, key.indexOf('.'));\n\n/** The entries of some areas: their keys start with an area's name. */\nexport const inAreas = (entries: Entry[], areas: readonly string[]) => entries.filter(([key]) => areas.includes(areaOf(key)));\n\n/**\n * Each area to the group whose file its lazy locales load from, named by the group's first area: the\n * areas a bundler puts in one chunk (`areaGroups` in `chunks.ts`), so they load in one request.\n */\nexport type Groups = ReadonlyMap<string, string>;\n\n/** The areas whose lazy locales load from the group `lead` names. */\nexport const membersOf = (groups: Groups, lead: string) => [...groups].filter(([, g]) => g === lead).map(([area]) => area);\n\nexport const areasOf = (generated: Generated) => new Set(generated.catalog.messages.map((m) => m.area));\n\n/** Areas `keep` names, which load with the index of a split catalog, as no module may name their keys. */\nexport const eagerAreas = (generated: Generated, keep: string[] = []) => {\n  const known = areasOf(generated);\n  return new Set(keep.map(areaOf).filter((a) => known.has(a)));\n};\n\n/** The areas that load with the code naming their keys: all but those `keep` loads with the index. */\nexport const lazyAreas = (generated: Generated, keep?: string[]) => {\n  const eager = eagerAreas(generated, keep);\n  return new Set([...areasOf(generated)].filter((a) => !eager.has(a)));\n};\n\n/** Which of `areas` the keys `code` names are in. */\nexport function areasNamed(code: string, areas: ReadonlySet<string>): string[] {\n  const named = keyRefs(code);\n  return [...new Set([...named.exact, ...named.prefixes].map(areaOf))].filter((a) => areas.has(a)).toSorted();\n}\n\n/**\n * `code` importing each of `areas`. At the end, as imports run first wherever they are, so no line\n * moves; in a component file, at the end of its first script.\n */\nexport function importingAreas(code: string, path: string, areas: string[], specifier = VIRTUAL.area): string {\n  const imports = areas.map((a) => `import ${JSON.stringify(specifier(a))};`).join('');\n  if (!SFC.test(path)) return `${code}\\n${imports}\\n`;\n  const close = code.indexOf('</script>');\n  return close === -1 ? `${code}\\n<script>${imports}</script>\\n` : `${code.slice(0, close)};${imports}${code.slice(close)}`;\n}\n\n/** What a split catalog's areas register under: the generated folder, from the config's. */\nconst splitId = (config: ResolvedConfig) => relative(config.root, config.out).replaceAll('\\\\', '/');\n\n/** A generated module's path, with forward slashes. */\nconst generatedPath = (config: ResolvedConfig, name: string) =>\n  join(config.out, `${name}.${config.language === 'ts' ? 'ts' : 'js'}`).replaceAll('\\\\', '/');\n\n/** The index of a split catalog, in the browser: no messages of its own, only the areas `keep` names. */\nexport function splitIndex(config: ResolvedConfig, generated: Generated, keep?: string[], where = VIRTUAL): string {\n  const locales = [...generated.entries.keys()];\n  const split = { id: splitId(config), areas: [...areasOf(generated)] };\n  return [\n    \"import { defineCatalog } from 'prosebook';\",\n    ...[...eagerAreas(generated, keep)].map((a) => `import ${JSON.stringify(where.area(a))};`),\n    `export const catalog = defineCatalog(${JSON.stringify({ source: config.source, locales, messages: {}, loaders: {}, split })});`,\n    '',\n  ].join('\\n');\n}\n\n/** How an area's module holds a locale that ships with it in a build: as an expression, from its entries. */\nexport type Inline = (locale: string, entries: Entry[]) => string;\n\n/**\n * An area's module: registers its messages in the locales that ship with it, and loaders for the\n * rest, and waits until every copy holds it. In a build, `inline` writes the first, and each of the\n * rest loads its part of the area's group, shared with the areas `groups` puts beside it, which the\n * copy takes only this area's keys from; in dev, without it, each locale is its generated module\n * whole, so an edit updates it as it would without splitting.\n */\nexport function areaModule(\n  config: ResolvedConfig,\n  generated: Generated,\n  area: string,\n  inline?: Inline,\n  where = VIRTUAL,\n  groups: Groups = new Map(),\n): string {\n  const lines = [\"import { addArea } from 'prosebook';\"];\n  const messages: string[] = [];\n  const loaders: string[] = [];\n  for (const [locale, entries] of generated.entries) {\n    const name = JSON.stringify(locale);\n    const own = inAreas(entries, [area]);\n    const whole = JSON.stringify(where.generated(generatedPath(config, locale)));\n    if (locale === config.source || config.bundled.includes(locale)) {\n      if (inline !== undefined) {\n        messages.push(`${name}: ${inline(locale, own)}`);\n      } else {\n        lines.push(`import m${messages.length} from ${whole};`);\n        messages.push(`${name}: m${messages.length}`);\n      }\n    } else if (inline === undefined) {\n      loaders.push(`${name}: () => import(${whole})`);\n    } else if (own.length > 0) {\n      loaders.push(`${name}: () => import(${JSON.stringify(where.area(groups.get(area) ?? area, locale))})`);\n    }\n  }\n  const args = [JSON.stringify(splitId(config)), JSON.stringify(area), `{ ${messages.join(', ')} }`, `{ ${loaders.join(', ')} }`];\n  lines.push(`await addArea(${args.join(', ')});`, '');\n  return lines.join('\\n');\n}\n\n/** A locale's module holding only the keys `kept`, as JavaScript, for a bundler to load in its place. */\nexport function prunedModule(entries: Entry[], kept: (key: string) => boolean): string {\n  return localeModule(compileLocale(entries, kept), '// Pruned by prosebook: only the messages the code names.', false);\n}\n\n/**\n * Appended to a locale module in dev. Accepts its own update and hands the new messages to every\n * copy (`HotHook`); a page loaded before the hooks existed reloads instead.\n */\nexport const 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\n/** Appended to the index in dev: its doc comments change with every edit; only a new locale reloads. */\nexport const 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\n/**\n * A locale module in dev under a bundler that runs it again when it changes, as Turbopack's Fast\n * Refresh does, but has no `import.meta.hot`: each run hands its messages to every copy. The first\n * run finds no copy holding the locale yet, so it changes nothing.\n */\nexport const notifyingLocale = (code: string, locale: string) =>\n  `${code.replace(/^export default /m, 'const messages = ')}\nexport default messages;\nglobalThis.__PROSEBOOK_HOT__?.forEach((update) => update(${JSON.stringify(locale)}, messages));\n`;\n\n/** Prepended to the index in dev, so the set every copy adds itself to exists before any copy does. */\nexport const HOT_SET = 'globalThis.__PROSEBOOK_HOT__ ??= new Set();\\n';\n\n/**\n * A module of prosebook's own beside the one at `url`, which passes its `import.meta.url`: the source\n * when run from source, the built file in dist.\n */\nexport const beside = (url: string, name: string) =>\n  fileURLToPath(new URL(`./${name}${url.endsWith('.ts') ? '.ts' : '.js'}`, url)).replaceAll('\\\\', '/');\n\n/** Code that starts the inspector (`inspector.ts`, imported from `path`) on the page, its endpoints under `base`. */\nexport const installInspector = (path: string, base: string) =>\n  `import { install as installInspector } from ${JSON.stringify(path)};\\ninstallInspector(${JSON.stringify({ base })});\\n`;\n"],"mappings":"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"}

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { f as watchCatalog } from "./bundle-DboItAre.js";
-import { D as whereOf, O as SYNTAX_NAME, _ as applyFixes, a as render, l as changeOf, n as generate, w as entryLocator, x as CatalogError, y as importTranslations } from "./generate-9pR3i5Bj.js";
-import { p as lint, r as loadConfig, t as CONFIG_FILES } from "./config-BPSmoYel.js";
-import { a as applyExtract, c as planExtract, i as planMigrate, n as todoOf, r as applyMigrate, t as SarifReport } from "./sarif-CWyTAQ0y.js";
-import { o as scan, r as isReferenced, s as sourceFiles } from "./scan-Bx0_yDSi.js";
-import { join, relative, resolve } from "node:path";
+import { T as watchCatalog } from "./bundle-Ut6Y2X6N.js";
+import { D as SCHEMA_LINE, M as whereOf, N as SYNTAX_NAME, T as CatalogError, _ as changeOf, a as render, d as importTranslations, g as todoOf, k as entryLocator, l as applyFixes, n as generate, p as exportOf } from "./generate-CKv86Iki.js";
+import { p as lint, r as loadConfig, t as CONFIG_FILES } from "./config-7T4hX_f7.js";
+import { i as applyExtract, n as applyMigrate, r as planMigrate, s as planExtract, t as SarifReport } from "./sarif-BnwYC78_.js";
+import { i as isReferenced, l as sourceFiles, s as scan } from "./scan-C0ap4Mpp.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, extname, join, relative, resolve } from "node:path";
 import { parseArgs } from "node:util";
 // src/cli.ts
 /**
@@ -25,8 +25,11 @@ Commands:
   accept <locale> [keys]  Mark stale translations as still right  (--all for every stale one)
   todo <locale>           Print the missing and stale entries of a locale, ready to translate
                           (--prompt: as a prompt for a model, saying how to reply)
-  import <locale> [file]  Write translations from todo's YAML filled in, or a model's reply to --prompt
-                          (stdin without a file); each is checked first, and one that fails is left out
+  export <locale> [file]  Write the entries todo lists as XLIFF 2.0 or JSON, for a translation tool
+                          (--all: every entry; the format from the file's extension, or --format)
+  import <locale> [file]  Write translations from todo's YAML filled in, a model's reply to --prompt,
+                          or a tool's XLIFF or JSON (stdin without a file); each is checked first,
+                          and one that fails is left out
   scan                    Find hardcoded text in JSX and catalog keys no code reads  (--strict)
   extract [paths]         Move hardcoded JSX text into the catalog and rewrite the code to read it
                           (dry run unless --write; --area <name> puts every entry in one area)
@@ -38,6 +41,7 @@ Options:
   --root <dir>            Project root (default: the current directory)
   --format <text|sarif>   With lint, scan, status and check: sarif writes a SARIF 2.1.0 log to stdout
                           for code scanning, and the usual text to stderr
+  --format <xliff|json>   With export: the file's format (XLIFF by default on stdout)
   -h, --help              Show this help
 `;
 const SARIF_COMMANDS = [
@@ -46,6 +50,11 @@ const SARIF_COMMANDS = [
 	"status",
 	"check"
 ];
+const EXCHANGE_FORMATS = {
+	xliff: "xliff",
+	xlf: "xliff",
+	json: "json"
+};
 /** What the checks that aren't lint rules hold the project to, for the rules in a SARIF log. */
 const RULES = {
 	catalog: "The catalog and its translations parse, and each translation keeps the placeholders of its source.",
@@ -86,7 +95,12 @@ async function main(argv) {
 		out(HELP);
 		return 0;
 	}
-	if (values.format !== void 0 && values.format !== "text" && values.format !== "sarif") {
+	if (command === "export") {
+		if (values.format !== void 0 && EXCHANGE_FORMATS[values.format] === void 0) {
+			err(`prosebook: export writes xliff or json, not "${values.format}"`);
+			return 1;
+		}
+	} else if (values.format !== void 0 && values.format !== "text" && values.format !== "sarif") {
 		err(`prosebook: --format is text or sarif, not "${values.format}"`);
 		return 1;
 	}
@@ -116,6 +130,7 @@ async function main(argv) {
 				break;
 			case "accept": return runAccept(config, rest, values.all === true);
 			case "todo": return runTodo(config, rest[0], values.prompt === true);
+			case "export": return runExport(config, rest[0], rest[1], values.format, values.all === true);
 			case "import": return runImport(config, rest[0], rest[1]);
 			case "scan":
 				code = runScan(config, values.strict === true, report);
@@ -177,12 +192,13 @@ function runGenerate(config, check, report) {
 			out(`prosebook: generated files are up to date (${summary})`);
 			return 0;
 		}
-		err(`prosebook: out of date, run \`prosebook generate\`:\n  ${changed.map((p) => rel(config, p)).join("\n  ")}`);
+		const why = (p) => dirname(p) === config.catalog && p.endsWith(".yaml") ? `its first line isn't \`${SCHEMA_LINE}\`, so editors can't find the schema` : "out of date";
+		err(`prosebook: out of date, run \`prosebook generate\`:\n  ${changed.map((p) => `${rel(config, p)}${why(p) === "out of date" ? "" : `: ${why(p)}`}`).join("\n  ")}`);
 		report?.rule("out-of-date", RULES["out-of-date"]);
 		for (const p of changed) report?.add({
 			rule: "out-of-date",
 			level: "error",
-			message: "out of date: run `prosebook generate`",
+			message: `${why(p)}: run \`prosebook generate\``,
 			file: rel(config, p)
 		});
 		return 1;
@@ -338,6 +354,33 @@ function runTodo(config, locale, prompt) {
 	if (prompt && todo.count > 0) err(`\nHand this to a model, save its reply, and \`prosebook import ${locale} <reply>\`.`);
 	return 0;
 }
+function runExport(config, locale, file, named, all) {
+	if (locale === void 0) {
+		err("Usage: prosebook export <locale> [file] [--all] [--format xliff|json]");
+		return 1;
+	}
+	const format = EXCHANGE_FORMATS[named ?? (file === void 0 ? "xliff" : extname(file).slice(1).toLowerCase())];
+	if (format === void 0) {
+		err(`prosebook: ${file} is neither .xlf nor .json: name the format with --format xliff or --format json`);
+		return 1;
+	}
+	const { catalog, stale } = render(config);
+	const exported = exportOf(config, catalog, stale.get(locale) ?? /* @__PURE__ */ new Map(), locale, format, all);
+	if (exported.count === 0) {
+		err(`prosebook: ${locale} is complete; --all exports every entry`);
+		return 0;
+	}
+	if (file === void 0) {
+		process.stdout.write(exported.text);
+		return 0;
+	}
+	const path = resolve(file);
+	mkdirSync(dirname(path), { recursive: true });
+	writeFileSync(path, exported.text);
+	out(`prosebook: exported ${exported.count} entr${exported.count === 1 ? "y" : "ies"} for ${locale} to ${file}`);
+	if (locale !== config.source) out(`Translate them, then \`prosebook import ${locale} ${file}\`.`);
+	return 0;
+}
 function runImport(config, locale, file) {
 	if (locale === void 0 || (file === void 0 || file === "-") && process.stdin.isTTY) {
 		err("Usage: prosebook import <locale> <file>, or the reply on stdin");
@@ -464,7 +507,7 @@ export default defineConfig({
   // messageFormat: 2,
 });
 `;
-const SAMPLE_CATALOG = `# yaml-language-server: $schema=./catalog.schema.json
+const SAMPLE_CATALOG = `${SCHEMA_LINE}
 app.title:
   kind: name
   surface: title