@mmstack/translate 19.1.2 → 19.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +284 -284
- package/fesm2022/mmstack-translate.mjs +10 -9
- package/fesm2022/mmstack-translate.mjs.map +1 -1
- package/lib/create-namespace.d.ts +1 -1
- package/lib/register-namespace.d.ts +1 -1
- package/package.json +1 -1
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2025-present Miha J. Mulec
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025-present Miha J. Mulec
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,284 +1,284 @@
|
|
|
1
|
-
# @mmstack/translate
|
|
2
|
-
|
|
3
|
-
**Type-Safe & modular localization for Modern Angular.**
|
|
4
|
-
|
|
5
|
-
[](https://badge.fury.io/js/%40mmstack%2Ftranslate)
|
|
6
|
-
[](https://github.com/mihajm/mmstack/blob/master/LICENSE)
|
|
7
|
-
[](CONTRIBUTING.md)
|
|
8
|
-
|
|
9
|
-
`@mmstack/translate` is an opinionated internationalization (i18n) library for Angular applications built with three core priorities:
|
|
10
|
-
|
|
11
|
-
1. **Maximum Type Safety:** Catch errors related to missing keys or incorrect/missing parameters at compile time.
|
|
12
|
-
2. **Simplified Build Process:** Lazily load translations at runtime, requiring only a **single application build** regardless of the number of supported locales.
|
|
13
|
-
3. **Scalable Modularity:** Organize translations into **namespaces** (typically aligned with feature libraries) and load them on demand.
|
|
14
|
-
|
|
15
|
-
It uses the robust **FormatJS** Intl runtime (`@formatjs/intl`) for ICU message formatting, and integrates with Angular's dependency injection and routing.
|
|
16
|
-
|
|
17
|
-
## Features
|
|
18
|
-
|
|
19
|
-
- ✅ **End-to-End Type Safety:** Compile-time checks for:
|
|
20
|
-
- Translation key existence (within a namespace).
|
|
21
|
-
- Correct parameter names and types.
|
|
22
|
-
- Required vs. optional parameters based on ICU message.
|
|
23
|
-
- Structural consistency check when defining non-default locales.
|
|
24
|
-
- 🚀 **Single Build Artifact:** Runtime translation loading.
|
|
25
|
-
- 📦 **Namespacing:** Organize translations by feature/library (e.g., 'quotes', 'userProfile', 'common').
|
|
26
|
-
- ⏳ **Lazy Loading:** Load namespaced translations on demand using Route Resolvers.
|
|
27
|
-
- ✨ **Reactive API:** Includes `t.asSignal()` for creating computed translation signals based on signal parameters.
|
|
28
|
-
- 🌍 **ICU Message Syntax:** Uses FormatJS runtime for robust support of variables (`{name}`), `plural`, `select`, and `selectordinal`. (Note: Complex inline date/number formats are not the focus; use Angular's built in Pipes/format functions & use the result as variables in your translation.)
|
|
29
|
-
- 🔗 **Shared Namespace Support:** Define common translations (e.g., 'Save', 'Cancel') in one namespace and make them type-safely accessible from others.
|
|
30
|
-
- 🛠️ **Template Helpers:** Includes abstract `BaseTranslatePipe` and `BaseTranslateDirective` for easy, type-safe templating.
|
|
31
|
-
|
|
32
|
-
### Comparison
|
|
33
|
-
|
|
34
|
-
While Angular offers excellent i18n solutions like `@angular/localize` and `transloco`, `@mmstack/translate` aims to fill a specific niche.
|
|
35
|
-
|
|
36
|
-
| Feature | `@mmstack/translate` | `@angular/localize` | `transloco` | `ngx-translate` |
|
|
37
|
-
| :----------------------- | :---------------------------------: | :----------------------: | :---------------------------: | :------------------------: |
|
|
38
|
-
| **Build Process** | ✅ Single Build | ❌ Multi-Build (Typical) | ✅ Single Build | ✅ Single Build |
|
|
39
|
-
| **Translation Timing** | Runtime | Compile Time | Runtime | Runtime |
|
|
40
|
-
| **Type Safety (Keys)** | ✅ Strong (Inferred from structure) | 🟡 via extraction | 🟡 Tooling/TS Files | 🟡 OK Manual/Tooling |
|
|
41
|
-
| **Type Safety (Params)** | ✅ Strong (Inferred from ICU) | ❌ None | 🟡 Manual | 🟡 Manual |
|
|
42
|
-
| **Locale Switching** | 🔄 Page Refresh Required | 🔄 Page Refresh Required | ✅ Dynamic (Runtime) | ✅ Dynamic (Runtime) |
|
|
43
|
-
| **Lazy Loading** | ✅ Built-in (Namespaces/Resolvers) | N/A (Compile Time) | ✅ Built-in (Scopes) | ✅ Yes (Custom Loaders) |
|
|
44
|
-
| **Namespacing/Scopes** | ✅ Built-in | ❌ None | ✅ Built-in (Scopes) | 🟡 Manual (File Structure) |
|
|
45
|
-
| **ICU Support** | ✅ Subset (via FormatJS Runtime) | ✅ Yes (Compile Time) | ✅ Yes (Runtime Intl/Plugins) | 🟡 Via Extensions |
|
|
46
|
-
| **Signal Integration** | ✅ Good (`t.asSignal()`) | N/A | ✅ Good (`translateSignal()`) | ❌ Minimal/None |
|
|
47
|
-
| **Maturity / Community** | ✨ New | Core Angular | ✅ Mature / Active | ✅ Mature |
|
|
48
|
-
|
|
49
|
-
## Installation & Configuration
|
|
50
|
-
|
|
51
|
-
Install the library & its peer dependency, `@formatjs/intl`.
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
npm install @mmstack/translate @formatjs/intl
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
If you'd like to setup @formatjs with custom properties & setup a different default locale then 'en-US' you can define these options at the root of your application.
|
|
58
|
-
|
|
59
|
-
```typescript
|
|
60
|
-
import { provideIntlConfig } from '@mmstack/translate';
|
|
61
|
-
|
|
62
|
-
const appConfig: Providers = [
|
|
63
|
-
provideIntlConfig({
|
|
64
|
-
defaultLocale: 'fr-FR', // defaults to 'en-US' if nothing is provided
|
|
65
|
-
}),
|
|
66
|
-
];
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
```typescript
|
|
70
|
-
import { Component, LOCALE_ID } from '@angular/core';
|
|
71
|
-
import { ActivatedRoute } from '@angular/router';
|
|
72
|
-
|
|
73
|
-
const KNOWN_LOCALES = ['en-US', 'sl-SI'];
|
|
74
|
-
|
|
75
|
-
@Component({
|
|
76
|
-
selector: 'app-locale-shell',
|
|
77
|
-
providers: [
|
|
78
|
-
{
|
|
79
|
-
provide: LOCALE_ID,
|
|
80
|
-
useFactory: (route: ActivatedRoute) => {
|
|
81
|
-
const locale = route.snapshot.paramMap.get('locale') || 'en-US';
|
|
82
|
-
if (KNOWN_LOCALES.includes(locale)) return locale;
|
|
83
|
-
return 'en-US';
|
|
84
|
-
},
|
|
85
|
-
deps: [ActivatedRoute],
|
|
86
|
-
},
|
|
87
|
-
],
|
|
88
|
-
template: `<ng-content />`,
|
|
89
|
-
})
|
|
90
|
-
export class LocaleShellComponent {}
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
_Note:_ `@mmstack/translate` relies on Angular's `LOCALE_ID` provider. You must provide a value for it. How you determine this value (e.g., hardcoded, from server config, from URL segment via a factory provider) is up to your application's architecture. The library assumes this `LOCALE_ID` is static for the duration of the application session and requires a page refresh to change.
|
|
94
|
-
|
|
95
|
-
## Usage
|
|
96
|
-
|
|
97
|
-
The core workflow involves defining namespaces, registering them (often via lazy loading), and then using the injected translation function (t), pipe, or directive.
|
|
98
|
-
|
|
99
|
-
### 1. Define Namespace & Translations
|
|
100
|
-
|
|
101
|
-
Define your default locale translations (e.g., 'en-US') as a `const` TypeScript object. Use createNamespace to process it and generate helpers.
|
|
102
|
-
|
|
103
|
-
```typescript
|
|
104
|
-
// Example: packages/quote/src/lib/quote.namespace.ts
|
|
105
|
-
import { createNamespace } from '@mmstack/translate';
|
|
106
|
-
|
|
107
|
-
// Create the namespace definition object
|
|
108
|
-
const ns = createNamespace('quote', {
|
|
109
|
-
pageTitle: 'Famous Quotes',
|
|
110
|
-
greeting: 'Hello {name}!',
|
|
111
|
-
detail: {
|
|
112
|
-
authorLabel: 'Author',
|
|
113
|
-
},
|
|
114
|
-
errors: {
|
|
115
|
-
minLength: 'Quote must be at least {min} characters long.',
|
|
116
|
-
},
|
|
117
|
-
stats: '{count, plural, one {# quote} other {# quotes}} available',
|
|
118
|
-
}
|
|
119
|
-
|
|
120
|
-
export default ns.translation;
|
|
121
|
-
|
|
122
|
-
export type QuoteLocale = (typeof ns)['translation'];
|
|
123
|
-
|
|
124
|
-
export const createQuoteTranslation = ns.createTranslation;
|
|
125
|
-
|
|
126
|
-
// Note the translations should be in separate files, if you are using import() to lazy load them.
|
|
127
|
-
// packages/quote/src/lib/quote-sl.translation.ts
|
|
128
|
-
|
|
129
|
-
import { createQuoteTranslation } from './quote.namespace';
|
|
130
|
-
|
|
131
|
-
// shape is typesafe (errors if you have missing or additional keys)
|
|
132
|
-
export default createQuoteTranslation({
|
|
133
|
-
pageTitle: 'Znani Citati',
|
|
134
|
-
greeting: 'Zdravo {name}!',
|
|
135
|
-
detail: {
|
|
136
|
-
authorLabel: 'Avtor',
|
|
137
|
-
},
|
|
138
|
-
errors: {
|
|
139
|
-
minLength: 'Citat mora imeti vsaj {min} znakov.', // If original has variables, the translation must contain a subset of used variables (min 1)
|
|
140
|
-
},
|
|
141
|
-
stats: '{count, plural, =1 {# citat} =2 {# citata} few {# citati} other {# citatov}} na voljo', // also guarenteed for "complex" variables, so {count} must be used in this translation
|
|
142
|
-
});
|
|
143
|
-
```
|
|
144
|
-
|
|
145
|
-
### 2. Register the namespace & load
|
|
146
|
-
|
|
147
|
-
Use registerNamespace to prepare your namespace definition and obtain the injectNamespaceT function and the resolveNamespaceTranslation resolver function. Use the resolver in your Angular routes.
|
|
148
|
-
|
|
149
|
-
```typescript
|
|
150
|
-
import q from './quote.namespace';
|
|
151
|
-
|
|
152
|
-
// Register the namespace
|
|
153
|
-
// Example: packages/quote/src/lib/quote.t.ts
|
|
154
|
-
const r = registerNamespace(
|
|
155
|
-
|
|
156
|
-
{
|
|
157
|
-
// Map other locales to promise factories (dynamic imports)
|
|
158
|
-
'sl-SI': () => import('./quote-sl.translation.ts').then((m) => m.default),
|
|
159
|
-
},
|
|
160
|
-
);
|
|
161
|
-
|
|
162
|
-
export const injectQuoteT = r.injectNamespaceT;
|
|
163
|
-
export const resolveQuoteTranslations = r.resolveNamespaceTranslation;
|
|
164
|
-
|
|
165
|
-
// in the main quote route add the provided resolver
|
|
166
|
-
|
|
167
|
-
import { type Routes } from '@angular/router';
|
|
168
|
-
import { resolveQuoteTranslations } from './quote.t';
|
|
169
|
-
|
|
170
|
-
export const MODULE_ROUTES: Routes = [
|
|
171
|
-
// ...
|
|
172
|
-
{
|
|
173
|
-
// ...
|
|
174
|
-
resolve: {
|
|
175
|
-
resolveQuoteTranslations,
|
|
176
|
-
},
|
|
177
|
-
},
|
|
178
|
-
];
|
|
179
|
-
```
|
|
180
|
-
|
|
181
|
-
#### 2b. [OPTIONAL] Configure the translation pipe and/or directive
|
|
182
|
-
|
|
183
|
-
```typescript
|
|
184
|
-
import { Pipe, Directive } from '@angular/core';
|
|
185
|
-
import { BaseTranslatePipe, BaseTranslateDirective } from '@mmstack/translate';
|
|
186
|
-
import { type QuoteLocale } from './quote.namespace';
|
|
187
|
-
|
|
188
|
-
@Pipe({
|
|
189
|
-
name: 'translate',
|
|
190
|
-
})
|
|
191
|
-
export class QuoteTranslatePipe extends BaseTranslatePipe<QuoteLocale> {}
|
|
192
|
-
|
|
193
|
-
@Directive({
|
|
194
|
-
selector: '[translate]', // input in BaseTranslateDirective is named 'translate'
|
|
195
|
-
})
|
|
196
|
-
// TInput is necessary to correctly infer the variables to the key
|
|
197
|
-
export class QuoteTranslateDirective<TInput extends string> extends BaseTranslateDirective<TInput, QuoteLocale> {}
|
|
198
|
-
```
|
|
199
|
-
|
|
200
|
-
### 3. Have fun :)
|
|
201
|
-
|
|
202
|
-
```typescript
|
|
203
|
-
@Component({
|
|
204
|
-
selector: 'app-quote',
|
|
205
|
-
imports: [QuoteTranslatePipe, QuoteTranslateDirective],
|
|
206
|
-
template: `
|
|
207
|
-
<!-- Pipe validates key & variables match -->
|
|
208
|
-
<h1>{{ 'quote.pageTitle' | translate }}</h1>
|
|
209
|
-
<!-- Non pluralized params must be string -->
|
|
210
|
-
<span>{{ 'quote.errors.minLength' | translate: { min: '5' } }}</span>
|
|
211
|
-
|
|
212
|
-
<!-- Directive replaces innerHTML of el -->
|
|
213
|
-
<h1 translate="quote.pageTitle"></h1>
|
|
214
|
-
<span [translate]="['quote.errors.minLength', { min: '5' }]"></span>
|
|
215
|
-
`,
|
|
216
|
-
})
|
|
217
|
-
export class QuoteComponent {
|
|
218
|
-
protected readonly count = signal(0);
|
|
219
|
-
private readonly t = injectQuoteT();
|
|
220
|
-
|
|
221
|
-
private readonly author = this.t('quote.detail.authorLabel'); // static translation
|
|
222
|
-
|
|
223
|
-
private readonly stats = this.t.asSignal('quote.stats', () => ({
|
|
224
|
-
count: this.count(), // must be object with count parameter & type number
|
|
225
|
-
}));
|
|
226
|
-
}
|
|
227
|
-
```
|
|
228
|
-
|
|
229
|
-
### 4. [OPTIONAL] - Creating a shared/common namespace
|
|
230
|
-
|
|
231
|
-
_Note:_ A shared namespace allows you to use it within other `t` functions. You are however responsible for loading it before those `t` functions initialize, usually for a shared namespace that would be at the top route.
|
|
232
|
-
|
|
233
|
-
#### 4a. Define a shared namespace
|
|
234
|
-
|
|
235
|
-
Same as quote example, but this time also export the `createMergedNamespace` function. This will be your new factory for other namespaces.
|
|
236
|
-
|
|
237
|
-
```typescript
|
|
238
|
-
// Example: packages/common-locales/src/lib/common.namespace.ts
|
|
239
|
-
import { createNamespace } from '@mmstack/translate';
|
|
240
|
-
|
|
241
|
-
const ns = createNamespace('common', {
|
|
242
|
-
yes: 'Yes',
|
|
243
|
-
no: 'No',
|
|
244
|
-
}
|
|
245
|
-
|
|
246
|
-
// ... rest
|
|
247
|
-
|
|
248
|
-
export const createAppNamespace = ns.createMergedNamespace;
|
|
249
|
-
```
|
|
250
|
-
|
|
251
|
-
### 4b. Use the common namespace factory instead of the library one
|
|
252
|
-
|
|
253
|
-
```typescript
|
|
254
|
-
// Example: packages/quote/src/lib/quote.namespace.ts
|
|
255
|
-
import { createAppNamespace } from '@org/common/locale'; // replace with your library import path
|
|
256
|
-
|
|
257
|
-
// Create the namespace definition object
|
|
258
|
-
const ns = createAppNamespace('quote', {
|
|
259
|
-
pageTitle: 'Famous Quotes',
|
|
260
|
-
}
|
|
261
|
-
|
|
262
|
-
// registration & other stuff remains the same
|
|
263
|
-
```
|
|
264
|
-
|
|
265
|
-
### 4c. Have even more fun!
|
|
266
|
-
|
|
267
|
-
```typescript
|
|
268
|
-
@Component({
|
|
269
|
-
//...
|
|
270
|
-
})
|
|
271
|
-
export class QuoteComponent {
|
|
272
|
-
private readonly t = injectQuoteT();
|
|
273
|
-
|
|
274
|
-
// t function is now 'aware' of the common namespace & its translations
|
|
275
|
-
private readonly yes = this.t('common.yes');
|
|
276
|
-
|
|
277
|
-
// quote translations also work the same
|
|
278
|
-
private readonly author = this.t('quote.detail.authorLabel');
|
|
279
|
-
}
|
|
280
|
-
```
|
|
281
|
-
|
|
282
|
-
## Contributing
|
|
283
|
-
|
|
284
|
-
Contributions, issues, and feature requests are welcome!
|
|
1
|
+
# @mmstack/translate
|
|
2
|
+
|
|
3
|
+
**Type-Safe & modular localization for Modern Angular.**
|
|
4
|
+
|
|
5
|
+
[](https://badge.fury.io/js/%40mmstack%2Ftranslate)
|
|
6
|
+
[](https://github.com/mihajm/mmstack/blob/master/LICENSE)
|
|
7
|
+
[](CONTRIBUTING.md)
|
|
8
|
+
|
|
9
|
+
`@mmstack/translate` is an opinionated internationalization (i18n) library for Angular applications built with three core priorities:
|
|
10
|
+
|
|
11
|
+
1. **Maximum Type Safety:** Catch errors related to missing keys or incorrect/missing parameters at compile time.
|
|
12
|
+
2. **Simplified Build Process:** Lazily load translations at runtime, requiring only a **single application build** regardless of the number of supported locales.
|
|
13
|
+
3. **Scalable Modularity:** Organize translations into **namespaces** (typically aligned with feature libraries) and load them on demand.
|
|
14
|
+
|
|
15
|
+
It uses the robust **FormatJS** Intl runtime (`@formatjs/intl`) for ICU message formatting, and integrates with Angular's dependency injection and routing.
|
|
16
|
+
|
|
17
|
+
## Features
|
|
18
|
+
|
|
19
|
+
- ✅ **End-to-End Type Safety:** Compile-time checks for:
|
|
20
|
+
- Translation key existence (within a namespace).
|
|
21
|
+
- Correct parameter names and types.
|
|
22
|
+
- Required vs. optional parameters based on ICU message.
|
|
23
|
+
- Structural consistency check when defining non-default locales.
|
|
24
|
+
- 🚀 **Single Build Artifact:** Runtime translation loading.
|
|
25
|
+
- 📦 **Namespacing:** Organize translations by feature/library (e.g., 'quotes', 'userProfile', 'common').
|
|
26
|
+
- ⏳ **Lazy Loading:** Load namespaced translations on demand using Route Resolvers.
|
|
27
|
+
- ✨ **Reactive API:** Includes `t.asSignal()` for creating computed translation signals based on signal parameters.
|
|
28
|
+
- 🌍 **ICU Message Syntax:** Uses FormatJS runtime for robust support of variables (`{name}`), `plural`, `select`, and `selectordinal`. (Note: Complex inline date/number formats are not the focus; use Angular's built in Pipes/format functions & use the result as variables in your translation.)
|
|
29
|
+
- 🔗 **Shared Namespace Support:** Define common translations (e.g., 'Save', 'Cancel') in one namespace and make them type-safely accessible from others.
|
|
30
|
+
- 🛠️ **Template Helpers:** Includes abstract `BaseTranslatePipe` and `BaseTranslateDirective` for easy, type-safe templating.
|
|
31
|
+
|
|
32
|
+
### Comparison
|
|
33
|
+
|
|
34
|
+
While Angular offers excellent i18n solutions like `@angular/localize` and `transloco`, `@mmstack/translate` aims to fill a specific niche.
|
|
35
|
+
|
|
36
|
+
| Feature | `@mmstack/translate` | `@angular/localize` | `transloco` | `ngx-translate` |
|
|
37
|
+
| :----------------------- | :---------------------------------: | :----------------------: | :---------------------------: | :------------------------: |
|
|
38
|
+
| **Build Process** | ✅ Single Build | ❌ Multi-Build (Typical) | ✅ Single Build | ✅ Single Build |
|
|
39
|
+
| **Translation Timing** | Runtime | Compile Time | Runtime | Runtime |
|
|
40
|
+
| **Type Safety (Keys)** | ✅ Strong (Inferred from structure) | 🟡 via extraction | 🟡 Tooling/TS Files | 🟡 OK Manual/Tooling |
|
|
41
|
+
| **Type Safety (Params)** | ✅ Strong (Inferred from ICU) | ❌ None | 🟡 Manual | 🟡 Manual |
|
|
42
|
+
| **Locale Switching** | 🔄 Page Refresh Required | 🔄 Page Refresh Required | ✅ Dynamic (Runtime) | ✅ Dynamic (Runtime) |
|
|
43
|
+
| **Lazy Loading** | ✅ Built-in (Namespaces/Resolvers) | N/A (Compile Time) | ✅ Built-in (Scopes) | ✅ Yes (Custom Loaders) |
|
|
44
|
+
| **Namespacing/Scopes** | ✅ Built-in | ❌ None | ✅ Built-in (Scopes) | 🟡 Manual (File Structure) |
|
|
45
|
+
| **ICU Support** | ✅ Subset (via FormatJS Runtime) | ✅ Yes (Compile Time) | ✅ Yes (Runtime Intl/Plugins) | 🟡 Via Extensions |
|
|
46
|
+
| **Signal Integration** | ✅ Good (`t.asSignal()`) | N/A | ✅ Good (`translateSignal()`) | ❌ Minimal/None |
|
|
47
|
+
| **Maturity / Community** | ✨ New | Core Angular | ✅ Mature / Active | ✅ Mature |
|
|
48
|
+
|
|
49
|
+
## Installation & Configuration
|
|
50
|
+
|
|
51
|
+
Install the library & its peer dependency, `@formatjs/intl`.
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
npm install @mmstack/translate @formatjs/intl
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
If you'd like to setup @formatjs with custom properties & setup a different default locale then 'en-US' you can define these options at the root of your application.
|
|
58
|
+
|
|
59
|
+
```typescript
|
|
60
|
+
import { provideIntlConfig } from '@mmstack/translate';
|
|
61
|
+
|
|
62
|
+
const appConfig: Providers = [
|
|
63
|
+
provideIntlConfig({
|
|
64
|
+
defaultLocale: 'fr-FR', // defaults to 'en-US' if nothing is provided
|
|
65
|
+
}),
|
|
66
|
+
];
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
```typescript
|
|
70
|
+
import { Component, LOCALE_ID } from '@angular/core';
|
|
71
|
+
import { ActivatedRoute } from '@angular/router';
|
|
72
|
+
|
|
73
|
+
const KNOWN_LOCALES = ['en-US', 'sl-SI'];
|
|
74
|
+
|
|
75
|
+
@Component({
|
|
76
|
+
selector: 'app-locale-shell',
|
|
77
|
+
providers: [
|
|
78
|
+
{
|
|
79
|
+
provide: LOCALE_ID,
|
|
80
|
+
useFactory: (route: ActivatedRoute) => {
|
|
81
|
+
const locale = route.snapshot.paramMap.get('locale') || 'en-US';
|
|
82
|
+
if (KNOWN_LOCALES.includes(locale)) return locale;
|
|
83
|
+
return 'en-US';
|
|
84
|
+
},
|
|
85
|
+
deps: [ActivatedRoute],
|
|
86
|
+
},
|
|
87
|
+
],
|
|
88
|
+
template: `<ng-content />`,
|
|
89
|
+
})
|
|
90
|
+
export class LocaleShellComponent {}
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
_Note:_ `@mmstack/translate` relies on Angular's `LOCALE_ID` provider. You must provide a value for it. How you determine this value (e.g., hardcoded, from server config, from URL segment via a factory provider) is up to your application's architecture. The library assumes this `LOCALE_ID` is static for the duration of the application session and requires a page refresh to change.
|
|
94
|
+
|
|
95
|
+
## Usage
|
|
96
|
+
|
|
97
|
+
The core workflow involves defining namespaces, registering them (often via lazy loading), and then using the injected translation function (t), pipe, or directive.
|
|
98
|
+
|
|
99
|
+
### 1. Define Namespace & Translations
|
|
100
|
+
|
|
101
|
+
Define your default locale translations (e.g., 'en-US') as a `const` TypeScript object. Use createNamespace to process it and generate helpers.
|
|
102
|
+
|
|
103
|
+
```typescript
|
|
104
|
+
// Example: packages/quote/src/lib/quote.namespace.ts
|
|
105
|
+
import { createNamespace } from '@mmstack/translate';
|
|
106
|
+
|
|
107
|
+
// Create the namespace definition object
|
|
108
|
+
const ns = createNamespace('quote', {
|
|
109
|
+
pageTitle: 'Famous Quotes',
|
|
110
|
+
greeting: 'Hello {name}!',
|
|
111
|
+
detail: {
|
|
112
|
+
authorLabel: 'Author',
|
|
113
|
+
},
|
|
114
|
+
errors: {
|
|
115
|
+
minLength: 'Quote must be at least {min} characters long.',
|
|
116
|
+
},
|
|
117
|
+
stats: '{count, plural, one {# quote} other {# quotes}} available',
|
|
118
|
+
});
|
|
119
|
+
|
|
120
|
+
export default ns.translation;
|
|
121
|
+
|
|
122
|
+
export type QuoteLocale = (typeof ns)['translation'];
|
|
123
|
+
|
|
124
|
+
export const createQuoteTranslation = ns.createTranslation;
|
|
125
|
+
|
|
126
|
+
// Note the translations should be in separate files, if you are using import() to lazy load them.
|
|
127
|
+
// packages/quote/src/lib/quote-sl.translation.ts
|
|
128
|
+
|
|
129
|
+
import { createQuoteTranslation } from './quote.namespace';
|
|
130
|
+
|
|
131
|
+
// shape is typesafe (errors if you have missing or additional keys)
|
|
132
|
+
export default createQuoteTranslation({
|
|
133
|
+
pageTitle: 'Znani Citati',
|
|
134
|
+
greeting: 'Zdravo {name}!',
|
|
135
|
+
detail: {
|
|
136
|
+
authorLabel: 'Avtor',
|
|
137
|
+
},
|
|
138
|
+
errors: {
|
|
139
|
+
minLength: 'Citat mora imeti vsaj {min} znakov.', // If original has variables, the translation must contain a subset of used variables (min 1)
|
|
140
|
+
},
|
|
141
|
+
stats: '{count, plural, =1 {# citat} =2 {# citata} few {# citati} other {# citatov}} na voljo', // also guarenteed for "complex" variables, so {count} must be used in this translation
|
|
142
|
+
});
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
### 2. Register the namespace & load
|
|
146
|
+
|
|
147
|
+
Use registerNamespace to prepare your namespace definition and obtain the injectNamespaceT function and the resolveNamespaceTranslation resolver function. Use the resolver in your Angular routes.
|
|
148
|
+
|
|
149
|
+
```typescript
|
|
150
|
+
import q from './quote.namespace';
|
|
151
|
+
|
|
152
|
+
// Register the namespace
|
|
153
|
+
// Example: packages/quote/src/lib/quote.t.ts
|
|
154
|
+
const r = registerNamespace(
|
|
155
|
+
() => import('./quote.namespace.ts').then((m) => m.default), // Default locale's compiled translation (functions as fallback if no locale of type provided)
|
|
156
|
+
{
|
|
157
|
+
// Map other locales to promise factories (dynamic imports)
|
|
158
|
+
'sl-SI': () => import('./quote-sl.translation.ts').then((m) => m.default),
|
|
159
|
+
},
|
|
160
|
+
);
|
|
161
|
+
|
|
162
|
+
export const injectQuoteT = r.injectNamespaceT;
|
|
163
|
+
export const resolveQuoteTranslations = r.resolveNamespaceTranslation;
|
|
164
|
+
|
|
165
|
+
// in the main quote route add the provided resolver
|
|
166
|
+
|
|
167
|
+
import { type Routes } from '@angular/router';
|
|
168
|
+
import { resolveQuoteTranslations } from './quote.t';
|
|
169
|
+
|
|
170
|
+
export const MODULE_ROUTES: Routes = [
|
|
171
|
+
// ...
|
|
172
|
+
{
|
|
173
|
+
// ...
|
|
174
|
+
resolve: {
|
|
175
|
+
resolveQuoteTranslations,
|
|
176
|
+
},
|
|
177
|
+
},
|
|
178
|
+
];
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
#### 2b. [OPTIONAL] Configure the translation pipe and/or directive
|
|
182
|
+
|
|
183
|
+
```typescript
|
|
184
|
+
import { Pipe, Directive } from '@angular/core';
|
|
185
|
+
import { BaseTranslatePipe, BaseTranslateDirective } from '@mmstack/translate';
|
|
186
|
+
import { type QuoteLocale } from './quote.namespace';
|
|
187
|
+
|
|
188
|
+
@Pipe({
|
|
189
|
+
name: 'translate',
|
|
190
|
+
})
|
|
191
|
+
export class QuoteTranslatePipe extends BaseTranslatePipe<QuoteLocale> {}
|
|
192
|
+
|
|
193
|
+
@Directive({
|
|
194
|
+
selector: '[translate]', // input in BaseTranslateDirective is named 'translate'
|
|
195
|
+
})
|
|
196
|
+
// TInput is necessary to correctly infer the variables to the key
|
|
197
|
+
export class QuoteTranslateDirective<TInput extends string> extends BaseTranslateDirective<TInput, QuoteLocale> {}
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
### 3. Have fun :)
|
|
201
|
+
|
|
202
|
+
```typescript
|
|
203
|
+
@Component({
|
|
204
|
+
selector: 'app-quote',
|
|
205
|
+
imports: [QuoteTranslatePipe, QuoteTranslateDirective],
|
|
206
|
+
template: `
|
|
207
|
+
<!-- Pipe validates key & variables match -->
|
|
208
|
+
<h1>{{ 'quote.pageTitle' | translate }}</h1>
|
|
209
|
+
<!-- Non pluralized params must be string -->
|
|
210
|
+
<span>{{ 'quote.errors.minLength' | translate: { min: '5' } }}</span>
|
|
211
|
+
|
|
212
|
+
<!-- Directive replaces innerHTML of el -->
|
|
213
|
+
<h1 translate="quote.pageTitle"></h1>
|
|
214
|
+
<span [translate]="['quote.errors.minLength', { min: '5' }]"></span>
|
|
215
|
+
`,
|
|
216
|
+
})
|
|
217
|
+
export class QuoteComponent {
|
|
218
|
+
protected readonly count = signal(0);
|
|
219
|
+
private readonly t = injectQuoteT();
|
|
220
|
+
|
|
221
|
+
private readonly author = this.t('quote.detail.authorLabel'); // static translation
|
|
222
|
+
|
|
223
|
+
private readonly stats = this.t.asSignal('quote.stats', () => ({
|
|
224
|
+
count: this.count(), // must be object with count parameter & type number
|
|
225
|
+
}));
|
|
226
|
+
}
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
### 4. [OPTIONAL] - Creating a shared/common namespace
|
|
230
|
+
|
|
231
|
+
_Note:_ A shared namespace allows you to use it within other `t` functions. You are however responsible for loading it before those `t` functions initialize, usually for a shared namespace that would be at the top route.
|
|
232
|
+
|
|
233
|
+
#### 4a. Define a shared namespace
|
|
234
|
+
|
|
235
|
+
Same as quote example, but this time also export the `createMergedNamespace` function. This will be your new factory for other namespaces.
|
|
236
|
+
|
|
237
|
+
```typescript
|
|
238
|
+
// Example: packages/common-locales/src/lib/common.namespace.ts
|
|
239
|
+
import { createNamespace } from '@mmstack/translate';
|
|
240
|
+
|
|
241
|
+
const ns = createNamespace('common', {
|
|
242
|
+
yes: 'Yes',
|
|
243
|
+
no: 'No',
|
|
244
|
+
});
|
|
245
|
+
|
|
246
|
+
// ... rest
|
|
247
|
+
|
|
248
|
+
export const createAppNamespace = ns.createMergedNamespace;
|
|
249
|
+
```
|
|
250
|
+
|
|
251
|
+
### 4b. Use the common namespace factory instead of the library one
|
|
252
|
+
|
|
253
|
+
```typescript
|
|
254
|
+
// Example: packages/quote/src/lib/quote.namespace.ts
|
|
255
|
+
import { createAppNamespace } from '@org/common/locale'; // replace with your library import path
|
|
256
|
+
|
|
257
|
+
// Create the namespace definition object
|
|
258
|
+
const ns = createAppNamespace('quote', {
|
|
259
|
+
pageTitle: 'Famous Quotes',
|
|
260
|
+
});
|
|
261
|
+
|
|
262
|
+
// registration & other stuff remains the same
|
|
263
|
+
```
|
|
264
|
+
|
|
265
|
+
### 4c. Have even more fun!
|
|
266
|
+
|
|
267
|
+
```typescript
|
|
268
|
+
@Component({
|
|
269
|
+
//...
|
|
270
|
+
})
|
|
271
|
+
export class QuoteComponent {
|
|
272
|
+
private readonly t = injectQuoteT();
|
|
273
|
+
|
|
274
|
+
// t function is now 'aware' of the common namespace & its translations
|
|
275
|
+
private readonly yes = this.t('common.yes');
|
|
276
|
+
|
|
277
|
+
// quote translations also work the same
|
|
278
|
+
private readonly author = this.t('quote.detail.authorLabel');
|
|
279
|
+
}
|
|
280
|
+
```
|
|
281
|
+
|
|
282
|
+
## Contributing
|
|
283
|
+
|
|
284
|
+
Contributions, issues, and feature requests are welcome!
|
|
@@ -166,32 +166,33 @@ function createT(store) {
|
|
|
166
166
|
return store.formatMessage(replaceWithDelim(stringKey), variables);
|
|
167
167
|
};
|
|
168
168
|
}
|
|
169
|
-
function registerNamespace(
|
|
169
|
+
function registerNamespace(defaultTranslation, other) {
|
|
170
170
|
const injectT = () => {
|
|
171
171
|
const store = inject(TranslationStore);
|
|
172
172
|
return addSignalFn(createT(store), store);
|
|
173
173
|
};
|
|
174
|
+
let defaultTranslationLoaded = false;
|
|
174
175
|
const resolver = async () => {
|
|
175
176
|
const locale = inject(LOCALE_ID);
|
|
176
177
|
const store = inject(TranslationStore);
|
|
177
|
-
const
|
|
178
|
-
|
|
179
|
-
[defaultLocale]: defaultTranslation,
|
|
180
|
-
});
|
|
181
|
-
if (locale === defaultLocale)
|
|
182
|
-
return;
|
|
183
|
-
const promise = other[locale];
|
|
178
|
+
const tPromise = other[locale];
|
|
179
|
+
const promise = tPromise ?? defaultTranslation;
|
|
184
180
|
if (!promise && isDevMode()) {
|
|
185
181
|
return console.warn(`No translation found for locale: ${locale}`);
|
|
186
182
|
}
|
|
183
|
+
if (promise === defaultTranslation && defaultTranslationLoaded)
|
|
184
|
+
return;
|
|
187
185
|
try {
|
|
188
186
|
const translation = await promise();
|
|
189
187
|
if (translation.locale !== locale && isDevMode()) {
|
|
190
188
|
return console.warn(`Expected locale to be ${locale} but got ${translation.locale}`);
|
|
191
189
|
}
|
|
192
|
-
store.register(
|
|
190
|
+
store.register(translation.namespace, {
|
|
193
191
|
[locale]: translation.flat,
|
|
194
192
|
});
|
|
193
|
+
if (promise === defaultTranslation) {
|
|
194
|
+
defaultTranslationLoaded = true;
|
|
195
|
+
}
|
|
195
196
|
}
|
|
196
197
|
catch {
|
|
197
198
|
if (isDevMode()) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mmstack-translate.mjs","sources":["../../../../packages/translate/src/lib/delim.ts","../../../../packages/translate/src/lib/compile.ts","../../../../packages/translate/src/lib/create-namespace.ts","../../../../packages/translate/src/lib/translation.store.ts","../../../../packages/translate/src/lib/register-namespace.ts","../../../../packages/translate/src/lib/translate.directive.ts","../../../../packages/translate/src/lib/translate.pipe.ts","../../../../packages/translate/src/mmstack-translate.ts"],"sourcesContent":["const KEY_DELIM = '::MMT_DELIM::';\n\nexport function prependDelim(prefix: string, key: string): string {\n return `${prefix}${KEY_DELIM}${key}`;\n}\n\nexport function replaceWithDelim(str: string, repl = '.'): string {\n return str.replaceAll(repl, KEY_DELIM);\n}\n","import { prependDelim } from './delim';\nimport {\n inferTranslationParamMap,\n inferTranslationShape,\n} from './parameterize.type';\nimport { UnknownStringKeyObject } from './string-key-object.type';\n\nconst INTERNAL_SYMBOL = Symbol.for('mmstack-translate-internal');\n\ntype InternalSymbol = typeof INTERNAL_SYMBOL;\n\nexport type CompiledTranslation<\n T extends UnknownStringKeyObject,\n TNS extends string,\n TLocale extends string = string,\n> = {\n flat: Record<string, string>;\n locale?: TLocale;\n namespace: TNS;\n [INTERNAL_SYMBOL]: {\n shape: inferTranslationShape<T>;\n map: inferTranslationParamMap<TNS, T>;\n };\n};\n\nexport type mergeTranslationMaps<\n TMain extends CompiledTranslation<UnknownStringKeyObject, string>,\n TOther extends CompiledTranslation<UnknownStringKeyObject, string>,\n> = Omit<TMain, InternalSymbol> & {\n [INTERNAL_SYMBOL]: {\n shape: inferCompiledTranslationShape<TMain>;\n map: inferCompiledTranslationMap<TOther> &\n inferCompiledTranslationMap<TMain>;\n };\n};\n\nexport type inferCompiledTranslationNamespace<\n T extends CompiledTranslation<UnknownStringKeyObject, string>,\n> = T['namespace'];\n\nexport type inferCompiledTranslationShape<\n T extends CompiledTranslation<UnknownStringKeyObject, string>,\n> = T[InternalSymbol]['shape'];\n\nexport type inferCompiledTranslationMap<\n T extends CompiledTranslation<UnknownStringKeyObject, string>,\n> = T[InternalSymbol]['map'];\n\nfunction isTranslationObject(t: unknown): t is UnknownStringKeyObject {\n return typeof t === 'object' && t !== null;\n}\n\nfunction flattenTranslation<T extends UnknownStringKeyObject>(obj: T) {\n return Object.entries(obj).reduce(\n (acc, [key, value]) => {\n if (typeof value === 'string') {\n acc[key] = value;\n } else if (isTranslationObject(value)) {\n Object.entries(flattenTranslation(value)).forEach(\n ([nestedKey, nestedValue]) => {\n acc[prependDelim(key, nestedKey)] = nestedValue;\n },\n );\n }\n\n return acc;\n },\n {} as Record<string, string>,\n );\n}\n\nexport function compileTranslation<\n T extends UnknownStringKeyObject,\n TNS extends string,\n TLocale extends string = string,\n>(\n translation: T,\n ns: TNS,\n locale?: TLocale,\n): CompiledTranslation<T, TNS, TLocale> {\n type $Shape = inferTranslationShape<T>;\n type $Map = inferTranslationParamMap<TNS, T>;\n\n return {\n locale,\n flat: flattenTranslation(translation),\n namespace: ns,\n [INTERNAL_SYMBOL]: {\n shape: {} as $Shape,\n map: {} as $Map,\n },\n };\n}\n","import {\n CompiledTranslation,\n compileTranslation,\n inferCompiledTranslationShape,\n mergeTranslationMaps,\n} from './compile';\nimport { UnknownStringKeyObject } from './string-key-object.type';\n\ntype TranslationNamespace<\n TNS extends string,\n T extends CompiledTranslation<UnknownStringKeyObject, TNS>,\n TShape extends UnknownStringKeyObject,\n> = {\n translation: T;\n createTranslation: <TLocale extends string>(\n locale: TLocale,\n translation: TShape,\n ) => CompiledTranslation<TShape, TNS, TLocale>;\n createMergedNamespace: <\n TOtherNS extends string,\n TOther extends UnknownStringKeyObject,\n TOtherCompiled extends CompiledTranslation<TOther, TOtherNS>,\n >(\n ns: TOtherNS,\n translation: TOther,\n ) => TranslationNamespace<\n TOtherNS,\n mergeTranslationMaps<TOtherCompiled, T>,\n inferCompiledTranslationShape<TOtherCompiled>\n >;\n};\n\nexport function createNamespace<\n T extends UnknownStringKeyObject,\n TNS extends string,\n>(ns: TNS, translation: T) {\n const compiled = compileTranslation<T, TNS>(translation, ns);\n\n type TCompiled = typeof compiled;\n type TShape = inferCompiledTranslationShape<typeof compiled>;\n\n const namespace: TranslationNamespace<TNS, TCompiled, TShape> = {\n translation: compileTranslation(translation, ns),\n createTranslation: <TLocale extends string>(\n locale: TLocale,\n translation: TShape,\n ) => {\n return compileTranslation(translation, ns, locale);\n },\n createMergedNamespace: <\n TOther extends UnknownStringKeyObject,\n TOtherNS extends string,\n TOtherCompiled extends CompiledTranslation<\n TOther,\n TOtherNS\n > = CompiledTranslation<TOther, TOtherNS>,\n >(\n otherNs: TOtherNS,\n otherTranslation: TOther,\n ) => {\n return createNamespace(otherNs, otherTranslation) as TranslationNamespace<\n TOtherNS,\n mergeTranslationMaps<TOtherCompiled, TCompiled>,\n inferCompiledTranslationShape<TOtherCompiled>\n > as unknown as any;\n },\n };\n\n return namespace;\n}\n","import {\n computed,\n inject,\n Injectable,\n InjectionToken,\n LOCALE_ID,\n Provider,\n signal,\n} from '@angular/core';\nimport { createIntl, createIntlCache, IntlConfig } from '@formatjs/intl';\nimport { prependDelim } from './delim';\n\nconst CONFIG_TOKEN = new InjectionToken<\n Omit<IntlConfig, 'locale' | 'messages'>\n>('mmstack-intl-config');\n\nexport function provideIntlConfig(\n config: Omit<IntlConfig, 'locale' | 'messages'>,\n): Provider {\n return {\n useValue: config,\n provide: CONFIG_TOKEN,\n };\n}\n\nexport function injectIntlConfig() {\n return inject(CONFIG_TOKEN, { optional: true }) ?? undefined;\n}\n\nexport function injectDefaultLocale() {\n return injectIntlConfig()?.defaultLocale ?? 'en-US';\n}\n\n@Injectable({\n providedIn: 'root',\n})\nexport class TranslationStore {\n private readonly cache = createIntlCache();\n private readonly config = injectIntlConfig();\n private readonly locale = inject(LOCALE_ID);\n private readonly defaultLocale = injectDefaultLocale();\n private readonly translations = signal<\n Record<string, Record<string, string>>\n >({\n [this.defaultLocale]: {},\n });\n\n private readonly nonMessageConfig = computed(() => ({\n ...this.config,\n locale: this.locale,\n }));\n\n private readonly messages = computed(\n () =>\n this.translations()[this.locale] ??\n this.translations()[this.defaultLocale] ??\n {},\n );\n\n readonly intl = computed(() =>\n createIntl(\n {\n ...this.nonMessageConfig(),\n messages: this.messages(),\n },\n this.cache,\n ),\n );\n\n formatMessage(key: string, values?: Record<string, string | number>) {\n const message = this.translations()[this.locale]?.[key] ?? '';\n\n if (!message) return '';\n\n return this.intl().formatMessage(\n { id: key, defaultMessage: message },\n values,\n );\n }\n\n register(\n namespace: string,\n flat: Partial<Record<string, Record<string, string>>>,\n ) {\n this.translations.update((cur) => {\n return Object.entries(flat).reduce(\n (acc, [locale, translation]) => {\n const localeTranslation = acc[locale] ?? {};\n\n const withNS = Object.entries(translation ?? {}).reduce(\n (acc, [key, value]) => {\n acc[prependDelim(namespace, key)] = value;\n return acc;\n },\n {} as Record<string, string>,\n );\n\n acc[locale] = {\n ...localeTranslation,\n ...withNS,\n };\n\n return acc;\n },\n { ...cur },\n );\n });\n }\n}\n\nexport function injectIntl() {\n return inject(TranslationStore).intl;\n}\n","import {\n computed,\n inject,\n isDevMode,\n isSignal,\n LOCALE_ID,\n Signal,\n} from '@angular/core';\nimport {\n CompiledTranslation,\n inferCompiledTranslationMap,\n inferCompiledTranslationShape,\n} from './compile';\nimport { replaceWithDelim } from './delim';\nimport { UnknownStringKeyObject } from './string-key-object.type';\nimport { injectDefaultLocale, TranslationStore } from './translation.store';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyStringRecord = Record<string, any>;\n\nfunction createEqualsRecord<T extends AnyStringRecord>(keys: (keyof T)[] = []) {\n let keyMatcher: (a: T, b: T) => boolean;\n\n if (keys.length === 0) {\n keyMatcher = () => true;\n } else if (keys.length === 1) {\n const key = keys[0];\n keyMatcher = (a, b) => a[key] === b[key];\n } else {\n keyMatcher = (a, b) => {\n return keys.every((k) => a[k] === b[k]);\n };\n }\n\n return (a?: T, b?: T): boolean => {\n if (!a && !b) return true;\n if (!a || !b) return false;\n return keyMatcher(a, b);\n };\n}\n\ntype TFunction<TMap extends AnyStringRecord> = <\n TKey extends keyof TMap & string,\n>(\n key: TKey,\n ...args: TMap[TKey] extends void ? [] : [TMap[TKey]]\n) => string;\n\ntype SignalTFunction<TMap extends AnyStringRecord> = <\n TKey extends keyof TMap & string,\n>(\n key: TKey,\n ...args: TMap[TKey] extends void ? [] : [() => TMap[TKey]]\n) => Signal<string>;\n\ntype TFunctionWithSignalConstructor<\n TMap extends AnyStringRecord,\n TFN extends TFunction<TMap>,\n> = TFN & {\n asSignal: SignalTFunction<TMap>;\n};\n\nfunction addSignalFn<TMap extends AnyStringRecord, TFn extends TFunction<TMap>>(\n fn: TFn,\n store: TranslationStore,\n): TFunctionWithSignalConstructor<TMap, TFn> {\n const withSig = fn as TFunctionWithSignalConstructor<TMap, TFn>;\n\n const asSignal = <TKey extends keyof TMap & string>(\n key: TKey,\n ...args: TMap[TKey] extends void ? [] : [() => TMap[TKey]]\n ): Signal<string> => {\n const variables = args[0] as () => AnyStringRecord | undefined;\n const stringKey = key as string;\n\n const flatPath = replaceWithDelim(stringKey);\n\n const varsFn = variables === undefined ? () => undefined : variables;\n const varsSignal = isSignal(varsFn)\n ? varsFn\n : computed(varsFn, {\n equal: createEqualsRecord(Object.keys(varsFn() as object)),\n });\n\n return computed(() => store.formatMessage(flatPath, varsSignal()));\n };\n\n withSig.asSignal = asSignal;\n\n return withSig;\n}\n\nexport function createT<TMap extends AnyStringRecord>(\n store: TranslationStore,\n): TFunction<TMap> {\n return <TKey extends keyof TMap & string>(\n key: TKey,\n ...args: TMap[TKey] extends void ? [] : [TMap[TKey]]\n ): string => {\n const variables = args[0] as AnyStringRecord | undefined;\n const stringKey = key as string;\n\n return store.formatMessage(replaceWithDelim(stringKey), variables);\n };\n}\n\nexport function registerNamespace<\n TDefault extends CompiledTranslation<UnknownStringKeyObject, string>,\n TOther extends CompiledTranslation<\n inferCompiledTranslationShape<TDefault>,\n string\n >,\n>(\n { namespace: ns, flat: defaultTranslation }: TDefault,\n other: Record<string, () => Promise<TOther>>,\n) {\n type $Map = inferCompiledTranslationMap<TDefault>;\n type $BaseTFN = TFunction<$Map>;\n type $TFN = TFunctionWithSignalConstructor<$Map, $BaseTFN>;\n\n const injectT = (): $TFN => {\n const store = inject(TranslationStore);\n\n return addSignalFn(createT(store), store);\n };\n\n const resolver = async () => {\n const locale = inject(LOCALE_ID);\n const store = inject(TranslationStore);\n const defaultLocale = injectDefaultLocale();\n\n store.register(ns, {\n [defaultLocale]: defaultTranslation,\n });\n\n if (locale === defaultLocale) return;\n\n const promise = other[locale] as () => Promise<TOther>;\n\n if (!promise && isDevMode()) {\n return console.warn(`No translation found for locale: ${locale}`);\n }\n\n try {\n const translation = await promise();\n\n if (translation.locale !== locale && isDevMode()) {\n return console.warn(\n `Expected locale to be ${locale} but got ${translation.locale}`,\n );\n }\n\n store.register(ns, {\n [locale]: translation.flat,\n });\n } catch {\n if (isDevMode()) {\n console.warn(`Failed to load translation for locale: ${locale}`);\n }\n }\n };\n\n return {\n injectNamespaceT: injectT,\n resolveNamespaceTranslation: resolver,\n };\n}\n","import {\n computed,\n Directive,\n effect,\n ElementRef,\n inject,\n input,\n Renderer2,\n} from '@angular/core';\nimport { CompiledTranslation, inferCompiledTranslationMap } from './compile';\nimport { createT } from './register-namespace';\nimport { UnknownStringKeyObject } from './string-key-object.type';\nimport { TranslationStore } from './translation.store';\n\n@Directive()\nexport abstract class BaseTranslateDirective<\n TInput extends string,\n T extends CompiledTranslation<UnknownStringKeyObject, string>,\n TMap extends inferCompiledTranslationMap<T> = inferCompiledTranslationMap<T>,\n TKey extends TInput & keyof TMap & string = TInput & keyof TMap & string,\n> {\n private readonly t = createT(inject(TranslationStore));\n\n readonly translate =\n input.required<\n TMap[TKey] extends void\n ? TKey | [key: TKey]\n : [key: TKey, vars: TMap[TKey]]\n >();\n\n constructor() {\n const key = computed(() => {\n const vars = this.translate();\n return (Array.isArray(vars) ? vars[0] : vars) as TKey;\n });\n\n const args = computed(\n () => {\n const vars = this.translate();\n return (Array.isArray(vars) ? vars[1] : undefined) as TMap[TKey];\n },\n {\n equal: (a, b) => {\n if (a === undefined && b === undefined) return true;\n if (a === undefined || b === undefined) return false;\n\n const aObj = a as Record<string, string>;\n const keys = Object.keys(aObj);\n const bObj = b as Record<string, string>;\n\n if (!keys.length) return !Object.keys(bObj).length;\n\n return keys.every((key) => aObj[key] === bObj[key]);\n },\n },\n );\n\n const translation = computed(() => this.t(key(), args()));\n\n const renderer = inject(Renderer2);\n const el = inject<ElementRef<HTMLElement>>(ElementRef);\n\n effect(() =>\n renderer.setProperty(el.nativeElement, 'textContent', translation()),\n );\n }\n}\n","import { inject } from '@angular/core';\nimport { CompiledTranslation, inferCompiledTranslationMap } from './compile';\nimport { createT } from './register-namespace';\nimport { UnknownStringKeyObject } from './string-key-object.type';\nimport { TranslationStore } from './translation.store';\n\nexport abstract class BaseTranslatePipe<\n T extends CompiledTranslation<UnknownStringKeyObject, string>,\n TMap extends inferCompiledTranslationMap<T> = inferCompiledTranslationMap<T>,\n> {\n private readonly t = createT<TMap>(inject(TranslationStore));\n\n transform<K extends keyof TMap & string>(\n key: K,\n ...args: TMap[K] extends void ? [] : [TMap[K]]\n ): string {\n return this.t(key, ...args);\n }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"mmstack-translate.mjs","sources":["../../../../packages/translate/src/lib/delim.ts","../../../../packages/translate/src/lib/compile.ts","../../../../packages/translate/src/lib/create-namespace.ts","../../../../packages/translate/src/lib/translation.store.ts","../../../../packages/translate/src/lib/register-namespace.ts","../../../../packages/translate/src/lib/translate.directive.ts","../../../../packages/translate/src/lib/translate.pipe.ts","../../../../packages/translate/src/mmstack-translate.ts"],"sourcesContent":["const KEY_DELIM = '::MMT_DELIM::';\r\n\r\nexport function prependDelim(prefix: string, key: string): string {\r\n return `${prefix}${KEY_DELIM}${key}`;\r\n}\r\n\r\nexport function replaceWithDelim(str: string, repl = '.'): string {\r\n return str.replaceAll(repl, KEY_DELIM);\r\n}\r\n","import { prependDelim } from './delim';\r\nimport {\r\n inferTranslationParamMap,\r\n inferTranslationShape,\r\n} from './parameterize.type';\r\nimport { UnknownStringKeyObject } from './string-key-object.type';\r\n\r\nconst INTERNAL_SYMBOL = Symbol.for('mmstack-translate-internal');\r\n\r\ntype InternalSymbol = typeof INTERNAL_SYMBOL;\r\n\r\nexport type CompiledTranslation<\r\n T extends UnknownStringKeyObject,\r\n TNS extends string,\r\n TLocale extends string = string,\r\n> = {\r\n flat: Record<string, string>;\r\n locale?: TLocale;\r\n namespace: TNS;\r\n [INTERNAL_SYMBOL]: {\r\n shape: inferTranslationShape<T>;\r\n map: inferTranslationParamMap<TNS, T>;\r\n };\r\n};\r\n\r\nexport type mergeTranslationMaps<\r\n TMain extends CompiledTranslation<UnknownStringKeyObject, string>,\r\n TOther extends CompiledTranslation<UnknownStringKeyObject, string>,\r\n> = Omit<TMain, InternalSymbol> & {\r\n [INTERNAL_SYMBOL]: {\r\n shape: inferCompiledTranslationShape<TMain>;\r\n map: inferCompiledTranslationMap<TOther> &\r\n inferCompiledTranslationMap<TMain>;\r\n };\r\n};\r\n\r\nexport type inferCompiledTranslationNamespace<\r\n T extends CompiledTranslation<UnknownStringKeyObject, string>,\r\n> = T['namespace'];\r\n\r\nexport type inferCompiledTranslationShape<\r\n T extends CompiledTranslation<UnknownStringKeyObject, string>,\r\n> = T[InternalSymbol]['shape'];\r\n\r\nexport type inferCompiledTranslationMap<\r\n T extends CompiledTranslation<UnknownStringKeyObject, string>,\r\n> = T[InternalSymbol]['map'];\r\n\r\nfunction isTranslationObject(t: unknown): t is UnknownStringKeyObject {\r\n return typeof t === 'object' && t !== null;\r\n}\r\n\r\nfunction flattenTranslation<T extends UnknownStringKeyObject>(obj: T) {\r\n return Object.entries(obj).reduce(\r\n (acc, [key, value]) => {\r\n if (typeof value === 'string') {\r\n acc[key] = value;\r\n } else if (isTranslationObject(value)) {\r\n Object.entries(flattenTranslation(value)).forEach(\r\n ([nestedKey, nestedValue]) => {\r\n acc[prependDelim(key, nestedKey)] = nestedValue;\r\n },\r\n );\r\n }\r\n\r\n return acc;\r\n },\r\n {} as Record<string, string>,\r\n );\r\n}\r\n\r\nexport function compileTranslation<\r\n T extends UnknownStringKeyObject,\r\n TNS extends string,\r\n TLocale extends string = string,\r\n>(\r\n translation: T,\r\n ns: TNS,\r\n locale?: TLocale,\r\n): CompiledTranslation<T, TNS, TLocale> {\r\n type $Shape = inferTranslationShape<T>;\r\n type $Map = inferTranslationParamMap<TNS, T>;\r\n\r\n return {\r\n locale,\r\n flat: flattenTranslation(translation),\r\n namespace: ns,\r\n [INTERNAL_SYMBOL]: {\r\n shape: {} as $Shape,\r\n map: {} as $Map,\r\n },\r\n };\r\n}\r\n","import {\r\n CompiledTranslation,\r\n compileTranslation,\r\n inferCompiledTranslationShape,\r\n mergeTranslationMaps,\r\n} from './compile';\r\nimport { UnknownStringKeyObject } from './string-key-object.type';\r\n\r\ntype TranslationNamespace<\r\n TNS extends string,\r\n T extends CompiledTranslation<UnknownStringKeyObject, TNS>,\r\n TShape extends UnknownStringKeyObject,\r\n> = {\r\n translation: T;\r\n createTranslation: <TLocale extends string>(\r\n locale: TLocale,\r\n translation: TShape,\r\n ) => CompiledTranslation<TShape, TNS, TLocale>;\r\n createMergedNamespace: <\r\n TOtherNS extends string,\r\n TOther extends UnknownStringKeyObject,\r\n TOtherCompiled extends CompiledTranslation<TOther, TOtherNS>,\r\n >(\r\n ns: TOtherNS,\r\n translation: TOther,\r\n ) => TranslationNamespace<\r\n TOtherNS,\r\n mergeTranslationMaps<TOtherCompiled, T>,\r\n inferCompiledTranslationShape<TOtherCompiled>\r\n >;\r\n};\r\n\r\nexport function createNamespace<\r\n const T extends UnknownStringKeyObject,\r\n TNS extends string,\r\n>(ns: TNS, translation: T) {\r\n const compiled = compileTranslation<T, TNS>(translation, ns);\r\n\r\n type TCompiled = typeof compiled;\r\n type TShape = inferCompiledTranslationShape<typeof compiled>;\r\n\r\n const namespace: TranslationNamespace<TNS, TCompiled, TShape> = {\r\n translation: compileTranslation(translation, ns),\r\n createTranslation: <TLocale extends string>(\r\n locale: TLocale,\r\n translation: TShape,\r\n ) => {\r\n return compileTranslation(translation, ns, locale);\r\n },\r\n createMergedNamespace: <\r\n TOther extends UnknownStringKeyObject,\r\n TOtherNS extends string,\r\n TOtherCompiled extends CompiledTranslation<\r\n TOther,\r\n TOtherNS\r\n > = CompiledTranslation<TOther, TOtherNS>,\r\n >(\r\n otherNs: TOtherNS,\r\n otherTranslation: TOther,\r\n ) => {\r\n return createNamespace(otherNs, otherTranslation) as TranslationNamespace<\r\n TOtherNS,\r\n mergeTranslationMaps<TOtherCompiled, TCompiled>,\r\n inferCompiledTranslationShape<TOtherCompiled>\r\n > as unknown as any;\r\n },\r\n };\r\n\r\n return namespace;\r\n}\r\n","import {\r\n computed,\r\n inject,\r\n Injectable,\r\n InjectionToken,\r\n LOCALE_ID,\r\n Provider,\r\n signal,\r\n} from '@angular/core';\r\nimport { createIntl, createIntlCache, IntlConfig } from '@formatjs/intl';\r\nimport { prependDelim } from './delim';\r\n\r\nconst CONFIG_TOKEN = new InjectionToken<\r\n Omit<IntlConfig, 'locale' | 'messages'>\r\n>('mmstack-intl-config');\r\n\r\nexport function provideIntlConfig(\r\n config: Omit<IntlConfig, 'locale' | 'messages'>,\r\n): Provider {\r\n return {\r\n useValue: config,\r\n provide: CONFIG_TOKEN,\r\n };\r\n}\r\n\r\nexport function injectIntlConfig() {\r\n return inject(CONFIG_TOKEN, { optional: true }) ?? undefined;\r\n}\r\n\r\nexport function injectDefaultLocale() {\r\n return injectIntlConfig()?.defaultLocale ?? 'en-US';\r\n}\r\n\r\n@Injectable({\r\n providedIn: 'root',\r\n})\r\nexport class TranslationStore {\r\n private readonly cache = createIntlCache();\r\n private readonly config = injectIntlConfig();\r\n private readonly locale = inject(LOCALE_ID);\r\n private readonly defaultLocale = injectDefaultLocale();\r\n private readonly translations = signal<\r\n Record<string, Record<string, string>>\r\n >({\r\n [this.defaultLocale]: {},\r\n });\r\n\r\n private readonly nonMessageConfig = computed(() => ({\r\n ...this.config,\r\n locale: this.locale,\r\n }));\r\n\r\n private readonly messages = computed(\r\n () =>\r\n this.translations()[this.locale] ??\r\n this.translations()[this.defaultLocale] ??\r\n {},\r\n );\r\n\r\n readonly intl = computed(() =>\r\n createIntl(\r\n {\r\n ...this.nonMessageConfig(),\r\n messages: this.messages(),\r\n },\r\n this.cache,\r\n ),\r\n );\r\n\r\n formatMessage(key: string, values?: Record<string, string | number>) {\r\n const message = this.translations()[this.locale]?.[key] ?? '';\r\n\r\n if (!message) return '';\r\n\r\n return this.intl().formatMessage(\r\n { id: key, defaultMessage: message },\r\n values,\r\n );\r\n }\r\n\r\n register(\r\n namespace: string,\r\n flat: Partial<Record<string, Record<string, string>>>,\r\n ) {\r\n this.translations.update((cur) => {\r\n return Object.entries(flat).reduce(\r\n (acc, [locale, translation]) => {\r\n const localeTranslation = acc[locale] ?? {};\r\n\r\n const withNS = Object.entries(translation ?? {}).reduce(\r\n (acc, [key, value]) => {\r\n acc[prependDelim(namespace, key)] = value;\r\n return acc;\r\n },\r\n {} as Record<string, string>,\r\n );\r\n\r\n acc[locale] = {\r\n ...localeTranslation,\r\n ...withNS,\r\n };\r\n\r\n return acc;\r\n },\r\n { ...cur },\r\n );\r\n });\r\n }\r\n}\r\n\r\nexport function injectIntl() {\r\n return inject(TranslationStore).intl;\r\n}\r\n","import {\r\n computed,\r\n inject,\r\n isDevMode,\r\n isSignal,\r\n LOCALE_ID,\r\n Signal,\r\n} from '@angular/core';\r\nimport {\r\n CompiledTranslation,\r\n inferCompiledTranslationMap,\r\n inferCompiledTranslationShape,\r\n} from './compile';\r\nimport { replaceWithDelim } from './delim';\r\nimport { UnknownStringKeyObject } from './string-key-object.type';\r\nimport { TranslationStore } from './translation.store';\r\n\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\ntype AnyStringRecord = Record<string, any>;\r\n\r\nfunction createEqualsRecord<T extends AnyStringRecord>(keys: (keyof T)[] = []) {\r\n let keyMatcher: (a: T, b: T) => boolean;\r\n\r\n if (keys.length === 0) {\r\n keyMatcher = () => true;\r\n } else if (keys.length === 1) {\r\n const key = keys[0];\r\n keyMatcher = (a, b) => a[key] === b[key];\r\n } else {\r\n keyMatcher = (a, b) => {\r\n return keys.every((k) => a[k] === b[k]);\r\n };\r\n }\r\n\r\n return (a?: T, b?: T): boolean => {\r\n if (!a && !b) return true;\r\n if (!a || !b) return false;\r\n return keyMatcher(a, b);\r\n };\r\n}\r\n\r\ntype TFunction<TMap extends AnyStringRecord> = <\r\n TKey extends keyof TMap & string,\r\n>(\r\n key: TKey,\r\n ...args: TMap[TKey] extends void ? [] : [TMap[TKey]]\r\n) => string;\r\n\r\ntype SignalTFunction<TMap extends AnyStringRecord> = <\r\n TKey extends keyof TMap & string,\r\n>(\r\n key: TKey,\r\n ...args: TMap[TKey] extends void ? [] : [() => TMap[TKey]]\r\n) => Signal<string>;\r\n\r\ntype TFunctionWithSignalConstructor<\r\n TMap extends AnyStringRecord,\r\n TFN extends TFunction<TMap>,\r\n> = TFN & {\r\n asSignal: SignalTFunction<TMap>;\r\n};\r\n\r\nfunction addSignalFn<TMap extends AnyStringRecord, TFn extends TFunction<TMap>>(\r\n fn: TFn,\r\n store: TranslationStore,\r\n): TFunctionWithSignalConstructor<TMap, TFn> {\r\n const withSig = fn as TFunctionWithSignalConstructor<TMap, TFn>;\r\n\r\n const asSignal = <TKey extends keyof TMap & string>(\r\n key: TKey,\r\n ...args: TMap[TKey] extends void ? [] : [() => TMap[TKey]]\r\n ): Signal<string> => {\r\n const variables = args[0] as () => AnyStringRecord | undefined;\r\n const stringKey = key as string;\r\n\r\n const flatPath = replaceWithDelim(stringKey);\r\n\r\n const varsFn = variables === undefined ? () => undefined : variables;\r\n const varsSignal = isSignal(varsFn)\r\n ? varsFn\r\n : computed(varsFn, {\r\n equal: createEqualsRecord(Object.keys(varsFn() as object)),\r\n });\r\n\r\n return computed(() => store.formatMessage(flatPath, varsSignal()));\r\n };\r\n\r\n withSig.asSignal = asSignal;\r\n\r\n return withSig;\r\n}\r\n\r\nexport function createT<TMap extends AnyStringRecord>(\r\n store: TranslationStore,\r\n): TFunction<TMap> {\r\n return <TKey extends keyof TMap & string>(\r\n key: TKey,\r\n ...args: TMap[TKey] extends void ? [] : [TMap[TKey]]\r\n ): string => {\r\n const variables = args[0] as AnyStringRecord | undefined;\r\n const stringKey = key as string;\r\n\r\n return store.formatMessage(replaceWithDelim(stringKey), variables);\r\n };\r\n}\r\n\r\nexport function registerNamespace<\r\n TDefault extends CompiledTranslation<UnknownStringKeyObject, string>,\r\n TOther extends CompiledTranslation<\r\n inferCompiledTranslationShape<TDefault>,\r\n string\r\n >,\r\n>(\r\n defaultTranslation: () => Promise<TDefault>,\r\n other: Record<string, () => Promise<TOther>>,\r\n) {\r\n type $Map = inferCompiledTranslationMap<TDefault>;\r\n type $BaseTFN = TFunction<$Map>;\r\n type $TFN = TFunctionWithSignalConstructor<$Map, $BaseTFN>;\r\n\r\n const injectT = (): $TFN => {\r\n const store = inject(TranslationStore);\r\n\r\n return addSignalFn(createT(store), store);\r\n };\r\n\r\n let defaultTranslationLoaded = false;\r\n const resolver = async () => {\r\n const locale = inject(LOCALE_ID);\r\n const store = inject(TranslationStore);\r\n\r\n const tPromise = other[locale] as (() => Promise<TOther>) | undefined;\r\n\r\n const promise = tPromise ?? defaultTranslation;\r\n if (!promise && isDevMode()) {\r\n return console.warn(`No translation found for locale: ${locale}`);\r\n }\r\n\r\n if (promise === defaultTranslation && defaultTranslationLoaded) return;\r\n\r\n try {\r\n const translation = await promise();\r\n\r\n if (translation.locale !== locale && isDevMode()) {\r\n return console.warn(\r\n `Expected locale to be ${locale} but got ${translation.locale}`,\r\n );\r\n }\r\n\r\n store.register(translation.namespace, {\r\n [locale]: translation.flat,\r\n });\r\n if (promise === defaultTranslation) {\r\n defaultTranslationLoaded = true;\r\n }\r\n } catch {\r\n if (isDevMode()) {\r\n console.warn(`Failed to load translation for locale: ${locale}`);\r\n }\r\n }\r\n };\r\n\r\n return {\r\n injectNamespaceT: injectT,\r\n resolveNamespaceTranslation: resolver,\r\n };\r\n}\r\n","import {\r\n computed,\r\n Directive,\r\n effect,\r\n ElementRef,\r\n inject,\r\n input,\r\n Renderer2,\r\n} from '@angular/core';\r\nimport { CompiledTranslation, inferCompiledTranslationMap } from './compile';\r\nimport { createT } from './register-namespace';\r\nimport { UnknownStringKeyObject } from './string-key-object.type';\r\nimport { TranslationStore } from './translation.store';\r\n\r\n@Directive()\r\nexport abstract class BaseTranslateDirective<\r\n TInput extends string,\r\n T extends CompiledTranslation<UnknownStringKeyObject, string>,\r\n TMap extends inferCompiledTranslationMap<T> = inferCompiledTranslationMap<T>,\r\n TKey extends TInput & keyof TMap & string = TInput & keyof TMap & string,\r\n> {\r\n private readonly t = createT(inject(TranslationStore));\r\n\r\n readonly translate =\r\n input.required<\r\n TMap[TKey] extends void\r\n ? TKey | [key: TKey]\r\n : [key: TKey, vars: TMap[TKey]]\r\n >();\r\n\r\n constructor() {\r\n const key = computed(() => {\r\n const vars = this.translate();\r\n return (Array.isArray(vars) ? vars[0] : vars) as TKey;\r\n });\r\n\r\n const args = computed(\r\n () => {\r\n const vars = this.translate();\r\n return (Array.isArray(vars) ? vars[1] : undefined) as TMap[TKey];\r\n },\r\n {\r\n equal: (a, b) => {\r\n if (a === undefined && b === undefined) return true;\r\n if (a === undefined || b === undefined) return false;\r\n\r\n const aObj = a as Record<string, string>;\r\n const keys = Object.keys(aObj);\r\n const bObj = b as Record<string, string>;\r\n\r\n if (!keys.length) return !Object.keys(bObj).length;\r\n\r\n return keys.every((key) => aObj[key] === bObj[key]);\r\n },\r\n },\r\n );\r\n\r\n const translation = computed(() => this.t(key(), args()));\r\n\r\n const renderer = inject(Renderer2);\r\n const el = inject<ElementRef<HTMLElement>>(ElementRef);\r\n\r\n effect(() =>\r\n renderer.setProperty(el.nativeElement, 'textContent', translation()),\r\n );\r\n }\r\n}\r\n","import { inject } from '@angular/core';\r\nimport { CompiledTranslation, inferCompiledTranslationMap } from './compile';\r\nimport { createT } from './register-namespace';\r\nimport { UnknownStringKeyObject } from './string-key-object.type';\r\nimport { TranslationStore } from './translation.store';\r\n\r\nexport abstract class BaseTranslatePipe<\r\n T extends CompiledTranslation<UnknownStringKeyObject, string>,\r\n TMap extends inferCompiledTranslationMap<T> = inferCompiledTranslationMap<T>,\r\n> {\r\n private readonly t = createT<TMap>(inject(TranslationStore));\r\n\r\n transform<K extends keyof TMap & string>(\r\n key: K,\r\n ...args: TMap[K] extends void ? [] : [TMap[K]]\r\n ): string {\r\n return this.t(key, ...args);\r\n }\r\n}\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
|
|
@@ -5,5 +5,5 @@ type TranslationNamespace<TNS extends string, T extends CompiledTranslation<Unkn
|
|
|
5
5
|
createTranslation: <TLocale extends string>(locale: TLocale, translation: TShape) => CompiledTranslation<TShape, TNS, TLocale>;
|
|
6
6
|
createMergedNamespace: <TOtherNS extends string, TOther extends UnknownStringKeyObject, TOtherCompiled extends CompiledTranslation<TOther, TOtherNS>>(ns: TOtherNS, translation: TOther) => TranslationNamespace<TOtherNS, mergeTranslationMaps<TOtherCompiled, T>, inferCompiledTranslationShape<TOtherCompiled>>;
|
|
7
7
|
};
|
|
8
|
-
export declare function createNamespace<T extends UnknownStringKeyObject, TNS extends string>(ns: TNS, translation: T): TranslationNamespace<TNS, CompiledTranslation<T, TNS, string>, import("./parameterize.type").inferTranslationShape<T>>;
|
|
8
|
+
export declare function createNamespace<const T extends UnknownStringKeyObject, TNS extends string>(ns: TNS, translation: T): TranslationNamespace<TNS, CompiledTranslation<T, TNS, string>, import("./parameterize.type").inferTranslationShape<T>>;
|
|
9
9
|
export {};
|
|
@@ -9,7 +9,7 @@ type TFunctionWithSignalConstructor<TMap extends AnyStringRecord, TFN extends TF
|
|
|
9
9
|
asSignal: SignalTFunction<TMap>;
|
|
10
10
|
};
|
|
11
11
|
export declare function createT<TMap extends AnyStringRecord>(store: TranslationStore): TFunction<TMap>;
|
|
12
|
-
export declare function registerNamespace<TDefault extends CompiledTranslation<UnknownStringKeyObject, string>, TOther extends CompiledTranslation<inferCompiledTranslationShape<TDefault>, string>>(
|
|
12
|
+
export declare function registerNamespace<TDefault extends CompiledTranslation<UnknownStringKeyObject, string>, TOther extends CompiledTranslation<inferCompiledTranslationShape<TDefault>, string>>(defaultTranslation: () => Promise<TDefault>, other: Record<string, () => Promise<TOther>>): {
|
|
13
13
|
injectNamespaceT: () => TFunctionWithSignalConstructor<inferCompiledTranslationMap<TDefault>, TFunction<inferCompiledTranslationMap<TDefault>>>;
|
|
14
14
|
resolveNamespaceTranslation: () => Promise<void>;
|
|
15
15
|
};
|