locon 1.4.0 → 1.4.2

package/README.md

@@ -1,5 +1,9 @@
 ## locon
 
+[![npm version](https://img.shields.io/npm/v/locon.svg)](https://www.npmjs.com/package/locon)
+[![GitHub release](https://img.shields.io/github/v/release/loconapp/locon?display_name=tag)](https://github.com/loconapp/locon/releases)
+[![Release workflow](https://github.com/loconapp/locon/actions/workflows/release.yml/badge.svg)](https://github.com/loconapp/locon/actions/workflows/release.yml)
+
 `locon` is a small, typed i18n helper for React Native.  
 It provides a context provider, a hook, and a simple text component to keep
 your translations flat, explicit, and easy to use.
@@ -29,10 +33,18 @@ function Example() {
 
 ### Installation
 
+Use your package manager of choice:
+
+| npm                 | yarn             | bun             |
+| ------------------- | ---------------- | --------------- |
+| `npm install locon` | `yarn add locon` | `bun add locon` |
+
 ```bash
 npm install locon
 # or
 yarn add locon
+# or
+bun add locon
 ```
 
 **Important:** After installation, run pod install for iOS:
@@ -45,9 +57,22 @@ cd ios && pod install
 
 - `react >= 19.0.0`
 - `react-native >= 0.70.0`
-- `react-native-localize >= 3.0.0` (installed automatically)
+- `react-native-localize >= 3.0.0` (optional, but recommended for accurate device language detection)
 
 `react-native-localize` is used for accurate device language detection on iOS and Android.
+It is not installed automatically — add it to your app if you want native locale detection:
+
+```bash
+yarn add react-native-localize
+# or
+npm install react-native-localize
+```
+
+Then run iOS pods:
+
+```bash
+cd ios && pod install
+```
 
 ---
 
@@ -113,11 +138,13 @@ export default App
 If `currentLocale` is not provided and `autodetect` is `true` (default),
 `locon` will:
 
-1. Use `react-native-localize` to detect device locale on iOS/Android
+1. Use `react-native-localize` (if installed) to detect device locale on iOS/Android
 2. Match the detected locale (including region) or just language code against your `assets`
 3. If a match is found, use it as initial locale
 4. Otherwise, fall back to `defaultLocale`
 
+If `react-native-localize` is not installed, `locon` falls back to the Intl API.
+
 #### 3. Use the `useLocon()` hook
 
 ```tsx

package/dist/index.js

@@ -58,6 +58,7 @@ function Locon({
   projectLocale = "en",
   autodetect = true
 }) {
+  const resolvedProjectLocale = projectLocale || defaultLocale;
   const [currentLocale, setCurrentLocale] = (0, import_react.useState)(() => {
     if (currentLocaleProps) {
       return currentLocaleProps;
@@ -92,7 +93,7 @@ function Locon({
     [assets]
   );
   const getAssetByValue = (0, import_react.useCallback)(
-    (assetValue, locale = projectLocale) => {
+    (assetValue, locale = resolvedProjectLocale) => {
       const currentAssets = assets[locale];
       if (!currentAssets) {
         return void 0;
@@ -100,7 +101,7 @@ function Locon({
       const assetKey = Object.keys(currentAssets).find((key) => currentAssets[key] === assetValue);
       return assetKey ? getAsset(assetKey) : void 0;
     },
-    [assets, getAsset, projectLocale]
+    [assets, getAsset, resolvedProjectLocale]
   );
   const l = (0, import_react.useCallback)(
     (assetKey) => {
@@ -112,6 +113,11 @@ function Locon({
     },
     [getAsset, getAssetByValue, defaultLocale]
   );
+  (0, import_react.useEffect)(() => {
+    if (currentLocaleProps && currentLocaleProps !== currentLocale) {
+      setCurrentLocale(currentLocaleProps);
+    }
+  }, [currentLocaleProps, currentLocale]);
   const value = (0, import_react.useMemo)(
     () => ({
       assets,

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { jsx } from "react/jsx-runtime";
-import { createContext, useCallback, useMemo, useState } from "react";
+import { createContext, useCallback, useEffect, useMemo, useState } from "react";
 import getSystemLanguage from "./utils/getSystemLanguage";
 const LoconContext = createContext({
   assets: {},
@@ -20,6 +20,7 @@ function Locon({
   projectLocale = "en",
   autodetect = true
 }) {
+  const resolvedProjectLocale = projectLocale || defaultLocale;
   const [currentLocale, setCurrentLocale] = useState(() => {
     if (currentLocaleProps) {
       return currentLocaleProps;
@@ -54,7 +55,7 @@ function Locon({
     [assets]
   );
   const getAssetByValue = useCallback(
-    (assetValue, locale = projectLocale) => {
+    (assetValue, locale = resolvedProjectLocale) => {
       const currentAssets = assets[locale];
       if (!currentAssets) {
         return void 0;
@@ -62,7 +63,7 @@ function Locon({
       const assetKey = Object.keys(currentAssets).find((key) => currentAssets[key] === assetValue);
       return assetKey ? getAsset(assetKey) : void 0;
     },
-    [assets, getAsset, projectLocale]
+    [assets, getAsset, resolvedProjectLocale]
   );
   const l = useCallback(
     (assetKey) => {
@@ -74,6 +75,11 @@ function Locon({
     },
     [getAsset, getAssetByValue, defaultLocale]
   );
+  useEffect(() => {
+    if (currentLocaleProps && currentLocaleProps !== currentLocale) {
+      setCurrentLocale(currentLocaleProps);
+    }
+  }, [currentLocaleProps, currentLocale]);
   const value = useMemo(
     () => ({
       assets,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "locon",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "locon is a simple and lightweight library for React Native that provides a simple way to manage translations in your app.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -11,7 +11,8 @@
   "scripts": {
     "build": "tsup",
     "test": "jest",
-    "publish": "npm publish"
+    "publish": "npm publish",
+    "release": "semantic-release"
   },
   "keywords": [
     "i18n",
@@ -41,10 +42,13 @@
   "devDependencies": {
     "@babel/preset-react": "^7.24.7",
     "@eslint/js": "^9.10.0",
+    "@semantic-release/commit-analyzer": "^10.0.1",
     "@semantic-release/exec": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "11.0.1",
     "@semantic-release/npm": "^12.0.1",
+    "@semantic-release/release-notes-generator": "^10.0.1",
+    "semantic-release": "^22.0.0",
     "@testing-library/jest-dom": "^6.5.0",
     "@testing-library/react": "^16.0.1",
     "@types/jest": "^29.5.12",