@byline/i18n 4.11.2 → 4.13.0

package/README.md

@@ -17,7 +17,7 @@ The package bundles every official Byline admin translation as a JSON file under
 ## Three entry points
 
 ```ts
-import { mergeTranslations, createFormatter, resolveInterfaceLocale } from '@byline/i18n'
+import { mergeTranslations, createFormatter, resolveAdminLocale } from '@byline/i18n'
 import { I18nProvider, useTranslation, LanguageMenu } from '@byline/i18n/react'
 import { adminTranslations, en } from '@byline/i18n/admin'
 ```
@@ -30,19 +30,19 @@ import { adminTranslations, en } from '@byline/i18n/admin'
 
 ```ts
 // apps/your-app/byline/admin.config.ts
-import { defineClientConfig } from '@byline/core'
+import { defineAdminConfig } from '@byline/core'
 import { adminTranslations } from '@byline/i18n/admin'
 
-defineClientConfig({
+defineAdminConfig({
   i18n: {
-    interface: {
+    admin: {
       defaultLocale: 'en',
       locales: ['en'],
     },
     // … content locales as before
     translations: adminTranslations({ locales: ['en'] }),
   },
-  // … the rest of your client config
+  // … the rest of your admin config
 })
 ```
 
@@ -52,7 +52,7 @@ defineClientConfig({
 import { adminTranslations } from '@byline/i18n/admin'
 
 i18n: {
-  interface: { defaultLocale: 'en', locales: ['en', 'fr'] },
+  admin: { defaultLocale: 'en', locales: ['en', 'fr'] },
   translations: adminTranslations({ locales: ['en', 'fr'] }),
 }
 ```
@@ -63,7 +63,7 @@ The set of bundled locales is exported as `bundledLocales` for hosts that want t
 import { adminTranslations, bundledLocales } from '@byline/i18n/admin'
 
 i18n: {
-  interface: { defaultLocale: 'en', locales: [...bundledLocales] },
+  admin: { defaultLocale: 'en', locales: [...bundledLocales] },
   translations: adminTranslations({ locales: bundledLocales }),
 }
 ```
@@ -72,7 +72,7 @@ i18n: {
 
 ## Plugin contributions
 
-A plugin (richtext extension, custom field, AI tool, …) ships its own JSON files inside its own package and exposes a factory matching `adminTranslations`'s shape — takes `{ locales }`, returns a `TranslationBundle` for the plugin's own namespace. The host merges them in `defineClientConfig`:
+A plugin (richtext extension, custom field, AI tool, …) ships its own JSON files inside its own package and exposes a factory matching `adminTranslations`'s shape — takes `{ locales }`, returns a `TranslationBundle` for the plugin's own namespace. The host merges them in `defineAdminConfig`:
 
 ```ts
 import { mergeTranslations } from '@byline/i18n'
@@ -80,7 +80,7 @@ import { adminTranslations } from '@byline/i18n/admin'
 import { aiTranslations } from '@byline/ai/i18n'
 
 i18n: {
-  interface: { defaultLocale: 'en', locales: ['en', 'fr'] },
+  admin: { defaultLocale: 'en', locales: ['en', 'fr'] },
   translations: mergeTranslations(
     adminTranslations({ locales: ['en', 'fr'] }),
     aiTranslations({ locales: ['en', 'fr'] }),
@@ -88,7 +88,7 @@ i18n: {
 }
 ```
 
-A plugin that ships a locale the host hasn't enabled is harmless — the plugin's factory simply returns nothing for that code, the merge produces an empty entry for it, and the boot validator gates against `i18n.interface.locales` anyway.
+A plugin that ships a locale the host hasn't enabled is harmless — the plugin's factory simply returns nothing for that code, the merge produces an empty entry for it, and the boot validator gates against `i18n.admin.locales` anyway.
 
 `mergeTranslations` is associative + deterministic; later sources override earlier ones at the `(locale, namespace, key)` grain, and a `MergeOptions.onCollision` callback is available for surfacing conflicts during development.
 
@@ -138,12 +138,12 @@ In a TanStack Start host, `resolveServerTranslator(namespace)` (provided by `@by
 
 ## Locale resolution cascade
 
-`resolveInterfaceLocale` is the same pure cascade run on client and server, so SSR and hydration produce the same answer:
+`resolveAdminLocale` is the same pure cascade run on client and server, so SSR and hydration produce the same answer:
 
 ```ts
-import { resolveInterfaceLocale } from '@byline/i18n'
+import { resolveAdminLocale } from '@byline/i18n'
 
-const activeLocale = resolveInterfaceLocale({
+const activeLocale = resolveAdminLocale({
   locales: ['en', 'fr'],
   defaultLocale: 'en',
   preferred: actor?.admin_user?.preferred_locale,

package/dist/admin/index.d.ts

@@ -14,10 +14,11 @@ declare const de: NamespaceTranslations;
 declare const it: NamespaceTranslations;
 declare const zhCN: NamespaceTranslations;
 declare const ko: NamespaceTranslations;
+declare const th: NamespaceTranslations;
 /** Locale codes for which a bundled translation ships in-package. */
 export declare const bundledLocales: readonly LocaleCode[];
 /** Re-exported as typed consts for plugin authors who want the literal-key autocomplete. */
-export { de, en, es, fr, it, ko, zhCN };
+export { de, en, es, fr, it, ko, th, zhCN };
 export type AdminNamespaceTranslations = typeof enJson;
 export interface AdminTranslationsOptions {
     /**
@@ -36,9 +37,9 @@ export interface AdminTranslationsOptions {
  * ```ts
  * import { adminTranslations } from '@byline/i18n/admin'
  *
- * defineClientConfig({
+ * defineAdminConfig({
  *   i18n: {
- *     interface: { defaultLocale: 'en', locales: ['en', 'fr'] },
+ *     admin: { defaultLocale: 'en', locales: ['en', 'fr'] },
  *     translations: adminTranslations({ locales: ['en', 'fr'] }),
  *   },
  * })

package/dist/admin/index.js

@@ -5,6 +5,7 @@ import es from "./es.js";
 import fr from "./fr.js";
 import it from "./it.js";
 import ko from "./ko.js";
+import th from "./th.js";
 import zh_CN from "./zh-CN.js";
 const admin_en = en;
 const admin_fr = fr;
@@ -13,6 +14,7 @@ const admin_de = de;
 const admin_it = it;
 const zhCN = zh_CN;
 const admin_ko = ko;
+const admin_th = th;
 const BUNDLES = {
     en: admin_en,
     fr: admin_fr,
@@ -20,7 +22,8 @@ const BUNDLES = {
     de: admin_de,
     it: admin_it,
     'zh-CN': zhCN,
-    ko: admin_ko
+    ko: admin_ko,
+    th: admin_th
 };
 const bundledLocales = Object.freeze(Object.keys(BUNDLES));
 function adminTranslations(options = {}) {
@@ -39,4 +42,4 @@ function adminTranslations(options = {}) {
     }
     return mergeTranslations(...partials);
 }
-export { adminTranslations, admin_de as de, admin_en as en, admin_es as es, admin_fr as fr, admin_it as it, admin_ko as ko, bundledLocales, zhCN };
+export { adminTranslations, admin_de as de, admin_en as en, admin_es as es, admin_fr as fr, admin_it as it, admin_ko as ko, admin_th as th, bundledLocales, zhCN };