@reblu/site-blocks 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @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

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