prosebook 0.0.1 → 0.2.0

package/dist/copy-DXnzXsJa.d.ts

@@ -0,0 +1,162 @@
+/**
+ * The shapes the generated catalog and the runtime agree on.
+ *
+ * A catalog is compiled at build time: every ICU message becomes either a string (no placeholders)
+ * or a small function over its arguments and a set of locale-bound helpers. The runtime never parses
+ * ICU, so it carries no parser, needs no `eval`, and a message costs a property read or one call.
+ */
+/** What the generator knows about one message: the arguments it takes and the tags it wraps text in. */
+interface MessageShape {
+  args: object;
+  tags: string;
+}
+/** Every key of a catalog, mapped to its shape. The generated `Messages` interface is one of these. */
+type MessageShapes = {
+  [key: string]: MessageShape;
+};
+/**
+ * Augmented by the generated module, so hooks and components that are not handed a catalog
+ * (`useCopy()`, `<Text>`) still know its keys:
+ *
+ * ```ts
+ * declare module 'prosebook' {
+ *   interface Register { messages: Messages; locale: Locale }
+ * }
+ * ```
+ *
+ * Add `tags: 'b' | 'link'` to say which tags the provider renders by default, so a call site
+ * needs to supply only the others.
+ */
+interface Register {}
+type RegisteredMessages = Register extends {
+  messages: infer M extends MessageShapes;
+} ? M : MessageShapes;
+type RegisteredLocale = Register extends {
+  locale: infer L extends string;
+} ? L : string;
+/** Tags the provider renders unless a call site says otherwise. */
+type DefaultTags = Register extends {
+  tags: infer T extends string;
+} ? T : never;
+/**
+ * The helpers a compiled message calls, bound to the locale its words are in. Names are one letter
+ * because they appear once per placeholder in every generated module.
+ */
+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, select, …}`. */
+  s(value: unknown, arms: Arms): unknown;
+  /** `<tag>…</tag>`: the tag's function from the values, or the bare children when there is none. */
+  t(values: Values, tag: string, children: unknown): unknown;
+}
+type Arms = {
+  [arm: string]: () => unknown;
+};
+type Values = {
+  readonly [name: string]: any;
+};
+/**
+ * Told of every message read: its key, the text it came to and the locale it was found in, which is
+ * the fallback's when the current locale lacks it. The Vite plugin's dev inspector sets one on
+ * `globalThis` to map text on screen back to keys; nothing sets it in a build.
+ */
+type ReadHook = (key: string, text: string, locale: string) => void;
+/** Hands a copy a locale's messages, regenerated after a catalog edit, in place of the ones it loaded. */
+type HotHook = (locale: string, messages: CompiledMessages) => void;
+/**
+ * What the Vite plugin sets on `globalThis` in dev. `__PROSEBOOK_HOT__` is there before the app runs,
+ * so each copy adds itself, and the generated modules call every copy when they are updated.
+ */
+type DevHooks = {
+  __PROSEBOOK_READ__?: ReadHook;
+  __PROSEBOOK_HOT__?: Set<HotHook>;
+};
+/** One compiled message. */
+type Compiled = string | ((values: Values, h: Helpers) => unknown);
+/** One locale's compiled messages: what a generated `<locale>.ts` module exports by default. */
+type CompiledMessages = {
+  readonly [key: string]: Compiled;
+};
+/** What a tag's function receives: the pieces it wraps, adjacent text already joined. */
+type Chunks<N> = (string | N)[];
+type TagFn<N> = (chunks: Chunks<N>) => N;
+/** A tag renderer for any kind of node, as configured once on a `Copy`. */
+type AnyTagFn = (chunks: never) => unknown;
+type NoArgs<T> = {} extends T ? true : false;
+/** The arguments of a plain read: optional when the message takes none. */
+type ArgsParam<S extends MessageShape> = NoArgs<S['args']> extends true ? [args?: S['args']] : [args: S['args']];
+type TagValues<S extends MessageShape, N> = { [T in Exclude<S['tags'], DefaultTags>]: TagFn<N>; } & { [T in Extract<S['tags'], DefaultTags>]?: TagFn<N>; };
+/** A rich read takes the message's arguments and a function per tag it wraps, beside the defaults. */
+type RichValues<S extends MessageShape, N> = S['args'] & TagValues<S, N>;
+type RichParam<S extends MessageShape, N> = NoArgs<RichValues<S, N>> extends true ? [values?: RichValues<S, N>] : [values: RichValues<S, N>];
+/** The keys whose message wraps part of itself in a tag. */
+type RichKey<M extends MessageShapes> = { [K in keyof M]: [M[K]['tags']] extends [never] ? never : K; }[keyof M] & string;
+type Loader = () => Promise<{
+  default: CompiledMessages;
+}>;
+/** A generated catalog: which locales exist, which ship in the bundle and how to fetch the rest. */
+interface Catalog<M extends MessageShapes = MessageShapes, L extends string = string> {
+  /** The locale the catalog is written in, which every other falls back to. */
+  readonly source: L;
+  readonly locales: readonly L[];
+  /** Locales whose messages ship in the bundle. Always holds the source. */
+  readonly messages: { readonly [locale in L]?: CompiledMessages; };
+  /** Locales fetched when first asked for. */
+  readonly loaders: { readonly [locale in L]?: Loader; };
+  /** Type-only: carries the message shapes from the generated module to `createCopy`. */
+  readonly '~messages'?: M;
+}
+/** Ties a generated catalog to its message shapes. Called by generated code. */
+declare function defineCatalog<M extends MessageShapes, L extends string = string>(catalog: Omit<Catalog<M, L>, '~messages'>): Catalog<M, L>;
+interface CopyOptions<L extends string> {
+  /** The locale to start in, or the locales a reader prefers, most preferred first. Defaults to the source. */
+  locale?: L | (string & {}) | readonly string[];
+  /** Tag renderers every rich read gets unless it supplies its own, such as `b` or `link`. */
+  tags?: {
+    [tag: string]: AnyTagFn;
+  };
+  /** What a key the catalog lacks reads as. Defaults to the key itself. */
+  onMissing?: (key: string, locale: L) => string;
+}
+/** 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> {
+  /** The locale messages are coming back in. */
+  readonly locale: L;
+  readonly locales: readonly L[];
+  readonly source: L;
+  /** The tag renderers rich reads fall back to, from `CopyOptions.tags`. */
+  readonly tags: {
+    readonly [tag: string]: AnyTagFn;
+  };
+  /** Settles once the starting locale's messages are loaded. */
+  readonly ready: Promise<void>;
+  /** A message as plain text. Tags render as the text they wrap. */
+  t<K extends keyof M & string>(this: void, key: K, ...args: ArgsParam<M[K]>): string;
+  /** A message with elements inside it: each tag's function turns what it wraps into a node. */
+  rich<K extends RichKey<M>, N = unknown>(this: void, key: K, ...values: RichParam<M[K], N>): Chunks<N>;
+  has(this: void, key: string): key is keyof M & string;
+  /** Switches locale once its messages (and its fallbacks') are loaded. */
+  setLocale(this: void, next: L | (string & {}) | readonly string[]): Promise<void>;
+  /** Counts changes to what messages read as: each locale switch, and each catalog edit in dev. */
+  readonly version: number;
+  /** Called after each locale switch, and in dev after each catalog edit. Returns the unsubscribe. */
+  subscribe(this: void, listener: () => void): () => void;
+  /** Formats a number in the current locale. */
+  number(this: void, value: number | bigint, options?: Intl.NumberFormatOptions): string;
+  /** Formats a date in the current locale. */
+  date(this: void, value: Date | number, options?: Intl.DateTimeFormatOptions): string;
+  /** Joins items as a list in the current locale: `a, b and c`. */
+  list(this: void, items: Iterable<string>, options?: Intl.ListFormatOptions): string;
+  /** `in 3 days`, `2 hours ago`, in the current locale. */
+  relative(this: void, value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions): string;
+}
+/** 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy-DXnzXsJa.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;;EAET,EAAE,eAAe,UAAU,KAAK;;EAEhC,EAAE,OAAO,eAAe,UAAU,KAAK;;EAEvC,EAAE,eAAe,gBAAgB,kBAAkB,MAAM;;EAEzD,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;KCzF/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;;;UAInB,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/helpers-BPuPGjQP.js

@@ -0,0 +1,61 @@
+// src/runtime/helpers.ts
+/**
+* The helpers compiled messages call, for one locale. Formatters are built once per options object:
+* the generator hoists each message's options to a module-level constant, so identity is a stable key.
+*/
+function createHelpers(locale) {
+	const numbers = /* @__PURE__ */ new Map();
+	const dates = /* @__PURE__ */ new Map();
+	let cardinal;
+	let ordinal;
+	return {
+		locale,
+		n(value, options) {
+			let format = numbers.get(options);
+			if (format === void 0) numbers.set(options, format = new Intl.NumberFormat(locale, options));
+			return format.format(value);
+		},
+		d(value, options) {
+			let format = dates.get(options);
+			if (format === void 0) dates.set(options, format = new Intl.DateTimeFormat(locale, options));
+			return format.format(value);
+		},
+		p(value, offset, isOrdinal, arms) {
+			const exact = arms[`=${value}`];
+			if (exact !== void 0) return exact();
+			return pick(arms, (isOrdinal ? ordinal ??= new Intl.PluralRules(locale, { type: "ordinal" }) : cardinal ??= new Intl.PluralRules(locale)).select(value - offset));
+		},
+		s(value, arms) {
+			return pick(arms, String(value));
+		},
+		t(values, tag, children) {
+			const render = values[tag];
+			return typeof render === "function" ? render(flatten(children)) : children;
+		}
+	};
+}
+function pick(arms, arm) {
+	return (Object.hasOwn(arms, arm) ? arms[arm] : arms["other"])();
+}
+/**
+* A compiled message's output as a flat list: nested arrays opened, adjacent text joined, and
+* `null`, `undefined` and booleans dropped, as React drops them.
+*/
+function flatten(output) {
+	const out = [];
+	const walk = (part) => {
+		if (Array.isArray(part)) {
+			for (const p of part) walk(p);
+			return;
+		}
+		if (part === null || part === void 0 || typeof part === "boolean") return;
+		if (typeof part === "number" || typeof part === "bigint") part = String(part);
+		if (typeof part === "string" && typeof out.at(-1) === "string") out[out.length - 1] += part;
+		else out.push(part);
+	};
+	walk(output);
+	return out;
+}
+export { flatten as n, createHelpers as t };
+
+//# sourceMappingURL=helpers-BPuPGjQP.js.map

package/dist/helpers-BPuPGjQP.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers-BPuPGjQP.js","names":[],"sources":["../src/runtime/helpers.ts"],"sourcesContent":["import type { Arms, Helpers, Values } from './types.ts';\n\n/**\n * The helpers compiled messages call, for one locale. Formatters are built once per options object:\n * the generator hoists each message's options to a module-level constant, so identity is a stable key.\n */\nexport function createHelpers(locale: string): Helpers {\n  const numbers = new Map<Intl.NumberFormatOptions | undefined, Intl.NumberFormat>();\n  const dates = new Map<Intl.DateTimeFormatOptions | undefined, Intl.DateTimeFormat>();\n  let cardinal: Intl.PluralRules | undefined;\n  let ordinal: Intl.PluralRules | undefined;\n\n  return {\n    locale,\n    n(value, options) {\n      let format = numbers.get(options);\n      if (format === undefined) numbers.set(options, (format = new Intl.NumberFormat(locale, options)));\n      return format.format(value);\n    },\n    d(value, options) {\n      let format = dates.get(options);\n      if (format === undefined) dates.set(options, (format = new Intl.DateTimeFormat(locale, options)));\n      return format.format(value);\n    },\n    p(value, offset, isOrdinal, arms) {\n      const exact = arms[`=${value}`];\n      if (exact !== undefined) return exact();\n      const rules = isOrdinal\n        ? (ordinal ??= new Intl.PluralRules(locale, { type: 'ordinal' }))\n        : (cardinal ??= new Intl.PluralRules(locale));\n      return pick(arms, rules.select(value - offset));\n    },\n    s(value, arms) {\n      return pick(arms, String(value));\n    },\n    t(values: Values, tag, children) {\n      const render = values[tag];\n      return typeof render === 'function' ? (render as (chunks: unknown[]) => unknown)(flatten(children)) : children;\n    },\n  };\n}\n\nfunction pick(arms: Arms, arm: string): unknown {\n  // ICU requires an `other` arm, and the generator refuses a message without one.\n  return (Object.hasOwn(arms, arm) ? arms[arm]! : arms['other']!)();\n}\n\n/**\n * A compiled message's output as a flat list: nested arrays opened, adjacent text joined, and\n * `null`, `undefined` and booleans dropped, as React drops them.\n */\nexport function flatten(output: unknown): unknown[] {\n  const out: unknown[] = [];\n  const walk = (part: unknown) => {\n    if (Array.isArray(part)) {\n      for (const p of part) walk(p);\n      return;\n    }\n    if (part === null || part === undefined || typeof part === 'boolean') return;\n    if (typeof part === 'number' || typeof part === 'bigint') part = String(part);\n    if (typeof part === 'string' && typeof out.at(-1) === 'string') out[out.length - 1] += part;\n    else out.push(part);\n  };\n  walk(output);\n  return out;\n}\n"],"mappings":";;;;;AAMA,SAAgB,cAAc,QAAyB;CACrD,MAAM,0BAAU,IAAI,IAA6D;CACjF,MAAM,wBAAQ,IAAI,IAAiE;CACnF,IAAI;CACJ,IAAI;CAEJ,OAAO;EACL;EACA,EAAE,OAAO,SAAS;GAChB,IAAI,SAAS,QAAQ,IAAI,OAAO;GAChC,IAAI,WAAW,KAAA,GAAW,QAAQ,IAAI,SAAU,SAAS,IAAI,KAAK,aAAa,QAAQ,OAAO,CAAE;GAChG,OAAO,OAAO,OAAO,KAAK;EAC5B;EACA,EAAE,OAAO,SAAS;GAChB,IAAI,SAAS,MAAM,IAAI,OAAO;GAC9B,IAAI,WAAW,KAAA,GAAW,MAAM,IAAI,SAAU,SAAS,IAAI,KAAK,eAAe,QAAQ,OAAO,CAAE;GAChG,OAAO,OAAO,OAAO,KAAK;EAC5B;EACA,EAAE,OAAO,QAAQ,WAAW,MAAM;GAChC,MAAM,QAAQ,KAAK,IAAI;GACvB,IAAI,UAAU,KAAA,GAAW,OAAO,MAAM;GAItC,OAAO,KAAK,OAHE,YACT,YAAY,IAAI,KAAK,YAAY,QAAQ,EAAE,MAAM,UAAU,CAAC,IAC5D,aAAa,IAAI,KAAK,YAAY,MAAM,EAAA,CACrB,OAAO,QAAQ,MAAM,CAAC;EAChD;EACA,EAAE,OAAO,MAAM;GACb,OAAO,KAAK,MAAM,OAAO,KAAK,CAAC;EACjC;EACA,EAAE,QAAgB,KAAK,UAAU;GAC/B,MAAM,SAAS,OAAO;GACtB,OAAO,OAAO,WAAW,aAAc,OAA0C,QAAQ,QAAQ,CAAC,IAAI;EACxG;CACF;AACF;AAEA,SAAS,KAAK,MAAY,KAAsB;CAE9C,QAAQ,OAAO,OAAO,MAAM,GAAG,IAAI,KAAK,OAAQ,KAAK,SAAA,CAAW;AAClE;;;;;AAMA,SAAgB,QAAQ,QAA4B;CAClD,MAAM,MAAiB,CAAC;CACxB,MAAM,QAAQ,SAAkB;EAC9B,IAAI,MAAM,QAAQ,IAAI,GAAG;GACvB,KAAK,MAAM,KAAK,MAAM,KAAK,CAAC;GAC5B;EACF;EACA,IAAI,SAAS,QAAQ,SAAS,KAAA,KAAa,OAAO,SAAS,WAAW;EACtE,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS,UAAU,OAAO,OAAO,IAAI;EAC5E,IAAI,OAAO,SAAS,YAAY,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,IAAI,IAAI,SAAS,MAAM;OAClF,IAAI,KAAK,IAAI;CACpB;CACA,KAAK,MAAM;CACX,OAAO;AACT"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { C as RichValues, S as RichParam, _ as ReadHook, a as defineCatalog, b as RegisteredMessages, c as Chunks, d as DefaultTags, f as DevHooks, g as MessageShapes, h as MessageShape, i as createCopy, l as Compiled, m as HotHook, n as Copy, o as AnyTagFn, p as Helpers, r as CopyOptions, s as ArgsParam, t as Catalog, u as CompiledMessages, v as Register, w as TagFn, x as RichKey, y as RegisteredLocale } from "./copy-DXnzXsJa.js";
+/**
+ * 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.
+ */
+export declare function negotiate<L extends string>(requested: string | readonly string[], available: readonly L[], fallback: L): L;
+/** The locales a message is looked up in, in order: the locale, its available parents, then the source. */
+export declare function chainOf<L extends string>(locale: L, available: readonly L[], source: L): L[];
+/** The locales the browser or the environment asks for, most preferred first. */
+export declare function preferredLocales(): string[];
+/**
+ * The helpers compiled messages call, for one locale. Formatters are built once per options object:
+ * the generator hoists each message's options to a module-level constant, so identity is a stable key.
+ */
+export declare function createHelpers(locale: string): Helpers;
+/**
+ * A compiled message's output as a flat list: nested arrays opened, adjacent text joined, and
+ * `null`, `undefined` and booleans dropped, as React drops them.
+ */
+export declare function flatten(output: unknown): unknown[];
+export { type AnyTagFn, type ArgsParam, type Catalog, type Chunks, type Compiled, type CompiledMessages, type Copy, type CopyOptions, type DefaultTags, type DevHooks, type Helpers, type HotHook, type MessageShape, type MessageShapes, type ReadHook, type Register, type RegisteredLocale, type RegisteredMessages, type RichKey, type RichParam, type RichValues, type TagFn, createCopy, defineCatalog };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/runtime/locale.ts","../src/runtime/helpers.ts"],"mappings":";;;;;;;wBAMgB,UAAU,kBAAkB,uCAAuC,oBAAoB,KAAK,UAAU,IAAI;;wBAmB1G,QAAQ,kBAAkB,QAAQ,GAAG,oBAAoB,KAAK,QAAQ,IAAI;;wBAa1E;;;;;wBChCA,cAAc,iBAAiB;;;;;wBA6C/B,QAAQ"}

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":";;;;;;;;AAMA,SAAgB,UAA4B,WAAuC,WAAyB,UAAgB;CAC1H,MAAM,QAAQ,QAAgB,UAAU,MAAM,MAAM,EAAE,YAAY,MAAM,IAAI,YAAY,CAAC;CACzF,KAAK,MAAM,QAAQ,OAAO,cAAc,WAAW,CAAC,SAAS,IAAI,WAAW;EAC1E,IAAI,MAAM;EACV,SAAS;GACP,MAAM,QAAQ,KAAK,GAAG;GACtB,IAAI,UAAU,KAAA,GAAW,OAAO;GAChC,MAAM,MAAM,IAAI,YAAY,GAAG;GAC/B,IAAI,MAAM,GAAG;GACb,MAAM,IAAI,MAAM,GAAG,GAAG;EACxB;EACA,MAAM,WAAW,WAAW,IAAI;EAChC,MAAM,UAAU,UAAU,MAAM,MAAM,WAAW,CAAC,MAAM,QAAQ;EAChE,IAAI,YAAY,KAAA,GAAW,OAAO;CACpC;CACA,OAAO;AACT;;AAGA,SAAgB,QAA0B,QAAW,WAAyB,QAAgB;CAC5F,MAAM,QAAa,CAAC,MAAM;CAC1B,IAAI,MAAc;CAClB,OAAO,IAAI,SAAS,GAAG,GAAG;EACxB,MAAM,IAAI,MAAM,GAAG,IAAI,YAAY,GAAG,CAAC;EACvC,MAAM,SAAS,UAAU,MAAM,MAAM,EAAE,YAAY,MAAM,IAAI,YAAY,CAAC;EAC1E,IAAI,WAAW,KAAA,KAAa,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,KAAK,MAAM;CACxE;CACA,IAAI,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,KAAK,MAAM;CAC9C,OAAO;AACT;;AAGA,SAAgB,mBAA6B;CAC3C,MAAM,MAAO,WAAoF;CACjG,IAAI,KAAK,aAAa,IAAI,UAAU,SAAS,GAAG,OAAO,CAAC,GAAG,IAAI,SAAS;CACxE,IAAI,KAAK,UAAU,OAAO,CAAC,IAAI,QAAQ;CACvC,MAAM,WAAW,KAAK,eAAe,CAAC,CAAC,gBAAgB,CAAC,CAAC;CACzD,OAAO,WAAW,CAAC,QAAQ,IAAI,CAAC;AAClC;AAEA,SAAS,WAAW,KAAqB;CACvC,OAAO,IAAI,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,CAAE,YAAY;AAC3C;;;AChBA,SAAgB,cACd,SACe;CACf,OAAO;AACT;;AA6CA,SAAS,OAAO,SAAmB,QAAgB,GAAoB;CACrE,IAAI,OAAO,YAAY,UAAU,OAAO;CACxC,MAAM,QAAQ,OAAO,YAAY,OAAO,QAAQ,MAAM,CAAC,CAAC,QAAQ,GAAG,OAAO,OAAO,MAAM,UAAU,CAAC;CAClG,OAAO,QAAQ,QAAQ,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE;AAC3C;;AAGA,SAAgB,WAAsD,SAAwB,UAA0B,CAAC,GAAe;CACtI,MAAM,yBAAS,IAAI,IAAc;CACjC,MAAM,0BAAU,IAAI,IAAuB;CAC3C,MAAM,4BAAY,IAAI,IAAgB;CACtC,MAAM,cAAc,QAAQ,QAAQ,CAAC;CACrC,MAAM,6BAAa,IAAI,IAAiG;CAExH,KAAK,MAAM,CAAC,QAAQ,aAAa,OAAO,QAAQ,QAAQ,QAAQ,GAC9D,OAAO,IAAI,QAAQ;EAAE;EAAU,GAAG,cAAc,MAAM;CAAE,CAAC;CAE3D,IAAI,SAAS,QAAQ;CACrB,IAAI,QAAiB,OAAO,QAAQ,QAAQ,QAAQ,SAAS,QAAQ,MAAM,CAAC;CAC5E,IAAI,SAAS;CACb,IAAI,UAAU;CAEd,SAAS,UAAU;EACjB;EACA,KAAK,MAAM,YAAY,WAAW,SAAS;CAC7C;CAGA,WAAyB,mBAAmB,KAAK,GAAG,aAAa;EAC/D,MAAM,QAAQ,OAAO,IAAI,CAAM;EAC/B,IAAI,UAAU,KAAA,GAAW;EACzB,MAAM,WAAW;EACjB,QAAQ;CACV,CAAC;CAED,SAAS,OAAO,SAAuB;EACrC,OAAO,QAAQ,SAAS,MAAM,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;CACnD;CAEA,SAAS,KAAK,GAAsB;EAClC,MAAM,OAAO,OAAO,IAAI,CAAC;EACzB,IAAI,MAAM,OAAO,QAAQ,QAAQ,IAAI;EACrC,IAAI,IAAI,QAAQ,IAAI,CAAC;EACrB,IAAI,MAAM,KAAA,GAAW;GAEnB,MAAM,SAAS,QAAQ,QAAQ;GAC/B,IAAI,WAAW,KAAA,GAAW,OAAO,QAAQ,uBAAO,IAAI,MAAM,sCAAsC,EAAE,EAAE,CAAC;GACrG,IAAI,OAAO,CAAC,CAAC,MAAM,QAAQ;IACzB,MAAM,QAAQ;KAAE,UAAU,IAAI;KAAS,GAAG,cAAc,CAAC;IAAE;IAC3D,OAAO,IAAI,GAAG,KAAK;IACnB,QAAQ,OAAO,CAAC;IAChB,OAAO;GACT,CAAC;GACD,EAAE,YAAY,QAAQ,OAAO,CAAC,CAAC;GAC/B,QAAQ,IAAI,GAAG,CAAC;EAClB;EACA,OAAO;CACT;CAEA,eAAe,UAAU,MAA4D;EACnF,MAAM,SAAS,UAAU,MAAM,QAAQ,SAAS,QAAQ,MAAM;EAC9D,MAAM,SAAS,EAAE;EACjB,MAAM,UAAU,QAAQ,QAAQ,QAAQ,SAAS,QAAQ,MAAM;EAC/D,MAAM,QAAQ,IAAI,QAAQ,IAAI,IAAI,CAAC;EAEnC,IAAI,WAAW,UAAU,WAAW,QAAQ;EAC5C,SAAS;EACT,QAAQ,OAAO,OAAO;EACtB,WAAW,MAAM;EACjB,QAAQ;CACV;CAEA,SAAS,KAAK,KAA8C;EAC1D,KAAK,MAAM,SAAS,OAAO;GACzB,MAAM,UAAU,MAAM,SAAS;GAC/B,IAAI,YAAY,KAAA,GAAW,OAAO,CAAC,SAAS,MAAM,CAAC;EACrD;CAEF;CAEA,SAAS,OAAO,KAAa,QAAyB;EACpD,MAAM,QAAQ,KAAK,GAAG;EACtB,IAAI,UAAU,KAAA,GAAW,OAAO,QAAQ,YAAY,QAAQ,UAAU,KAAK,MAAM,IAAI;EACrF,MAAM,CAAC,SAAS,KAAK;EACrB,MAAM,MAAM,OAAO,YAAY,WAAW,UAAU,QAAQ,QAAQ,CAAC;EACrE,MAAM,OAAQ,WAAwB;EACtC,IAAI,SAAS,KAAA,GAAW,KAAK,KAAK,OAAO,QAAQ,WAAW,MAAM,OAAO,SAAS,QAAQ,CAAC,GAAG,EAAE,MAAM;EACtG,OAAO;CACT;CAEA,SAAS,UAAa,MAAc,SAA6B,MAAkB;EACjF,MAAM,KAAK,GAAG,OAAO,KAAK,UAAU,WAAW,CAAC,CAAC;EACjD,IAAI,OAAO,WAAW,IAAI,EAAE;EAC5B,IAAI,SAAS,KAAA,GAAW,WAAW,IAAI,IAAK,OAAO,KAAK,CAAW;EACnE,OAAO;CACT;CAEA,MAAM,QAAQ,QAAQ,WAAW,KAAA,IAAY,QAAQ,QAAQ,IAAI,UAAU,QAAQ,MAAM;CAEzF,OAAO;EACL,IAAI,SAAS;GACX,OAAO;EACT;EACA,IAAI,UAAU;GACZ,OAAO;EACT;EACA,SAAS,QAAQ;EACjB,QAAQ,QAAQ;EAChB,MAAM;EACN;EACA,EAAE,KAAK,GAAG,MAAM;GACd,MAAM,MAAM,OAAO,KAAM,KAAK,MAA6B,CAAC,CAAC;GAC7D,OAAO,OAAO,QAAQ,WAAW,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,EAAE;EAC7D;EACA,KAAK,KAAK,GAAG,QAAQ;GACnB,MAAM,MAAM,OAAO,KAAK;IAAE,GAAG;IAAa,GAAI,OAAO;GAA0B,CAAC;GAChF,OAAO,QAAQ,GAAG;EACpB;EACA,IAAI,KAA8B;GAChC,OAAO,KAAK,GAAG,MAAM,KAAA;EACvB;EACA;EACA,UAAU,UAAU;GAClB,UAAU,IAAI,QAAQ;GACtB,aAAa,UAAU,OAAO,QAAQ;EACxC;EACA,OAAO,OAAO,MAAM;GAClB,OAAO,UAAU,KAAK,YAAY,IAAI,KAAK,aAAa,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK;EACrF;EACA,KAAK,OAAO,MAAM;GAChB,OAAO,UAAU,KAAK,YAAY,IAAI,KAAK,eAAe,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK;EACvF;EACA,KAAK,OAAO,MAAM;GAChB,OAAO,UAAU,KAAK,YAAY,IAAI,KAAK,WAAW,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK;EACnF;EACA,SAAS,OAAO,MAAM,MAAM;GAC1B,OAAO,UAAU,KAAK,YAAY,IAAI,KAAK,mBAAmB,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,OAAO,IAAI;EACjG;CACF;AACF"}

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"}