@rivinia/i18n 1.0.0-rc.4 → 1.0.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/CHANGELOG.md +3 -19
- package/README.md +14 -14
- package/package.json +3 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,24 +1,8 @@
|
|
|
1
1
|
# @rivinia/i18n
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
`provideRiviniaI18n` config keys**, the pipe name (`rvTranslate`), **the loader
|
|
7
|
-
descriptor contract — including the `LoaderContext` a custom loader receives**,
|
|
8
|
-
the ICU placeholder rules, the `--rv-i18n-*` token names, and the declaration
|
|
9
|
-
shape `rivinia-i18n-keys` generates (`RiviniaI18nKeyRegistry`). Changing any of
|
|
10
|
-
those is a major; adding one is a minor. A new token is always additive — the
|
|
11
|
-
toggle and the picker read `var(--rv-i18n-<name>, var(--rv-<semantic>, <previous
|
|
12
|
-
value>))`.
|
|
13
|
-
|
|
14
|
-
Coming from 0.8.0: **nothing to do** — 1.0.0 removes no name and renames none.
|
|
15
|
-
The removals a consumer already met were in 0.6.0 (`RTranslatePipe` /
|
|
16
|
-
`rTranslate`), recorded below, and the freeze that fixed what ships is
|
|
17
|
-
[`docs/releases/1.0/API-SURFACE.md`](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/docs/releases/1.0/API-SURFACE.md).
|
|
18
|
-
The README is the start-here tier; everyday patterns and the reference live in
|
|
19
|
-
[`docs/i18n/`](https://github.com/abdelfattahqandil21-oss/Revinia/tree/main/docs/i18n),
|
|
20
|
-
one topic per page. This file keeps what a consumer of this package needs,
|
|
21
|
-
including the migration notes for 0.6.0 and 0.4.0.
|
|
3
|
+
## 1.0.0
|
|
4
|
+
|
|
5
|
+
- First stable release. The optional @rivinia/select peer remains optional and accepts the stable 1.0 line.
|
|
22
6
|
|
|
23
7
|
## 1.0.0-rc.4
|
|
24
8
|
|
package/README.md
CHANGED
|
@@ -4,16 +4,16 @@
|
|
|
4
4
|
[](https://www.npmjs.com/package/@rivinia/i18n)
|
|
5
5
|
|
|
6
6
|
<p align="center">
|
|
7
|
-
<img src="https://raw.githubusercontent.com/abdelfattahqandil21-oss/Revinia/i18n/v1.0.0
|
|
7
|
+
<img src="https://raw.githubusercontent.com/abdelfattahqandil21-oss/Revinia/i18n/v1.0.0/assets/rivinia-abstract-mark-light.svg" alt="Rivinia" width="340" />
|
|
8
8
|
</p>
|
|
9
9
|
|
|
10
10
|
A headless Angular language manager built on signals: key-based JSON
|
|
11
11
|
dictionaries, inline translations, RTL/LTR document attributes, lazy loaders, ICU
|
|
12
12
|
plural/select messages, browser-language detection, and `Intl` number/date
|
|
13
13
|
formatting — with SSR that actually works and no runtime dependency beyond
|
|
14
|
-
Angular. Package version: **1.0.0
|
|
14
|
+
Angular. Package version: **1.0.0**.
|
|
15
15
|
|
|
16
|
-
1.0.0
|
|
16
|
+
The `1.0.0` stable release follows the 1.0 release candidates; 0.x was experimental.
|
|
17
17
|
|
|
18
18
|
Concretely: the text lives in JSON files, components ask for a key, and the whole
|
|
19
19
|
app — text, direction, dates, numbers — follows the language the user picked.
|
|
@@ -43,7 +43,7 @@ export class Header {
|
|
|
43
43
|
|
|
44
44
|
`title()` and the pipe update on the click and the page's direction flips with the
|
|
45
45
|
language — nothing else is wired by hand. The same app under
|
|
46
|
-
[`projects/i18n/testing/app/src`](https://github.com/abdelfattahqandil21-oss/Revinia/tree/i18n/v1.0.0
|
|
46
|
+
[`projects/i18n/testing/app/src`](https://github.com/abdelfattahqandil21-oss/Revinia/tree/i18n/v1.0.0/projects/i18n/testing/app/src)
|
|
47
47
|
is what the Playwright suites drive: `npx ng build i18n-e2e` runs it locally.
|
|
48
48
|
|
|
49
49
|
## Why `@rivinia/i18n`
|
|
@@ -129,7 +129,7 @@ so an app that never runs `ng add` does not install it). Optional, for the picke
|
|
|
129
129
|
|
|
130
130
|
The two are independent: the UI entry points import core **types** only, and the core
|
|
131
131
|
never imports them. Every UI export is Experimental; the tiers are in the
|
|
132
|
-
[API reference](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0
|
|
132
|
+
[API reference](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0/docs/i18n/api.md#api-stability).
|
|
133
133
|
|
|
134
134
|
## Compatibility
|
|
135
135
|
|
|
@@ -144,25 +144,25 @@ above. The **Enhanced** row belongs to the picker's popup, which is
|
|
|
144
144
|
`@rivinia/select`'s; the toggle is a plain button and is unaffected.
|
|
145
145
|
`document.startViewTransition` is used only if you opt into `viewTransition` — the
|
|
146
146
|
service feature-detects it and applies the change without a transition where it is
|
|
147
|
-
absent. Peers: `@angular/core` `^22.0.0`, plus `@rivinia/select` `^1.0.0
|
|
147
|
+
absent. Peers: `@angular/core` `^22.0.0`, plus `@rivinia/select` `^1.0.0` for
|
|
148
148
|
the `/select` entry only — optional, so an app that never imports
|
|
149
149
|
`@rivinia/i18n/select` does not install it. The caret admits every select 1.x
|
|
150
150
|
release, the rc and the final alike, and excludes a 2.0. The floor dates, the
|
|
151
151
|
`@supports` gate and what has never been run (including real Safari) are in
|
|
152
|
-
[browser support](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0
|
|
152
|
+
[browser support](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0/docs/browser-support.md).
|
|
153
153
|
|
|
154
154
|
## Go further
|
|
155
155
|
|
|
156
156
|
Three levels, kept as they were: everyday patterns first, then the complete
|
|
157
157
|
surface ordered by API.
|
|
158
158
|
|
|
159
|
-
| Tier | Read
|
|
160
|
-
| ----------------------- |
|
|
161
|
-
| Everyday use | [translating text](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0
|
|
162
|
-
| Reference — behaviour | [ICU messages](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0
|
|
163
|
-
| Reference — the surface | [the API](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0
|
|
164
|
-
| Theming | [Rivinia theming](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0
|
|
159
|
+
| Tier | Read |
|
|
160
|
+
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
161
|
+
| Everyday use | [translating text](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0/docs/i18n/translating.md) · [switching the language](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0/docs/i18n/switching.md) · [dictionaries and SSR](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0/docs/i18n/dictionaries.md) |
|
|
162
|
+
| Reference — behaviour | [ICU messages](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0/docs/i18n/icu.md) · [missing keys, fallback and failures](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0/docs/i18n/resilience.md) · [the CLI](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0/docs/i18n/cli.md) |
|
|
163
|
+
| Reference — the surface | [the API](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0/docs/i18n/api.md) · [the language toggle](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0/docs/i18n/toggle.md) · [the language picker](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0/docs/i18n/select.md) |
|
|
164
|
+
| Theming | [Rivinia theming](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0/docs/theme/README.md) |
|
|
165
165
|
|
|
166
166
|
Migration notes for each version live in
|
|
167
|
-
[CHANGELOG.md](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0
|
|
167
|
+
[CHANGELOG.md](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0/projects/i18n/CHANGELOG.md).
|
|
168
168
|
MIT licensed.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@rivinia/i18n",
|
|
3
|
-
"version": "1.0.0
|
|
3
|
+
"version": "1.0.0",
|
|
4
4
|
"description": "Headless Angular language manager: signals, RTL, SSR-safe loaders, fallback language, missing-key reporting, ICU plurals, typed keys.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"angular",
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
"url": "git+https://github.com/abdelfattahqandil21-oss/Revinia.git",
|
|
18
18
|
"directory": "projects/i18n"
|
|
19
19
|
},
|
|
20
|
-
"homepage": "https://github.com/abdelfattahqandil21-oss/Revinia/tree/
|
|
20
|
+
"homepage": "https://github.com/abdelfattahqandil21-oss/Revinia/tree/i18n/v1.0.0/projects/i18n#readme",
|
|
21
21
|
"bugs": {
|
|
22
22
|
"url": "https://github.com/abdelfattahqandil21-oss/Revinia/issues"
|
|
23
23
|
},
|
|
@@ -33,7 +33,7 @@
|
|
|
33
33
|
"peerDependencies": {
|
|
34
34
|
"@angular-devkit/schematics": "^22.0.0",
|
|
35
35
|
"@angular/core": "^22.0.0",
|
|
36
|
-
"@rivinia/select": "^1.0.0
|
|
36
|
+
"@rivinia/select": "^1.0.0"
|
|
37
37
|
},
|
|
38
38
|
"peerDependenciesMeta": {
|
|
39
39
|
"@angular-devkit/schematics": {
|