@reblu/site-blocks 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @reblu/site-blocks
 
+## 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
+
+- e78229a: REB-853 — rename the `Specialty` organism to the niche-agnostic `ParentPage` (a page with a linked grid of child pages), with props `childPages`, `childPageHref` and `childPagesLabel`.
+
+  `Specialty` / `SpecialtyProps` and the props `treatments`, `treatmentHref` and `treatmentsLabel` remain as `@deprecated` aliases — `Specialty` is the same reference as `ParentPage`, so rendering is unchanged. They will be removed in the next major, not before 2027-03-31.
+
 ## 0.9.0
 
 ### Minor Changes

package/README.md

@@ -15,10 +15,11 @@ a different-looking site for every tenant, with zero forks.
 | `readingTime`, `formatPrice`, `buildShareUrls`, `markdownToSafeHtml`                                          | `.`        | Pure, framework-agnostic helpers (RSC-safe).                                                                                 |
 | `sanitizeHtml`                                                                                                | `.`        | Sanitises an HTML string before `dangerouslySetInnerHTML` — the **HTML boundary**. See "Security boundaries" below.          |
 | `MarkdownRenderer`                                                                                            | `.`        | Canonical Blog renderer: `marked` → **hast-util-sanitize** (XSS) → component map, with a YouTube-domain allowlist. RSC-safe. |
-| `Treatment`, `Specialty`, `ProfileCard`, `ProductCard`                                                        | `.`        | Presentational organisms over the SITE API contracts. RSC-safe.                                                              |
+| `Treatment`, `ParentPage`, `ProfileCard`, `ProductCard`                                                       | `.`        | Presentational organisms over the SITE API contracts. RSC-safe. `Specialty`: deprecated alias, see below.                    |
 | `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,108 @@ 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
+sections of a `PageDetail`, then an optional linked grid of its child pages
+(`PageListItem[]` — cover image, title, excerpt).
+
+```tsx
+import { ParentPage } from '@reblu/site-blocks'
+
+export function ServicesHub({ page, services }) {
+  return (
+    <ParentPage
+      page={page}
+      childPages={services}
+      childPageHref={(slug) => `/services/${slug}`}
+      childPagesLabel='Services'
+    />
+  )
+}
+```
+
+**Deprecated (REB-853) — removed in the next major, not before 2027-03-31:**
+
+| Deprecated        | Use instead       |
+| ----------------- | ----------------- |
+| `Specialty`       | `ParentPage`      |
+| `SpecialtyProps`  | `ParentPageProps` |
+| `treatments`      | `childPages`      |
+| `treatmentHref`   | `childPageHref`   |
+| `treatmentsLabel` | `childPagesLabel` |
+
+`Specialty` is the same component reference as `ParentPage`, not a copy, so
+existing code renders exactly as before. When a new prop and its deprecated
+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.
+
 ## Page blocks
 
 `PageBlocks` renders a page's registry blocks (`PageDetail.blocks` from