@reblu/site-blocks 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @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
+
+- c147a33: Add `ProductTrustItems` (REB-862): a plug-and-play Server Component that renders the store-wide trust messages from `ShopConfig.productTrustItems` (REB-858). Renders nothing when there is no data, skips items with an unknown icon or empty text, and never invents default claims. Ships `DEFAULT_TRUST_ICONS` (Lucide icons, bundled — no `lucide-react` needed in the SITE) with a per-icon `icons` override.
+
 ## 0.10.0
 
 ### Minor Changes

package/README.md

@@ -19,6 +19,7 @@ a different-looking site for every tenant, with zero forks.
 | `ShopFilters`                                                                                                 | `.`        | Plug-and-play shop filter chrome over `GET /api/site/shop/facets`. RSC-safe. See "Shop filters" below.                       |
 | `CartLineList`, `CartSummary`, `AddedToCartToast`, `CheckoutLoginPrompt`, `CheckoutForm`, `OrderConfirmation` | `.`        | Cart & checkout organisms. RSC-safe by construction. See "Cart & checkout" below.                                            |
 | `PageBlocks`, `FaqAccordion`                                                                                  | `.`        | Registry-block renderer (`PageDetail.blocks`) and native `<details>` FAQ. Server Components. See "Page blocks" below.        |
+| `ProductTrustItems`, `DEFAULT_TRUST_ICONS`                                                                    | `.`        | Store-wide trust messages from `ShopConfig.productTrustItems`. Server Component. See "Product trust items" below.            |
 | `buildFaqPageJsonLd`, `collectFaqItems`                                                                       | `./seo`    | schema.org `FAQPage` structured data. Directive-free (also on `.`). See "Page blocks" below.                                 |
 | `useCollection`                                                                                               | `./client` | Headless filterable/sortable/paginated collection hook (facets, category, tag, search). Serves both page and blog indexes.   |
 | `Collection`                                                                                                  | `./client` | Token-driven presentational grid over `useCollection`.                                                                       |
@@ -380,6 +381,71 @@ Every title/description is overridable via `labels` (see
 "`useShopOrderStatus` — the order-confirmation flow" for the full wiring
 recipe.
 
+## Product trust items
+
+`ProductTrustItems` renders the store-wide trust messages (shipping, returns,
+secure payment…) the owner configures in nexus and the API serves as
+`ShopConfig.productTrustItems` (REB-858). It is a Server Component — no
+`'use client'`, no hooks — so it works in a Server Component page and inside a
+Client Component alike. Drop it under the add-to-cart button:
+
+```tsx
+import { createRebluClient } from '@reblu/site-client'
+import { ProductTrustItems } from '@reblu/site-blocks'
+
+const client = createRebluClient({
+  baseUrl: 'https://api.reblu.app',
+  apiKey: process.env.REBLU_API_KEY!,
+})
+
+export default async function ProductPage() {
+  const shopConfig = await client.shop.config()
+  return (
+    <>
+      {/* …product, price, add-to-cart… */}
+      <ProductTrustItems items={shopConfig.productTrustItems} className='border-t pt-4' />
+    </>
+  )
+}
+```
+
+### Semantics — the API is the only source of claims
+
+- **No data, no block.** `null`, `undefined` or `[]` render nothing. The
+  component never invents default items.
+- **Unknown icons are skipped**, with no fallback icon. The contract is
+  forward-compatible (`icon: ShopProductTrustIcon | (string & {})`), so a newer
+  API may send an icon this version does not know; that item is dropped.
+- **Empty text is skipped** (whitespace-only included). If no item survives,
+  nothing is rendered — never an empty `<ul>`.
+- **Unknown item keys are ignored.**
+- Order is the configured order.
+
+### Markup and styling
+
+A semantic `<ul>` (or `<ol>` via `as='ol'`) of `<li>` rows; each icon is
+`aria-hidden` because the text carries the meaning. Colours come from theme
+tokens only (`text-muted-foreground`, `text-foreground/60`). `className` styles
+the list, `itemClassName` each row.
+
+### Overriding icons
+
+`DEFAULT_TRUST_ICONS` maps every `ShopProductTrustIcon` to a Lucide icon
+(`shipping`→Truck, `returns`→RotateCcw, `secure-payment`→ShieldCheck,
+`support`→Headset, `gift`→Gift, `pickup`→Store, `warranty`→BadgeCheck,
+`quality`→Award). They are bundled into this package, so the SITE needs no
+`lucide-react` of its own. Pass `icons` to replace any of them — the override is
+merged over the defaults and receives `className` and `aria-hidden`:
+
+```tsx
+import { Truck } from 'my-icon-set'
+
+<ProductTrustItems items={shopConfig.productTrustItems} icons={{ shipping: Truck }} />
+```
+
+`icons` cannot add a new icon key: an item whose `icon` this version does not
+know is still skipped.
+
 ## `ParentPage` (formerly `Specialty`)
 
 `ParentPage` renders a page that groups other pages: the hero and content
@@ -417,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