@burojs/i18n-core 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maksim Kuznetsov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,89 @@
+# @burojs/i18n-core
+
+Hierarchical i18n for [buro](https://github.com/buro/buro), with a per-resource fallback chain over [i18next](https://www.i18next.com).
+
+Translation happens at **render time**, so switching language updates the whole UI live — no reload, no refetch.
+
+## Install
+
+```bash
+pnpm add @burojs/i18n-core
+```
+
+## Usage
+
+```ts
+import { createI18n, createI18nextAdapter } from '@burojs/i18n-core';
+
+const i18n = createI18n({
+  adapter: createI18nextAdapter({
+    defaultLocale: 'ru',
+    locales: ['ru', 'en'],
+    resources: { ru: ruBundle, en: enBundle },
+    fallbackLocale: 'en',
+  }),
+});
+```
+
+## Key resolution
+
+A key is resolved against the most specific namespace first and falls back outward, so a resource can override a shared string without copying the rest:
+
+```
+resources.<resource>.fields.<field>.label   →   fields.<field>.label   →   <the key itself>
+```
+
+`resolveKey` implements that chain and is exported for callers that need to know *which* key won.
+
+## Locale registry
+
+Most apps assemble their `resources` from more than one place: the framework
+ships a base dictionary, the app adds its own chrome strings, a domain module
+adds its enum labels. Printing that as one literal object means adding a
+language is a code change. `createLocaleRegistry` instead lets each source
+**register** a contribution — the registry merges them:
+
+```ts
+import {
+  createLocaleRegistry,
+  localeContributionsFromGlob,
+  createI18nFromRegistry,
+} from '@burojs/i18n-core';
+import { en as frameworkEn } from '@burojs/react';
+
+const registry = createLocaleRegistry();
+registry.register({ locale: 'en', priority: 0, source: '@burojs/react', bundle: frameworkEn });
+
+// One file per locale, globbed by the bundler — dropping in `es.ts` is the
+// entire mechanism for adding Spanish. Nothing here lists locale codes.
+const glob = import.meta.glob('./locales/*.ts', { eager: true });
+for (const c of localeContributionsFromGlob(glob, { source: 'app', priority: 10 })) {
+  registry.register(c);
+}
+
+const i18n = await createI18nFromRegistry(registry, {
+  defaultLocale: 'en',
+  fallbackLocale: 'en', // or a per-locale chain: { fr: ['en'], default: ['en'] }
+});
+```
+
+A key collision within one (locale, namespace) resolves by the higher
+DECLARED `priority`, never by which contribution happened to register last.
+`localeContributionsFromGlob` is bundler-agnostic (same reasoning as
+`@burojs/core`'s `docsFromGlob`): it accepts whatever flat `path → module`
+map `import.meta.glob` or an equivalent walk produces, and the caller — not
+this package — is the one that actually calls the bundler API.
+
+## Main exports
+
+- **`createI18n` / `I18nFacade`** — the facade the React layer consumes.
+- **`createI18nextAdapter`** — the default backend; swap it to use another i18n runtime.
+- **`createResourceI18n` / `ResourceI18n`** — a resource-scoped view of the facade.
+- **`resolveKey`** — the fallback-chain resolver, usable standalone.
+- **`createLocaleRegistry` / `LocaleRegistry`** — merges per-source locale contributions by declared priority.
+- **`localeContributionsFromGlob`** — turns a bundler glob of per-locale files into contributions.
+- **`createI18nFromRegistry`** — wires a `LocaleRegistry` straight into `createI18nextAdapter` + `createI18n`.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,243 @@
+'use strict';
+
+var i18next = require('i18next');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var i18next__default = /*#__PURE__*/_interopDefault(i18next);
+
+// 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;
+}
+async function createI18nextAdapter(config) {
+  const instance = i18next__default.default.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;
+    }
+  };
+}
+
+// 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
+  };
+}
+
+// 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
+  };
+}
+
+// src/locale-registry.ts
+var DEFAULT_NAMESPACE = "common";
+function isPlainObject(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;
+}
+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;
+    }
+  };
+}
+var DEFAULT_LOCALE_PATTERN = /(?:^|\/)([A-Za-z0-9-]+)\.(?:ts|tsx|js|jsx|mjs|cjs)$/;
+function defaultLocaleOf(path) {
+  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;
+}
+
+// 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 });
+}
+
+// src/index.ts
+var PACKAGE_NAME = "@burojs/i18n-core";
+var PACKAGE_VERSION = "0.0.0";
+
+exports.PACKAGE_NAME = PACKAGE_NAME;
+exports.PACKAGE_VERSION = PACKAGE_VERSION;
+exports.createI18n = createI18n;
+exports.createI18nFromRegistry = createI18nFromRegistry;
+exports.createI18nextAdapter = createI18nextAdapter;
+exports.createLocaleRegistry = createLocaleRegistry;
+exports.createResourceI18n = createResourceI18n;
+exports.localeContributionsFromGlob = localeContributionsFromGlob;
+exports.resolveKey = resolveKey;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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":["i18next"],"mappings":"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","file":"index.cjs","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"]}

