@reblu/site-blocks 0.11.0 → 0.12.1

package/dist/index.d.cts

@@ -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.
@@ -732,13 +752,20 @@ declare function AddedToCartToast({ status, productName, quantity, imageUrl, car
 /**
  * `CheckoutLoginPrompt` — the "login prompt hook" the checkout flow needs
  * (REB-829): a guest-checkout identification dialog offering "continue with
- * this email" (so the SITE can check for an existing account via
- * `client.shop.checkEmail`) or "continue as guest" outright. Fully
- * controlled/presentational — it performs NO fetch itself (unlike
- * demo-site's original `CheckoutLoginModal`, which called
- * `/api/shop/check-email` internally); the consuming SITE owns `email`
- * state and the `checkEmail` call, and drives `checking`/`error` from its
- * own result.
+ * this email" or "continue as guest" outright. Fully controlled/presentational
+ * — it performs NO fetch itself; the consuming SITE owns `email` state and
+ * decides what `onSubmitEmail` does.
+ *
+ * Never reveal whether an account exists (REB-834). Do NOT wire
+ * `onSubmitEmail` to `client.shop.checkEmail` (deprecated, it always answers
+ * `{ exists: false }`) or build any UI on an `exists` answer. Treat both
+ * actions the same way for every email: `onSubmitEmail` carries the typed
+ * email into the checkout (or into the SITE's own login page), and
+ * `onContinueAsGuest` proceeds without it. If a guest's email belongs to an
+ * account, the server links the order to it after payment — the browser is
+ * never told before. `checking`/`error` remain for a SITE's own synchronous
+ * work (e.g. saving the email to its checkout state); leave them unset
+ * otherwise.
  */
 interface CheckoutLoginPromptLabels {
     title: string;
@@ -773,6 +800,13 @@ declare function CheckoutLoginPrompt({ open, email, onEmailChange, onClose, onSu
  * dependency surface minimal); the consuming SITE owns validation and wires
  * its own `onSubmit`.
  *
+ * Account handling (REB-834): render the same form for every email. The
+ * `loginPrompt` slot is a static «Iniciar sesión o continuar como invitado»
+ * offer — never a branch on whether the typed email has an account (the
+ * deprecated `client.shop.checkEmail` always answers `{ exists: false }`). If
+ * a guest's email belongs to an account, the server links the order to it
+ * after payment.
+ *
  * Scope note: shipping/billing address collection is intentionally OUT of
  * this component — those field sets vary by tenant shop config (shipping
  * enabled/disabled, invoicing requirements) far more than the guest-email +
@@ -905,4 +939,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, 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 };
+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

@@ -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.
@@ -732,13 +752,20 @@ declare function AddedToCartToast({ status, productName, quantity, imageUrl, car
 /**
  * `CheckoutLoginPrompt` — the "login prompt hook" the checkout flow needs
  * (REB-829): a guest-checkout identification dialog offering "continue with
- * this email" (so the SITE can check for an existing account via
- * `client.shop.checkEmail`) or "continue as guest" outright. Fully
- * controlled/presentational — it performs NO fetch itself (unlike
- * demo-site's original `CheckoutLoginModal`, which called
- * `/api/shop/check-email` internally); the consuming SITE owns `email`
- * state and the `checkEmail` call, and drives `checking`/`error` from its
- * own result.
+ * this email" or "continue as guest" outright. Fully controlled/presentational
+ * — it performs NO fetch itself; the consuming SITE owns `email` state and
+ * decides what `onSubmitEmail` does.
+ *
+ * Never reveal whether an account exists (REB-834). Do NOT wire
+ * `onSubmitEmail` to `client.shop.checkEmail` (deprecated, it always answers
+ * `{ exists: false }`) or build any UI on an `exists` answer. Treat both
+ * actions the same way for every email: `onSubmitEmail` carries the typed
+ * email into the checkout (or into the SITE's own login page), and
+ * `onContinueAsGuest` proceeds without it. If a guest's email belongs to an
+ * account, the server links the order to it after payment — the browser is
+ * never told before. `checking`/`error` remain for a SITE's own synchronous
+ * work (e.g. saving the email to its checkout state); leave them unset
+ * otherwise.
  */
 interface CheckoutLoginPromptLabels {
     title: string;
@@ -773,6 +800,13 @@ declare function CheckoutLoginPrompt({ open, email, onEmailChange, onClose, onSu
  * dependency surface minimal); the consuming SITE owns validation and wires
  * its own `onSubmit`.
  *
+ * Account handling (REB-834): render the same form for every email. The
+ * `loginPrompt` slot is a static «Iniciar sesión o continuar como invitado»
+ * offer — never a branch on whether the typed email has an account (the
+ * deprecated `client.shop.checkEmail` always answers `{ exists: false }`). If
+ * a guest's email belongs to an account, the server links the order to it
+ * after payment.
+ *
  * Scope note: shipping/billing address collection is intentionally OUT of
  * this component — those field sets vary by tenant shop config (shipping
  * enabled/disabled, invoicing requirements) far more than the guest-email +
@@ -905,4 +939,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, 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 };
+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 };