@hua-labs/i18n-core 2.1.0 → 2.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -1
- package/dist/chunk-7ZYOSEMW.mjs +1006 -0
- package/dist/chunk-7ZYOSEMW.mjs.map +1 -0
- package/dist/index.cjs +1874 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.mts +3 -3
- package/dist/index.d.ts +249 -0
- package/dist/index.mjs +13 -18
- package/dist/index.mjs.map +1 -1
- package/dist/{server-4TeBq6hp.d.mts → server-DgpyR0RE.d.mts} +27 -4
- package/dist/server-DgpyR0RE.d.ts +390 -0
- package/dist/{chunk-EZL5TNH5.mjs → server.cjs} +7 -3
- package/dist/server.cjs.map +1 -0
- package/dist/server.d.mts +1 -1
- package/dist/server.d.ts +1 -0
- package/dist/server.mjs +1 -1
- package/package.json +10 -7
- package/src/components/MissingKeyOverlay.tsx +6 -4
- package/src/core/translator.tsx +7 -7
- package/src/hooks/useI18n.tsx +25 -34
- package/src/index.ts +5 -2
- package/src/types/index.ts +59 -2
- package/dist/chunk-EZL5TNH5.mjs.map +0 -1
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@ Lightweight, production-ready i18n library for React. Delivers zero-flicker lang
|
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/@hua-labs/i18n-core)
|
|
6
6
|
[](https://www.npmjs.com/package/@hua-labs/i18n-core)
|
|
7
|
-
[](https://github.com/HUA-Labs/
|
|
7
|
+
[](https://github.com/HUA-Labs/hua-packages/blob/main/LICENSE)
|
|
8
8
|
[](https://www.typescriptlang.org/)
|
|
9
9
|
[](https://reactjs.org/)
|
|
10
10
|
|
|
@@ -17,7 +17,10 @@ Lightweight, production-ready i18n library for React. Delivers zero-flicker lang
|
|
|
17
17
|
- **Type-safe arrays — tArray() returns string[] without casting**
|
|
18
18
|
- **State management — First-class Zustand support via i18n-core-zustand**
|
|
19
19
|
- **Automatic retry — Exponential backoff for API loader failures**
|
|
20
|
+
- **React Native — Works in Expo and bare RN projects via CJS/ESM dual format**
|
|
20
21
|
- **~6.5KB gzipped — Zero external dependencies**
|
|
22
|
+
- **Cross-platform — I18nPlatformAdapter for Web, React Native, Flutter bridge**
|
|
23
|
+
- **Generic getRawValue<T>() — type-safe raw value access without casting**
|
|
21
24
|
|
|
22
25
|
## Installation
|
|
23
26
|
|
|
@@ -65,6 +68,8 @@ function Welcome() {
|
|
|
65
68
|
| `Translator` | class | Core translator class (for manual instantiation) |
|
|
66
69
|
| `ssrTranslate` | function | Server-side translation function (no React needed) |
|
|
67
70
|
| `serverTranslate` | function | Server-side translate with full config |
|
|
71
|
+
| `webPlatformAdapter` | function | Default web adapter — navigator.language detection + window event language sync |
|
|
72
|
+
| `headlessPlatformAdapter` | function | No-op adapter for SSR, testing, and Flutter bridge scenarios |
|
|
68
73
|
| `I18nConfig` | type | |
|
|
69
74
|
| `I18nContextType` | type | |
|
|
70
75
|
| `TranslationParams` | type | |
|
|
@@ -74,6 +79,7 @@ function Welcome() {
|
|
|
74
79
|
| `ResolvePluralKey` | type | |
|
|
75
80
|
| `PluralValue` | type | |
|
|
76
81
|
| `PluralCategory` | type | |
|
|
82
|
+
| `I18nPlatformAdapter` | interface | Platform adapter interface — implement for React Native or custom environments |
|
|
77
83
|
| `createCoreI18n` | function | Create an i18n Provider component with configuration |
|
|
78
84
|
| `CoreProvider` | function | Minimal Provider with zero config |
|
|
79
85
|
| `createLanguageProvider` | function | Create a Provider with just a language setting |
|