npm - @burojs/i18n-core - Versions diffs - 0.2.0 → 0.5.0 - Mend

@burojs/i18n-core 0.2.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/index.js CHANGED Viewed

@@ -1,229 +1,241 @@
-import i18next from 'i18next';
-// src/lookup.ts
+import i18next from "i18next";
+//#region src/lookup.ts
 function resolveKey(key, resource) {
-  if (!key) return [];
-  if (key.startsWith("resources.") || key.startsWith("enums.") || key.startsWith("common.")) {
-    return [key];
-  }
-  const candidates = [];
-  if (resource) {
-    candidates.push(`resources.${resource}.${key}`);
-  }
-  candidates.push(`resources._.${key}`);
-  candidates.push(`common.${key}`);
-  candidates.push(key);
-  return candidates;
+	if (!key) return [];
+	if (key.startsWith("resources.") || key.startsWith("enums.") || key.startsWith("common.") || key.startsWith("blocks.")) return [key];
+	const candidates = [];
+	if (resource) candidates.push(`resources.${resource}.${key}`);
+	candidates.push(`resources._.${key}`);
+	candidates.push(`common.${key}`);
+	candidates.push(key);
+	return candidates;
 }
+//#endregion
+//#region src/i18next-adapter.ts
+const MISSING = "\0";
 async function createI18nextAdapter(config) {
-  const instance = i18next.createInstance();
-  await instance.init({
-    lng: config.defaultLocale,
-    fallbackLng: config.fallbackLocale ?? config.defaultLocale,
-    supportedLngs: config.locales,
-    resources: config.resources,
-    keySeparator: config.keySeparator ?? ".",
-    // Qualified Buro entity refs use `namespace:id`. Resource keys flow
-    // through `resources.<ref>.<key>`, so treating ':' as i18next's namespace
-    // separator would split a valid ref before our explicit `ns` routing gets
-    // to resolve it.
-    nsSeparator: config.nsSeparator ?? false,
-    defaultNS: "common",
-    interpolation: { escapeValue: false },
-    returnNull: false
-  });
-  return {
-    t(key, params) {
-      const dotIdx = key.indexOf(".");
-      if (dotIdx === -1) {
-        return instance.t(key, params);
-      }
-      const ns = key.substring(0, dotIdx);
-      const subKey = key.substring(dotIdx + 1);
-      const result = instance.t(subKey, { ns, ...params ?? {} });
-      if (result === subKey && !instance.exists(subKey, { ns })) {
-        return key;
-      }
-      return result;
-    },
-    async changeLocale(locale) {
-      await instance.changeLanguage(locale);
-    },
-    async loadNamespace(namespace, _locale) {
-      await instance.loadNamespaces(namespace);
-    },
-    getCurrentLocale() {
-      return instance.language;
-    },
-    onLocaleChange(cb) {
-      instance.on("languageChanged", cb);
-      return () => instance.off("languageChanged", cb);
-    },
-    hasKey(key) {
-      const dotIdx = key.indexOf(".");
-      const ns = dotIdx === -1 ? void 0 : key.substring(0, dotIdx);
-      const subKey = dotIdx === -1 ? key : key.substring(dotIdx + 1);
-      const opts = ns === void 0 ? void 0 : { ns };
-      if (!instance.exists(subKey, opts)) return false;
-      const value = instance.t(subKey, { ...opts ?? {}, returnObjects: true });
-      return typeof value !== "object" || value === null;
-    }
-  };
+	const instance = i18next.createInstance();
+	await instance.init({
+		lng: config.defaultLocale,
+		fallbackLng: config.fallbackLocale ?? config.defaultLocale,
+		supportedLngs: config.locales,
+		resources: config.resources,
+		keySeparator: config.keySeparator ?? ".",
+		nsSeparator: config.nsSeparator ?? false,
+		defaultNS: "common",
+		interpolation: { escapeValue: false },
+		returnNull: false,
+		returnEmptyString: false
+	});
+	return {
+		t(key, params) {
+			const dotIdx = key.indexOf(".");
+			if (dotIdx === -1) return instance.t(key, params);
+			const ns = key.substring(0, dotIdx);
+			const subKey = key.substring(dotIdx + 1);
+			const result = instance.t(subKey, {
+				ns,
+				...params ?? {}
+			});
+			const count = typeof params?.count === "number" ? params.count : void 0;
+			if (result === subKey && !instance.exists(subKey, count === void 0 ? { ns } : {
+				ns,
+				count
+			})) return key;
+			return result;
+		},
+		async changeLocale(locale) {
+			await instance.changeLanguage(locale);
+		},
+		async loadNamespace(namespace, _locale) {
+			await instance.loadNamespaces(namespace);
+		},
+		getCurrentLocale() {
+			return instance.language;
+		},
+		onLocaleChange(cb) {
+			instance.on("languageChanged", cb);
+			return () => instance.off("languageChanged", cb);
+		},
+		hasKey(key, options) {
+			const dotIdx = key.indexOf(".");
+			const ns = dotIdx === -1 ? void 0 : key.substring(0, dotIdx);
+			const subKey = dotIdx === -1 ? key : key.substring(dotIdx + 1);
+			const lookup = {
+				...ns === void 0 ? {} : { ns },
+				...options?.count === void 0 ? {} : { count: options.count }
+			};
+			const value = instance.t(subKey, {
+				...lookup,
+				returnObjects: true,
+				defaultValue: MISSING
+			});
+			return value !== MISSING && (typeof value !== "object" || value === null);
+		}
+	};
 }
-// src/i18n.ts
+//#endregion
+//#region src/i18n.ts
 function createI18n(config) {
-  const { adapter, warnOnMissing = true } = config;
-  return {
-    t(key, options) {
-      const candidates = resolveKey(key, options?.resource);
-      for (const candidate of candidates) {
-        if (adapter.hasKey(candidate)) {
-          return adapter.t(candidate, options?.params);
-        }
-      }
-      if (warnOnMissing && typeof console !== "undefined") {
-        console.warn(
-          `[@burojs/i18n-core] Missing translation: '${key}'${options?.resource ? ` (resource: ${options.resource})` : ""}`
-        );
-      }
-      return key;
-    },
-    has(key, options) {
-      return resolveKey(key, options?.resource).some((candidate) => adapter.hasKey(candidate));
-    },
-    async changeLocale(locale) {
-      await adapter.changeLocale(locale);
-    },
-    getCurrentLocale() {
-      return adapter.getCurrentLocale();
-    },
-    onLocaleChange(cb) {
-      return adapter.onLocaleChange?.(cb) ?? (() => {
-      });
-    },
-    async loadNamespace(namespace, locale) {
-      await adapter.loadNamespace(namespace, locale);
-    },
-    adapter
-  };
+	const { adapter, warnOnMissing = true, locales } = config;
+	return {
+		t(key, options) {
+			const count = options?.count;
+			const params = count === void 0 ? options?.params : {
+				...options?.params,
+				count
+			};
+			const candidates = resolveKey(key, options?.resource);
+			for (const candidate of candidates) if (count === void 0 ? adapter.hasKey(candidate) : adapter.hasKey(candidate, { count })) return adapter.t(candidate, params);
+			if (warnOnMissing && typeof console !== "undefined") console.warn(`[@burojs/i18n-core] Missing translation: '${key}'${options?.resource ? ` (resource: ${options.resource})` : ""}`);
+			return key;
+		},
+		has(key, options) {
+			const count = options?.count;
+			return resolveKey(key, options?.resource).some((candidate) => count === void 0 ? adapter.hasKey(candidate) : adapter.hasKey(candidate, { count }));
+		},
+		async changeLocale(locale) {
+			await adapter.changeLocale(locale);
+		},
+		getCurrentLocale() {
+			return adapter.getCurrentLocale();
+		},
+		onLocaleChange(cb) {
+			return adapter.onLocaleChange?.(cb) ?? (() => {});
+		},
+		async loadNamespace(namespace, locale) {
+			await adapter.loadNamespace(namespace, locale);
+		},
+		...locales === void 0 ? {} : { locales },
+		adapter
+	};
 }