package/dist/index.d.cts

@@ -0,0 +1,261 @@
+import { FallbackLng } from 'i18next';
+
+interface I18nAdapter {
+    t: (key: string, params?: Record<string, unknown>) => string;
+    changeLocale: (locale: string) => Promise<void>;
+    loadNamespace: (namespace: string, locale: string) => Promise<void>;
+    getCurrentLocale: () => string;
+    hasKey: (key: string) => boolean;
+    /**
+     * Subscribe to active-locale changes (fired by {@link I18nAdapter.changeLocale}).
+     * Returns an unsubscribe fn. Optional — adapters that cannot notify omit it,
+     * and the React layer then degrades to a non-reactive locale read. This is
+     * what powers the live language switch (no page reload): `useLocale()` wires
+     * it into `useSyncExternalStore`.
+     */
+    onLocaleChange?: (cb: () => void) => () => void;
+}
+
+/**
+ * Recursive translation bundle: keys map to a string, a nested bundle, or an
+ * ARRAY of either.
+ *
+ * The array arm is not a convenience. i18next addresses array members by index
+ * — `doc.links.0.label` is exactly how `resolveDoc` reads a documentation
+ * entry's external references — so an ordered list is a shape the store really
+ * holds. The type said otherwise, and the mismatch was hidden rather than
+ * caught: resource bundles are cast to `ResourceTranslationBundle` at the
+ * boundary, so nothing complained until a bundle carrying `links` was passed
+ * WITHOUT a cast, at which point the error surfaced in the app rather than in
+ * the package that owns the type.
+ */
+type TranslationBundle = {
+    [key: string]: string | TranslationBundle | readonly (string | TranslationBundle)[];
+};
+/**
+ * Per-resource bundle: optional async loader returning default-export bundle.
+ */
+type ResourceBundle = (() => Promise<{
+    default: TranslationBundle;
+}>) | Record<string, () => Promise<{
+    default: TranslationBundle;
+}>>;
+
+/**
+ * Open interface for opt-in codegen-typed i18n keys.
+ *
+ *   declare module '@burojs/i18n-core' {
+ *     interface I18nKeys {
+ *       'actions.create': void;
+ *     }
+ *   }
+ */
+interface I18nKeys {
+}
+/**
+ * Open interface for keys requiring interpolation parameters.
+ */
+interface I18nKeysWithParams {
+}
+
+/**
+ * Build candidate keys for fallback lookup.
+ *
+ * Lookup order (first match wins):
+ *   1. resources.<name>.<key>     — resource-specific
+ *   2. resources._.<key>          — base for all resources
+ *   3. common.<key>               — global common
+ *   4. <key>                      — raw fallback (debug only)
+ *
+ * If `key` is already namespaced (starts with `resources.`, `enums.` or
+ * `common.`), return it as-is without further scoping.
+ */
+declare function resolveKey(key: string, resource?: string): string[];
+
+interface I18nextAdapterConfig {
+    defaultLocale: string;
+    locales: string[];
+    resources?: Record<string, Record<string, TranslationBundle>>;
+    /**
+     * A single fallback locale (`'en'`) applies uniformly to every locale. A
+     * `fr → en` fallback for one locale but not another needs i18next's own
+     * per-locale chain shape instead — `{ fr: ['en'], default: ['en'] }` — so
+     * this accepts i18next's full `FallbackLng` type rather than just `string`.
+     * The chain is entirely CONFIG: nothing in this adapter special-cases any
+     * particular locale code, here or anywhere else.
+     */
+    fallbackLocale?: FallbackLng;
+    keySeparator?: string | false;
+    nsSeparator?: string | false;
+}
+/**
+ * Default I18nAdapter implementation backed by i18next.
+ * Each top-level key in resources becomes a separate i18next namespace
+ * (e.g. 'common', 'resources').
+ */
+declare function createI18nextAdapter(config: I18nextAdapterConfig): Promise<I18nAdapter>;
+
+interface I18nFacade {
+    t: (key: string, options?: {
+        resource?: string;
+        params?: Record<string, unknown>;
+    }) => string;
+    /**
+     * True when a translation for `key` EXISTS (through the same candidate chain
+     * as {@link I18nFacade.t}). Distinct from `t`, which returns the raw key on a
+     * miss — the content model probes presence with `has` to tell "no bundle
+     * entry" (render nothing) from "bundle entry === key text".
+     */
+    has: (key: string, options?: {
+        resource?: string;
+    }) => boolean;
+    changeLocale: (locale: string) => Promise<void>;
+    getCurrentLocale: () => string;
+    /**
+     * Subscribe to active-locale changes. Returns an unsubscribe fn. When the
+     * adapter can't notify, this is a no-op subscription (returns an unsubscribe
+     * that does nothing) — the live language switch then falls back to a static
+     * read. Consumed by `useLocale()` via `useSyncExternalStore`.
+     */
+    onLocaleChange: (cb: () => void) => () => void;
+    loadNamespace: (namespace: string, locale: string) => Promise<void>;
+    adapter: I18nAdapter;
+}
+interface CreateI18nConfig {
+    adapter: I18nAdapter;
+    warnOnMissing?: boolean;
+}
+declare function createI18n(config: CreateI18nConfig): I18nFacade;
+
+interface ResourceI18n {
+    t: (key: string, options?: {
+        resource?: string;
+        params?: Record<string, unknown>;
+    }) => string;
+    changeLocale: (locale: string) => Promise<void>;
+    getCurrentLocale: () => string;
+    resource: string;
+}
+/**
+ * Wraps an I18nFacade with a default resource scope.
+ * `t('actions.delete')` will lookup `resources.<resource>.actions.delete` first.
+ * Pass an explicit `resource` option to override the default scope.
+ */
+declare function createResourceI18n(i18n: I18nFacade, resource: string): ResourceI18n;
+
+/**
+ * One package/app/domain module's offering for one locale.
+ *
+ * A contribution is data, not code: nothing about `createI18nextAdapter`'s
+ * `resources` shape is visible here, and nothing here names a fixed set of
+ * locale codes or counts them. `locale` is whatever the file/module that
+ * produced this contribution says it is — the registry never validates it
+ * against a known list, because there is no known list. That is the whole
+ * point: a twenty-first language is a twenty-first contribution, not a
+ * twenty-first `case`.
+ */
+interface LocaleContribution {
+    /** Locale code this contribution provides strings for (e.g. 'en', 'es', 'fr'). */
+    locale: string;
+    /**
+     * i18next namespace the bundle merges into. Defaults to `'common'` — the
+     * same default namespace `createI18nextAdapter` uses.
+     */
+    namespace?: string;
+    /**
+     * Declared merge priority. On a key collision within the same
+     * (locale, namespace), the contribution with the HIGHER priority wins —
+     * not whichever happened to register last. Ties fall back to registration
+     * order (last registered wins), which is why two genuinely competing
+     * sources must declare distinct priorities rather than relying on the tie
+     * break.
+     */
+    priority: number;
+    /**
+     * Where this contribution came from — a package name, `'app'`, an enum
+     * module name. Diagnostic only (surfaced by {@link LocaleRegistry.contributions}
+     * for debugging a collision); never branched on.
+     */
+    source: string;
+    bundle: TranslationBundle;
+}
+interface LocaleRegistry {
+    /** Add one contribution. Order of registration does not matter for the merge result — only `priority` does (see {@link LocaleContribution.priority}). */
+    register(contribution: LocaleContribution): void;
+    /**
+     * Every locale code that has at least one contribution, sorted. Derived
+     * purely from what was registered — nothing enumerates or counts locales
+     * anywhere else in this module.
+     */
+    locales(): string[];
+    /** Every namespace that has at least one contribution, sorted. */
+    namespaces(): string[];
+    /** All registered contributions, in registration order. For diagnostics/tests. */
+    contributions(): readonly LocaleContribution[];
+    /**
+     * Assemble `{ [locale]: { [namespace]: TranslationBundle } }`, ready to
+     * pass straight as `createI18nextAdapter`'s `resources` config. Within one
+     * (locale, namespace) group, contributions are deep-merged in ascending
+     * priority order, so a higher-priority contribution's leaves win over a
+     * lower-priority one's on any overlapping key while leaving the rest of
+     * the lower-priority bundle intact.
+     */
+    buildResources(): Record<string, Record<string, TranslationBundle>>;
+}
+declare function createLocaleRegistry(): LocaleRegistry;
+/**
+ * A bundler-produced glob module, as `import.meta.glob` (Vite) or an
+ * equivalent walk over `require.context` (webpack) would yield it: a flat
+ * map of path → either the loaded module itself or `{ default }`.
+ *
+ * Bundler-agnostic on purpose, same reasoning as `@burojs/core`'s
+ * `docsFromGlob`: no bundler-agnostic glob primitive exists, and a published
+ * package must not require one — the ADOPTER calls `import.meta.glob` (or
+ * whatever their bundler offers) and hands the plain object here.
+ */
+type LocaleGlobModule = TranslationBundle | {
+    default: TranslationBundle;
+};
+interface LocaleContributionsFromGlobOptions {
+    /** {@link LocaleContribution.source} for every contribution produced. */
+    source: string;
+    /** {@link LocaleContribution.priority} for every contribution produced. */
+    priority: number;
+    /** {@link LocaleContribution.namespace}. Defaults to `'common'`. */
+    namespace?: string;
+    /**
+     * Extracts the locale code from a glob path. Default matches a bare
+     * `<locale>.ts`/`<locale>.tsx`/`<locale>.js` filename (`'./locales/en.ts'`
+     * → `'en'`, `'./locales/fr-CA.ts'` → `'fr-CA'`) — no restriction to a
+     * known set of codes; whatever the filename says IS the locale code. Paths
+     * that don't match are skipped rather than guessed at (same discipline as
+     * `docsFromGlob`).
+     */
+    localeOf?: (path: string) => string | undefined;
+}
+/**
+ * Normalize a bundler glob of per-locale files into {@link LocaleContribution}s.
+ * One file → one locale → one contribution. Nothing here enumerates or counts
+ * locale codes: whatever files are present in the globbed directory at build
+ * time ARE the contributions produced — dropping in a new file is the entire
+ * mechanism for adding a language.
+ */
+declare function localeContributionsFromGlob(glob: Record<string, LocaleGlobModule>, options: LocaleContributionsFromGlobOptions): LocaleContribution[];
+
+type CreateI18nFromRegistryConfig = Pick<I18nextAdapterConfig, 'defaultLocale' | 'fallbackLocale' | 'keySeparator' | 'nsSeparator'> & {
+    warnOnMissing?: boolean;
+};
+/**
+ * Wires a {@link LocaleRegistry} straight into `createI18nextAdapter` +
+ * `createI18n`: `registry.locales()` becomes the adapter's `locales`,
+ * `registry.buildResources()` becomes its `resources`. This is the ONLY
+ * place those two need to be threaded together — an app that builds its own
+ * registry never re-lists its locale codes to hand them to the adapter, it
+ * just calls this.
+ */
+declare function createI18nFromRegistry(registry: LocaleRegistry, config: CreateI18nFromRegistryConfig): Promise<I18nFacade>;
+
+declare const PACKAGE_NAME: "@burojs/i18n-core";
+declare const PACKAGE_VERSION: "0.0.0";
+
+export { type CreateI18nConfig, type CreateI18nFromRegistryConfig, type I18nAdapter, type I18nFacade, type I18nKeys, type I18nKeysWithParams, type I18nextAdapterConfig, type LocaleContribution, type LocaleContributionsFromGlobOptions, type LocaleGlobModule, type LocaleRegistry, PACKAGE_NAME, PACKAGE_VERSION, type ResourceBundle, type ResourceI18n, type TranslationBundle, createI18n, createI18nFromRegistry, createI18nextAdapter, createLocaleRegistry, createResourceI18n, localeContributionsFromGlob, resolveKey };

