@anguless/angulux 22.0.0-rc.0 → 22.2.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 (182) hide show
  1. package/README.md +291 -0
  2. package/fesm2022/anguless-angulux-api.mjs +40 -82
  3. package/fesm2022/anguless-angulux-api.mjs.map +1 -1
  4. package/fesm2022/anguless-angulux-autofocus.mjs +7 -7
  5. package/fesm2022/anguless-angulux-avatar.mjs +10 -10
  6. package/fesm2022/anguless-angulux-avatargroup.mjs +10 -10
  7. package/fesm2022/anguless-angulux-badge.mjs +13 -13
  8. package/fesm2022/anguless-angulux-base.mjs +3 -3
  9. package/fesm2022/anguless-angulux-basecomponent.mjs +6 -6
  10. package/fesm2022/anguless-angulux-baseeditableholder.mjs +3 -3
  11. package/fesm2022/anguless-angulux-baseinput.mjs +3 -3
  12. package/fesm2022/anguless-angulux-basemodelholder.mjs +3 -3
  13. package/fesm2022/anguless-angulux-bind.mjs +7 -7
  14. package/fesm2022/anguless-angulux-button.mjs +43 -74
  15. package/fesm2022/anguless-angulux-button.mjs.map +1 -1
  16. package/fesm2022/anguless-angulux-card.mjs +42 -102
  17. package/fesm2022/anguless-angulux-card.mjs.map +1 -1
  18. package/fesm2022/anguless-angulux-chart.mjs +10 -10
  19. package/fesm2022/anguless-angulux-checkbox.mjs +18 -38
  20. package/fesm2022/anguless-angulux-checkbox.mjs.map +1 -1
  21. package/fesm2022/anguless-angulux-chip.mjs +20 -40
  22. package/fesm2022/anguless-angulux-chip.mjs.map +1 -1
  23. package/fesm2022/anguless-angulux-colorpicker.mjs +10 -10
  24. package/fesm2022/anguless-angulux-config.mjs +6 -6
  25. package/fesm2022/anguless-angulux-confirmdialog.mjs +52 -117
  26. package/fesm2022/anguless-angulux-confirmdialog.mjs.map +1 -1
  27. package/fesm2022/anguless-angulux-datepicker.mjs +104 -212
  28. package/fesm2022/anguless-angulux-datepicker.mjs.map +1 -1
  29. package/fesm2022/anguless-angulux-dialog.mjs +50 -114
  30. package/fesm2022/anguless-angulux-dialog.mjs.map +1 -1
  31. package/fesm2022/anguless-angulux-divider.mjs +10 -10
  32. package/fesm2022/anguless-angulux-dom.mjs +7 -0
  33. package/fesm2022/anguless-angulux-dom.mjs.map +1 -1
  34. package/fesm2022/anguless-angulux-drawer.mjs +34 -82
  35. package/fesm2022/anguless-angulux-drawer.mjs.map +1 -1
  36. package/fesm2022/anguless-angulux-fileupload.mjs +83 -159
  37. package/fesm2022/anguless-angulux-fileupload.mjs.map +1 -1
  38. package/fesm2022/anguless-angulux-fluid.mjs +10 -10
  39. package/fesm2022/anguless-angulux-focustrap.mjs +7 -7
  40. package/fesm2022/anguless-angulux-iconfield.mjs +10 -10
  41. package/fesm2022/anguless-angulux-icons-angledoubledown.mjs +3 -3
  42. package/fesm2022/anguless-angulux-icons-angledoubleleft.mjs +3 -3
  43. package/fesm2022/anguless-angulux-icons-angledoubleright.mjs +3 -3
  44. package/fesm2022/anguless-angulux-icons-angledoubleup.mjs +3 -3
  45. package/fesm2022/anguless-angulux-icons-angledown.mjs +3 -3
  46. package/fesm2022/anguless-angulux-icons-angleleft.mjs +3 -3
  47. package/fesm2022/anguless-angulux-icons-angleright.mjs +3 -3
  48. package/fesm2022/anguless-angulux-icons-angleup.mjs +3 -3
  49. package/fesm2022/anguless-angulux-icons-arrowdown.mjs +3 -3
  50. package/fesm2022/anguless-angulux-icons-arrowdownleft.mjs +3 -3
  51. package/fesm2022/anguless-angulux-icons-arrowdownright.mjs +3 -3
  52. package/fesm2022/anguless-angulux-icons-arrowleft.mjs +3 -3
  53. package/fesm2022/anguless-angulux-icons-arrowright.mjs +3 -3
  54. package/fesm2022/anguless-angulux-icons-arrowup.mjs +3 -3
  55. package/fesm2022/anguless-angulux-icons-ban.mjs +3 -3
  56. package/fesm2022/anguless-angulux-icons-bars.mjs +3 -3
  57. package/fesm2022/anguless-angulux-icons-baseicon.mjs +6 -6
  58. package/fesm2022/anguless-angulux-icons-blank.mjs +3 -3
  59. package/fesm2022/anguless-angulux-icons-calendar.mjs +3 -3
  60. package/fesm2022/anguless-angulux-icons-caretleft.mjs +3 -3
  61. package/fesm2022/anguless-angulux-icons-caretright.mjs +3 -3
  62. package/fesm2022/anguless-angulux-icons-check.mjs +3 -3
  63. package/fesm2022/anguless-angulux-icons-chevrondown.mjs +3 -3
  64. package/fesm2022/anguless-angulux-icons-chevronleft.mjs +3 -3
  65. package/fesm2022/anguless-angulux-icons-chevronright.mjs +3 -3
  66. package/fesm2022/anguless-angulux-icons-chevronup.mjs +3 -3
  67. package/fesm2022/anguless-angulux-icons-exclamationtriangle.mjs +3 -3
  68. package/fesm2022/anguless-angulux-icons-eye.mjs +3 -3
  69. package/fesm2022/anguless-angulux-icons-eyeslash.mjs +3 -3
  70. package/fesm2022/anguless-angulux-icons-filter.mjs +3 -3
  71. package/fesm2022/anguless-angulux-icons-filterfill.mjs +3 -3
  72. package/fesm2022/anguless-angulux-icons-filterslash.mjs +3 -3
  73. package/fesm2022/anguless-angulux-icons-home.mjs +3 -3
  74. package/fesm2022/anguless-angulux-icons-infocircle.mjs +3 -3
  75. package/fesm2022/anguless-angulux-icons-minus.mjs +3 -3
  76. package/fesm2022/anguless-angulux-icons-pencil.mjs +3 -3
  77. package/fesm2022/anguless-angulux-icons-plus.mjs +3 -3
  78. package/fesm2022/anguless-angulux-icons-refresh.mjs +3 -3
  79. package/fesm2022/anguless-angulux-icons-search.mjs +3 -3
  80. package/fesm2022/anguless-angulux-icons-searchminus.mjs +3 -3
  81. package/fesm2022/anguless-angulux-icons-searchplus.mjs +3 -3
  82. package/fesm2022/anguless-angulux-icons-sortalt.mjs +3 -3
  83. package/fesm2022/anguless-angulux-icons-sortamountdown.mjs +3 -3
  84. package/fesm2022/anguless-angulux-icons-sortamountupalt.mjs +3 -3
  85. package/fesm2022/anguless-angulux-icons-spinner.mjs +3 -3
  86. package/fesm2022/anguless-angulux-icons-star.mjs +3 -3
  87. package/fesm2022/anguless-angulux-icons-starfill.mjs +3 -3
  88. package/fesm2022/anguless-angulux-icons-thlarge.mjs +3 -3
  89. package/fesm2022/anguless-angulux-icons-times.mjs +3 -3
  90. package/fesm2022/anguless-angulux-icons-timescircle.mjs +3 -3
  91. package/fesm2022/anguless-angulux-icons-trash.mjs +3 -3
  92. package/fesm2022/anguless-angulux-icons-undo.mjs +3 -3
  93. package/fesm2022/anguless-angulux-icons-upload.mjs +3 -3
  94. package/fesm2022/anguless-angulux-icons-windowmaximize.mjs +3 -3
  95. package/fesm2022/anguless-angulux-icons-windowminimize.mjs +3 -3
  96. package/fesm2022/anguless-angulux-inputicon.mjs +10 -10
  97. package/fesm2022/anguless-angulux-inputnumber.mjs +38 -69
  98. package/fesm2022/anguless-angulux-inputnumber.mjs.map +1 -1
  99. package/fesm2022/anguless-angulux-inputtext.mjs +10 -10
  100. package/fesm2022/anguless-angulux-menu.mjs +44 -90
  101. package/fesm2022/anguless-angulux-menu.mjs.map +1 -1
  102. package/fesm2022/anguless-angulux-message.mjs +30 -61
  103. package/fesm2022/anguless-angulux-message.mjs.map +1 -1
  104. package/fesm2022/anguless-angulux-motion.mjs +13 -13
  105. package/fesm2022/anguless-angulux-multiselect.mjs +103 -248
  106. package/fesm2022/anguless-angulux-multiselect.mjs.map +1 -1
  107. package/fesm2022/anguless-angulux-overlay.mjs +18 -39
  108. package/fesm2022/anguless-angulux-overlay.mjs.map +1 -1
  109. package/fesm2022/anguless-angulux-paginator.mjs +57 -103
  110. package/fesm2022/anguless-angulux-paginator.mjs.map +1 -1
  111. package/fesm2022/anguless-angulux-password.mjs +49 -104
  112. package/fesm2022/anguless-angulux-password.mjs.map +1 -1
  113. package/fesm2022/anguless-angulux-popover.mjs +16 -33
  114. package/fesm2022/anguless-angulux-popover.mjs.map +1 -1
  115. package/fesm2022/anguless-angulux-progressbar.mjs +18 -37
  116. package/fesm2022/anguless-angulux-progressbar.mjs.map +1 -1
  117. package/fesm2022/anguless-angulux-progressspinner.mjs +10 -10
  118. package/fesm2022/anguless-angulux-radiobutton.mjs +13 -13
  119. package/fesm2022/anguless-angulux-ripple.mjs +10 -10
  120. package/fesm2022/anguless-angulux-scroller.mjs +36 -77
  121. package/fesm2022/anguless-angulux-scroller.mjs.map +1 -1
  122. package/fesm2022/anguless-angulux-select.mjs +85 -225
  123. package/fesm2022/anguless-angulux-select.mjs.map +1 -1
  124. package/fesm2022/anguless-angulux-selectbutton.mjs +18 -35
  125. package/fesm2022/anguless-angulux-selectbutton.mjs.map +1 -1
  126. package/fesm2022/anguless-angulux-skeleton.mjs +10 -10
  127. package/fesm2022/anguless-angulux-splitbutton.mjs +23 -50
  128. package/fesm2022/anguless-angulux-splitbutton.mjs.map +1 -1
  129. package/fesm2022/anguless-angulux-table.mjs +332 -638
  130. package/fesm2022/anguless-angulux-table.mjs.map +1 -1
  131. package/fesm2022/anguless-angulux-tabs.mjs +47 -71
  132. package/fesm2022/anguless-angulux-tabs.mjs.map +1 -1
  133. package/fesm2022/anguless-angulux-tag.mjs +20 -37
  134. package/fesm2022/anguless-angulux-tag.mjs.map +1 -1
  135. package/fesm2022/anguless-angulux-textarea.mjs +10 -10
  136. package/fesm2022/anguless-angulux-tieredmenu.mjs +28 -55
  137. package/fesm2022/anguless-angulux-tieredmenu.mjs.map +1 -1
  138. package/fesm2022/anguless-angulux-timeline.mjs +24 -55
  139. package/fesm2022/anguless-angulux-timeline.mjs.map +1 -1
  140. package/fesm2022/anguless-angulux-toast.mjs +24 -49
  141. package/fesm2022/anguless-angulux-toast.mjs.map +1 -1
  142. package/fesm2022/anguless-angulux-togglebutton.mjs +23 -50
  143. package/fesm2022/anguless-angulux-togglebutton.mjs.map +1 -1
  144. package/fesm2022/anguless-angulux-toggleswitch.mjs +18 -38
  145. package/fesm2022/anguless-angulux-toggleswitch.mjs.map +1 -1
  146. package/fesm2022/anguless-angulux-tooltip.mjs +10 -10
  147. package/fesm2022/anguless-angulux-treetable.mjs +229 -428
  148. package/fesm2022/anguless-angulux-treetable.mjs.map +1 -1
  149. package/fesm2022/anguless-angulux-usestyle.mjs +3 -3
  150. package/package.json +6 -6
  151. package/types/anguless-angulux-api.d.ts +17 -21
  152. package/types/anguless-angulux-button.d.ts +6 -12
  153. package/types/anguless-angulux-card.d.ts +8 -17
  154. package/types/anguless-angulux-checkbox.d.ts +4 -8
  155. package/types/anguless-angulux-chip.d.ts +4 -8
  156. package/types/anguless-angulux-confirmdialog.d.ts +19 -29
  157. package/types/anguless-angulux-datepicker.d.ts +27 -42
  158. package/types/anguless-angulux-dialog.d.ts +10 -20
  159. package/types/anguless-angulux-drawer.d.ts +8 -16
  160. package/types/anguless-angulux-fileupload.d.ts +27 -38
  161. package/types/anguless-angulux-inputnumber.d.ts +6 -12
  162. package/types/anguless-angulux-menu.d.ts +27 -39
  163. package/types/anguless-angulux-message.d.ts +6 -12
  164. package/types/anguless-angulux-multiselect.d.ts +20 -41
  165. package/types/anguless-angulux-overlay.d.ts +4 -7
  166. package/types/anguless-angulux-paginator.d.ts +17 -25
  167. package/types/anguless-angulux-password.d.ts +30 -38
  168. package/types/anguless-angulux-popover.d.ts +4 -7
  169. package/types/anguless-angulux-progressbar.d.ts +4 -8
  170. package/types/anguless-angulux-scroller.d.ts +7 -13
  171. package/types/anguless-angulux-select.d.ts +16 -49
  172. package/types/anguless-angulux-selectbutton.d.ts +4 -8
  173. package/types/anguless-angulux-splitbutton.d.ts +17 -21
  174. package/types/anguless-angulux-table.d.ts +42 -93
  175. package/types/anguless-angulux-tabs.d.ts +4 -9
  176. package/types/anguless-angulux-tag.d.ts +4 -8
  177. package/types/anguless-angulux-tieredmenu.d.ts +5 -9
  178. package/types/anguless-angulux-timeline.d.ts +5 -11
  179. package/types/anguless-angulux-toast.d.ts +22 -26
  180. package/types/anguless-angulux-togglebutton.d.ts +5 -11
  181. package/types/anguless-angulux-toggleswitch.d.ts +4 -8
  182. package/types/anguless-angulux-treetable.d.ts +40 -62
