@pyreon/i18n 0.0.1

package/lib/devtools.js

@@ -0,0 +1,81 @@
+//#region src/devtools.ts
+/**
+* @pyreon/i18n devtools introspection API.
+* Import: `import { ... } from "@pyreon/i18n/devtools"`
+*/
+const _activeInstances = /* @__PURE__ */ new Map();
+const _listeners = /* @__PURE__ */ new Set();
+function _notify() {
+	for (const listener of _listeners) listener();
+}
+/**
+* Register an i18n instance for devtools inspection.
+*
+* @example
+* const i18n = createI18n({ ... })
+* registerI18n("app", i18n)
+*/
+function registerI18n(name, instance) {
+	_activeInstances.set(name, new WeakRef(instance));
+	_notify();
+}
+/** Unregister an i18n instance. */
+function unregisterI18n(name) {
+	_activeInstances.delete(name);
+	_notify();
+}
+/** Get all registered i18n instance names. Cleans up garbage-collected instances. */
+function getActiveI18nInstances() {
+	for (const [name, ref] of _activeInstances) if (ref.deref() === void 0) _activeInstances.delete(name);
+	return [..._activeInstances.keys()];
+}
+/** Get an i18n instance by name (or undefined if GC'd or not registered). */
+function getI18nInstance(name) {
+	const ref = _activeInstances.get(name);
+	if (!ref) return void 0;
+	const instance = ref.deref();
+	if (!instance) {
+		_activeInstances.delete(name);
+		return;
+	}
+	return instance;
+}
+/** Safely read a property that may be a signal (callable). */
+function safeRead(obj, key, fallback = void 0) {
+	try {
+		const val = obj[key];
+		return typeof val === "function" ? val() : fallback;
+	} catch {
+		return fallback;
+	}
+}
+/**
+* Get a snapshot of an i18n instance's state.
+*/
+function getI18nSnapshot(name) {
+	const instance = getI18nInstance(name);
+	if (!instance) return void 0;
+	const ns = safeRead(instance, "loadedNamespaces", /* @__PURE__ */ new Set());
+	return {
+		locale: safeRead(instance, "locale"),
+		availableLocales: safeRead(instance, "availableLocales", []),
+		loadedNamespaces: ns instanceof Set ? [...ns] : [],
+		isLoading: safeRead(instance, "isLoading", false)
+	};
+}
+/** Subscribe to i18n registry changes. Returns unsubscribe function. */
+function onI18nChange(listener) {
+	_listeners.add(listener);
+	return () => {
+		_listeners.delete(listener);
+	};
+}
+/** @internal — reset devtools registry (for tests). */
+function _resetDevtools() {
+	_activeInstances.clear();
+	_listeners.clear();
+}
+
+//#endregion
+export { _resetDevtools, getActiveI18nInstances, getI18nInstance, getI18nSnapshot, onI18nChange, registerI18n, unregisterI18n };
+//# sourceMappingURL=devtools.js.map

package/lib/devtools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools.js","names":[],"sources":["../src/devtools.ts"],"sourcesContent":["/**\n * @pyreon/i18n devtools introspection API.\n * Import: `import { ... } from \"@pyreon/i18n/devtools\"`\n */\n\nconst _activeInstances = new Map<string, WeakRef<object>>()\nconst _listeners = new Set<() => void>()\n\nfunction _notify(): void {\n  for (const listener of _listeners) listener()\n}\n\n/**\n * Register an i18n instance for devtools inspection.\n *\n * @example\n * const i18n = createI18n({ ... })\n * registerI18n(\"app\", i18n)\n */\nexport function registerI18n(name: string, instance: object): void {\n  _activeInstances.set(name, new WeakRef(instance))\n  _notify()\n}\n\n/** Unregister an i18n instance. */\nexport function unregisterI18n(name: string): void {\n  _activeInstances.delete(name)\n  _notify()\n}\n\n/** Get all registered i18n instance names. Cleans up garbage-collected instances. */\nexport function getActiveI18nInstances(): string[] {\n  for (const [name, ref] of _activeInstances) {\n    if (ref.deref() === undefined) _activeInstances.delete(name)\n  }\n  return [..._activeInstances.keys()]\n}\n\n/** Get an i18n instance by name (or undefined if GC'd or not registered). */\nexport function getI18nInstance(name: string): object | undefined {\n  const ref = _activeInstances.get(name)\n  if (!ref) return undefined\n  const instance = ref.deref()\n  if (!instance) {\n    _activeInstances.delete(name)\n    return undefined\n  }\n  return instance\n}\n\n/** Safely read a property that may be a signal (callable). */\nfunction safeRead(\n  obj: Record<string, unknown>,\n  key: string,\n  fallback: unknown = undefined,\n): unknown {\n  try {\n    const val = obj[key]\n    return typeof val === 'function' ? (val as () => unknown)() : fallback\n  } catch {\n    return fallback\n  }\n}\n\n/**\n * Get a snapshot of an i18n instance's state.\n */\nexport function getI18nSnapshot(\n  name: string,\n): Record<string, unknown> | undefined {\n  const instance = getI18nInstance(name) as Record<string, unknown> | undefined\n  if (!instance) return undefined\n  const ns = safeRead(instance, 'loadedNamespaces', new Set())\n  return {\n    locale: safeRead(instance, 'locale'),\n    availableLocales: safeRead(instance, 'availableLocales', []),\n    loadedNamespaces: ns instanceof Set ? [...ns] : [],\n    isLoading: safeRead(instance, 'isLoading', false),\n  }\n}\n\n/** Subscribe to i18n registry changes. Returns unsubscribe function. */\nexport function onI18nChange(listener: () => void): () => void {\n  _listeners.add(listener)\n  return () => {\n    _listeners.delete(listener)\n  }\n}\n\n/** @internal — reset devtools registry (for tests). */\nexport function _resetDevtools(): void {\n  _activeInstances.clear()\n  _listeners.clear()\n}\n"],"mappings":";;;;;AAKA,MAAM,mCAAmB,IAAI,KAA8B;AAC3D,MAAM,6BAAa,IAAI,KAAiB;AAExC,SAAS,UAAgB;AACvB,MAAK,MAAM,YAAY,WAAY,WAAU;;;;;;;;;AAU/C,SAAgB,aAAa,MAAc,UAAwB;AACjE,kBAAiB,IAAI,MAAM,IAAI,QAAQ,SAAS,CAAC;AACjD,UAAS;;;AAIX,SAAgB,eAAe,MAAoB;AACjD,kBAAiB,OAAO,KAAK;AAC7B,UAAS;;;AAIX,SAAgB,yBAAmC;AACjD,MAAK,MAAM,CAAC,MAAM,QAAQ,iBACxB,KAAI,IAAI,OAAO,KAAK,OAAW,kBAAiB,OAAO,KAAK;AAE9D,QAAO,CAAC,GAAG,iBAAiB,MAAM,CAAC;;;AAIrC,SAAgB,gBAAgB,MAAkC;CAChE,MAAM,MAAM,iBAAiB,IAAI,KAAK;AACtC,KAAI,CAAC,IAAK,QAAO;CACjB,MAAM,WAAW,IAAI,OAAO;AAC5B,KAAI,CAAC,UAAU;AACb,mBAAiB,OAAO,KAAK;AAC7B;;AAEF,QAAO;;;AAIT,SAAS,SACP,KACA,KACA,WAAoB,QACX;AACT,KAAI;EACF,MAAM,MAAM,IAAI;AAChB,SAAO,OAAO,QAAQ,aAAc,KAAuB,GAAG;SACxD;AACN,SAAO;;;;;;AAOX,SAAgB,gBACd,MACqC;CACrC,MAAM,WAAW,gBAAgB,KAAK;AACtC,KAAI,CAAC,SAAU,QAAO;CACtB,MAAM,KAAK,SAAS,UAAU,oCAAoB,IAAI,KAAK,CAAC;AAC5D,QAAO;EACL,QAAQ,SAAS,UAAU,SAAS;EACpC,kBAAkB,SAAS,UAAU,oBAAoB,EAAE,CAAC;EAC5D,kBAAkB,cAAc,MAAM,CAAC,GAAG,GAAG,GAAG,EAAE;EAClD,WAAW,SAAS,UAAU,aAAa,MAAM;EAClD;;;AAIH,SAAgB,aAAa,UAAkC;AAC7D,YAAW,IAAI,SAAS;AACxB,cAAa;AACX,aAAW,OAAO,SAAS;;;;AAK/B,SAAgB,iBAAuB;AACrC,kBAAiB,OAAO;AACxB,YAAW,OAAO"}

