@burojs/i18n-core 0.2.0 → 0.5.0

package/dist/index.cjs.map

@@ -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":["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"]}
+{"version":3,"file":"index.cjs","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":";;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,SAAgB,WAAW,KAAa,UAA6B;CACnE,IAAI,CAAC,KAAK,OAAO,CAAC;CAKlB,IACE,IAAI,WAAW,YAAY,KAC3B,IAAI,WAAW,QAAQ,KACvB,IAAI,WAAW,SAAS,KACxB,IAAI,WAAW,SAAS,GAExB,OAAO,CAAC,GAAG;CAGb,MAAM,aAAuB,CAAC;CAC9B,IAAI,UACF,WAAW,KAAK,aAAa,SAAS,GAAG,KAAK;CAEhD,WAAW,KAAK,eAAe,KAAK;CACpC,WAAW,KAAK,UAAU,KAAK;CAC/B,WAAW,KAAK,GAAG;CACnB,OAAO;AACT;;;AC/BA,MAAM,UAAU;AAwBhB,eAAsB,qBAAqB,QAAoD;CAC7F,MAAM,WAAiB,QAAA,QAAQ,eAAe;CAE9C,MAAM,SAAS,KAAK;EAClB,KAAK,OAAO;EACZ,aAAa,OAAO,kBAAkB,OAAO;EAC7C,eAAe,OAAO;EACtB,WAAW,OAAO;EAClB,cAAc,OAAO,gBAAgB;EAKrC,aAAa,OAAO,eAAe;EACnC,WAAW;EACX,eAAe,EAAE,aAAa,MAAM;EACpC,YAAY;EAIZ,mBAAmB;CACrB,CAAC;CAED,OAAO;EACL,EAAE,KAAK,QAAQ;GACb,MAAM,SAAS,IAAI,QAAQ,GAAG;GAC9B,IAAI,WAAW,IACb,OAAO,SAAS,EAAE,KAAK,MAAM;GAE/B,MAAM,KAAK,IAAI,UAAU,GAAG,MAAM;GAClC,MAAM,SAAS,IAAI,UAAU,SAAS,CAAC;GACvC,MAAM,SAAS,SAAS,EAAE,QAAQ;IAAE;IAAI,GAAI,UAAU,CAAC;GAAG,CAAC;GAI3D,MAAM,QAAQ,OAAO,QAAQ,UAAU,WAAW,OAAO,QAAQ,KAAA;GACjE,IACE,WAAW,UACX,CAAC,SAAS,OAAO,QAAQ,UAAU,KAAA,IAAY,EAAE,GAAG,IAAI;IAAE;IAAI;GAAM,CAAC,GAErE,OAAO;GAET,OAAO;EACT;EACA,MAAM,aAAa,QAAQ;GACzB,MAAM,SAAS,eAAe,MAAM;EACtC;EACA,MAAM,cAAc,WAAW,SAAS;GACtC,MAAM,SAAS,eAAe,SAAS;EACzC;EACA,mBAAmB;GACjB,OAAO,SAAS;EAClB;EACA,eAAe,IAAI;GACjB,SAAS,GAAG,mBAAmB,EAAE;GACjC,aAAa,SAAS,IAAI,mBAAmB,EAAE;EACjD;EACA,OAAO,KAAK,SAAS;GACnB,MAAM,SAAS,IAAI,QAAQ,GAAG;GAC9B,MAAM,KAAK,WAAW,KAAK,KAAA,IAAY,IAAI,UAAU,GAAG,MAAM;GAC9D,MAAM,SAAS,WAAW,KAAK,MAAM,IAAI,UAAU,SAAS,CAAC;GAC7D,MAAM,SAAS;IACb,GAAI,OAAO,KAAA,IAAY,CAAC,IAAI,EAAE,GAAG;IACjC,GAAI,SAAS,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,QAAQ,MAAM;GACjE;GA4BA,MAAM,QAAQ,SAAS,EAAE,QAAQ;IAC/B,GAAG;IACH,eAAe;IACf,cAAc;GAChB,CAAC;GACD,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,UAAU;EACtE;CACF;AACF;;;AChFA,SAAgB,WAAW,QAAsC;CAC/D,MAAM,EAAE,SAAS,gBAAgB,MAAM,YAAY;CAEnD,OAAO;EACL,EAAE,KAAK,SAAS;GAEd,MAAM,QAAQ,SAAS;GACvB,MAAM,SAAS,UAAU,KAAA,IAAY,SAAS,SAAS;IAAE,GAAG,SAAS;IAAQ;GAAM;GACnF,MAAM,aAAa,WAAW,KAAK,SAAS,QAAQ;GACpD,KAAK,MAAM,aAAa,YAGtB,IADE,UAAU,KAAA,IAAY,QAAQ,OAAO,SAAS,IAAI,QAAQ,OAAO,WAAW,EAAE,MAAM,CAAC,GAErF,OAAO,QAAQ,EAAE,WAAW,MAAM;GAGtC,IAAI,iBAAiB,OAAO,YAAY,aACtC,QAAQ,KACN,6CAA6C,IAAI,GAAG,SAAS,WAAW,eAAe,QAAQ,SAAS,KAAK,IAC/G;GAEF,OAAO;EACT;EACA,IAAI,KAAK,SAAS;GAChB,MAAM,QAAQ,SAAS;GACvB,OAAO,WAAW,KAAK,SAAS,QAAQ,CAAC,CAAC,MAAM,cAC9C,UAAU,KAAA,IAAY,QAAQ,OAAO,SAAS,IAAI,QAAQ,OAAO,WAAW,EAAE,MAAM,CAAC,CACvF;EACF;EACA,MAAM,aAAa,QAAQ;GACzB,MAAM,QAAQ,aAAa,MAAM;EACnC;EACA,mBAAmB;GACjB,OAAO,QAAQ,iBAAiB;EAClC;EACA,eAAe,IAAI;GACjB,OAAO,QAAQ,iBAAiB,EAAE,YAAY,CAAC;EACjD;EACA,MAAM,cAAc,WAAW,QAAQ;GACrC,MAAM,QAAQ,cAAc,WAAW,MAAM;EAC/C;EACA,GAAI,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ;EAC3C;CACF;AACF;;;AC3EA,SAAgB,mBAAmB,MAAkB,UAAgC;CACnF,OAAO;EACL,EAAE,KAAK,SAAS;GACd,OAAO,KAAK,EAAE,KAAK;IACjB,UAAU,SAAS,YAAY;IAC/B,QAAQ,SAAS;IACjB,GAAI,SAAS,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,QAAQ,MAAM;GACjE,CAAC;EACH;EACA,cAAc,KAAK;EACnB,kBAAkB,KAAK;EACvB;CACF;AACF;;;ACiDA,MAAM,oBAAoB;AAE1B,SAAS,cAAc,OAAkD;CACvE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAQA,SAAS,YAAY,MAAyB,SAA+C;CAC3F,MAAM,MAA+B,EAAE,GAAG,KAAK;CAC/C,KAAK,MAAM,CAAC,KAAK,iBAAiB,OAAO,QAAQ,OAAO,GAAG;EACzD,MAAM,YAAY,IAAI;EACtB,IAAI,OACF,cAAc,SAAS,KAAK,cAAc,YAAY,IAClD,YAAY,WAAgC,YAAiC,IAC7E;CACR;CACA,OAAO;AACT;AAYA,SAAgB,qBAAqB,SAAgD;CACnF,MAAM,UAAW,SAAwD;CACzE,IAAI,OAAO,YAAY,YAAY,YAAY,IAC7C,MAAM,IAAI,UACR,kGAAkG,KAAK,UAAU,OAAO,EAAE,EAC5H;CAEF,MAAM,aAAmC,CAAC;CAE1C,OAAO;EACL,UAAU;GACR,OAAO;EACT;EACA,SAAS,cAAc;GACrB,WAAW,KAAK,YAAY;EAC9B;EACA,UAAU;GACR,OAAO,MAAM,KAAK,IAAI,IAAI,WAAW,KAAK,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK;EACnE;EACA,aAAa;GACX,OAAO,MAAM,KAAK,IAAI,IAAI,WAAW,KAAK,MAAM,EAAE,aAAa,iBAAiB,CAAC,CAAC,CAAC,CAAC,KAAK;EAC3F;EACA,gBAAgB;GACd,OAAO;EACT;EACA,iBAAiB;GACf,IAAI,CAAC,WAAW,MAAM,MAAM,EAAE,WAAW,OAAO,GAAG;IACjD,MAAM,QAAQ,MAAM,KAAK,IAAI,IAAI,WAAW,KAAK,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK;IACxE,MAAM,IAAI,MACR,wCAAwC,KAAK,UAAU,OAAO,EAAE,oCAC7C,MAAM,WAAW,IAAI,SAAS,MAAM,KAAK,IAAI,EAAE,oHAEpE;GACF;GAQA,MAAM,WAAW,IAAI,IAA+C;GACpE,KAAK,MAAM,gBAAgB,YAAY;IACrC,MAAM,YAAY,aAAa,aAAa;IAC5C,IAAI,cAAc,SAAS,IAAI,aAAa,MAAM;IAClD,IAAI,CAAC,aAAa;KAChB,cAAc,IAAI,IAAkC;KACpD,SAAS,IAAI,aAAa,QAAQ,WAAW;IAC/C;IACA,MAAM,QAAQ,YAAY,IAAI,SAAS;IACvC,IAAI,OACF,MAAM,KAAK,YAAY;SAEvB,YAAY,IAAI,WAAW,CAAC,YAAY,CAAC;GAE7C;GAEA,MAAM,YAA+D,CAAC;GACtE,KAAK,MAAM,CAAC,QAAQ,gBAAgB,UAAU;IAC5C,MAAM,aAAgD,CAAC;IACvD,KAAK,MAAM,CAAC,WAAW,UAAU,aAAa;KAM5C,MAAM,UAAU,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;KACjE,IAAI,SAA4B,CAAC;KACjC,KAAK,MAAM,gBAAgB,SACzB,SAAS,YAAY,QAAQ,aAAa,MAAM;KAElD,WAAW,aAAa;IAC1B;IACA,UAAU,UAAU;GACtB;GACA,OAAO;EACT;CACF;AACF;AAgCA,MAAM,yBAAyB;AAE/B,SAAS,gBAAgB,MAAkC;CACzD,OAAO,uBAAuB,KAAK,IAAI,CAAC,GAAG;AAC7C;AASA,SAAgB,4BACd,MACA,SACsB;CACtB,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,MAA4B,CAAC;CACnC,KAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQ,IAAI,GAAG;EAC9C,MAAM,SAAS,SAAS,IAAI;EAC5B,IAAI,WAAW,KAAA,GAAW;EAM1B,MAAM,SAAS,cAAe,IAA8B,OAAO,IAC9D,IAAuC,UACvC;EACL,IAAI,KAAK;GACP;GACA,UAAU,QAAQ;GAClB,QAAQ,QAAQ;GAChB;GACA,GAAI,QAAQ,cAAc,KAAA,IAAY,EAAE,WAAW,QAAQ,UAAU,IAAI,CAAC;EAC5E,CAAC;CACH;CACA,OAAO;AACT;;;AC9OA,eAAsB,uBACpB,UACA,SAAuC,CAAC,GACnB;CACrB,MAAM,YAAY,SAAS,eAAe;CAC1C,MAAM,UAAU,SAAS,QAAQ;CASjC,OAAO,WAAW;EAChB,eAToB,qBAAqB;GACzC,eAAe,OAAO,iBAAiB;GACvC,SAAS,SAAS,QAAQ;GAC1B;GACA,gBAAgB,OAAO,kBAAkB;GACzC,GAAI,OAAO,iBAAiB,KAAA,IAAY,EAAE,cAAc,OAAO,aAAa,IAAI,CAAC;GACjF,GAAI,OAAO,gBAAgB,KAAA,IAAY,EAAE,aAAa,OAAO,YAAY,IAAI,CAAC;EAChF,CAAC;EAGC,eAAe,OAAO;EACtB,eAAe,SAAS,QAAQ;CAClC,CAAC;AACH;;;AC1CA,MAAa,eAAe;AAC5B,MAAa,kBAAkB"}

