@exhaustive-ui/mcp 22.0.0-rc.2 → 22.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.
Files changed (62) hide show
  1. package/data/components/accordion.md +1 -0
  2. package/data/components/autocomplete.md +59 -0
  3. package/data/components/cascadeselect.md +136 -0
  4. package/data/components/checkbox.md +56 -0
  5. package/data/components/colorpicker.md +49 -0
  6. package/data/components/confirmpopup.md +0 -7
  7. package/data/components/dataview.md +0 -2
  8. package/data/components/datepicker.md +52 -3
  9. package/data/components/drawer.md +1 -1
  10. package/data/components/editor.md +49 -0
  11. package/data/components/floatlabel.md +72 -0
  12. package/data/components/iftalabel.md +68 -0
  13. package/data/components/inputmask.md +54 -4
  14. package/data/components/inputnumber.md +52 -3
  15. package/data/components/inputotp.md +50 -0
  16. package/data/components/inputtext.md +63 -1
  17. package/data/components/knob.md +55 -0
  18. package/data/components/listbox.md +57 -2
  19. package/data/components/message.md +0 -1
  20. package/data/components/multiselect.md +59 -4
  21. package/data/components/orderlist.md +1 -3
  22. package/data/components/password.md +52 -3
  23. package/data/components/picklist.md +0 -3
  24. package/data/components/radiobutton.md +60 -0
  25. package/data/components/rating.md +49 -0
  26. package/data/components/select.md +58 -3
  27. package/data/components/selectbutton.md +50 -1
  28. package/data/components/slider.md +50 -0
  29. package/data/components/stepper.md +0 -1
  30. package/data/components/table.md +1 -1
  31. package/data/components/textarea.md +48 -0
  32. package/data/components/togglebutton.md +50 -0
  33. package/data/components/toggleswitch.md +49 -0
  34. package/data/components/tooltip.md +0 -1
  35. package/data/components/treeselect.md +61 -1
  36. package/data/components/treetable.md +1 -1
  37. package/data/components.json +774 -503
  38. package/data/llms-full.txt +3494 -819
  39. package/data/llms.txt +2 -1
  40. package/data/manifest.json +91 -476
  41. package/data/pages/accessibility.md +164 -6
  42. package/data/pages/animations.md +110 -5
  43. package/data/pages/configuration.md +107 -102
  44. package/data/pages/contribution.md +68 -7
  45. package/data/pages/customicons.md +8 -8
  46. package/data/pages/faq.md +103 -8
  47. package/data/pages/icons.md +24 -23
  48. package/data/pages/installation.md +77 -25
  49. package/data/pages/llms.md +71 -15
  50. package/data/pages/passthrough.md +96 -7
  51. package/data/pages/philosophy.md +80 -11
  52. package/data/pages/primeflex.md +41 -4
  53. package/data/pages/rtl.md +4 -1
  54. package/data/pages/styled.md +174 -66
  55. package/data/pages/tailwind.md +309 -218
  56. package/data/pages/unstyled.md +48 -7
  57. package/data/pages/update.md +42 -13
  58. package/data/pages/v22.md +218 -0
  59. package/data/snapshot.json +4 -4
  60. package/dist/index.mjs +72 -22
  61. package/dist/index.mjs.map +1 -1
  62. package/package.json +1 -1
@@ -1,34 +1,63 @@
1
1
  # Update ExhaustiveUI
2
2
 
3
- Updating with ng update, Angular version compatibility, and what changes in v22 (Signals API, OnPush, automated migrations).
3
+ Updating with ng update, Angular version compatibility, and a summary of what changes in v22.
4
4
 
