ng-hub-ui-paginable 21.3.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.
 
 ---
@@ -2229,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
@@ -2306,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