@reblu/site-blocks 0.11.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @reblu/site-blocks
 
+## 0.12.0
+
+### Minor Changes
+
+- 7a00471: Featured pages per page category (REB-869). `@reblu/site-contracts` adds `PagesListQuery`, the query of `GET /api/site/pages`, including the new `featured` flag. `@reblu/site-client`: `pages.list({ category, featured: true })` returns that category's featured pages (max 3) in the tenant's order, skipping unpublished, deleted or moved pages, and an empty list when nothing is featured; the new `pages.featured(category, { limit?, fallback?, cache? })` helper returns the featured pages, or the category's first `limit` pages in normal order when none are featured, so a landing teaser is never empty. `limit` must be an integer >= 1: above 3 it is clamped to 3; 0, negative, fractional or NaN throw a `RangeError` before any request. Against an API that predates `featured`, the flag is ignored and `pages.featured()` silently degrades to the category's first `limit` pages. `@reblu/site-blocks` adds `PageCardGrid`, the page-card grid `ParentPage` already rendered for its child pages, as a drop-in (`pages`, `pageHref`, `heading`); cards are keyed by category + slug, an empty `heading` renders no `<h2>`. `ParentPage` now renders through it with unchanged markup (including the empty `<h2>` for `childPagesLabel=''`).
+
+### Patch Changes
+
+- Updated dependencies [7a00471]
+  - @reblu/site-contracts@1.13.0
+
 ## 0.11.0
 
 ### Minor Changes

package/README.md

@@ -483,6 +483,30 @@ counterpart are both passed, the new one wins. The default grid heading stays
 `"Treatments"` and the root keeps `data-slot="specialty"` until that major, so
 the rename changes no markup — pass `childPagesLabel` to set your own heading.
 
+## `PageCardGrid` — featured pages teaser (REB-869)
+
+The linked page-card grid `ParentPage` uses for its child pages, as a
+standalone drop-in over any `PageListItem[]`, rendered in the order given (and
+nothing at all for an empty list). Its natural feed is
+`client.pages.featured(category)` from `@reblu/site-client`: the up-to-3 pages
+the tenant featured on that category in nexus («Destacadas en la portada»), in
+the tenant's order — or the category's first pages when none are featured yet.
+
+```tsx
+import { PageCardGrid } from '@reblu/site-blocks'
+
+export async function ServicesTeaser() {
+  const pages = await client.pages.featured('servicios')
+  return (
+    <PageCardGrid
+      pages={pages}
+      heading='Servicios'
+      pageHref={(page) => `/${page.category?.slug}/${page.slug}`} // default: `/${slug}`
+    />
+  )
+}
+```
+
 ## Page blocks
 
 `PageBlocks` renders a page's registry blocks (`PageDetail.blocks` from