@gravionlabs/helix-core 22.0.0

package/LICENSE.md

@@ -0,0 +1,77 @@
+# PRIMENG LICENSES
+
+## PRIMENG COMMUNITY VERSIONS LICENSE
+
+The MIT License (MIT)
+
+Copyright (c) 2016-2026 PrimeTek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+## PRIMENG LTS VERSIONS LICENSE (Versions with -lts suffix)
+
+THIS LICENSE AGREEMENT (THIS “CLA”) CONTAINS THE TERMS AND CONDITIONS FOR YOUR USE OF “PRIMENG LONG TERM SUPPORT”, A SUITE OF Angular Components (THE “Software”). THIS CLA IS A BINDING AGREEMENT BETWEEN YOU (“Licensee”) AND PrimeTek Bilişim. (“Licensor“); HOWEVER, IF YOU ARE ACTING AS AN AGENT FOR ANOTHER, SUCH AS ON BEHALF OF YOUR EMPLOYER, THEN “YOU” MEANS THE OTHER PERSON. BY INSTALLING, COPYING, USING OR OTHERWISE ACCESSING THE SOFTWARE, YOU AGREE TO BE BOUND BY THESE TERMS AND CONDITIONS.
+
+The term “Software” includes all source and object code, in whole and/or part; all printed materials; “online” or electronic documentation; data, data engines, images; updates and upgrades; and anything provided for use with or in conjunction with the Software.
+
+## Summary
+
+- Can be used on unlimited sites and servers
+- Source-code cannot be resold or distributed
+- Commercial use allowed
+- Can modify source-code but cannot distribute modifications (derivative works)
+
+## Terms and Conditions
+
+1. **License Grant:** Licensor hereby grants Licensee a Personal, Non-assignable and non-transferable, Commercial, Royalty free, Including the rights to create but not distribute derivative works, Non-exclusive license identified with a unique key stated in section 3, all with accordance with the terms set forth and other legal restrictions set forth in 3rd party software used while running Software.
+
+    1. **Limited:** Licensee may use Software for the purpose of:
+
+        1. Running Software on Licensee’s Website\[s\] and Server\[s\];
+        2. Allowing 3rd Parties to run Software on Licensee’s Website\[s\] and Server\[s\];
+        3. Publishing Software’s output to Licensee and 3rd Parties;
+        4. Distribute verbatim copies of Software’s output (including compiled binaries);
+        5. Modify Software to suit Licensee’s needs and specifications.
+
+    2. **Non Assignable and Non-Transferable:** Licensee may not assign or transfer his rights and duties under this license.
+    3. **Commercial, Royalty Free:** Licensee may use Software for any purpose, including paid-services, without any royalties
+    4. **Including the Right to Create Derivative Works:** Licensee may create derivative works based on Software, including amending Software’s source code, modifying it, integrating it into a larger work or removing portions of Software, as long as no distribution of the derivative works is made
+
+2. **Term & Termination:** The Term of this license shall be until terminated. Licensor may terminate this Agreement, including Licensee’s license in the case where Licensee :
+    1. became insolvent or otherwise entered into any liquidation process; or
+    2. exported The Software to any jurisdiction where licensor may not enforce his rights under this agreements in; or
+    3. Licensee was in breach of any of this license's terms and conditions and such breach was not cured, immediately upon notification; or
+    4. Licensee in breach of any of the terms of clause 2 to this license; or
+    5. Licensee otherwise entered into any arrangement which caused Licensor to be unable to enforce his rights under this License.
+3. **Payment:** In consideration of the License granted under clause 2, Licensee shall pay Licensor a fee, via credit card or any other mean which Licensor may deem adequate. Failure to perform payment shall construe as material breach of this Agreement. Transaction id of the payment is the unique license key granted to Licensee.
+4. **Upgrades, Updates and Fixes:** .
+
+    1. **Fix:** for the purpose of this license, a fix shall be a minor amendment in The Software, intended to remove bugs or alter minor features which impair the The Software's functionality. A fix shall be marked as a new sub-sub-version number. For example, should Licensee purchase Software under version 1.1.1, an upgrade shall commence under number 1.1.2.
+
+5. **Support:** Software is provided under an AS-IS basis and without any support, updates or maintenance. Nothing in this Agreement shall require Licensor to provide Licensee with support or fixes to any bug, failure, mis-performance or other defect in The Software.
+6. **Liability:** To the extent permitted under Law, The Software is provided under an AS-IS basis. Licensor shall never, and without any limit, be liable for any damage, cost, expense or any other payment incurred by Licesee as a result of Software’s actions, failure, bugs and/or any other interaction between The Software and Licesee’s end-equipment, computers, other software or any 3rd party, end-equipment, computer or services. Moreover, Licensor shall never be liable for any defect in source code written by Licensee when relying on The Software or using The Software’s source code.
+7. **Warranty:**
+
+    1. **Intellectual Property:** Licensor hereby warrants that The Software does not violate or infringe any 3rd party claims in regards to intellectual property, patents and/or trademarks and that to the best of its knowledge no legal action has been taken against it for any infringement or violation of any 3rd party intellectual property rights.
+    2. **No-Warranty:** The Software is provided without any warranty; Licensor hereby disclaims any warranty that The Software shall be error free, without defects or code which may cause damage to Licensee’s computers or to Licensee, and that Software shall be functional. Licensee shall be solely liable to any damage, defect or loss incurred as a result of operating software and undertake the risks contained in running The Software on License’s Server\[s\] and Website\[s\].
+    3. **Prior Inspection:** Licensee hereby states that he inspected The Software thoroughly and found it satisfactory and adequate to his needs, that it does not interfere with his regular operation and that it does meet the standards and scope of his computer systems and architecture. Licensee found that The Software interacts with his development, website and server environment and that it does not infringe any of End User License Agreement of any software Licensee may use in performing his services. Licensee hereby waives any claims regarding The Software's incompatibility, performance, results and features, and warrants that he inspected the The Software.
+
+8. **No Refunds:** Licensee warrants that he inspected The Software according to clause 7(c) and that it is adequate to his needs. Accordingly, as The Software is intangible goods, Licensee shall not be, ever, entitled to any refund, rebate, compensation or restitution for any reason whatsoever, even if The Software contains material flaws.
+9. **Indemnification:** Licensee hereby warrants to hold Licensor harmless and indemnify Licensor for any lawsuit brought against it in regards to Licensee’s use of The Software in means that violate, breach or otherwise circumvent this license, Licensor's intellectual property rights or Licensor's title in The Software. Licensor shall promptly notify Licensee in case of such legal action and request Licensee’s consent prior to any settlement in relation to such lawsuit or claim.
+10. **Governing Law, Jurisdiction:** Licensee hereby agrees not to initiate class-action lawsuits against Licensor in relation to this license and to compensate Licensor for any legal fees, cost or attorney fees should any claim brought by Licensee against Licensor be denied, in part or in full.

