ng-hub-ui-paginable 21.2.0 → 22.0.0

package/README.md

@@ -1,5 +1,15 @@
 # ng-hub-ui-paginable
 
+[Español](./README.es.md) | **English**
+
+## Documentation and Live Examples
+
+This package is part of [Hub UI](https://hubui.dev/), a collection of Angular component libraries for standalone apps.
+
+- Docs: https://hubui.dev/paginable/overview/
+- Live examples: https://hubui.dev/paginable/examples/
+- Hub UI: https://hubui.dev/
+
 ## 🧩 Library Family `ng-hub-ui`
 
 This library is part of the **ng-hub-ui** ecosystem:
@@ -10,9 +20,13 @@ This library is part of the **ng-hub-ui** ecosystem:
 - [**ng-hub-ui-board**](https://www.npmjs.com/package/ng-hub-ui-board)
 - [**ng-hub-ui-breadcrumbs**](https://www.npmjs.com/package/ng-hub-ui-breadcrumbs)
 - [**ng-hub-ui-calendar**](https://www.npmjs.com/package/ng-hub-ui-calendar)
+- [**ng-hub-ui-dropdown**](https://www.npmjs.com/package/ng-hub-ui-dropdown)
+- [**ng-hub-ui-history**](https://www.npmjs.com/package/ng-hub-ui-history)
 - [**ng-hub-ui-modal**](https://www.npmjs.com/package/ng-hub-ui-modal)
+- [**ng-hub-ui-nav**](https://www.npmjs.com/package/ng-hub-ui-nav)
 - [**ng-hub-ui-paginable**](https://www.npmjs.com/package/ng-hub-ui-paginable) ← You are here
 - [**ng-hub-ui-portal**](https://www.npmjs.com/package/ng-hub-ui-portal)
+- [**ng-hub-ui-sortable**](https://www.npmjs.com/package/ng-hub-ui-sortable)
 - [**ng-hub-ui-stepper**](https://www.npmjs.com/package/ng-hub-ui-stepper)
 - [**ng-hub-ui-utils**](https://www.npmjs.com/package/ng-hub-ui-utils)
 
@@ -115,8 +129,8 @@ This library arises from the need to offer highly configurable, accessible, and
 
 All components are built as standalone Angular components with full Angular Signals support.
 
-> ⚠️ **Breaking changes in v21.2.0**
-> This major release removes the `color` property from `PaginableActionButton` and unifies action button contracts.
+> ⚠️ **Breaking changes in v22.0.0**
+> This major release restructures the List CSS API (the `.hub-list` block moves to the host, the `<ul>` becomes `.hub-list__items`), renames the `--hub-list-container-*` variables, and removes the non-functional `--hub-table-breakpoint-*` variables. `peerDependencies` stays at `>=18.0.0`, so Angular 18–22 remain supported.
 > Review migration steps in [BREAKING_CHANGES.md](./BREAKING_CHANGES.md) before upgrading.
 
 ---
@@ -402,6 +416,24 @@ export class ExampleComponent {
 </hub-ui-list>
 ```
 
+### List Component as Cards
+
+Use the same component with `options.display = 'cards'` when you want a card-based root layout while keeping nested children rendered as a regular hierarchical list.
+
+```html
+<hub-ui-list
+	[items]="products()"
+	[bindLabel]="'name'"
+	[bindChildren]="'children'"
+	[options]="{
+		display: 'cards',
+		searchable: true,
+		collapsed: true
+	}"
+>
+</hub-ui-list>
+```
+
 ### Standalone Paginator
 
 ```html
@@ -1056,6 +1088,8 @@ interface ListClickEvent<T> {
 }
 ```
 
+`options.display` accepts `'list' | 'cards'`. The `cards` mode only affects the root level of the list component.
+
 ### Paginator Component (`<hub-ui-paginator>`)
 
 #### Inputs
@@ -2209,6 +2243,27 @@ export class AppComponent {
 
 ## 📊 Changelog
 
+## [22.0.0] - 2026-06-17
+
+### Changed
+
+- **List:** the BEM block now lives on the host element. The host `hub-list` carries the `.hub-list` block class and the `<ul>` becomes the `.hub-list__items` element (modifiers `.hub-list__items--root` / `--cards`). Backgrounds are controlled via `--hub-list-bg` (host) and `--hub-list-item-bg` (items), both defaulting to a transparent host / surface items.
+
+### Added
+
+- **List:** `--hub-list-gap`, `--hub-list-items-bg` and `--hub-list-item-bg` CSS variables.
+
+### Fixed
+
+- **List:** the card CSS variables (`--hub-list-cards-*`) were documented and overridable but never applied — they now take effect.
+- **Paginator:** `--hub-paginator-font-size` is now actually applied.
+- **Docs:** CSS variables reference corrected (fixed the `--hub-table-table-*` doubled-prefix typo, documented the table search block) and brought to full EN/ES parity.
+
+### Removed
+
+- **Breaking — List:** renamed `--hub-list-container-*` variables to `--hub-list-bg` / `--hub-list-border-radius` / `--hub-list-padding-x/y` / `--hub-list-items-gap`, and the `.hub-list` / `.hub-list--root` / `.hub-list--cards` selectors were restructured (see the Changed note above).
+- **Table:** removed the non-functional `--hub-table-breakpoint-*` variables (responsive breakpoints are fixed and cannot be overridden via CSS variables).
+
 ## [19.10.2] - 2025-12-23
 
 ### Added
@@ -2286,7 +2341,7 @@ Do you like this library? You can support us by buying us a coffee ☕:
 
 Thanks to all contributors who have helped make this library better!
 
-- **Carlos Morcillo Fernández** - _Creator & Maintainer_ - [@carlos-morcillo](https://github.com/carlos-morcillo)
+- **[Carlos Morcillo Fernández](https://www.carlosmorcillo.com)** - _Creator & Maintainer_ - [@carlos-morcillo](https://github.com/carlos-morcillo)
 
 ## 📄 License