package/lib/index.js

@@ -0,0 +1,330 @@
+import { computed, signal } from "@pyreon/reactivity";
+import { Fragment, createContext, h, onUnmount, popContext, pushContext, useContext } from "@pyreon/core";
+
+//#region src/interpolation.ts
+const INTERPOLATION_RE = /\{\{(\s*\w+\s*)\}\}/g;
+/**
+* Replace `{{key}}` placeholders in a string with values from the given record.
+* Supports optional whitespace inside braces: `{{ name }}` works too.
+* Unmatched placeholders are left as-is.
+*/
+function interpolate(template, values) {
+	if (!values || !template.includes("{{")) return template;
+	return template.replace(INTERPOLATION_RE, (_, key) => {
+		const trimmed = key.trim();
+		const value = values[trimmed];
+		if (value === void 0) return `{{${trimmed}}}`;
+		try {
+			return typeof value === "object" && value !== null ? JSON.stringify(value) : `${value}`;
+		} catch {
+			return `{{${trimmed}}}`;
+		}
+	});
+}
+
+//#endregion
+//#region src/pluralization.ts
+/**
+* Resolve the plural category for a given count and locale.
+*
+* Uses custom rules if provided, otherwise falls back to `Intl.PluralRules`.
+* Returns CLDR plural categories: "zero", "one", "two", "few", "many", "other".
+*/
+function resolvePluralCategory(locale, count, customRules) {
+	if (customRules?.[locale]) return customRules[locale](count);
+	if (typeof Intl !== "undefined" && Intl.PluralRules) try {
+		return new Intl.PluralRules(locale).select(count);
+	} catch {}
+	return count === 1 ? "one" : "other";
+}
+
+//#endregion
+//#region src/create-i18n.ts
+/**
+* Resolve a dot-separated key path in a nested dictionary.
+* E.g. "user.greeting" → dictionary.user.greeting
+*/
+function resolveKey(dict, keyPath) {
+	const parts = keyPath.split(".");
+	let current = dict;
+	for (const part of parts) {
+		if (current == null || typeof current === "string") return void 0;
+		current = current[part];
+	}
+	return typeof current === "string" ? current : void 0;
+}
+/**
+* Deep-merge source into target (mutates target).
+*/
+function deepMerge(target, source) {
+	for (const key of Object.keys(source)) {
+		if (key === "__proto__" || key === "constructor" || key === "prototype") continue;
+		const sourceVal = source[key];
+		const targetVal = target[key];
+		if (typeof sourceVal === "object" && sourceVal !== null && typeof targetVal === "object" && targetVal !== null) deepMerge(targetVal, sourceVal);
+		else target[key] = sourceVal;
+	}
+}
+/**
+* Create a reactive i18n instance.
+*
+* @example
+* const i18n = createI18n({
+*   locale: 'en',
+*   fallbackLocale: 'en',
+*   messages: {
+*     en: { greeting: 'Hello {{name}}!' },
+*     de: { greeting: 'Hallo {{name}}!' },
+*   },
+* })
+*
+* // Reactive translation — re-evaluates on locale change
+* i18n.t('greeting', { name: 'Alice' }) // "Hello Alice!"
+* i18n.locale.set('de')
+* i18n.t('greeting', { name: 'Alice' }) // "Hallo Alice!"
+*
+* @example
+* // Async namespace loading
+* const i18n = createI18n({
+*   locale: 'en',
+*   loader: async (locale, namespace) => {
+*     const mod = await import(`./locales/${locale}/${namespace}.json`)
+*     return mod.default
+*   },
+* })
+* await i18n.loadNamespace('auth')
+* i18n.t('auth:errors.invalid') // looks up "errors.invalid" in "auth" namespace
+*/
+function createI18n(options) {
+	const { fallbackLocale, loader, defaultNamespace = "common", pluralRules, onMissingKey } = options;
+	const locale = signal(options.locale);
+	const store = /* @__PURE__ */ new Map();
+	const storeVersion = signal(0);
+	const pendingLoads = signal(0);
+	const loadedNsVersion = signal(0);
+	const pendingPromises = /* @__PURE__ */ new Map();
+	const isLoading = computed(() => pendingLoads() > 0);
+	const loadedNamespaces = computed(() => {
+		loadedNsVersion();
+		const currentLocale = locale();
+		const nsMap = store.get(currentLocale);
+		return new Set(nsMap ? nsMap.keys() : []);
+	});
+	const availableLocales = computed(() => {
+		storeVersion();
+		return [...store.keys()];
+	});
+	if (options.messages) for (const [loc, dict] of Object.entries(options.messages)) {
+		const nsMap = /* @__PURE__ */ new Map();
+		nsMap.set(defaultNamespace, dict);
+		store.set(loc, nsMap);
+	}
+	function getNamespaceMap(loc) {
+		let nsMap = store.get(loc);
+		if (!nsMap) {
+			nsMap = /* @__PURE__ */ new Map();
+			store.set(loc, nsMap);
+		}
+		return nsMap;
+	}
+	function lookupKey(loc, namespace, keyPath) {
+		const nsMap = store.get(loc);
+		if (!nsMap) return void 0;
+		const dict = nsMap.get(namespace);
+		if (!dict) return void 0;
+		return resolveKey(dict, keyPath);
+	}
+	function resolveTranslation(key, values) {
+		const currentLocale = locale();
+		storeVersion();
+		let namespace = defaultNamespace;
+		let keyPath = key;
+		const colonIndex = key.indexOf(":");
+		if (colonIndex > 0) {
+			namespace = key.slice(0, colonIndex);
+			keyPath = key.slice(colonIndex + 1);
+		}
+		if (values && "count" in values) {
+			const category = resolvePluralCategory(currentLocale, Number(values.count), pluralRules);
+			const pluralKey = `${keyPath}_${category}`;
+			const pluralResult = lookupKey(currentLocale, namespace, pluralKey) ?? (fallbackLocale ? lookupKey(fallbackLocale, namespace, pluralKey) : void 0);
+			if (pluralResult) return interpolate(pluralResult, values);
+		}
+		const result = lookupKey(currentLocale, namespace, keyPath) ?? (fallbackLocale ? lookupKey(fallbackLocale, namespace, keyPath) : void 0);
+		if (result !== void 0) return interpolate(result, values);
+		if (onMissingKey) {
+			const custom = onMissingKey(currentLocale, key, namespace);
+			if (custom !== void 0) return custom;
+		}
+		return key;
+	}
+	const t = (key, values) => {
+		return resolveTranslation(key, values);
+	};
+	const loadNamespace = async (namespace, loc) => {
+		if (!loader) return;
+		const targetLocale = loc ?? locale.peek();
+		const cacheKey = `${targetLocale}:${namespace}`;
+		const nsMap = getNamespaceMap(targetLocale);
+		if (nsMap.has(namespace)) return;
+		const existing = pendingPromises.get(cacheKey);
+		if (existing) return existing;
+		pendingLoads.update((n) => n + 1);
+		const promise = loader(targetLocale, namespace).then((dict) => {
+			if (dict) {
+				nsMap.set(namespace, dict);
+				storeVersion.update((n) => n + 1);
+				loadedNsVersion.update((n) => n + 1);
+			}
+		}).finally(() => {
+			pendingPromises.delete(cacheKey);
+			pendingLoads.update((n) => n - 1);
+		});
+		pendingPromises.set(cacheKey, promise);
+		return promise;
+	};
+	const exists = (key) => {
+		const currentLocale = locale.peek();
+		let namespace = defaultNamespace;
+		let keyPath = key;
+		const colonIndex = key.indexOf(":");
+		if (colonIndex > 0) {
+			namespace = key.slice(0, colonIndex);
+			keyPath = key.slice(colonIndex + 1);
+		}
+		return lookupKey(currentLocale, namespace, keyPath) !== void 0 || (fallbackLocale ? lookupKey(fallbackLocale, namespace, keyPath) !== void 0 : false);
+	};
+	const addMessages = (loc, messages, namespace) => {
+		const ns = namespace ?? defaultNamespace;
+		const nsMap = getNamespaceMap(loc);
+		const existing = nsMap.get(ns);
+		if (existing) deepMerge(existing, messages);
+		else {
+			const cloned = {};
+			deepMerge(cloned, messages);
+			nsMap.set(ns, cloned);
+		}
+		storeVersion.update((n) => n + 1);
+		loadedNsVersion.update((n) => n + 1);
+	};
+	return {
+		t,
+		locale,
+		loadNamespace,
+		isLoading,
+		loadedNamespaces,
+		exists,
+		addMessages,
+		availableLocales
+	};
+}
+
+//#endregion
+//#region src/context.ts
+const I18nContext = createContext(null);
+/**
+* Provide an i18n instance to the component tree.
+*
+* @example
+* const i18n = createI18n({ locale: 'en', messages: { en: { hello: 'Hello' } } })
+*
+* // In JSX:
+* <I18nProvider instance={i18n}>
+*   <App />
+* </I18nProvider>
+*/
+function I18nProvider(props) {
+	pushContext(new Map([[I18nContext.id, props.instance]]));
+	onUnmount(() => popContext());
+	const ch = props.children;
+	return typeof ch === "function" ? ch() : ch;
+}
+/**
+* Access the i18n instance from the nearest I18nProvider.
+* Must be called within a component tree wrapped by I18nProvider.
+*
+* @example
+* function Greeting() {
+*   const { t, locale } = useI18n()
+*   return <h1>{t('greeting', { name: 'World' })}</h1>
+* }
+*/
+function useI18n() {
+	const instance = useContext(I18nContext);
+	if (!instance) throw new Error("[@pyreon/i18n] useI18n() must be used within an <I18nProvider>.");
+	return instance;
+}
+
+//#endregion
+//#region src/trans.ts
+const TAG_RE = /<(\w+)>(.*?)<\/\1>/gs;
+/**
+* Parse a translated string into an array of plain text and rich tag segments.
+*
+* @example
+* parseRichText("Hello <bold>world</bold>, click <link>here</link>")
+* // → ["Hello ", { tag: "bold", children: "world" }, ", click ", { tag: "link", children: "here" }]
+*/
+function parseRichText(text) {
+	const parts = [];
+	let lastIndex = 0;
+	for (const match of text.matchAll(TAG_RE)) {
+		const before = text.slice(lastIndex, match.index);
+		if (before) parts.push(before);
+		parts.push({
+			tag: match[1],
+			children: match[2]
+		});
+		lastIndex = match.index + match[0].length;
+	}
+	const after = text.slice(lastIndex);
+	if (after) parts.push(after);
+	return parts;
+}
+/**
+* Rich JSX interpolation component for translations.
+*
+* Allows embedding JSX components within translated strings using XML-like tags.
+* The `t` function resolves the translation and interpolates `{{values}}` first,
+* then `<tag>content</tag>` patterns are mapped to the provided components.
+*
+* @example
+* // Translation: "You have <bold>{{count}}</bold> unread messages"
+* const { t } = useI18n()
+* <Trans
+*   t={t}
+*   i18nKey="messages.unread"
+*   values={{ count: 5 }}
+*   components={{
+*     bold: (children) => <strong>{children}</strong>,
+*   }}
+* />
+* // Renders: You have <strong>5</strong> unread messages
+*
+* @example
+* // Translation: "Read our <terms>terms of service</terms> and <privacy>privacy policy</privacy>"
+* <Trans
+*   t={t}
+*   i18nKey="legal"
+*   components={{
+*     terms: (children) => <a href="/terms">{children}</a>,
+*     privacy: (children) => <a href="/privacy">{children}</a>,
+*   }}
+* />
+*/
+function Trans(props) {
+	const translated = props.t(props.i18nKey, props.values);
+	if (!props.components) return translated;
+	const parts = parseRichText(translated);
+	if (parts.length === 1 && typeof parts[0] === "string") return parts[0];
+	return h(Fragment, null, ...parts.map((part) => {
+		if (typeof part === "string") return part;
+		const component = props.components[part.tag];
+		if (!component) return part.children;
+		return component(part.children);
+	}));
+}
+
+//#endregion
+export { I18nContext, I18nProvider, Trans, createI18n, interpolate, parseRichText, resolvePluralCategory, useI18n };
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/interpolation.ts","../src/pluralization.ts","../src/create-i18n.ts","../src/context.ts","../src/trans.ts"],"sourcesContent":["import type { InterpolationValues } from './types'\n\nconst INTERPOLATION_RE = /\\{\\{(\\s*\\w+\\s*)\\}\\}/g\n\n/**\n * Replace `{{key}}` placeholders in a string with values from the given record.\n * Supports optional whitespace inside braces: `{{ name }}` works too.\n * Unmatched placeholders are left as-is.\n */\nexport function interpolate(\n  template: string,\n  values?: InterpolationValues,\n): string {\n  if (!values || !template.includes('{{')) return template\n  return template.replace(INTERPOLATION_RE, (_, key: string) => {\n    const trimmed = key.trim()\n    const value = values[trimmed]\n    if (value === undefined) return `{{${trimmed}}}`\n    // Safely coerce — guard against malicious toString/valueOf\n    try {\n      return typeof value === 'object' && value !== null\n        ? JSON.stringify(value)\n        : `${value}`\n    } catch {\n      return `{{${trimmed}}}`\n    }\n  })\n}\n","import type { PluralRules } from './types'\n\n/**\n * Resolve the plural category for a given count and locale.\n *\n * Uses custom rules if provided, otherwise falls back to `Intl.PluralRules`.\n * Returns CLDR plural categories: \"zero\", \"one\", \"two\", \"few\", \"many\", \"other\".\n */\nexport function resolvePluralCategory(\n  locale: string,\n  count: number,\n  customRules?: PluralRules,\n): string {\n  // Custom rules take priority\n  if (customRules?.[locale]) {\n    return customRules[locale](count)\n  }\n\n  // Use Intl.PluralRules if available\n  if (typeof Intl !== 'undefined' && Intl.PluralRules) {\n    try {\n      const pr = new Intl.PluralRules(locale)\n      return pr.select(count)\n    } catch {\n      // Invalid locale — fall through\n    }\n  }\n\n  // Basic fallback\n  return count === 1 ? 'one' : 'other'\n}\n","import { signal, computed } from '@pyreon/reactivity'\nimport type {\n  I18nOptions,\n  I18nInstance,\n  TranslationDictionary,\n  InterpolationValues,\n} from './types'\nimport { interpolate } from './interpolation'\nimport { resolvePluralCategory } from './pluralization'\n\n/**\n * Resolve a dot-separated key path in a nested dictionary.\n * E.g. \"user.greeting\" → dictionary.user.greeting\n */\nfunction resolveKey(\n  dict: TranslationDictionary,\n  keyPath: string,\n): string | undefined {\n  const parts = keyPath.split('.')\n  let current: TranslationDictionary | string = dict\n\n  for (const part of parts) {\n    if (current == null || typeof current === 'string') return undefined\n    current = current[part] as TranslationDictionary | string\n  }\n\n  return typeof current === 'string' ? current : undefined\n}\n\n/**\n * Deep-merge source into target (mutates target).\n */\nfunction deepMerge(\n  target: TranslationDictionary,\n  source: TranslationDictionary,\n): void {\n  for (const key of Object.keys(source)) {\n    if (key === '__proto__' || key === 'constructor' || key === 'prototype')\n      continue\n    const sourceVal = source[key]\n    const targetVal = target[key]\n    if (\n      typeof sourceVal === 'object' &&\n      sourceVal !== null &&\n      typeof targetVal === 'object' &&\n      targetVal !== null\n    ) {\n      deepMerge(\n        targetVal as TranslationDictionary,\n        sourceVal as TranslationDictionary,\n      )\n    } else {\n      target[key] = sourceVal!\n    }\n  }\n}\n\n/**\n * Create a reactive i18n instance.\n *\n * @example\n * const i18n = createI18n({\n *   locale: 'en',\n *   fallbackLocale: 'en',\n *   messages: {\n *     en: { greeting: 'Hello {{name}}!' },\n *     de: { greeting: 'Hallo {{name}}!' },\n *   },\n * })\n *\n * // Reactive translation — re-evaluates on locale change\n * i18n.t('greeting', { name: 'Alice' }) // \"Hello Alice!\"\n * i18n.locale.set('de')\n * i18n.t('greeting', { name: 'Alice' }) // \"Hallo Alice!\"\n *\n * @example\n * // Async namespace loading\n * const i18n = createI18n({\n *   locale: 'en',\n *   loader: async (locale, namespace) => {\n *     const mod = await import(`./locales/${locale}/${namespace}.json`)\n *     return mod.default\n *   },\n * })\n * await i18n.loadNamespace('auth')\n * i18n.t('auth:errors.invalid') // looks up \"errors.invalid\" in \"auth\" namespace\n */\nexport function createI18n(options: I18nOptions): I18nInstance {\n  const {\n    fallbackLocale,\n    loader,\n    defaultNamespace = 'common',\n    pluralRules,\n    onMissingKey,\n  } = options\n\n  // ── Reactive state ──────────────────────────────────────────────────\n\n  const locale = signal(options.locale)\n\n  // Internal store: locale → namespace → dictionary\n  // We use a version counter to trigger reactive updates when messages change,\n  // since the store is mutated in place (Object.is would skip same-reference sets).\n  const store = new Map<string, Map<string, TranslationDictionary>>()\n  const storeVersion = signal(0)\n\n  // Loading state\n  const pendingLoads = signal(0)\n  const loadedNsVersion = signal(0)\n\n  // In-flight load promises — deduplicates concurrent loads for the same locale:namespace\n  const pendingPromises = new Map<string, Promise<void>>()\n\n  const isLoading = computed(() => pendingLoads() > 0)\n  const loadedNamespaces = computed(() => {\n    loadedNsVersion()\n    const currentLocale = locale()\n    const nsMap = store.get(currentLocale)\n    return new Set(nsMap ? nsMap.keys() : [])\n  })\n  const availableLocales = computed(() => {\n    storeVersion() // subscribe to store changes\n    return [...store.keys()]\n  })\n\n  // ── Initialize static messages ──────────────────────────────────────\n\n  if (options.messages) {\n    for (const [loc, dict] of Object.entries(options.messages)) {\n      const nsMap = new Map<string, TranslationDictionary>()\n      nsMap.set(defaultNamespace, dict)\n      store.set(loc, nsMap)\n    }\n  }\n\n  // ── Internal helpers ────────────────────────────────────────────────\n\n  function getNamespaceMap(loc: string): Map<string, TranslationDictionary> {\n    let nsMap = store.get(loc)\n    if (!nsMap) {\n      nsMap = new Map()\n      store.set(loc, nsMap)\n    }\n    return nsMap\n  }\n\n  function lookupKey(\n    loc: string,\n    namespace: string,\n    keyPath: string,\n  ): string | undefined {\n    const nsMap = store.get(loc)\n    if (!nsMap) return undefined\n    const dict = nsMap.get(namespace)\n    if (!dict) return undefined\n    return resolveKey(dict, keyPath)\n  }\n\n  function resolveTranslation(\n    key: string,\n    values?: InterpolationValues,\n  ): string {\n    // Subscribe to reactive dependencies\n    const currentLocale = locale()\n    storeVersion()\n\n    // Parse key: \"namespace:key.path\" or just \"key.path\"\n    let namespace = defaultNamespace\n    let keyPath = key\n\n    const colonIndex = key.indexOf(':')\n    if (colonIndex > 0) {\n      namespace = key.slice(0, colonIndex)\n      keyPath = key.slice(colonIndex + 1)\n    }\n\n    // Handle pluralization: if values contain `count`, try plural suffixes\n    if (values && 'count' in values) {\n      const count = Number(values.count)\n      const category = resolvePluralCategory(currentLocale, count, pluralRules)\n\n      // Try exact form first (e.g. \"items_one\"), then fall back to base key\n      const pluralKey = `${keyPath}_${category}`\n      const pluralResult =\n        lookupKey(currentLocale, namespace, pluralKey) ??\n        (fallbackLocale\n          ? lookupKey(fallbackLocale, namespace, pluralKey)\n          : undefined)\n\n      if (pluralResult) {\n        return interpolate(pluralResult, values)\n      }\n    }\n\n    // Standard lookup: current locale → fallback locale\n    const result =\n      lookupKey(currentLocale, namespace, keyPath) ??\n      (fallbackLocale\n        ? lookupKey(fallbackLocale, namespace, keyPath)\n        : undefined)\n\n    if (result !== undefined) {\n      return interpolate(result, values)\n    }\n\n    // Missing key handler\n    if (onMissingKey) {\n      const custom = onMissingKey(currentLocale, key, namespace)\n      if (custom !== undefined) return custom!\n    }\n\n    // Return the key itself as a visual fallback\n    return key\n  }\n\n  // ── Public API ──────────────────────────────────────────────────────\n\n  const t = (key: string, values?: InterpolationValues): string => {\n    return resolveTranslation(key, values)\n  }\n\n  const loadNamespace = async (\n    namespace: string,\n    loc?: string,\n  ): Promise<void> => {\n    if (!loader) return\n\n    const targetLocale = loc ?? locale.peek()\n    const cacheKey = `${targetLocale}:${namespace}`\n    const nsMap = getNamespaceMap(targetLocale)\n\n    // Skip if already loaded\n    if (nsMap.has(namespace)) return\n\n    // Deduplicate concurrent loads for the same locale:namespace\n    const existing = pendingPromises.get(cacheKey)\n    if (existing) return existing\n\n    pendingLoads.update((n) => n + 1)\n\n    const promise = loader(targetLocale, namespace)\n      .then((dict) => {\n        if (dict) {\n          nsMap.set(namespace, dict)\n          storeVersion.update((n) => n + 1)\n          loadedNsVersion.update((n) => n + 1)\n        }\n      })\n      .finally(() => {\n        pendingPromises.delete(cacheKey)\n        pendingLoads.update((n) => n - 1)\n      })\n\n    pendingPromises.set(cacheKey, promise)\n    return promise\n  }\n\n  const exists = (key: string): boolean => {\n    const currentLocale = locale.peek()\n\n    let namespace = defaultNamespace\n    let keyPath = key\n    const colonIndex = key.indexOf(':')\n    if (colonIndex > 0) {\n      namespace = key.slice(0, colonIndex)\n      keyPath = key.slice(colonIndex + 1)\n    }\n\n    return (\n      lookupKey(currentLocale, namespace, keyPath) !== undefined ||\n      (fallbackLocale\n        ? lookupKey(fallbackLocale, namespace, keyPath) !== undefined\n        : false)\n    )\n  }\n\n  const addMessages = (\n    loc: string,\n    messages: TranslationDictionary,\n    namespace?: string,\n  ): void => {\n    const ns = namespace ?? defaultNamespace\n    const nsMap = getNamespaceMap(loc)\n    const existing = nsMap.get(ns)\n\n    if (existing) {\n      deepMerge(existing, messages)\n    } else {\n      // Deep-clone to prevent external mutation from corrupting the store\n      const cloned: TranslationDictionary = {}\n      deepMerge(cloned, messages)\n      nsMap.set(ns, cloned)\n    }\n\n    storeVersion.update((n) => n + 1)\n    loadedNsVersion.update((n) => n + 1)\n  }\n\n  return {\n    t,\n    locale,\n    loadNamespace,\n    isLoading,\n    loadedNamespaces,\n    exists,\n    addMessages,\n    availableLocales,\n  }\n}\n","import {\n  createContext,\n  pushContext,\n  popContext,\n  onUnmount,\n  useContext,\n} from '@pyreon/core'\nimport type { VNodeChild, VNode, Props } from '@pyreon/core'\nimport type { I18nInstance } from './types'\n\nexport const I18nContext = createContext<I18nInstance | null>(null)\n\nexport interface I18nProviderProps extends Props {\n  instance: I18nInstance\n  children?: VNodeChild\n}\n\n/**\n * Provide an i18n instance to the component tree.\n *\n * @example\n * const i18n = createI18n({ locale: 'en', messages: { en: { hello: 'Hello' } } })\n *\n * // In JSX:\n * <I18nProvider instance={i18n}>\n *   <App />\n * </I18nProvider>\n */\nexport function I18nProvider(props: I18nProviderProps): VNode {\n  const frame = new Map([[I18nContext.id, props.instance]])\n  pushContext(frame)\n\n  onUnmount(() => popContext())\n\n  const ch = props.children\n  return (typeof ch === 'function' ? (ch as () => VNodeChild)() : ch) as VNode\n}\n\n/**\n * Access the i18n instance from the nearest I18nProvider.\n * Must be called within a component tree wrapped by I18nProvider.\n *\n * @example\n * function Greeting() {\n *   const { t, locale } = useI18n()\n *   return <h1>{t('greeting', { name: 'World' })}</h1>\n * }\n */\nexport function useI18n(): I18nInstance {\n  const instance = useContext(I18nContext)\n  if (!instance) {\n    throw new Error(\n      '[@pyreon/i18n] useI18n() must be used within an <I18nProvider>.',\n    )\n  }\n  return instance\n}\n","import { h, Fragment } from '@pyreon/core'\nimport type { VNode, Props } from '@pyreon/core'\nimport type { InterpolationValues } from './types'\n\nconst TAG_RE = /<(\\w+)>(.*?)<\\/\\1>/gs\n\ninterface RichPart {\n  tag: string\n  children: string\n}\n\n/**\n * Parse a translated string into an array of plain text and rich tag segments.\n *\n * @example\n * parseRichText(\"Hello <bold>world</bold>, click <link>here</link>\")\n * // → [\"Hello \", { tag: \"bold\", children: \"world\" }, \", click \", { tag: \"link\", children: \"here\" }]\n */\nexport function parseRichText(text: string): (string | RichPart)[] {\n  const parts: (string | RichPart)[] = []\n  let lastIndex = 0\n\n  for (const match of text.matchAll(TAG_RE)) {\n    const before = text.slice(lastIndex, match.index)\n    if (before) parts.push(before)\n    parts.push({ tag: match[1]!, children: match[2]! })\n    lastIndex = match.index! + match[0].length\n  }\n\n  const after = text.slice(lastIndex)\n  if (after) parts.push(after)\n\n  return parts\n}\n\nexport interface TransProps extends Props {\n  /** Translation key (supports namespace:key syntax). */\n  i18nKey: string\n  /** Interpolation values for {{placeholder}} syntax. */\n  values?: InterpolationValues\n  /**\n   * Component map for rich interpolation.\n   * Keys match tag names in the translation string.\n   * Values are component functions: `(children: any) => VNode`\n   *\n   * @example\n   * // Translation: \"Read the <terms>terms</terms> and <privacy>policy</privacy>\"\n   * components={{\n   *   terms: (children) => <a href=\"/terms\">{children}</a>,\n   *   privacy: (children) => <a href=\"/privacy\">{children}</a>,\n   * }}\n   */\n  components?: Record<string, (children: any) => any>\n  /**\n   * The i18n instance's `t` function.\n   * Can be obtained from `useI18n()` or passed directly.\n   */\n  t: (key: string, values?: InterpolationValues) => string\n}\n\n/**\n * Rich JSX interpolation component for translations.\n *\n * Allows embedding JSX components within translated strings using XML-like tags.\n * The `t` function resolves the translation and interpolates `{{values}}` first,\n * then `<tag>content</tag>` patterns are mapped to the provided components.\n *\n * @example\n * // Translation: \"You have <bold>{{count}}</bold> unread messages\"\n * const { t } = useI18n()\n * <Trans\n *   t={t}\n *   i18nKey=\"messages.unread\"\n *   values={{ count: 5 }}\n *   components={{\n *     bold: (children) => <strong>{children}</strong>,\n *   }}\n * />\n * // Renders: You have <strong>5</strong> unread messages\n *\n * @example\n * // Translation: \"Read our <terms>terms of service</terms> and <privacy>privacy policy</privacy>\"\n * <Trans\n *   t={t}\n *   i18nKey=\"legal\"\n *   components={{\n *     terms: (children) => <a href=\"/terms\">{children}</a>,\n *     privacy: (children) => <a href=\"/privacy\">{children}</a>,\n *   }}\n * />\n */\nexport function Trans(props: TransProps): VNode | string {\n  const translated = props.t(props.i18nKey, props.values)\n\n  if (!props.components) return translated\n\n  const parts = parseRichText(translated)\n\n  // If the result is a single plain string, return it directly\n  if (parts.length === 1 && typeof parts[0] === 'string') return parts[0]\n\n  const children = parts.map((part) => {\n    if (typeof part === 'string') return part\n    const component = props.components![part.tag]\n    // Unmatched tags: render children as plain text (no raw HTML markup)\n    if (!component) return part.children\n    return component(part.children)\n  })\n\n  return h(Fragment, null, ...children)\n}\n"],"mappings":"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"}

package/lib/types/devtools.d.ts

@@ -0,0 +1,74 @@
+function _notify() {
+  for (const listener of _listeners) listener();
+}
+/**
+* Register an i18n instance for devtools inspection.
+*
+* @example
+* const i18n = createI18n({ ... })
+* registerI18n("app", i18n)
+*/
+function registerI18n(name, instance) {
+  _activeInstances.set(name, new WeakRef(instance));
+  _notify();
+}
+/** Unregister an i18n instance. */
+function unregisterI18n(name) {
+  _activeInstances.delete(name);
+  _notify();
+}
+/** Get all registered i18n instance names. Cleans up garbage-collected instances. */
+function getActiveI18nInstances() {
+  for (const [name, ref] of _activeInstances) if (ref.deref() === void 0) _activeInstances.delete(name);
+  return [..._activeInstances.keys()];
+}
+/** Get an i18n instance by name (or undefined if GC'd or not registered). */
+function getI18nInstance(name) {
+  const ref = _activeInstances.get(name);
+  if (!ref) return void 0;
+  const instance = ref.deref();
+  if (!instance) {
+    _activeInstances.delete(name);
+    return;
+  }
+  return instance;
+}
+/** Safely read a property that may be a signal (callable). */
+function safeRead(obj, key, fallback = void 0) {
+  try {
+    const val = obj[key];
+    return typeof val === "function" ? val() : fallback;
+  } catch {
+    return fallback;
+  }
+}
+/**
+* Get a snapshot of an i18n instance's state.
+*/
+function getI18nSnapshot(name) {
+  const instance = getI18nInstance(name);
+  if (!instance) return void 0;
+  const ns = safeRead(instance, "loadedNamespaces", /* @__PURE__ */new Set());
+  return {
+    locale: safeRead(instance, "locale"),
+    availableLocales: safeRead(instance, "availableLocales", []),
+    loadedNamespaces: ns instanceof Set ? [...ns] : [],
+    isLoading: safeRead(instance, "isLoading", false)
+  };
+}
+/** Subscribe to i18n registry changes. Returns unsubscribe function. */
+function onI18nChange(listener) {
+  _listeners.add(listener);
+  return () => {
+    _listeners.delete(listener);
+  };
+}
+/** @internal — reset devtools registry (for tests). */
+function _resetDevtools() {
+  _activeInstances.clear();
+  _listeners.clear();
+}
+
+//#endregion
+export { _resetDevtools, getActiveI18nInstances, getI18nInstance, getI18nSnapshot, onI18nChange, registerI18n, unregisterI18n };
+//# sourceMappingURL=devtools.d.ts.map

package/lib/types/devtools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools.d.ts","names":[],"sources":["../../src/devtools.ts"],"mappings":"AAQA,SAAS,OAAA,CAAA,EAAgB;EACvB,KAAK,MAAM,QAAA,IAAY,UAAA,EAAY,QAAA,CAAA,CAAU;;;;;;;;;AAU/C,SAAgB,YAAA,CAAa,IAAA,EAAc,QAAA,EAAwB;EACjE,gBAAA,CAAiB,GAAA,CAAI,IAAA,EAAM,IAAI,OAAA,CAAQ,QAAA,CAAS,CAAC;EACjD,OAAA,CAAA,CAAS;;;AAIX,SAAgB,cAAA,CAAe,IAAA,EAAoB;EACjD,gBAAA,CAAiB,MAAA,CAAO,IAAA,CAAK;EAC7B,OAAA,CAAA,CAAS;;;AAIX,SAAgB,sBAAA,CAAA,EAAmC;EACjD,KAAK,MAAM,CAAC,IAAA,EAAM,GAAA,CAAA,IAAQ,gBAAA,EACxB,IAAI,GAAA,CAAI,KAAA,CAAA,CAAO,KAAK,KAAA,CAAA,EAAW,gBAAA,CAAiB,MAAA,CAAO,IAAA,CAAK;EAE9D,OAAO,CAAC,GAAG,gBAAA,CAAiB,IAAA,CAAA,CAAM,CAAC;;;AAIrC,SAAgB,eAAA,CAAgB,IAAA,EAAkC;EAChE,MAAM,GAAA,GAAM,gBAAA,CAAiB,GAAA,CAAI,IAAA,CAAK;EACtC,IAAI,CAAC,GAAA,EAAK,OAAO,KAAA,CAAA;EACjB,MAAM,QAAA,GAAW,GAAA,CAAI,KAAA,CAAA,CAAO;EAC5B,IAAI,CAAC,QAAA,EAAU;IACb,gBAAA,CAAiB,MAAA,CAAO,IAAA,CAAK;IAC7B;;EAEF,OAAO,QAAA;;;AAIT,SAAS,QAAA,CACP,GAAA,EACA,GAAA,EACA,QAAA,GAAoB,KAAA,CAAA,EACX;EACT,IAAI;IACF,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,CAAA;IAChB,OAAO,OAAO,GAAA,KAAQ,UAAA,GAAc,GAAA,CAAA,CAAuB,GAAG,QAAA;UACxD;IACN,OAAO,QAAA;;;;;;AAOX,SAAgB,eAAA,CACd,IAAA,EACqC;EACrC,MAAM,QAAA,GAAW,eAAA,CAAgB,IAAA,CAAK;EACtC,IAAI,CAAC,QAAA,EAAU,OAAO,KAAA,CAAA;EACtB,MAAM,EAAA,GAAK,QAAA,CAAS,QAAA,EAAU,kBAAA,EAAA,eAAoB,IAAI,GAAA,CAAA,CAAK,CAAC;EAC5D,OAAO;IACL,MAAA,EAAQ,QAAA,CAAS,QAAA,EAAU,QAAA,CAAS;IACpC,gBAAA,EAAkB,QAAA,CAAS,QAAA,EAAU,kBAAA,EAAoB,EAAE,CAAC;IAC5D,gBAAA,EAAkB,EAAA,YAAc,GAAA,GAAM,CAAC,GAAG,EAAA,CAAG,GAAG,EAAE;IAClD,SAAA,EAAW,QAAA,CAAS,QAAA,EAAU,WAAA,EAAa,KAAA;GAC5C;;;AAIH,SAAgB,YAAA,CAAa,QAAA,EAAkC;EAC7D,UAAA,CAAW,GAAA,CAAI,QAAA,CAAS;EACxB,OAAA,MAAa;IACX,UAAA,CAAW,MAAA,CAAO,QAAA,CAAS;;;;AAK/B,SAAgB,cAAA,CAAA,EAAuB;EACrC,gBAAA,CAAiB,KAAA,CAAA,CAAO;EACxB,UAAA,CAAW,KAAA,CAAA,CAAO"}

package/lib/types/devtools2.d.ts

@@ -0,0 +1,30 @@
+//#region src/devtools.d.ts
+/**
+ * @pyreon/i18n devtools introspection API.
+ * Import: `import { ... } from "@pyreon/i18n/devtools"`
+ */
+/**
+ * Register an i18n instance for devtools inspection.
+ *
+ * @example
+ * const i18n = createI18n({ ... })
+ * registerI18n("app", i18n)
+ */
+declare function registerI18n(name: string, instance: object): void;
+/** Unregister an i18n instance. */
+declare function unregisterI18n(name: string): void;
+/** Get all registered i18n instance names. Cleans up garbage-collected instances. */
+declare function getActiveI18nInstances(): string[];
+/** Get an i18n instance by name (or undefined if GC'd or not registered). */
+declare function getI18nInstance(name: string): object | undefined;
+/**
+ * Get a snapshot of an i18n instance's state.
+ */
+declare function getI18nSnapshot(name: string): Record<string, unknown> | undefined;
+/** Subscribe to i18n registry changes. Returns unsubscribe function. */
+declare function onI18nChange(listener: () => void): () => void;
+/** @internal — reset devtools registry (for tests). */
+declare function _resetDevtools(): void;
+//#endregion
+export { _resetDevtools, getActiveI18nInstances, getI18nInstance, getI18nSnapshot, onI18nChange, registerI18n, unregisterI18n };
+//# sourceMappingURL=devtools2.d.ts.map

package/lib/types/devtools2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools2.d.ts","names":[],"sources":["../../src/devtools.ts"],"mappings":";;AAmBA;;;;;AAMA;;;;;iBANgB,YAAA,CAAa,IAAA,UAAc,QAAA;;iBAM3B,cAAA,CAAe,IAAA;;iBAMf,sBAAA,CAAA;AAQhB;AAAA,iBAAgB,eAAA,CAAgB,IAAA;;;;iBA4BhB,eAAA,CACd,IAAA,WACC,MAAA;;iBAaa,YAAA,CAAa,QAAA;;iBAQb,cAAA,CAAA"}