5
- ## Major-versions
5
+ ## Overview
6
+
7
+ All `@exhaustive-ui/core` packages — the components, themes, locale definitions, Tailwind CSS plugin and their internal dependencies — are versioned and released together, so an update always moves the whole suite to a single
8
+ new version. ExhaustiveUI supports `ng update`, the Angular CLI's own update mechanism, which bumps every installed ExhaustiveUI package in one step and runs any automated code migrations shipped with the new version.
9
+
10
+ Major versions follow Angular's: when a new Angular major ships, a matching ExhaustiveUI major is released for it. Minor and patch releases stay within the same Angular major and are drop-in updates.
11
+
12
+ This page is about updating a project that already uses ExhaustiveUI. To move an existing PrimeNG workspace across, see the
13
+ [migration guide](https://v1.optimus.openng.org/migration/primeng) instead.
14
+
15
+ ## Updating
6
16
 
7
- Each ExhaustiveUI major targets a single Angular major. To move to a new major, update Angular first — the Angular update guide covers that step — then update ExhaustiveUI to the matching major by passing the target version. For example, once Angular v23 and ExhaustiveUI v23 are out, from v22: Review the release notes of the target version for breaking changes before you start.
17
+ Run `ng update` without arguments at any time to list the updates available in your workspace, ExhaustiveUI included.
8
18
 
9
19
  ```bash
10
- ng update @angular/core@23 @angular/cli@23
11
- ng update @exhaustive-ui/core@23
20
+ ng update
12
21
  ```
13
22
 
14
- ## Ng-update
23
+ To update within the current major, pass the main package. The Angular CLI resolves the rest: `@exhaustive-ui/core` declares all its companion packages as a group, so every installed `@exhaustive-ui/*` package —
24
+ themes, locale, Tailwind CSS plugin and the internal runtime packages — is updated together and the suite cannot end up on mixed versions.
15
25
 
16
- Run ng update without arguments at any time to list the updates available in your workspace, ExhaustiveUI included. To update within the current major, pass the main package. The Angular CLI resolves the rest: @exhaustive-ui/core declares all its companion packages as a group, so every installed @exhaustive-ui/* package — themes, locale, Tailwind CSS plugin and the internal runtime packages — is updated together and the suite cannot end up on mixed versions. Like any ng update run, the command expects a clean git working tree so its changes can be reviewed or reverted in isolation — commit or stash your work first.
26
+ ```bash
27
+ ng update @exhaustive-ui/core
28
+ ```
17
29
 
18
- ## Overview
30
+ Like any `ng update` run, the command expects a clean git working tree so its changes can be reviewed or reverted in isolation — commit or stash your work first.
19
31
 
20
- All @exhaustive-ui/core packages — the components, themes, locale definitions, Tailwind CSS plugin and their internal dependencies — are versioned and released together, so an update always moves the whole suite to a single new version. ExhaustiveUI supports ng update , the Angular CLI's own update mechanism, which bumps every installed ExhaustiveUI package in one step and runs any automated code migrations shipped with the new version. Major versions follow Angular's: when a new Angular major ships, a matching ExhaustiveUI major is released for it. Minor and patch releases stay within the same Angular major and are drop-in updates. This page is about updating a project that already uses ExhaustiveUI. To move an existing PrimeNG workspace across, see the migration guide instead.
32
+ ## Angular Version Compatibility
21
33
 
22
- ## Release-notes
34
+ Each ExhaustiveUI major targets a single Angular major.
23
35
 
24
- Every version is published with its notes on the GitHub releases page , covering new features, fixes and any breaking changes or manual steps a release requires. Check the notes for the target version before a major update.
36
+ To move to a new major, update Angular first — the [Angular update guide](https://angular.dev/update-guide) covers that step — then update ExhaustiveUI to the matching major by
37
+ passing the target version. For example, once Angular v23 and ExhaustiveUI v23 are out, from v22:
25
38
 
26
- ## V22
39
+ ```bash
40
+ ng update @angular/core@23 @angular/cli@23
41
+ ng update @exhaustive-ui/core@23
42
+ ```
43
+
44
+ Review the release notes of the target version for breaking changes before you start.
27
45
 
28
- ExhaustiveUI v22 is the first major of the fork. It requires Angular v22 and moves the whole library to the Angular Signals API. Templates keep working as before: inputs are still bound with [name] , two-way bindings with [(name)] , and outputs with (name) . What changes is code that reaches into a component instance. Inputs are signal inputs: read them as component.name() rather than component.name , and set them through a template binding rather than by assignment. Two-way properties such as visible , value or selection are model() signals; call .set() on them from code. Template and child queries are signal queries ( contentChild() , viewChild() , ...), read with a call as well. Components use OnPush change detection, except Table, TreeTable and DynamicDialog. State shared with them should be passed through inputs or signals rather than mutated in place. Templates use the built-in @if / @for control flow, and option lists, menus and paginators track rows by position, so replacing the model no longer recreates every row. Run the update with ng update ; it applies the automated migrations shipped with v22 to your templates and code: styleclass-to-class : styleClass becomes the native class attribute on the components that dropped the input. renamed-inputs : deprecated aliases are renamed to their replacement, e.g. showCloseIcon to closable on Drawer, minLength to minQueryLength on AutoComplete, virtualRowHeight to virtualScrollItemSize on TreeTable. remove-dead-inputs and remove-dead-outputs : bindings of inputs and outputs that already had no effect are removed. config-overlay-options-signal : overlayOptions on the global configuration is a signal; assignments become .set() and reads become calls. Each migration prints the files it changed and the places it left for you to review, with file and line numbers. A workspace that has just switched to ExhaustiveUI, from PrimeNG with the migrate-from-primeng schematic or from Optimus UI, did not go through ng update . Run the migrations explicitly:
46
+ ## Updating to v22
47
+
48
+ ExhaustiveUI v22 is the first major of the fork. It requires Angular 22 and moves the whole library to the Angular Signals API. Templates keep working as before; code that reaches into a component instance reads inputs with a call and
49
+ writes two-way properties with `.set()`, and components use OnPush change detection. `ng update` applies nine migrations to templates and code and reports what it left for review.
29
50
 
30
51
  ```bash
31
52
  ng update @angular/core@22 @angular/cli@22
32
53
  ng update @exhaustive-ui/core@22
33
54
  ```
34
55
 
56
+ The [migration guide to v22](https://exhaustive-ui.com/migration/v22) covers the update steps from an ExhaustiveUI prerelease, PrimeNG v21 or Optimus UI, each migration and its report, the code changes, and the behavior
57
+ and type changes.
58
+
59
+ ## Release Notes
60
+
61
+ Every version is published with its notes on the [GitHub releases page](https://github.com/e-xiste/exhaustive-ui/releases), covering new features, fixes and any breaking changes or
62
+ manual steps a release requires. Check the notes for the target version before a major update.
63
+
@@ -0,0 +1,218 @@
1
+ # Migrating to v22
2
+
3
+ Moving an application to ExhaustiveUI v22: update steps from an ExhaustiveUI prerelease, PrimeNG v21 or Optimus UI, the automated migrations and their report, the Signals API, OnPush, removed API, behavior and type changes.
4
+
5
+ ## Overview
6
+
7
+ ExhaustiveUI v22 requires Angular 22 and moves every component and directive to the Angular Signals API. Templates bind as before: `[name]`, `[(name)]` and `(name)` keep working. Most of the work is done by
8
+ `ng update`. What is left is code that reaches into a component instance, data mutated in place under OnPush components, and the few places the migrations report.
9
+
10
+ This guide covers three starting points:
11
+
12
+ - **A v22 alpha or release candidate** of ExhaustiveUI: update to 22.0.0 with `ng update`, which runs the migrations. They leave code that is already migrated as it is, so running them again is safe.
13
+ - **PrimeNG v21**: switch to ExhaustiveUI with the `migrate-from-primeng` schematic, then run the v22 migrations explicitly.
14
+ - **Optimus UI v2**, which shares the PrimeNG v21 API: swap the packages and imports, then run the v22 migrations explicitly.
15
+
16
+ Updating later within v22, or to a future major, is covered by the [update guide](https://exhaustive-ui.com/migration/update). Every breaking change below is also listed in the
17
+ [changelog](https://github.com/e-xiste/exhaustive-ui/blob/main/CHANGELOG.md).
18
+
19
+ ## Before you start
20
+
21
+ - **Angular 22.** The peer dependencies are `^22.0.0`. Update Angular first with the [Angular update guide](https://angular.dev/update-guide), and use the Node.js and TypeScript versions it requires.
22
+ - **A clean git working tree.** Commit or stash your work, so the changes made by the migrations can be reviewed, and reverted, on their own.
23
+ - **A build and test run that passes** before you start, so anything that breaks afterwards comes from the update.
24
+ - **PrimeFlex**, if the project uses it: it is not part of the update. The `migrate-from-primeflex` schematic translates its classes to Tailwind CSS, as a separate step.
25
+
26
+ ## Update steps
27
+
28
+ ### From an ExhaustiveUI alpha or release candidate
29
+
30
+ Update Angular, then ExhaustiveUI. Every installed `@exhaustive-ui/*` package moves to 22.0.0 together, and the migrations run.
31
+
32
+ ```bash
33
+ ng update @angular/core@22 @angular/cli@22
34
+ ng update @exhaustive-ui/core@22
35
+ ```
36
+
37
+ ### From PrimeNG v21
38
+
39
+ Update Angular to 22, install ExhaustiveUI and run the `migrate-from-primeng` schematic. It swaps the `primeng`, `@primeuix/*` and PrimeIcons dependencies, rewrites the imports (`primeng/button` becomes
40
+ `@exhaustive-ui/core/button`) and renames the configuration API (`providePrimeNG` becomes `provideExhaustive`). The workspace did not go through `ng update`, so run the v22 migrations explicitly afterwards.
41
+
42
+ ```bash
43
+ ng update @angular/core@22 @angular/cli@22
44
+ npm install @exhaustive-ui/core@22
45
+ ng generate @exhaustive-ui/core:migrate-from-primeng
46
+ ng update @exhaustive-ui/core --migrate-only --from=3.0.0
47
+ ```
48
+
49
+ Projects on PrimeNG v20 or older upgrade to PrimeNG v21 first; the schematic checks the version and refuses otherwise.
50
+
51
+ ### From Optimus UI v2
52
+
53
+ Optimus UI v2 has the PrimeNG v21 API under other package names. Replace its packages with their `@exhaustive-ui/*` counterparts (`@exhaustive-ui/core`, `@exhaustive-ui/themes`...), update the import paths
54
+ to match, then run the v22 migrations explicitly.
55
+
56
+ ```bash
57
+ ng update @exhaustive-ui/core --migrate-only --from=3.0.0
58
+ ```
59
+
60
+ ### Then
61
+
62
+ 1. Read the report the migrations printed, see `Reviewing the report` below.
63
+ 2. Fix the TypeScript errors: most come from the Signals API and the removed TypeScript API.
64
+ 3. Check the screens that mutate data bound to a component, which no longer refresh under OnPush.
65
+ 4. Read the behavior changes, then build and run your tests.
66
+
67
+ ## Automated migrations
68
+
69
+ `ng update` applies nine migrations to the templates (inline and external) and the TypeScript code of every project in the workspace. Each one only touches the ExhaustiveUI elements and APIs it knows, and reports what it cannot
70
+ rewrite safely.
71
+
72
+ - **styleclass-to-class**: `styleClass`/`[styleClass]` becomes `class`/`[class]` on the ~60 components whose deprecated `styleClass` input was removed, such as Tag, Card, Select, Table, DatePicker, Panel, AvatarGroup and InputGroupAddon.
73
+ - **renamed-inputs**: Drawer `showCloseIcon` becomes `closable` and `ariaCloseLabel` becomes `closeAriaLabel`; Paginator `dropdownAppendTo` becomes `appendTo`; Password `maxLength` becomes `maxlength`; AutoComplete `minLength` becomes `minQueryLength`; TreeSelect `containerStyleClass`/`containerStyle` become `class`/`style`; TreeTable `virtualRowHeight` becomes `virtualScrollItemSize`; Listbox and MultiSelect `filterPlaceHolder` becomes `filterPlaceholder`; ImageCompare `ariaLabelledby` becomes `ariaLabelledBy`; Dialog `[content]`, which set the header template, becomes `[headerTemplate]`; the `pt*` pass-through aliases of pButton, pButtonLabel, pButtonIcon, pBadge, pInputText and pTooltip become `pButtonPT`, `pButtonLabelPT`, `pButtonIconPT`, `pBadgePT`, `pInputTextPT` and `pTooltipPT`; pBadge `size` on a plain element becomes `badgeSize`.
74
+ - **renamed-outputs**: OrderList `onFilterEvent` becomes `onFilter`; Table `selectAllChange` becomes `onSelectAllChange`; MultiSelect `onPanelShow`/`onPanelHide` become `onShow`/`onHide`. The payloads are unchanged, so handlers reading `$event` keep working.
75
+ - **renamed-templates**: the MultiSelect `removetokenicon` template becomes `chipicon`, with the same context.
76
+ - **remove-dead-inputs**: removes the bindings of about eighty inputs that had already stopped doing anything, such as the `*TransitionOptions` inputs (replaced by `motionOptions`), `autoZIndex`/`baseZIndex` on sub menus, Table `frozenColumns`/`frozenWidth`, the ConfirmDialog aria labels and the `trackBy` inputs of DataView, OrderList and PickList.
77
+ - **remove-dead-outputs**: removes Overlay `onAnimationStart`/`onAnimationDone` and MenubarSub `menuFocus`/`menuBlur`/`menuKeydown`.
78
+ - **config-overlay-options-signal**: `Exhaustive.overlayOptions` is a signal. Assignments become `.set()` and reads become calls.
79
+ - **config-input-style-to-variant**: the global `inputStyle` option becomes `inputVariant` (same values), in `provideExhaustive()`/`setConfig()` objects and on the `Exhaustive` service.
80
+ - **removed-exports**: `Password_VALUE_ACCESSOR` becomes `PASSWORD_VALUE_ACCESSOR`; the removed `InplaceDisplay`/`InplaceContent` wrappers are dropped from imports and their elements become `<span>`.
81
+
82
+ ## Reviewing the report
83
+
84
+ Each migration prints the files it changed, then the places it left for you, with the file and line. These are the cases it reports and what to do with them.
85
+
86
+ - **Programmatic access to a removed or renamed name**, such as `drawer.showCloseIcon = true` or `table.selectAllChange.subscribe(...)`: use the new name, and the Signals API described below.
87
+ - **A tag that binds both the old and the new name**: keep the new one and delete the old one, after checking which value you meant.
88
+ - **A Table `[(selectAll)]` two-way binding**, which relied on the renamed `selectAllChange`: bind `[selectAll]="selectAll"` and `(onSelectAllChange)="selectAll = $event.checked"`.
89
+ - **A MultiSelect that already projects a `chipicon` template** next to `removetokenicon`: keep one of them.
90
+ - **A configuration object that sets both `inputStyle` and `inputVariant` , or a receiver the migration cannot prove to be the `Exhaustive` service: set `inputVariant` only.
91
+ - Imports of rendering internals that are no longer exported**: the `SelectItem` option component of Select (the `SelectItem` interface of `@exhaustive-ui/core/api` is unchanged), Menu's `SafeHtmlPipe`, `MapperPipe`, `RadioControlRegistry` and `MenubarService`. Remove the import; the components no longer need them from you.
92
+
93
+ Coding agents can check the result with the `validate_usage` tool of the `@exhaustive-ui/mcp` server, which names the replacement of every input removed or renamed in v22, and follow its `update_to_v22` prompt.
94
+
95
+ ## Code using a component instance
96
+
97
+ Every input is an `input()`, every two-way property a `model()`, every output an `output()` and every query a signal query. No `@Input`, `@Output`, `@ViewChild` or
98
+ `@ContentChild` decorator is left. Templates are not affected, and the migrations do not rewrite this kind of code: the compiler points at each place.
99
+
100
+ - Read an input by calling it: `table.first()`, not `table.first`.
101
+ - Inputs can no longer be assigned from code. Bind them in the template to a field or a signal of your component, and change that instead.
102
+ - Two-way properties are `model()` signals: write them with `.set()`, as in `drawer.visible.set(true)`. The value and change-event pairs became models, for example `first`, `rows` and `selection` on Table and TreeTable, and `visible` on Dialog, Drawer and Galleria. `[(x)]` bindings keep working.
103
+ - Outputs are `OutputEmitterRef`s: `.subscribe()` still works, `.pipe()` and the other `EventEmitter` members do not. Use `outputToObservable()` when you need an observable.
104
+ - Public child references of a component are signal queries too, and are read with a call.
105
+ - The global configuration is a set of signals on the `Exhaustive` service: `config.ripple.set(true)`, `config.inputVariant()`.
106
+
107
+ ```typescript
108
+ // Before
109
+ @ViewChild(Table) table!: Table;
110
+ @ViewChild(Drawer) drawer!: Drawer;
111
+
112
+ reset() {
113
+ const first = this.table.first;
114
+ this.table.selection = [];
115
+ this.drawer.visible = false;
116
+ this.config.ripple = true;
117
+ }
118
+
119
+ // After
120
+ table = viewChild.required(Table);
121
+ drawer = viewChild.required(Drawer);
122
+
123
+ reset() {
124
+ const first = this.table().first();
125
+ this.table().selection.set([]);
126
+ this.drawer().visible.set(false);
127
+ this.config.ripple.set(true);
128
+ }
129
+ ```
130
+
131
+ ## OnPush change detection
132
+
133
+ Every component uses `OnPush` change detection, except Table, TreeTable and DynamicDialog, which stay Eager on purpose because they render objects that applications commonly mutate in place. An OnPush component refreshes when one
134
+ of its inputs gets a new value, when it handles an event, or when a signal it reads changes. It does not see a change made inside an array or an object it already holds.
135
+
136
+ The symptom is a component that does not update: options added with `push()` that do not appear in a Select, a Tree node renamed in place, a chart that keeps its old data. Give the component a new array or object, or keep the
137
+ data in a signal.
138
+
139
+ ```typescript
140
+ // Before: the Select does not show the new option under OnPush
141
+ this.cities.push({ name: 'Paris', code: 'PRS' });
142
+
143
+ // After: a new array
144
+ this.cities = [...this.cities, { name: 'Paris', code: 'PRS' }];
145
+
146
+ // Or a signal, bound with [options]="cities()"
147
+ cities = signal<City[]>([]);
148
+ this.cities.update((cities) => [...cities, { name: 'Paris', code: 'PRS' }]);
149
+ ```
150
+
151
+ Templates use the built-in `@if`, `@for` and `@switch` control flow, and option lists, menus, Paginator and DatePicker reuse their rows when the data is replaced instead of recreating them. Replacing the
152
+ array is therefore cheap, and no NG0955 or NG0956 warning comes from the library.
153
+
154
+ ## Removed TypeScript API
155
+
156
+ These removals have no migration: they only appear in TypeScript code, and the compiler points at each use.
157
+
158
+ - `OverlayOptions.showTransitionOptions`/`hideTransitionOptions` and `DynamicDialogConfig.rtl`/`transitionOptions`: nothing read them. Use `motionOptions`.
159
+ - `@exhaustive-ui/utils`: `classNames` becomes `cn`, `createStyleAsString` becomes `createStyleMarkup`, `createStyleTag` becomes `createStyleElement`, `mergeKeys` becomes `deepMerge`.
160
+ - `@exhaustive-ui/styled`: `getDirective` on the theme service becomes `getComponent`.
161
+ - Sub components that render the inside of a component (`ContextMenuSub`, `TieredMenuSub`, `MenuItemContent`, `MultiSelectItem`, `ToastItem`, `TableBody`, `TTBody`, `UITreeNode`, the Galleria parts...), `PARENT_INSTANCE` and the pre-signals helpers of `@exhaustive-ui/core/utils` are still exported in v22 but tagged `@internal`. They are not public API and can change in a minor release.
162
+
163
+ ## Behavior changes
164
+
165
+ These changes compile without error but can change what users see, or what a test asserts. Most come from fixes of bugs inherited from PrimeNG and Optimus UI. The issue numbers in the changelog are Optimus UI's.
166
+
167
+ ### Forms
168
+
169
+ - InputText: when `[invalid]` is bound, it alone decides the invalid style; the automatic `ng-invalid ng-dirty` border no longer applies on top of it.
170
+ - InputNumber: a keystroke that would make the formatted value longer than `maxlength` is rejected instead of truncating the text. The native `min`/`max` attributes are gone; the bounds stay in `aria-valuemin`/`aria-valuemax`.
171
+ - Select: a Select inside a disabled `<fieldset>` is disabled, except inside the fieldset's first `<legend>`, as for native controls.
172
+ - Select, MultiSelect and CascadeSelect use the SVG spinner of Button as their default loading icon, instead of the `pi-spin` icon class.
173
+ - PickList: moving items sets `source` and `target` to new arrays and emits `sourceChange`/`targetChange`, so `[(source)]`/`[(target)]` bindings follow.
174
+ - TreeTable: the selection change can fire once per intermediate step while a checkbox propagates.
175
+ - DatePicker: the `data-date` attribute of day cells uses a 1-based month.
176
+ - AutoFocus: the native `autofocus` attribute is only rendered when autofocus is on; Button and the other components no longer carry it by default.
177
+
178
+ ### Overlays and menus
179
+
180
+ - Overlays are placed against the viewport without its scrollbars, so an overlay at the right edge no longer goes under the vertical scrollbar.
181
+ - Tooltip honours the global `overlayAppendTo` option.
182
+ - TieredMenu: with `autoDisplay`, submenus open on hover from the start, without a first click. A popup TieredMenu gives the focus back to its trigger when an item is picked.
183
+ - ContextMenu: showing a context menu closes any other one that is open.
184
+ - ConfirmPopup: an `accepticon`/`rejecticon` template replaces the `acceptIcon`/`rejectIcon` class instead of rendering next to it, as in ConfirmDialog.
185
+
186
+ ### Accessibility markup
187
+
188
+ - Stepper: the `tablist` role is on `p-step-list`. Splitter: the `separator` role is on the focusable gutter handle.
189
+ - FocusTrap sentinels are no longer `aria-hidden`. ConfirmDialog no longer puts a `role` on the `p-dialog` host.
190
+ - Table announces keyboard column and row moves through the new `aria.columnMoved` and `aria.rowMoved` translation keys. A custom `aria` translation without them falls back to English.
191
+
192
+ ### Theming and display
193
+
194
+ - A token overridden under `colorScheme.light` wins over the preset's top-level token, as it already did in dark mode. A top-level override passed to `definePreset`, `updatePreset` or `usePreset` still wins.
195
+ - MeterGroup: meter widths use the exact percentage; labels keep the rounded value.
196
+ - ToggleSwitch has no `size` input any more: it had no effect.
197
+
198
+ ## Type changes
199
+
200
+ Some types now describe what the components actually emit or accept. Code that relied on the old types may need a cast or a narrower check.
201
+
202
+ - Table `onFilter`: `filters` is typed `FilterMetadata | FilterMetadata[]`.
203
+ - TreeTable `TreeTableLazyLoadEvent`: `first` is a `number` and `last` an optional `number`, as in `TableLazyLoadEvent`.
204
+ - CascadeSelect: `options` is typed as an array, and the value accepts an object.
205
+ - Dialog and ConfirmDialog: `pt.root` is typed as the options of the root element.
206
+ - Chart `onDataSelect` emits the new exported `ChartDataSelectEvent` type.
207
+ - `Confirmation` accepts `draggable`, and DatePicker `hourFormat` also accepts a number.
208
+
209
+ ## Checklist
210
+
211
+ - Angular 22 installed, and `ng update` (or `--migrate-only --from=3.0.0`) run on a clean working tree.
212
+ - Every place listed in the migration report handled.
213
+ - The project compiles: inputs are read with a call, two-way properties written with `.set()`, removed TypeScript API replaced.
214
+ - No `styleClass`, removed input or `pt*` alias left in templates: `validate_usage` of the MCP server can check this.
215
+ - Screens that change data bound to a component show the change: new arrays and objects, or signals, rather than in-place mutation.
216
+ - Behavior changes reviewed against your tests and screenshots.
217
+ - Signal Forms, if you adopt them: a required field shows as invalid before any interaction, because `[invalid]` cannot be bound next to `[formField]`. A fix is planned in a v22 minor release.
218
+
@@ -1,9 +1,9 @@
1
1
  {
2
- "generatedAt": "2026-11-21T17:03:06.979Z",
3
- "libraryVersion": "22.0.0-rc.2",
4
- "docsGeneratedAt": "2026-11-21",
2
+ "generatedAt": "2026-11-22T10:53:49.910Z",
3
+ "libraryVersion": "22.0.0",
4
+ "docsGeneratedAt": "2026-11-22",
5
5
  "components": 96,
6
- "guides": 17,
6
+ "guides": 18,
7
7
  "source": "local",
8
8
  "origin": "../../apps/docs/public/llms"
9
9
  }
package/dist/index.mjs CHANGED
@@ -1069,13 +1069,14 @@ function literalOfBinding(value) {
1069
1069
  /**
1070
1070
  * Inputs and outputs removed or renamed in ExhaustiveUI v22, keyed by component tag (`p-` prefix,
1071
1071
  * case and hyphens ignored). Mirrors the `ng update` migrations of @exhaustive-ui/core
1072
- * (styleclass-to-class, renamed-inputs, remove-dead-inputs, remove-dead-outputs) so that
1072
+ * (styleclass-to-class, renamed-inputs, renamed-outputs, remove-dead-inputs, remove-dead-outputs) so that
1073
1073
  * validate_usage can name the replacement instead of only reporting an unknown binding.
1074
1074
  */
1075
1075
  const STYLE_CLASS_REMOVED = [
1076
1076
  "accordion",
1077
1077
  "autocomplete",
1078
1078
  "avatar",
1079
+ "avatargroup",
1079
1080
  "badge",
1080
1081
  "blockui",
1081
1082
  "card",
@@ -1093,6 +1094,7 @@ const STYLE_CLASS_REMOVED = [
1093
1094
  "image",
1094
1095
  "inplace",
1095
1096
  "inputgroup",
1097
+ "inputgroupaddon",
1096
1098
  "inputicon",
1097
1099
  "inputnumber",
1098
1100
  "knob",
@@ -1129,14 +1131,27 @@ const STYLE_CLASS_REMOVED = [
1129
1131
  "treetable"
1130
1132
  ];
1131
1133
  const RENAMED = {
1132
- drawer: { showcloseicon: "closable" },
1134
+ drawer: {
1135
+ showcloseicon: "closable",
1136
+ ariacloselabel: "closeAriaLabel"
1137
+ },
1133
1138
  paginator: { dropdownappendto: "appendTo" },
1139
+ dialog: { content: "headerTemplate" },
1134
1140
  autocomplete: { minlength: "minQueryLength" },
1135
1141
  treeselect: {
1136
1142
  containerstyleclass: "class",
1137
1143
  containerstyle: "style"
1138
1144
  },
1139
- treetable: { virtualrowheight: "virtualScrollItemSize" }
1145
+ treetable: { virtualrowheight: "virtualScrollItemSize" },
1146
+ pbutton: { ptbuttondirective: "pButtonPT" },
1147
+ pbuttonlabel: { ptbuttonlabel: "pButtonLabelPT" },
1148
+ pbuttonicon: { ptbuttonicon: "pButtonIconPT" },
1149
+ pbadge: {
1150
+ ptbadgedirective: "pBadgePT",
1151
+ size: "badgeSize"
1152
+ },
1153
+ pinputtext: { ptinputtext: "pInputTextPT" },
1154
+ ptooltip: { pttooltip: "pTooltipPT" }
1140
1155
  };
1141
1156
  const DEAD_INPUTS = {
1142
1157
  toast: [
@@ -1159,7 +1174,6 @@ const DEAD_INPUTS = {
1159
1174
  panel: ["transitionOptions"],
1160
1175
  accordion: ["transitionOptions"],
1161
1176
  scrolltop: ["showTransitionOptions", "hideTransitionOptions"],
1162
- confirmpopup: ["showTransitionOptions", "hideTransitionOptions"],
1163
1177
  togglebutton: ["inputId"],
1164
1178
  popover: [
1165
1179
  "showTransitionOptions",
@@ -1227,9 +1241,35 @@ const DEAD_INPUTS = {
1227
1241
  "autoZIndex",
1228
1242
  "baseZIndex",
1229
1243
  "showTransitionOptions",
1230
- "hideTransitionOptions"
1244
+ "hideTransitionOptions",
1245
+ "autoHighlight"
1246
+ ],
1247
+ multiselect: ["filterFields"],
1248
+ stepper: ["transitionOptions"],
1249
+ listbox: ["searchLocale"],
1250
+ dataview: ["gridStyleClass", "trackBy"],
1251
+ orderlist: ["trackBy", "header"],
1252
+ picklist: [
1253
+ "trackBy",
1254
+ "sourceTrackBy",
1255
+ "targetTrackBy"
1256
+ ],
1257
+ toggleswitch: ["size"],
1258
+ selectbutton: ["tabindex"],
1259
+ confirmpopup: [
1260
+ "showTransitionOptions",
1261
+ "hideTransitionOptions",
1262
+ "baseZIndex"
1231
1263
  ],
1232
- multiselect: ["filterFields"]
1264
+ treetablesorticon: ["ariaLabelAsc", "ariaLabelDesc"]
1265
+ };
1266
+ const RENAMED_OUTPUTS = {
1267
+ orderlist: { onFilterEvent: "onFilter" },
1268
+ table: { selectAllChange: "onSelectAllChange" },
1269
+ multiselect: {
1270
+ onPanelShow: "onShow",
1271
+ onPanelHide: "onHide"
1272
+ }
1233
1273
  };
1234
1274
  const DEAD_OUTPUTS = {
1235
1275
  overlay: ["onAnimationStart", "onAnimationDone"],
@@ -1245,7 +1285,10 @@ function tagKey(tag) {
1245
1285
  function has(list, name) {
1246
1286
  return !!list?.some((entry) => entry.toLowerCase() === name.toLowerCase());
1247
1287
  }
1248
- /** Replacement guidance for an input that no longer exists on `tag`, or undefined when it was not removed in v22. */
1288
+ /**
1289
+ * Replacement guidance for an input that no longer exists on `tag` (an element name, or an attribute
1290
+ * directive selector such as `[pTooltip]`), or undefined when it was not removed in v22.
1291
+ */
1249
1292
  function removedInputHint(tag, name) {
1250
1293
  const key = tagKey(tag);
1251
1294
  const lower = name.toLowerCase();
@@ -1263,6 +1306,11 @@ function removedInputHint(tag, name) {
1263
1306
  /** Replacement guidance for an output that no longer exists on `tag`, or undefined when it was not removed in v22. */
1264
1307
  function removedOutputHint(tag, name) {
1265
1308
  const key = tagKey(tag);
1309
+ const renamed = RENAMED_OUTPUTS[key]?.[name];
1310
+ if (renamed) return {
1311
+ message: `${name} was renamed to ${renamed} in v22, with the same event payload (ng update applies the renamed-outputs migration).`,
1312
+ suggestion: renamed
1313
+ };
1266
1314
  if (!has(DEAD_OUTPUTS[key], name)) return;
1267
1315
  return { message: `${name} was removed in v22: ${key === "overlay" ? "use onOverlayBeforeEnter/onOverlayAfterEnter (show) or onOverlayBeforeLeave/onOverlayAfterLeave (hide) instead" : "it never fired, bind the native focus/blur/keydown events of the element instead"} (ng update applies the remove-dead-outputs migration).` };
1268
1316
  }
@@ -1487,6 +1535,8 @@ function checkElement(component, element, matches, isOwnElement) {
1487
1535
  }
1488
1536
  for (const output of ref.declaration.outputs ?? []) outputs.add(output.name);
1489
1537
  }
1538
+ const directiveAttributes = own.flatMap((declaration) => splitSelectors(declaration.selector).map(attributeSelectorName)).filter((attribute) => !!attribute && element.attributes.some((candidate) => candidate.name.toLowerCase() === attribute.toLowerCase()));
1539
+ const removedHint = (name) => isOwnElement ? removedInputHint(element.name, name) : directiveAttributes.map((attribute) => removedInputHint(`[${attribute}]`, name)).find(Boolean);
1490
1540
  const allowedProps = [...inputs.keys()].sort().join(", ");
1491
1541
  const allowedEvents = [...outputs].sort().join(", ");
1492
1542
  const supportsForms = own.some((declaration) => declaration.forms);
@@ -1499,8 +1549,8 @@ function checkElement(component, element, matches, isOwnElement) {
1499
1549
  if (everyInput.has(lowerName) && !inputs.has(lowerName)) break;
1500
1550
  const input = inputs.get(lowerName);
1501
1551
  if (!input) {
1502
- if (GLOBAL_ATTRIBUTES.has(lowerName) || lowerName.startsWith("aria-") || lowerName.startsWith("data-") || lowerName.startsWith("ng") || !isOwnElement && NATIVE_ATTRIBUTES.has(lowerName)) break;
1503
- const removed = isOwnElement ? removedInputHint(element.name, attribute.name) : void 0;
1552
+ const removed = removedHint(attribute.name);
1553
+ if (!removed && (GLOBAL_ATTRIBUTES.has(lowerName) || lowerName.startsWith("aria-") || lowerName.startsWith("data-") || lowerName.startsWith("ng") || !isOwnElement && NATIVE_ATTRIBUTES.has(lowerName))) break;
1504
1554
  issues.push({
1505
1555
  kind: "unknown-prop",
1506
1556
  severity: "error",
@@ -1527,20 +1577,20 @@ function checkElement(component, element, matches, isOwnElement) {
1527
1577
  });
1528
1578
  break;
1529
1579
  }
1530
- case "event":
1580
+ case "event": {
1531
1581
  if (outputs.has(attribute.name)) break;
1532
1582
  if (inputs.get(lowerName.replace(/change$/, ""))?.twoWay && /change$/i.test(attribute.name)) break;
1533
- if (/^on[A-Z]/.test(attribute.name)) {
1534
- const removed = isOwnElement ? removedOutputHint(element.name, attribute.name) : void 0;
1535
- issues.push({
1536
- kind: "unknown-output",
1537
- severity: "error",
1538
- name: attribute.name,
1539
- message: `"${attribute.name}" is not an output of ${label}.${removed ? ` ${removed.message}` : ""}`,
1540
- allowedEvents
1541
- });
1542
- }
1583
+ const removed = isOwnElement ? removedOutputHint(element.name, attribute.name) : void 0;
1584
+ if (removed || /^on[A-Z]/.test(attribute.name)) issues.push({
1585
+ kind: "unknown-output",
1586
+ severity: "error",
1587
+ name: attribute.name,
1588
+ message: `"${attribute.name}" is not an output of ${label}.${removed ? ` ${removed.message}` : ""}`,
1589
+ allowedEvents,
1590
+ ...removed?.suggestion ? { suggestion: removed.suggestion } : {}
1591
+ });
1543
1592
  break;
1593
+ }
1544
1594
  case "twoWay": {
1545
1595
  if (lowerName === "ngmodel") {
1546
1596
  if (isOwnElement && !supportsForms && !inputs.has("ngmodel")) issues.push({
@@ -2639,8 +2689,8 @@ const PROMPTS = {
2639
2689
  title: "Update to ExhaustiveUI v22",
2640
2690
  description: "Update an application to ExhaustiveUI v22 (Angular v22, Signals API) and fix what ng update leaves for review.",
2641
2691
  steps: [
2642
- "Call get_guide for \"update\" and read its v22 section.",
2643
- "Update Angular first (`ng update @angular/core@22 @angular/cli@22`), then run `ng update @exhaustive-ui/core@22`; its migrations rewrite styleClass to class, renamed inputs and bindings of removed inputs and outputs, and print what they left for review.",
2692
+ "Call get_guide for \"v22\" (the migration guide to v22) and follow its update steps for the starting point: an ExhaustiveUI prerelease, PrimeNG v21 or Optimus UI.",
2693
+ "Update Angular first (`ng update @angular/core@22 @angular/cli@22`), then run `ng update @exhaustive-ui/core@22`; its nine migrations rewrite styleClass to class, renamed inputs, outputs and templates, bindings of removed inputs and outputs, and the configuration API, and print what they left for review. Handle each reported place as the \"Reviewing the report\" section of the guide describes.",
2644
2694
  "In TypeScript code that holds a component instance (viewChild, ViewChild, injected component), read inputs as signals (`table.selection()`), write two-way properties with `.set()` (`drawer.visible.set(true)`), and call signal queries.",
2645
2695
  "Components are OnPush (except Table, TreeTable and DynamicDialog): pass new arrays or objects, or signals, instead of mutating data bound to them in place.",
2646
2696
  "Call validate_usage on each template that uses a `p-*` element: removed or renamed v22 inputs are reported with their replacement."