@reblu/site-blocks 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @reblu/site-blocks
 
+## 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,7 +15,7 @@ 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.        |
@@ -380,6 +380,43 @@ Every title/description is overridable via `labels` (see
 "`useShopOrderStatus` — the order-confirmation flow" for the full wiring
 recipe.
 
+## `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

package/dist/index.cjs

@@ -33,6 +33,7 @@ __export(src_exports, {
   MarkdownRenderer: () => MarkdownRenderer,
   OrderConfirmation: () => OrderConfirmation,
   PageBlocks: () => PageBlocks,
+  ParentPage: () => ParentPage,
   ProductCard: () => ProductCard,
   ProfileCard: () => ProfileCard,
   SafeHtml: () => SafeHtml,
@@ -13371,25 +13372,32 @@ function Treatment({ page, className }) {
   ] });
 }
 
-// src/components/specialty.tsx
+// src/components/parent-page.tsx
 var import_utils4 = require("@reblu/site-ui/utils");
 var import_jsx_runtime4 = require("react/jsx-runtime");
-function Specialty({
+var defaultChildPageHref = (slug) => `/${slug}`;
+function ParentPage({
   page,
-  treatments = [],
-  treatmentHref = (slug) => `/${slug}`,
-  treatmentsLabel = "Treatments",
+  childPages,
+  childPageHref,
+  childPagesLabel,
+  treatments,
+  treatmentHref,
+  treatmentsLabel,
   className
 }) {
+  const pages = childPages ?? treatments ?? [];
+  const hrefFor = childPageHref ?? treatmentHref ?? defaultChildPageHref;
+  const label = childPagesLabel ?? treatmentsLabel ?? "Treatments";
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("article", { className: (0, import_utils4.cn)("space-y-12", className), "data-slot": "specialty", children: [
     /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PageHero, { page }),
     /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PageSectionList, { sections: page.sections }),
-    treatments.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("section", { className: "space-y-6", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("h2", { className: "text-2xl font-bold", children: treatmentsLabel }),
-      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("ul", { className: "grid list-none grid-cols-1 gap-6 p-0 sm:grid-cols-2 lg:grid-cols-3", children: treatments.map((t) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("li", { children: /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
+    pages.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("section", { className: "space-y-6", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("h2", { className: "text-2xl font-bold", children: label }),
+      /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("ul", { className: "grid list-none grid-cols-1 gap-6 p-0 sm:grid-cols-2 lg:grid-cols-3", children: pages.map((t) => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("li", { children: /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(
         "a",
         {
-          href: treatmentHref(t.slug),
+          href: hrefFor(t.slug),
           className: "group flex h-full flex-col overflow-hidden rounded-lg border bg-card transition-shadow hover:shadow-lg",
           children: [
             t.coverImageUrl && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "relative aspect-video overflow-hidden bg-muted", children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
@@ -13412,6 +13420,9 @@ function Specialty({
   ] });
 }
 
+// src/components/specialty.tsx
+var Specialty = ParentPage;
+
 // src/components/profile-card.tsx
 var import_utils5 = require("@reblu/site-ui/utils");
 var import_jsx_runtime5 = require("react/jsx-runtime");
@@ -14640,6 +14651,7 @@ function OrderConfirmation({
   MarkdownRenderer,
   OrderConfirmation,
   PageBlocks,
+  ParentPage,
   ProductCard,
   ProfileCard,
   SafeHtml,