package/README.md ADDED
@@ -0,0 +1,291 @@
1
+ # angulux
2
+
3
+ **A curated Angular 22 UI component library, forked from the last MIT release of PrimeNG (21.1.9), with the MIT provenance proven by machine rather than asserted in prose.**
4
+
5
+ [![CI](https://github.com/anguless-com/angulux/actions/workflows/ci.yml/badge.svg)](https://github.com/anguless-com/angulux/actions/workflows/ci.yml)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
7
+ [![npm](https://img.shields.io/npm/v/@anguless/angulux)](https://www.npmjs.com/package/@anguless/angulux)
8
+ [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/anguless-com/angulux/badge)](https://scorecard.dev/viewer/?uri=github.com/anguless-com/angulux)
9
+
10
+ ```bash
11
+ npm install @anguless/angulux @primeuix/themes
12
+ ```
13
+
14
+ ```ts
15
+ import { provideAngulux } from '@anguless/angulux/config';
16
+ import Aura from '@primeuix/themes/aura';
17
+
18
+ bootstrapApplication(App, {
19
+ providers: [provideAngulux({ theme: { preset: Aura } })]
20
+ });
21
+ ```
22
+
23
+ **Why the second package.** angulux ships no theme presets of its own, so the preset comes
24
+ from `@primeuix/themes` — PrimeTek's, and MIT through `2.0.3`. angulux itself still installs
25
+ with **zero PrimeTek packages** in its dependency tree; drop the second package and
26
+ `provideAngulux()` runs unstyled but works.
27
+
28
+ It is declared as an **optional** peer ranged `^2.0.0`, and the ceiling is deliberate:
29
+ `3.0.0` is the first commercial release. Be clear about what that buys you — a peer range is
30
+ a *warning*, not a lock. `npm install @primeuix/themes@3` still succeeds; it just prints an
31
+ `ERESOLVE` warning naming the range it broke. That is enough for the case that actually
32
+ happens (a routine `npm update`, or an agent bumping dependencies, sliding across a license
33
+ boundary in silence) and it is not enough for anything else. If the boundary matters to you,
34
+ pin the version exactly and run a licence guard in your own build. That gate is published as
35
+ its own MIT package, [`angulux-license-guard`](packages/angulux-license-guard) — it reads your
36
+ lockfile, fails closed on any PrimeTek package it cannot verify, and has no dependencies of
37
+ its own. It works in any project; it does not require angulux.
38
+
39
+ ---
40
+
41
+ ## Read this part first
42
+
43
+ angulux is **not** a drop-in replacement for PrimeNG, and it is **not** trying to be the
44
+ community's continuation of it. Three facts decide whether you should keep reading:
45
+
46
+ 1. **It ships 64 of PrimeNG's 117 modules.** Editor, Tree, OrganizationChart, PickList,
47
+ OrderList, Listbox and 47 others are not ported — all 53 are listed in
48
+ [`packages/angulux/attic/`](packages/angulux/attic/). See
49
+ [What angulux is NOT](#what-angulux-is-not).
50
+ 2. **Selectors were renamed.** `p-button` is `agl-button`, `pTooltip` is `aglTooltip`.
51
+ CSS class names (`p-*`) were deliberately kept — see [NOTICE](NOTICE) for why.
52
+ 3. **Bus factor is 1.** One maintainer, a permanent obligation of two Angular majors per
53
+ year. MIT, best-effort, **no SLA**. If that is disqualifying for you, it should be.
54
+
55
+ If what you need is "I run PrimeNG 21 and I want to keep going with minimal change", the
56
+ honest answer is that [Optimus UI](https://github.com/openng-org/optimus-ui) fits that
57
+ better than angulux does: it keeps the `p-*` selectors and carries the full module set.
58
+ We would rather tell you that here than collect an issue about it later.
59
+
60
+ ## Why angulux exists
61
+
62
+ PrimeNG 22 moved to a commercial license. Every release up to and including **21.1.9** was
63
+ published under MIT and stays MIT permanently — that is what a published license grant
64
+ means. angulux is a fork taken at that boundary, for teams whose blocker is **control and
65
+ legal certainty**, not price.
66
+
67
+ The interesting part is not the fork. It is that the boundary is enforced by machine.
68
+
69
+ ## The three things that are actually different
70
+
71
+ ### 1. Every release is machine-proven MIT
72
+
73
+ Thirteen gates run on every commit and every pull request. They do not check style — each one
74
+ closes a class of failure that has already happened in this repository.
75
+
76
+ | Gate | What it refuses to let through |
77
+ |---|---|
78
+ | `check:catalog` | a dependency version drifting off the pinned catalog |
79
+ | `check:scope` | the transitive closure drifting off the 64 warranted modules |
80
+ | `check:license` | any PrimeTek package from a post-MIT release entering the tree — and, separately, any licence-flagged material sitting in `ref/` that `PROVENANCE.md` does not declare |
81
+ | `check:names` | PrimeNG names surviving in selector, API or **trademark** positions — including inside bare strings, JSDoc links and DOM attributes |
82
+ | `check:risk-coverage` | the browser gate's scope drifting off the risky decorators computed from source |
83
+ | `check:language` | non-English text reaching a public repository |
84
+ | `check:public-tree` | internal-only paths sitting in the git index (`.gitignore` does **not** untrack) |
85
+ | `check:scope-names` | a bare `angulux`/`angulux-*` package reference surviving where the scoped `@anguless/*` name belongs |
86
+ | `check:tsup` | the bundler leaking outside the four forks' own build scripts |
87
+ | `check:action-inputs` | a workflow passing a `with:` key that its action does not declare — YAML nobody validates until it silently does nothing |
88
+ | `check:facet-single-route` | a template slot growing a second route, after the whole library was collapsed onto one `<ng-template #x>` mechanism |
89
+ | `check:corpus` | `corpus/corpus.json` drifting off the source it is generated from — a generated artifact nobody regenerates is a lie with a timestamp, and nothing else breaks when it goes stale |
90
+ | `check:gate-count` | this list going stale — the count and the gate names are re-derived from `package.json` and checked against every place they are written down |
91
+
92
+ ```bash
93
+ npm run check # all thirteen, no build needed
94
+ ```
95
+
96
+ Two further checks run after the build rather than inside that suite, because neither has
97
+ anything to inspect until there is a build to inspect. Both look at the artifact instead of
98
+ the source it came from:
99
+
100
+ | Check | What it refuses to let ship |
101
+ |---|---|
102
+ | `check:publishable` | packs every package and reads `package.json` back **out of the tarball**, so what gets inspected is the exact bytes npm would receive. It exists because a guard that read the source tree instead once passed while three packages were about to publish an uninstallable `workspace:` dependency |
103
+ | `check:dts` | compiles the **emitted `.d.ts`** with `skipLibCheck: false`. Every tsconfig here sets it to `true`, which means our own declarations are the one thing no build in this repository type-checks — a consumer who turns it off compiles them for real, and if they do not stand up alone that consumer's build breaks while ours stays green |
104
+
105
+ Both refuse to run against nothing, and `check:dts` goes further: it reports success only
106
+ after a deliberately broken declaration has been put through the same program and rejected.
107
+ A type-check aimed at zero files does not say "I found nothing" — it says "no errors".
108
+
109
+ Two of them — `check:license` and `check:catalog` — **also run daily on a schedule**, and
110
+ that is not redundancy. A pull-request run only proves the tree was clean *at our last
111
+ commit*, while the boundary those two enforce lives outside this repository: PrimeTek
112
+ decides which of their releases is the last MIT one, and that can change on a day when
113
+ nobody here pushes anything. The rest gate our own code, so a commit is the only
114
+ moment they can be wrong.
115
+
116
+ On top of that: `provenance/manifest.json` records SHA-256 checksums and registry publish
117
+ timestamps for every archived MIT artifact, and a browser gate renders **15 of 15**
118
+ risk-flagged decorators in a real Chromium and asserts on the result — because a green
119
+ type-check cannot see a render bug.
120
+
121
+ Current evidence, reproducible from a clean checkout:
122
+
123
+ ```
124
+ 13/13 gates exit 0
125
+ library build exit 0 · 210 entrypoints
126
+ inherited spec suite 3765 SUCCESS
127
+ browser gate 13/13 passed
128
+ runtime deps tslib + four first-party angulux-* packages. Zero PrimeTek.
129
+ ```
130
+
131
+ ### 2. Angular-latest-first, as a published commitment
132
+
133
+ The commitment is **a green build within 14 days of every Angular major RC**, verified by a
134
+ nightly job that builds against `@angular/core@next` and reports publicly. angulux's major
135
+ version is locked to Angular's major, so `angulux@22.x` targets Angular 22 and nothing else.
136
+
137
+ ### 3. 64 warranted modules instead of 117 unverified ones
138
+
139
+ Every shipped module is inside the closure that the gates cover. The other 53 live in
140
+ [`packages/angulux/attic/`](packages/angulux/attic/) — verbatim upstream source, not built,
141
+ not published, kept in the open as a roadmap. Promoting one is a well-defined contribution; see
142
+ [CONTRIBUTING.md](CONTRIBUTING.md).
143
+
144
+ ## What angulux is NOT
145
+
146
+ - **Not a drop-in replacement.** Selectors changed. A migration codemod is planned, not shipped.
147
+ - **Not feature-parity with PrimeNG.** 64 of 117 modules. Missing, among others: Editor,
148
+ Tree, TreeSelect, OrganizationChart, PickList, OrderList, Listbox, Terminal, Dock.
149
+ (TreeTable **is** shipped; Tree is not.)
150
+ - **Not affiliated with PrimeTek or Google.** See [NOTICE](NOTICE).
151
+ - **Not a supported product.** MIT, best-effort, no SLA, no response-time promise.
152
+ - **Not a fork made in anger.** PrimeTek gave the community ten years of MIT work and
153
+ confirmed that past MIT releases stay MIT. This project exists because of that grant,
154
+ not in spite of it. Keep that tone in issues and pull requests.
155
+
156
+ ## Requirements
157
+
158
+ | | |
159
+ |---|---|
160
+ | Angular | `^22.0.0` |
161
+ | TypeScript | `6.0.x` (Angular 22's compiler requires `>=6.0 <6.1`) |
162
+ | Node | `>=22` |
163
+ | Package manager | pnpm 9.6.0 (via corepack) for development; any manager to consume |
164
+
165
+ `chart.js` is an optional peer, needed only by the chart module. There is no
166
+ `@angular/cdk` peer — it was dropped on purpose; nothing in the warranted closure needs it.
167
+
168
+ ## Packages
169
+
170
+ | Package | Version | Purpose |
171
+ |---|---|---|
172
+ | [`angulux`](packages/angulux) | `22.x` | the component library — major locked to Angular's major |
173
+ | [`angulux-styled`](packages/angulux-styled) | `1.x` | style engine, forked from `@primeuix/styled` |
174
+ | [`angulux-utils`](packages/angulux-utils) | `1.x` | DOM/object utilities, forked from `@primeuix/utils` |
175
+ | [`angulux-styles`](packages/angulux-styles) | `1.x` | base style definitions |
176
+ | [`angulux-motion`](packages/angulux-motion) | `1.x` | animation primitives |
177
+
178
+ The four forked packages version **independently on `1.x`** — they do not depend on Angular,
179
+ so locking them to Angular's major would be a lie about their compatibility.
180
+
181
+ ## Development
182
+
183
+ ```bash
184
+ corepack pnpm install
185
+ npm run check # the 13 gates
186
+
187
+ # the four forked packages build BEFORE the library — dependency order matters
188
+ for p in utils styled motion styles; do
189
+ (cd packages/angulux-$p && corepack pnpm run build)
190
+ done
191
+
192
+ corepack pnpm --filter angulux run build # → 210 entrypoints
193
+ corepack pnpm --filter angulux run test:unit # → 3765 specs
194
+ corepack pnpm --filter @angulux/verify run build
195
+ npx playwright test --config e2e/playwright.config.ts # browser gate → 13/13
196
+ ```
197
+
198
+ `pnpm` runs through corepack and is not on `PATH`; use `corepack pnpm`. Karma needs
199
+ `CHROME_BIN` set if Chrome is not at the default location.
200
+
201
+ ## Documentation for AI assistants
202
+
203
+ Angulux is new, so no model has seen it. Ask an assistant about it and it will answer with
204
+ PrimeNG's `p-*` API, because that is the only thing in its training data. These files exist
205
+ so it does not have to guess:
206
+
207
+ | URL | What it is |
208
+ | --- | --- |
209
+ | [the index page](https://angulux.anguless.com/) | what is here, for a reader who trimmed the URL back to the host; also served at [`/llms`](https://angulux.anguless.com/llms) |
210
+ | [`llms.txt`](https://angulux.anguless.com/llms.txt) | the index, in the [llms.txt](https://llmstxt.org) format |
211
+ | [`llms-full.txt`](https://angulux.anguless.com/llms-full.txt) | every module's API in one file |
212
+ | `<module>.md` | one page per module, e.g. [`button.md`](https://angulux.anguless.com/button.md) |
213
+
214
+ All of it is generated from this repository's own TypeScript into `corpus/corpus.json`, and
215
+ `check:corpus` fails the build if the committed corpus is not byte-identical to a fresh
216
+ generation. Nothing here is hand-written, so **do not edit the corpus or the pages** — the
217
+ next generation overwrites them. Fix the JSDoc in the component instead.
218
+
219
+ Three things worth knowing before you rely on it:
220
+
221
+ - **`llms-full.txt` is not part of the llms.txt specification.** The spec defines one file,
222
+ `llms.txt`. The full variant is a widely-followed convention, and we serve it because
223
+ assistants look for it — not because a standard requires it.
224
+ - **Most inputs do not document a default.** Only 127 of 1205 declare `@defaultValue`, so
225
+ pages say *not documented* rather than leaving a blank that reads as "there is no default".
226
+ - **69 inputs are deprecated** and each page names the replacement. That number is the single
227
+ best reason for this to exist: without it, an assistant recommends them confidently.
228
+
229
+ The generator can only read `packages/angulux/**` and `tools/**` and makes no network
230
+ request. That boundary is enforced in code and asserted by a test, because the PrimeNG
231
+ *documentation site* was never MIT — only the source was, and only up to 21.1.9.
232
+
233
+ ### For assistants that speak MCP
234
+
235
+ `packages/angulux-mcp` serves the same corpus as five tools over MCP stdio, so an assistant can
236
+ query it instead of reading a page. It is **not published** — run it from a checkout:
237
+
238
+ ```
239
+ claude mcp add angulux -- node /absolute/path/to/angulux/packages/angulux-mcp/bin/angulux-mcp.mjs
240
+ ```
241
+
242
+ The tool worth knowing about is `check_usage`. Give it a selector, an import specifier, a module
243
+ name or a list of inputs, and it answers before you write the code:
244
+
245
+ ```
246
+ check_usage({ selector: 'p-button', entrypoint: 'primeng/button' })
247
+ → selector `p-button` is PrimeNG's; angulux uses `agl-button`
248
+ → import specifier `primeng/button` does not resolve; use `@anguless/angulux/button`
249
+ ```
250
+
251
+ A test drives the real binary over stdio and proves all 24 benchmark questions are answerable in
252
+ at most two tool calls, with PrimeNG's answer absent from the reply. That is a claim about the
253
+ data, not about assistants: whether a model actually consults the server instead of guessing is
254
+ **not measured** — see the package README.
255
+
256
+ See [`packages/angulux-mcp/README.md`](packages/angulux-mcp/README.md) for the other four tools,
257
+ the non-Claude client snippet, and why the package is unpublished.
258
+
259
+ ## Provenance
260
+
261
+ [`PROVENANCE.md`](PROVENANCE.md) records the exact upstream commits, the archived MIT
262
+ artifacts and their checksums, and the command to verify them yourself. You are not asked to
263
+ take the MIT claim on trust — you are given the means to check it. That is the whole point
264
+ of the project.
265
+
266
+ ## Contributing
267
+
268
+ Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request. It is short, but the
269
+ **provenance clause is not optional**: contributions must not carry code, documentation or
270
+ generated output derived from any post-MIT PrimeNG release. One contaminated pull request
271
+ would invalidate the entire argument above, so every pull request carries a Developer
272
+ Certificate of Origin sign-off and an explicit provenance attestation.
273
+
274
+ Also relevant: [TRIAGE.md](TRIAGE.md) (what happens after you file) ·
275
+ [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) · [SECURITY.md](SECURITY.md) ·
276
+ [SUPPORT.md](SUPPORT.md) · [GOVERNANCE.md](GOVERNANCE.md)
277
+
278
+ ### Think the provenance claim is wrong somewhere?
279
+
280
+ Then that is the single most valuable thing you can report here, and it is handled as P0:
281
+ [open a Provenance concern](https://github.com/anguless-com/angulux/issues/new/choose).
282
+
283
+ A project that asks you not to trust it has to mean it. The claim gets checked, not
284
+ defended; if it holds, the affected code is removed rather than argued for; if a gate should
285
+ have caught it, a gate gets written; and the outcome is published either way, including when
286
+ the report turns out to be wrong. If you are a rights holder making a legal claim, use the
287
+ [private channel](https://github.com/anguless-com/angulux/security/advisories/new) instead.
288
+
289
+ ## License
290
+
291
+ MIT — see [LICENSE](LICENSE) and [NOTICE](NOTICE).
@@ -1,8 +1,7 @@
1
1
  import * as i0 from '@angular/core';
2
- import { Injectable, ChangeDetectionStrategy, Component, Input, Directive, NgModule } from '@angular/core';
2
+ import { Injectable, NgModule } from '@angular/core';
3
3
  import { Subject } from 'rxjs';
4
4
  import { resolveFieldData, equals, removeAccents } from '@anguless/angulux-utils';
5
- import { CommonModule } from '@angular/common';
6
5
 
7
6
  /**
8
7
  * Type of the confirm event.
@@ -47,10 +46,10 @@ class ConfirmationService {
47
46
  onAccept() {
48
47
  this.acceptConfirmationSource.next(null);
49
48
  }
50
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ConfirmationService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
51
- static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ConfirmationService });
49
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: ConfirmationService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
50
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: ConfirmationService });
52
51
  }
53
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ConfirmationService, decorators: [{
52
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: ConfirmationService, decorators: [{
54
53
  type: Injectable
55
54
  }] });
56
55
 
@@ -66,10 +65,10 @@ class ContextMenuService {
66
65
  this.activeItemKey = null;
67
66
  this.activeItemKeyChange.next(this.activeItemKey);
68
67
  }
69
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ContextMenuService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
70
- static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ContextMenuService });
68
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: ContextMenuService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
69
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: ContextMenuService });
71
70
  }
72
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ContextMenuService, decorators: [{
71
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: ContextMenuService, decorators: [{
73
72
  type: Injectable
74
73
  }] });
75
74
 
@@ -314,10 +313,10 @@ class FilterService {
314
313
  register(rule, fn) {
315
314
  this.filters[rule] = fn;
316
315
  }
317
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: FilterService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
318
- static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: FilterService, providedIn: 'root' });
316
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: FilterService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
317
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: FilterService, providedIn: 'root' });
319
318
  }
320
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: FilterService, decorators: [{
319
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: FilterService, decorators: [{
321
320
  type: Injectable,
322
321
  args: [{ providedIn: 'root' }]
323
322
  }] });
@@ -359,10 +358,10 @@ class MessageService {
359
358
  clear(key) {
360
359
  this.clearSource.next(key || null);
361
360
  }
362
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: MessageService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
363
- static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: MessageService });
361
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: MessageService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
362
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: MessageService });
364
363
  }
365
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: MessageService, decorators: [{
364
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: MessageService, decorators: [{
366
365
  type: Injectable
367
366
  }] });
368
367
 
@@ -379,10 +378,10 @@ class OverlayService {
379
378
  emitParentDrag(container) {
380
379
  this.parentDragSource.next(container);
381
380
  }
382
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: OverlayService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
383
- static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: OverlayService, providedIn: 'root' });
381
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: OverlayService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
382
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: OverlayService, providedIn: 'root' });
384
383
  }
385
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: OverlayService, decorators: [{
384
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: OverlayService, decorators: [{
386
385
  type: Injectable,
387
386
  args: [{ providedIn: 'root' }]
388
387
  }] });
@@ -592,7 +591,6 @@ class AglIcons {
592
591
  static PLUS_CIRCLE = 'pi pi-plus-circle';
593
592
  static POUND = 'pi pi-pound';
594
593
  static POWER_OFF = 'pi pi-power-off';
595
- static PRIME = 'pi pi-prime';
596
594
  static PRINT = 'pi pi-print';
597
595
  static QRCODE = 'pi pi-qrcode';
598
596
  static QUESTION = 'pi pi-question';
@@ -701,69 +699,29 @@ class AglIcons {
701
699
  static YOUTUBE = 'pi pi-youtube';
702
700
  }
703
701
 
704
- class Header {
705
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: Header, deps: [], target: i0.ɵɵFactoryTarget.Component });
706
- static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "22.0.8", type: Header, isStandalone: false, selector: "agl-header", ngImport: i0, template: '<ng-content></ng-content>', isInline: true, changeDetection: i0.ChangeDetectionStrategy.Eager });
707
- }
708
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: Header, decorators: [{
709
- type: Component,
710
- args: [{
711
- changeDetection: ChangeDetectionStrategy.Eager,
712
- selector: 'agl-header',
713
- template: '<ng-content></ng-content>',
714
- standalone: false
715
- }]
716
- }] });
717
- class Footer {
718
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: Footer, deps: [], target: i0.ɵɵFactoryTarget.Component });
719
- static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "22.0.8", type: Footer, isStandalone: false, selector: "agl-footer", ngImport: i0, template: '<ng-content></ng-content>', isInline: true, changeDetection: i0.ChangeDetectionStrategy.Eager });
720
- }
721
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: Footer, decorators: [{
722
- type: Component,
723
- args: [{
724
- changeDetection: ChangeDetectionStrategy.Eager,
725
- selector: 'agl-footer',
726
- template: '<ng-content></ng-content>',
727
- standalone: false
728
- }]
729
- }] });
730
- class AglTemplate {
731
- template;
732
- type;
733
- name;
734
- constructor(template) {
735
- this.template = template;
736
- }
737
- getType() {
738
- return this.name;
739
- }
740
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AglTemplate, deps: [{ token: i0.TemplateRef }], target: i0.ɵɵFactoryTarget.Directive });
741
- static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.8", type: AglTemplate, isStandalone: true, selector: "[aglTemplate]", inputs: { type: "type", name: ["aglTemplate", "name"] }, ngImport: i0 });
742
- }
743
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AglTemplate, decorators: [{
744
- type: Directive,
745
- args: [{
746
- selector: '[aglTemplate]',
747
- standalone: true
748
- }]
749
- }], ctorParameters: () => [{ type: i0.TemplateRef }], propDecorators: { type: [{
750
- type: Input
751
- }], name: [{
752
- type: Input,
753
- args: ['aglTemplate']
754
- }] } });
702
+ /**
703
+ * SharedModule once carried the three retired facet mechanisms: the `<agl-header>` and
704
+ * `<agl-footer>` projection components, and the `[aglTemplate]` directive whose `getType()`
705
+ * fed a per-component decorator query that switched on the slot name and wrote the result into
706
+ * a shadow `_xTemplate` field.
707
+ *
708
+ * BL-35 replaced all three with one route per slot — `<ng-template #x>` read by
709
+ * `contentChild('x')` — so the module now declares and exports nothing. Removing the three
710
+ * classes was the closing condition of that migration, and `tools/check-facet-single-route.mjs`
711
+ * (R-6) keeps them gone: it fails if any of the three reappears here.
712
+ *
713
+ * The module itself is deliberately kept. It is public API that consumers import, and dropping
714
+ * an export is a breaking change that belongs to a major-version decision rather than to this
715
+ * migration. Importing it is now a no-op.
716
+ */
755
717
  class SharedModule {
756
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: SharedModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
757
- static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: SharedModule, declarations: [Header, Footer], imports: [CommonModule, AglTemplate], exports: [Header, Footer, AglTemplate] });
758
- static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: SharedModule, imports: [CommonModule] });
718
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: SharedModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
719
+ static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.1.1", ngImport: i0, type: SharedModule });
720
+ static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: SharedModule });
759
721
  }
760
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: SharedModule, decorators: [{
722
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: SharedModule, decorators: [{
761
723
  type: NgModule,
762
- args: [{
763
- imports: [CommonModule, AglTemplate],
764
- exports: [Header, Footer, AglTemplate],
765
- declarations: [Header, Footer]
766
- }]
724
+ args: [{}]
767
725
  }] });
768
726
 
769
727
  class TranslationKeys {
@@ -828,10 +786,10 @@ class TreeDragDropService {
828
786
  stopDrag(event) {
829
787
  this.dragStopSource.next(event);
830
788
  }
831
- static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: TreeDragDropService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
832
- static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: TreeDragDropService });
789
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: TreeDragDropService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
790
+ static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: TreeDragDropService });
833
791
  }
834
- i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: TreeDragDropService, decorators: [{
792
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.1", ngImport: i0, type: TreeDragDropService, decorators: [{
835
793
  type: Injectable
836
794
  }] });
837
795
 
@@ -839,5 +797,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
839
797
  * Generated bundle index. Do not edit.
840
798
  */
841
799
 
842
- export { AglIcons, AglTemplate, ConfirmEventType, ConfirmationService, ContextMenuService, FilterMatchMode, FilterOperator, FilterService, Footer, Header, MessageService, OverlayService, SharedModule, TranslationKeys, TreeDragDropService };
800
+ export { AglIcons, ConfirmEventType, ConfirmationService, ContextMenuService, FilterMatchMode, FilterOperator, FilterService, MessageService, OverlayService, SharedModule, TranslationKeys, TreeDragDropService };
843
801
  //# sourceMappingURL=anguless-angulux-api.mjs.map