package/README.md

@@ -0,0 +1,35 @@
+# @gravionlabs/helix-core
+
+Helix base component library for Angular — 90 UI components, 7 directives, and
+20 infrastructure modules, each exposed as its own secondary entry point:
+
+```ts
+import { Button } from '@gravionlabs/helix-core/button';
+```
+
+```html
+<h-button label="Save" />
+```
+
+Selectors, CSS classes, and design tokens all use the `h-` prefix
+(`h-button`, `hTooltip`, `hRipple`, `.h-button`, `--h-primary-color`,
+`data-h-disabled`). Styling and theming (the former
+`@primeuix/{utils,motion,styled,styles,themes}` MIT layer) are vendored into
+this library — see [VENDOR.md](VENDOR.md); the class/token prefix rename is
+epic #421 feature #431 (see
+[docs/migrations/css-class-prefix-decision.md](../../docs/migrations/css-class-prefix-decision.md)
+for the history of why it was previously infeasible).
+
+## Documentation
+
+Every module has its own doc page — selectors, inputs, outputs, and exported
+types — indexed at [docs/components](../../docs/components/README.md).
+
+## Attribution
+
+This library is a fork of [PrimeNG](https://github.com/primefaces/primeng) by
+PrimeTek Informatics, vendored at tag `21.1.9` — the last version published
+under the MIT "PRIMENG COMMUNITY VERSIONS LICENSE". See `LICENSE.md` for the
+original license and `VENDOR.md` for the exact upstream commit and the list of
+local modifications. All credit for the original component implementations
+belongs to PrimeTek.

package/VENDOR.md

@@ -0,0 +1,74 @@
+# Vendored source: PrimeNG 21.1.9
+
+This library is a vendored fork of PrimeNG, imported from the last MIT
+community version. Record kept for future diffing against upstream.
+
+| | |
+| --- | --- |
+| Upstream repository | https://github.com/primefaces/primeng |
+| Upstream path | `packages/primeng/src` |
+| Tag | `21.1.9` |
+| Commit | `c493b1c6d9f7cdffbe1c4dc195493dd73d733593` |
+| License at tag | MIT — "PRIMENG COMMUNITY VERSIONS LICENSE" (see `LICENSE.md`) |
+| Imported | 2026-07-13 (epic #201, feature #203) |
+
+## Local modifications
+
+- Import specifiers rewritten: `primeng/<entry>` → `@gravionlabs/helix-core/<entry>`.
+- All component/directive selectors renamed `p-` → `h-` (`p-button` → `h-button`,
+  `pButton` → `hButton`), including template usages and input aliases.
+- `.p-*` CSS class names, `--p-*` design tokens, and `data-p-*`/`data-p` state
+  attributes were renamed to `.h-*`/`--h-*`/`data-h-*`/`data-h` once the
+  styling layer producing them was vendored in (epic #421 feature #431,
+  2026-09-14) — see the "Vendored source: primeuix" section below.
+- Build adapted from the upstream Nx/prebuild setup to this workspace's plain
+  ng-packagr configuration (`ng build core`); the per-entry-point
+  `ng-package.json` files are upstream's, with `$schema` paths adjusted.
+- Upstream `*.spec.ts` files are vendored unmodified apart from the import
+  rewrite; they are excluded from the library build and not yet adapted to the
+  renamed selectors or this workspace's test runner.
+
+## Diffing against upstream
+
+```sh
+git clone --depth 1 --branch 21.1.9 https://github.com/primefaces/primeng
+diff -r primeng/packages/primeng/src projects/core
+```
+
+# Vendored source: primeuix
+
+The `@primeuix/*` packages PrimeNG 21.1.9 depends on for styling and theming
+(`utils`, `motion`, `styled`, `styles`, `themes`) are also vendored in, one at
+a time, as they no longer publish MIT versions past the pins below (epic #421).
+Each is copied from `github.com/primefaces/primeuix` (MIT) into a new
+`uix/<pkg>` (or `themes`) secondary entry point of this library, keeping
+upstream's internal file layout for future diffing.
+
+| Package | Pinned version | Upstream commit | Notes |
+| --- | --- | --- | --- |
+| `utils` | 0.7.2 | [`main`](https://github.com/primefaces/primeuix) @ 0.6.4, hand-ported to 0.7.2 | `isCssSupported` (new in 0.7.x), `toElement` (ref-unwrapping superset), `setAttribute` (style-object handling) manually ported on top of the 0.6.4 source — see doc comments on the touched files under `uix/utils/dom/methods/`. |
+| `motion` | 0.0.10 | [`6835ef4347`](https://github.com/primefaces/primeuix/commit/6835ef4347) (the 0.0.10 version-bump commit; `main` had since moved to 0.0.11 with unrelated new features, deliberately not picked up) | Vendored unmodified apart from import rewrites (`@primeuix/utils` → `uix/utils`) and flattening the package's `types/index.ts` into a sibling `types.ts`. |
+| `styled` | 0.7.4 | [`main`](https://github.com/primefaces/primeuix) @ 0.7.4 (matches the pin exactly) | Vendored unmodified apart from import rewrites (`@primeuix/utils`(`/eventbus`, `/object`) → `uix/utils`). The entry point keeps upstream's `public_api.ts` (renamed from `index.ts`) at its root; two files (`helpers/css.ts`, `helpers/color/palette.ts`) that did a bare directory import of the package root were pointed at `./public_api` explicitly, since ng-packagr refuses an `index.ts` living alongside a differently-named entry file. |
+| `styles` | 2.0.3 | [`main`](https://github.com/primefaces/primeuix) @ 2.0.3 (matches the pin exactly) | Not a separate entry point — each of the 84 component CSS-in-JS modules actually imported (`packages/styles/src/<name>/index.ts`) was copied verbatim next to the component's existing `*style.ts` as `<component>/style/<name>.css.ts`, and the importing file's `from '@primeuix/styles/<name>'` was pointed at the new relative file. Upstream has no cross-module imports in this package, so this was a pure mechanical move. |
+| `themes` | 2.0.3 | [`main`](https://github.com/primefaces/primeuix) @ 2.0.3 (matches the pin exactly) | Vendored as `themes` (engine: `$t`, `updatePreset`, `updateSurfacePalette`, …), `themes/types` (design-token type declarations — its own entry point since presets need it cross-directory) and `themes/{aura,lara,nora}` (Material intentionally excluded per decision). Verified byte-for-byte deep-equal against the live `@primeuix/themes` package for all three presets. Two structural changes from upstream: (1) every component folder's redundant `index.d.ts` packaging shim was dropped (upstream ships a real `index.ts` *and* a near-duplicate hand-written `.d.ts` for its own dual-publish tooling; nothing in-package imports the `.d.ts` except `base`, whose `index.d.ts` is the *real* token-type declarations and was kept, renamed to `basetokens.ts` to avoid colliding with the real `index.ts`). (2) Each preset's default export was changed to a plain named export (`export const auraPreset = {...}`, no `export default`) — see the note below. |
+
+### Gotcha: `export default` is silently dropped from unconsumed ng-packagr entry points
+
+While vendoring `themes`, a bare `export default {...}` (or `export { x as default }`) on a secondary entry point's `public_api.ts` was silently stripped from the built FESM bundle — with no build error — whenever nothing else in the **same** `ng build core` invocation imported that entry point. A plain named export (`export const x = {...}`) on the exact same file survives correctly. Confirmed by bisecting with a minimal throwaway entry point. Since `themes`/`themes/aura`/`themes/lara`/`themes/nora` have no consumers within `projects/core` itself (only `helix-shell`/`helix-demo`, built as separate `ng build` invocations against the *published* dist), any `export default` here would ship broken. **Conclusion: never use `export default` in a `projects/core` secondary entry point** — use named exports throughout.
+
+## `.p-*` → `.h-*` rename (feature #431, 2026-09-14)
+
+Once the styling layer above was fully vendored, the `.p-*` CSS class names, `--p-*` design tokens, and `data-p-*`/bare `data-p` state attributes it produces (previously kept unrenamed per the now-superseded [css-class-prefix-decision.md](../../docs/migrations/css-class-prefix-decision.md)) were mechanically renamed to `.h-*`/`--h-*`/`data-h-*`/`data-h`:
+
+- The rename regex was word-boundary-safe (`\bp-[a-zA-Z][\w-]*` → `h-...`, plus a separate `\bdata-p\b` → `data-h` pass for the bare multi-value state attribute): it cannot match Tailwind's own `p-4`/`px-2` spacing utilities (digit, or a different letter, immediately follows the hyphen) or `pi-*` primeicons classes.
+- Applied across `projects/core` (all 84 vendored `*.css.ts` style modules, component/directive logic, templates, and the `themes/aura` preset's inline `css` override module), `projects/shell`, `projects/zod`, `projects/ag-grid`, and `apps/helix-demo/src` (not `apps/helix-demo/public/source`, which is generated — see `pnpm demo:generate-sources`).
+- `uix/styled`'s `prefix` default (`config/index.ts`) changed from `'p'` to `'h'`, so the `dt()`/`$dt()` token-key generator and `toVariables()` now emit `--h-*` variable names at runtime, matching the renamed static CSS.
+- `projects/shell`'s `tailwindcss-primeui` Tailwind plugin dependency was vendored and renamed too, since it hardcodes `--p-*`/`data-p-*` throughout its utilities and `@custom-variant`s — see `projects/shell/VENDOR.md`.
+- `docs/components/*` regenerated (`pnpm docs:components`) to reflect renamed default values and doc comments.
+
+## Diffing against upstream primeuix
+
+```sh
+git clone --depth 1 --branch main https://github.com/primefaces/primeuix
+diff -r primeuix/packages/utils/src projects/core/uix/utils
+```