@guildofgleks/ui 21.12.0 → 21.13.0

package/README.md

@@ -6,7 +6,7 @@
 
 # @guildofgleks/ui
 
-An Angular 21 and 22 component library with **no CDK and no Material**. 29 components, 5
+An Angular 21 and 22 component library with **no CDK and no Material**. 30 components, 5
 directives and 3 services, all standalone, all signal-based, themed entirely through CSS custom
 properties.
 
@@ -67,6 +67,8 @@ reset is untouched either way, and a single class of specificity means your own
 
 ```ts
 import { ButtonComponent, SelectComponent } from '@guildofgleks/ui';
+// Three components have their own entry point, so a lazy route can keep them out of your
+// initial bundle: '@guildofgleks/ui/table', '/datepicker' and '/dialog'.
 
 @Component({
   imports: [ButtonComponent, SelectComponent],
@@ -446,7 +448,7 @@ dropdowns, always for the menu.
 | Data                | `gog-table` (+ `gog-column`), `gog-paginator`, `gog-tag`                                                                                                                                                          |
 | Layout & disclosure | `gog-accordion`, `gog-tabs` (+ `gog-tab`), `gog-collapsible`, `gog-card`, `gog-panel`, `gog-divider`, `gog-scroll`                                                                                                |
 | Overlays            | `gog-dialog`, `gog-confirmation-dialog`, `gog-toast` (+ `gog-toast-container`), `gog-menu` (+ `gogMenuTrigger` / `gogMenuItem`)                                                                                   |
-| Feedback            | `gog-spinner`, `gog-spinner-overlay`, `gog-progressbar`, `gog-skeleton`                                                                                                                                           |
+| Feedback            | `gog-spinner`, `gog-spinner-overlay`, `gog-progressbar`, `gog-skeleton`, `gog-alert`                                                                                                                              |
 | Content             | `gog-icon`                                                                                                                                                                                                        |
 
 **Directives:** `gogButton` (a link that looks like a button), `gogTooltip`, `gogBadge`,
@@ -464,6 +466,24 @@ A few things worth knowing before you reach for a workaround:
   `[lazy]="true"` it hands both to the server: `value` is the current page, `totalRecords` drives
   the paginator, and `gogSortChange` / `gogPageChange` are your refetch signals. Row selection is
   `selectionMode` + `[(selection)]`; set `dataKey` or a refetch drops it.
+
+  **And here is where it stops, so you find out now rather than halfway in.** `gog-table` has no
+  **column resizing or reordering** by the reader (a column's `width`/`minWidth`/`maxWidth` are
+  yours to set, not theirs to drag), no **frozen columns**, no **expandable rows** and no **row
+  grouping**.
+
+  It **does** virtualize, with `virtualize` — which needs `maxHeight` and `fullWidth`, and says so
+  in a dev-mode warning if either is missing. That is the DOM half: `[lazy]="true"` keeps the fetch
+  small and still stamps every row it is handed. Neither substitutes for the other, and a long
+  table usually wants both.
+
+  `stickyHeader` is not the missing feature in disguise — it pins the header while rows scroll
+  under it, which is the vertical axis. Freezing a first column against horizontal scroll is the
+  one this list says no to.
+
+  If you need a data grid, use one. This is a table that sorts, pages, selects and lets you
+  template any cell, and it is meant to stay small enough to read.
+
 - **`gog-button` cannot be a link** — it renders its own `<button>`. Use `[gogButton]` on your own
   `<a>` instead; nothing is brokered through inputs, so `routerLink`, `href` and `target` keep
   working. That is also why this package needs no `@angular/router`.
@@ -500,4 +520,4 @@ Apache-2.0 © Roman Malitskyi
 Built-in icons are [Lucide](https://lucide.dev) glyphs, inlined so the package keeps zero runtime
 dependencies. Lucide is ISC licensed; portions are held by Cole Bemis 2013–2022 as part of
 Feather (MIT), all others by Lucide Contributors 2022 — full notice in
-`src/lib/shared/icons.ts`.
+`shared/icons.ts`.