@reblu/site-blocks 0.9.0 → 0.11.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, BlockType, PageBlock, ResolvedEmbed, ShopFacets, ShopOrder } from '@reblu/site-contracts';
+import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, BlockType, PageBlock, ResolvedEmbed, ShopFacets, ShopOrder } from '@reblu/site-contracts';
 import { FaqItem } from './seo.cjs';
 export { FaqPageJsonLd, buildFaqPageJsonLd, collectFaqItems } from './seo.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -252,22 +252,50 @@ interface TreatmentProps {
 declare function Treatment({ page, className }: TreatmentProps): react_jsx_runtime.JSX.Element;
 
 /**
- * `Specialty` — specialty page organism over a `PageDetail`. Like `Treatment` it
- * renders a hero and content sections, but a specialty groups treatments, so it
- * also renders an optional grid of the treatment pages under it (links to each
- * treatment). Token-driven, RSC-safe.
+ * `ParentPage` — page organism over a `PageDetail` that groups other pages. Like
+ * `Treatment` it renders a hero and content sections, then an optional linked
+ * grid of its child pages (cover image, title, excerpt). Token-driven, RSC-safe.
+ *
+ * REB-853: formerly `Specialty`, which remains a deprecated alias.
  */
-interface SpecialtyProps {
+interface ParentPageProps {
     page: PageDetail;
-    /** Treatment pages under this specialty. Rendered as a linked grid when present. */
+    /** Child pages under this page. Rendered as a linked grid when present. */
+    childPages?: PageListItem[];
+    /** Builds the href for a child page from its slug. Defaults to `/{slug}`. */
+    childPageHref?: (slug: string) => string;
+    /** Heading for the child-pages grid. Defaults to "Treatments" (unchanged from `Specialty`). */
+    childPagesLabel?: string;
+    /**
+     * @deprecated Use `childPages`. Removed in the next major, not before 2027-03-31.
+     * Ignored when `childPages` is passed.
+     */
     treatments?: PageListItem[];
-    /** Builds the href for a treatment page from its slug. Defaults to `/{slug}`. */
+    /**
+     * @deprecated Use `childPageHref`. Removed in the next major, not before 2027-03-31.
+     * Ignored when `childPageHref` is passed.
+     */
     treatmentHref?: (slug: string) => string;
-    /** Heading for the treatments grid. Defaults to "Treatments". */
+    /**
+     * @deprecated Use `childPagesLabel`. Removed in the next major, not before 2027-03-31.
+     * Ignored when `childPagesLabel` is passed.
+     */
     treatmentsLabel?: string;
     className?: string;
 }
-declare function Specialty({ page, treatments, treatmentHref, treatmentsLabel, className, }: SpecialtyProps): react_jsx_runtime.JSX.Element;
+declare function ParentPage({ page, childPages, childPageHref, childPagesLabel, treatments, treatmentHref, treatmentsLabel, className, }: ParentPageProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * @deprecated Renamed to `ParentPage` (REB-853) — the SDK is niche-agnostic.
+ * Removed in the next major, not before 2027-03-31.
+ * Same reference as `ParentPage`, not a copy.
+ */
+declare const Specialty: typeof ParentPage;
+/**
+ * @deprecated Renamed to `ParentPageProps` (REB-853).
+ * Removed in the next major, not before 2027-03-31.
+ */
+type SpecialtyProps = ParentPageProps;
 
 /**
  * `ProfileCard` — presentational professional/team-member card (the clinic
@@ -304,6 +332,45 @@ interface ProductCardProps {
 }
 declare function ProductCard({ product, href, currencyCode, locale, className }: ProductCardProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * `ProductTrustItems` — the store-wide trust messages (shipping, returns, secure
+ * payment…) configured in nexus and served as `ShopConfig.productTrustItems`
+ * (REB-858). Drop it under the add-to-cart button of a product page (REB-862).
+ *
+ * Server Component, RSC-safe: no hooks, no state, no `'use client'`. The default
+ * icons are Lucide icons bundled into this package's artifact, so their
+ * server-evaluability does not depend on the consumer's `lucide-react` version.
+ *
+ * Semantics — the API is the only source of claims:
+ * - `null`, `undefined` or `[]` render NOTHING. No default items are ever invented.
+ * - An item whose `icon` is not one this version knows is SKIPPED (no fallback
+ *   icon): the contract is forward-compatible and a newer API may add icons.
+ * - An item with empty / whitespace-only `text` is skipped.
+ * - If no item survives, nothing is rendered — never an empty `<ul>`.
+ * - Unknown item keys are ignored.
+ */
+/** Props an icon component receives. Lucide icons and plain `<svg>` components both fit. */
+interface TrustIconProps {
+    className?: string;
+    'aria-hidden'?: boolean | 'true' | 'false';
+}
+type TrustIconComponent = ComponentType<TrustIconProps>;
+/** The default icon for every `ShopProductTrustIcon` of the current contract. */
+declare const DEFAULT_TRUST_ICONS: Readonly<Record<ShopProductTrustIcon, TrustIconComponent>>;
+interface ProductTrustItemsProps {
+    /** `ShopConfig.productTrustItems` as served — may be `null` / `undefined`. */
+    items: readonly ShopProductTrustItem[] | null | undefined;
+    /** Per-icon overrides merged over {@link DEFAULT_TRUST_ICONS}. Cannot add new icon keys. */
+    icons?: Partial<Record<ShopProductTrustIcon, TrustIconComponent>>;
+    /** List element. Defaults to `ul`. */
+    as?: 'ul' | 'ol';
+    /** Classes for the list element. */
+    className?: string;
+    /** Classes for each `<li>` row. */
+    itemClassName?: string;
+}
+declare function ProductTrustItems({ items, icons, as: List, className, itemClassName, }: ProductTrustItemsProps): react_jsx_runtime.JSX.Element | null;
+
 /** A heading level a caller can configure — `h1`…`h6`. */
 type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
 
@@ -838,4 +905,4 @@ interface OrderConfirmationProps {
 }
 declare function OrderConfirmation({ status, order, sessionId, cartHref, onRecheck, labels, currencyCode, locale, className, }: OrderConfirmationProps): react_jsx_runtime.JSX.Element;
 
-export { ALLOWED_YOUTUBE_HOSTS, AddedToCartToast, type AddedToCartToastLabels, type AddedToCartToastProps, type AddedToCartToastStatus, type BlockRendererProps, type CanonicalBlockType, type CartLineItemView, CartLineList, type CartLineListLabels, type CartLineListProps, CartSummary, type CartSummaryLabels, type CartSummaryProps, type CheckoutAppliedDiscount, type CheckoutContactErrors, type CheckoutContactValues, CheckoutForm, type CheckoutFormLabels, type CheckoutFormProps, CheckoutLoginPrompt, type CheckoutLoginPromptLabels, type CheckoutLoginPromptProps, DEFAULT_SHOP_ERROR_FALLBACK_MESSAGE, DEFAULT_SHOP_ERROR_MESSAGES, DEFAULT_SHOP_PRICE_BANDS, FaqAccordion, type FaqAccordionProps, FaqItem, type HeadingLevel, MarkdownRenderer, type MarkdownRendererProps, OrderConfirmation, type OrderConfirmationLabels, type OrderConfirmationOrder, type OrderConfirmationProps, type OrderConfirmationStatus, PageBlocks, type PageBlocksComponents, type PageBlocksProps, ProductCard, type ProductCardProps, ProfileCard, type ProfileCardProps, type RenderableBlock, SafeHtml, type SafeHtmlProps, type ShareUrls, type ShopFilterPriceBand, ShopFilters, type ShopFiltersActive, type ShopFiltersHrefs, type ShopFiltersLabels, type ShopFiltersProps, Specialty, type SpecialtyProps, Treatment, type TreatmentProps, buildShareUrls, formatPrice, getShopErrorMessage, isAllowedYouTubeHost, markdownToSafeHtml, readingTime, sanitizeHtml, shouldRenderShopFilters };
+export { ALLOWED_YOUTUBE_HOSTS, AddedToCartToast, type AddedToCartToastLabels, type AddedToCartToastProps, type AddedToCartToastStatus, type BlockRendererProps, type CanonicalBlockType, type CartLineItemView, CartLineList, type CartLineListLabels, type CartLineListProps, CartSummary, type CartSummaryLabels, type CartSummaryProps, type CheckoutAppliedDiscount, type CheckoutContactErrors, type CheckoutContactValues, CheckoutForm, type CheckoutFormLabels, type CheckoutFormProps, CheckoutLoginPrompt, type CheckoutLoginPromptLabels, type CheckoutLoginPromptProps, DEFAULT_SHOP_ERROR_FALLBACK_MESSAGE, DEFAULT_SHOP_ERROR_MESSAGES, DEFAULT_SHOP_PRICE_BANDS, DEFAULT_TRUST_ICONS, FaqAccordion, type FaqAccordionProps, FaqItem, type HeadingLevel, MarkdownRenderer, type MarkdownRendererProps, OrderConfirmation, type OrderConfirmationLabels, type OrderConfirmationOrder, type OrderConfirmationProps, type OrderConfirmationStatus, PageBlocks, type PageBlocksComponents, type PageBlocksProps, ParentPage, type ParentPageProps, ProductCard, type ProductCardProps, ProductTrustItems, type ProductTrustItemsProps, ProfileCard, type ProfileCardProps, type RenderableBlock, SafeHtml, type SafeHtmlProps, type ShareUrls, type ShopFilterPriceBand, ShopFilters, type ShopFiltersActive, type ShopFiltersHrefs, type ShopFiltersLabels, type ShopFiltersProps, Specialty, type SpecialtyProps, Treatment, type TreatmentProps, type TrustIconComponent, type TrustIconProps, buildShareUrls, formatPrice, getShopErrorMessage, isAllowedYouTubeHost, markdownToSafeHtml, readingTime, sanitizeHtml, shouldRenderShopFilters };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, BlockType, PageBlock, ResolvedEmbed, ShopFacets, ShopOrder } from '@reblu/site-contracts';
+import { ShopErrorCode, PageDetail, PageListItem, ShopProductListItem, ShopProductTrustIcon, ShopProductTrustItem, BlockType, PageBlock, ResolvedEmbed, ShopFacets, ShopOrder } from '@reblu/site-contracts';
 import { FaqItem } from './seo.js';
 export { FaqPageJsonLd, buildFaqPageJsonLd, collectFaqItems } from './seo.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -252,22 +252,50 @@ interface TreatmentProps {
 declare function Treatment({ page, className }: TreatmentProps): react_jsx_runtime.JSX.Element;
 
 /**
- * `Specialty` — specialty page organism over a `PageDetail`. Like `Treatment` it
- * renders a hero and content sections, but a specialty groups treatments, so it
- * also renders an optional grid of the treatment pages under it (links to each
- * treatment). Token-driven, RSC-safe.
+ * `ParentPage` — page organism over a `PageDetail` that groups other pages. Like
+ * `Treatment` it renders a hero and content sections, then an optional linked
+ * grid of its child pages (cover image, title, excerpt). Token-driven, RSC-safe.
+ *
+ * REB-853: formerly `Specialty`, which remains a deprecated alias.
  */
-interface SpecialtyProps {
+interface ParentPageProps {
     page: PageDetail;
-    /** Treatment pages under this specialty. Rendered as a linked grid when present. */
+    /** Child pages under this page. Rendered as a linked grid when present. */
+    childPages?: PageListItem[];
+    /** Builds the href for a child page from its slug. Defaults to `/{slug}`. */
+    childPageHref?: (slug: string) => string;
+    /** Heading for the child-pages grid. Defaults to "Treatments" (unchanged from `Specialty`). */
+    childPagesLabel?: string;
+    /**
+     * @deprecated Use `childPages`. Removed in the next major, not before 2027-03-31.
+     * Ignored when `childPages` is passed.
+     */
     treatments?: PageListItem[];
-    /** Builds the href for a treatment page from its slug. Defaults to `/{slug}`. */
+    /**
+     * @deprecated Use `childPageHref`. Removed in the next major, not before 2027-03-31.
+     * Ignored when `childPageHref` is passed.
+     */
     treatmentHref?: (slug: string) => string;
-    /** Heading for the treatments grid. Defaults to "Treatments". */
+    /**
+     * @deprecated Use `childPagesLabel`. Removed in the next major, not before 2027-03-31.
+     * Ignored when `childPagesLabel` is passed.
+     */
     treatmentsLabel?: string;
     className?: string;
 }
-declare function Specialty({ page, treatments, treatmentHref, treatmentsLabel, className, }: SpecialtyProps): react_jsx_runtime.JSX.Element;
+declare function ParentPage({ page, childPages, childPageHref, childPagesLabel, treatments, treatmentHref, treatmentsLabel, className, }: ParentPageProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * @deprecated Renamed to `ParentPage` (REB-853) — the SDK is niche-agnostic.
+ * Removed in the next major, not before 2027-03-31.
+ * Same reference as `ParentPage`, not a copy.
+ */
+declare const Specialty: typeof ParentPage;
+/**
+ * @deprecated Renamed to `ParentPageProps` (REB-853).
+ * Removed in the next major, not before 2027-03-31.
+ */
+type SpecialtyProps = ParentPageProps;
 
 /**
  * `ProfileCard` — presentational professional/team-member card (the clinic
@@ -304,6 +332,45 @@ interface ProductCardProps {
 }
 declare function ProductCard({ product, href, currencyCode, locale, className }: ProductCardProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * `ProductTrustItems` — the store-wide trust messages (shipping, returns, secure
+ * payment…) configured in nexus and served as `ShopConfig.productTrustItems`
+ * (REB-858). Drop it under the add-to-cart button of a product page (REB-862).
+ *
+ * Server Component, RSC-safe: no hooks, no state, no `'use client'`. The default
+ * icons are Lucide icons bundled into this package's artifact, so their
+ * server-evaluability does not depend on the consumer's `lucide-react` version.
+ *
+ * Semantics — the API is the only source of claims:
+ * - `null`, `undefined` or `[]` render NOTHING. No default items are ever invented.
+ * - An item whose `icon` is not one this version knows is SKIPPED (no fallback
+ *   icon): the contract is forward-compatible and a newer API may add icons.
+ * - An item with empty / whitespace-only `text` is skipped.
+ * - If no item survives, nothing is rendered — never an empty `<ul>`.
+ * - Unknown item keys are ignored.
+ */
+/** Props an icon component receives. Lucide icons and plain `<svg>` components both fit. */
+interface TrustIconProps {
+    className?: string;
+    'aria-hidden'?: boolean | 'true' | 'false';
+}
+type TrustIconComponent = ComponentType<TrustIconProps>;
+/** The default icon for every `ShopProductTrustIcon` of the current contract. */
+declare const DEFAULT_TRUST_ICONS: Readonly<Record<ShopProductTrustIcon, TrustIconComponent>>;
+interface ProductTrustItemsProps {
+    /** `ShopConfig.productTrustItems` as served — may be `null` / `undefined`. */
+    items: readonly ShopProductTrustItem[] | null | undefined;
+    /** Per-icon overrides merged over {@link DEFAULT_TRUST_ICONS}. Cannot add new icon keys. */
+    icons?: Partial<Record<ShopProductTrustIcon, TrustIconComponent>>;
+    /** List element. Defaults to `ul`. */
+    as?: 'ul' | 'ol';
+    /** Classes for the list element. */
+    className?: string;
+    /** Classes for each `<li>` row. */
+    itemClassName?: string;
+}
+declare function ProductTrustItems({ items, icons, as: List, className, itemClassName, }: ProductTrustItemsProps): react_jsx_runtime.JSX.Element | null;
+
 /** A heading level a caller can configure — `h1`…`h6`. */
 type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
 
@@ -838,4 +905,4 @@ interface OrderConfirmationProps {
 }
 declare function OrderConfirmation({ status, order, sessionId, cartHref, onRecheck, labels, currencyCode, locale, className, }: OrderConfirmationProps): react_jsx_runtime.JSX.Element;
 
-export { ALLOWED_YOUTUBE_HOSTS, AddedToCartToast, type AddedToCartToastLabels, type AddedToCartToastProps, type AddedToCartToastStatus, type BlockRendererProps, type CanonicalBlockType, type CartLineItemView, CartLineList, type CartLineListLabels, type CartLineListProps, CartSummary, type CartSummaryLabels, type CartSummaryProps, type CheckoutAppliedDiscount, type CheckoutContactErrors, type CheckoutContactValues, CheckoutForm, type CheckoutFormLabels, type CheckoutFormProps, CheckoutLoginPrompt, type CheckoutLoginPromptLabels, type CheckoutLoginPromptProps, DEFAULT_SHOP_ERROR_FALLBACK_MESSAGE, DEFAULT_SHOP_ERROR_MESSAGES, DEFAULT_SHOP_PRICE_BANDS, FaqAccordion, type FaqAccordionProps, FaqItem, type HeadingLevel, MarkdownRenderer, type MarkdownRendererProps, OrderConfirmation, type OrderConfirmationLabels, type OrderConfirmationOrder, type OrderConfirmationProps, type OrderConfirmationStatus, PageBlocks, type PageBlocksComponents, type PageBlocksProps, ProductCard, type ProductCardProps, ProfileCard, type ProfileCardProps, type RenderableBlock, SafeHtml, type SafeHtmlProps, type ShareUrls, type ShopFilterPriceBand, ShopFilters, type ShopFiltersActive, type ShopFiltersHrefs, type ShopFiltersLabels, type ShopFiltersProps, Specialty, type SpecialtyProps, Treatment, type TreatmentProps, buildShareUrls, formatPrice, getShopErrorMessage, isAllowedYouTubeHost, markdownToSafeHtml, readingTime, sanitizeHtml, shouldRenderShopFilters };
+export { ALLOWED_YOUTUBE_HOSTS, AddedToCartToast, type AddedToCartToastLabels, type AddedToCartToastProps, type AddedToCartToastStatus, type BlockRendererProps, type CanonicalBlockType, type CartLineItemView, CartLineList, type CartLineListLabels, type CartLineListProps, CartSummary, type CartSummaryLabels, type CartSummaryProps, type CheckoutAppliedDiscount, type CheckoutContactErrors, type CheckoutContactValues, CheckoutForm, type CheckoutFormLabels, type CheckoutFormProps, CheckoutLoginPrompt, type CheckoutLoginPromptLabels, type CheckoutLoginPromptProps, DEFAULT_SHOP_ERROR_FALLBACK_MESSAGE, DEFAULT_SHOP_ERROR_MESSAGES, DEFAULT_SHOP_PRICE_BANDS, DEFAULT_TRUST_ICONS, FaqAccordion, type FaqAccordionProps, FaqItem, type HeadingLevel, MarkdownRenderer, type MarkdownRendererProps, OrderConfirmation, type OrderConfirmationLabels, type OrderConfirmationOrder, type OrderConfirmationProps, type OrderConfirmationStatus, PageBlocks, type PageBlocksComponents, type PageBlocksProps, ParentPage, type ParentPageProps, ProductCard, type ProductCardProps, ProductTrustItems, type ProductTrustItemsProps, ProfileCard, type ProfileCardProps, type RenderableBlock, SafeHtml, type SafeHtmlProps, type ShareUrls, type ShopFilterPriceBand, ShopFilters, type ShopFiltersActive, type ShopFiltersHrefs, type ShopFiltersLabels, type ShopFiltersProps, Specialty, type SpecialtyProps, Treatment, type TreatmentProps, type TrustIconComponent, type TrustIconProps, buildShareUrls, formatPrice, getShopErrorMessage, isAllowedYouTubeHost, markdownToSafeHtml, readingTime, sanitizeHtml, shouldRenderShopFilters };