@reblu/site-blocks 0.31.0 → 0.32.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @reblu/site-blocks
 
+## 0.32.0
+
+### Minor Changes
+
+- 93143eb: Reviews (REB-1272). `@reblu/site-contracts` exports the `Review` and `ReviewSource` types of `GET /api/site/reviews`. `@reblu/site-client` adds `client.reviews.list({ pageId?, limit? }, cache?)`: the tenant's published reviews in the order set in nexus, optionally only one page's (404 without the tenant's `reviews` module). `@reblu/site-blocks` adds `Reviews`, a Server Component drop-in: a responsive grid with an accessible star rating, the author, the date, the text and a «Ver en <fuente>» link to the original (new tab, `rel="noopener nofollow"`), plus an optional tenant `notice` above or below the grid. Every existing export and namespace is unchanged.
+
+### Patch Changes
+
+- Updated dependencies [25a6af3]
+- Updated dependencies [93143eb]
+  - @reblu/site-contracts@1.30.0
+
 ## 0.31.0
 
 ### Minor Changes

package/README.md

@@ -36,6 +36,7 @@ colour on the red background. See `docs/theming/theming.md`.
 | `ProductTrustItems`, `DEFAULT_TRUST_ICONS`                                                                    | `.`        | Store-wide trust messages from `ShopConfig.productTrustItems`. Server Component. See "Product trust items" below.            |
 | `TrustBadges`, `DEFAULT_TRUST_BADGE_HEADINGS`                                                                 | `.`        | The tenant's trust badges from `client.trustBadges.list()`, grouped by type. Server Component. See "Trust badges" below.     |
 | `ArbitrationBadge`                                                                                            | `.`        | The consumer-arbitration distinctive with its adhesion number, for the footer. Server Component. See "Consumer arbitration badge" below. |
+| `Reviews`                                                                                                     | `.`        | The tenant's published, verifiable reviews from `client.reviews.list()`. Server Component. See "Reviews" 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`.                                                                       |
@@ -927,6 +928,56 @@ import { Truck } from 'my-icon-set'
 `icons` cannot add a new icon key: an item whose `icon` this version does not
 know is still skipped.
 
+## Reviews
+
+`Reviews` (REB-1272) renders the tenant's published reviews, managed in nexus
+(«Reseñas») and served by `client.reviews.list()`: a responsive grid of cards
+with the stars, the text, the author, the date and a «Ver en Google» link to
+the original review. Publishing, hiding or reordering a review in nexus changes
+the SITE on the next revalidation, with no deploy.
+
+```tsx
+import { Reviews } from '@reblu/site-blocks'
+
+export async function HomeReviews() {
+  const { data: reviews } = await client.reviews
+    .list({ limit: 6 }, { revalidate: 3600 })
+    .catch(() => ({ data: [] }))
+  return (
+    <Reviews
+      reviews={reviews}
+      heading='Reseñas verificadas'
+      notice='Reseñas publicadas en Google y Doctoralia; cada una enlaza a su original.'
+    />
+  )
+}
+
+// Only the reviews linked to one page (a treatment, a professional's profile):
+const { data: pageReviews } = await client.reviews.list({ pageId: page.id })
+```
+
+- **Verifiable or not shown.** A review renders only with an `https://` link to
+  its original, a rating of 1 to 5 and an author; anything else is skipped.
+  The link opens in a new tab with `rel="noopener nofollow"` and a visually
+  hidden «(se abre en una pestaña nueva)» (`newWindowLabel`). Its text is
+  `linkLabel(sourceName)`, «Ver en Google» by default.
+- **Notice.** `notice` is the tenant's short text on how its reviews are
+  checked. Spanish consumer law asks a business that shows reviews to say
+  whether and how it ensures they come from real customers; the exact wording
+  is the tenant's (pending legal review, REB-136). It goes below the grid, or
+  above it with `noticePosition='above'`.
+- Stars are one `role="img"` labelled «5 de 5 estrellas». A star-only review
+  (`text: null`) renders without a quote. The date is the calendar day the
+  review was written, formatted in `locale` (default `es-ES`), never shifted
+  by the visitor's time zone.
+- `null`, `undefined` or an empty list render nothing — no heading, no notice.
+- `heading` wraps everything in a `<section aria-labelledby={headingId}>`
+  (default id `reviews-heading`, level `headingLevel`, default 2).
+- Styling hooks: `className`, `cardClassName` (merge with `cn`);
+  `headingClassName`, `gridClassName` and `noticeClassName` follow the REB-997
+  slot rule and REPLACE their defaults (`text-xl font-semibold`,
+  `sm:grid-cols-2 lg:grid-cols-3`, `text-sm text-muted-foreground`).
+
 ## Trust badges
 
 `TrustBadges` renders the tenant's trust badges — partners, insurers, funding,