@reblu/site-blocks 0.10.0 → 0.12.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';
@@ -285,6 +285,26 @@ interface ParentPageProps {
 }
 declare function ParentPage({ page, childPages, childPageHref, childPagesLabel, treatments, treatmentHref, treatmentsLabel, className, }: ParentPageProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * `PageCardGrid` — a linked grid of page cards (cover image, title, excerpt)
+ * over any `PageListItem[]`, in the order given. Token-driven, RSC-safe.
+ *
+ * REB-869: extracted from `ParentPage`'s child-pages grid (same markup) so a
+ * SITE can drop it in anywhere — typically a landing teaser over
+ * `client.pages.featured(category)`, which returns the category's featured
+ * pages in the tenant's order, or its first pages when none are featured.
+ * Renders nothing for an empty list.
+ */
+interface PageCardGridProps {
+    pages: PageListItem[];
+    /** Builds a card's href from its page. Defaults to `/{slug}`. */
+    pageHref?: (page: PageListItem) => string;
+    /** Optional `<h2>` above the grid. */
+    heading?: string;
+    className?: string;
+}
+declare function PageCardGrid(props: PageCardGridProps): 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.
@@ -332,6 +352,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;
 
@@ -866,4 +925,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, ParentPage, type ParentPageProps, 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, PageCardGrid, type PageCardGridProps, 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';
@@ -285,6 +285,26 @@ interface ParentPageProps {
 }
 declare function ParentPage({ page, childPages, childPageHref, childPagesLabel, treatments, treatmentHref, treatmentsLabel, className, }: ParentPageProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * `PageCardGrid` — a linked grid of page cards (cover image, title, excerpt)
+ * over any `PageListItem[]`, in the order given. Token-driven, RSC-safe.
+ *
+ * REB-869: extracted from `ParentPage`'s child-pages grid (same markup) so a
+ * SITE can drop it in anywhere — typically a landing teaser over
+ * `client.pages.featured(category)`, which returns the category's featured
+ * pages in the tenant's order, or its first pages when none are featured.
+ * Renders nothing for an empty list.
+ */
+interface PageCardGridProps {
+    pages: PageListItem[];
+    /** Builds a card's href from its page. Defaults to `/{slug}`. */
+    pageHref?: (page: PageListItem) => string;
+    /** Optional `<h2>` above the grid. */
+    heading?: string;
+    className?: string;
+}
+declare function PageCardGrid(props: PageCardGridProps): 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.
@@ -332,6 +352,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;
 
@@ -866,4 +925,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, ParentPage, type ParentPageProps, 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, PageCardGrid, type PageCardGridProps, 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 };