package/dist/index.d.cts

@@ -1,21 +1,30 @@
-import { FallbackLng } from 'i18next';
-
+import { FallbackLng } from "i18next";
+//#region src/types/adapter.d.ts
 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;
+  t: (key: string, params?: Record<string, unknown>) => string;
+  changeLocale: (locale: string) => Promise<void>;
+  loadNamespace: (namespace: string, locale: string) => Promise<void>;
+  getCurrentLocale: () => string;
+  /**
+   * True when a USABLE STRING exists at `key` (an object node is not one).
+   * Pass `count` to ask about a count family (`<key>_one | _few | _many |
+   * _other`): i18next resolves the suffix only when it is asked with a count,
+   * so without one a present family reports missing.
+   */
+  hasKey: (key: string, options?: {
+    count?: number;
+  }) => 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;
 }
-
+//#endregion
+//#region src/types/bundle.d.ts
 /**
  * Recursive translation bundle: keys map to a string, a nested bundle, or an
  * ARRAY of either.
@@ -30,17 +39,18 @@ interface I18nAdapter {
  * the package that owns the type.
  */
 type TranslationBundle = {
-    [key: string]: string | TranslationBundle | readonly (string | TranslationBundle)[];
+  [key: string]: string | TranslationBundle | readonly (string | TranslationBundle)[];
 };
 /**
  * Per-resource bundle: optional async loader returning default-export bundle.
  */
 type ResourceBundle = (() => Promise<{
-    default: TranslationBundle;
+  default: TranslationBundle;
 }>) | Record<string, () => Promise<{
-    default: TranslationBundle;
+  default: TranslationBundle;
 }>>;
