@aparte/angular 0.24.0 → 0.25.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/README.md CHANGED
@@ -1,9 +1,13 @@
1
1
  # @aparte/angular
2
2
 
3
3
  The **Angular AI chat component** of [aparté](https://github.com/apartejs/aparte) — an ergonomic
4
- `<aparte-chat>` standalone component (Angular 19) plus services (`AparteAiService`, `ConversationManagerService`) over the
4
+ `<aparte-chat>` standalone component (Angular 19.2 to 21, zone or zoneless) plus services (`AparteAiService`, `ConversationManagerService`) over the
5
5
  framework-agnostic web components in `@aparte/core`.
6
6
 
7
+ Tested in CI with Angular 19 and 21, zoneless, and in an Angular 21 SSR app rendered on the server
8
+ and hydrated with no mismatch — no `@defer` needed. `<ng-template aparteToolUI="…" let-tool>`
9
+ draws a tool call with your own components, injected from where you declare it.
10
+
7
11
  ```bash
8
12
  npm install @aparte/angular @aparte/core @angular/core @angular/common rxjs
9
13
  ```
@@ -48,13 +52,12 @@ that write attributes, one typed `@Output()` per event, and no `CUSTOM_ELEMENTS_
48
52
  component. Import what you use or `APARTE_ELEMENT_DIRECTIVES` for all of them.
49
53
  `<aparte-ui name="my-widget">` remains for an element aparté does not define.
50
54
 
51
- **On the Angular version.** The peer range is `^19.2.0`, and that is the only major this
52
- package is built and browser-tested against. It is a thin bridge over standard custom
53
- elements — no private Angular API, no `NgModule`, nothing the newer majors removed — so 20
54
- through 22 will very likely work, and you can install it with `--legacy-peer-deps` or an
55
- override if you want to try. But "very likely" is not something to encode in a peer range:
56
- the sibling Svelte wrapper claims two majors because each one is compiled and driven in a
57
- real browser in CI, and this one has no such example yet. Widening the range before the
58
- proof exists would be a promise nobody here has checked.
55
+ **On the Angular version.** The peer range is `^19.2.0 || ^20.0.0 || ^21.0.0`, and each
56
+ end of it is proven rather than assumed. The package is compiled on 19.2, its oldest major,
57
+ in Angular's partial mode, which Angular guarantees a newer app can link; its specs run on
58
+ 19, under zone.js and zoneless, and in a server render. The repo's Angular example runs on
59
+ 21, zoneless, and is driven in a real browser by the end-to-end suite. 20 sits between two
60
+ proven majors. Angular 22 is not in the range yet: it joins when it is driven the same way,
61
+ not before — a peer range is a promise, and this one only promises what has been run.
59
62
 
60
63
  > ESM-only. See the docs for the full API. Part of the aparté monorepo.
package/dist/README.md CHANGED
@@ -1,9 +1,13 @@
1
1
  # @aparte/angular
2
2
 
3
3
  The **Angular AI chat component** of [aparté](https://github.com/apartejs/aparte) — an ergonomic
4
- `<aparte-chat>` standalone component (Angular 19) plus services (`AparteAiService`, `ConversationManagerService`) over the
4
+ `<aparte-chat>` standalone component (Angular 19.2 to 21, zone or zoneless) plus services (`AparteAiService`, `ConversationManagerService`) over the
5
5
  framework-agnostic web components in `@aparte/core`.
6
6
 
7
+ Tested in CI with Angular 19 and 21, zoneless, and in an Angular 21 SSR app rendered on the server
8
+ and hydrated with no mismatch — no `@defer` needed. `<ng-template aparteToolUI="…" let-tool>`
9
+ draws a tool call with your own components, injected from where you declare it.
10
+
7
11
  ```bash
8
12
  npm install @aparte/angular @aparte/core @angular/core @angular/common rxjs
9
13
  ```
@@ -48,13 +52,12 @@ that write attributes, one typed `@Output()` per event, and no `CUSTOM_ELEMENTS_
48
52
  component. Import what you use or `APARTE_ELEMENT_DIRECTIVES` for all of them.
49
53
  `<aparte-ui name="my-widget">` remains for an element aparté does not define.
50
54
 
51
- **On the Angular version.** The peer range is `^19.2.0`, and that is the only major this
52
- package is built and browser-tested against. It is a thin bridge over standard custom
53
- elements — no private Angular API, no `NgModule`, nothing the newer majors removed — so 20
54
- through 22 will very likely work, and you can install it with `--legacy-peer-deps` or an
55
- override if you want to try. But "very likely" is not something to encode in a peer range:
56
- the sibling Svelte wrapper claims two majors because each one is compiled and driven in a
57
- real browser in CI, and this one has no such example yet. Widening the range before the
58
- proof exists would be a promise nobody here has checked.
55
+ **On the Angular version.** The peer range is `^19.2.0 || ^20.0.0 || ^21.0.0`, and each
56
+ end of it is proven rather than assumed. The package is compiled on 19.2, its oldest major,
57
+ in Angular's partial mode, which Angular guarantees a newer app can link; its specs run on
58
+ 19, under zone.js and zoneless, and in a server render. The repo's Angular example runs on
59
+ 21, zoneless, and is driven in a real browser by the end-to-end suite. 20 sits between two
60
+ proven majors. Angular 22 is not in the range yet: it joins when it is driven the same way,
61
+ not before — a peer range is a promise, and this one only promises what has been run.
59
62
 
60
63
  > ESM-only. See the docs for the full API. Part of the aparté monorepo.