package/dist/index.d.ts

@@ -0,0 +1,261 @@
+import { FallbackLng } from 'i18next';
+
+interface I18nAdapter {
+    t: (key: string, params?: Record<string, unknown>) => string;
+    changeLocale: (locale: string) => Promise<void>;
+    loadNamespace: (namespace: string, locale: string) => Promise<void>;
+    getCurrentLocale: () => string;
+    hasKey: (key: string) => boolean;
+    /**
+     * Subscribe to active-locale changes (fired by {@link I18nAdapter.changeLocale}).
+     * Returns an unsubscribe fn. Optional — adapters that cannot notify omit it,
+     * and the React layer then degrades to a non-reactive locale read. This is
+     * what powers the live language switch (no page reload): `useLocale()` wires
+     * it into `useSyncExternalStore`.
+     */
+    onLocaleChange?: (cb: () => void) => () => void;
+}
+
+/**
+ * Recursive translation bundle: keys map to a string, a nested bundle, or an
+ * ARRAY of either.
+ *
+ * The array arm is not a convenience. i18next addresses array members by index
+ * — `doc.links.0.label` is exactly how `resolveDoc` reads a documentation
+ * entry's external references — so an ordered list is a shape the store really
+ * holds. The type said otherwise, and the mismatch was hidden rather than
+ * caught: resource bundles are cast to `ResourceTranslationBundle` at the
+ * boundary, so nothing complained until a bundle carrying `links` was passed
+ * WITHOUT a cast, at which point the error surfaced in the app rather than in
+ * the package that owns the type.
+ */
+type TranslationBundle = {
+    [key: string]: string | TranslationBundle | readonly (string | TranslationBundle)[];
+};
+/**
+ * Per-resource bundle: optional async loader returning default-export bundle.
+ */
+type ResourceBundle = (() => Promise<{
+    default: TranslationBundle;
+}>) | Record<string, () => Promise<{
+    default: TranslationBundle;
+}>>;
+
+/**
+ * Open interface for opt-in codegen-typed i18n keys.
+ *
+ *   declare module '@burojs/i18n-core' {
+ *     interface I18nKeys {
+ *       'actions.create': void;
+ *     }
+ *   }
+ */
+interface I18nKeys {
+}
+/**
+ * Open interface for keys requiring interpolation parameters.
+ */
+interface I18nKeysWithParams {
+}
+
+/**
+ * Build candidate keys for fallback lookup.
+ *
+ * Lookup order (first match wins):
+ *   1. resources.<name>.<key>     — resource-specific
+ *   2. resources._.<key>          — base for all resources
+ *   3. common.<key>               — global common
+ *   4. <key>                      — raw fallback (debug only)
+ *
+ * If `key` is already namespaced (starts with `resources.`, `enums.` or
+ * `common.`), return it as-is without further scoping.
+ */
+declare function resolveKey(key: string, resource?: string): string[];
+
+interface I18nextAdapterConfig {
+    defaultLocale: string;
+    locales: string[];
+    resources?: Record<string, Record<string, TranslationBundle>>;
+    /**
+     * A single fallback locale (`'en'`) applies uniformly to every locale. A
+     * `fr → en` fallback for one locale but not another needs i18next's own
+     * per-locale chain shape instead — `{ fr: ['en'], default: ['en'] }` — so
+     * this accepts i18next's full `FallbackLng` type rather than just `string`.
+     * The chain is entirely CONFIG: nothing in this adapter special-cases any
+     * particular locale code, here or anywhere else.
+     */
+    fallbackLocale?: FallbackLng;
+    keySeparator?: string | false;
+    nsSeparator?: string | false;
+}
+/**
+ * Default I18nAdapter implementation backed by i18next.
+ * Each top-level key in resources becomes a separate i18next namespace
+ * (e.g. 'common', 'resources').
+ */
+declare function createI18nextAdapter(config: I18nextAdapterConfig): Promise<I18nAdapter>;
+
+interface I18nFacade {
+    t: (key: string, options?: {
+        resource?: string;
+        params?: Record<string, unknown>;
+    }) => string;
+    /**
+     * True when a translation for `key` EXISTS (through the same candidate chain
+     * as {@link I18nFacade.t}). Distinct from `t`, which returns the raw key on a
+     * miss — the content model probes presence with `has` to tell "no bundle
+     * entry" (render nothing) from "bundle entry === key text".
+     */
+    has: (key: string, options?: {
+        resource?: string;
+    }) => boolean;
+    changeLocale: (locale: string) => Promise<void>;
+    getCurrentLocale: () => string;
+    /**
+     * Subscribe to active-locale changes. Returns an unsubscribe fn. When the
+     * adapter can't notify, this is a no-op subscription (returns an unsubscribe
+     * that does nothing) — the live language switch then falls back to a static
+     * read. Consumed by `useLocale()` via `useSyncExternalStore`.
+     */
+    onLocaleChange: (cb: () => void) => () => void;
+    loadNamespace: (namespace: string, locale: string) => Promise<void>;
+    adapter: I18nAdapter;
+}
+interface CreateI18nConfig {
+    adapter: I18nAdapter;
+    warnOnMissing?: boolean;
+}
+declare function createI18n(config: CreateI18nConfig): I18nFacade;
+
+interface ResourceI18n {
+    t: (key: string, options?: {
+        resource?: string;
+        params?: Record<string, unknown>;
+    }) => string;
+    changeLocale: (locale: string) => Promise<void>;
+    getCurrentLocale: () => string;
+    resource: string;
+}
+/**
+ * Wraps an I18nFacade with a default resource scope.
+ * `t('actions.delete')` will lookup `resources.<resource>.actions.delete` first.
+ * Pass an explicit `resource` option to override the default scope.
+ */
+declare function createResourceI18n(i18n: I18nFacade, resource: string): ResourceI18n;
+
+/**
+ * One package/app/domain module's offering for one locale.
+ *
+ * A contribution is data, not code: nothing about `createI18nextAdapter`'s
+ * `resources` shape is visible here, and nothing here names a fixed set of
+ * locale codes or counts them. `locale` is whatever the file/module that
+ * produced this contribution says it is — the registry never validates it
+ * against a known list, because there is no known list. That is the whole
+ * point: a twenty-first language is a twenty-first contribution, not a
+ * twenty-first `case`.
+ */
+interface LocaleContribution {
+    /** Locale code this contribution provides strings for (e.g. 'en', 'es', 'fr'). */
+    locale: string;
+    /**
+     * i18next namespace the bundle merges into. Defaults to `'common'` — the
+     * same default namespace `createI18nextAdapter` uses.
+     */
+    namespace?: string;
+    /**
+     * Declared merge priority. On a key collision within the same
+     * (locale, namespace), the contribution with the HIGHER priority wins —
+     * not whichever happened to register last. Ties fall back to registration
+     * order (last registered wins), which is why two genuinely competing
+     * sources must declare distinct priorities rather than relying on the tie
+     * break.
+     */
+    priority: number;
+    /**
+     * Where this contribution came from — a package name, `'app'`, an enum
+     * module name. Diagnostic only (surfaced by {@link LocaleRegistry.contributions}
+     * for debugging a collision); never branched on.
+     */
+    source: string;
+    bundle: TranslationBundle;
+}
+interface LocaleRegistry {
+    /** Add one contribution. Order of registration does not matter for the merge result — only `priority` does (see {@link LocaleContribution.priority}). */
+    register(contribution: LocaleContribution): void;
+    /**
+     * Every locale code that has at least one contribution, sorted. Derived
+     * purely from what was registered — nothing enumerates or counts locales
+     * anywhere else in this module.
+     */
+    locales(): string[];
+    /** Every namespace that has at least one contribution, sorted. */
+    namespaces(): string[];
+    /** All registered contributions, in registration order. For diagnostics/tests. */
+    contributions(): readonly LocaleContribution[];
+    /**
+     * Assemble `{ [locale]: { [namespace]: TranslationBundle } }`, ready to
+     * pass straight as `createI18nextAdapter`'s `resources` config. Within one
+     * (locale, namespace) group, contributions are deep-merged in ascending
+     * priority order, so a higher-priority contribution's leaves win over a
+     * lower-priority one's on any overlapping key while leaving the rest of
+     * the lower-priority bundle intact.
+     */
+    buildResources(): Record<string, Record<string, TranslationBundle>>;
+}
+declare function createLocaleRegistry(): LocaleRegistry;
+/**
+ * A bundler-produced glob module, as `import.meta.glob` (Vite) or an
+ * equivalent walk over `require.context` (webpack) would yield it: a flat
+ * map of path → either the loaded module itself or `{ default }`.
+ *
+ * Bundler-agnostic on purpose, same reasoning as `@burojs/core`'s
+ * `docsFromGlob`: no bundler-agnostic glob primitive exists, and a published
+ * package must not require one — the ADOPTER calls `import.meta.glob` (or
+ * whatever their bundler offers) and hands the plain object here.
+ */
+type LocaleGlobModule = TranslationBundle | {
+    default: TranslationBundle;
+};
+interface LocaleContributionsFromGlobOptions {
+    /** {@link LocaleContribution.source} for every contribution produced. */
+    source: string;
+    /** {@link LocaleContribution.priority} for every contribution produced. */
+    priority: number;
+    /** {@link LocaleContribution.namespace}. Defaults to `'common'`. */
+    namespace?: string;
+    /**
+     * Extracts the locale code from a glob path. Default matches a bare
+     * `<locale>.ts`/`<locale>.tsx`/`<locale>.js` filename (`'./locales/en.ts'`
+     * → `'en'`, `'./locales/fr-CA.ts'` → `'fr-CA'`) — no restriction to a
+     * known set of codes; whatever the filename says IS the locale code. Paths
+     * that don't match are skipped rather than guessed at (same discipline as
+     * `docsFromGlob`).
+     */
+    localeOf?: (path: string) => string | undefined;
+}
+/**
+ * Normalize a bundler glob of per-locale files into {@link LocaleContribution}s.
+ * One file → one locale → one contribution. Nothing here enumerates or counts
+ * locale codes: whatever files are present in the globbed directory at build
+ * time ARE the contributions produced — dropping in a new file is the entire
+ * mechanism for adding a language.
+ */
+declare function localeContributionsFromGlob(glob: Record<string, LocaleGlobModule>, options: LocaleContributionsFromGlobOptions): LocaleContribution[];
+
+type CreateI18nFromRegistryConfig = Pick<I18nextAdapterConfig, 'defaultLocale' | 'fallbackLocale' | 'keySeparator' | 'nsSeparator'> & {
+    warnOnMissing?: boolean;
+};
+/**
+ * Wires a {@link LocaleRegistry} straight into `createI18nextAdapter` +
+ * `createI18n`: `registry.locales()` becomes the adapter's `locales`,
+ * `registry.buildResources()` becomes its `resources`. This is the ONLY
+ * place those two need to be threaded together — an app that builds its own
+ * registry never re-lists its locale codes to hand them to the adapter, it
+ * just calls this.
+ */
+declare function createI18nFromRegistry(registry: LocaleRegistry, config: CreateI18nFromRegistryConfig): Promise<I18nFacade>;
+
+declare const PACKAGE_NAME: "@burojs/i18n-core";
+declare const PACKAGE_VERSION: "0.0.0";
+
+export { type CreateI18nConfig, type CreateI18nFromRegistryConfig, type I18nAdapter, type I18nFacade, type I18nKeys, type I18nKeysWithParams, type I18nextAdapterConfig, type LocaleContribution, type LocaleContributionsFromGlobOptions, type LocaleGlobModule, type LocaleRegistry, PACKAGE_NAME, PACKAGE_VERSION, type ResourceBundle, type ResourceI18n, type TranslationBundle, createI18n, createI18nFromRegistry, createI18nextAdapter, createLocaleRegistry, createResourceI18n, localeContributionsFromGlob, resolveKey };

