prosebook 0.2.0 → 0.3.0

package/dist/{config-_4HfnJQu.d.ts → config-DdMkKt_N.d.ts}

@@ -412,6 +412,34 @@ declare function compileRule(name: string, rule: Rule): CheckRule;
 /** `text` with the edits made, leaving out any that overlaps one before it. */
 declare function applyEdits(text: string, edits: Edit[]): string;
 declare function lint(messages: Message[], config: ResolvedConfig): Finding[];
+type Element = MessageFormatElement;
+/** A function as written: `:number minimumFractionDigits=2`. Kept on the styles it produces, to write back. */
+interface Mf2Function {
+  name: string;
+  options: Record<string, string>;
+  /** Options given by an argument, as `currency=$code`: the option's name to the argument's. */
+  args?: Record<string, string>;
+  /** `u:dir`: the direction the value is written in, which picks the mark isolating it. */
+  dir?: 'ltr' | 'rtl' | 'auto';
+}
+/** An MF2 message as the element tree. Throws, with the fix, where it can't be read or compiled. */
+declare function parseMf2(text: string, locale: string, isolate?: Isolate): Element[];
+/**
+ * When a placeholder is isolated from the text around it, so a value written the other way can't
+ * reorder it: `'rtl'` in a locale not known to run left to right, or where `u:dir` asks; `'always'`
+ * also for every value of unknown direction (a string), as the spec's default strategy has it.
+ */
+type Isolate = 'rtl' | 'always' | false;
+/** The `Intl.NumberFormat` options a numeric function formats with. */
+declare function intlNumber(fn: Mf2Function): Intl.NumberFormatOptions;
+/**
+ * The `Intl.DateTimeFormat` options a date or time function formats with. MF2's date and time
+ * functions are still a draft; this follows the spec's semantic options as the `messageformat`
+ * package does, so a message reads the same in both.
+ */
+declare function intlDate(fn: Mf2Function): Intl.DateTimeFormatOptions;
+/** A message tree as MF2 text. Throws, saying what has no MF2 equivalent, where it can't be written. */
+declare function toMf2(ast: Element[], locale: string): string;
 interface WordLists {
   /** Words a string never uses, in groups that say why. */
   banned?: {
@@ -437,6 +465,24 @@ interface LintConfig extends WordLists {
   /** Severities for one area's entries (a key's first segment) over `rules`: `{ native: { 'sentence-case': 'off' } }`. */
   areas?: Record<string, RuleSeverities>;
 }
+/**
+ * Native code generated from the catalog, for the parts of an app outside the browser: a tray, a
+ * menu bar, a CLI. One file, holding every locale, with a typed function per message.
+ */
+interface NativeTarget {
+  language: 'rust' | 'swift' | 'kotlin';
+  /** The file written. */
+  out: string;
+  /**
+   * Key prefixes the file holds: `['native']` takes every `native.*` key, which it names without the
+   * prefix (`native.tray.quit` is `tray_quit`). Every key, named in full, by default.
+   */
+  keys?: string[];
+  /** The type holding the locales and messages: `Locale` in Rust, `Copy` in Swift and Kotlin. */
+  name?: string;
+  /** Kotlin's package. */
+  package?: string;
+}
 interface ProsebookConfig {
   /** The source-language catalog: one `<area>.yaml` per area. */
   catalog?: string;
@@ -453,6 +499,13 @@ interface ProsebookConfig {
    * translations alike; `prosebook migrate` rewrites a catalog from one to the other.
    */
   messageFormat?: 1 | 2;
+  /**
+   * In MF2, when a placeholder is wrapped in Unicode isolation marks, so a value written the other
+   * way (a Latin name in Hebrew) can't reorder the text around it. `'rtl'`, the default: in locales
+   * written right to left, and wherever `u:dir` asks. `'always'`: also every string in any locale,
+   * as the spec's default has it. `false`: never.
+   */
+  isolate?: Isolate;
   /** Locales that ship in the main bundle beside the source, rather than loading when first used. */
   bundled?: string[];
   /** A pseudo-locale generated from the source (accented and lengthened) to find layout bugs and hardcoded text. */
@@ -470,6 +523,8 @@ interface ProsebookConfig {
   /** Where a string may sit, with what each surface means. */
   surfaces?: Record<string, string>;
   lint?: LintConfig;
+  /** Rust, Swift or Kotlin files `generate` writes beside the TypeScript. */
+  native?: NativeTarget[];
   /** Where `prosebook scan` looks for hardcoded text and catalog keys. */
   scan?: {
     dirs?: string[];
@@ -486,6 +541,7 @@ interface ResolvedConfig {
   lock: string;
   source: string;
   messageFormat: 1 | 2;
+  isolate: Isolate;
   bundled: string[];
   pseudo: string | false;
   stale: 'use' | 'fallback';
@@ -501,6 +557,9 @@ interface ResolvedConfig {
     }>;
     areas: Record<string, Record<string, Severity>>;
   } & Required<WordLists>;
+  native: (NativeTarget & {
+    name: string;
+  })[];
   scan: {
     dirs: string[];
     extensions: string[];
@@ -513,5 +572,5 @@ declare const CONFIG_FILES: string[];
 /** Finds and reads the config at `root`, or the defaults when there is none. */
 declare function loadConfig(root: string, inline?: ProsebookConfig): Promise<ResolvedConfig>;
 declare function resolveConfig(root: string, config: ProsebookConfig): ResolvedConfig;
-export { sentences as A, EntryLocation as B, RuleContext as C, definePlugin as D, compileRule as E, KindRule as F, entryLocation as G, Message as H, STRICT_LISTS as I, whereOf as J, loadCatalog as K, Severity as L, words as M, DEFAULT_KINDS as N, lint as O, DEFAULT_SURFACES as P, Catalog as R, Rule as S, applyEdits as T, Problem as U, KEY_PATTERN as V, Translation as W, MessageFormatElement as Y, HOLE as _, WordLists as a, Readings as b, resolveConfig as c, CheckRule as d, ConditionalRule as f, Finding as g, ExistenceRule as h, ResolvedConfig as i, singularOf as j, phrase as k, CORE_RULES as l, Edit as m, LintConfig as n, defineConfig as o, CoreRule as p, previewOf as q, ProsebookConfig as r, loadConfig as s, CONFIG_FILES as t, CapitalizationRule as u, OccurrenceRule as v, SubstitutionRule as w, Report as x, Plugin as y, CatalogError as z };
-//# sourceMappingURL=config-_4HfnJQu.d.ts.map
+export { loadCatalog as $, RuleContext as A, DEFAULT_KINDS as B, Finding as C, Readings as D, Plugin as E, lint as F, Catalog as G, KindRule as H, phrase as I, KEY_PATTERN as J, CatalogError as K, sentences as L, applyEdits as M, compileRule as N, Report as O, definePlugin as P, entryLocation as Q, singularOf as R, ExistenceRule as S, OccurrenceRule as T, STRICT_LISTS as U, DEFAULT_SURFACES as V, Severity as W, Problem as X, Message as Y, Translation as Z, CapitalizationRule as _, ResolvedConfig as a, CoreRule as b, loadConfig as c, Mf2Function as d, previewOf as et, intlDate as f, CORE_RULES as g, toMf2 as h, ProsebookConfig as i, SubstitutionRule as j, Rule as k, resolveConfig as l, parseMf2 as m, LintConfig as n, MessageFormatElement as nt, WordLists as o, intlNumber as p, EntryLocation as q, NativeTarget as r, defineConfig as s, CONFIG_FILES as t, whereOf as tt, Isolate as u, CheckRule as v, HOLE as w, Edit as x, ConditionalRule as y, words as z };
+//# sourceMappingURL=config-DdMkKt_N.d.ts.map

package/dist/config-DdMkKt_N.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-DdMkKt_N.d.ts","names":[],"sources":["../src/tools/catalog.ts","../src/tools/presets.ts","../src/tools/lint.ts","../src/tools/mf2.ts","../src/tools/config.ts"],"mappings":"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"}

package/dist/config.d.ts

@@ -1,2 +1,2 @@
-import { A as sentences, C as RuleContext, D as definePlugin, F as KindRule, L as Severity, M as words, S as Rule, _ as HOLE, a as WordLists, b as Readings, c as resolveConfig, d as CheckRule, f as ConditionalRule, h as ExistenceRule, i as ResolvedConfig, k as phrase, n as LintConfig, o as defineConfig, r as ProsebookConfig, s as loadConfig, t as CONFIG_FILES, u as CapitalizationRule, v as OccurrenceRule, w as SubstitutionRule, x as Report, y as Plugin } from "./config-_4HfnJQu.js";
-export { CONFIG_FILES, type CapitalizationRule, type CheckRule, type ConditionalRule, type ExistenceRule, HOLE, type KindRule, LintConfig, type OccurrenceRule, type Plugin, ProsebookConfig, type Readings, type Report, ResolvedConfig, type Rule, type RuleContext, type Severity, type SubstitutionRule, WordLists, defineConfig, definePlugin, loadConfig, phrase, resolveConfig, sentences, words };
+import { A as RuleContext, D as Readings, E as Plugin, H as KindRule, I as phrase, L as sentences, O as Report, P as definePlugin, S as ExistenceRule, T as OccurrenceRule, W as Severity, _ as CapitalizationRule, a as ResolvedConfig, c as loadConfig, i as ProsebookConfig, j as SubstitutionRule, k as Rule, l as resolveConfig, n as LintConfig, o as WordLists, r as NativeTarget, s as defineConfig, t as CONFIG_FILES, v as CheckRule, w as HOLE, y as ConditionalRule, z as words } from "./config-DdMkKt_N.js";
+export { CONFIG_FILES, type CapitalizationRule, type CheckRule, type ConditionalRule, type ExistenceRule, HOLE, type KindRule, LintConfig, NativeTarget, type OccurrenceRule, type Plugin, ProsebookConfig, type Readings, type Report, ResolvedConfig, type Rule, type RuleContext, type Severity, type SubstitutionRule, WordLists, defineConfig, definePlugin, loadConfig, phrase, resolveConfig, sentences, words };

package/dist/config.js

@@ -1 +1 @@
-export { t as CONFIG_FILES, l as HOLE, n as defineConfig, f as definePlugin, r as loadConfig, m as phrase, i as resolveConfig, h as sentences, _ as words } from "./config-D--RITk2.js";
+export { t as CONFIG_FILES, l as HOLE, n as defineConfig, f as definePlugin, r as loadConfig, m as phrase, i as resolveConfig, h as sentences, _ as words } from "./config-BPSmoYel.js";

package/dist/{copy-DXnzXsJa.d.ts → copy-B3V_QRkT.d.ts}

@@ -44,12 +44,20 @@ type DefaultTags = Register extends {
  */
 interface Helpers {
   readonly locale: string;
-  /** `{x, number, …}` and the `#` of a plural. */
-  n(value: number, options?: Intl.NumberFormatOptions): string;
-  /** `{x, date, …}` and `{x, time, …}`. */
-  d(value: Date | number, options?: Intl.DateTimeFormatOptions): string;
-  /** `{x, plural, …}` and `{x, selectordinal, …}`: picks an arm and renders it. */
-  p(value: number, offset: number, ordinal: boolean, arms: Arms): unknown;
+  /**
+   * `{x, number, …}` and the `#` of a plural; `given` holds the options arguments give, in MF2.
+   * Nothing where there is no value or `Intl` refuses it, so the message shows `e`'s fallback.
+   */
+  n(value: number, options?: Intl.NumberFormatOptions, given?: Intl.NumberFormatOptions): string | undefined;
+  /** `{x, date, …}` and `{x, time, …}`, as `n`. */
+  d(value: Date | number, options?: Intl.DateTimeFormatOptions, given?: Intl.DateTimeFormatOptions): string | undefined;
+  /** A placeholder's fallback, `{x}`, where it has no value or `n` or `d` gave nothing: reports why. */
+  e(fallback: string): string;
+  /**
+   * `{x, plural, …}` and `{x, selectordinal, …}`: picks an arm and renders it. MF2 passes the
+   * options its selector formats with, since those decide the category: `1.0` is `other` in English.
+   */
+  p(value: number, offset: number, ordinal: boolean, arms: Arms, options?: Intl.PluralRulesOptions, given?: Intl.PluralRulesOptions): unknown;
   /** `{x, select, …}`. */
   s(value: unknown, arms: Arms): unknown;
   /** `<tag>…</tag>`: the tag's function from the values, or the bare children when there is none. */
@@ -123,6 +131,11 @@ interface CopyOptions<L extends string> {
   };
   /** What a key the catalog lacks reads as. Defaults to the key itself. */
   onMissing?: (key: string, locale: L) => string;
+  /**
+   * Told of a placeholder that had no value, or one `Intl` refused (`currency: 'euro'`): the message
+   * still renders, showing `{name}` there. Defaults to `console.error`.
+   */
+  onError?: (error: Error, key: string, locale: L) => void;
 }
 /** Its methods don't use `this`, so they can be passed around and destructured: `const { t } = copy`. */
 interface Copy<M extends MessageShapes = MessageShapes, L extends string = string> {
@@ -159,4 +172,4 @@ interface Copy<M extends MessageShapes = MessageShapes, L extends string = strin
 /** A catalog reader with a current locale. Create one per app, or one per request on a server. */
 declare function createCopy<M extends MessageShapes, L extends string>(catalog: Catalog<M, L>, options?: CopyOptions<L>): Copy<M, L>;
 export { RichValues as C, RichParam as S, ReadHook as _, defineCatalog as a, RegisteredMessages as b, Chunks as c, DefaultTags as d, DevHooks as f, MessageShapes as g, MessageShape as h, createCopy as i, Compiled as l, HotHook as m, Copy as n, AnyTagFn as o, Helpers as p, CopyOptions as r, ArgsParam as s, Catalog as t, CompiledMessages as u, Register as v, TagFn as w, RichKey as x, RegisteredLocale as y };
-//# sourceMappingURL=copy-DXnzXsJa.d.ts.map
+//# sourceMappingURL=copy-B3V_QRkT.d.ts.map

package/dist/copy-B3V_QRkT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-B3V_QRkT.d.ts","names":[],"sources":["../src/runtime/types.ts","../src/runtime/copy.ts"],"mappings":";;;;;;;;UASiB;EACf;EACA;;;KAIU;GAAmB,cAAc;;;;;;;;;;;;;;;UAgB5B;KAEL,qBAAqB;EAAmB,gBAAgB,UAAU;IAAkB,IAAI;KACxF,mBAAmB;EAAmB,cAAc;IAAqB;;KAEzE,cAAc;EAAmB,YAAY;IAAqB;;;;;UAM7D;WACN;;;;;EAKT,EAAE,eAAe,UAAU,KAAK,qBAAqB,QAAQ,KAAK;;EAElE,EAAE,OAAO,eAAe,UAAU,KAAK,uBAAuB,QAAQ,KAAK;;EAE3E,EAAE;;;;;EAKF,EACE,eACA,gBACA,kBACA,MAAM,MACN,UAAU,KAAK,oBACf,QAAQ,KAAK;;EAGf,EAAE,gBAAgB,MAAM;;EAExB,EAAE,QAAQ,QAAQ,aAAa;;KAGrB;GAAU;;KAIV;YAAqB;;;;;;;KAOrB,YAAY,aAAa,cAAc;;KAGvC,WAAW,gBAAgB,UAAU;;;;;KAMrC;EAAa,qBAAqB;EAAU,oBAAoB,IAAI;;;KAGpE,sBAAsB,QAAQ,QAAQ,GAAG;;KAGzC;YAA+B,cAAc;;;KAG7C,OAAO,eAAe;KACtB,MAAM,MAAM,QAAQ,OAAO,OAAO;;KAElC,YAAY;KAEnB,OAAO,gBAAgB;;KAGhB,UAAU,UAAU,gBAAgB,OAAO,2BAA2B,OAAO,cAAc,MAAM;KAExG,UAAU,UAAU,cAAc,QAAQ,KAAK,QAAQ,WAAW,eAAe,MAAM,WACzF,KAAK,QAAQ,WAAW,gBAAgB,MAAM;;KAIrC,WAAW,UAAU,cAAc,KAAK,YAAY,UAAU,GAAG;KACjE,UAAU,UAAU,cAAc,KAC5C,OAAO,WAAW,GAAG,oBAAoB,SAAS,WAAW,GAAG,OAAO,QAAQ,WAAW,GAAG;;KAGnF,QAAQ,UAAU,oBAAoB,WAAW,KAAK,EAAE,sCAAsC,WAAU;KCxG/G,eAAe;EAAU,SAAS;;;UAGtB,QAAQ,UAAU,gBAAgB,eAAe;;WAEvD,QAAQ;WACR,kBAAkB;;WAElB,sBAAsB,UAAU,KAAK;;WAErC,qBAAqB,UAAU,KAAK;;WAEpC,cAAc;;;iBAIT,cAAc,UAAU,eAAe,2BACrD,SAAS,KAAK,QAAQ,GAAG,mBACxB,QAAQ,GAAG;UAIG,YAAY;;EAE3B,SAAS;;EAET;KAAU,cAAc;;;EAExB,aAAa,aAAa,QAAQ;;;;;EAKlC,WAAW,OAAO,OAAO,aAAa,QAAQ;;;UAI/B,KAAK,UAAU,gBAAgB,eAAe;;WAEpD,QAAQ;WACR,kBAAkB;WAClB,QAAQ;;WAER;cAAkB,cAAc;;;WAEhC,OAAO;;EAEhB,EAAE,gBAAgB,YAAY,YAAY,KAAK,MAAM,MAAM,UAAU,EAAE;;EAEvE,KAAK,UAAU,QAAQ,IAAI,aAAa,YAAY,KAAK,MAAM,QAAQ,UAAU,EAAE,IAAI,KAAK,OAAO;EACnG,IAAI,YAAY,cAAc,aAAa;;EAE3C,UAAU,YAAY,MAAM,wCAAwC;;WAE3D;;EAET,UAAU,YAAY;;EAEtB,OAAO,YAAY,wBAAwB,UAAU,KAAK;;EAE1D,KAAK,YAAY,OAAO,eAAe,UAAU,KAAK;;EAEtD,KAAK,YAAY,OAAO,kBAAkB,UAAU,KAAK;;EAEzD,SAAS,YAAY,eAAe,MAAM,KAAK,wBAAwB,UAAU,KAAK;;;iBAaxE,WAAW,UAAU,eAAe,kBAAkB,SAAS,QAAQ,GAAG,IAAI,UAAS,YAAY,KAAU,KAAK,GAAG"}

package/dist/copy-Bo_FIoLy.js

@@ -0,0 +1,154 @@
+import { n as flatten, t as createHelpers } from "./helpers-BWGcD0kS.js";
+import { n as chainOf, r as negotiate } from "./locale-DpQA1pqH.js";
+// src/runtime/copy.ts
+/** Ties a generated catalog to its message shapes. Called by generated code. */
+function defineCatalog(catalog) {
+	return catalog;
+}
+/** A message as the text it puts on screen: rendered again with its tags left as their text. */
+function textOf(message, values, h) {
+	if (typeof message === "string") return message;
+	const plain = Object.fromEntries(Object.entries(values).filter(([, v]) => typeof v !== "function"));
+	return flatten(message(plain, h)).join("");
+}
+/** A catalog reader with a current locale. Create one per app, or one per request on a server. */
+function createCopy(catalog, options = {}) {
+	const loaded = /* @__PURE__ */ new Map();
+	const pending = /* @__PURE__ */ new Map();
+	const listeners = /* @__PURE__ */ new Set();
+	const defaultTags = options.tags ?? {};
+	const formatters = /* @__PURE__ */ new Map();
+	let reading;
+	const helpers = (l) => createHelpers(l, (error) => {
+		if (reading === void 0) return;
+		if (options.onError) options.onError(error, reading, l);
+		else console.error(`prosebook: ${reading} in ${l}: ${error.message}`);
+	});
+	for (const [locale, messages] of Object.entries(catalog.messages)) loaded.set(locale, {
+		messages,
+		h: helpers(locale)
+	});
+	let locale = catalog.source;
+	let chain = layers(chainOf(locale, catalog.locales, catalog.source));
+	let latest = 0;
+	let version = 0;
+	function changed() {
+		version++;
+		for (const listener of listeners) listener();
+	}
+	globalThis.__PROSEBOOK_HOT__?.add((l, messages) => {
+		const layer = loaded.get(l);
+		if (layer === void 0) return;
+		layer.messages = messages;
+		changed();
+	});
+	function layers(locales) {
+		return locales.flatMap((l) => loaded.get(l) ?? []);
+	}
+	function load(l) {
+		const done = loaded.get(l);
+		if (done) return Promise.resolve(done);
+		let p = pending.get(l);
+		if (p === void 0) {
+			const loader = catalog.loaders[l];
+			if (loader === void 0) return Promise.reject(/* @__PURE__ */ new Error(`prosebook: no messages for locale "${l}"`));
+			p = loader().then((mod) => {
+				const layer = {
+					messages: mod.default,
+					h: helpers(l)
+				};
+				loaded.set(l, layer);
+				pending.delete(l);
+				return layer;
+			});
+			p.catch(() => pending.delete(l));
+			pending.set(l, p);
+		}
+		return p;
+	}
+	async function setLocale(next) {
+		const target = negotiate(next, catalog.locales, catalog.source);
+		const ticket = ++latest;
+		const locales = chainOf(target, catalog.locales, catalog.source);
+		await Promise.all(locales.map(load));
+		if (ticket !== latest || target === locale) return;
+		locale = target;
+		chain = layers(locales);
+		formatters.clear();
+		changed();
+	}
+	function find(key) {
+		for (const layer of chain) {
+			const message = layer.messages[key];
+			if (message !== void 0) return [message, layer.h];
+		}
+	}
+	function render(key, values) {
+		const found = find(key);
+		if (found === void 0) return options.onMissing ? options.onMissing(key, locale) : key;
+		const [message, h] = found;
+		reading = key;
+		let out;
+		try {
+			out = typeof message === "string" ? message : message(values, h);
+		} finally {
+			reading = void 0;
+		}
+		const read = globalThis.__PROSEBOOK_READ__;
+		if (read !== void 0) read(key, typeof out === "string" ? out : textOf(message, values, h), h.locale);
+		return out;
+	}
+	function formatter(kind, options, make) {
+		const id = `${kind}${JSON.stringify(options ?? {})}`;
+		let made = formatters.get(id);
+		if (made === void 0) formatters.set(id, made = make());
+		return made;
+	}
+	const ready = options.locale === void 0 ? Promise.resolve() : setLocale(options.locale);
+	return {
+		get locale() {
+			return locale;
+		},
+		get version() {
+			return version;
+		},
+		locales: catalog.locales,
+		source: catalog.source,
+		tags: defaultTags,
+		ready,
+		t(key, ...args) {
+			const out = render(key, args[0] ?? {});
+			return typeof out === "string" ? out : flatten(out).join("");
+		},
+		rich(key, ...values) {
+			const out = render(key, {
+				...defaultTags,
+				...values[0]
+			});
+			return flatten(out);
+		},
+		has(key) {
+			return find(key) !== void 0;
+		},
+		setLocale,
+		subscribe(listener) {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		},
+		number(value, opts) {
+			return formatter("n", opts, () => new Intl.NumberFormat(locale, opts)).format(value);
+		},
+		date(value, opts) {
+			return formatter("d", opts, () => new Intl.DateTimeFormat(locale, opts)).format(value);
+		},
+		list(items, opts) {
+			return formatter("l", opts, () => new Intl.ListFormat(locale, opts)).format(items);
+		},
+		relative(value, unit, opts) {
+			return formatter("r", opts, () => new Intl.RelativeTimeFormat(locale, opts)).format(value, unit);
+		}
+	};
+}
+export { defineCatalog as n, createCopy as t };
+
+//# sourceMappingURL=copy-Bo_FIoLy.js.map

package/dist/copy-Bo_FIoLy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-Bo_FIoLy.js","names":[],"sources":["../src/runtime/copy.ts"],"sourcesContent":["import { createHelpers, flatten } from './helpers.ts';\nimport { chainOf, negotiate } from './locale.ts';\nimport type {\n  AnyTagFn,\n  ArgsParam,\n  Chunks,\n  Compiled,\n  CompiledMessages,\n  Helpers,\n  DevHooks,\n  MessageShapes,\n  RichKey,\n  RichParam,\n  Values,\n} from './types.ts';\n\ntype Loader = () => Promise<{ default: CompiledMessages }>;\n\n/** A generated catalog: which locales exist, which ship in the bundle and how to fetch the rest. */\nexport interface Catalog<M extends MessageShapes = MessageShapes, L extends string = string> {\n  /** The locale the catalog is written in, which every other falls back to. */\n  readonly source: L;\n  readonly locales: readonly L[];\n  /** Locales whose messages ship in the bundle. Always holds the source. */\n  readonly messages: { readonly [locale in L]?: CompiledMessages };\n  /** Locales fetched when first asked for. */\n  readonly loaders: { readonly [locale in L]?: Loader };\n  /** Type-only: carries the message shapes from the generated module to `createCopy`. */\n  readonly '~messages'?: M;\n}\n\n/** Ties a generated catalog to its message shapes. Called by generated code. */\nexport function defineCatalog<M extends MessageShapes, L extends string = string>(\n  catalog: Omit<Catalog<M, L>, '~messages'>,\n): Catalog<M, L> {\n  return catalog;\n}\n\nexport interface CopyOptions<L extends string> {\n  /** The locale to start in, or the locales a reader prefers, most preferred first. Defaults to the source. */\n  locale?: L | (string & {}) | readonly string[];\n  /** Tag renderers every rich read gets unless it supplies its own, such as `b` or `link`. */\n  tags?: { [tag: string]: AnyTagFn };\n  /** What a key the catalog lacks reads as. Defaults to the key itself. */\n  onMissing?: (key: string, locale: L) => string;\n  /**\n   * Told of a placeholder that had no value, or one `Intl` refused (`currency: 'euro'`): the message\n   * still renders, showing `{name}` there. Defaults to `console.error`.\n   */\n  onError?: (error: Error, key: string, locale: L) => void;\n}\n\n/** Its methods don't use `this`, so they can be passed around and destructured: `const { t } = copy`. */\nexport interface Copy<M extends MessageShapes = MessageShapes, L extends string = string> {\n  /** The locale messages are coming back in. */\n  readonly locale: L;\n  readonly locales: readonly L[];\n  readonly source: L;\n  /** The tag renderers rich reads fall back to, from `CopyOptions.tags`. */\n  readonly tags: { readonly [tag: string]: AnyTagFn };\n  /** Settles once the starting locale's messages are loaded. */\n  readonly ready: Promise<void>;\n  /** A message as plain text. Tags render as the text they wrap. */\n  t<K extends keyof M & string>(this: void, key: K, ...args: ArgsParam<M[K]>): string;\n  /** A message with elements inside it: each tag's function turns what it wraps into a node. */\n  rich<K extends RichKey<M>, N = unknown>(this: void, key: K, ...values: RichParam<M[K], N>): Chunks<N>;\n  has(this: void, key: string): key is keyof M & string;\n  /** Switches locale once its messages (and its fallbacks') are loaded. */\n  setLocale(this: void, next: L | (string & {}) | readonly string[]): Promise<void>;\n  /** Counts changes to what messages read as: each locale switch, and each catalog edit in dev. */\n  readonly version: number;\n  /** Called after each locale switch, and in dev after each catalog edit. Returns the unsubscribe. */\n  subscribe(this: void, listener: () => void): () => void;\n  /** Formats a number in the current locale. */\n  number(this: void, value: number | bigint, options?: Intl.NumberFormatOptions): string;\n  /** Formats a date in the current locale. */\n  date(this: void, value: Date | number, options?: Intl.DateTimeFormatOptions): string;\n  /** Joins items as a list in the current locale: `a, b and c`. */\n  list(this: void, items: Iterable<string>, options?: Intl.ListFormatOptions): string;\n  /** `in 3 days`, `2 hours ago`, in the current locale. */\n  relative(this: void, value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions): string;\n}\n\ntype Layer = { messages: CompiledMessages; h: Helpers };\n\n/** A message as the text it puts on screen: rendered again with its tags left as their text. */\nfunction textOf(message: Compiled, values: Values, h: Helpers): string {\n  if (typeof message === 'string') return message;\n  const plain = Object.fromEntries(Object.entries(values).filter(([, v]) => typeof v !== 'function'));\n  return flatten(message(plain, h)).join('');\n}\n\n/** A catalog reader with a current locale. Create one per app, or one per request on a server. */\nexport function createCopy<M extends MessageShapes, L extends string>(catalog: Catalog<M, L>, options: CopyOptions<L> = {}): Copy<M, L> {\n  const loaded = new Map<L, Layer>();\n  const pending = new Map<L, Promise<Layer>>();\n  const listeners = new Set<() => void>();\n  const defaultTags = options.tags ?? {};\n  const formatters = new Map<string, Intl.NumberFormat | Intl.DateTimeFormat | Intl.ListFormat | Intl.RelativeTimeFormat>();\n  // The key being rendered, which a helper's report names; none while the inspector renders it again.\n  let reading: string | undefined;\n  const helpers = (l: L) =>\n    createHelpers(l, (error) => {\n      if (reading === undefined) return;\n      if (options.onError) options.onError(error, reading, l);\n      else console.error(`prosebook: ${reading} in ${l}: ${error.message}`);\n    });\n\n  for (const [locale, messages] of Object.entries(catalog.messages) as [L, CompiledMessages][])\n    loaded.set(locale, { messages, h: helpers(locale) });\n\n  let locale = catalog.source;\n  let chain: Layer[] = layers(chainOf(locale, catalog.locales, catalog.source));\n  let latest = 0;\n  let version = 0;\n\n  function changed() {\n    version++;\n    for (const listener of listeners) listener();\n  }\n\n  // A layer's messages are swapped in place, so the chain that holds it reads the new ones.\n  (globalThis as DevHooks).__PROSEBOOK_HOT__?.add((l, messages) => {\n    const layer = loaded.get(l as L);\n    if (layer === undefined) return;\n    layer.messages = messages;\n    changed();\n  });\n\n  function layers(locales: L[]): Layer[] {\n    return locales.flatMap((l) => loaded.get(l) ?? []);\n  }\n\n  function load(l: L): Promise<Layer> {\n    const done = loaded.get(l);\n    if (done) return Promise.resolve(done);\n    let p = pending.get(l);\n    if (p === undefined) {\n      // oxlint-disable-next-line typescript/no-unsafe-enum-assignment -- `L` is a string union, not an enum; the rule misreads the mapped type\n      const loader = catalog.loaders[l];\n      if (loader === undefined) return Promise.reject(new Error(`prosebook: no messages for locale \"${l}\"`));\n      p = loader().then((mod) => {\n        const layer = { messages: mod.default, h: helpers(l) };\n        loaded.set(l, layer);\n        pending.delete(l);\n        return layer;\n      });\n      p.catch(() => pending.delete(l));\n      pending.set(l, p);\n    }\n    return p;\n  }\n\n  async function setLocale(next: L | (string & {}) | readonly string[]): Promise<void> {\n    const target = negotiate(next, catalog.locales, catalog.source);\n    const ticket = ++latest;\n    const locales = chainOf(target, catalog.locales, catalog.source);\n    await Promise.all(locales.map(load));\n    // A slower load must not undo a later switch.\n    if (ticket !== latest || target === locale) return;\n    locale = target;\n    chain = layers(locales);\n    formatters.clear();\n    changed();\n  }\n\n  function find(key: string): [Compiled, Helpers] | undefined {\n    for (const layer of chain) {\n      const message = layer.messages[key];\n      if (message !== undefined) return [message, layer.h];\n    }\n    return undefined;\n  }\n\n  function render(key: string, values: Values): unknown {\n    const found = find(key);\n    if (found === undefined) return options.onMissing ? options.onMissing(key, locale) : key;\n    const [message, h] = found;\n    reading = key;\n    let out: unknown;\n    try {\n      out = typeof message === 'string' ? message : message(values, h);\n    } finally {\n      reading = undefined;\n    }\n    const read = (globalThis as DevHooks).__PROSEBOOK_READ__;\n    if (read !== undefined) read(key, typeof out === 'string' ? out : textOf(message, values, h), h.locale);\n    return out;\n  }\n\n  function formatter<F>(kind: string, options: object | undefined, make: () => F): F {\n    const id = `${kind}${JSON.stringify(options ?? {})}`;\n    let made = formatters.get(id) as F | undefined;\n    if (made === undefined) formatters.set(id, (made = make()) as never);\n    return made;\n  }\n\n  const ready = options.locale === undefined ? Promise.resolve() : setLocale(options.locale);\n\n  return {\n    get locale() {\n      return locale;\n    },\n    get version() {\n      return version;\n    },\n    locales: catalog.locales,\n    source: catalog.source,\n    tags: defaultTags,\n    ready,\n    t(key, ...args) {\n      const out = render(key, (args[0] as Values | undefined) ?? {});\n      return typeof out === 'string' ? out : flatten(out).join('');\n    },\n    rich(key, ...values) {\n      const out = render(key, { ...defaultTags, ...(values[0] as Values | undefined) });\n      return flatten(out) as Chunks<never>;\n    },\n    has(key): key is keyof M & string {\n      return find(key) !== undefined;\n    },\n    setLocale,\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    number(value, opts) {\n      return formatter('n', opts, () => new Intl.NumberFormat(locale, opts)).format(value);\n    },\n    date(value, opts) {\n      return formatter('d', opts, () => new Intl.DateTimeFormat(locale, opts)).format(value);\n    },\n    list(items, opts) {\n      return formatter('l', opts, () => new Intl.ListFormat(locale, opts)).format(items);\n    },\n    relative(value, unit, opts) {\n      return formatter('r', opts, () => new Intl.RelativeTimeFormat(locale, opts)).format(value, unit);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/endpoints-CnUfCkIk.js

@@ -0,0 +1,96 @@
+import { C as entryLocation, T as loadCatalog, b as readEntry, v as editEntry, x as CatalogError } from "./generate-9pR3i5Bj.js";
+// src/tools/endpoints.ts
+/** Answers the inspector's requests, and nothing for any other path. */
+function inspectorEndpoints(config, { base = "/", open }) {
+	return async (req) => {
+		const url = new URL(req.url);
+		if (url.pathname === `${base}__prosebook/open`) return openEntry(await config, url, open);
+		if (url.pathname === `${base}__prosebook/entry`) return entry(await config, req, url);
+	};
+}
+/**
+* `?key=cart.items&locale=de`: the translation's entry, or the catalog's with `catalog` or when the
+* locale has none. Read from disk, so a key added since the page loaded is found.
+*/
+async function openEntry(config, url, open) {
+	const key = url.searchParams.get("key") ?? "";
+	let message;
+	try {
+		message = loadCatalog(config).messages.find((m) => m.key === key);
+	} catch (e) {
+		return failed(e);
+	}
+	if (message === void 0) return new Response(`no entry for "${key}" in the catalog: has it been renamed since the page loaded?`, { status: 404 });
+	const locale = url.searchParams.has("catalog") ? void 0 : url.searchParams.get("locale") ?? void 0;
+	return open(entryLocation(config, message, locale));
+}
+/**
+* The inspector's dialog: GET `?key=…` reads an entry in every locale, POST `{ key, edit, write }`
+* applies an edit (`entry.ts`). A POST writes files, so only the page itself may send one: same origin,
+* and JSON, which a form on another site can't send without asking first.
+*/
+async function entry(config, req, url) {
+	if (req.method === "GET") try {
+		return Response.json(readEntry(config, url.searchParams.get("key") ?? ""));
+	} catch (e) {
+		return failed(e);
+	}
+	const origin = req.headers.get("origin");
+	const sameOrigin = origin === null || new URL(origin).host === url.host;
+	if (req.method !== "POST" || !sameOrigin || req.headers.get("content-type")?.startsWith("application/json") !== true) return Response.json({ problems: [{
+		severity: "error",
+		message: "edits come from the page, as JSON"
+	}] }, { status: 403 });
+	try {
+		const { key, edit, write } = await req.json();
+		const result = editEntry(config, key, edit, write === true);
+		return Response.json(result, { status: result.problems.length > 0 ? 422 : 200 });
+	} catch (e) {
+		return failed(e);
+	}
+}
+/** A redirect within the page's origin, to a launcher the dev server answers itself. */
+const redirect = (path) => new Response(null, {
+	status: 307,
+	headers: { Location: path }
+});
+function failed(e) {
+	return Response.json({ problems: e instanceof CatalogError ? e.problems : [{
+		severity: "error",
+		message: e instanceof Error ? e.message : String(e)
+	}] }, { status: e instanceof CatalogError ? 409 : 400 });
+}
+/**
+* The endpoints as Node middleware, for Vite's server and Next's. The request's host is the one the
+* page was served from: a proxy's `x-forwarded-host`, as Next's rewrite sets, before its own.
+*/
+function nodeMiddleware(handle) {
+	return (req, res, next) => {
+		if (req.url?.includes("/__prosebook/") !== true) return next();
+		const forwarded = req.headers["x-forwarded-host"];
+		const host = (Array.isArray(forwarded) ? forwarded[0] : forwarded) ?? req.headers.host ?? "localhost";
+		const headers = new Headers();
+		for (const [name, value] of Object.entries(req.headers)) for (const v of Array.isArray(value) ? value : value === void 0 ? [] : [value]) headers.append(name, v);
+		const chunks = [];
+		req.on("data", (chunk) => chunks.push(chunk));
+		req.on("end", () => {
+			const body = req.method === "GET" || req.method === "HEAD" ? void 0 : Buffer.concat(chunks);
+			handle(new Request(`http://${host}${req.url}`, {
+				method: req.method,
+				headers,
+				body
+			})).then(async (response) => {
+				if (response === void 0) return next();
+				res.statusCode = response.status;
+				response.headers.forEach((value, name) => res.setHeader(name, value));
+				res.end(Buffer.from(await response.arrayBuffer()));
+			}).catch((e) => {
+				res.statusCode = 500;
+				res.end(e instanceof Error ? e.message : String(e));
+			});
+		});
+	};
+}
+export { nodeMiddleware as n, redirect as r, inspectorEndpoints as t };
+
+//# sourceMappingURL=endpoints-CnUfCkIk.js.map

package/dist/endpoints-CnUfCkIk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints-CnUfCkIk.js","names":[],"sources":["../src/tools/endpoints.ts"],"sourcesContent":["/**\n * The dev server's half of the inspector (`inspector.ts`, `inspector-dialog.ts`): `__prosebook/open`,\n * which opens an entry in the editor, and `__prosebook/entry`, which reads and edits one. Written over\n * `Request` and `Response`, so each integration mounts them its own way: Vite as middleware, Bun as\n * `Bun.serve` routes, Next behind a rewrite to a server of their own. Each opens the editor its dev\n * server already launches.\n */\nimport type { IncomingMessage, ServerResponse } from 'node:http';\n\nimport { CatalogError, entryLocation, loadCatalog, type EntryLocation } from './catalog.ts';\nimport type { ResolvedConfig } from './config.ts';\nimport { editEntry, readEntry, type EntryEdit } from './entry.ts';\n\nexport interface EndpointOptions {\n  /** The path the endpoints sit under, ending in `/`: `/` by default. */\n  base?: string;\n  /** Opens an entry in the editor: a redirect to the dev server's own launcher, or a reply once it has. */\n  open: (at: EntryLocation) => Response | Promise<Response>;\n}\n\n/** Answers the inspector's requests, and nothing for any other path. */\nexport function inspectorEndpoints(\n  config: ResolvedConfig | Promise<ResolvedConfig>,\n  { base = '/', open }: EndpointOptions,\n): (req: Request) => Promise<Response | undefined> {\n  return async (req) => {\n    const url = new URL(req.url);\n    if (url.pathname === `${base}__prosebook/open`) return openEntry(await config, url, open);\n    if (url.pathname === `${base}__prosebook/entry`) return entry(await config, req, url);\n    return undefined;\n  };\n}\n\n/**\n * `?key=cart.items&locale=de`: the translation's entry, or the catalog's with `catalog` or when the\n * locale has none. Read from disk, so a key added since the page loaded is found.\n */\nasync function openEntry(config: ResolvedConfig, url: URL, open: EndpointOptions['open']): Promise<Response> {\n  const key = url.searchParams.get('key') ?? '';\n  let message;\n  try {\n    message = loadCatalog(config).messages.find((m) => m.key === key);\n  } catch (e) {\n    return failed(e);\n  }\n  if (message === undefined)\n    return new Response(`no entry for \"${key}\" in the catalog: has it been renamed since the page loaded?`, { status: 404 });\n  const locale = url.searchParams.has('catalog') ? undefined : (url.searchParams.get('locale') ?? undefined);\n  return open(entryLocation(config, message, locale));\n}\n\n/**\n * The inspector's dialog: GET `?key=…` reads an entry in every locale, POST `{ key, edit, write }`\n * applies an edit (`entry.ts`). A POST writes files, so only the page itself may send one: same origin,\n * and JSON, which a form on another site can't send without asking first.\n */\nasync function entry(config: ResolvedConfig, req: Request, url: URL): Promise<Response> {\n  if (req.method === 'GET') {\n    try {\n      return Response.json(readEntry(config, url.searchParams.get('key') ?? ''));\n    } catch (e) {\n      return failed(e);\n    }\n  }\n  const origin = req.headers.get('origin');\n  const sameOrigin = origin === null || new URL(origin).host === url.host;\n  if (req.method !== 'POST' || !sameOrigin || req.headers.get('content-type')?.startsWith('application/json') !== true)\n    return Response.json({ problems: [{ severity: 'error', message: 'edits come from the page, as JSON' }] }, { status: 403 });\n  try {\n    const { key, edit, write } = (await req.json()) as { key: string; edit: EntryEdit; write?: boolean };\n    const result = editEntry(config, key, edit, write === true);\n    return Response.json(result, { status: result.problems.length > 0 ? 422 : 200 });\n  } catch (e) {\n    return failed(e);\n  }\n}\n\n/** A redirect within the page's origin, to a launcher the dev server answers itself. */\nexport const redirect = (path: string) => new Response(null, { status: 307, headers: { Location: path } });\n\nfunction failed(e: unknown): Response {\n  return Response.json(\n    { problems: e instanceof CatalogError ? e.problems : [{ severity: 'error', message: e instanceof Error ? e.message : String(e) }] },\n    { status: e instanceof CatalogError ? 409 : 400 },\n  );\n}\n\n/**\n * The endpoints as Node middleware, for Vite's server and Next's. The request's host is the one the\n * page was served from: a proxy's `x-forwarded-host`, as Next's rewrite sets, before its own.\n */\nexport function nodeMiddleware(\n  handle: (req: Request) => Promise<Response | undefined>,\n): (req: IncomingMessage, res: ServerResponse, next: () => void) => void {\n  return (req, res, next) => {\n    // Before reading the body, which a request for anything else leaves to whoever answers it.\n    if (req.url?.includes('/__prosebook/') !== true) return next();\n    const forwarded = req.headers['x-forwarded-host'];\n    const host = (Array.isArray(forwarded) ? forwarded[0] : forwarded) ?? req.headers.host ?? 'localhost';\n    const headers = new Headers();\n    for (const [name, value] of Object.entries(req.headers))\n      for (const v of Array.isArray(value) ? value : value === undefined ? [] : [value]) headers.append(name, v);\n\n    const chunks: Buffer[] = [];\n    req.on('data', (chunk: Buffer) => chunks.push(chunk));\n    req.on('end', () => {\n      const body = req.method === 'GET' || req.method === 'HEAD' ? undefined : Buffer.concat(chunks);\n      handle(new Request(`http://${host}${req.url}`, { method: req.method, headers, body }))\n        .then(async (response) => {\n          if (response === undefined) return next();\n          res.statusCode = response.status;\n          response.headers.forEach((value, name) => res.setHeader(name, value));\n          res.end(Buffer.from(await response.arrayBuffer()));\n        })\n        .catch((e: unknown) => {\n          res.statusCode = 500;\n          res.end(e instanceof Error ? e.message : String(e));\n        });\n    });\n  };\n}\n"],"mappings":"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"}