@rivinia/i18n 1.0.0-rc.4 → 1.0.1

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 +7 -19
  2. package/README.md +14 -15
  3. package/package.json +3 -3
package/CHANGELOG.md CHANGED
@@ -1,24 +1,12 @@
1
1
  # @rivinia/i18n
2
2
 
3
- From 1.0.0 this package follows **strict semver**: only a major may break, a new
4
- config key, export, token or loader hook is a minor, and a patch never changes
5
- what a page renders. The contract is wider than the export list: **the
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.1
4
+
5
+ - Documentation links updated to the 1.0.1 tag.
6
+
7
+ ## 1.0.0
8
+
9
+ - First stable release. The optional @rivinia/select peer remains optional and accepts the stable 1.0 line.
22
10
 
23
11
  ## 1.0.0-rc.4
24
12
 
package/README.md CHANGED
@@ -4,16 +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/i18n/v1.0.0-rc.4/assets/rivinia-abstract-mark-light.svg" alt="Rivinia" width="140" />
7
+ <img src="https://raw.githubusercontent.com/abdelfattahqandil21-oss/Revinia/i18n/v1.0.1/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-rc.4**.
14
+ Angular. Package version: **1.0.1**.
15
15
 
16
- 1.0.0-rc.1 is the first supported release; 0.x was experimental.
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-rc.4/projects/i18n/testing/app/src)
46
+ [`projects/i18n/testing/app/src`](https://github.com/abdelfattahqandil21-oss/Revinia/tree/i18n/v1.0.1/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-rc.4/docs/i18n/api.md#api-stability).
132
+ [API reference](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.1/docs/i18n/api.md#api-stability).
133
133
 
134
134
  ## Compatibility
135
135
 
@@ -144,25 +144,24 @@ 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-rc.1` for
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-rc.4/docs/browser-support.md).
152
+ [browser support](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.1/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-rc.4/docs/i18n/translating.md) · [switching the language](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.4/docs/i18n/switching.md) · [dictionaries and SSR](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.4/docs/i18n/dictionaries.md) |
162
- | Reference — behaviour | [ICU messages](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.4/docs/i18n/icu.md) · [missing keys, fallback and failures](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.4/docs/i18n/resilience.md) · [the CLI](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.4/docs/i18n/cli.md) |
163
- | Reference — the surface | [the API](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.4/docs/i18n/api.md) · [the language toggle](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.4/docs/i18n/toggle.md) · [the language picker](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.4/docs/i18n/select.md) |
164
- | Theming | [Rivinia theming](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.4/docs/theme/README.md) |
159
+ | Tier | Read |
160
+ | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
161
+ | Everyday use | [translating text](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.1/docs/i18n/translating.md) · [switching the language](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.1/docs/i18n/switching.md) · [dictionaries and SSR](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.1/docs/i18n/dictionaries.md) |
162
+ | Reference — behaviour | [ICU messages](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.1/docs/i18n/icu.md) · [missing keys, fallback and failures](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.1/docs/i18n/resilience.md) · [the CLI](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.1/docs/i18n/cli.md) |
163
+ | Reference — the surface | [the API](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.1/docs/i18n/api.md) · [the language toggle](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.1/docs/i18n/toggle.md) · [the language picker](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.1/docs/i18n/select.md) |
164
+ | Theming | [Rivinia theming](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.1/docs/theme/README.md) |
165
165
 
166
- Migration notes for each version live in
167
- [CHANGELOG.md](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.0-rc.4/projects/i18n/CHANGELOG.md).
166
+ Release history: [CHANGELOG.md](https://github.com/abdelfattahqandil21-oss/Revinia/blob/i18n/v1.0.1/projects/i18n/CHANGELOG.md).
168
167
  MIT licensed.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rivinia/i18n",
3
- "version": "1.0.0-rc.4",
3
+ "version": "1.0.1",
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/main/projects/i18n#readme",
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-rc.1"
36
+ "@rivinia/select": "^1.0.0"
37
37
  },
38
38
  "peerDependenciesMeta": {
39
39
  "@angular-devkit/schematics": {