@better-i18n/expo 0.7.2 → 0.7.3

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export { initBetterI18n, getLanguages, subscribeLanguages, getLanguagesSnapshot, refreshLanguages } from "./helpers.js";
 export type { InitBetterI18nOptions, BetterI18nResult } from "./helpers.js";
 export { useLanguages } from "./hooks.js";
+export { useLocaleSwitcher } from "./use-locale-switcher.js";
+export type { UseLocaleSwitcherReturn } from "./use-locale-switcher.js";
 export { getDeviceLocale, getDeviceLocales } from "./locale.js";
 export { createMemoryStorage, storageAdapter } from "./storage.js";
 export type { MMKVLike, AsyncStorageLike } from "./types.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACxH,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG7D,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEpF,+CAA+C;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACxH,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGxE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG7D,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEpF,+CAA+C;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -2,6 +2,7 @@
 export { initBetterI18n, getLanguages, subscribeLanguages, getLanguagesSnapshot, refreshLanguages } from "./helpers.js";
 // React hooks
 export { useLanguages } from "./hooks.js";
+export { useLocaleSwitcher } from "./use-locale-switcher.js";
 // Locale detection
 export { getDeviceLocale, getDeviceLocales } from "./locale.js";
 // Storage

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGxH,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEhE,UAAU;AACV,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAMnE,+CAA+C;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGxH,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEhE,UAAU;AACV,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAMnE,+CAA+C;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/use-locale-switcher.d.ts

@@ -0,0 +1,40 @@
+import type { LanguageOption } from "@better-i18n/core";
+export interface UseLocaleSwitcherReturn {
+    /** Available languages from the CDN manifest. Empty array before `initBetterI18n` completes. */
+    languages: LanguageOption[];
+    /** Current active locale (normalized to lowercase BCP 47). */
+    currentLocale: string;
+    /** Switch to a new locale. Pre-loads translations before switching to prevent flash. */
+    changeLocale: (locale: string) => Promise<void>;
+}
+/**
+ * Hook for building a custom locale switcher UI in React Native.
+ *
+ * Combines `useLanguages()` for the language list with `i18next.changeLanguage()`
+ * (pre-patched by `initBetterI18n` to pre-load translations before switching).
+ *
+ * @example
+ * ```tsx
+ * import { useLocaleSwitcher } from '@better-i18n/expo';
+ *
+ * function LanguagePicker() {
+ *   const { languages, currentLocale, changeLocale } = useLocaleSwitcher();
+ *
+ *   return (
+ *     <FlatList
+ *       data={languages}
+ *       keyExtractor={(item) => item.code}
+ *       renderItem={({ item }) => (
+ *         <Pressable onPress={() => changeLocale(item.code)}>
+ *           <Text style={item.code === currentLocale ? styles.active : undefined}>
+ *             {item.nativeName || item.code}
+ *           </Text>
+ *         </Pressable>
+ *       )}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export declare function useLocaleSwitcher(): UseLocaleSwitcherReturn;
+//# sourceMappingURL=use-locale-switcher.d.ts.map

package/dist/use-locale-switcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-locale-switcher.d.ts","sourceRoot":"","sources":["../src/use-locale-switcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,WAAW,uBAAuB;IACtC,gGAAgG;IAChG,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,8DAA8D;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CAiB3D"}

package/dist/use-locale-switcher.js

@@ -0,0 +1,43 @@
+import { useCallback, useMemo } from "react";
+import { useTranslation } from "react-i18next";
+import { normalizeLocale } from "@better-i18n/core";
+import { useLanguages } from "./hooks.js";
+/**
+ * Hook for building a custom locale switcher UI in React Native.
+ *
+ * Combines `useLanguages()` for the language list with `i18next.changeLanguage()`
+ * (pre-patched by `initBetterI18n` to pre-load translations before switching).
+ *
+ * @example
+ * ```tsx
+ * import { useLocaleSwitcher } from '@better-i18n/expo';
+ *
+ * function LanguagePicker() {
+ *   const { languages, currentLocale, changeLocale } = useLocaleSwitcher();
+ *
+ *   return (
+ *     <FlatList
+ *       data={languages}
+ *       keyExtractor={(item) => item.code}
+ *       renderItem={({ item }) => (
+ *         <Pressable onPress={() => changeLocale(item.code)}>
+ *           <Text style={item.code === currentLocale ? styles.active : undefined}>
+ *             {item.nativeName || item.code}
+ *           </Text>
+ *         </Pressable>
+ *       )}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export function useLocaleSwitcher() {
+    const languages = useLanguages();
+    const { i18n } = useTranslation();
+    const currentLocale = useMemo(() => normalizeLocale(i18n.language), [i18n.language]);
+    const changeLocale = useCallback(async (locale) => {
+        await i18n.changeLanguage(normalizeLocale(locale));
+    }, [i18n]);
+    return { languages, currentLocale, changeLocale };
+}
+//# sourceMappingURL=use-locale-switcher.js.map

package/dist/use-locale-switcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-locale-switcher.js","sourceRoot":"","sources":["../src/use-locale-switcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAW1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,EAAE,IAAI,EAAE,GAAG,cAAc,EAAE,CAAC;IAElC,MAAM,aAAa,GAAG,OAAO,CAC3B,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,EACpC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAChB,CAAC;IAEF,MAAM,YAAY,GAAG,WAAW,CAC9B,KAAK,EAAE,MAAc,EAAE,EAAE;QACvB,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC,EACD,CAAC,IAAI,CAAC,CACP,CAAC;IAEF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;AACpD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-i18n/expo",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Better i18n backend plugin for i18next in Expo/React Native",
   "license": "MIT",
   "repository": {
@@ -50,7 +50,7 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@better-i18n/core": "0.2.4"
+    "@better-i18n/core": "0.3.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0",