-
+//#endregion
+//#region src/types/i18n-keys.d.ts
 /**
  * Open interface for opt-in codegen-typed i18n keys.
  *
@@ -50,14 +60,13 @@ type ResourceBundle = (() => Promise<{
  *     }
  *   }
  */
-interface I18nKeys {
-}
+interface I18nKeys {}
 /**
  * Open interface for keys requiring interpolation parameters.
  */
-interface I18nKeysWithParams {
-}
-
+interface I18nKeysWithParams {}
+//#endregion
+//#region src/lookup.d.ts
 /**
  * Build candidate keys for fallback lookup.
  *
@@ -67,26 +76,27 @@ interface I18nKeysWithParams {
  *   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.
+ * If `key` is already namespaced (starts with `resources.`, `enums.`,
+ * `common.` or `blocks.`), return it as-is without further scoping.
  */
 declare function resolveKey(key: string, resource?: string): string[];
-
+//#endregion
+//#region src/i18next-adapter.d.ts
 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;
+  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.
@@ -94,47 +104,67 @@ interface I18nextAdapterConfig {
  * (e.g. 'common', 'resources').
  */
 declare function createI18nextAdapter(config: I18nextAdapterConfig): Promise<I18nAdapter>;
-
+//#endregion
+//#region src/i18n.d.ts
 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;
+  /**
+   * Translate `key` through the candidate chain. `count` selects a count
+   * family's form (`<key>_one | _few | _many | _other`, by the locale's CLDR
+   * rules) and interpolates `{{count}}`; a family asked without a count is
+   * missing. A `count` inside `params` only interpolates.
+   */
+  t: (key: string, options?: {
+    resource?: string;
+    params?: Record<string, unknown>;
+    count?: number;
+  }) => 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". Pass `count` to probe a count family.
+   */
+  has: (key: string, options?: {
+    resource?: string;
+    count?: number;
+  }) => 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>;
+  /**
+   * The locale codes this app can switch to. Optional: a facade built without
+   * a list (a hand-rolled one, a test double) simply does not say, and a
+   * language control then offers only the active locale. `createI18nFromRegistry`
+   * fills it from the registry.
+   */
+  locales?: () => readonly string[];
+  adapter: I18nAdapter;
 }
 interface CreateI18nConfig {
-    adapter: I18nAdapter;
-    warnOnMissing?: boolean;
+  adapter: I18nAdapter;
+  warnOnMissing?: boolean;
+  /** The switchable locale codes, exposed as {@link I18nFacade.locales}. */
+  locales?: () => readonly string[];
 }
 declare function createI18n(config: CreateI18nConfig): I18nFacade;