-// src/resource-context.ts
+//#endregion
+//#region src/resource-context.ts
 function createResourceI18n(i18n, resource) {
-  return {
-    t(key, options) {
-      return i18n.t(key, {
-        resource: options?.resource ?? resource,
-        params: options?.params
-      });
-    },
-    changeLocale: i18n.changeLocale,
-    getCurrentLocale: i18n.getCurrentLocale,
-    resource
-  };
+	return {
+		t(key, options) {
+			return i18n.t(key, {
+				resource: options?.resource ?? resource,
+				params: options?.params,
+				...options?.count === void 0 ? {} : { count: options.count }
+			});
+		},
+		changeLocale: i18n.changeLocale,
+		getCurrentLocale: i18n.getCurrentLocale,
+		resource
+	};
 }
-// src/locale-registry.ts
-var DEFAULT_NAMESPACE = "common";
+//#endregion
+//#region src/locale-registry.ts
+const DEFAULT_NAMESPACE = "common";
 function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function mergeBundle(base, overlay) {
-  const out = { ...base };
-  for (const [key, overlayValue] of Object.entries(overlay)) {
-    const baseValue = out[key];
-    out[key] = isPlainObject(baseValue) && isPlainObject(overlayValue) ? mergeBundle(baseValue, overlayValue) : overlayValue;
-  }
-  return out;
+	const out = { ...base };
+	for (const [key, overlayValue] of Object.entries(overlay)) {
+		const baseValue = out[key];
+		out[key] = isPlainObject(baseValue) && isPlainObject(overlayValue) ? mergeBundle(baseValue, overlayValue) : overlayValue;
+	}
+	return out;
 }
