@rivinia/i18n 1.0.0-rc.1 → 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.
Files changed (3) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/README.md +14 -12
  3. 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,16 @@
4
4
  [![license](https://img.shields.io/npm/l/@rivinia/i18n.svg)](https://www.npmjs.com/package/@rivinia/i18n)
5
5
 
6
6
  <p align="center">
7
- <img src="https://raw.githubusercontent.com/abdelfattahqandil21-oss/Revinia/main/assets/rivinia-abstract-mark-light.svg" alt="Rivinia" width="140" />
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.1**.
14
+ Angular. Package version: **1.0.0-rc.3**.
15
+
16
+ 1.0.0-rc.1 is the first supported release; 0.x was experimental.
15
17
 
16
18
  Concretely: the text lives in JSON files, components ask for a key, and the whole
17
19
  app — text, direction, dates, numbers — follows the language the user picked.
@@ -41,7 +43,7 @@ export class Header {
41
43
 
42
44
  `title()` and the pipe update on the click and the page's direction flips with the
43
45
  language — nothing else is wired by hand. The same app under
44
- [`projects/i18n-e2e/src/app`](https://github.com/abdelfattahqandil21-oss/Revinia/tree/main/projects/i18n-e2e/src/app)
46
+ [`projects/i18n/testing/app/src`](https://github.com/abdelfattahqandil21-oss/Revinia/tree/i18n/v1.0.0-rc.3/projects/i18n/testing/app/src)
45
47
  is what the Playwright suites drive: `npx ng build i18n-e2e` runs it locally.
46
48
 
47
49
  ## Why `@rivinia/i18n`
@@ -127,7 +129,7 @@ so an app that never runs `ng add` does not install it). Optional, for the picke
127
129
 
128
130
  The two are independent: the UI entry points import core **types** only, and the core
129
131
  never imports them. Every UI export is Experimental; the tiers are in the
130
- [API reference](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/docs/i18n/api.md#api-stability).
132
+ [API reference](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/docs/i18n/api.md#api-stability).
131
133
 
132
134
  ## Compatibility
133
135
 
@@ -147,20 +149,20 @@ the `/select` entry only — optional, so an app that never imports
147
149
  `@rivinia/i18n/select` does not install it. The caret admits every select 1.x
148
150
  release, the rc and the final alike, and excludes a 2.0. The floor dates, the
149
151
  `@supports` gate and what has never been run (including real Safari) are in
150
- [browser support](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/docs/browser-support.md).
152
+ [browser support](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/docs/browser-support.md).
151
153
 
152
154
  ## Go further
153
155
 
154
156
  Three levels, kept as they were: everyday patterns first, then the complete
155
157
  surface ordered by API.
156
158
 
157
- | Tier | Read |
158
- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
159
- | Everyday use | [translating text](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/docs/i18n/translating.md) · [switching the language](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/docs/i18n/switching.md) · [dictionaries and SSR](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/docs/i18n/dictionaries.md) |
160
- | Reference — behaviour | [ICU messages](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/docs/i18n/icu.md) · [missing keys, fallback and failures](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/docs/i18n/resilience.md) · [the CLI](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/docs/i18n/cli.md) |
161
- | Reference — the surface | [the API](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/docs/i18n/api.md) · [the language toggle](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/docs/i18n/toggle.md) · [the language picker](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/docs/i18n/select.md) |
162
- | Theming | [Rivinia theming](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/docs/theming.md) |
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) |
163
165
 
164
166
  Migration notes for each version live in
165
- [CHANGELOG.md](https://github.com/abdelfattahqandil21-oss/Revinia/blob/main/projects/i18n/CHANGELOG.md).
167
+ [CHANGELOG.md](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.3/projects/i18n/CHANGELOG.md).
166
168
  MIT licensed.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rivinia/i18n",
3
- "version": "1.0.0-rc.1",
3
+ "version": "1.0.0-rc.3",
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",