-
+//#endregion
+//#region src/resource-context.d.ts
 interface ResourceI18n {
-    t: (key: string, options?: {
-        resource?: string;
-        params?: Record<string, unknown>;
-    }) => string;
-    changeLocale: (locale: string) => Promise<void>;
-    getCurrentLocale: () => string;
-    resource: string;
+  t: (key: string, options?: {
+    resource?: string;
+    params?: Record<string, unknown>;
+    count?: number;
+  }) => string;
+  changeLocale: (locale: string) => Promise<void>;
+  getCurrentLocale: () => string;
+  resource: string;
 }
 /**
  * Wraps an I18nFacade with a default resource scope.
@@ -142,7 +172,8 @@ interface ResourceI18n {
  * Pass an explicit `resource` option to override the default scope.
  */
 declare function createResourceI18n(i18n: I18nFacade, resource: string): ResourceI18n;
-
+//#endregion
+//#region src/locale-registry.d.ts
 /**
  * One package/app/domain module's offering for one locale.
  *
@@ -155,54 +186,79 @@ declare function createResourceI18n(i18n: I18nFacade, resource: string): Resourc
  * 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;
+  /** 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>>;
+  /**
+   * The primary locale, as declared to {@link createLocaleRegistry}: the one
+   * whose text is the default in code, and the locale every other one falls
+   * back to. The single source of truth for it — `createI18nFromRegistry`
+   * defaults both the starting locale and the fallback to it, and
+   * `@burojs/testing`'s `checkApp` reads it to know which locale is exempt
+   * from `i18n.missing`. Never derived from contributions or their order.
+   */
+  primary(): string;
+  /** 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.
+   *
+   * Throws when no contribution is registered for {@link primary}: a
+   * fallback chain that ends at a locale with no bundle, and a primary that
+   * `locales()` (and so every language switcher built from it) does not
+   * list, is a misconfiguration (usually a typo, `'en-US'` for `'en'`, or a
+   * glob that missed its file), not a state to render. An app that really
+   * has no strings for its primary locale registers an empty bundle for it.
+   */
+  buildResources(): Record<string, Record<string, TranslationBundle>>;
 }
