prosebook 0.0.1 → 0.1.0

package/dist/index.js

@@ -0,0 +1,188 @@
+import { n as flatten, t as createHelpers } from "./helpers-BPuPGjQP.js";
+// src/runtime/locale.ts
+/**
+* Picks the best available locale for what was asked, in the order it was asked.
+*
+* Each requested tag tries an exact match, then its parents (`pt-BR` finds `pt`), then any locale
+* of the same language (`pt` finds `pt-BR`). Matching ignores case, as BCP 47 does.
+*/
+function negotiate(requested, available, fallback) {
+	const find = (tag) => available.find((a) => a.toLowerCase() === tag.toLowerCase());
+	for (const want of typeof requested === "string" ? [requested] : requested) {
+		let tag = want;
+		for (;;) {
+			const found = find(tag);
+			if (found !== void 0) return found;
+			const cut = tag.lastIndexOf("-");
+			if (cut < 0) break;
+			tag = tag.slice(0, cut);
+		}
+		const language = languageOf(want);
+		const sibling = available.find((a) => languageOf(a) === language);
+		if (sibling !== void 0) return sibling;
+	}
+	return fallback;
+}
+/** The locales a message is looked up in, in order: the locale, its available parents, then the source. */
+function chainOf(locale, available, source) {
+	const chain = [locale];
+	let tag = locale;
+	while (tag.includes("-")) {
+		tag = tag.slice(0, tag.lastIndexOf("-"));
+		const parent = available.find((a) => a.toLowerCase() === tag.toLowerCase());
+		if (parent !== void 0 && !chain.includes(parent)) chain.push(parent);
+	}
+	if (!chain.includes(source)) chain.push(source);
+	return chain;
+}
+/** The locales the browser or the environment asks for, most preferred first. */
+function preferredLocales() {
+	const nav = globalThis.navigator;
+	if (nav?.languages && nav.languages.length > 0) return [...nav.languages];
+	if (nav?.language) return [nav.language];
+	const resolved = Intl.DateTimeFormat().resolvedOptions().locale;
+	return resolved ? [resolved] : [];
+}
+function languageOf(tag) {
+	return tag.split("-", 1)[0].toLowerCase();
+}
+// 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();
+	for (const [locale, messages] of Object.entries(catalog.messages)) loaded.set(locale, {
+		messages,
+		h: createHelpers(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: createHelpers(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;
+		const out = typeof message === "string" ? message : message(values, h);
+		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 { chainOf, createCopy, createHelpers, defineCatalog, flatten, negotiate, preferredLocales };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/runtime/locale.ts","../src/runtime/copy.ts"],"sourcesContent":["/**\n * Picks the best available locale for what was asked, in the order it was asked.\n *\n * Each requested tag tries an exact match, then its parents (`pt-BR` finds `pt`), then any locale\n * of the same language (`pt` finds `pt-BR`). Matching ignores case, as BCP 47 does.\n */\nexport function negotiate<L extends string>(requested: string | readonly string[], available: readonly L[], fallback: L): L {\n  const find = (tag: string) => available.find((a) => a.toLowerCase() === tag.toLowerCase());\n  for (const want of typeof requested === 'string' ? [requested] : requested) {\n    let tag = want;\n    for (;;) {\n      const found = find(tag);\n      if (found !== undefined) return found;\n      const cut = tag.lastIndexOf('-');\n      if (cut < 0) break;\n      tag = tag.slice(0, cut);\n    }\n    const language = languageOf(want);\n    const sibling = available.find((a) => languageOf(a) === language);\n    if (sibling !== undefined) return sibling;\n  }\n  return fallback;\n}\n\n/** The locales a message is looked up in, in order: the locale, its available parents, then the source. */\nexport function chainOf<L extends string>(locale: L, available: readonly L[], source: L): L[] {\n  const chain: L[] = [locale];\n  let tag: string = locale;\n  while (tag.includes('-')) {\n    tag = tag.slice(0, tag.lastIndexOf('-'));\n    const parent = available.find((a) => a.toLowerCase() === tag.toLowerCase());\n    if (parent !== undefined && !chain.includes(parent)) chain.push(parent);\n  }\n  if (!chain.includes(source)) chain.push(source);\n  return chain;\n}\n\n/** The locales the browser or the environment asks for, most preferred first. */\nexport function preferredLocales(): string[] {\n  const nav = (globalThis as { navigator?: { languages?: readonly string[]; language?: string } }).navigator;\n  if (nav?.languages && nav.languages.length > 0) return [...nav.languages];\n  if (nav?.language) return [nav.language];\n  const resolved = Intl.DateTimeFormat().resolvedOptions().locale;\n  return resolved ? [resolved] : [];\n}\n\nfunction languageOf(tag: string): string {\n  return tag.split('-', 1)[0]!.toLowerCase();\n}\n","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\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\n  for (const [locale, messages] of Object.entries(catalog.messages) as [L, CompiledMessages][])\n    loaded.set(locale, { messages, h: createHelpers(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: createHelpers(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    const out = typeof message === 'string' ? message : message(values, h);\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/inspector.d.ts

@@ -0,0 +1,37 @@
+export interface Read {
+  key: string;
+  /** The locale the message was found in. */
+  locale: string;
+}
+/** Recent reads by the text they came to, least recent text first; each text's keys most recent first. */
+export type Reads = Map<string, Read[]>;
+/** The character under the pointer: a text node and its index there. */
+export interface Caret {
+  node: Node;
+  offset: number;
+}
+export interface Hit {
+  text: string;
+  read: Read;
+  /** How many other keys came to the same text. */
+  others: number;
+  /** The innermost element holding all of the text. */
+  element: Element;
+}
+export declare function record(reads: Reads, key: string, text: string, locale: string): void;
+/**
+ * The read under the caret: the longest text that covers it, in the innermost element holding all of
+ * it. A rich message runs across its elements, so it wins over a shorter text inside one of them.
+ * Without a caret (over an input, or padding) an element's whole text, or the target's readable
+ * attribute, must equal a read.
+ */
+export declare function keyAt(target: Element, caret: Caret | undefined, reads: Reads): Hit | undefined;
+/** The character under a point on screen, where the browser can say. */
+export declare function caretAt(x: number, y: number): Caret | undefined;
+export interface InspectorOptions {
+  /** The dev server's base URL, ending in `/`. */
+  base: string;
+}
+/** Starts listening for reads and for Alt on the page. Called by the module the Vite plugin serves. */
+export declare function install({ base }: InspectorOptions): void;
+//# sourceMappingURL=inspector.d.ts.map

package/dist/inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.d.ts","names":[],"sources":["../src/inspector.ts"],"mappings":"A,iBAaiB;EACf;;EAEA;;;YAIU,QAAQ,YAAY;;iBAGf;EACf,MAAM;EACN;;iBAGe;EACf;EACA,MAAM;;EAEN;;EAEA,SAAS;;wBAOK,OAAO,OAAO,OAAO,aAAa,cAAc;;;;;;;wBAchD,MAAM,QAAQ,SAAS,OAAO,mBAAmB,OAAO,QAAQ;;wBAuChE,QAAQ,WAAW,YAAY;iBAgB9B;;EAEf;;;wBAIc,UAAU,QAAQ"}