-function createLocaleRegistry() {
-  const registered = [];
-  return {
-    register(contribution) {
-      registered.push(contribution);
-    },
-    locales() {
-      return Array.from(new Set(registered.map((c) => c.locale))).sort();
-    },
-    namespaces() {
-      return Array.from(new Set(registered.map((c) => c.namespace ?? DEFAULT_NAMESPACE))).sort();
-    },
-    contributions() {
-      return registered;
-    },
-    buildResources() {
-      const byLocale = /* @__PURE__ */ new Map();
-      for (const contribution of registered) {
-        const namespace = contribution.namespace ?? DEFAULT_NAMESPACE;
-        let byNamespace = byLocale.get(contribution.locale);
-        if (!byNamespace) {
-          byNamespace = /* @__PURE__ */ new Map();
-          byLocale.set(contribution.locale, byNamespace);
-        }
-        const group = byNamespace.get(namespace);
-        if (group) {
-          group.push(contribution);
-        } else {
-          byNamespace.set(namespace, [contribution]);
-        }
-      }
-      const resources = {};
-      for (const [locale, byNamespace] of byLocale) {
-        const namespaces = {};
-        for (const [namespace, group] of byNamespace) {
-          const ordered = [...group].sort((a, b) => a.priority - b.priority);
-          let merged = {};
-          for (const contribution of ordered) {
-            merged = mergeBundle(merged, contribution.bundle);
-          }
-          namespaces[namespace] = merged;
-        }
-        resources[locale] = namespaces;
-      }
-      return resources;
-    }
-  };
+function createLocaleRegistry(options) {
+	const primary = options?.primary;
+	if (typeof primary !== "string" || primary === "") throw new TypeError(`createLocaleRegistry needs { primary }, the locale whose text is the default in code; received ${JSON.stringify(primary)}.`);
+	const registered = [];
+	return {
+		primary() {
+			return primary;
+		},
+		register(contribution) {
+			registered.push(contribution);
+		},
+		locales() {
+			return Array.from(new Set(registered.map((c) => c.locale))).sort();
+		},
+		namespaces() {
+			return Array.from(new Set(registered.map((c) => c.namespace ?? DEFAULT_NAMESPACE))).sort();
+		},
+		contributions() {
+			return registered;
+		},
+		buildResources() {
+			if (!registered.some((c) => c.locale === primary)) {
+				const known = Array.from(new Set(registered.map((c) => c.locale))).sort();
+				throw new Error(`The locale registry's primary locale ${JSON.stringify(primary)} has no contribution (registered: ${known.length === 0 ? "none" : known.join(", ")}). Register its bundle, an empty one if the app has no strings of its own, or declare the primary it does register.`);
+			}
+			const byLocale = new Map();
+			for (const contribution of registered) {
+				const namespace = contribution.namespace ?? DEFAULT_NAMESPACE;
+				let byNamespace = byLocale.get(contribution.locale);
+				if (!byNamespace) {
+					byNamespace = new Map();
+					byLocale.set(contribution.locale, byNamespace);
+				}
+				const group = byNamespace.get(namespace);
+				if (group) group.push(contribution);
+				else byNamespace.set(namespace, [contribution]);
+			}
+			const resources = {};
+			for (const [locale, byNamespace] of byLocale) {
+				const namespaces = {};
+				for (const [namespace, group] of byNamespace) {
+					const ordered = [...group].sort((a, b) => a.priority - b.priority);
+					let merged = {};
+					for (const contribution of ordered) merged = mergeBundle(merged, contribution.bundle);
+					namespaces[namespace] = merged;
+				}
+				resources[locale] = namespaces;
+			}
+			return resources;
+		}
+	};
 }
-var DEFAULT_LOCALE_PATTERN = /(?:^|\/)([A-Za-z0-9-]+)\.(?:ts|tsx|js|jsx|mjs|cjs)$/;
+const DEFAULT_LOCALE_PATTERN = /(?:^|\/)([A-Za-z0-9-]+)\.(?:ts|tsx|js|jsx|mjs|cjs)$/;
 function defaultLocaleOf(path) {
-  return DEFAULT_LOCALE_PATTERN.exec(path)?.[1];
+	return DEFAULT_LOCALE_PATTERN.exec(path)?.[1];
 }
 function localeContributionsFromGlob(glob, options) {
-  const localeOf = options.localeOf ?? defaultLocaleOf;
-  const out = [];
-  for (const [path, mod] of Object.entries(glob)) {
-    const locale = localeOf(path);
-    if (locale === void 0) continue;
-    const bundle = isPlainObject(mod.default) ? mod.default : mod;
-    out.push({
-      locale,
-      priority: options.priority,
-      source: options.source,
-      bundle,
-      ...options.namespace !== void 0 ? { namespace: options.namespace } : {}
-    });
-  }
-  return out;
+	const localeOf = options.localeOf ?? defaultLocaleOf;
+	const out = [];
+	for (const [path, mod] of Object.entries(glob)) {
+		const locale = localeOf(path);
+		if (locale === void 0) continue;
+		const bundle = isPlainObject(mod.default) ? mod.default : mod;
+		out.push({
+			locale,
+			priority: options.priority,
+			source: options.source,
+			bundle,
+			...options.namespace !== void 0 ? { namespace: options.namespace } : {}
+		});
+	}
+	return out;
 }
-// src/create-i18n-from-registry.ts
-async function createI18nFromRegistry(registry, config) {
-  const adapter = await createI18nextAdapter({
-    defaultLocale: config.defaultLocale,
-    locales: registry.locales(),
-    resources: registry.buildResources(),
-    ...config.fallbackLocale !== void 0 ? { fallbackLocale: config.fallbackLocale } : {},
-    ...config.keySeparator !== void 0 ? { keySeparator: config.keySeparator } : {},
-    ...config.nsSeparator !== void 0 ? { nsSeparator: config.nsSeparator } : {}
-  });
-  return createI18n({ adapter, warnOnMissing: config.warnOnMissing });
+//#endregion
+//#region src/create-i18n-from-registry.ts
+async function createI18nFromRegistry(registry, config = {}) {
+	const resources = registry.buildResources();
+	const primary = registry.primary();
+	return createI18n({
+		adapter: await createI18nextAdapter({
+			defaultLocale: config.defaultLocale ?? primary,
+			locales: registry.locales(),
+			resources,
+			fallbackLocale: config.fallbackLocale ?? primary,
+			...config.keySeparator !== void 0 ? { keySeparator: config.keySeparator } : {},
+			...config.nsSeparator !== void 0 ? { nsSeparator: config.nsSeparator } : {}
+		}),
+		warnOnMissing: config.warnOnMissing,
+		locales: () => registry.locales()
+	});
 }
-// src/index.ts
-var PACKAGE_NAME = "@burojs/i18n-core";
-var PACKAGE_VERSION = "0.0.0";
+//#endregion
+//#region src/index.ts
+const PACKAGE_NAME = "@burojs/i18n-core";
+const PACKAGE_VERSION = "0.0.0";
+//#endregion
 export { PACKAGE_NAME, PACKAGE_VERSION, createI18n, createI18nFromRegistry, createI18nextAdapter, createLocaleRegistry, createResourceI18n, localeContributionsFromGlob, resolveKey };
-//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/lookup.ts","../src/i18next-adapter.ts","../src/i18n.ts","../src/resource-context.ts","../src/locale-registry.ts","../src/create-i18n-from-registry.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/*\n Build candidate keys for fallback lookup.\n \n Lookup order (first match wins):\n * 1. resources.<name>.<key> — resource-specific\n * 2. resources._.<key> — base for all resources\n * 3. common.<key> — global common\n * 4. <key> — raw fallback (debug only)\n \n If `key` is already namespaced (starts with `resources.`, `enums.` or\n * `common.`), return it as-is without further scoping.\n /\nexport function resolveKey(key: string, resource?: string): string[] {\n if (!key) return [];\n\n // Already namespaced — return as-is. `enums.` is a first-class top-level\n // namespace (global enum labels), like `resources.` and `common.`.\n if (key.startsWith('resources.') \|\| key.startsWith('enums.') \|\| key.startsWith('common.')) {\n return [key];\n }\n\n const candidates: string[] = [];\n if (resource) {\n candidates.push(`resources.${resource}.${key}`);\n }\n candidates.push(`resources._.${key}`);\n candidates.push(`common.${key}`);\n candidates.push(key); // raw fallback for warnings\n return candidates;\n}\n","import i18next, { type FallbackLng, type i18n } from 'i18next';\nimport type { I18nAdapter, TranslationBundle } from './types/index.js';\n\nexport interface I18nextAdapterConfig {\n defaultLocale: string;\n locales: string[];\n resources?: Record<string, Record<string, TranslationBundle>>;\n /\n A single fallback locale (`'en'`) applies uniformly to every locale. A\n * `fr → en` fallback for one locale but not another needs i18next's own\n * per-locale chain shape instead — `{ fr: ['en'], default: ['en'] }` — so\n * this accepts i18next's full `FallbackLng` type rather than just `string`.\n * The chain is entirely CONFIG: nothing in this adapter special-cases any\n * particular locale code, here or anywhere else.\n /\n fallbackLocale?: FallbackLng;\n keySeparator?: string \| false;\n nsSeparator?: string \| false;\n}\n\n/\n Default I18nAdapter implementation backed by i18next.\n * Each top-level key in resources becomes a separate i18next namespace\n * (e.g. 'common', 'resources').\n /\nexport async function createI18nextAdapter(config: I18nextAdapterConfig): Promise<I18nAdapter> {\n const instance: i18n = i18next.createInstance();\n\n await instance.init({\n lng: config.defaultLocale,\n fallbackLng: config.fallbackLocale ?? config.defaultLocale,\n supportedLngs: config.locales,\n resources: config.resources,\n keySeparator: config.keySeparator ?? '.',\n // Qualified Buro entity refs use `namespace:id`. Resource keys flow\n // through `resources.<ref>.<key>`, so treating ':' as i18next's namespace\n // separator would split a valid ref before our explicit `ns` routing gets\n // to resolve it.\n nsSeparator: config.nsSeparator ?? false,\n defaultNS: 'common',\n interpolation: { escapeValue: false },\n returnNull: false,\n });\n\n return {\n t(key, params) {\n const dotIdx = key.indexOf('.');\n if (dotIdx === -1) {\n return instance.t(key, params) as string;\n }\n const ns = key.substring(0, dotIdx);\n const subKey = key.substring(dotIdx + 1);\n const result = instance.t(subKey, { ns, ...(params ?? {}) }) as string;\n // i18next returns the bare subKey when missing — restore the full key as fallback\n if (result === subKey && !instance.exists(subKey, { ns })) {\n return key;\n }\n return result;\n },\n async changeLocale(locale) {\n await instance.changeLanguage(locale);\n },\n async loadNamespace(namespace, _locale) {\n await instance.loadNamespaces(namespace);\n },\n getCurrentLocale() {\n return instance.language;\n },\n onLocaleChange(cb) {\n instance.on('languageChanged', cb);\n return () => instance.off('languageChanged', cb);\n },\n hasKey(key) {\n const dotIdx = key.indexOf('.');\n const ns = dotIdx === -1 ? undefined : key.substring(0, dotIdx);\n const subKey = dotIdx === -1 ? key : key.substring(dotIdx + 1);\n const opts = ns === undefined ? undefined : { ns };\n if (!instance.exists(subKey, opts)) return false;\n /\n `exists()` alone is not enough, and the gap is the root cause of a whole\n family of bugs rather than a curiosity.\n\n i18next answers `exists()` with TRUE for an OBJECT node — `fields.gtin`\n once that entry is promoted from a plain string to `{ label, doc }`,\n `enums.<ns>.<value>` when it carries a `doc` but no `label`, and so on.\n `t()` on such a node neither throws nor returns the key: it returns the\n literal sentence\n\n key '…' returned an object instead of string.\n\n Since `resolveContentSlot` commits to the FIRST key whose `has()` is\n true, every resolver built on it — field labels, enum labels, nav\n labels, tab captions — would render that sentence to the user. No crash,\n no warning, just wrong text on screen. It was found three separate times\n in three separate resolvers before being fixed here, once.\n\n So `has` now means what its callers always assumed: there is a USABLE\n STRING at this key. Non-object primitives stay truthy, leaving plural\n forms and numeric values behaving exactly as before.\n /\n const value = instance.t(subKey, { ...(opts ?? {}), returnObjects: true }) as unknown;\n return typeof value !== 'object' \|\| value === null;\n },\n };\n}\n","import { resolveKey } from './lookup.js';\nimport type { I18nAdapter } from './types/index.js';\n\nexport interface I18nFacade {\n t: (key: string, options?: { resource?: string; params?: Record<string, unknown> }) => string;\n /\n True when a translation for `key` EXISTS (through the same candidate chain\n * as {@link I18nFacade.t}). Distinct from `t`, which returns the raw key on a\n * miss — the content model probes presence with `has` to tell \"no bundle\n * entry\" (render nothing) from \"bundle entry === key text\".\n /\n has: (key: string, options?: { resource?: string }) => boolean;\n changeLocale: (locale: string) => Promise<void>;\n getCurrentLocale: () => string;\n /\n Subscribe to active-locale changes. Returns an unsubscribe fn. When the\n * adapter can't notify, this is a no-op subscription (returns an unsubscribe\n * that does nothing) — the live language switch then falls back to a static\n * read. Consumed by `useLocale()` via `useSyncExternalStore`.\n /\n onLocaleChange: (cb: () => void) => () => void;\n loadNamespace: (namespace: string, locale: string) => Promise<void>;\n adapter: I18nAdapter;\n}\n\nexport interface CreateI18nConfig {\n adapter: I18nAdapter;\n warnOnMissing?: boolean;\n}\n\nexport function createI18n(config: CreateI18nConfig): I18nFacade {\n const { adapter, warnOnMissing = true } = config;\n\n return {\n t(key, options) {\n const candidates = resolveKey(key, options?.resource);\n for (const candidate of candidates) {\n if (adapter.hasKey(candidate)) {\n return adapter.t(candidate, options?.params);\n }\n }\n if (warnOnMissing && typeof console !== 'undefined') {\n console.warn(\n `[@burojs/i18n-core] Missing translation: '${key}'${options?.resource ? ` (resource: ${options.resource})` : ''}`,\n );\n }\n return key;\n },\n has(key, options) {\n return resolveKey(key, options?.resource).some((candidate) => adapter.hasKey(candidate));\n },\n async changeLocale(locale) {\n await adapter.changeLocale(locale);\n },\n getCurrentLocale() {\n return adapter.getCurrentLocale();\n },\n onLocaleChange(cb) {\n return adapter.onLocaleChange?.(cb) ?? (() => {});\n },\n async loadNamespace(namespace, locale) {\n await adapter.loadNamespace(namespace, locale);\n },\n adapter,\n };\n}\n","import type { I18nFacade } from './i18n.js';\n\nexport interface ResourceI18n {\n t: (key: string, options?: { resource?: string; params?: Record<string, unknown> }) => string;\n changeLocale: (locale: string) => Promise<void>;\n getCurrentLocale: () => string;\n resource: string;\n}\n\n/\n Wraps an I18nFacade with a default resource scope.\n * `t('actions.delete')` will lookup `resources.<resource>.actions.delete` first.\n * Pass an explicit `resource` option to override the default scope.\n /\nexport function createResourceI18n(i18n: I18nFacade, resource: string): ResourceI18n {\n return {\n t(key, options) {\n return i18n.t(key, {\n resource: options?.resource ?? resource,\n params: options?.params,\n });\n },\n changeLocale: i18n.changeLocale,\n getCurrentLocale: i18n.getCurrentLocale,\n resource,\n };\n}\n","import type { TranslationBundle } from './types/bundle.js';\n\n/\n One package/app/domain module's offering for one locale.\n \n A contribution is data, not code: nothing about `createI18nextAdapter`'s\n * `resources` shape is visible here, and nothing here names a fixed set of\n * locale codes or counts them. `locale` is whatever the file/module that\n * produced this contribution says it is — the registry never validates it\n * against a known list, because there is no known list. That is the whole\n * point: a twenty-first language is a twenty-first contribution, not a\n * twenty-first `case`.\n /\nexport interface LocaleContribution {\n /* Locale code this contribution provides strings for (e.g. 'en', 'es', 'fr'). /\n locale: string;\n /\n i18next namespace the bundle merges into. Defaults to `'common'` — the\n * same default namespace `createI18nextAdapter` uses.\n /\n namespace?: string;\n /\n Declared merge priority. On a key collision within the same\n * (locale, namespace), the contribution with the HIGHER priority wins —\n * not whichever happened to register last. Ties fall back to registration\n * order (last registered wins), which is why two genuinely competing\n * sources must declare distinct priorities rather than relying on the tie\n * break.\n /\n priority: number;\n /\n Where this contribution came from — a package name, `'app'`, an enum\n * module name. Diagnostic only (surfaced by {@link LocaleRegistry.contributions}\n * for debugging a collision); never branched on.\n /\n source: string;\n bundle: TranslationBundle;\n}\n\nexport interface LocaleRegistry {\n /* Add one contribution. Order of registration does not matter for the merge result — only `priority` does (see {@link LocaleContribution.priority}). /\n register(contribution: LocaleContribution): void;\n /\n Every locale code that has at least one contribution, sorted. Derived\n * purely from what was registered — nothing enumerates or counts locales\n * anywhere else in this module.\n /\n locales(): string[];\n /* Every namespace that has at least one contribution, sorted. /\n namespaces(): string[];\n /* All registered contributions, in registration order. For diagnostics/tests. /\n contributions(): readonly LocaleContribution[];\n /\n Assemble `{ [locale]: { [namespace]: TranslationBundle } }`, ready to\n * pass straight as `createI18nextAdapter`'s `resources` config. Within one\n * (locale, namespace) group, contributions are deep-merged in ascending\n * priority order, so a higher-priority contribution's leaves win over a\n * lower-priority one's on any overlapping key while leaving the rest of\n * the lower-priority bundle intact.\n /\n buildResources(): Record<string, Record<string, TranslationBundle>>;\n}\n\nconst DEFAULT_NAMESPACE = 'common';\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/\n Recursively merge `overlay` onto `base`. Arrays and primitives are replaced\n * wholesale (a `TranslationBundle` array leaf — see that type's own comment\n * on why arrays are a real leaf shape — is not index-merged: the whole array\n * is the unit an overlay replaces). Plain objects merge key by key.\n /\nfunction mergeBundle(base: TranslationBundle, overlay: TranslationBundle): TranslationBundle {\n const out: Record<string, unknown> = { ...base };\n for (const [key, overlayValue] of Object.entries(overlay)) {\n const baseValue = out[key];\n out[key] =\n isPlainObject(baseValue) && isPlainObject(overlayValue)\n ? mergeBundle(baseValue as TranslationBundle, overlayValue as TranslationBundle)\n : overlayValue;\n }\n return out as TranslationBundle;\n}\n\nexport function createLocaleRegistry(): LocaleRegistry {\n const registered: LocaleContribution[] = [];\n\n return {\n register(contribution) {\n registered.push(contribution);\n },\n locales() {\n return Array.from(new Set(registered.map((c) => c.locale))).sort();\n },\n namespaces() {\n return Array.from(new Set(registered.map((c) => c.namespace ?? DEFAULT_NAMESPACE))).sort();\n },\n contributions() {\n return registered;\n },\n buildResources() {\n // Group by (locale, namespace) via NESTED maps rather than a\n // delimiter-joined composite string key. A locale or namespace code is\n // caller-supplied and unconstrained (see `LocaleContribution.locale`'s\n // own comment), so any single-character delimiter is a value that\n // could* collide with real content; nested `Map`s need no delimiter\n // at all, so there is nothing to collide with and nothing unusual\n // embedded in this file's source for a diff tool to trip over.\n const byLocale = new Map<string, Map<string, LocaleContribution[]>>();\n for (const contribution of registered) {\n const namespace = contribution.namespace ?? DEFAULT_NAMESPACE;\n let byNamespace = byLocale.get(contribution.locale);\n if (!byNamespace) {\n byNamespace = new Map<string, LocaleContribution[]>();\n byLocale.set(contribution.locale, byNamespace);\n }\n const group = byNamespace.get(namespace);\n if (group) {\n group.push(contribution);\n } else {\n byNamespace.set(namespace, [contribution]);\n }\n }\n\n const resources: Record<string, Record<string, TranslationBundle>> = {};\n for (const [locale, byNamespace] of byLocale) {\n const namespaces: Record<string, TranslationBundle> = {};\n for (const [namespace, group] of byNamespace) {\n // Stable sort ascending by priority: lower priority applied first,\n // higher priority applied last so it wins the overlapping leaves.\n // `Array#sort` is stable per spec (ES2019+), so contributions with\n // equal priority keep their registration order — last-registered\n // wins ONLY within a tie, never across a declared priority gap.\n const ordered = [...group].sort((a, b) => a.priority - b.priority);\n let merged: TranslationBundle = {};\n for (const contribution of ordered) {\n merged = mergeBundle(merged, contribution.bundle);\n }\n namespaces[namespace] = merged;\n }\n resources[locale] = namespaces;\n }\n return resources;\n },\n };\n}\n\n/*\n A bundler-produced glob module, as `import.meta.glob` (Vite) or an\n * equivalent walk over `require.context` (webpack) would yield it: a flat\n * map of path → either the loaded module itself or `{ default }`.\n \n Bundler-agnostic on purpose, same reasoning as `@burojs/core`'s\n * `docsFromGlob`: no bundler-agnostic glob primitive exists, and a published\n * package must not require one — the ADOPTER calls `import.meta.glob` (or\n * whatever their bundler offers) and hands the plain object here.\n /\nexport type LocaleGlobModule = TranslationBundle \| { default: TranslationBundle };\n\nexport interface LocaleContributionsFromGlobOptions {\n /* {@link LocaleContribution.source} for every contribution produced. /\n source: string;\n /* {@link LocaleContribution.priority} for every contribution produced. /\n priority: number;\n /* {@link LocaleContribution.namespace}. Defaults to `'common'`. /\n namespace?: string;\n /\n Extracts the locale code from a glob path. Default matches a bare\n * `<locale>.ts`/`<locale>.tsx`/`<locale>.js` filename (`'./locales/en.ts'`\n * → `'en'`, `'./locales/fr-CA.ts'` → `'fr-CA'`) — no restriction to a\n * known set of codes; whatever the filename says IS the locale code. Paths\n * that don't match are skipped rather than guessed at (same discipline as\n * `docsFromGlob`).\n /\n localeOf?: (path: string) => string \| undefined;\n}\n\nconst DEFAULT_LOCALE_PATTERN = /(?:^\|\\/)([A-Za-z0-9-]+)\\.(?:ts\|tsx\|js\|jsx\|mjs\|cjs)$/;\n\nfunction defaultLocaleOf(path: string): string \| undefined {\n return DEFAULT_LOCALE_PATTERN.exec(path)?.[1];\n}\n\n/\n Normalize a bundler glob of per-locale files into {@link LocaleContribution}s.\n * One file → one locale → one contribution. Nothing here enumerates or counts\n * locale codes: whatever files are present in the globbed directory at build\n * time ARE the contributions produced — dropping in a new file is the entire\n * mechanism for adding a language.\n /\nexport function localeContributionsFromGlob(\n glob: Record<string, LocaleGlobModule>,\n options: LocaleContributionsFromGlobOptions,\n): LocaleContribution[] {\n const localeOf = options.localeOf ?? defaultLocaleOf;\n const out: LocaleContribution[] = [];\n for (const [path, mod] of Object.entries(glob)) {\n const locale = localeOf(path);\n if (locale === undefined) continue;\n // Eager `import.meta.glob` yields a module namespace object — always\n // `{ default, ...named exports }` for a file that does `export default\n // {...}`. Unwrap it when present; otherwise trust the glob already\n // handed a bare bundle (e.g. a caller that pre-unwrapped, or a\n // require.context-style walk that returns exports directly).\n const bundle = isPlainObject((mod as { default?: unknown }).default)\n ? (mod as { default: TranslationBundle }).default\n : (mod as TranslationBundle);\n out.push({\n locale,\n priority: options.priority,\n source: options.source,\n bundle,\n ...(options.namespace !== undefined ? { namespace: options.namespace } : {}),\n });\n }\n return out;\n}\n","import { type I18nFacade, createI18n } from './i18n.js';\nimport { type I18nextAdapterConfig, createI18nextAdapter } from './i18next-adapter.js';\nimport type { LocaleRegistry } from './locale-registry.js';\n\nexport type CreateI18nFromRegistryConfig = Pick<\n I18nextAdapterConfig,\n 'defaultLocale' \| 'fallbackLocale' \| 'keySeparator' \| 'nsSeparator'\n> & {\n warnOnMissing?: boolean;\n};\n\n/\n Wires a {@link LocaleRegistry} straight into `createI18nextAdapter` +\n * `createI18n`: `registry.locales()` becomes the adapter's `locales`,\n * `registry.buildResources()` becomes its `resources`. This is the ONLY\n * place those two need to be threaded together — an app that builds its own\n * registry never re-lists its locale codes to hand them to the adapter, it\n * just calls this.\n /\nexport async function createI18nFromRegistry(\n registry: LocaleRegistry,\n config: CreateI18nFromRegistryConfig,\n): Promise<I18nFacade> {\n const adapter = await createI18nextAdapter({\n defaultLocale: config.defaultLocale,\n locales: registry.locales(),\n resources: registry.buildResources(),\n ...(config.fallbackLocale !== undefined ? { fallbackLocale: config.fallbackLocale } : {}),\n ...(config.keySeparator !== undefined ? { keySeparator: config.keySeparator } : {}),\n ...(config.nsSeparator !== undefined ? { nsSeparator: config.nsSeparator } : {}),\n });\n return createI18n({ adapter, warnOnMissing: config.warnOnMissing });\n}\n","// Constants\nexport const PACKAGE_NAME = '@burojs/i18n-core' as const;\nexport const PACKAGE_VERSION = '0.0.0' as const;\n\n// Types\nexport type from './types/index.js';\n\n// Lookup\nexport { resolveKey } from './lookup.js';\n\n// i18next adapter\nexport { createI18nextAdapter, type I18nextAdapterConfig } from './i18next-adapter.js';\n\n// I18n facade\nexport { createI18n, type I18nFacade, type CreateI18nConfig } from './i18n.js';\n\n// Resource context\nexport { createResourceI18n, type ResourceI18n } from './resource-context.js';\n\n// Locale registry — assembling locales from what has REGISTERED (framework\n// packages, the app, domain enum modules) instead of a hand-printed literal.\nexport {\n createLocaleRegistry,\n localeContributionsFromGlob,\n type LocaleContribution,\n type LocaleContributionsFromGlobOptions,\n type LocaleGlobModule,\n type LocaleRegistry,\n} from './locale-registry.js';\nexport {\n createI18nFromRegistry,\n type CreateI18nFromRegistryConfig,\n} from './create-i18n-from-registry.js';\n"]}
1	+ {"version":3,"file":"index.js","names":[],"sources":["../src/lookup.ts","../src/i18next-adapter.ts","../src/i18n.ts","../src/resource-context.ts","../src/locale-registry.ts","../src/create-i18n-from-registry.ts","../src/index.ts"],"sourcesContent":["/*\n Build candidate keys for fallback lookup.\n \n Lookup order (first match wins):\n * 1. resources.<name>.<key> — resource-specific\n * 2. resources._.<key> — base for all resources\n * 3. common.<key> — global common\n * 4. <key> — raw fallback (debug only)\n \n If `key` is already namespaced (starts with `resources.`, `enums.`,\n * `common.` or `blocks.`), return it as-is without further scoping.\n /\nexport function resolveKey(key: string, resource?: string): string[] {\n if (!key) return [];\n\n // Already namespaced — return as-is. `enums.` is a first-class top-level\n // namespace (global enum labels), like `resources.` and `common.`; so is\n // `blocks.` (a block view's `t` reads `blocks.<id>.<key>`).\n if (\n key.startsWith('resources.') \|\|\n key.startsWith('enums.') \|\|\n key.startsWith('common.') \|\|\n key.startsWith('blocks.')\n ) {\n return [key];\n }\n\n const candidates: string[] = [];\n if (resource) {\n candidates.push(`resources.${resource}.${key}`);\n }\n candidates.push(`resources._.${key}`);\n candidates.push(`common.${key}`);\n candidates.push(key); // raw fallback for warnings\n return candidates;\n}\n","import i18next, { type FallbackLng, type i18n } from 'i18next';\nimport type { I18nAdapter, TranslationBundle } from './types/index.js';\n\n/* What a lookup answers when no locale in the chain holds a usable value. /\nconst MISSING = '\\u0000';\n\nexport interface I18nextAdapterConfig {\n defaultLocale: string;\n locales: string[];\n resources?: Record<string, Record<string, TranslationBundle>>;\n /\n A single fallback locale (`'en'`) applies uniformly to every locale. A\n * `fr → en` fallback for one locale but not another needs i18next's own\n * per-locale chain shape instead — `{ fr: ['en'], default: ['en'] }` — so\n * this accepts i18next's full `FallbackLng` type rather than just `string`.\n * The chain is entirely CONFIG: nothing in this adapter special-cases any\n * particular locale code, here or anywhere else.\n /\n fallbackLocale?: FallbackLng;\n keySeparator?: string \| false;\n nsSeparator?: string \| false;\n}\n\n/\n Default I18nAdapter implementation backed by i18next.\n * Each top-level key in resources becomes a separate i18next namespace\n * (e.g. 'common', 'resources').\n /\nexport async function createI18nextAdapter(config: I18nextAdapterConfig): Promise<I18nAdapter> {\n const instance: i18n = i18next.createInstance();\n\n await instance.init({\n lng: config.defaultLocale,\n fallbackLng: config.fallbackLocale ?? config.defaultLocale,\n supportedLngs: config.locales,\n resources: config.resources,\n keySeparator: config.keySeparator ?? '.',\n // Qualified Buro entity refs use `namespace:id`. Resource keys flow\n // through `resources.<ref>.<key>`, so treating ':' as i18next's namespace\n // separator would split a valid ref before our explicit `ns` routing gets\n // to resolve it.\n nsSeparator: config.nsSeparator ?? false,\n defaultNS: 'common',\n interpolation: { escapeValue: false },\n returnNull: false,\n // An empty string is an untranslated key (what extraction tools write), not\n // a translation: `exists` and `t` walk on to the fallback locale, then the\n // caller's code default, so a label never renders blank.\n returnEmptyString: false,\n });\n\n return {\n t(key, params) {\n const dotIdx = key.indexOf('.');\n if (dotIdx === -1) {\n return instance.t(key, params) as string;\n }\n const ns = key.substring(0, dotIdx);\n const subKey = key.substring(dotIdx + 1);\n const result = instance.t(subKey, { ns, ...(params ?? {}) }) as string;\n // i18next returns the bare subKey when missing — restore the full key as\n // fallback. The probe carries the count, so a resolved count family is\n // not mistaken for a miss.\n const count = typeof params?.count === 'number' ? params.count : undefined;\n if (\n result === subKey &&\n !instance.exists(subKey, count === undefined ? { ns } : { ns, count })\n ) {\n return key;\n }\n return result;\n },\n async changeLocale(locale) {\n await instance.changeLanguage(locale);\n },\n async loadNamespace(namespace, _locale) {\n await instance.loadNamespaces(namespace);\n },\n getCurrentLocale() {\n return instance.language;\n },\n onLocaleChange(cb) {\n instance.on('languageChanged', cb);\n return () => instance.off('languageChanged', cb);\n },\n hasKey(key, options) {\n const dotIdx = key.indexOf('.');\n const ns = dotIdx === -1 ? undefined : key.substring(0, dotIdx);\n const subKey = dotIdx === -1 ? key : key.substring(dotIdx + 1);\n const lookup = {\n ...(ns === undefined ? {} : { ns }),\n ...(options?.count === undefined ? {} : { count: options.count }),\n };\n /\n `exists()` is not enough, and the gap is the root cause of a whole\n family of bugs rather than a curiosity.\n\n i18next answers `exists()` with TRUE for an OBJECT node — `fields.gtin`\n once that entry is promoted from a plain string to `{ label, doc }`,\n `enums.<ns>.<value>` when it carries a `doc` but no `label`, and so on.\n `t()` on such a node neither throws nor returns the key: it returns the\n literal sentence\n\n key '…' returned an object instead of string.\n\n Since `resolveContentSlot` commits to the FIRST key whose `has()` is\n true, every resolver built on it — field labels, enum labels, nav\n labels, tab captions — would render that sentence to the user. No crash,\n no warning, just wrong text on screen. It was found three separate times\n in three separate resolvers before being fixed here, once.\n\n `exists()` is also TRUE for an empty string in the last locale of the\n chain, even with `returnEmptyString: false`. So the lookup itself is the\n probe: `t()` walks the whole chain (count forms included) and answers the\n sentinel default only when no locale holds a usable value.\n\n So `has` means what its callers always assumed: there is a USABLE,\n non-empty STRING at this key. Non-object primitives stay truthy, leaving\n plural forms and numeric values behaving exactly as before.\n /\n const value = instance.t(subKey, {\n ...lookup,\n returnObjects: true,\n defaultValue: MISSING,\n }) as unknown;\n return value !== MISSING && (typeof value !== 'object' \|\| value === null);\n },\n };\n}\n","import { resolveKey } from './lookup.js';\nimport type { I18nAdapter } from './types/index.js';\n\nexport interface I18nFacade {\n /\n Translate `key` through the candidate chain. `count` selects a count\n * family's form (`<key>_one \| _few \| _many \| _other`, by the locale's CLDR\n * rules) and interpolates `{{count}}`; a family asked without a count is\n * missing. A `count` inside `params` only interpolates.\n /\n t: (\n key: string,\n options?: { resource?: string; params?: Record<string, unknown>; count?: number },\n ) => string;\n /\n True when a translation for `key` EXISTS (through the same candidate chain\n * as {@link I18nFacade.t}). Distinct from `t`, which returns the raw key on a\n * miss — the content model probes presence with `has` to tell \"no bundle\n * entry\" (render nothing) from \"bundle entry === key text\". Pass `count` to probe a count family.\n /\n has: (key: string, options?: { resource?: string; count?: number }) => boolean;\n changeLocale: (locale: string) => Promise<void>;\n getCurrentLocale: () => string;\n /\n Subscribe to active-locale changes. Returns an unsubscribe fn. When the\n * adapter can't notify, this is a no-op subscription (returns an unsubscribe\n * that does nothing) — the live language switch then falls back to a static\n * read. Consumed by `useLocale()` via `useSyncExternalStore`.\n /\n onLocaleChange: (cb: () => void) => () => void;\n loadNamespace: (namespace: string, locale: string) => Promise<void>;\n /\n The locale codes this app can switch to. Optional: a facade built without\n * a list (a hand-rolled one, a test double) simply does not say, and a\n * language control then offers only the active locale. `createI18nFromRegistry`\n * fills it from the registry.\n /\n locales?: () => readonly string[];\n adapter: I18nAdapter;\n}\n\nexport interface CreateI18nConfig {\n adapter: I18nAdapter;\n warnOnMissing?: boolean;\n /* The switchable locale codes, exposed as {@link I18nFacade.locales}. /\n locales?: () => readonly string[];\n}\n\nexport function createI18n(config: CreateI18nConfig): I18nFacade {\n const { adapter, warnOnMissing = true, locales } = config;\n\n return {\n t(key, options) {\n // `count` is the one spelling: a `count` inside `params` only interpolates.\n const count = options?.count;\n const params = count === undefined ? options?.params : { ...options?.params, count };\n const candidates = resolveKey(key, options?.resource);\n for (const candidate of candidates) {\n const present =\n count === undefined ? adapter.hasKey(candidate) : adapter.hasKey(candidate, { count });\n if (present) {\n return adapter.t(candidate, params);\n }\n }\n if (warnOnMissing && typeof console !== 'undefined') {\n console.warn(\n `[@burojs/i18n-core] Missing translation: '${key}'${options?.resource ? ` (resource: ${options.resource})` : ''}`,\n );\n }\n return key;\n },\n has(key, options) {\n const count = options?.count;\n return resolveKey(key, options?.resource).some((candidate) =>\n count === undefined ? adapter.hasKey(candidate) : adapter.hasKey(candidate, { count }),\n );\n },\n async changeLocale(locale) {\n await adapter.changeLocale(locale);\n },\n getCurrentLocale() {\n return adapter.getCurrentLocale();\n },\n onLocaleChange(cb) {\n return adapter.onLocaleChange?.(cb) ?? (() => {});\n },\n async loadNamespace(namespace, locale) {\n await adapter.loadNamespace(namespace, locale);\n },\n ...(locales === undefined ? {} : { locales }),\n adapter,\n };\n}\n","import type { I18nFacade } from './i18n.js';\n\nexport interface ResourceI18n {\n t: (\n key: string,\n options?: { resource?: string; params?: Record<string, unknown>; count?: number },\n ) => string;\n changeLocale: (locale: string) => Promise<void>;\n getCurrentLocale: () => string;\n resource: string;\n}\n\n/\n Wraps an I18nFacade with a default resource scope.\n * `t('actions.delete')` will lookup `resources.<resource>.actions.delete` first.\n * Pass an explicit `resource` option to override the default scope.\n /\nexport function createResourceI18n(i18n: I18nFacade, resource: string): ResourceI18n {\n return {\n t(key, options) {\n return i18n.t(key, {\n resource: options?.resource ?? resource,\n params: options?.params,\n ...(options?.count === undefined ? {} : { count: options.count }),\n });\n },\n changeLocale: i18n.changeLocale,\n getCurrentLocale: i18n.getCurrentLocale,\n resource,\n };\n}\n","import type { TranslationBundle } from './types/bundle.js';\n\n/\n One package/app/domain module's offering for one locale.\n \n A contribution is data, not code: nothing about `createI18nextAdapter`'s\n * `resources` shape is visible here, and nothing here names a fixed set of\n * locale codes or counts them. `locale` is whatever the file/module that\n * produced this contribution says it is — the registry never validates it\n * against a known list, because there is no known list. That is the whole\n * point: a twenty-first language is a twenty-first contribution, not a\n * twenty-first `case`.\n /\nexport interface LocaleContribution {\n /* Locale code this contribution provides strings for (e.g. 'en', 'es', 'fr'). /\n locale: string;\n /\n i18next namespace the bundle merges into. Defaults to `'common'` — the\n * same default namespace `createI18nextAdapter` uses.\n /\n namespace?: string;\n /\n Declared merge priority. On a key collision within the same\n * (locale, namespace), the contribution with the HIGHER priority wins —\n * not whichever happened to register last. Ties fall back to registration\n * order (last registered wins), which is why two genuinely competing\n * sources must declare distinct priorities rather than relying on the tie\n * break.\n /\n priority: number;\n /\n Where this contribution came from — a package name, `'app'`, an enum\n * module name. Diagnostic only (surfaced by {@link LocaleRegistry.contributions}\n * for debugging a collision); never branched on.\n /\n source: string;\n bundle: TranslationBundle;\n}\n\nexport interface LocaleRegistry {\n /\n The primary locale, as declared to {@link createLocaleRegistry}: the one\n * whose text is the default in code, and the locale every other one falls\n * back to. The single source of truth for it — `createI18nFromRegistry`\n * defaults both the starting locale and the fallback to it, and\n * `@burojs/testing`'s `checkApp` reads it to know which locale is exempt\n * from `i18n.missing`. Never derived from contributions or their order.\n /\n primary(): string;\n /* Add one contribution. Order of registration does not matter for the merge result — only `priority` does (see {@link LocaleContribution.priority}). /\n register(contribution: LocaleContribution): void;\n /\n Every locale code that has at least one contribution, sorted. Derived\n * purely from what was registered — nothing enumerates or counts locales\n * anywhere else in this module.\n /\n locales(): string[];\n /* Every namespace that has at least one contribution, sorted. /\n namespaces(): string[];\n /* All registered contributions, in registration order. For diagnostics/tests. /\n contributions(): readonly LocaleContribution[];\n /\n Assemble `{ [locale]: { [namespace]: TranslationBundle } }`, ready to\n * pass straight as `createI18nextAdapter`'s `resources` config. Within one\n * (locale, namespace) group, contributions are deep-merged in ascending\n * priority order, so a higher-priority contribution's leaves win over a\n * lower-priority one's on any overlapping key while leaving the rest of\n * the lower-priority bundle intact.\n \n Throws when no contribution is registered for {@link primary}: a\n * fallback chain that ends at a locale with no bundle, and a primary that\n * `locales()` (and so every language switcher built from it) does not\n * list, is a misconfiguration (usually a typo, `'en-US'` for `'en'`, or a\n * glob that missed its file), not a state to render. An app that really\n * has no strings for its primary locale registers an empty bundle for it.\n /\n buildResources(): Record<string, Record<string, TranslationBundle>>;\n}\n\nconst DEFAULT_NAMESPACE = 'common';\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/\n Recursively merge `overlay` onto `base`. Arrays and primitives are replaced\n * wholesale (a `TranslationBundle` array leaf — see that type's own comment\n * on why arrays are a real leaf shape — is not index-merged: the whole array\n * is the unit an overlay replaces). Plain objects merge key by key.\n /\nfunction mergeBundle(base: TranslationBundle, overlay: TranslationBundle): TranslationBundle {\n const out: Record<string, unknown> = { ...base };\n for (const [key, overlayValue] of Object.entries(overlay)) {\n const baseValue = out[key];\n out[key] =\n isPlainObject(baseValue) && isPlainObject(overlayValue)\n ? mergeBundle(baseValue as TranslationBundle, overlayValue as TranslationBundle)\n : overlayValue;\n }\n return out as TranslationBundle;\n}\n\nexport interface LocaleRegistryOptions {\n /\n The primary locale: the one whose text is the default in code. Required,\n * and declared here rather than inferred, because nothing in the\n * contributions says which locale it is — registration order and the\n * sorted `locales()` both carry no meaning.\n /\n primary: string;\n}\n\nexport function createLocaleRegistry(options: LocaleRegistryOptions): LocaleRegistry {\n const primary = (options as Partial<LocaleRegistryOptions> \| undefined)?.primary;\n if (typeof primary !== 'string' \|\| primary === '') {\n throw new TypeError(\n `createLocaleRegistry needs { primary }, the locale whose text is the default in code; received ${JSON.stringify(primary)}.`,\n );\n }\n const registered: LocaleContribution[] = [];\n\n return {\n primary() {\n return primary;\n },\n register(contribution) {\n registered.push(contribution);\n },\n locales() {\n return Array.from(new Set(registered.map((c) => c.locale))).sort();\n },\n namespaces() {\n return Array.from(new Set(registered.map((c) => c.namespace ?? DEFAULT_NAMESPACE))).sort();\n },\n contributions() {\n return registered;\n },\n buildResources() {\n if (!registered.some((c) => c.locale === primary)) {\n const known = Array.from(new Set(registered.map((c) => c.locale))).sort();\n throw new Error(\n `The locale registry's primary locale ${JSON.stringify(primary)} has no contribution` +\n ` (registered: ${known.length === 0 ? 'none' : known.join(', ')}). Register its bundle,` +\n ' an empty one if the app has no strings of its own, or declare the primary it does register.',\n );\n }\n // Group by (locale, namespace) via NESTED maps rather than a\n // delimiter-joined composite string key. A locale or namespace code is\n // caller-supplied and unconstrained (see `LocaleContribution.locale`'s\n // own comment), so any single-character delimiter is a value that\n // could* collide with real content; nested `Map`s need no delimiter\n // at all, so there is nothing to collide with and nothing unusual\n // embedded in this file's source for a diff tool to trip over.\n const byLocale = new Map<string, Map<string, LocaleContribution[]>>();\n for (const contribution of registered) {\n const namespace = contribution.namespace ?? DEFAULT_NAMESPACE;\n let byNamespace = byLocale.get(contribution.locale);\n if (!byNamespace) {\n byNamespace = new Map<string, LocaleContribution[]>();\n byLocale.set(contribution.locale, byNamespace);\n }\n const group = byNamespace.get(namespace);\n if (group) {\n group.push(contribution);\n } else {\n byNamespace.set(namespace, [contribution]);\n }\n }\n\n const resources: Record<string, Record<string, TranslationBundle>> = {};\n for (const [locale, byNamespace] of byLocale) {\n const namespaces: Record<string, TranslationBundle> = {};\n for (const [namespace, group] of byNamespace) {\n // Stable sort ascending by priority: lower priority applied first,\n // higher priority applied last so it wins the overlapping leaves.\n // `Array#sort` is stable per spec (ES2019+), so contributions with\n // equal priority keep their registration order — last-registered\n // wins ONLY within a tie, never across a declared priority gap.\n const ordered = [...group].sort((a, b) => a.priority - b.priority);\n let merged: TranslationBundle = {};\n for (const contribution of ordered) {\n merged = mergeBundle(merged, contribution.bundle);\n }\n namespaces[namespace] = merged;\n }\n resources[locale] = namespaces;\n }\n return resources;\n },\n };\n}\n\n/*\n A bundler-produced glob module, as `import.meta.glob` (Vite) or an\n * equivalent walk over `require.context` (webpack) would yield it: a flat\n * map of path → either the loaded module itself or `{ default }`.\n \n Bundler-agnostic on purpose, same reasoning as `@burojs/core`'s\n * `docsFromGlob`: no bundler-agnostic glob primitive exists, and a published\n * package must not require one — the ADOPTER calls `import.meta.glob` (or\n * whatever their bundler offers) and hands the plain object here.\n /\nexport type LocaleGlobModule = TranslationBundle \| { default: TranslationBundle };\n\nexport interface LocaleContributionsFromGlobOptions {\n /* {@link LocaleContribution.source} for every contribution produced. /\n source: string;\n /* {@link LocaleContribution.priority} for every contribution produced. /\n priority: number;\n /* {@link LocaleContribution.namespace}. Defaults to `'common'`. /\n namespace?: string;\n /\n Extracts the locale code from a glob path. Default matches a bare\n * `<locale>.ts`/`<locale>.tsx`/`<locale>.js` filename (`'./locales/en.ts'`\n * → `'en'`, `'./locales/fr-CA.ts'` → `'fr-CA'`) — no restriction to a\n * known set of codes; whatever the filename says IS the locale code. Paths\n * that don't match are skipped rather than guessed at (same discipline as\n * `docsFromGlob`).\n /\n localeOf?: (path: string) => string \| undefined;\n}\n\nconst DEFAULT_LOCALE_PATTERN = /(?:^\|\\/)([A-Za-z0-9-]+)\\.(?:ts\|tsx\|js\|jsx\|mjs\|cjs)$/;\n\nfunction defaultLocaleOf(path: string): string \| undefined {\n return DEFAULT_LOCALE_PATTERN.exec(path)?.[1];\n}\n\n/\n Normalize a bundler glob of per-locale files into {@link LocaleContribution}s.\n * One file → one locale → one contribution. Nothing here enumerates or counts\n * locale codes: whatever files are present in the globbed directory at build\n * time ARE the contributions produced — dropping in a new file is the entire\n * mechanism for adding a language.\n /\nexport function localeContributionsFromGlob(\n glob: Record<string, LocaleGlobModule>,\n options: LocaleContributionsFromGlobOptions,\n): LocaleContribution[] {\n const localeOf = options.localeOf ?? defaultLocaleOf;\n const out: LocaleContribution[] = [];\n for (const [path, mod] of Object.entries(glob)) {\n const locale = localeOf(path);\n if (locale === undefined) continue;\n // Eager `import.meta.glob` yields a module namespace object — always\n // `{ default, ...named exports }` for a file that does `export default\n // {...}`. Unwrap it when present; otherwise trust the glob already\n // handed a bare bundle (e.g. a caller that pre-unwrapped, or a\n // require.context-style walk that returns exports directly).\n const bundle = isPlainObject((mod as { default?: unknown }).default)\n ? (mod as { default: TranslationBundle }).default\n : (mod as TranslationBundle);\n out.push({\n locale,\n priority: options.priority,\n source: options.source,\n bundle,\n ...(options.namespace !== undefined ? { namespace: options.namespace } : {}),\n });\n }\n return out;\n}\n","import { type I18nFacade, createI18n } from './i18n.js';\nimport { type I18nextAdapterConfig, createI18nextAdapter } from './i18next-adapter.js';\nimport type { LocaleRegistry } from './locale-registry.js';\n\nexport type CreateI18nFromRegistryConfig = Partial<\n Pick<I18nextAdapterConfig, 'defaultLocale' \| 'fallbackLocale' \| 'keySeparator' \| 'nsSeparator'>\n> & {\n warnOnMissing?: boolean;\n};\n\n/\n Wires a {@link LocaleRegistry} straight into `createI18nextAdapter` +\n * `createI18n`: `registry.locales()` becomes the adapter's `locales`,\n * `registry.buildResources()` becomes its `resources`, and\n * `registry.primary()` is both the starting locale and the fallback unless\n * `defaultLocale` (the starting locale, say a stored choice) or\n * `fallbackLocale` (say a per-locale chain) overrides it. This is the ONLY\n * place those need to be threaded together — an app that builds its own\n * registry never re-lists its locale codes, or restates its primary locale,\n * to hand them to the adapter; it just calls this.\n \n Throws when the registry's primary locale has no contribution (see\n * {@link LocaleRegistry.buildResources}).\n /\nexport async function createI18nFromRegistry(\n registry: LocaleRegistry,\n config: CreateI18nFromRegistryConfig = {},\n): Promise<I18nFacade> {\n const resources = registry.buildResources();\n const primary = registry.primary();\n const adapter = await createI18nextAdapter({\n defaultLocale: config.defaultLocale ?? primary,\n locales: registry.locales(),\n resources,\n fallbackLocale: config.fallbackLocale ?? primary,\n ...(config.keySeparator !== undefined ? { keySeparator: config.keySeparator } : {}),\n ...(config.nsSeparator !== undefined ? { nsSeparator: config.nsSeparator } : {}),\n });\n return createI18n({\n adapter,\n warnOnMissing: config.warnOnMissing,\n locales: () => registry.locales(),\n });\n}\n","// Constants\nexport const PACKAGE_NAME = '@burojs/i18n-core' as const;\nexport const PACKAGE_VERSION = '0.0.0' as const;\n\n// Types\nexport type from './types/index.js';\n\n// Lookup\nexport { resolveKey } from './lookup.js';\n\n// i18next adapter\nexport { createI18nextAdapter, type I18nextAdapterConfig } from './i18next-adapter.js';\n\n// I18n facade\nexport { createI18n, type I18nFacade, type CreateI18nConfig } from './i18n.js';\n\n// Resource context\nexport { createResourceI18n, type ResourceI18n } from './resource-context.js';\n\n// Locale registry — assembling locales from what has REGISTERED (framework\n// packages, the app, domain enum modules) instead of a hand-printed literal.\nexport {\n createLocaleRegistry,\n localeContributionsFromGlob,\n type LocaleContribution,\n type LocaleContributionsFromGlobOptions,\n type LocaleGlobModule,\n type LocaleRegistry,\n type LocaleRegistryOptions,\n} from './locale-registry.js';\nexport {\n createI18nFromRegistry,\n type CreateI18nFromRegistryConfig,\n} from './create-i18n-from-registry.js';\n"],"mappings":"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"}