-declare function createLocaleRegistry(): LocaleRegistry;
+interface LocaleRegistryOptions {
+  /**
+   * The primary locale: the one whose text is the default in code. Required,
+   * and declared here rather than inferred, because nothing in the
+   * contributions says which locale it is — registration order and the
+   * sorted `locales()` both carry no meaning.
+   */
+  primary: string;
+}
+declare function createLocaleRegistry(options: LocaleRegistryOptions): LocaleRegistry;
 /**
  * A bundler-produced glob module, as `import.meta.glob` (Vite) or an
  * equivalent walk over `require.context` (webpack) would yield it: a flat
@@ -214,24 +270,24 @@ declare function createLocaleRegistry(): LocaleRegistry;
  * whatever their bundler offers) and hands the plain object here.
  */
 type LocaleGlobModule = TranslationBundle | {
-    default: 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;
+  /** {@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.
@@ -241,21 +297,30 @@ interface LocaleContributionsFromGlobOptions {
  * 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;
+//#endregion
+//#region src/create-i18n-from-registry.d.ts
+type CreateI18nFromRegistryConfig = Partial<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.
+ * `registry.buildResources()` becomes its `resources`, and
+ * `registry.primary()` is both the starting locale and the fallback unless
+ * `defaultLocale` (the starting locale, say a stored choice) or
+ * `fallbackLocale` (say a per-locale chain) overrides it. This is the ONLY
+ * place those need to be threaded together — an app that builds its own
+ * registry never re-lists its locale codes, or restates its primary locale,
+ * to hand them to the adapter; it just calls this.
+ *
+ * Throws when the registry's primary locale has no contribution (see
+ * {@link LocaleRegistry.buildResources}).
  */
-declare function createI18nFromRegistry(registry: LocaleRegistry, config: CreateI18nFromRegistryConfig): Promise<I18nFacade>;
-
+declare function createI18nFromRegistry(registry: LocaleRegistry, config?: CreateI18nFromRegistryConfig): Promise<I18nFacade>;
+//#endregion
+//#region src/index.d.ts
 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 };
+//#endregion
+export { type CreateI18nConfig, type CreateI18nFromRegistryConfig, type I18nAdapter, type I18nFacade, type I18nKeys, type I18nKeysWithParams, type I18nextAdapterConfig, type LocaleContribution, type LocaleContributionsFromGlobOptions, type LocaleGlobModule, type LocaleRegistry, type LocaleRegistryOptions, PACKAGE_NAME, PACKAGE_VERSION, type ResourceBundle, type ResourceI18n, type TranslationBundle, createI18n, createI18nFromRegistry, createI18nextAdapter, createLocaleRegistry, createResourceI18n, localeContributionsFromGlob, resolveKey };
+//# sourceMappingURL=index.d.cts.map