@minejs/i18n 0.0.5 → 0.0.7

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.
Files changed (6) hide show
  1. package/README.md +340 -340
  2. package/dist/index.cjs +1 -1
  3. package/dist/index.cjs.map +1 -1
  4. package/dist/index.js +1 -1
  5. package/dist/index.js.map +1 -1
  6. package/package.json +3 -3
package/README.md CHANGED
@@ -1,341 +1,341 @@
1
- <!-- ╔══════════════════════════════ BEG ══════════════════════════════╗ -->
2
-
3
- <br>
4
- <div align="center">
5
- <p>
6
- <img src="./assets/img/logo.png" alt="logo" style="" height="60" />
7
- </p>
8
- </div>
9
-
10
- <div align="center">
11
- <img src="https://img.shields.io/badge/v-0.0.5-black"/>
12
- <a href="https://img.shields.io/github/stars/minejs-org"><img src="https://img.shields.io/badge/🔥-@minejs-black"/></a>
13
- <br>
14
- <img src="https://img.shields.io/badge/coverage-94.40%25-brightgreen" alt="Test Coverage" />
15
- <img src="https://img.shields.io/github/issues/minejs-org/i18n?style=flat" alt="Github Repo Issues" />
16
- <img src="https://img.shields.io/github/stars/minejs-org/i18n?style=social" alt="GitHub Repo stars" />
17
- </div>
18
- <br>
19
-
20
- <!-- ╚═════════════════════════════════════════════════════════════════╝ -->
21
-
22
-
23
-
24
- <!-- ╔══════════════════════════════ DOC ══════════════════════════════╗ -->
25
-
26
- - ## Overview 👀
27
-
28
- - #### Why ?
29
- > To unify the translation system and languages ​​on the server and client, faster, cleaner, more maintainable.
30
-
31
- - #### When ?
32
- > When you need to add a translation to your server or client.
33
-
34
- > When you use [@cruxjs/app](https://github.com/cruxjs-org/app).
35
-
36
- <br>
37
- <br>
38
-
39
- - ## Quick Start 🔥
40
-
41
- > install [`hmm`](https://github.com/minejs-org/hmm) first.
42
-
43
- ```bash
44
- # in your terminal
45
- hmm i @minejs/i18n
46
- ```
47
-
48
- <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> </div>
49
-
50
- - #### Setup
51
-
52
- - ##### JSON
53
-
54
- > Save the translation **keys and their values** ​​in `.json` files.
55
-
56
- ```jsonc
57
- // ./src/shared/dist/u18n/en.json
58
- {
59
- "key": "value"
60
- }
61
- ```
62
-
63
- ```jsonc
64
- // ./src/shared/dist/u18n/ar.json
65
- {
66
- "key": "قيـمة"
67
- }
68
- ```
69
-
70
- - ##### I18n
71
-
72
- > ***🌟 If you are using [`@cruxjs/app`](https://github.com/cruxjs-org/app) you can skip this step. 🌟***
73
-
74
- > Then in your project ***(works with any environment: `server`, `browser`, ..)***
75
- >
76
- > Call the `setupI18n(..)` function **only once** in your application's lifecycle :
77
-
78
- ```ts
79
- import { setupI18n } from `@minejs/i18n`;
80
- ```
81
-
82
- ```ts
83
- await this.setupI18n({
84
- defaultLanguage : 'en',
85
- supportedLanguages : ['en', 'ar'],
86
- basePath : '/static/dist/i18n', // for client side (or your custom public url)
87
- : './src/shared/dist/i18n', // for server side (or your custom local path)
88
- });
89
- ```
90
-
91
- <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> </div>
92
- <br>
93
-
94
- - #### Usage
95
-
96
- > Now you can call the `t(..)` function anywhere in your project :
97
-
98
- ```tsx
99
- import { t } from `@minejs/i18n`;
100
- ```
101
-
102
- ```ts
103
- t('key', { params }, fallback) // just it !
104
- ```
105
-
106
- <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> </div>
107
-
108
- - #### Language Switching
109
-
110
- ```typescript
111
- import { setLanguage, onChange } from '@minejs/i18n';
112
-
113
- // Listen to changes
114
- onChange((lang) => {
115
- console.log('Language changed to:', lang);
116
- document.documentElement.lang = lang;
117
- document.dir = isRTL() ? 'rtl' : 'ltr';
118
- });
119
-
120
- // Change language
121
- await setLanguage('ar');
122
- ```
123
-
124
- - #### Parameterized Translations
125
-
126
- ```json
127
- {
128
- "greeting": "Hello {name}, you have {count} messages"
129
- }
130
- ```
131
-
132
- ```typescript
133
- t('greeting', { name: 'John', count: '5' })
134
- // "Hello John, you have 5 messages"
135
- ```
136
-
137
- - #### HTML Tag Parsing
138
-
139
- ```json
140
- {
141
- "terms": "I agree to the <link>Terms of Service</link>"
142
- }
143
- ```
144
-
145
- ```typescript
146
- const tokens = tParse('terms');
147
- // [
148
- // { type: 'text', content: 'I agree to the ' },
149
- // { type: 'tag', tag: 'link', content: 'Terms of Service' }
150
- // ]
151
- ```
152
-
153
- - #### Page Titles (with RTL support)
154
-
155
- ```typescript
156
- import { genPageTitle } from '@minejs/i18n';
157
-
158
- // en: "Settings - MyApp"
159
- // ar: "MyApp - الإعدادات"
160
- const title = genPageTitle('settings');
161
- ```
162
-
163
- <br>
164
- <br>
165
-
166
- - ## Documentation 📑
167
-
168
- - ### API
169
-
170
- - #### Types
171
-
172
- ```typescript
173
- type LanguageCode = string;
174
- ```
175
-
176
- ```typescript
177
- interface I18nConfig {
178
- defaultLanguage? : LanguageCode;
179
- supportedLanguages? : LanguageCode[];
180
- fallbackLanguage? : LanguageCode;
181
- onLanguageChange? : (lang: LanguageCode) => void;
182
- storage? : I18nStorage;
183
- basePath? : string;
184
- fileExtension? : string;
185
- }
186
- ```
187
-
188
- ```typescript
189
- interface TranslationToken {
190
- type : 'text' | 'tag';
191
- tag? : string;
192
- content : string;
193
- }
194
- ```
195
-
196
- <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> </div>
197
-
198
- - #### Functions
199
-
200
- - #### `setupI18n(config)`
201
-
202
- > Initialize i18n with auto-detection
203
-
204
- ```typescript
205
- await setupI18n({
206
- defaultLanguage : 'en',
207
- supportedLanguages : ['en', 'ar', 'fr'],
208
- basePath : '/i18n/', // URL (browser) or path (server)
209
- fileExtension : 'json' // optional
210
- });
211
- ```
212
-
213
- - #### `t(key, params?)`
214
-
215
- > Translate with parameter replacement
216
-
217
- ```typescript
218
- t('greeting', { name: 'John' }) // "Hello John"
219
- ```
220
-
221
- - #### `tLang(key, lang, params?)`
222
-
223
- > Translate with specific language
224
-
225
- ```typescript
226
- tLang('greeting', 'ar', { name: 'أحمد' })
227
- ```
228
-
229
- - #### `tParse(key, params?)`
230
-
231
- > Parse translation with HTML tags
232
-
233
- ```typescript
234
- tParse('message') // Returns TokenArray
235
- ```
236
-
237
- - #### `setLanguage(lang)`
238
-
239
- > Change current language
240
-
241
- ```typescript
242
- await setLanguage('ar')
243
- ```
244
-
245
- - #### `getLanguage()`
246
-
247
- > Get current language code
248
-
249
- ```typescript
250
- const lang = getLanguage() // 'en'
251
- ```
252
-
253
- - #### `getSupportedLanguages()`
254
-
255
- > Get all supported languages
256
-
257
- ```typescript
258
- const langs = getSupportedLanguages() // ['en', 'ar', 'fr']
259
- ```
260
-
261
- - #### `isRTL()`
262
-
263
- > Check if current language is RTL
264
-
265
- ```typescript
266
- if (isRTL()) { /* Handle RTL layout */ }
267
- ```
268
-
269
- - #### `onChange(callback)`
270
-
271
- > Subscribe to language changes
272
-
273
- ```typescript
274
- const unsubscribe = onChange((lang) => console.log('Changed to:', lang))
275
- ```
276
-
277
- - #### `genPageTitle(key, prefix?)`
278
-
279
- > Generate page title with app name
280
-
281
- ```typescript
282
- genPageTitle('home') // "Home - MyApp" or "MyApp - الرئيسية"
283
- ```
284
-
285
- - #### `plural(count, singleKey, pluralKey)`
286
-
287
- > Handle pluralization
288
-
289
- ```typescript
290
- plural(5, 'item.single', 'item.plural') // "5 items"
291
- ```
292
-
293
- - #### `hasKey(key)`
294
-
295
- > Check if translation exists
296
-
297
- ```typescript
298
- if (hasKey('settings.theme')) { /* ... */ }
299
- ```
300
-
301
- - #### `loadLanguage(lang, translations)`
302
-
303
- > Load translations for a language
304
-
305
- ```typescript
306
- loadLanguage('en', { greeting: 'Hello' })
307
- ```
308
-
309
- - #### `loadTranslations(translations)`
310
-
311
- > Load multiple languages at once
312
-
313
- ```typescript
314
- loadTranslations({
315
- en: { greeting: 'Hello' },
316
- ar: { greeting: 'مرحبا' }
317
- })
318
- ```
319
-
320
- <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> </div>
321
-
322
- - #### Related
323
-
324
- - ##### [@cruxjs/app](https://github.com/cruxjs-org/app)
325
-
326
- <!-- ╚═════════════════════════════════════════════════════════════════╝ -->
327
-
328
-
329
-
330
- <!-- ╔══════════════════════════════ END ══════════════════════════════╗ -->
331
-
332
- <br>
333
- <br>
334
-
335
- ---
336
-
337
- <div align="center">
338
- <a href="https://github.com/maysara-elshewehy"><img src="https://img.shields.io/badge/by-Maysara-black"/></a>
339
- </div>
340
-
1
+ <!-- ╔══════════════════════════════ BEG ══════════════════════════════╗ -->
2
+
3
+ <br>
4
+ <div align="center">
5
+ <p>
6
+ <img src="./assets/img/logo.png" alt="logo" style="" height="60" />
7
+ </p>
8
+ </div>
9
+
10
+ <div align="center">
11
+ <img src="https://img.shields.io/badge/v-0.0.7-black"/>
12
+ <a href="https://img.shields.io/github/stars/minejs-org"><img src="https://img.shields.io/badge/🔥-@minejs-black"/></a>
13
+ <br>
14
+ <img src="https://img.shields.io/badge/coverage-94.40%25-brightgreen" alt="Test Coverage" />
15
+ <img src="https://img.shields.io/github/issues/minejs-org/i18n?style=flat" alt="Github Repo Issues" />
16
+ <img src="https://img.shields.io/github/stars/minejs-org/i18n?style=social" alt="GitHub Repo stars" />
17
+ </div>
18
+ <br>
19
+
20
+ <!-- ╚═════════════════════════════════════════════════════════════════╝ -->
21
+
22
+
23
+
24
+ <!-- ╔══════════════════════════════ DOC ══════════════════════════════╗ -->
25
+
26
+ - ## Overview 👀
27
+
28
+ - #### Why ?
29
+ > To unify the translation system and languages ​​on the server and client, faster, cleaner, more maintainable.
30
+
31
+ - #### When ?
32
+ > When you need to add a translation to your server or client.
33
+
34
+ > When you use [@cruxjs/app](https://github.com/cruxjs-org/app).
35
+
36
+ <br>
37
+ <br>
38
+
39
+ - ## Quick Start 🔥
40
+
41
+ > install [`hmm`](https://github.com/minejs-org/hmm) first.
42
+
43
+ ```bash
44
+ # in your terminal
45
+ hmm i @minejs/i18n
46
+ ```
47
+
48
+ <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> </div>
49
+
50
+ - #### Setup
51
+
52
+ - ##### JSON
53
+
54
+ > Save the translation **keys and their values** ​​in `.json` files.
55
+
56
+ ```jsonc
57
+ // ./src/shared/dist/u18n/en.json
58
+ {
59
+ "key": "value"
60
+ }
61
+ ```
62
+
63
+ ```jsonc
64
+ // ./src/shared/dist/u18n/ar.json
65
+ {
66
+ "key": "قيـمة"
67
+ }
68
+ ```
69
+
70
+ - ##### I18n
71
+
72
+ > ***🌟 If you are using [`@cruxjs/app`](https://github.com/cruxjs-org/app) you can skip this step. 🌟***
73
+
74
+ > Then in your project ***(works with any environment: `server`, `browser`, ..)***
75
+ >
76
+ > Call the `setupI18n(..)` function **only once** in your application's lifecycle :
77
+
78
+ ```ts
79
+ import { setupI18n } from `@minejs/i18n`;
80
+ ```
81
+
82
+ ```ts
83
+ await this.setupI18n({
84
+ defaultLanguage : 'en',
85
+ supportedLanguages : ['en', 'ar'],
86
+ basePath : '/static/dist/i18n', // for client side (or your custom public url)
87
+ : './src/shared/dist/i18n', // for server side (or your custom local path)
88
+ });
89
+ ```
90
+
91
+ <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> </div>
92
+ <br>
93
+
94
+ - #### Usage
95
+
96
+ > Now you can call the `t(..)` function anywhere in your project :
97
+
98
+ ```tsx
99
+ import { t } from `@minejs/i18n`;
100
+ ```
101
+
102
+ ```ts
103
+ t('key', { params }, fallback) // just it !
104
+ ```
105
+
106
+ <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> </div>
107
+
108
+ - #### Language Switching
109
+
110
+ ```typescript
111
+ import { setLanguage, onChange } from '@minejs/i18n';
112
+
113
+ // Listen to changes
114
+ onChange((lang) => {
115
+ console.log('Language changed to:', lang);
116
+ document.documentElement.lang = lang;
117
+ document.dir = isRTL() ? 'rtl' : 'ltr';
118
+ });
119
+
120
+ // Change language
121
+ await setLanguage('ar');
122
+ ```
123
+
124
+ - #### Parameterized Translations
125
+
126
+ ```json
127
+ {
128
+ "greeting": "Hello {name}, you have {count} messages"
129
+ }
130
+ ```
131
+
132
+ ```typescript
133
+ t('greeting', { name: 'John', count: '5' })
134
+ // "Hello John, you have 5 messages"
135
+ ```
136
+
137
+ - #### HTML Tag Parsing
138
+
139
+ ```json
140
+ {
141
+ "terms": "I agree to the <link>Terms of Service</link>"
142
+ }
143
+ ```
144
+
145
+ ```typescript
146
+ const tokens = tParse('terms');
147
+ // [
148
+ // { type: 'text', content: 'I agree to the ' },
149
+ // { type: 'tag', tag: 'link', content: 'Terms of Service' }
150
+ // ]
151
+ ```
152
+
153
+ - #### Page Titles (with RTL support)
154
+
155
+ ```typescript
156
+ import { genPageTitle } from '@minejs/i18n';
157
+
158
+ // en: "Settings - MyApp"
159
+ // ar: "MyApp - الإعدادات"
160
+ const title = genPageTitle('settings');
161
+ ```
162
+
163
+ <br>
164
+ <br>
165
+
166
+ - ## Documentation 📑
167
+
168
+ - ### API
169
+
170
+ - #### Types
171
+
172
+ ```typescript
173
+ type LanguageCode = string;
174
+ ```
175
+
176
+ ```typescript
177
+ interface I18nConfig {
178
+ defaultLanguage? : LanguageCode;
179
+ supportedLanguages? : LanguageCode[];
180
+ fallbackLanguage? : LanguageCode;
181
+ onLanguageChange? : (lang: LanguageCode) => void;
182
+ storage? : I18nStorage;
183
+ basePath? : string;
184
+ fileExtension? : string;
185
+ }
186
+ ```
187
+
188
+ ```typescript
189
+ interface TranslationToken {
190
+ type : 'text' | 'tag';
191
+ tag? : string;
192
+ content : string;
193
+ }
194
+ ```
195
+
196
+ <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> </div>
197
+
198
+ - #### Functions
199
+
200
+ - #### `setupI18n(config)`
201
+
202
+ > Initialize i18n with auto-detection
203
+
204
+ ```typescript
205
+ await setupI18n({
206
+ defaultLanguage : 'en',
207
+ supportedLanguages : ['en', 'ar', 'fr'],
208
+ basePath : '/i18n/', // URL (browser) or path (server)
209
+ fileExtension : 'json' // optional
210
+ });
211
+ ```
212
+
213
+ - #### `t(key, params?)`
214
+
215
+ > Translate with parameter replacement
216
+
217
+ ```typescript
218
+ t('greeting', { name: 'John' }) // "Hello John"
219
+ ```
220
+
221
+ - #### `tLang(key, lang, params?)`
222
+
223
+ > Translate with specific language
224
+
225
+ ```typescript
226
+ tLang('greeting', 'ar', { name: 'أحمد' })
227
+ ```
228
+
229
+ - #### `tParse(key, params?)`
230
+
231
+ > Parse translation with HTML tags
232
+
233
+ ```typescript
234
+ tParse('message') // Returns TokenArray
235
+ ```
236
+
237
+ - #### `setLanguage(lang)`
238
+
239
+ > Change current language
240
+
241
+ ```typescript
242
+ await setLanguage('ar')
243
+ ```
244
+
245
+ - #### `getLanguage()`
246
+
247
+ > Get current language code
248
+
249
+ ```typescript
250
+ const lang = getLanguage() // 'en'
251
+ ```
252
+
253
+ - #### `getSupportedLanguages()`
254
+
255
+ > Get all supported languages
256
+
257
+ ```typescript
258
+ const langs = getSupportedLanguages() // ['en', 'ar', 'fr']
259
+ ```
260
+
261
+ - #### `isRTL()`
262
+
263
+ > Check if current language is RTL
264
+
265
+ ```typescript
266
+ if (isRTL()) { /* Handle RTL layout */ }
267
+ ```
268
+
269
+ - #### `onChange(callback)`
270
+
271
+ > Subscribe to language changes
272
+
273
+ ```typescript
274
+ const unsubscribe = onChange((lang) => console.log('Changed to:', lang))
275
+ ```
276
+
277
+ - #### `genPageTitle(key, prefix?)`
278
+
279
+ > Generate page title with app name
280
+
281
+ ```typescript
282
+ genPageTitle('home') // "Home - MyApp" or "MyApp - الرئيسية"
283
+ ```
284
+
285
+ - #### `plural(count, singleKey, pluralKey)`
286
+
287
+ > Handle pluralization
288
+
289
+ ```typescript
290
+ plural(5, 'item.single', 'item.plural') // "5 items"
291
+ ```
292
+
293
+ - #### `hasKey(key)`
294
+
295
+ > Check if translation exists
296
+
297
+ ```typescript
298
+ if (hasKey('settings.theme')) { /* ... */ }
299
+ ```
300
+
301
+ - #### `loadLanguage(lang, translations)`
302
+
303
+ > Load translations for a language
304
+
305
+ ```typescript
306
+ loadLanguage('en', { greeting: 'Hello' })
307
+ ```
308
+
309
+ - #### `loadTranslations(translations)`
310
+
311
+ > Load multiple languages at once
312
+
313
+ ```typescript
314
+ loadTranslations({
315
+ en: { greeting: 'Hello' },
316
+ ar: { greeting: 'مرحبا' }
317
+ })
318
+ ```
319
+
320
+ <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> </div>
321
+
322
+ - #### Related
323
+
324
+ - ##### [@cruxjs/app](https://github.com/cruxjs-org/app)
325
+
326
+ <!-- ╚═════════════════════════════════════════════════════════════════╝ -->
327
+
328
+
329
+
330
+ <!-- ╔══════════════════════════════ END ══════════════════════════════╗ -->
331
+
332
+ <br>
333
+ <br>
334
+
335
+ ---
336
+
337
+ <div align="center">
338
+ <a href="https://github.com/maysara-elshewehy"><img src="https://img.shields.io/badge/by-Maysara-black"/></a>
339
+ </div>
340
+
341
341
  <!-- ╚═════════════════════════════════════════════════════════════════╝ -->
package/dist/index.cjs CHANGED
@@ -1,2 +1,2 @@
1
- 'use strict';Object.defineProperty(exports,'__esModule',{value:true});var u=class{constructor(e){this.translations={};this.currentLanguage="en";this.defaultLanguage="en";this.supportedLanguages=new Set(["en"]);this.rtlLanguages=new Set(["ar","he","fa","ur","yi","ji","iw","ku"]);this.listeners=new Set;e&&(this.defaultLanguage=e.defaultLanguage||"en",this.currentLanguage=e.defaultLanguage||"en",this.storage=e.storage,this.onLanguageChange=e.onLanguageChange,e.supportedLanguages&&(this.supportedLanguages=new Set(e.supportedLanguages)));}async init(){if(this.storage){let e=await this.storage.get("i18n-language");e&&this.supportedLanguages.has(e)&&(this.currentLanguage=e);}}loadLanguage(e,t){this.translations[e]||(this.translations[e]={});let a=this.flattenObject(t);this.translations[e]={...this.translations[e],...a},this.supportedLanguages.add(e);}loadTranslations(e){Object.entries(e).forEach(([t,a])=>{this.loadLanguage(t,a);});}flattenObject(e,t=""){let a={};for(let r in e){if(!Object.prototype.hasOwnProperty.call(e,r))continue;let i=e[r],s=t?`${t}.${r}`:r;typeof i=="object"&&i!==null&&!Array.isArray(i)?Object.assign(a,this.flattenObject(i,s)):a[s]=String(i);}return a}t(e,t){let a=this.getTranslation(e);return t&&Object.entries(t).forEach(([r,i])=>{let s=this.getTranslation(i,i);a=a.replace(new RegExp(`\\{${r}\\}`,"g"),s);}),a}getTranslation(e,t){return this.translations[this.currentLanguage]?.[e]?this.translations[this.currentLanguage][e]:this.defaultLanguage!==this.currentLanguage&&this.translations[this.defaultLanguage]?.[e]?this.translations[this.defaultLanguage][e]:(console.warn(`[i18n] Translation key not found: "${e}" (lang: ${this.currentLanguage})`),t||e)}tLang(e,t,a){let r=this.currentLanguage;this.currentLanguage=t;let i=this.t(e,a);return this.currentLanguage=r,i}tParse(e,t){let a=this.t(e,t);a=a.replace(/\\n|\/n/g,"<br>");let r=[],i=/<([a-z]+)>([^<]*)<\/\1>|<([a-z]+)\s*\/?>|([^<]+)/gi,s;for(;(s=i.exec(a))!==null;)s[4]?r.push({type:"text",content:s[4]}):s[1]?r.push({type:"tag",tag:s[1],content:s[2]}):s[3]&&r.push({type:"tag",tag:s[3],content:""});return r.length>0?r:[{type:"text",content:a}]}async setLanguage(e){if(!this.supportedLanguages.has(e)){console.warn(`[i18n] Language "${e}" not supported`);return}this.currentLanguage=e,this.storage&&await this.storage.set("i18n-language",e),this.listeners.forEach(t=>t(e)),this.onLanguageChange&&this.onLanguageChange(e);}getLanguage(){return this.currentLanguage}getSupportedLanguages(){return Array.from(this.supportedLanguages)}isLanguageSupported(e){return this.supportedLanguages.has(e)}hasKey(e){return !!(this.translations[this.currentLanguage]?.[e]||this.translations[this.defaultLanguage]?.[e])}getTranslations(){return this.translations[this.currentLanguage]||{}}isRTL(){return this.rtlLanguages.has(this.currentLanguage.toLowerCase().substring(0,2))}isRTLLanguage(e){return this.rtlLanguages.has(e.toLowerCase().substring(0,2))}onChange(e){return this.listeners.add(e),()=>this.listeners.delete(e)}};var L=()=>({get:n=>typeof localStorage>"u"?null:localStorage.getItem(n),set:(n,e)=>{typeof localStorage<"u"&&localStorage.setItem(n,e);}}),y=()=>{let n=new Map;return {get:e=>n.get(e)||null,set:(e,t)=>{n.set(e,t);}}},f=()=>typeof localStorage<"u"?L():y(),p=class{constructor(e,t,a="json"){this.loading=new Map;this.loaded=new Set;this.baseUrl=e.endsWith("/")?e:e+"/",this.manager=t,this.fileExtension=a,this.isServerSide=typeof fetch>"u";}async load(e){if(this.loaded.has(e))return;if(this.loading.has(e))return this.loading.get(e);let t=this.doLoad(e);this.loading.set(e,t);try{await t,this.loaded.add(e);}finally{this.loading.delete(e);}}async doLoad(e){try{let t=`${this.baseUrl}${e}.${this.fileExtension}`,a;t.startsWith(".")||t.startsWith("/")||/^[a-zA-Z]:/.test(t)||this.isServerSide?a=await this.loadFromFile(t):a=await this.loadFromUrl(t),a&&this.manager.loadLanguage(e,a);}catch(t){console.warn(`[i18n] Error loading language: ${e}`,t);}}async loadFromUrl(e){try{let t=await fetch(e);return t.ok?await t.json():(console.warn(`[i18n] Failed to load language from URL: ${e} (${t.status})`),null)}catch(t){return console.warn(`[i18n] Error fetching from URL: ${e}`,t),null}}async loadFromFile(e){try{let t=await import('fs').then(s=>s.promises).catch(()=>null),a=await import('path').then(s=>s).catch(()=>null);if(!t)return console.warn("[i18n] fs module not available. Running in browser?"),null;let r=e;if(a&&!a.isAbsolute(e)){let s=await import('process').then(h=>h).catch(()=>null);s&&(r=a.resolve(s.cwd(),e));}let i=await t.readFile(r,"utf-8");return JSON.parse(i)}catch(t){return console.warn(`[i18n] Error reading file: ${e}`,t),null}}isLoaded(e){return this.loaded.has(e)}},g=null,l=null;function w(){return typeof navigator<"u"&&navigator.language?navigator.language.split("-")[0].toLowerCase():"en"}function m(){return typeof fetch<"u"&&typeof window<"u"}function o(){return g||(g=new u),g}function v(){return l}async function b(n){if(m()&&!n.defaultLanguage){let e=w();n.supportedLanguages?.includes(e)?n.defaultLanguage=e:n.defaultLanguage=n.supportedLanguages?.[0]||"en";}if(n.storage||(n.storage=f()),g=new u(n),await g.init(),n.basePath){let e=n.fileExtension||"json";l=new p(n.basePath,g,e),await l.load(g.getLanguage());}return g}var d=(n,e)=>o().t(n,e),C=(n,e,t)=>o().tLang(n,e,t),x=(n,e)=>o().tParse(n,e),S=async n=>l&&!l.isLoaded(n)?l.load(n).then(()=>o().setLanguage(n)):o().setLanguage(n),R=()=>o().getLanguage(),T=()=>o().getSupportedLanguages(),I=n=>o().hasKey(n),c=()=>o().isRTL(),P=n=>o().isRTLLanguage(n),$=n=>o().onChange(n),E=(n,e)=>o().loadLanguage(n,e),j=n=>o().loadTranslations(n);function M(n,e="page."){let t=d("app.name"),a=d(e+n);return c()?`${t} - ${a}`:`${a} - ${t}`}function O(n,e,t){return d(n===1?e:t,{count:String(n)})}var A={setupI18n:b,getI18n:o,getLazyLoader:v,I18nManager:u,LazyLoader:p,t:d,tLang:C,tParse:x,setLanguage:S,getLanguage:R,getSupportedLanguages:T,hasKey:I,isRTL:c,isRTLLanguage:P,onChange:$,loadLanguage:E,loadTranslations:j,genPageTitle:M,plural:O};exports.I18nManager=u;exports.LazyLoader=p;exports.default=A;exports.genPageTitle=M;exports.getI18n=o;exports.getLanguage=R;exports.getLazyLoader=v;exports.getSupportedLanguages=T;exports.hasKey=I;exports.isRTL=c;exports.isRTLLanguage=P;exports.loadLanguage=E;exports.loadTranslations=j;exports.onChange=$;exports.plural=O;exports.setLanguage=S;exports.setupI18n=b;exports.t=d;exports.tLang=C;exports.tParse=x;//# sourceMappingURL=index.cjs.map
1
+ 'use strict';Object.defineProperty(exports,'__esModule',{value:true});var u=class{constructor(e){this.translations={};this.currentLanguage="en";this.defaultLanguage="en";this.supportedLanguages=new Set(["en"]);this.rtlLanguages=new Set(["ar","he","fa","ur","yi","ji","iw","ku"]);this.listeners=new Set;e&&(this.defaultLanguage=e.defaultLanguage||"en",this.currentLanguage=e.defaultLanguage||"en",this.storage=e.storage,this.onLanguageChange=e.onLanguageChange,e.supportedLanguages&&(this.supportedLanguages=new Set(e.supportedLanguages)));}async init(){if(this.storage){let e=await this.storage.get("i18n-language");e&&this.supportedLanguages.has(e)&&(this.currentLanguage=e);}}loadLanguage(e,t){this.translations[e]||(this.translations[e]={});let a=this.flattenObject(t);this.translations[e]={...this.translations[e],...a},this.supportedLanguages.add(e);}loadTranslations(e){Object.entries(e).forEach(([t,a])=>{this.loadLanguage(t,a);});}flattenObject(e,t=""){let a={};for(let r in e){if(!Object.prototype.hasOwnProperty.call(e,r))continue;let i=e[r],s=t?`${t}.${r}`:r;typeof i=="object"&&i!==null&&!Array.isArray(i)?Object.assign(a,this.flattenObject(i,s)):a[s]=String(i);}return a}t(e,t){let a=this.getTranslation(e);return t&&Object.entries(t).forEach(([r,i])=>{let s=this.getTranslation(i,i);a=a.replace(new RegExp(`\\{${r}\\}`,"g"),s);}),a}getTranslation(e,t){return this.translations[this.currentLanguage]?.[e]?this.translations[this.currentLanguage][e]:this.defaultLanguage!==this.currentLanguage&&this.translations[this.defaultLanguage]?.[e]?this.translations[this.defaultLanguage][e]:(console.warn(`[i18n] Translation key not found: "${e}" (lang: ${this.currentLanguage})`),t||e)}tLang(e,t,a){let r=this.currentLanguage;this.currentLanguage=t;let i=this.t(e,a);return this.currentLanguage=r,i}tParse(e,t){let a=this.t(e,t);a=a.replace(/\\n|\/n/g,"<br>");let r=[],i=/<([a-z]+)>([^<]*)<\/\1>|<([a-z]+)\s*\/?>|([^<]+)/gi,s;for(;(s=i.exec(a))!==null;)s[4]?r.push({type:"text",content:s[4]}):s[1]?r.push({type:"tag",tag:s[1],content:s[2]}):s[3]&&r.push({type:"tag",tag:s[3],content:""});return r.length>0?r:[{type:"text",content:a}]}async setLanguage(e){if(!this.supportedLanguages.has(e)){console.warn(`[i18n] Language "${e}" not supported`);return}this.currentLanguage=e,this.storage&&await this.storage.set("i18n-language",e),this.listeners.forEach(t=>t(e)),this.onLanguageChange&&this.onLanguageChange(e);}getLanguage(){return this.currentLanguage}getSupportedLanguages(){return Array.from(this.supportedLanguages)}isLanguageSupported(e){return this.supportedLanguages.has(e)}hasKey(e){return !!(this.translations[this.currentLanguage]?.[e]||this.translations[this.defaultLanguage]?.[e])}getTranslations(){return this.translations[this.currentLanguage]||{}}isRTL(){return this.rtlLanguages.has(this.currentLanguage.toLowerCase().substring(0,2))}isRTLLanguage(e){return this.rtlLanguages.has(e.toLowerCase().substring(0,2))}onChange(e){return this.listeners.add(e),()=>this.listeners.delete(e)}};var L=()=>({get:n=>typeof localStorage>"u"?null:localStorage.getItem(n),set:(n,e)=>{typeof localStorage<"u"&&localStorage.setItem(n,e);}}),y=()=>{let n=new Map;return {get:e=>n.get(e)||null,set:(e,t)=>{n.set(e,t);}}},f=()=>typeof localStorage<"u"?L():y(),p=class{constructor(e,t,a="json"){this.loading=new Map;this.loaded=new Set;this.baseUrl=e.endsWith("/")?e:e+"/",this.manager=t,this.fileExtension=a,this.isServerSide=typeof fetch>"u";}async load(e){if(this.loaded.has(e))return;if(this.loading.has(e))return this.loading.get(e);let t=this.doLoad(e);this.loading.set(e,t);try{await t,this.loaded.add(e);}finally{this.loading.delete(e);}}async doLoad(e){try{let t=`${this.baseUrl}${e}.${this.fileExtension}`,a;t.startsWith(".")||t.startsWith("/")||/^[a-zA-Z]:/.test(t)||this.isServerSide?a=await this.loadFromFile(t):a=await this.loadFromUrl(t),a&&this.manager.loadLanguage(e,a);}catch(t){console.warn(`[i18n] Error loading language: ${e}`,t);}}async loadFromUrl(e){try{let t=await fetch(e);return t.ok?await t.json():(console.warn(`[i18n] Failed to load language from URL: ${e} (${t.status})`),null)}catch(t){return console.warn(`[i18n] Error fetching from URL: ${e}`,t),null}}async loadFromFile(e){try{let t=await import('fs').then(s=>s.promises).catch(()=>null),a=await import('path').then(s=>s).catch(()=>null);if(!t)return console.warn("[i18n] fs module not available. Running in browser?"),null;let r=e;if(a&&!a.isAbsolute(e)){let s=await import('process').then(h=>h).catch(()=>null);s&&(r=a.resolve(s.cwd(),e));}let i=await t.readFile(r,"utf-8");return JSON.parse(i)}catch(t){return console.warn(`[i18n] Error reading file: ${e}`,t),null}}isLoaded(e){return this.loaded.has(e)}},g=null,l=null;function w(){return typeof navigator<"u"&&navigator.language?navigator.language.split("-")[0].toLowerCase():"en"}function m(){return typeof fetch<"u"&&typeof window<"u"}function o(){return g||(g=new u),g}function v(){return l}async function b(n){if(m()&&!n.defaultLanguage){let e=w();n.supportedLanguages?.includes(e)?n.defaultLanguage=e:n.defaultLanguage=n.supportedLanguages?.[0]||"en";}if(n.storage||(n.storage=f()),g=new u(n),await g.init(),n.basePath){let e=n.fileExtension||"json";l=new p(n.basePath,g,e),await l.load(g.getLanguage());}return g}var d=(n,e)=>o().t(n,e),C=(n,e,t)=>o().tLang(n,e,t),x=(n,e)=>o().tParse(n,e),S=n=>l&&!l.isLoaded(n)?l.load(n).then(()=>o().setLanguage(n)):o().setLanguage(n),R=()=>o().getLanguage(),T=()=>o().getSupportedLanguages(),I=n=>o().hasKey(n),c=()=>o().isRTL(),P=n=>o().isRTLLanguage(n),$=n=>o().onChange(n),E=(n,e)=>o().loadLanguage(n,e),j=n=>o().loadTranslations(n);function M(n,e="page."){let t=d("app.name"),a=d(e+n);return c()?`${t} - ${a}`:`${a} - ${t}`}function O(n,e,t){return d(n===1?e:t,{count:String(n)})}var A={setupI18n:b,getI18n:o,getLazyLoader:v,I18nManager:u,LazyLoader:p,t:d,tLang:C,tParse:x,setLanguage:S,getLanguage:R,getSupportedLanguages:T,hasKey:I,isRTL:c,isRTLLanguage:P,onChange:$,loadLanguage:E,loadTranslations:j,genPageTitle:M,plural:O};exports.I18nManager=u;exports.LazyLoader=p;exports.default=A;exports.genPageTitle=M;exports.getI18n=o;exports.getLanguage=R;exports.getLazyLoader=v;exports.getSupportedLanguages=T;exports.hasKey=I;exports.isRTL=c;exports.isRTLLanguage=P;exports.loadLanguage=E;exports.loadTranslations=j;exports.onChange=$;exports.plural=O;exports.setLanguage=S;exports.setupI18n=b;exports.t=d;exports.tLang=C;exports.tParse=x;//# sourceMappingURL=index.cjs.map
2
2
  //# sourceMappingURL=index.cjs.map
package/dist/index.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/mod/i18n.ts","../src/index.ts"],"names":["I18nManager","config","stored","lang","translations","flattened","trans","obj","prefix","key","value","newKey","params","translation","param","paramValue","fallback","original","result","tokens","regex","match","fn","callback","createBrowserStorage","createMemoryStorage","store","getDefaultStorage","LazyLoader","baseUrl","manager","fileExtension","promise","filePath","data","error","url","response","fs","m","path","resolvedPath","process","content","instance","lazyLoader","detectBrowserLanguage","isBrowser","getI18n","getLazyLoader","setupI18n","detectedLang","t","tLang","tParse","setLanguage","getLanguage","getSupportedLanguages","hasKey","isRTL","isRTLLanguage","onChange","loadLanguage","loadTranslations","genPageTitle","appName","pageName","plural","count","singleKey","pluralKey","index_default"],"mappings":"sEAgBW,IAAMA,EAAN,KAAkB,CAajB,WAAA,CAAYC,CAAAA,CAA2B,CATvC,IAAA,CAAQ,YAAA,CAA6C,EAAC,CACtD,KAAQ,eAAA,CAA2C,IAAA,CACnD,IAAA,CAAQ,eAAA,CAA2C,KACnD,IAAA,CAAQ,kBAAA,CAAsB,IAAI,GAAA,CAAwB,CAAC,IAAI,CAAC,CAAA,CAChE,IAAA,CAAQ,aAAsB,IAAI,GAAA,CAAY,CAAC,IAAA,CAAM,KAAM,IAAA,CAAM,IAAA,CAAM,IAAA,CAAM,IAAA,CAAM,KAAM,IAAI,CAAC,CAAA,CAC9F,IAAA,CAAQ,UAAsB,IAAI,GAAA,CAK1BA,CAAAA,GACA,IAAA,CAAK,gBAAkBA,CAAAA,CAAO,eAAA,EAAmB,IAAA,CACjD,IAAA,CAAK,gBAAkBA,CAAAA,CAAO,eAAA,EAAmB,IAAA,CACjD,IAAA,CAAK,QAAUA,CAAAA,CAAO,OAAA,CACtB,IAAA,CAAK,gBAAA,CAAmBA,EAAO,gBAAA,CAE3BA,CAAAA,CAAO,kBAAA,GACP,IAAA,CAAK,mBAAqB,IAAI,GAAA,CAAIA,CAAAA,CAAO,kBAAkB,IAGvE,CAKA,MAAa,MAAsB,CAC/B,GAAI,KAAK,OAAA,CAAS,CACd,IAAMC,CAAAA,CAAS,MAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,eAAe,EACjDA,CAAAA,EAAU,IAAA,CAAK,kBAAA,CAAmB,GAAA,CAAIA,CAAM,CAAA,GAC5C,IAAA,CAAK,eAAA,CAAkBA,CAAAA,EAE/B,CACJ,CAaO,YAAA,CAAaC,CAAAA,CAA0BC,CAAAA,CAAyC,CAC9E,IAAA,CAAK,YAAA,CAAaD,CAAI,CAAA,GACvB,KAAK,YAAA,CAAaA,CAAI,CAAA,CAAI,IAG9B,IAAME,CAAAA,CAAY,IAAA,CAAK,aAAA,CAAcD,CAAY,CAAA,CACjD,IAAA,CAAK,YAAA,CAAaD,CAAI,EAAI,CAAE,GAAG,IAAA,CAAK,YAAA,CAAaA,CAAI,CAAA,CAAG,GAAGE,CAAU,CAAA,CACrE,KAAK,kBAAA,CAAmB,GAAA,CAAIF,CAAI,EACpC,CAMO,gBAAA,CAAiBC,CAAAA,CAA0C,CAC9D,MAAA,CAAO,QAAQA,CAAY,CAAA,CAAE,OAAA,CAAQ,CAAC,CAACD,CAAAA,CAAMG,CAAK,CAAA,GAAM,CACpD,KAAK,YAAA,CAAaH,CAAAA,CAAMG,CAAK,EACjC,CAAC,EACL,CAOQ,aAAA,CAAcC,CAAAA,CAA0BC,CAAAA,CAAiB,GAA4B,CACzF,IAAMH,CAAAA,CAAoC,GAE1C,IAAA,IAAWI,CAAAA,IAAOF,CAAAA,CAAK,CACnB,GAAI,CAAC,MAAA,CAAO,SAAA,CAAU,cAAA,CAAe,KAAKA,CAAAA,CAAKE,CAAG,CAAA,CAAG,SAErD,IAAMC,CAAAA,CAAQH,CAAAA,CAAIE,CAAG,CAAA,CACfE,EAASH,CAAAA,CAAS,CAAA,EAAGA,CAAM,CAAA,CAAA,EAAIC,CAAG,CAAA,CAAA,CAAKA,CAAAA,CAEzC,OAAOC,CAAAA,EAAU,UAAYA,CAAAA,GAAU,IAAA,EAAQ,CAAC,KAAA,CAAM,QAAQA,CAAK,CAAA,CACnE,MAAA,CAAO,MAAA,CAAOL,EAAW,IAAA,CAAK,aAAA,CAAcK,CAAAA,CAAOC,CAAM,CAAC,CAAA,CAE1DN,CAAAA,CAAUM,CAAM,CAAA,CAAI,OAAOD,CAAK,EAExC,CAEA,OAAOL,CACX,CAkBO,CAAA,CAAEI,CAAAA,CAAaG,CAAAA,CAAyC,CAC3D,IAAIC,CAAAA,CAAc,IAAA,CAAK,cAAA,CAAeJ,CAAG,CAAA,CAEzC,OAAIG,GACA,MAAA,CAAO,OAAA,CAAQA,CAAM,CAAA,CAAE,OAAA,CAAQ,CAAC,CAACE,EAAOJ,CAAK,CAAA,GAAM,CAE/C,IAAMK,EAAa,IAAA,CAAK,cAAA,CAAeL,CAAAA,CAAOA,CAAK,EACnDG,CAAAA,CAAcA,CAAAA,CAAY,OAAA,CACtB,IAAI,OAAO,CAAA,GAAA,EAAMC,CAAK,CAAA,GAAA,CAAA,CAAO,GAAG,EAChCC,CACJ,EACJ,CAAC,CAAA,CAGEF,CACX,CAMQ,cAAA,CAAeJ,CAAAA,CAAaO,CAAAA,CAA2B,CAE3D,OAAI,IAAA,CAAK,YAAA,CAAa,IAAA,CAAK,eAAe,CAAA,GAAIP,CAAG,CAAA,CACtC,IAAA,CAAK,aAAa,IAAA,CAAK,eAAe,CAAA,CAAEA,CAAG,EAIlD,IAAA,CAAK,eAAA,GAAoB,IAAA,CAAK,eAAA,EAC9B,KAAK,YAAA,CAAa,IAAA,CAAK,eAAe,CAAA,GAAIA,CAAG,CAAA,CACtC,IAAA,CAAK,YAAA,CAAa,IAAA,CAAK,eAAe,CAAA,CAAEA,CAAG,CAAA,EAItD,OAAA,CAAQ,KAAK,CAAA,mCAAA,EAAsCA,CAAG,CAAA,SAAA,EAAY,IAAA,CAAK,eAAe,CAAA,CAAA,CAAG,CAAA,CAClFO,GAAYP,CAAAA,CACvB,CASO,MAAMA,CAAAA,CAAaN,CAAAA,CAA0BS,CAAAA,CAAyC,CACzF,IAAMK,CAAAA,CAAW,IAAA,CAAK,eAAA,CACtB,IAAA,CAAK,gBAAkBd,CAAAA,CACvB,IAAMe,CAAAA,CAAS,IAAA,CAAK,EAAET,CAAAA,CAAKG,CAAM,CAAA,CACjC,OAAA,IAAA,CAAK,gBAAkBK,CAAAA,CAChBC,CACX,CAoBO,MAAA,CAAOT,EAAaG,CAAAA,CAA2D,CAClF,IAAIC,CAAAA,CAAc,KAAK,CAAA,CAAEJ,CAAAA,CAAKG,CAAM,CAAA,CAGpCC,EAAcA,CAAAA,CAAY,OAAA,CAAQ,UAAA,CAAY,MAAM,EAEpD,IAAMM,CAAAA,CAAmC,EAAC,CACpCC,EAAQ,oDAAA,CACVC,CAAAA,CAEJ,KAAA,CAAQA,CAAAA,CAAQD,EAAM,IAAA,CAAKP,CAAW,CAAA,IAAO,IAAA,EACrCQ,EAAM,CAAC,CAAA,CAEPF,CAAAA,CAAO,IAAA,CAAK,CAAE,IAAA,CAAM,MAAA,CAAQ,OAAA,CAASE,CAAAA,CAAM,CAAC,CAAE,CAAC,CAAA,CACxCA,CAAAA,CAAM,CAAC,CAAA,CAEdF,CAAAA,CAAO,IAAA,CAAK,CAAE,KAAM,KAAA,CAAO,GAAA,CAAKE,EAAM,CAAC,CAAA,CAAG,QAASA,CAAAA,CAAM,CAAC,CAAE,CAAC,EACtDA,CAAAA,CAAM,CAAC,CAAA,EAEdF,CAAAA,CAAO,KAAK,CAAE,IAAA,CAAM,KAAA,CAAO,GAAA,CAAKE,EAAM,CAAC,CAAA,CAAG,OAAA,CAAS,EAAG,CAAC,CAAA,CAI/D,OAAOF,CAAAA,CAAO,MAAA,CAAS,EAAIA,CAAAA,CAAS,CAAC,CAAE,IAAA,CAAM,OAAQ,OAAA,CAASN,CAAY,CAAC,CAC/E,CAUA,MAAa,WAAA,CAAYV,CAAAA,CAAyC,CAC9D,GAAI,CAAC,IAAA,CAAK,kBAAA,CAAmB,GAAA,CAAIA,CAAI,CAAA,CAAG,CACpC,OAAA,CAAQ,IAAA,CAAK,oBAAoBA,CAAI,CAAA,eAAA,CAAiB,CAAA,CACtD,MACJ,CAEA,IAAA,CAAK,eAAA,CAAkBA,CAAAA,CAGnB,IAAA,CAAK,SACL,MAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,gBAAiBA,CAAI,CAAA,CAIhD,IAAA,CAAK,SAAA,CAAU,QAAQmB,CAAAA,EAAMA,CAAAA,CAAGnB,CAAI,CAAC,EAEjC,IAAA,CAAK,gBAAA,EACL,KAAK,gBAAA,CAAiBA,CAAI,EAElC,CAKO,WAAA,EAAkC,CACrC,OAAO,KAAK,eAChB,CAKO,qBAAA,EAA8C,CACjD,OAAO,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,kBAAkB,CAC7C,CAKO,mBAAA,CAAoBA,CAAAA,CAAmC,CAC1D,OAAO,IAAA,CAAK,kBAAA,CAAmB,GAAA,CAAIA,CAAI,CAC3C,CAUO,MAAA,CAAOM,CAAAA,CAAsB,CAChC,OAAO,CAAC,EACJ,IAAA,CAAK,YAAA,CAAa,KAAK,eAAe,CAAA,GAAIA,CAAG,CAAA,EAC7C,KAAK,YAAA,CAAa,IAAA,CAAK,eAAe,CAAA,GAAIA,CAAG,CAAA,CAErD,CAKO,eAAA,EAA0C,CAC7C,OAAO,IAAA,CAAK,YAAA,CAAa,IAAA,CAAK,eAAe,GAAK,EACtD,CAKO,KAAA,EAAiB,CACpB,OAAO,IAAA,CAAK,YAAA,CAAa,GAAA,CAAI,KAAK,eAAA,CAAgB,WAAA,EAAY,CAAE,SAAA,CAAU,EAAG,CAAC,CAAC,CACnF,CAKO,cAAcN,CAAAA,CAAmC,CACpD,OAAO,IAAA,CAAK,YAAA,CAAa,IAAIA,CAAAA,CAAK,WAAA,EAAY,CAAE,SAAA,CAAU,EAAG,CAAC,CAAC,CACnE,CAMO,SAASoB,CAAAA,CAA0D,CACtE,OAAA,IAAA,CAAK,SAAA,CAAU,IAAIA,CAAQ,CAAA,CACpB,IAAM,IAAA,CAAK,UAAU,MAAA,CAAOA,CAAQ,CAC/C,CAIR,EC3SA,IAAMC,CAAAA,CAAuB,KAA0B,CACnD,IAAMf,CAAAA,EACE,OAAO,YAAA,CAAiB,GAAA,CAAoB,KACzC,YAAA,CAAa,OAAA,CAAQA,CAAG,CAAA,CAEnC,GAAA,CAAK,CAACA,CAAAA,CAAaC,CAAAA,GAAkB,CAC7B,OAAO,aAAiB,GAAA,EACxB,YAAA,CAAa,OAAA,CAAQD,CAAAA,CAAKC,CAAK,EAEvC,CACJ,CAAA,CAAA,CAKMe,CAAAA,CAAsB,IAAyB,CACjD,IAAMC,CAAAA,CAAQ,IAAI,IAClB,OAAO,CACH,GAAA,CAAMjB,CAAAA,EAAgBiB,EAAM,GAAA,CAAIjB,CAAG,CAAA,EAAK,IAAA,CACxC,IAAK,CAACA,CAAAA,CAAaC,CAAAA,GAAkB,CAAEgB,EAAM,GAAA,CAAIjB,CAAAA,CAAKC,CAAK,EAAG,CAClE,CACJ,CAAA,CAKMiB,CAAAA,CAAoB,IACf,OAAO,aAAiB,GAAA,CAAcH,CAAAA,EAAqB,CAAIC,CAAAA,GAO7DG,CAAAA,CAAN,KAAiB,CAQpB,WAAA,CAAYC,EAAiBC,CAAAA,CAAsBC,CAAAA,CAAwB,MAAA,CAAQ,CALnF,KAAQ,OAAA,CAAU,IAAI,GAAA,CACtB,IAAA,CAAQ,OAAS,IAAI,GAAA,CAKjB,IAAA,CAAK,OAAA,CAAUF,EAAQ,QAAA,CAAS,GAAG,CAAA,CAAIA,CAAAA,CAAUA,EAAU,GAAA,CAC3D,IAAA,CAAK,OAAA,CAAUC,CAAAA,CACf,KAAK,aAAA,CAAgBC,CAAAA,CACrB,IAAA,CAAK,YAAA,CAAe,OAAO,KAAA,CAAU,IACzC,CAMA,MAAM,KAAK5B,CAAAA,CAAyC,CAEhD,GAAI,IAAA,CAAK,OAAO,GAAA,CAAIA,CAAI,CAAA,CACpB,OAIJ,GAAI,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAIA,CAAI,EACrB,OAAO,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAIA,CAAI,CAAA,CAIhC,IAAM6B,CAAAA,CAAU,IAAA,CAAK,OAAO7B,CAAI,CAAA,CAChC,KAAK,OAAA,CAAQ,GAAA,CAAIA,EAAM6B,CAAO,CAAA,CAE9B,GAAI,CACA,MAAMA,CAAAA,CACN,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI7B,CAAI,EACxB,CAAA,OAAE,CACE,IAAA,CAAK,QAAQ,MAAA,CAAOA,CAAI,EAC5B,CACJ,CAEA,MAAc,MAAA,CAAOA,CAAAA,CAAyC,CAC1D,GAAI,CACA,IAAM8B,CAAAA,CAAW,CAAA,EAAG,KAAK,OAAO,CAAA,EAAG9B,CAAI,CAAA,CAAA,EAAI,KAAK,aAAa,CAAA,CAAA,CAEzD+B,CAAAA,CAGgBD,CAAAA,CAAS,WAAW,GAAG,CAAA,EAAKA,CAAAA,CAAS,UAAA,CAAW,GAAG,CAAA,EAAK,YAAA,CAAa,IAAA,CAAKA,CAAQ,GAEnF,IAAA,CAAK,YAAA,CAEpBC,CAAAA,CAAO,MAAM,KAAK,YAAA,CAAaD,CAAQ,CAAA,CAGvCC,CAAAA,CAAO,MAAM,IAAA,CAAK,WAAA,CAAYD,CAAQ,CAAA,CAGtCC,GAEA,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa/B,CAAAA,CAAM+B,CAA2B,EAEnE,CAAA,MAASC,CAAAA,CAAO,CACZ,QAAQ,IAAA,CAAK,CAAA,+BAAA,EAAkChC,CAAI,CAAA,CAAA,CAAIgC,CAAK,EAChE,CACJ,CAEA,MAAc,WAAA,CAAYC,EAAqD,CAC3E,GAAI,CACA,IAAMC,EAAW,MAAM,KAAA,CAAMD,CAAG,CAAA,CAEhC,OAAIC,CAAAA,CAAS,EAAA,CACF,MAAMA,CAAAA,CAAS,MAAK,EAE3B,OAAA,CAAQ,IAAA,CAAK,CAAA,yCAAA,EAA4CD,CAAG,CAAA,EAAA,EAAKC,CAAAA,CAAS,MAAM,CAAA,CAAA,CAAG,EAC5E,IAAA,CAEf,CAAA,MAASF,CAAAA,CAAO,CACZ,eAAQ,IAAA,CAAK,CAAA,gCAAA,EAAmCC,CAAG,CAAA,CAAA,CAAID,CAAK,CAAA,CACrD,IACX,CACJ,CAEA,MAAc,YAAA,CAAaF,CAAAA,CAA0D,CACjF,GAAI,CAGA,IAAMK,CAAAA,CAAK,MAAM,OAAO,IAAI,CAAA,CAAE,IAAA,CAAKC,CAAAA,EAAKA,CAAAA,CAAE,QAAQ,CAAA,CAAE,KAAA,CAAM,IAAW,IAAI,EAEnEC,CAAAA,CAAO,MAAM,OAAO,MAAM,EAAE,IAAA,CAAKD,CAAAA,EAAKA,CAAC,CAAA,CAAE,MAAM,IAAW,IAAI,EAEpE,GAAI,CAACD,EACD,OAAA,OAAA,CAAQ,IAAA,CAAK,qDAAqD,CAAA,CAC3D,KAIX,IAAIG,CAAAA,CAAeR,CAAAA,CACnB,GAAIO,GAAQ,CAACA,CAAAA,CAAK,UAAA,CAAWP,CAAQ,EAAG,CAEpC,IAAMS,CAAAA,CAAU,aAAa,SAAS,CAAA,CAAE,IAAA,CAAKH,CAAAA,EAAKA,CAAC,CAAA,CAAE,KAAA,CAAM,IAAW,IAAI,EACtEG,CAAAA,GACAD,CAAAA,CAAeD,CAAAA,CAAK,OAAA,CAAQE,EAAQ,GAAA,EAAI,CAAGT,CAAQ,CAAA,EAE3D,CAEA,IAAMU,CAAAA,CAAU,MAAML,CAAAA,CAAG,QAAA,CAASG,EAAc,OAAO,CAAA,CACvD,OAAO,IAAA,CAAK,MAAME,CAAO,CAC7B,CAAA,MAASR,CAAAA,CAAO,CACZ,OAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,2BAAA,EAA8BF,CAAQ,GAAIE,CAAK,CAAA,CACrD,IACX,CACJ,CAEA,QAAA,CAAShC,CAAAA,CAAmC,CACxC,OAAO,KAAK,MAAA,CAAO,GAAA,CAAIA,CAAI,CAC/B,CACJ,CAAA,CAQIyC,CAAAA,CAA+B,KAC/BC,CAAAA,CAAgC,KAOpC,SAASC,CAAAA,EAAgC,CACrC,OAAI,OAAO,UAAc,GAAA,EAAe,SAAA,CAAU,QAAA,CACvC,SAAA,CAAU,SAAS,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,EAAE,WAAA,EAAY,CAEjD,IACX,CAMA,SAASC,CAAAA,EAAqB,CAC1B,OAAO,OAAO,MAAU,GAAA,EAAe,OAAO,MAAA,CAAW,GAC7D,CAKO,SAASC,CAAAA,EAAuB,CACnC,OAAKJ,IACDA,CAAAA,CAAW,IAAI5C,CAAAA,CAAAA,CAEZ4C,CACX,CAKO,SAASK,CAAAA,EAAmC,CAC/C,OAAOJ,CACX,CA0BA,eAAsBK,CAAAA,CAClBjD,CAAAA,CACoB,CAEpB,GAAI8C,CAAAA,EAAU,EAAK,CAAC9C,EAAO,eAAA,CAAiB,CACxC,IAAMkD,CAAAA,CAAeL,GAAsB,CACvC7C,CAAAA,CAAO,kBAAA,EAAoB,QAAA,CAASkD,CAAY,CAAA,CAChDlD,CAAAA,CAAO,eAAA,CAAkBkD,CAAAA,CAEzBlD,EAAO,eAAA,CAAkBA,CAAAA,CAAO,kBAAA,GAAqB,CAAC,GAAK,KAEnE,CAYA,GATKA,CAAAA,CAAO,OAAA,GACRA,EAAO,OAAA,CAAU0B,CAAAA,EAAkB,CAAA,CAIvCiB,CAAAA,CAAW,IAAI5C,CAAAA,CAAYC,CAAM,CAAA,CACjC,MAAM2C,EAAS,IAAA,EAAK,CAGhB3C,CAAAA,CAAO,QAAA,CAAU,CACjB,IAAM8B,CAAAA,CAAgB9B,CAAAA,CAAO,aAAA,EAAiB,OAC9C4C,CAAAA,CAAa,IAAIjB,CAAAA,CAAW3B,CAAAA,CAAO,SAAU2C,CAAAA,CAAUb,CAAa,CAAA,CACpE,MAAMc,EAAW,IAAA,CAAKD,CAAAA,CAAS,WAAA,EAAa,EAChD,CAEA,OAAOA,CACX,KAWaQ,CAAAA,CAAI,CAAC3C,CAAAA,CAAaG,CAAAA,GAC3BoC,GAAQ,CAAE,CAAA,CAAEvC,CAAAA,CAAKG,CAAM,EAKdyC,CAAAA,CAAQ,CAAC5C,CAAAA,CAAaN,CAAAA,CAA0BS,IACzDoC,CAAAA,EAAQ,CAAE,KAAA,CAAMvC,CAAAA,CAAKN,EAAMS,CAAM,CAAA,CAKxB0C,CAAAA,CAAS,CAAC7C,EAAaG,CAAAA,GAChCoC,CAAAA,EAAQ,CAAE,MAAA,CAAOvC,EAAKG,CAAM,CAAA,CAKnB2C,CAAAA,CAAc,MAAOpD,GAE1B0C,CAAAA,EAAc,CAACA,EAAW,QAAA,CAAS1C,CAAI,EAChC0C,CAAAA,CAAW,IAAA,CAAK1C,CAAI,CAAA,CAAE,KAAK,IAAM6C,CAAAA,EAAQ,CAAE,WAAA,CAAY7C,CAAI,CAAC,CAAA,CAEhE6C,CAAAA,EAAQ,CAAE,YAAY7C,CAAI,CAAA,CAMxBqD,CAAAA,CAAc,IACvBR,GAAQ,CAAE,WAAA,EAAY,CAKbS,CAAAA,CAAwB,IACjCT,CAAAA,EAAQ,CAAE,qBAAA,EAAsB,CAKvBU,EAAUjD,CAAAA,EACnBuC,CAAAA,EAAQ,CAAE,MAAA,CAAOvC,CAAG,CAAA,CAKXkD,CAAAA,CAAQ,IACjBX,CAAAA,GAAU,KAAA,EAAM,CAKPY,CAAAA,CAAiBzD,CAAAA,EAC1B6C,GAAQ,CAAE,aAAA,CAAc7C,CAAI,CAAA,CAKnB0D,EAAYtC,CAAAA,EACrByB,CAAAA,EAAQ,CAAE,QAAA,CAASzB,CAAQ,CAAA,CAMlBuC,CAAAA,CAAe,CAAC3D,CAAAA,CAA0BC,IACnD4C,CAAAA,EAAQ,CAAE,YAAA,CAAa7C,CAAAA,CAAMC,CAAY,CAAA,CAKhC2D,CAAAA,CAAoB3D,CAAAA,EAC7B4C,CAAAA,GAAU,gBAAA,CAAiB5C,CAAY,EAepC,SAAS4D,EAAavD,CAAAA,CAAaD,CAAAA,CAAiB,QAAiB,CACxE,IAAMyD,EAAUb,CAAAA,CAAE,UAAU,CAAA,CACtBc,CAAAA,CAAWd,EAAE5C,CAAAA,CAASC,CAAG,CAAA,CAC/B,OAAOkD,GAAM,CAAI,CAAA,EAAGM,CAAO,CAAA,GAAA,EAAMC,CAAQ,CAAA,CAAA,CAAK,CAAA,EAAGA,CAAQ,CAAA,GAAA,EAAMD,CAAO,CAAA,CAC1E,CASO,SAASE,CAAAA,CAAOC,EAAeC,CAAAA,CAAmBC,CAAAA,CAA2B,CAEhF,OAAOlB,EADKgB,CAAAA,GAAU,CAAA,CAAIC,CAAAA,CAAYC,CAAAA,CACxB,CAAE,KAAA,CAAO,MAAA,CAAOF,CAAK,CAAE,CAAC,CAC1C,CAQA,IAAOG,CAAAA,CAAQ,CACX,UAAArB,CAAAA,CACA,OAAA,CAAAF,CAAAA,CACA,aAAA,CAAAC,EACA,WAAA,CAAAjD,CAAAA,CACA,UAAA,CAAA4B,CAAAA,CACA,EAAAwB,CAAAA,CACA,KAAA,CAAAC,CAAAA,CACA,MAAA,CAAAC,EACA,WAAA,CAAAC,CAAAA,CACA,WAAA,CAAAC,CAAAA,CACA,sBAAAC,CAAAA,CACA,MAAA,CAAAC,CAAAA,CACA,KAAA,CAAAC,EACA,aAAA,CAAAC,CAAAA,CACA,QAAA,CAAAC,CAAAA,CACA,aAAAC,CAAAA,CACA,gBAAA,CAAAC,EACA,YAAA,CAAAC,CAAAA,CACA,OAAAG,CACJ","file":"index.cjs","sourcesContent":["// src/mod/i18n.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n import * as types from '../types';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n export class I18nManager {\r\n\r\n // ┌──────────────────────────────── INIT ──────────────────────────────┐\r\n\r\n private translations : types.TranslationSet = {};\r\n private currentLanguage : types.LanguageCode = 'en';\r\n private defaultLanguage : types.LanguageCode = 'en';\r\n private supportedLanguages = new Set<types.LanguageCode>(['en']);\r\n private rtlLanguages = new Set<string>(['ar', 'he', 'fa', 'ur', 'yi', 'ji', 'iw', 'ku']);\r\n private listeners = new Set<(lang: types.LanguageCode) => void>();\r\n private storage? : types.I18nStorage;\r\n private onLanguageChange? : (lang: types.LanguageCode) => void;\r\n\r\n constructor(config?: types.I18nConfig) {\r\n if (config) {\r\n this.defaultLanguage = config.defaultLanguage || 'en';\r\n this.currentLanguage = config.defaultLanguage || 'en';\r\n this.storage = config.storage;\r\n this.onLanguageChange = config.onLanguageChange;\r\n\r\n if (config.supportedLanguages) {\r\n this.supportedLanguages = new Set(config.supportedLanguages);\r\n }\r\n }\r\n }\r\n\r\n /**\r\n * Initialize with stored language preference\r\n */\r\n public async init(): Promise<void> {\r\n if (this.storage) {\r\n const stored = await this.storage.get('i18n-language');\r\n if (stored && this.supportedLanguages.has(stored)) {\r\n this.currentLanguage = stored;\r\n }\r\n }\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌──────────────────────────────── LOAD ──────────────────────────────┐\r\n\r\n /**\r\n * Load translations for a specific language\r\n * @param lang Language code\r\n * @param translations Translation object (can be nested)\r\n */\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n public loadLanguage(lang: types.LanguageCode, translations: Record<string, any>): void {\r\n if (!this.translations[lang]) {\r\n this.translations[lang] = {};\r\n }\r\n\r\n const flattened = this.flattenObject(translations);\r\n this.translations[lang] = { ...this.translations[lang], ...flattened };\r\n this.supportedLanguages.add(lang);\r\n }\r\n\r\n /**\r\n * Load multiple languages at once\r\n * @param translations Object with language codes as keys\r\n */\r\n public loadTranslations(translations: types.TranslationSet): void {\r\n Object.entries(translations).forEach(([lang, trans]) => {\r\n this.loadLanguage(lang, trans);\r\n });\r\n }\r\n\r\n /**\r\n * Flatten nested object into dot notation\r\n * @private\r\n */\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n private flattenObject(obj: Record<string, any>, prefix: string = ''): Record<string, string> {\r\n const flattened: Record<string, string> = {};\r\n\r\n for (const key in obj) {\r\n if (!Object.prototype.hasOwnProperty.call(obj, key)) continue;\r\n\r\n const value = obj[key];\r\n const newKey = prefix ? `${prefix}.${key}` : key;\r\n\r\n if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\r\n Object.assign(flattened, this.flattenObject(value, newKey));\r\n } else {\r\n flattened[newKey] = String(value);\r\n }\r\n }\r\n\r\n return flattened;\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌───────────────────────────── TRANSLATION ──────────────────────────┐\r\n\r\n /**\r\n * Translate a key with parameter replacement\r\n *\r\n * @example\r\n * t('welcome.message', { name: 'John' })\r\n * // => \"Welcome, John!\"\r\n *\r\n * @param key Translation key (dot notation)\r\n * @param params Optional parameters for replacement\r\n * @returns Translated string\r\n */\r\n public t(key: string, params?: Record<string, string>): string {\r\n let translation = this.getTranslation(key);\r\n\r\n if (params) {\r\n Object.entries(params).forEach(([param, value]) => {\r\n // Check if parameter value is itself a translation key\r\n const paramValue = this.getTranslation(value, value);\r\n translation = translation.replace(\r\n new RegExp(`\\\\{${param}\\\\}`, 'g'),\r\n paramValue\r\n );\r\n });\r\n }\r\n\r\n return translation;\r\n }\r\n\r\n /**\r\n * Get raw translation without parameter replacement\r\n * @private\r\n */\r\n private getTranslation(key: string, fallback?: string): string {\r\n // Try current language\r\n if (this.translations[this.currentLanguage]?.[key]) {\r\n return this.translations[this.currentLanguage][key];\r\n }\r\n\r\n // Try default language\r\n if (this.defaultLanguage !== this.currentLanguage &&\r\n this.translations[this.defaultLanguage]?.[key]) {\r\n return this.translations[this.defaultLanguage][key];\r\n }\r\n\r\n // Warn and return fallback\r\n console.warn(`[i18n] Translation key not found: \"${key}\" (lang: ${this.currentLanguage})`);\r\n return fallback || key;\r\n }\r\n\r\n /**\r\n * Translate with a specific language temporarily\r\n *\r\n * @param key Translation key\r\n * @param lang Language code\r\n * @param params Optional parameters\r\n */\r\n public tLang(key: string, lang: types.LanguageCode, params?: Record<string, string>): string {\r\n const original = this.currentLanguage;\r\n this.currentLanguage = lang;\r\n const result = this.t(key, params);\r\n this.currentLanguage = original;\r\n return result;\r\n }\r\n\r\n /**\r\n * Translate and parse HTML-like tags into tokens\r\n * Converts \\n or /n to line breaks\r\n *\r\n * @example\r\n * // Translation: \"Hello\\nWorld <strong>here</strong>\"\r\n * tParse('message')\r\n * // => [\r\n * // { type: 'text', content: 'Hello' },\r\n * // { type: 'tag', tag: 'br', content: '' },\r\n * // { type: 'text', content: 'World ' },\r\n * // { type: 'tag', tag: 'strong', content: 'here' }\r\n * // ]\r\n *\r\n * @param key Translation key\r\n * @param params Optional parameters\r\n * @returns Array of tokens\r\n */\r\n public tParse(key: string, params?: Record<string, string>): types.TranslationToken[] {\r\n let translation = this.t(key, params);\r\n\r\n // Convert newlines to <br> tags\r\n translation = translation.replace(/\\\\n|\\/n/g, '<br>');\r\n\r\n const tokens: types.TranslationToken[] = [];\r\n const regex = /<([a-z]+)>([^<]*)<\\/\\1>|<([a-z]+)\\s*\\/?>|([^<]+)/gi;\r\n let match;\r\n\r\n while ((match = regex.exec(translation)) !== null) {\r\n if (match[4]) {\r\n // Plain text\r\n tokens.push({ type: 'text', content: match[4] });\r\n } else if (match[1]) {\r\n // Paired tag: <strong>text</strong>\r\n tokens.push({ type: 'tag', tag: match[1], content: match[2] });\r\n } else if (match[3]) {\r\n // Self-closing: <br> or <br/>\r\n tokens.push({ type: 'tag', tag: match[3], content: '' });\r\n }\r\n }\r\n\r\n return tokens.length > 0 ? tokens : [{ type: 'text', content: translation }];\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌────────────────────────────── LANGUAGE ────────────────────────────┐\r\n\r\n /**\r\n * Set current language\r\n */\r\n public async setLanguage(lang: types.LanguageCode): Promise<void> {\r\n if (!this.supportedLanguages.has(lang)) {\r\n console.warn(`[i18n] Language \"${lang}\" not supported`);\r\n return;\r\n }\r\n\r\n this.currentLanguage = lang;\r\n\r\n // Persist if storage available\r\n if (this.storage) {\r\n await this.storage.set('i18n-language', lang);\r\n }\r\n\r\n // Notify listeners\r\n this.listeners.forEach(fn => fn(lang));\r\n\r\n if (this.onLanguageChange) {\r\n this.onLanguageChange(lang);\r\n }\r\n }\r\n\r\n /**\r\n * Get current language\r\n */\r\n public getLanguage(): types.LanguageCode {\r\n return this.currentLanguage;\r\n }\r\n\r\n /**\r\n * Get all supported languages\r\n */\r\n public getSupportedLanguages(): types.LanguageCode[] {\r\n return Array.from(this.supportedLanguages);\r\n }\r\n\r\n /**\r\n * Check if language is supported\r\n */\r\n public isLanguageSupported(lang: types.LanguageCode): boolean {\r\n return this.supportedLanguages.has(lang);\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌─────────────────────────────── HELPERS ────────────────────────────┐\r\n\r\n /**\r\n * Check if a translation key exists\r\n */\r\n public hasKey(key: string): boolean {\r\n return !!(\r\n this.translations[this.currentLanguage]?.[key] ||\r\n this.translations[this.defaultLanguage]?.[key]\r\n );\r\n }\r\n\r\n /**\r\n * Get all translations for current language\r\n */\r\n public getTranslations(): Record<string, string> {\r\n return this.translations[this.currentLanguage] || {};\r\n }\r\n\r\n /**\r\n * Check if current language is RTL\r\n */\r\n public isRTL(): boolean {\r\n return this.rtlLanguages.has(this.currentLanguage.toLowerCase().substring(0, 2));\r\n }\r\n\r\n /**\r\n * Check if specific language is RTL\r\n */\r\n public isRTLLanguage(lang: types.LanguageCode): boolean {\r\n return this.rtlLanguages.has(lang.toLowerCase().substring(0, 2));\r\n }\r\n\r\n /**\r\n * Subscribe to language changes\r\n * @returns Unsubscribe function\r\n */\r\n public onChange(callback: (lang: types.LanguageCode) => void): () => void {\r\n this.listeners.add(callback);\r\n return () => this.listeners.delete(callback);\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n","// src/index.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n import * as types from './types';\r\n import { I18nManager } from './mod/i18n';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ ════ ════════════════════════════════════════╗\r\n\r\n /**\r\n * Storage adapter for browser (localStorage)\r\n */\r\n const createBrowserStorage = (): types.I18nStorage => ({\r\n get: (key: string) => {\r\n if (typeof localStorage === 'undefined') return null;\r\n return localStorage.getItem(key);\r\n },\r\n set: (key: string, value: string) => {\r\n if (typeof localStorage !== 'undefined') {\r\n localStorage.setItem(key, value);\r\n }\r\n }\r\n });\r\n\r\n /**\r\n * Storage adapter for memory (in-process storage)\r\n */\r\n const createMemoryStorage = (): types.I18nStorage => {\r\n const store = new Map<string, string>();\r\n return {\r\n get: (key: string) => store.get(key) || null,\r\n set: (key: string, value: string) => { store.set(key, value); }\r\n };\r\n };\r\n\r\n /**\r\n * Auto-select appropriate storage based on environment\r\n */\r\n const getDefaultStorage = (): types.I18nStorage => {\r\n return typeof localStorage !== 'undefined' ? createBrowserStorage() : createMemoryStorage();\r\n };\r\n\r\n /**\r\n * Lazy loader: fetch language on-demand\r\n * Supports both URL-based (browser) and file-based (server) loading\r\n */\r\n export class LazyLoader {\r\n private baseUrl: string;\r\n private manager: I18nManager;\r\n private loading = new Map<types.LanguageCode, Promise<void>>();\r\n private loaded = new Set<types.LanguageCode>();\r\n private isServerSide: boolean;\r\n private fileExtension: string;\r\n\r\n constructor(baseUrl: string, manager: I18nManager, fileExtension: string = 'json') {\r\n this.baseUrl = baseUrl.endsWith('/') ? baseUrl : baseUrl + '/';\r\n this.manager = manager;\r\n this.fileExtension = fileExtension;\r\n this.isServerSide = typeof fetch === 'undefined';\r\n }\r\n\r\n /**\r\n * Load a language file on-demand\r\n * Caches the promise to prevent duplicate requests\r\n */\r\n async load(lang: types.LanguageCode): Promise<void> {\r\n // Already loaded\r\n if (this.loaded.has(lang)) {\r\n return;\r\n }\r\n\r\n // Currently loading\r\n if (this.loading.has(lang)) {\r\n return this.loading.get(lang);\r\n }\r\n\r\n // Start loading\r\n const promise = this.doLoad(lang);\r\n this.loading.set(lang, promise);\r\n\r\n try {\r\n await promise;\r\n this.loaded.add(lang);\r\n } finally {\r\n this.loading.delete(lang);\r\n }\r\n }\r\n\r\n private async doLoad(lang: types.LanguageCode): Promise<void> {\r\n try {\r\n const filePath = `${this.baseUrl}${lang}.${this.fileExtension}`;\r\n\r\n let data: Record<string, string> | null;\r\n\r\n // Check if it's a local file path (relative or absolute)\r\n const isLocalPath = filePath.startsWith('.') || filePath.startsWith('/') || /^[a-zA-Z]:/.test(filePath);\r\n\r\n if (isLocalPath || this.isServerSide) {\r\n // Node.js/local: Read from filesystem\r\n data = await this.loadFromFile(filePath);\r\n } else {\r\n // Browser: Fetch from URL\r\n data = await this.loadFromUrl(filePath);\r\n }\r\n\r\n if (data) {\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n this.manager.loadLanguage(lang, data as Record<string, any>);\r\n }\r\n } catch (error) {\r\n console.warn(`[i18n] Error loading language: ${lang}`, error);\r\n }\r\n }\r\n\r\n private async loadFromUrl(url: string): Promise<Record<string, string> | null> {\r\n try {\r\n const response = await fetch(url);\r\n\r\n if (response.ok) {\r\n return await response.json();\r\n } else {\r\n console.warn(`[i18n] Failed to load language from URL: ${url} (${response.status})`);\r\n return null;\r\n }\r\n } catch (error) {\r\n console.warn(`[i18n] Error fetching from URL: ${url}`, error);\r\n return null;\r\n }\r\n }\r\n\r\n private async loadFromFile(filePath: string): Promise<Record<string, string> | null> {\r\n try {\r\n // Dynamic import to avoid issues in browsers\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n const fs = await import('fs').then(m => m.promises).catch((): any => null);\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n const path = await import('path').then(m => m).catch((): any => null);\r\n\r\n if (!fs) {\r\n console.warn('[i18n] fs module not available. Running in browser?');\r\n return null;\r\n }\r\n\r\n // Resolve relative paths to absolute paths\r\n let resolvedPath = filePath;\r\n if (path && !path.isAbsolute(filePath)) {\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n const process = await import('process').then(m => m).catch((): any => null);\r\n if (process) {\r\n resolvedPath = path.resolve(process.cwd(), filePath);\r\n }\r\n }\r\n\r\n const content = await fs.readFile(resolvedPath, 'utf-8');\r\n return JSON.parse(content);\r\n } catch (error) {\r\n console.warn(`[i18n] Error reading file: ${filePath}`, error);\r\n return null;\r\n }\r\n }\r\n\r\n isLoaded(lang: types.LanguageCode): boolean {\r\n return this.loaded.has(lang);\r\n }\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ ════ ════════════════════════════════════════╗\r\n\r\n let instance: I18nManager | null = null;\r\n let lazyLoader: LazyLoader | null = null;\r\n\r\n /**\r\n * Get browser language preference\r\n * Uses navigator.language if available (browser environment)\r\n * @private\r\n */\r\n function detectBrowserLanguage(): string {\r\n if (typeof navigator !== 'undefined' && navigator.language) {\r\n return navigator.language.split('-')[0].toLowerCase();\r\n }\r\n return 'en';\r\n }\r\n\r\n /**\r\n * Check if running in browser environment\r\n * @private\r\n */\r\n function isBrowser(): boolean {\r\n return typeof fetch !== 'undefined' && typeof window !== 'undefined';\r\n }\r\n\r\n /**\r\n * Get or create the global i18n instance\r\n */\r\n export function getI18n(): I18nManager {\r\n if (!instance) {\r\n instance = new I18nManager();\r\n }\r\n return instance;\r\n }\r\n\r\n /**\r\n * Get the lazy loader instance (only available after setupI18n with basePath)\r\n */\r\n export function getLazyLoader(): LazyLoader | null {\r\n return lazyLoader;\r\n }\r\n\r\n /**\r\n * Main setup function - Single, simple, auto-detecting initialization\r\n *\r\n * Auto-detects environment and handles both browser and server:\r\n * - Browser: Auto-detects language, loads from URL path\r\n * - Server: Uses defaultLanguage, loads from file system\r\n *\r\n * Call this ONCE at app startup.\r\n *\r\n * @example\r\n * // Browser - Auto-detects language, lazy-loads from URL\r\n * await setupI18n({\r\n * supportedLanguages: ['en', 'ar', 'fr'],\r\n * basePath: '/i18n/'\r\n * });\r\n *\r\n * @example\r\n * // Server - Uses default language, lazy-loads from filesystem\r\n * await setupI18n({\r\n * defaultLanguage: 'en',\r\n * supportedLanguages: ['en', 'ar', 'fr'],\r\n * basePath: './locales/'\r\n * });\r\n */\r\n export async function setupI18n(\r\n config: types.I18nConfig & { basePath?: string }\r\n ): Promise<I18nManager> {\r\n // Auto-detect browser language if in browser and no defaultLanguage specified\r\n if (isBrowser() && !config.defaultLanguage) {\r\n const detectedLang = detectBrowserLanguage();\r\n if (config.supportedLanguages?.includes(detectedLang)) {\r\n config.defaultLanguage = detectedLang;\r\n } else {\r\n config.defaultLanguage = config.supportedLanguages?.[0] || 'en';\r\n }\r\n }\r\n\r\n // Use appropriate storage based on environment\r\n if (!config.storage) {\r\n config.storage = getDefaultStorage();\r\n }\r\n\r\n // Create and initialize manager\r\n instance = new I18nManager(config);\r\n await instance.init();\r\n\r\n // Setup lazy loading if basePath provided\r\n if (config.basePath) {\r\n const fileExtension = config.fileExtension || 'json';\r\n lazyLoader = new LazyLoader(config.basePath, instance, fileExtension);\r\n await lazyLoader.load(instance.getLanguage());\r\n }\r\n\r\n return instance;\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ ════ ════════════════════════════════════════╗\r\n\r\n /**\r\n * Translate a key with optional parameter replacement\r\n */\r\n export const t = (key: string, params?: Record<string, string>) =>\r\n getI18n().t(key, params);\r\n\r\n /**\r\n * Translate a key with a specific language temporarily\r\n */\r\n export const tLang = (key: string, lang: types.LanguageCode, params?: Record<string, string>) =>\r\n getI18n().tLang(key, lang, params);\r\n\r\n /**\r\n * Parse translation with HTML tags into tokens\r\n */\r\n export const tParse = (key: string, params?: Record<string, string>) =>\r\n getI18n().tParse(key, params);\r\n\r\n /**\r\n * Set current language and trigger listeners\r\n */\r\n export const setLanguage = async (lang: types.LanguageCode): Promise<void> => {\r\n // Load language if lazy loader available\r\n if (lazyLoader && !lazyLoader.isLoaded(lang)) {\r\n return lazyLoader.load(lang).then(() => getI18n().setLanguage(lang));\r\n }\r\n return getI18n().setLanguage(lang);\r\n };\r\n\r\n /**\r\n * Get current language code\r\n */\r\n export const getLanguage = () =>\r\n getI18n().getLanguage();\r\n\r\n /**\r\n * Get all supported languages\r\n */\r\n export const getSupportedLanguages = () =>\r\n getI18n().getSupportedLanguages();\r\n\r\n /**\r\n * Check if translation key exists\r\n */\r\n export const hasKey = (key: string) =>\r\n getI18n().hasKey(key);\r\n\r\n /**\r\n * Check if current language is RTL\r\n */\r\n export const isRTL = () =>\r\n getI18n().isRTL();\r\n\r\n /**\r\n * Check if specific language is RTL\r\n */\r\n export const isRTLLanguage = (lang: types.LanguageCode) =>\r\n getI18n().isRTLLanguage(lang);\r\n\r\n /**\r\n * Subscribe to language changes\r\n */\r\n export const onChange = (callback: (lang: types.LanguageCode) => void) =>\r\n getI18n().onChange(callback);\r\n\r\n /**\r\n * Load translations for a specific language\r\n */\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n export const loadLanguage = (lang: types.LanguageCode, translations: Record<string, any>) =>\r\n getI18n().loadLanguage(lang, translations);\r\n\r\n /**\r\n * Load multiple languages at once\r\n */\r\n export const loadTranslations = (translations: types.TranslationSet) =>\r\n getI18n().loadTranslations(translations);\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ ════ ════════════════════════════════════════╗\r\n\r\n /**\r\n * Generate page title with proper RTL handling\r\n *\r\n * @example\r\n * // English: \"Profile - MyApp\"\r\n * // Arabic: \"MyApp - الملف الشخصي\"\r\n */\r\n export function genPageTitle(key: string, prefix: string = 'page.'): string {\r\n const appName = t('app.name');\r\n const pageName = t(prefix + key);\r\n return isRTL() ? `${appName} - ${pageName}` : `${pageName} - ${appName}`;\r\n }\r\n\r\n /**\r\n * Pluralization helper - select translation based on count\r\n *\r\n * @example\r\n * plural(1, 'item.single', 'item.plural') // \"1 item\"\r\n * plural(5, 'item.single', 'item.plural') // \"5 items\"\r\n */\r\n export function plural(count: number, singleKey: string, pluralKey: string): string {\r\n const key = count === 1 ? singleKey : pluralKey;\r\n return t(key, { count: String(count) });\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ ════ ════════════════════════════════════════╗\r\n\r\n export default {\r\n setupI18n,\r\n getI18n,\r\n getLazyLoader,\r\n I18nManager,\r\n LazyLoader,\r\n t,\r\n tLang,\r\n tParse,\r\n setLanguage,\r\n getLanguage,\r\n getSupportedLanguages,\r\n hasKey,\r\n isRTL,\r\n isRTLLanguage,\r\n onChange,\r\n loadLanguage,\r\n loadTranslations,\r\n genPageTitle,\r\n plural,\r\n };\r\n\r\n export type I18nManagerInstance = InstanceType<typeof I18nManager>;\r\n export type LazyLoaderInstance = InstanceType<typeof LazyLoader>;\r\n\r\n export * from './mod/i18n';\r\n export * from './types';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n"]}
1
+ {"version":3,"sources":["../src/mod/i18n.ts","../src/index.ts"],"names":["I18nManager","config","stored","lang","translations","flattened","trans","obj","prefix","key","value","newKey","params","translation","param","paramValue","fallback","original","result","tokens","regex","match","fn","callback","createBrowserStorage","createMemoryStorage","store","getDefaultStorage","LazyLoader","baseUrl","manager","fileExtension","promise","filePath","data","error","url","response","fs","m","path","resolvedPath","process","content","instance","lazyLoader","detectBrowserLanguage","isBrowser","getI18n","getLazyLoader","setupI18n","detectedLang","t","tLang","tParse","setLanguage","getLanguage","getSupportedLanguages","hasKey","isRTL","isRTLLanguage","onChange","loadLanguage","loadTranslations","genPageTitle","appName","pageName","plural","count","singleKey","pluralKey","index_default"],"mappings":"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","file":"index.cjs","sourcesContent":["// src/mod/i18n.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n import * as types from '../types';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n export class I18nManager {\r\n\r\n // ┌──────────────────────────────── INIT ──────────────────────────────┐\r\n\r\n private translations : types.TranslationSet = {};\r\n private currentLanguage : types.LanguageCode = 'en';\r\n private defaultLanguage : types.LanguageCode = 'en';\r\n private supportedLanguages = new Set<types.LanguageCode>(['en']);\r\n private rtlLanguages = new Set<string>(['ar', 'he', 'fa', 'ur', 'yi', 'ji', 'iw', 'ku']);\r\n private listeners = new Set<(lang: types.LanguageCode) => void>();\r\n private storage? : types.I18nStorage;\r\n private onLanguageChange? : (lang: types.LanguageCode) => void;\r\n\r\n constructor(config?: types.I18nConfig) {\r\n if (config) {\r\n this.defaultLanguage = config.defaultLanguage || 'en';\r\n this.currentLanguage = config.defaultLanguage || 'en';\r\n this.storage = config.storage;\r\n this.onLanguageChange = config.onLanguageChange;\r\n\r\n if (config.supportedLanguages) {\r\n this.supportedLanguages = new Set(config.supportedLanguages);\r\n }\r\n }\r\n }\r\n\r\n /**\r\n * Initialize with stored language preference\r\n */\r\n public async init(): Promise<void> {\r\n if (this.storage) {\r\n const stored = await this.storage.get('i18n-language');\r\n if (stored && this.supportedLanguages.has(stored)) {\r\n this.currentLanguage = stored;\r\n }\r\n }\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌──────────────────────────────── LOAD ──────────────────────────────┐\r\n\r\n /**\r\n * Load translations for a specific language\r\n * @param lang Language code\r\n * @param translations Translation object (can be nested)\r\n */\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n public loadLanguage(lang: types.LanguageCode, translations: Record<string, any>): void {\r\n if (!this.translations[lang]) {\r\n this.translations[lang] = {};\r\n }\r\n\r\n const flattened = this.flattenObject(translations);\r\n this.translations[lang] = { ...this.translations[lang], ...flattened };\r\n this.supportedLanguages.add(lang);\r\n }\r\n\r\n /**\r\n * Load multiple languages at once\r\n * @param translations Object with language codes as keys\r\n */\r\n public loadTranslations(translations: types.TranslationSet): void {\r\n Object.entries(translations).forEach(([lang, trans]) => {\r\n this.loadLanguage(lang, trans);\r\n });\r\n }\r\n\r\n /**\r\n * Flatten nested object into dot notation\r\n * @private\r\n */\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n private flattenObject(obj: Record<string, any>, prefix: string = ''): Record<string, string> {\r\n const flattened: Record<string, string> = {};\r\n\r\n for (const key in obj) {\r\n if (!Object.prototype.hasOwnProperty.call(obj, key)) continue;\r\n\r\n const value = obj[key];\r\n const newKey = prefix ? `${prefix}.${key}` : key;\r\n\r\n if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\r\n Object.assign(flattened, this.flattenObject(value, newKey));\r\n } else {\r\n flattened[newKey] = String(value);\r\n }\r\n }\r\n\r\n return flattened;\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌───────────────────────────── TRANSLATION ──────────────────────────┐\r\n\r\n /**\r\n * Translate a key with parameter replacement\r\n *\r\n * @example\r\n * t('welcome.message', { name: 'John' })\r\n * // => \"Welcome, John!\"\r\n *\r\n * @param key Translation key (dot notation)\r\n * @param params Optional parameters for replacement\r\n * @returns Translated string\r\n */\r\n public t(key: string, params?: Record<string, string>): string {\r\n let translation = this.getTranslation(key);\r\n\r\n if (params) {\r\n Object.entries(params).forEach(([param, value]) => {\r\n // Check if parameter value is itself a translation key\r\n const paramValue = this.getTranslation(value, value);\r\n translation = translation.replace(\r\n new RegExp(`\\\\{${param}\\\\}`, 'g'),\r\n paramValue\r\n );\r\n });\r\n }\r\n\r\n return translation;\r\n }\r\n\r\n /**\r\n * Get raw translation without parameter replacement\r\n * @private\r\n */\r\n private getTranslation(key: string, fallback?: string): string {\r\n // Try current language\r\n if (this.translations[this.currentLanguage]?.[key]) {\r\n return this.translations[this.currentLanguage][key];\r\n }\r\n\r\n // Try default language\r\n if (this.defaultLanguage !== this.currentLanguage &&\r\n this.translations[this.defaultLanguage]?.[key]) {\r\n return this.translations[this.defaultLanguage][key];\r\n }\r\n\r\n // Warn and return fallback\r\n console.warn(`[i18n] Translation key not found: \"${key}\" (lang: ${this.currentLanguage})`);\r\n return fallback || key;\r\n }\r\n\r\n /**\r\n * Translate with a specific language temporarily\r\n *\r\n * @param key Translation key\r\n * @param lang Language code\r\n * @param params Optional parameters\r\n */\r\n public tLang(key: string, lang: types.LanguageCode, params?: Record<string, string>): string {\r\n const original = this.currentLanguage;\r\n this.currentLanguage = lang;\r\n const result = this.t(key, params);\r\n this.currentLanguage = original;\r\n return result;\r\n }\r\n\r\n /**\r\n * Translate and parse HTML-like tags into tokens\r\n * Converts \\n or /n to line breaks\r\n *\r\n * @example\r\n * // Translation: \"Hello\\nWorld <strong>here</strong>\"\r\n * tParse('message')\r\n * // => [\r\n * // { type: 'text', content: 'Hello' },\r\n * // { type: 'tag', tag: 'br', content: '' },\r\n * // { type: 'text', content: 'World ' },\r\n * // { type: 'tag', tag: 'strong', content: 'here' }\r\n * // ]\r\n *\r\n * @param key Translation key\r\n * @param params Optional parameters\r\n * @returns Array of tokens\r\n */\r\n public tParse(key: string, params?: Record<string, string>): types.TranslationToken[] {\r\n let translation = this.t(key, params);\r\n\r\n // Convert newlines to <br> tags\r\n translation = translation.replace(/\\\\n|\\/n/g, '<br>');\r\n\r\n const tokens: types.TranslationToken[] = [];\r\n const regex = /<([a-z]+)>([^<]*)<\\/\\1>|<([a-z]+)\\s*\\/?>|([^<]+)/gi;\r\n let match;\r\n\r\n while ((match = regex.exec(translation)) !== null) {\r\n if (match[4]) {\r\n // Plain text\r\n tokens.push({ type: 'text', content: match[4] });\r\n } else if (match[1]) {\r\n // Paired tag: <strong>text</strong>\r\n tokens.push({ type: 'tag', tag: match[1], content: match[2] });\r\n } else if (match[3]) {\r\n // Self-closing: <br> or <br/>\r\n tokens.push({ type: 'tag', tag: match[3], content: '' });\r\n }\r\n }\r\n\r\n return tokens.length > 0 ? tokens : [{ type: 'text', content: translation }];\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌────────────────────────────── LANGUAGE ────────────────────────────┐\r\n\r\n /**\r\n * Set current language\r\n */\r\n public async setLanguage(lang: types.LanguageCode): Promise<void> {\r\n if (!this.supportedLanguages.has(lang)) {\r\n console.warn(`[i18n] Language \"${lang}\" not supported`);\r\n return;\r\n }\r\n\r\n this.currentLanguage = lang;\r\n\r\n // Persist if storage available\r\n if (this.storage) {\r\n await this.storage.set('i18n-language', lang);\r\n }\r\n\r\n // Notify listeners\r\n this.listeners.forEach(fn => fn(lang));\r\n\r\n if (this.onLanguageChange) {\r\n this.onLanguageChange(lang);\r\n }\r\n }\r\n\r\n /**\r\n * Get current language\r\n */\r\n public getLanguage(): types.LanguageCode {\r\n return this.currentLanguage;\r\n }\r\n\r\n /**\r\n * Get all supported languages\r\n */\r\n public getSupportedLanguages(): types.LanguageCode[] {\r\n return Array.from(this.supportedLanguages);\r\n }\r\n\r\n /**\r\n * Check if language is supported\r\n */\r\n public isLanguageSupported(lang: types.LanguageCode): boolean {\r\n return this.supportedLanguages.has(lang);\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌─────────────────────────────── HELPERS ────────────────────────────┐\r\n\r\n /**\r\n * Check if a translation key exists\r\n */\r\n public hasKey(key: string): boolean {\r\n return !!(\r\n this.translations[this.currentLanguage]?.[key] ||\r\n this.translations[this.defaultLanguage]?.[key]\r\n );\r\n }\r\n\r\n /**\r\n * Get all translations for current language\r\n */\r\n public getTranslations(): Record<string, string> {\r\n return this.translations[this.currentLanguage] || {};\r\n }\r\n\r\n /**\r\n * Check if current language is RTL\r\n */\r\n public isRTL(): boolean {\r\n return this.rtlLanguages.has(this.currentLanguage.toLowerCase().substring(0, 2));\r\n }\r\n\r\n /**\r\n * Check if specific language is RTL\r\n */\r\n public isRTLLanguage(lang: types.LanguageCode): boolean {\r\n return this.rtlLanguages.has(lang.toLowerCase().substring(0, 2));\r\n }\r\n\r\n /**\r\n * Subscribe to language changes\r\n * @returns Unsubscribe function\r\n */\r\n public onChange(callback: (lang: types.LanguageCode) => void): () => void {\r\n this.listeners.add(callback);\r\n return () => this.listeners.delete(callback);\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n","// src/index.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n import * as types from './types';\r\n import { I18nManager } from './mod/i18n';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n /**\r\n * Storage adapter for browser (localStorage)\r\n */\r\n const createBrowserStorage = (): types.I18nStorage => ({\r\n get: (key: string) => {\r\n if (typeof localStorage === 'undefined') return null;\r\n return localStorage.getItem(key);\r\n },\r\n set: (key: string, value: string) => {\r\n if (typeof localStorage !== 'undefined') {\r\n localStorage.setItem(key, value);\r\n }\r\n }\r\n });\r\n\r\n /**\r\n * Storage adapter for memory (in-process storage)\r\n */\r\n const createMemoryStorage = (): types.I18nStorage => {\r\n const store = new Map<string, string>();\r\n return {\r\n get: (key: string) => store.get(key) || null,\r\n set: (key: string, value: string) => { store.set(key, value); }\r\n };\r\n };\r\n\r\n /**\r\n * Auto-select appropriate storage based on environment\r\n */\r\n const getDefaultStorage = (): types.I18nStorage => {\r\n return typeof localStorage !== 'undefined' ? createBrowserStorage() : createMemoryStorage();\r\n };\r\n\r\n /**\r\n * Lazy loader: fetch language on-demand\r\n * Supports both URL-based (browser) and file-based (server) loading\r\n */\r\n export class LazyLoader {\r\n private baseUrl: string;\r\n private manager: I18nManager;\r\n private loading = new Map<types.LanguageCode, Promise<void>>();\r\n private loaded = new Set<types.LanguageCode>();\r\n private isServerSide: boolean;\r\n private fileExtension: string;\r\n\r\n constructor(baseUrl: string, manager: I18nManager, fileExtension: string = 'json') {\r\n this.baseUrl = baseUrl.endsWith('/') ? baseUrl : baseUrl + '/';\r\n this.manager = manager;\r\n this.fileExtension = fileExtension;\r\n this.isServerSide = typeof fetch === 'undefined';\r\n }\r\n\r\n /**\r\n * Load a language file on-demand\r\n * Caches the promise to prevent duplicate requests\r\n */\r\n async load(lang: types.LanguageCode): Promise<void> {\r\n // Already loaded\r\n if (this.loaded.has(lang)) {\r\n return;\r\n }\r\n\r\n // Currently loading\r\n if (this.loading.has(lang)) {\r\n return this.loading.get(lang);\r\n }\r\n\r\n // Start loading\r\n const promise = this.doLoad(lang);\r\n this.loading.set(lang, promise);\r\n\r\n try {\r\n await promise;\r\n this.loaded.add(lang);\r\n } finally {\r\n this.loading.delete(lang);\r\n }\r\n }\r\n\r\n private async doLoad(lang: types.LanguageCode): Promise<void> {\r\n try {\r\n const filePath = `${this.baseUrl}${lang}.${this.fileExtension}`;\r\n\r\n let data: Record<string, string> | null;\r\n\r\n // Check if it's a local file path (relative or absolute)\r\n const isLocalPath = filePath.startsWith('.') || filePath.startsWith('/') || /^[a-zA-Z]:/.test(filePath);\r\n\r\n if (isLocalPath || this.isServerSide) {\r\n // Node.js/local: Read from filesystem\r\n data = await this.loadFromFile(filePath);\r\n } else {\r\n // Browser: Fetch from URL\r\n data = await this.loadFromUrl(filePath);\r\n }\r\n\r\n if (data) {\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n this.manager.loadLanguage(lang, data as Record<string, any>);\r\n }\r\n } catch (error) {\r\n console.warn(`[i18n] Error loading language: ${lang}`, error);\r\n }\r\n }\r\n\r\n private async loadFromUrl(url: string): Promise<Record<string, string> | null> {\r\n try {\r\n const response = await fetch(url);\r\n\r\n if (response.ok) {\r\n return await response.json();\r\n } else {\r\n console.warn(`[i18n] Failed to load language from URL: ${url} (${response.status})`);\r\n return null;\r\n }\r\n } catch (error) {\r\n console.warn(`[i18n] Error fetching from URL: ${url}`, error);\r\n return null;\r\n }\r\n }\r\n\r\n private async loadFromFile(filePath: string): Promise<Record<string, string> | null> {\r\n try {\r\n // Dynamic import to avoid issues in browsers\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n const fs = await import('fs').then(m => m.promises).catch((): any => null);\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n const path = await import('path').then(m => m).catch((): any => null);\r\n\r\n if (!fs) {\r\n console.warn('[i18n] fs module not available. Running in browser?');\r\n return null;\r\n }\r\n\r\n // Resolve relative paths to absolute paths\r\n let resolvedPath = filePath;\r\n if (path && !path.isAbsolute(filePath)) {\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n const process = await import('process').then(m => m).catch((): any => null);\r\n if (process) {\r\n resolvedPath = path.resolve(process.cwd(), filePath);\r\n }\r\n }\r\n\r\n const content = await fs.readFile(resolvedPath, 'utf-8');\r\n return JSON.parse(content);\r\n } catch (error) {\r\n console.warn(`[i18n] Error reading file: ${filePath}`, error);\r\n return null;\r\n }\r\n }\r\n\r\n isLoaded(lang: types.LanguageCode): boolean {\r\n return this.loaded.has(lang);\r\n }\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ ════ ════════════════════════════════════════╗\r\n\r\n let instance: I18nManager | null = null;\r\n let lazyLoader: LazyLoader | null = null;\r\n\r\n /**\r\n * Get browser language preference\r\n * Uses navigator.language if available (browser environment)\r\n * @private\r\n */\r\n function detectBrowserLanguage(): string {\r\n if (typeof navigator !== 'undefined' && navigator.language) {\r\n return navigator.language.split('-')[0].toLowerCase();\r\n }\r\n return 'en';\r\n }\r\n\r\n /**\r\n * Check if running in browser environment\r\n * @private\r\n */\r\n function isBrowser(): boolean {\r\n return typeof fetch !== 'undefined' && typeof window !== 'undefined';\r\n }\r\n\r\n /**\r\n * Get or create the global i18n instance\r\n */\r\n export function getI18n(): I18nManager {\r\n if (!instance) {\r\n instance = new I18nManager();\r\n }\r\n return instance;\r\n }\r\n\r\n /**\r\n * Get the lazy loader instance (only available after setupI18n with basePath)\r\n */\r\n export function getLazyLoader(): LazyLoader | null {\r\n return lazyLoader;\r\n }\r\n\r\n /**\r\n * Main setup function - Single, simple, auto-detecting initialization\r\n *\r\n * Auto-detects environment and handles both browser and server:\r\n * - Browser: Auto-detects language, loads from URL path\r\n * - Server: Uses defaultLanguage, loads from file system\r\n *\r\n * Call this ONCE at app startup.\r\n *\r\n * @example\r\n * // Browser - Auto-detects language, lazy-loads from URL\r\n * await setupI18n({\r\n * supportedLanguages: ['en', 'ar', 'fr'],\r\n * basePath: '/i18n/'\r\n * });\r\n *\r\n * @example\r\n * // Server - Uses default language, lazy-loads from filesystem\r\n * await setupI18n({\r\n * defaultLanguage: 'en',\r\n * supportedLanguages: ['en', 'ar', 'fr'],\r\n * basePath: './locales/'\r\n * });\r\n */\r\n export async function setupI18n(\r\n config: types.I18nConfig & { basePath?: string }\r\n ): Promise<I18nManager> {\r\n // Auto-detect browser language if in browser and no defaultLanguage specified\r\n if (isBrowser() && !config.defaultLanguage) {\r\n const detectedLang = detectBrowserLanguage();\r\n if (config.supportedLanguages?.includes(detectedLang)) {\r\n config.defaultLanguage = detectedLang;\r\n } else {\r\n config.defaultLanguage = config.supportedLanguages?.[0] || 'en';\r\n }\r\n }\r\n\r\n // Use appropriate storage based on environment\r\n if (!config.storage) {\r\n config.storage = getDefaultStorage();\r\n }\r\n\r\n // Create and initialize manager\r\n instance = new I18nManager(config);\r\n await instance.init();\r\n\r\n // Setup lazy loading if basePath provided\r\n if (config.basePath) {\r\n const fileExtension = config.fileExtension || 'json';\r\n lazyLoader = new LazyLoader(config.basePath, instance, fileExtension);\r\n await lazyLoader.load(instance.getLanguage());\r\n }\r\n\r\n return instance;\r\n }\r\n\r\n\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CONVENIENCE FUNCTIONS ════════════════════════════════════════╗\r\n\r\n /**\r\n * Translate a key with optional parameter replacement\r\n */\r\n export const t = (key: string, params?: Record<string, string>) =>\r\n getI18n().t(key, params);\r\n\r\n /**\r\n * Translate a key with a specific language temporarily\r\n */\r\n export const tLang = (key: string, lang: types.LanguageCode, params?: Record<string, string>) =>\r\n getI18n().tLang(key, lang, params);\r\n\r\n /**\r\n * Parse translation with HTML tags into tokens\r\n */\r\n export const tParse = (key: string, params?: Record<string, string>) =>\r\n getI18n().tParse(key, params);\r\n\r\n /**\r\n * Set current language and trigger listeners\r\n */\r\n export const setLanguage = (lang: types.LanguageCode): Promise<void> => {\r\n // Load language if lazy loader available\r\n if (lazyLoader && !lazyLoader.isLoaded(lang)) {\r\n return lazyLoader.load(lang).then(() => getI18n().setLanguage(lang));\r\n }\r\n return getI18n().setLanguage(lang);\r\n };\r\n\r\n /**\r\n * Get current language code\r\n */\r\n export const getLanguage = () =>\r\n getI18n().getLanguage();\r\n\r\n /**\r\n * Get all supported languages\r\n */\r\n export const getSupportedLanguages = () =>\r\n getI18n().getSupportedLanguages();\r\n\r\n /**\r\n * Check if translation key exists\r\n */\r\n export const hasKey = (key: string) =>\r\n getI18n().hasKey(key);\r\n\r\n /**\r\n * Check if current language is RTL\r\n */\r\n export const isRTL = () =>\r\n getI18n().isRTL();\r\n\r\n /**\r\n * Check if specific language is RTL\r\n */\r\n export const isRTLLanguage = (lang: types.LanguageCode) =>\r\n getI18n().isRTLLanguage(lang);\r\n\r\n /**\r\n * Subscribe to language changes\r\n */\r\n export const onChange = (callback: (lang: types.LanguageCode) => void) =>\r\n getI18n().onChange(callback);\r\n\r\n /**\r\n * Load translations for a specific language\r\n */\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n export const loadLanguage = (lang: types.LanguageCode, translations: Record<string, any>) =>\r\n getI18n().loadLanguage(lang, translations);\r\n\r\n /**\r\n * Load multiple languages at once\r\n */\r\n export const loadTranslations = (translations: types.TranslationSet) =>\r\n getI18n().loadTranslations(translations);\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ UTILITY FUNCTIONS ════════════════════════════════════════╗\r\n\r\n /**\r\n * Generate page title with proper RTL handling\r\n *\r\n * @example\r\n * // English: \"Profile - MyApp\"\r\n * // Arabic: \"MyApp - الملف الشخصي\"\r\n */\r\n export function genPageTitle(key: string, prefix: string = 'page.'): string {\r\n const appName = t('app.name');\r\n const pageName = t(prefix + key);\r\n return isRTL() ? `${appName} - ${pageName}` : `${pageName} - ${appName}`;\r\n }\r\n\r\n /**\r\n * Pluralization helper - select translation based on count\r\n *\r\n * @example\r\n * plural(1, 'item.single', 'item.plural') // \"1 item\"\r\n * plural(5, 'item.single', 'item.plural') // \"5 items\"\r\n */\r\n export function plural(count: number, singleKey: string, pluralKey: string): string {\r\n const key = count === 1 ? singleKey : pluralKey;\r\n return t(key, { count: String(count) });\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ EXPORTS ════════════════════════════════════════╗\r\n\r\n export default {\r\n setupI18n,\r\n getI18n,\r\n getLazyLoader,\r\n I18nManager,\r\n LazyLoader,\r\n t,\r\n tLang,\r\n tParse,\r\n setLanguage,\r\n getLanguage,\r\n getSupportedLanguages,\r\n hasKey,\r\n isRTL,\r\n isRTLLanguage,\r\n onChange,\r\n loadLanguage,\r\n loadTranslations,\r\n genPageTitle,\r\n plural,\r\n };\r\n\r\n export type I18nManagerInstance = InstanceType<typeof I18nManager>;\r\n export type LazyLoaderInstance = InstanceType<typeof LazyLoader>;\r\n\r\n export * from './mod/i18n';\r\n export * from './types';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n"]}
package/dist/index.js CHANGED
@@ -1,2 +1,2 @@
1
- var u=class{constructor(e){this.translations={};this.currentLanguage="en";this.defaultLanguage="en";this.supportedLanguages=new Set(["en"]);this.rtlLanguages=new Set(["ar","he","fa","ur","yi","ji","iw","ku"]);this.listeners=new Set;e&&(this.defaultLanguage=e.defaultLanguage||"en",this.currentLanguage=e.defaultLanguage||"en",this.storage=e.storage,this.onLanguageChange=e.onLanguageChange,e.supportedLanguages&&(this.supportedLanguages=new Set(e.supportedLanguages)));}async init(){if(this.storage){let e=await this.storage.get("i18n-language");e&&this.supportedLanguages.has(e)&&(this.currentLanguage=e);}}loadLanguage(e,t){this.translations[e]||(this.translations[e]={});let a=this.flattenObject(t);this.translations[e]={...this.translations[e],...a},this.supportedLanguages.add(e);}loadTranslations(e){Object.entries(e).forEach(([t,a])=>{this.loadLanguage(t,a);});}flattenObject(e,t=""){let a={};for(let r in e){if(!Object.prototype.hasOwnProperty.call(e,r))continue;let i=e[r],s=t?`${t}.${r}`:r;typeof i=="object"&&i!==null&&!Array.isArray(i)?Object.assign(a,this.flattenObject(i,s)):a[s]=String(i);}return a}t(e,t){let a=this.getTranslation(e);return t&&Object.entries(t).forEach(([r,i])=>{let s=this.getTranslation(i,i);a=a.replace(new RegExp(`\\{${r}\\}`,"g"),s);}),a}getTranslation(e,t){return this.translations[this.currentLanguage]?.[e]?this.translations[this.currentLanguage][e]:this.defaultLanguage!==this.currentLanguage&&this.translations[this.defaultLanguage]?.[e]?this.translations[this.defaultLanguage][e]:(console.warn(`[i18n] Translation key not found: "${e}" (lang: ${this.currentLanguage})`),t||e)}tLang(e,t,a){let r=this.currentLanguage;this.currentLanguage=t;let i=this.t(e,a);return this.currentLanguage=r,i}tParse(e,t){let a=this.t(e,t);a=a.replace(/\\n|\/n/g,"<br>");let r=[],i=/<([a-z]+)>([^<]*)<\/\1>|<([a-z]+)\s*\/?>|([^<]+)/gi,s;for(;(s=i.exec(a))!==null;)s[4]?r.push({type:"text",content:s[4]}):s[1]?r.push({type:"tag",tag:s[1],content:s[2]}):s[3]&&r.push({type:"tag",tag:s[3],content:""});return r.length>0?r:[{type:"text",content:a}]}async setLanguage(e){if(!this.supportedLanguages.has(e)){console.warn(`[i18n] Language "${e}" not supported`);return}this.currentLanguage=e,this.storage&&await this.storage.set("i18n-language",e),this.listeners.forEach(t=>t(e)),this.onLanguageChange&&this.onLanguageChange(e);}getLanguage(){return this.currentLanguage}getSupportedLanguages(){return Array.from(this.supportedLanguages)}isLanguageSupported(e){return this.supportedLanguages.has(e)}hasKey(e){return !!(this.translations[this.currentLanguage]?.[e]||this.translations[this.defaultLanguage]?.[e])}getTranslations(){return this.translations[this.currentLanguage]||{}}isRTL(){return this.rtlLanguages.has(this.currentLanguage.toLowerCase().substring(0,2))}isRTLLanguage(e){return this.rtlLanguages.has(e.toLowerCase().substring(0,2))}onChange(e){return this.listeners.add(e),()=>this.listeners.delete(e)}};var L=()=>({get:n=>typeof localStorage>"u"?null:localStorage.getItem(n),set:(n,e)=>{typeof localStorage<"u"&&localStorage.setItem(n,e);}}),y=()=>{let n=new Map;return {get:e=>n.get(e)||null,set:(e,t)=>{n.set(e,t);}}},f=()=>typeof localStorage<"u"?L():y(),p=class{constructor(e,t,a="json"){this.loading=new Map;this.loaded=new Set;this.baseUrl=e.endsWith("/")?e:e+"/",this.manager=t,this.fileExtension=a,this.isServerSide=typeof fetch>"u";}async load(e){if(this.loaded.has(e))return;if(this.loading.has(e))return this.loading.get(e);let t=this.doLoad(e);this.loading.set(e,t);try{await t,this.loaded.add(e);}finally{this.loading.delete(e);}}async doLoad(e){try{let t=`${this.baseUrl}${e}.${this.fileExtension}`,a;t.startsWith(".")||t.startsWith("/")||/^[a-zA-Z]:/.test(t)||this.isServerSide?a=await this.loadFromFile(t):a=await this.loadFromUrl(t),a&&this.manager.loadLanguage(e,a);}catch(t){console.warn(`[i18n] Error loading language: ${e}`,t);}}async loadFromUrl(e){try{let t=await fetch(e);return t.ok?await t.json():(console.warn(`[i18n] Failed to load language from URL: ${e} (${t.status})`),null)}catch(t){return console.warn(`[i18n] Error fetching from URL: ${e}`,t),null}}async loadFromFile(e){try{let t=await import('fs').then(s=>s.promises).catch(()=>null),a=await import('path').then(s=>s).catch(()=>null);if(!t)return console.warn("[i18n] fs module not available. Running in browser?"),null;let r=e;if(a&&!a.isAbsolute(e)){let s=await import('process').then(h=>h).catch(()=>null);s&&(r=a.resolve(s.cwd(),e));}let i=await t.readFile(r,"utf-8");return JSON.parse(i)}catch(t){return console.warn(`[i18n] Error reading file: ${e}`,t),null}}isLoaded(e){return this.loaded.has(e)}},g=null,l=null;function w(){return typeof navigator<"u"&&navigator.language?navigator.language.split("-")[0].toLowerCase():"en"}function m(){return typeof fetch<"u"&&typeof window<"u"}function o(){return g||(g=new u),g}function v(){return l}async function b(n){if(m()&&!n.defaultLanguage){let e=w();n.supportedLanguages?.includes(e)?n.defaultLanguage=e:n.defaultLanguage=n.supportedLanguages?.[0]||"en";}if(n.storage||(n.storage=f()),g=new u(n),await g.init(),n.basePath){let e=n.fileExtension||"json";l=new p(n.basePath,g,e),await l.load(g.getLanguage());}return g}var d=(n,e)=>o().t(n,e),C=(n,e,t)=>o().tLang(n,e,t),x=(n,e)=>o().tParse(n,e),S=async n=>l&&!l.isLoaded(n)?l.load(n).then(()=>o().setLanguage(n)):o().setLanguage(n),R=()=>o().getLanguage(),T=()=>o().getSupportedLanguages(),I=n=>o().hasKey(n),c=()=>o().isRTL(),P=n=>o().isRTLLanguage(n),$=n=>o().onChange(n),E=(n,e)=>o().loadLanguage(n,e),j=n=>o().loadTranslations(n);function M(n,e="page."){let t=d("app.name"),a=d(e+n);return c()?`${t} - ${a}`:`${a} - ${t}`}function O(n,e,t){return d(n===1?e:t,{count:String(n)})}var A={setupI18n:b,getI18n:o,getLazyLoader:v,I18nManager:u,LazyLoader:p,t:d,tLang:C,tParse:x,setLanguage:S,getLanguage:R,getSupportedLanguages:T,hasKey:I,isRTL:c,isRTLLanguage:P,onChange:$,loadLanguage:E,loadTranslations:j,genPageTitle:M,plural:O};export{u as I18nManager,p as LazyLoader,A as default,M as genPageTitle,o as getI18n,R as getLanguage,v as getLazyLoader,T as getSupportedLanguages,I as hasKey,c as isRTL,P as isRTLLanguage,E as loadLanguage,j as loadTranslations,$ as onChange,O as plural,S as setLanguage,b as setupI18n,d as t,C as tLang,x as tParse};//# sourceMappingURL=index.js.map
1
+ var u=class{constructor(e){this.translations={};this.currentLanguage="en";this.defaultLanguage="en";this.supportedLanguages=new Set(["en"]);this.rtlLanguages=new Set(["ar","he","fa","ur","yi","ji","iw","ku"]);this.listeners=new Set;e&&(this.defaultLanguage=e.defaultLanguage||"en",this.currentLanguage=e.defaultLanguage||"en",this.storage=e.storage,this.onLanguageChange=e.onLanguageChange,e.supportedLanguages&&(this.supportedLanguages=new Set(e.supportedLanguages)));}async init(){if(this.storage){let e=await this.storage.get("i18n-language");e&&this.supportedLanguages.has(e)&&(this.currentLanguage=e);}}loadLanguage(e,t){this.translations[e]||(this.translations[e]={});let a=this.flattenObject(t);this.translations[e]={...this.translations[e],...a},this.supportedLanguages.add(e);}loadTranslations(e){Object.entries(e).forEach(([t,a])=>{this.loadLanguage(t,a);});}flattenObject(e,t=""){let a={};for(let r in e){if(!Object.prototype.hasOwnProperty.call(e,r))continue;let i=e[r],s=t?`${t}.${r}`:r;typeof i=="object"&&i!==null&&!Array.isArray(i)?Object.assign(a,this.flattenObject(i,s)):a[s]=String(i);}return a}t(e,t){let a=this.getTranslation(e);return t&&Object.entries(t).forEach(([r,i])=>{let s=this.getTranslation(i,i);a=a.replace(new RegExp(`\\{${r}\\}`,"g"),s);}),a}getTranslation(e,t){return this.translations[this.currentLanguage]?.[e]?this.translations[this.currentLanguage][e]:this.defaultLanguage!==this.currentLanguage&&this.translations[this.defaultLanguage]?.[e]?this.translations[this.defaultLanguage][e]:(console.warn(`[i18n] Translation key not found: "${e}" (lang: ${this.currentLanguage})`),t||e)}tLang(e,t,a){let r=this.currentLanguage;this.currentLanguage=t;let i=this.t(e,a);return this.currentLanguage=r,i}tParse(e,t){let a=this.t(e,t);a=a.replace(/\\n|\/n/g,"<br>");let r=[],i=/<([a-z]+)>([^<]*)<\/\1>|<([a-z]+)\s*\/?>|([^<]+)/gi,s;for(;(s=i.exec(a))!==null;)s[4]?r.push({type:"text",content:s[4]}):s[1]?r.push({type:"tag",tag:s[1],content:s[2]}):s[3]&&r.push({type:"tag",tag:s[3],content:""});return r.length>0?r:[{type:"text",content:a}]}async setLanguage(e){if(!this.supportedLanguages.has(e)){console.warn(`[i18n] Language "${e}" not supported`);return}this.currentLanguage=e,this.storage&&await this.storage.set("i18n-language",e),this.listeners.forEach(t=>t(e)),this.onLanguageChange&&this.onLanguageChange(e);}getLanguage(){return this.currentLanguage}getSupportedLanguages(){return Array.from(this.supportedLanguages)}isLanguageSupported(e){return this.supportedLanguages.has(e)}hasKey(e){return !!(this.translations[this.currentLanguage]?.[e]||this.translations[this.defaultLanguage]?.[e])}getTranslations(){return this.translations[this.currentLanguage]||{}}isRTL(){return this.rtlLanguages.has(this.currentLanguage.toLowerCase().substring(0,2))}isRTLLanguage(e){return this.rtlLanguages.has(e.toLowerCase().substring(0,2))}onChange(e){return this.listeners.add(e),()=>this.listeners.delete(e)}};var L=()=>({get:n=>typeof localStorage>"u"?null:localStorage.getItem(n),set:(n,e)=>{typeof localStorage<"u"&&localStorage.setItem(n,e);}}),y=()=>{let n=new Map;return {get:e=>n.get(e)||null,set:(e,t)=>{n.set(e,t);}}},f=()=>typeof localStorage<"u"?L():y(),p=class{constructor(e,t,a="json"){this.loading=new Map;this.loaded=new Set;this.baseUrl=e.endsWith("/")?e:e+"/",this.manager=t,this.fileExtension=a,this.isServerSide=typeof fetch>"u";}async load(e){if(this.loaded.has(e))return;if(this.loading.has(e))return this.loading.get(e);let t=this.doLoad(e);this.loading.set(e,t);try{await t,this.loaded.add(e);}finally{this.loading.delete(e);}}async doLoad(e){try{let t=`${this.baseUrl}${e}.${this.fileExtension}`,a;t.startsWith(".")||t.startsWith("/")||/^[a-zA-Z]:/.test(t)||this.isServerSide?a=await this.loadFromFile(t):a=await this.loadFromUrl(t),a&&this.manager.loadLanguage(e,a);}catch(t){console.warn(`[i18n] Error loading language: ${e}`,t);}}async loadFromUrl(e){try{let t=await fetch(e);return t.ok?await t.json():(console.warn(`[i18n] Failed to load language from URL: ${e} (${t.status})`),null)}catch(t){return console.warn(`[i18n] Error fetching from URL: ${e}`,t),null}}async loadFromFile(e){try{let t=await import('fs').then(s=>s.promises).catch(()=>null),a=await import('path').then(s=>s).catch(()=>null);if(!t)return console.warn("[i18n] fs module not available. Running in browser?"),null;let r=e;if(a&&!a.isAbsolute(e)){let s=await import('process').then(h=>h).catch(()=>null);s&&(r=a.resolve(s.cwd(),e));}let i=await t.readFile(r,"utf-8");return JSON.parse(i)}catch(t){return console.warn(`[i18n] Error reading file: ${e}`,t),null}}isLoaded(e){return this.loaded.has(e)}},g=null,l=null;function w(){return typeof navigator<"u"&&navigator.language?navigator.language.split("-")[0].toLowerCase():"en"}function m(){return typeof fetch<"u"&&typeof window<"u"}function o(){return g||(g=new u),g}function v(){return l}async function b(n){if(m()&&!n.defaultLanguage){let e=w();n.supportedLanguages?.includes(e)?n.defaultLanguage=e:n.defaultLanguage=n.supportedLanguages?.[0]||"en";}if(n.storage||(n.storage=f()),g=new u(n),await g.init(),n.basePath){let e=n.fileExtension||"json";l=new p(n.basePath,g,e),await l.load(g.getLanguage());}return g}var d=(n,e)=>o().t(n,e),C=(n,e,t)=>o().tLang(n,e,t),x=(n,e)=>o().tParse(n,e),S=n=>l&&!l.isLoaded(n)?l.load(n).then(()=>o().setLanguage(n)):o().setLanguage(n),R=()=>o().getLanguage(),T=()=>o().getSupportedLanguages(),I=n=>o().hasKey(n),c=()=>o().isRTL(),P=n=>o().isRTLLanguage(n),$=n=>o().onChange(n),E=(n,e)=>o().loadLanguage(n,e),j=n=>o().loadTranslations(n);function M(n,e="page."){let t=d("app.name"),a=d(e+n);return c()?`${t} - ${a}`:`${a} - ${t}`}function O(n,e,t){return d(n===1?e:t,{count:String(n)})}var A={setupI18n:b,getI18n:o,getLazyLoader:v,I18nManager:u,LazyLoader:p,t:d,tLang:C,tParse:x,setLanguage:S,getLanguage:R,getSupportedLanguages:T,hasKey:I,isRTL:c,isRTLLanguage:P,onChange:$,loadLanguage:E,loadTranslations:j,genPageTitle:M,plural:O};export{u as I18nManager,p as LazyLoader,A as default,M as genPageTitle,o as getI18n,R as getLanguage,v as getLazyLoader,T as getSupportedLanguages,I as hasKey,c as isRTL,P as isRTLLanguage,E as loadLanguage,j as loadTranslations,$ as onChange,O as plural,S as setLanguage,b as setupI18n,d as t,C as tLang,x as tParse};//# sourceMappingURL=index.js.map
2
2
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/mod/i18n.ts","../src/index.ts"],"names":["I18nManager","config","stored","lang","translations","flattened","trans","obj","prefix","key","value","newKey","params","translation","param","paramValue","fallback","original","result","tokens","regex","match","fn","callback","createBrowserStorage","createMemoryStorage","store","getDefaultStorage","LazyLoader","baseUrl","manager","fileExtension","promise","filePath","data","error","url","response","fs","m","path","resolvedPath","process","content","instance","lazyLoader","detectBrowserLanguage","isBrowser","getI18n","getLazyLoader","setupI18n","detectedLang","t","tLang","tParse","setLanguage","getLanguage","getSupportedLanguages","hasKey","isRTL","isRTLLanguage","onChange","loadLanguage","loadTranslations","genPageTitle","appName","pageName","plural","count","singleKey","pluralKey","index_default"],"mappings":"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","file":"index.js","sourcesContent":["// src/mod/i18n.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n import * as types from '../types';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n export class I18nManager {\r\n\r\n // ┌──────────────────────────────── INIT ──────────────────────────────┐\r\n\r\n private translations : types.TranslationSet = {};\r\n private currentLanguage : types.LanguageCode = 'en';\r\n private defaultLanguage : types.LanguageCode = 'en';\r\n private supportedLanguages = new Set<types.LanguageCode>(['en']);\r\n private rtlLanguages = new Set<string>(['ar', 'he', 'fa', 'ur', 'yi', 'ji', 'iw', 'ku']);\r\n private listeners = new Set<(lang: types.LanguageCode) => void>();\r\n private storage? : types.I18nStorage;\r\n private onLanguageChange? : (lang: types.LanguageCode) => void;\r\n\r\n constructor(config?: types.I18nConfig) {\r\n if (config) {\r\n this.defaultLanguage = config.defaultLanguage || 'en';\r\n this.currentLanguage = config.defaultLanguage || 'en';\r\n this.storage = config.storage;\r\n this.onLanguageChange = config.onLanguageChange;\r\n\r\n if (config.supportedLanguages) {\r\n this.supportedLanguages = new Set(config.supportedLanguages);\r\n }\r\n }\r\n }\r\n\r\n /**\r\n * Initialize with stored language preference\r\n */\r\n public async init(): Promise<void> {\r\n if (this.storage) {\r\n const stored = await this.storage.get('i18n-language');\r\n if (stored && this.supportedLanguages.has(stored)) {\r\n this.currentLanguage = stored;\r\n }\r\n }\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌──────────────────────────────── LOAD ──────────────────────────────┐\r\n\r\n /**\r\n * Load translations for a specific language\r\n * @param lang Language code\r\n * @param translations Translation object (can be nested)\r\n */\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n public loadLanguage(lang: types.LanguageCode, translations: Record<string, any>): void {\r\n if (!this.translations[lang]) {\r\n this.translations[lang] = {};\r\n }\r\n\r\n const flattened = this.flattenObject(translations);\r\n this.translations[lang] = { ...this.translations[lang], ...flattened };\r\n this.supportedLanguages.add(lang);\r\n }\r\n\r\n /**\r\n * Load multiple languages at once\r\n * @param translations Object with language codes as keys\r\n */\r\n public loadTranslations(translations: types.TranslationSet): void {\r\n Object.entries(translations).forEach(([lang, trans]) => {\r\n this.loadLanguage(lang, trans);\r\n });\r\n }\r\n\r\n /**\r\n * Flatten nested object into dot notation\r\n * @private\r\n */\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n private flattenObject(obj: Record<string, any>, prefix: string = ''): Record<string, string> {\r\n const flattened: Record<string, string> = {};\r\n\r\n for (const key in obj) {\r\n if (!Object.prototype.hasOwnProperty.call(obj, key)) continue;\r\n\r\n const value = obj[key];\r\n const newKey = prefix ? `${prefix}.${key}` : key;\r\n\r\n if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\r\n Object.assign(flattened, this.flattenObject(value, newKey));\r\n } else {\r\n flattened[newKey] = String(value);\r\n }\r\n }\r\n\r\n return flattened;\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌───────────────────────────── TRANSLATION ──────────────────────────┐\r\n\r\n /**\r\n * Translate a key with parameter replacement\r\n *\r\n * @example\r\n * t('welcome.message', { name: 'John' })\r\n * // => \"Welcome, John!\"\r\n *\r\n * @param key Translation key (dot notation)\r\n * @param params Optional parameters for replacement\r\n * @returns Translated string\r\n */\r\n public t(key: string, params?: Record<string, string>): string {\r\n let translation = this.getTranslation(key);\r\n\r\n if (params) {\r\n Object.entries(params).forEach(([param, value]) => {\r\n // Check if parameter value is itself a translation key\r\n const paramValue = this.getTranslation(value, value);\r\n translation = translation.replace(\r\n new RegExp(`\\\\{${param}\\\\}`, 'g'),\r\n paramValue\r\n );\r\n });\r\n }\r\n\r\n return translation;\r\n }\r\n\r\n /**\r\n * Get raw translation without parameter replacement\r\n * @private\r\n */\r\n private getTranslation(key: string, fallback?: string): string {\r\n // Try current language\r\n if (this.translations[this.currentLanguage]?.[key]) {\r\n return this.translations[this.currentLanguage][key];\r\n }\r\n\r\n // Try default language\r\n if (this.defaultLanguage !== this.currentLanguage &&\r\n this.translations[this.defaultLanguage]?.[key]) {\r\n return this.translations[this.defaultLanguage][key];\r\n }\r\n\r\n // Warn and return fallback\r\n console.warn(`[i18n] Translation key not found: \"${key}\" (lang: ${this.currentLanguage})`);\r\n return fallback || key;\r\n }\r\n\r\n /**\r\n * Translate with a specific language temporarily\r\n *\r\n * @param key Translation key\r\n * @param lang Language code\r\n * @param params Optional parameters\r\n */\r\n public tLang(key: string, lang: types.LanguageCode, params?: Record<string, string>): string {\r\n const original = this.currentLanguage;\r\n this.currentLanguage = lang;\r\n const result = this.t(key, params);\r\n this.currentLanguage = original;\r\n return result;\r\n }\r\n\r\n /**\r\n * Translate and parse HTML-like tags into tokens\r\n * Converts \\n or /n to line breaks\r\n *\r\n * @example\r\n * // Translation: \"Hello\\nWorld <strong>here</strong>\"\r\n * tParse('message')\r\n * // => [\r\n * // { type: 'text', content: 'Hello' },\r\n * // { type: 'tag', tag: 'br', content: '' },\r\n * // { type: 'text', content: 'World ' },\r\n * // { type: 'tag', tag: 'strong', content: 'here' }\r\n * // ]\r\n *\r\n * @param key Translation key\r\n * @param params Optional parameters\r\n * @returns Array of tokens\r\n */\r\n public tParse(key: string, params?: Record<string, string>): types.TranslationToken[] {\r\n let translation = this.t(key, params);\r\n\r\n // Convert newlines to <br> tags\r\n translation = translation.replace(/\\\\n|\\/n/g, '<br>');\r\n\r\n const tokens: types.TranslationToken[] = [];\r\n const regex = /<([a-z]+)>([^<]*)<\\/\\1>|<([a-z]+)\\s*\\/?>|([^<]+)/gi;\r\n let match;\r\n\r\n while ((match = regex.exec(translation)) !== null) {\r\n if (match[4]) {\r\n // Plain text\r\n tokens.push({ type: 'text', content: match[4] });\r\n } else if (match[1]) {\r\n // Paired tag: <strong>text</strong>\r\n tokens.push({ type: 'tag', tag: match[1], content: match[2] });\r\n } else if (match[3]) {\r\n // Self-closing: <br> or <br/>\r\n tokens.push({ type: 'tag', tag: match[3], content: '' });\r\n }\r\n }\r\n\r\n return tokens.length > 0 ? tokens : [{ type: 'text', content: translation }];\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌────────────────────────────── LANGUAGE ────────────────────────────┐\r\n\r\n /**\r\n * Set current language\r\n */\r\n public async setLanguage(lang: types.LanguageCode): Promise<void> {\r\n if (!this.supportedLanguages.has(lang)) {\r\n console.warn(`[i18n] Language \"${lang}\" not supported`);\r\n return;\r\n }\r\n\r\n this.currentLanguage = lang;\r\n\r\n // Persist if storage available\r\n if (this.storage) {\r\n await this.storage.set('i18n-language', lang);\r\n }\r\n\r\n // Notify listeners\r\n this.listeners.forEach(fn => fn(lang));\r\n\r\n if (this.onLanguageChange) {\r\n this.onLanguageChange(lang);\r\n }\r\n }\r\n\r\n /**\r\n * Get current language\r\n */\r\n public getLanguage(): types.LanguageCode {\r\n return this.currentLanguage;\r\n }\r\n\r\n /**\r\n * Get all supported languages\r\n */\r\n public getSupportedLanguages(): types.LanguageCode[] {\r\n return Array.from(this.supportedLanguages);\r\n }\r\n\r\n /**\r\n * Check if language is supported\r\n */\r\n public isLanguageSupported(lang: types.LanguageCode): boolean {\r\n return this.supportedLanguages.has(lang);\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌─────────────────────────────── HELPERS ────────────────────────────┐\r\n\r\n /**\r\n * Check if a translation key exists\r\n */\r\n public hasKey(key: string): boolean {\r\n return !!(\r\n this.translations[this.currentLanguage]?.[key] ||\r\n this.translations[this.defaultLanguage]?.[key]\r\n );\r\n }\r\n\r\n /**\r\n * Get all translations for current language\r\n */\r\n public getTranslations(): Record<string, string> {\r\n return this.translations[this.currentLanguage] || {};\r\n }\r\n\r\n /**\r\n * Check if current language is RTL\r\n */\r\n public isRTL(): boolean {\r\n return this.rtlLanguages.has(this.currentLanguage.toLowerCase().substring(0, 2));\r\n }\r\n\r\n /**\r\n * Check if specific language is RTL\r\n */\r\n public isRTLLanguage(lang: types.LanguageCode): boolean {\r\n return this.rtlLanguages.has(lang.toLowerCase().substring(0, 2));\r\n }\r\n\r\n /**\r\n * Subscribe to language changes\r\n * @returns Unsubscribe function\r\n */\r\n public onChange(callback: (lang: types.LanguageCode) => void): () => void {\r\n this.listeners.add(callback);\r\n return () => this.listeners.delete(callback);\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n","// src/index.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n import * as types from './types';\r\n import { I18nManager } from './mod/i18n';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ ════ ════════════════════════════════════════╗\r\n\r\n /**\r\n * Storage adapter for browser (localStorage)\r\n */\r\n const createBrowserStorage = (): types.I18nStorage => ({\r\n get: (key: string) => {\r\n if (typeof localStorage === 'undefined') return null;\r\n return localStorage.getItem(key);\r\n },\r\n set: (key: string, value: string) => {\r\n if (typeof localStorage !== 'undefined') {\r\n localStorage.setItem(key, value);\r\n }\r\n }\r\n });\r\n\r\n /**\r\n * Storage adapter for memory (in-process storage)\r\n */\r\n const createMemoryStorage = (): types.I18nStorage => {\r\n const store = new Map<string, string>();\r\n return {\r\n get: (key: string) => store.get(key) || null,\r\n set: (key: string, value: string) => { store.set(key, value); }\r\n };\r\n };\r\n\r\n /**\r\n * Auto-select appropriate storage based on environment\r\n */\r\n const getDefaultStorage = (): types.I18nStorage => {\r\n return typeof localStorage !== 'undefined' ? createBrowserStorage() : createMemoryStorage();\r\n };\r\n\r\n /**\r\n * Lazy loader: fetch language on-demand\r\n * Supports both URL-based (browser) and file-based (server) loading\r\n */\r\n export class LazyLoader {\r\n private baseUrl: string;\r\n private manager: I18nManager;\r\n private loading = new Map<types.LanguageCode, Promise<void>>();\r\n private loaded = new Set<types.LanguageCode>();\r\n private isServerSide: boolean;\r\n private fileExtension: string;\r\n\r\n constructor(baseUrl: string, manager: I18nManager, fileExtension: string = 'json') {\r\n this.baseUrl = baseUrl.endsWith('/') ? baseUrl : baseUrl + '/';\r\n this.manager = manager;\r\n this.fileExtension = fileExtension;\r\n this.isServerSide = typeof fetch === 'undefined';\r\n }\r\n\r\n /**\r\n * Load a language file on-demand\r\n * Caches the promise to prevent duplicate requests\r\n */\r\n async load(lang: types.LanguageCode): Promise<void> {\r\n // Already loaded\r\n if (this.loaded.has(lang)) {\r\n return;\r\n }\r\n\r\n // Currently loading\r\n if (this.loading.has(lang)) {\r\n return this.loading.get(lang);\r\n }\r\n\r\n // Start loading\r\n const promise = this.doLoad(lang);\r\n this.loading.set(lang, promise);\r\n\r\n try {\r\n await promise;\r\n this.loaded.add(lang);\r\n } finally {\r\n this.loading.delete(lang);\r\n }\r\n }\r\n\r\n private async doLoad(lang: types.LanguageCode): Promise<void> {\r\n try {\r\n const filePath = `${this.baseUrl}${lang}.${this.fileExtension}`;\r\n\r\n let data: Record<string, string> | null;\r\n\r\n // Check if it's a local file path (relative or absolute)\r\n const isLocalPath = filePath.startsWith('.') || filePath.startsWith('/') || /^[a-zA-Z]:/.test(filePath);\r\n\r\n if (isLocalPath || this.isServerSide) {\r\n // Node.js/local: Read from filesystem\r\n data = await this.loadFromFile(filePath);\r\n } else {\r\n // Browser: Fetch from URL\r\n data = await this.loadFromUrl(filePath);\r\n }\r\n\r\n if (data) {\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n this.manager.loadLanguage(lang, data as Record<string, any>);\r\n }\r\n } catch (error) {\r\n console.warn(`[i18n] Error loading language: ${lang}`, error);\r\n }\r\n }\r\n\r\n private async loadFromUrl(url: string): Promise<Record<string, string> | null> {\r\n try {\r\n const response = await fetch(url);\r\n\r\n if (response.ok) {\r\n return await response.json();\r\n } else {\r\n console.warn(`[i18n] Failed to load language from URL: ${url} (${response.status})`);\r\n return null;\r\n }\r\n } catch (error) {\r\n console.warn(`[i18n] Error fetching from URL: ${url}`, error);\r\n return null;\r\n }\r\n }\r\n\r\n private async loadFromFile(filePath: string): Promise<Record<string, string> | null> {\r\n try {\r\n // Dynamic import to avoid issues in browsers\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n const fs = await import('fs').then(m => m.promises).catch((): any => null);\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n const path = await import('path').then(m => m).catch((): any => null);\r\n\r\n if (!fs) {\r\n console.warn('[i18n] fs module not available. Running in browser?');\r\n return null;\r\n }\r\n\r\n // Resolve relative paths to absolute paths\r\n let resolvedPath = filePath;\r\n if (path && !path.isAbsolute(filePath)) {\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n const process = await import('process').then(m => m).catch((): any => null);\r\n if (process) {\r\n resolvedPath = path.resolve(process.cwd(), filePath);\r\n }\r\n }\r\n\r\n const content = await fs.readFile(resolvedPath, 'utf-8');\r\n return JSON.parse(content);\r\n } catch (error) {\r\n console.warn(`[i18n] Error reading file: ${filePath}`, error);\r\n return null;\r\n }\r\n }\r\n\r\n isLoaded(lang: types.LanguageCode): boolean {\r\n return this.loaded.has(lang);\r\n }\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ ════ ════════════════════════════════════════╗\r\n\r\n let instance: I18nManager | null = null;\r\n let lazyLoader: LazyLoader | null = null;\r\n\r\n /**\r\n * Get browser language preference\r\n * Uses navigator.language if available (browser environment)\r\n * @private\r\n */\r\n function detectBrowserLanguage(): string {\r\n if (typeof navigator !== 'undefined' && navigator.language) {\r\n return navigator.language.split('-')[0].toLowerCase();\r\n }\r\n return 'en';\r\n }\r\n\r\n /**\r\n * Check if running in browser environment\r\n * @private\r\n */\r\n function isBrowser(): boolean {\r\n return typeof fetch !== 'undefined' && typeof window !== 'undefined';\r\n }\r\n\r\n /**\r\n * Get or create the global i18n instance\r\n */\r\n export function getI18n(): I18nManager {\r\n if (!instance) {\r\n instance = new I18nManager();\r\n }\r\n return instance;\r\n }\r\n\r\n /**\r\n * Get the lazy loader instance (only available after setupI18n with basePath)\r\n */\r\n export function getLazyLoader(): LazyLoader | null {\r\n return lazyLoader;\r\n }\r\n\r\n /**\r\n * Main setup function - Single, simple, auto-detecting initialization\r\n *\r\n * Auto-detects environment and handles both browser and server:\r\n * - Browser: Auto-detects language, loads from URL path\r\n * - Server: Uses defaultLanguage, loads from file system\r\n *\r\n * Call this ONCE at app startup.\r\n *\r\n * @example\r\n * // Browser - Auto-detects language, lazy-loads from URL\r\n * await setupI18n({\r\n * supportedLanguages: ['en', 'ar', 'fr'],\r\n * basePath: '/i18n/'\r\n * });\r\n *\r\n * @example\r\n * // Server - Uses default language, lazy-loads from filesystem\r\n * await setupI18n({\r\n * defaultLanguage: 'en',\r\n * supportedLanguages: ['en', 'ar', 'fr'],\r\n * basePath: './locales/'\r\n * });\r\n */\r\n export async function setupI18n(\r\n config: types.I18nConfig & { basePath?: string }\r\n ): Promise<I18nManager> {\r\n // Auto-detect browser language if in browser and no defaultLanguage specified\r\n if (isBrowser() && !config.defaultLanguage) {\r\n const detectedLang = detectBrowserLanguage();\r\n if (config.supportedLanguages?.includes(detectedLang)) {\r\n config.defaultLanguage = detectedLang;\r\n } else {\r\n config.defaultLanguage = config.supportedLanguages?.[0] || 'en';\r\n }\r\n }\r\n\r\n // Use appropriate storage based on environment\r\n if (!config.storage) {\r\n config.storage = getDefaultStorage();\r\n }\r\n\r\n // Create and initialize manager\r\n instance = new I18nManager(config);\r\n await instance.init();\r\n\r\n // Setup lazy loading if basePath provided\r\n if (config.basePath) {\r\n const fileExtension = config.fileExtension || 'json';\r\n lazyLoader = new LazyLoader(config.basePath, instance, fileExtension);\r\n await lazyLoader.load(instance.getLanguage());\r\n }\r\n\r\n return instance;\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ ════ ════════════════════════════════════════╗\r\n\r\n /**\r\n * Translate a key with optional parameter replacement\r\n */\r\n export const t = (key: string, params?: Record<string, string>) =>\r\n getI18n().t(key, params);\r\n\r\n /**\r\n * Translate a key with a specific language temporarily\r\n */\r\n export const tLang = (key: string, lang: types.LanguageCode, params?: Record<string, string>) =>\r\n getI18n().tLang(key, lang, params);\r\n\r\n /**\r\n * Parse translation with HTML tags into tokens\r\n */\r\n export const tParse = (key: string, params?: Record<string, string>) =>\r\n getI18n().tParse(key, params);\r\n\r\n /**\r\n * Set current language and trigger listeners\r\n */\r\n export const setLanguage = async (lang: types.LanguageCode): Promise<void> => {\r\n // Load language if lazy loader available\r\n if (lazyLoader && !lazyLoader.isLoaded(lang)) {\r\n return lazyLoader.load(lang).then(() => getI18n().setLanguage(lang));\r\n }\r\n return getI18n().setLanguage(lang);\r\n };\r\n\r\n /**\r\n * Get current language code\r\n */\r\n export const getLanguage = () =>\r\n getI18n().getLanguage();\r\n\r\n /**\r\n * Get all supported languages\r\n */\r\n export const getSupportedLanguages = () =>\r\n getI18n().getSupportedLanguages();\r\n\r\n /**\r\n * Check if translation key exists\r\n */\r\n export const hasKey = (key: string) =>\r\n getI18n().hasKey(key);\r\n\r\n /**\r\n * Check if current language is RTL\r\n */\r\n export const isRTL = () =>\r\n getI18n().isRTL();\r\n\r\n /**\r\n * Check if specific language is RTL\r\n */\r\n export const isRTLLanguage = (lang: types.LanguageCode) =>\r\n getI18n().isRTLLanguage(lang);\r\n\r\n /**\r\n * Subscribe to language changes\r\n */\r\n export const onChange = (callback: (lang: types.LanguageCode) => void) =>\r\n getI18n().onChange(callback);\r\n\r\n /**\r\n * Load translations for a specific language\r\n */\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n export const loadLanguage = (lang: types.LanguageCode, translations: Record<string, any>) =>\r\n getI18n().loadLanguage(lang, translations);\r\n\r\n /**\r\n * Load multiple languages at once\r\n */\r\n export const loadTranslations = (translations: types.TranslationSet) =>\r\n getI18n().loadTranslations(translations);\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ ════ ════════════════════════════════════════╗\r\n\r\n /**\r\n * Generate page title with proper RTL handling\r\n *\r\n * @example\r\n * // English: \"Profile - MyApp\"\r\n * // Arabic: \"MyApp - الملف الشخصي\"\r\n */\r\n export function genPageTitle(key: string, prefix: string = 'page.'): string {\r\n const appName = t('app.name');\r\n const pageName = t(prefix + key);\r\n return isRTL() ? `${appName} - ${pageName}` : `${pageName} - ${appName}`;\r\n }\r\n\r\n /**\r\n * Pluralization helper - select translation based on count\r\n *\r\n * @example\r\n * plural(1, 'item.single', 'item.plural') // \"1 item\"\r\n * plural(5, 'item.single', 'item.plural') // \"5 items\"\r\n */\r\n export function plural(count: number, singleKey: string, pluralKey: string): string {\r\n const key = count === 1 ? singleKey : pluralKey;\r\n return t(key, { count: String(count) });\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ ════ ════════════════════════════════════════╗\r\n\r\n export default {\r\n setupI18n,\r\n getI18n,\r\n getLazyLoader,\r\n I18nManager,\r\n LazyLoader,\r\n t,\r\n tLang,\r\n tParse,\r\n setLanguage,\r\n getLanguage,\r\n getSupportedLanguages,\r\n hasKey,\r\n isRTL,\r\n isRTLLanguage,\r\n onChange,\r\n loadLanguage,\r\n loadTranslations,\r\n genPageTitle,\r\n plural,\r\n };\r\n\r\n export type I18nManagerInstance = InstanceType<typeof I18nManager>;\r\n export type LazyLoaderInstance = InstanceType<typeof LazyLoader>;\r\n\r\n export * from './mod/i18n';\r\n export * from './types';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n"]}
1
+ {"version":3,"sources":["../src/mod/i18n.ts","../src/index.ts"],"names":["I18nManager","config","stored","lang","translations","flattened","trans","obj","prefix","key","value","newKey","params","translation","param","paramValue","fallback","original","result","tokens","regex","match","fn","callback","createBrowserStorage","createMemoryStorage","store","getDefaultStorage","LazyLoader","baseUrl","manager","fileExtension","promise","filePath","data","error","url","response","fs","m","path","resolvedPath","process","content","instance","lazyLoader","detectBrowserLanguage","isBrowser","getI18n","getLazyLoader","setupI18n","detectedLang","t","tLang","tParse","setLanguage","getLanguage","getSupportedLanguages","hasKey","isRTL","isRTLLanguage","onChange","loadLanguage","loadTranslations","genPageTitle","appName","pageName","plural","count","singleKey","pluralKey","index_default"],"mappings":"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","file":"index.js","sourcesContent":["// src/mod/i18n.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n import * as types from '../types';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n export class I18nManager {\r\n\r\n // ┌──────────────────────────────── INIT ──────────────────────────────┐\r\n\r\n private translations : types.TranslationSet = {};\r\n private currentLanguage : types.LanguageCode = 'en';\r\n private defaultLanguage : types.LanguageCode = 'en';\r\n private supportedLanguages = new Set<types.LanguageCode>(['en']);\r\n private rtlLanguages = new Set<string>(['ar', 'he', 'fa', 'ur', 'yi', 'ji', 'iw', 'ku']);\r\n private listeners = new Set<(lang: types.LanguageCode) => void>();\r\n private storage? : types.I18nStorage;\r\n private onLanguageChange? : (lang: types.LanguageCode) => void;\r\n\r\n constructor(config?: types.I18nConfig) {\r\n if (config) {\r\n this.defaultLanguage = config.defaultLanguage || 'en';\r\n this.currentLanguage = config.defaultLanguage || 'en';\r\n this.storage = config.storage;\r\n this.onLanguageChange = config.onLanguageChange;\r\n\r\n if (config.supportedLanguages) {\r\n this.supportedLanguages = new Set(config.supportedLanguages);\r\n }\r\n }\r\n }\r\n\r\n /**\r\n * Initialize with stored language preference\r\n */\r\n public async init(): Promise<void> {\r\n if (this.storage) {\r\n const stored = await this.storage.get('i18n-language');\r\n if (stored && this.supportedLanguages.has(stored)) {\r\n this.currentLanguage = stored;\r\n }\r\n }\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌──────────────────────────────── LOAD ──────────────────────────────┐\r\n\r\n /**\r\n * Load translations for a specific language\r\n * @param lang Language code\r\n * @param translations Translation object (can be nested)\r\n */\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n public loadLanguage(lang: types.LanguageCode, translations: Record<string, any>): void {\r\n if (!this.translations[lang]) {\r\n this.translations[lang] = {};\r\n }\r\n\r\n const flattened = this.flattenObject(translations);\r\n this.translations[lang] = { ...this.translations[lang], ...flattened };\r\n this.supportedLanguages.add(lang);\r\n }\r\n\r\n /**\r\n * Load multiple languages at once\r\n * @param translations Object with language codes as keys\r\n */\r\n public loadTranslations(translations: types.TranslationSet): void {\r\n Object.entries(translations).forEach(([lang, trans]) => {\r\n this.loadLanguage(lang, trans);\r\n });\r\n }\r\n\r\n /**\r\n * Flatten nested object into dot notation\r\n * @private\r\n */\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n private flattenObject(obj: Record<string, any>, prefix: string = ''): Record<string, string> {\r\n const flattened: Record<string, string> = {};\r\n\r\n for (const key in obj) {\r\n if (!Object.prototype.hasOwnProperty.call(obj, key)) continue;\r\n\r\n const value = obj[key];\r\n const newKey = prefix ? `${prefix}.${key}` : key;\r\n\r\n if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\r\n Object.assign(flattened, this.flattenObject(value, newKey));\r\n } else {\r\n flattened[newKey] = String(value);\r\n }\r\n }\r\n\r\n return flattened;\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌───────────────────────────── TRANSLATION ──────────────────────────┐\r\n\r\n /**\r\n * Translate a key with parameter replacement\r\n *\r\n * @example\r\n * t('welcome.message', { name: 'John' })\r\n * // => \"Welcome, John!\"\r\n *\r\n * @param key Translation key (dot notation)\r\n * @param params Optional parameters for replacement\r\n * @returns Translated string\r\n */\r\n public t(key: string, params?: Record<string, string>): string {\r\n let translation = this.getTranslation(key);\r\n\r\n if (params) {\r\n Object.entries(params).forEach(([param, value]) => {\r\n // Check if parameter value is itself a translation key\r\n const paramValue = this.getTranslation(value, value);\r\n translation = translation.replace(\r\n new RegExp(`\\\\{${param}\\\\}`, 'g'),\r\n paramValue\r\n );\r\n });\r\n }\r\n\r\n return translation;\r\n }\r\n\r\n /**\r\n * Get raw translation without parameter replacement\r\n * @private\r\n */\r\n private getTranslation(key: string, fallback?: string): string {\r\n // Try current language\r\n if (this.translations[this.currentLanguage]?.[key]) {\r\n return this.translations[this.currentLanguage][key];\r\n }\r\n\r\n // Try default language\r\n if (this.defaultLanguage !== this.currentLanguage &&\r\n this.translations[this.defaultLanguage]?.[key]) {\r\n return this.translations[this.defaultLanguage][key];\r\n }\r\n\r\n // Warn and return fallback\r\n console.warn(`[i18n] Translation key not found: \"${key}\" (lang: ${this.currentLanguage})`);\r\n return fallback || key;\r\n }\r\n\r\n /**\r\n * Translate with a specific language temporarily\r\n *\r\n * @param key Translation key\r\n * @param lang Language code\r\n * @param params Optional parameters\r\n */\r\n public tLang(key: string, lang: types.LanguageCode, params?: Record<string, string>): string {\r\n const original = this.currentLanguage;\r\n this.currentLanguage = lang;\r\n const result = this.t(key, params);\r\n this.currentLanguage = original;\r\n return result;\r\n }\r\n\r\n /**\r\n * Translate and parse HTML-like tags into tokens\r\n * Converts \\n or /n to line breaks\r\n *\r\n * @example\r\n * // Translation: \"Hello\\nWorld <strong>here</strong>\"\r\n * tParse('message')\r\n * // => [\r\n * // { type: 'text', content: 'Hello' },\r\n * // { type: 'tag', tag: 'br', content: '' },\r\n * // { type: 'text', content: 'World ' },\r\n * // { type: 'tag', tag: 'strong', content: 'here' }\r\n * // ]\r\n *\r\n * @param key Translation key\r\n * @param params Optional parameters\r\n * @returns Array of tokens\r\n */\r\n public tParse(key: string, params?: Record<string, string>): types.TranslationToken[] {\r\n let translation = this.t(key, params);\r\n\r\n // Convert newlines to <br> tags\r\n translation = translation.replace(/\\\\n|\\/n/g, '<br>');\r\n\r\n const tokens: types.TranslationToken[] = [];\r\n const regex = /<([a-z]+)>([^<]*)<\\/\\1>|<([a-z]+)\\s*\\/?>|([^<]+)/gi;\r\n let match;\r\n\r\n while ((match = regex.exec(translation)) !== null) {\r\n if (match[4]) {\r\n // Plain text\r\n tokens.push({ type: 'text', content: match[4] });\r\n } else if (match[1]) {\r\n // Paired tag: <strong>text</strong>\r\n tokens.push({ type: 'tag', tag: match[1], content: match[2] });\r\n } else if (match[3]) {\r\n // Self-closing: <br> or <br/>\r\n tokens.push({ type: 'tag', tag: match[3], content: '' });\r\n }\r\n }\r\n\r\n return tokens.length > 0 ? tokens : [{ type: 'text', content: translation }];\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌────────────────────────────── LANGUAGE ────────────────────────────┐\r\n\r\n /**\r\n * Set current language\r\n */\r\n public async setLanguage(lang: types.LanguageCode): Promise<void> {\r\n if (!this.supportedLanguages.has(lang)) {\r\n console.warn(`[i18n] Language \"${lang}\" not supported`);\r\n return;\r\n }\r\n\r\n this.currentLanguage = lang;\r\n\r\n // Persist if storage available\r\n if (this.storage) {\r\n await this.storage.set('i18n-language', lang);\r\n }\r\n\r\n // Notify listeners\r\n this.listeners.forEach(fn => fn(lang));\r\n\r\n if (this.onLanguageChange) {\r\n this.onLanguageChange(lang);\r\n }\r\n }\r\n\r\n /**\r\n * Get current language\r\n */\r\n public getLanguage(): types.LanguageCode {\r\n return this.currentLanguage;\r\n }\r\n\r\n /**\r\n * Get all supported languages\r\n */\r\n public getSupportedLanguages(): types.LanguageCode[] {\r\n return Array.from(this.supportedLanguages);\r\n }\r\n\r\n /**\r\n * Check if language is supported\r\n */\r\n public isLanguageSupported(lang: types.LanguageCode): boolean {\r\n return this.supportedLanguages.has(lang);\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n\r\n // ┌─────────────────────────────── HELPERS ────────────────────────────┐\r\n\r\n /**\r\n * Check if a translation key exists\r\n */\r\n public hasKey(key: string): boolean {\r\n return !!(\r\n this.translations[this.currentLanguage]?.[key] ||\r\n this.translations[this.defaultLanguage]?.[key]\r\n );\r\n }\r\n\r\n /**\r\n * Get all translations for current language\r\n */\r\n public getTranslations(): Record<string, string> {\r\n return this.translations[this.currentLanguage] || {};\r\n }\r\n\r\n /**\r\n * Check if current language is RTL\r\n */\r\n public isRTL(): boolean {\r\n return this.rtlLanguages.has(this.currentLanguage.toLowerCase().substring(0, 2));\r\n }\r\n\r\n /**\r\n * Check if specific language is RTL\r\n */\r\n public isRTLLanguage(lang: types.LanguageCode): boolean {\r\n return this.rtlLanguages.has(lang.toLowerCase().substring(0, 2));\r\n }\r\n\r\n /**\r\n * Subscribe to language changes\r\n * @returns Unsubscribe function\r\n */\r\n public onChange(callback: (lang: types.LanguageCode) => void): () => void {\r\n this.listeners.add(callback);\r\n return () => this.listeners.delete(callback);\r\n }\r\n\r\n // └────────────────────────────────────────────────────────────────────┘\r\n\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n","// src/index.ts\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n import * as types from './types';\r\n import { I18nManager } from './mod/i18n';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n /**\r\n * Storage adapter for browser (localStorage)\r\n */\r\n const createBrowserStorage = (): types.I18nStorage => ({\r\n get: (key: string) => {\r\n if (typeof localStorage === 'undefined') return null;\r\n return localStorage.getItem(key);\r\n },\r\n set: (key: string, value: string) => {\r\n if (typeof localStorage !== 'undefined') {\r\n localStorage.setItem(key, value);\r\n }\r\n }\r\n });\r\n\r\n /**\r\n * Storage adapter for memory (in-process storage)\r\n */\r\n const createMemoryStorage = (): types.I18nStorage => {\r\n const store = new Map<string, string>();\r\n return {\r\n get: (key: string) => store.get(key) || null,\r\n set: (key: string, value: string) => { store.set(key, value); }\r\n };\r\n };\r\n\r\n /**\r\n * Auto-select appropriate storage based on environment\r\n */\r\n const getDefaultStorage = (): types.I18nStorage => {\r\n return typeof localStorage !== 'undefined' ? createBrowserStorage() : createMemoryStorage();\r\n };\r\n\r\n /**\r\n * Lazy loader: fetch language on-demand\r\n * Supports both URL-based (browser) and file-based (server) loading\r\n */\r\n export class LazyLoader {\r\n private baseUrl: string;\r\n private manager: I18nManager;\r\n private loading = new Map<types.LanguageCode, Promise<void>>();\r\n private loaded = new Set<types.LanguageCode>();\r\n private isServerSide: boolean;\r\n private fileExtension: string;\r\n\r\n constructor(baseUrl: string, manager: I18nManager, fileExtension: string = 'json') {\r\n this.baseUrl = baseUrl.endsWith('/') ? baseUrl : baseUrl + '/';\r\n this.manager = manager;\r\n this.fileExtension = fileExtension;\r\n this.isServerSide = typeof fetch === 'undefined';\r\n }\r\n\r\n /**\r\n * Load a language file on-demand\r\n * Caches the promise to prevent duplicate requests\r\n */\r\n async load(lang: types.LanguageCode): Promise<void> {\r\n // Already loaded\r\n if (this.loaded.has(lang)) {\r\n return;\r\n }\r\n\r\n // Currently loading\r\n if (this.loading.has(lang)) {\r\n return this.loading.get(lang);\r\n }\r\n\r\n // Start loading\r\n const promise = this.doLoad(lang);\r\n this.loading.set(lang, promise);\r\n\r\n try {\r\n await promise;\r\n this.loaded.add(lang);\r\n } finally {\r\n this.loading.delete(lang);\r\n }\r\n }\r\n\r\n private async doLoad(lang: types.LanguageCode): Promise<void> {\r\n try {\r\n const filePath = `${this.baseUrl}${lang}.${this.fileExtension}`;\r\n\r\n let data: Record<string, string> | null;\r\n\r\n // Check if it's a local file path (relative or absolute)\r\n const isLocalPath = filePath.startsWith('.') || filePath.startsWith('/') || /^[a-zA-Z]:/.test(filePath);\r\n\r\n if (isLocalPath || this.isServerSide) {\r\n // Node.js/local: Read from filesystem\r\n data = await this.loadFromFile(filePath);\r\n } else {\r\n // Browser: Fetch from URL\r\n data = await this.loadFromUrl(filePath);\r\n }\r\n\r\n if (data) {\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n this.manager.loadLanguage(lang, data as Record<string, any>);\r\n }\r\n } catch (error) {\r\n console.warn(`[i18n] Error loading language: ${lang}`, error);\r\n }\r\n }\r\n\r\n private async loadFromUrl(url: string): Promise<Record<string, string> | null> {\r\n try {\r\n const response = await fetch(url);\r\n\r\n if (response.ok) {\r\n return await response.json();\r\n } else {\r\n console.warn(`[i18n] Failed to load language from URL: ${url} (${response.status})`);\r\n return null;\r\n }\r\n } catch (error) {\r\n console.warn(`[i18n] Error fetching from URL: ${url}`, error);\r\n return null;\r\n }\r\n }\r\n\r\n private async loadFromFile(filePath: string): Promise<Record<string, string> | null> {\r\n try {\r\n // Dynamic import to avoid issues in browsers\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n const fs = await import('fs').then(m => m.promises).catch((): any => null);\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n const path = await import('path').then(m => m).catch((): any => null);\r\n\r\n if (!fs) {\r\n console.warn('[i18n] fs module not available. Running in browser?');\r\n return null;\r\n }\r\n\r\n // Resolve relative paths to absolute paths\r\n let resolvedPath = filePath;\r\n if (path && !path.isAbsolute(filePath)) {\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n const process = await import('process').then(m => m).catch((): any => null);\r\n if (process) {\r\n resolvedPath = path.resolve(process.cwd(), filePath);\r\n }\r\n }\r\n\r\n const content = await fs.readFile(resolvedPath, 'utf-8');\r\n return JSON.parse(content);\r\n } catch (error) {\r\n console.warn(`[i18n] Error reading file: ${filePath}`, error);\r\n return null;\r\n }\r\n }\r\n\r\n isLoaded(lang: types.LanguageCode): boolean {\r\n return this.loaded.has(lang);\r\n }\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ ════ ════════════════════════════════════════╗\r\n\r\n let instance: I18nManager | null = null;\r\n let lazyLoader: LazyLoader | null = null;\r\n\r\n /**\r\n * Get browser language preference\r\n * Uses navigator.language if available (browser environment)\r\n * @private\r\n */\r\n function detectBrowserLanguage(): string {\r\n if (typeof navigator !== 'undefined' && navigator.language) {\r\n return navigator.language.split('-')[0].toLowerCase();\r\n }\r\n return 'en';\r\n }\r\n\r\n /**\r\n * Check if running in browser environment\r\n * @private\r\n */\r\n function isBrowser(): boolean {\r\n return typeof fetch !== 'undefined' && typeof window !== 'undefined';\r\n }\r\n\r\n /**\r\n * Get or create the global i18n instance\r\n */\r\n export function getI18n(): I18nManager {\r\n if (!instance) {\r\n instance = new I18nManager();\r\n }\r\n return instance;\r\n }\r\n\r\n /**\r\n * Get the lazy loader instance (only available after setupI18n with basePath)\r\n */\r\n export function getLazyLoader(): LazyLoader | null {\r\n return lazyLoader;\r\n }\r\n\r\n /**\r\n * Main setup function - Single, simple, auto-detecting initialization\r\n *\r\n * Auto-detects environment and handles both browser and server:\r\n * - Browser: Auto-detects language, loads from URL path\r\n * - Server: Uses defaultLanguage, loads from file system\r\n *\r\n * Call this ONCE at app startup.\r\n *\r\n * @example\r\n * // Browser - Auto-detects language, lazy-loads from URL\r\n * await setupI18n({\r\n * supportedLanguages: ['en', 'ar', 'fr'],\r\n * basePath: '/i18n/'\r\n * });\r\n *\r\n * @example\r\n * // Server - Uses default language, lazy-loads from filesystem\r\n * await setupI18n({\r\n * defaultLanguage: 'en',\r\n * supportedLanguages: ['en', 'ar', 'fr'],\r\n * basePath: './locales/'\r\n * });\r\n */\r\n export async function setupI18n(\r\n config: types.I18nConfig & { basePath?: string }\r\n ): Promise<I18nManager> {\r\n // Auto-detect browser language if in browser and no defaultLanguage specified\r\n if (isBrowser() && !config.defaultLanguage) {\r\n const detectedLang = detectBrowserLanguage();\r\n if (config.supportedLanguages?.includes(detectedLang)) {\r\n config.defaultLanguage = detectedLang;\r\n } else {\r\n config.defaultLanguage = config.supportedLanguages?.[0] || 'en';\r\n }\r\n }\r\n\r\n // Use appropriate storage based on environment\r\n if (!config.storage) {\r\n config.storage = getDefaultStorage();\r\n }\r\n\r\n // Create and initialize manager\r\n instance = new I18nManager(config);\r\n await instance.init();\r\n\r\n // Setup lazy loading if basePath provided\r\n if (config.basePath) {\r\n const fileExtension = config.fileExtension || 'json';\r\n lazyLoader = new LazyLoader(config.basePath, instance, fileExtension);\r\n await lazyLoader.load(instance.getLanguage());\r\n }\r\n\r\n return instance;\r\n }\r\n\r\n\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CONVENIENCE FUNCTIONS ════════════════════════════════════════╗\r\n\r\n /**\r\n * Translate a key with optional parameter replacement\r\n */\r\n export const t = (key: string, params?: Record<string, string>) =>\r\n getI18n().t(key, params);\r\n\r\n /**\r\n * Translate a key with a specific language temporarily\r\n */\r\n export const tLang = (key: string, lang: types.LanguageCode, params?: Record<string, string>) =>\r\n getI18n().tLang(key, lang, params);\r\n\r\n /**\r\n * Parse translation with HTML tags into tokens\r\n */\r\n export const tParse = (key: string, params?: Record<string, string>) =>\r\n getI18n().tParse(key, params);\r\n\r\n /**\r\n * Set current language and trigger listeners\r\n */\r\n export const setLanguage = (lang: types.LanguageCode): Promise<void> => {\r\n // Load language if lazy loader available\r\n if (lazyLoader && !lazyLoader.isLoaded(lang)) {\r\n return lazyLoader.load(lang).then(() => getI18n().setLanguage(lang));\r\n }\r\n return getI18n().setLanguage(lang);\r\n };\r\n\r\n /**\r\n * Get current language code\r\n */\r\n export const getLanguage = () =>\r\n getI18n().getLanguage();\r\n\r\n /**\r\n * Get all supported languages\r\n */\r\n export const getSupportedLanguages = () =>\r\n getI18n().getSupportedLanguages();\r\n\r\n /**\r\n * Check if translation key exists\r\n */\r\n export const hasKey = (key: string) =>\r\n getI18n().hasKey(key);\r\n\r\n /**\r\n * Check if current language is RTL\r\n */\r\n export const isRTL = () =>\r\n getI18n().isRTL();\r\n\r\n /**\r\n * Check if specific language is RTL\r\n */\r\n export const isRTLLanguage = (lang: types.LanguageCode) =>\r\n getI18n().isRTLLanguage(lang);\r\n\r\n /**\r\n * Subscribe to language changes\r\n */\r\n export const onChange = (callback: (lang: types.LanguageCode) => void) =>\r\n getI18n().onChange(callback);\r\n\r\n /**\r\n * Load translations for a specific language\r\n */\r\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n export const loadLanguage = (lang: types.LanguageCode, translations: Record<string, any>) =>\r\n getI18n().loadLanguage(lang, translations);\r\n\r\n /**\r\n * Load multiple languages at once\r\n */\r\n export const loadTranslations = (translations: types.TranslationSet) =>\r\n getI18n().loadTranslations(translations);\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ UTILITY FUNCTIONS ════════════════════════════════════════╗\r\n\r\n /**\r\n * Generate page title with proper RTL handling\r\n *\r\n * @example\r\n * // English: \"Profile - MyApp\"\r\n * // Arabic: \"MyApp - الملف الشخصي\"\r\n */\r\n export function genPageTitle(key: string, prefix: string = 'page.'): string {\r\n const appName = t('app.name');\r\n const pageName = t(prefix + key);\r\n return isRTL() ? `${appName} - ${pageName}` : `${pageName} - ${appName}`;\r\n }\r\n\r\n /**\r\n * Pluralization helper - select translation based on count\r\n *\r\n * @example\r\n * plural(1, 'item.single', 'item.plural') // \"1 item\"\r\n * plural(5, 'item.single', 'item.plural') // \"5 items\"\r\n */\r\n export function plural(count: number, singleKey: string, pluralKey: string): string {\r\n const key = count === 1 ? singleKey : pluralKey;\r\n return t(key, { count: String(count) });\r\n }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ EXPORTS ════════════════════════════════════════╗\r\n\r\n export default {\r\n setupI18n,\r\n getI18n,\r\n getLazyLoader,\r\n I18nManager,\r\n LazyLoader,\r\n t,\r\n tLang,\r\n tParse,\r\n setLanguage,\r\n getLanguage,\r\n getSupportedLanguages,\r\n hasKey,\r\n isRTL,\r\n isRTLLanguage,\r\n onChange,\r\n loadLanguage,\r\n loadTranslations,\r\n genPageTitle,\r\n plural,\r\n };\r\n\r\n export type I18nManagerInstance = InstanceType<typeof I18nManager>;\r\n export type LazyLoaderInstance = InstanceType<typeof LazyLoader>;\r\n\r\n export * from './mod/i18n';\r\n export * from './types';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@minejs/i18n",
3
- "version": "0.0.5",
3
+ "version": "0.0.7",
4
4
  "description": "A lightweight, production-ready internationalization (i18n) library with zero dependencies.",
5
5
  "keywords": ["minejs", "i18n"],
6
6
  "license": "MIT",
@@ -41,7 +41,7 @@
41
41
  },
42
42
  "devDependencies": {
43
43
  "@eslint/js": "^9.39.2",
44
- "@stylistic/eslint-plugin": "^5.6.1",
44
+ "@stylistic/eslint-plugin": "^5.7.0",
45
45
  "@types/bun": "^1.3.5",
46
46
  "@types/node": "^20.19.27",
47
47
  "bun-plugin-dts": "^0.3.0",
@@ -49,6 +49,6 @@
49
49
  "ts-node": "^10.9.2",
50
50
  "tsup": "^8.5.1",
51
51
  "typescript": "^5.9.3",
52
- "typescript-eslint": "^8.51.0"
52
+ "typescript-eslint": "^8.52.0"
53
53
  }
54
54
  }