@rivinia/i18n 1.0.0-rc.2 → 1.0.0-rc.3
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 +28 -0
- package/README.md +12 -12
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -20,6 +20,34 @@ The README is the start-here tier; everyday patterns and the reference live in
|
|
|
20
20
|
one topic per page. This file keeps what a consumer of this package needs,
|
|
21
21
|
including the migration notes for 0.6.0 and 0.4.0.
|
|
22
22
|
|
|
23
|
+
## 1.0.0-rc.3
|
|
24
|
+
|
|
25
|
+
**No config key, export, pipe, token, loader hook or behavior changed** — the code in
|
|
26
|
+
this release is the code of `1.0.0-rc.2`. The version exists because a published version
|
|
27
|
+
is immutable and `1.0.0-rc.2` shipped a `CHANGELOG.md` whose newest heading was still
|
|
28
|
+
`## 1.0.0-rc.1`, and because every repository link in the READMEs now points at an
|
|
29
|
+
immutable release tag instead of the moving `main` branch.
|
|
30
|
+
|
|
31
|
+
- **Documentation links are pinned to this release.** The asset and docs links in
|
|
32
|
+
`README.md` resolve through the `i18n/v1.0.0-rc.3` tag, so the document read from the
|
|
33
|
+
installed package can never be redirected to a `main` that has moved on.
|
|
34
|
+
- **Nothing a consumer imports moved**: 35 names at `.`, 5 at `./ui`, 5 at `./select`,
|
|
35
|
+
the `rvTranslate` pipe, the ICU rules and the shape `rivinia-i18n-keys` generates are
|
|
36
|
+
as frozen in the API surface document.
|
|
37
|
+
- **The optional `@rivinia/select` peer stays at `^1.0.0-rc.1` on purpose.** That range
|
|
38
|
+
admits every select `1.x` — each rc and the stable release alike — and excludes a 2.0,
|
|
39
|
+
which is what a peer wants. It is deliberately not `^1.0.0` yet: a caret on `1.0.0`
|
|
40
|
+
excludes prereleases, so an app installing this rc alongside `@rivinia/select@next`
|
|
41
|
+
would get an `ERESOLVE` the day the file is changed and not before. The flip belongs
|
|
42
|
+
with the `1.0.0` release, where both sides exist.
|
|
43
|
+
|
|
44
|
+
## 1.0.0-rc.2
|
|
45
|
+
|
|
46
|
+
Documentation only, and the first release of this package whose own changelog entry had
|
|
47
|
+
to be written after the fact (see above). What it carried was the `Package version` line
|
|
48
|
+
in `README.md`; the optional `@rivinia/select` peer stayed at `^1.0.0-rc.1`. No config
|
|
49
|
+
key, export, pipe, token, loader hook or behavior changed.
|
|
50
|
+
|
|
23
51
|
## 1.0.0-rc.1
|
|
24
52
|
|
|
25
53
|
- **The optional `@rivinia/select` peer is now `^1.0.0-rc.1`** (it was `^0.7.0`, a
|
package/README.md
CHANGED
|
@@ -4,14 +4,14 @@
|
|
|
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/
|
|
7
|
+
<img src="https://raw.githubusercontent.com/abdelfattahqandil21-oss/Revinia/i18n/v1.0.0-rc.3/assets/rivinia-abstract-mark-light.svg" alt="Rivinia" width="140" />
|
|
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-rc.
|
|
14
|
+
Angular. Package version: **1.0.0-rc.3**.
|
|
15
15
|
|
|
16
16
|
1.0.0-rc.1 is the first supported release; 0.x was experimental.
|
|
17
17
|
|
|
@@ -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
|
|
46
|
+
[`projects/i18n/testing/app/src`](https://github.com/abdelfattahqandil21-oss/Revinia/tree/i18n/v1.0.0-rc.3/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/
|
|
132
|
+
[API reference](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/docs/i18n/api.md#api-stability).
|
|
133
133
|
|
|
134
134
|
## Compatibility
|
|
135
135
|
|
|
@@ -149,20 +149,20 @@ 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/
|
|
152
|
+
[browser support](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/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/
|
|
162
|
-
| Reference — behaviour | [ICU messages](https://github.com/abdelfattahqandil21-oss/Revinia/blob/
|
|
163
|
-
| Reference — the surface | [the API](https://github.com/abdelfattahqandil21-oss/Revinia/blob/
|
|
164
|
-
| Theming | [Rivinia theming](https://github.com/abdelfattahqandil21-oss/Revinia/blob/
|
|
159
|
+
| Tier | Read |
|
|
160
|
+
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
161
|
+
| Everyday use | [translating text](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/docs/i18n/translating.md) · [switching the language](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/docs/i18n/switching.md) · [dictionaries and SSR](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/docs/i18n/dictionaries.md) |
|
|
162
|
+
| Reference — behaviour | [ICU messages](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/docs/i18n/icu.md) · [missing keys, fallback and failures](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/docs/i18n/resilience.md) · [the CLI](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/docs/i18n/cli.md) |
|
|
163
|
+
| Reference — the surface | [the API](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/docs/i18n/api.md) · [the language toggle](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/docs/i18n/toggle.md) · [the language picker](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/docs/i18n/select.md) |
|
|
164
|
+
| Theming | [Rivinia theming](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/docs/theming.md) |
|
|
165
165
|
|
|
166
166
|
Migration notes for each version live in
|
|
167
|
-
[CHANGELOG.md](https://github.com/abdelfattahqandil21-oss/Revinia/blob/
|
|
167
|
+
[CHANGELOG.md](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/projects/i18n/CHANGELOG.md).
|
|
168
168
|
MIT licensed.
|
package/package.json
CHANGED