package/dist/index.js

@@ -0,0 +1,229 @@
+import i18next from 'i18next';
+
+// 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;
+}
+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;
+    }
+  };
+}
+
+// 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
+  };
+}
+
+// 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
+  };
+}
+
+// src/locale-registry.ts
+var DEFAULT_NAMESPACE = "common";
+function isPlainObject(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;
+}
+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;
+    }
+  };
+}
+var DEFAULT_LOCALE_PATTERN = /(?:^|\/)([A-Za-z0-9-]+)\.(?:ts|tsx|js|jsx|mjs|cjs)$/;
+function defaultLocaleOf(path) {
+  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;
+}
+
+// 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 });
+}
+
+// src/index.ts
+var PACKAGE_NAME = "@burojs/i18n-core";
+var PACKAGE_VERSION = "0.0.0";
+
+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

@@ -0,0 +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"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@burojs/i18n-core",
+  "version": "0.2.0",
+  "license": "MIT",
+  "description": "Buro: hierarchical i18n with fallback chain over i18next",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@burojs/core": "0.2.0"
+  },
+  "peerDependencies": {
+    "i18next": ">=23 <27"
+  },
+  "devDependencies": {
+    "expect-type": "^1.1.0",
+    "i18next": "^24.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.0",
+    "@burojs/tooling-eslint": "0.0.0",
+    "@burojs/tooling-tsconfig": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "typecheck:tests": "tsc -p tsconfig.test.json"
+  }
+}