@reblu/site-blocks 0.5.0 → 0.6.0

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PageDetail, PageListItem, ShopProductListItem, ShopFacets } from '@reblu/site-contracts';
+import { PageDetail, PageListItem, ShopProductListItem, ShopFacets, ShopOrder } from '@reblu/site-contracts';
+import { ReactNode, FormEvent } from 'react';
 
 declare function readingTime(content: string | null | undefined): number | null;
 
@@ -383,4 +384,275 @@ interface ShopFiltersProps {
 declare function shouldRenderShopFilters(facets: ShopFacets, active?: ShopFiltersActive): boolean;
 declare function ShopFilters({ facets, hrefs, active, onChange, priceBands, labels, currencyCode, locale, className, }: ShopFiltersProps): react_jsx_runtime.JSX.Element | null;
 
-export { ALLOWED_YOUTUBE_HOSTS, DEFAULT_SHOP_PRICE_BANDS, MarkdownRenderer, type MarkdownRendererProps, ProductCard, type ProductCardProps, ProfileCard, type ProfileCardProps, SafeHtml, type SafeHtmlProps, type ShareUrls, type ShopFilterPriceBand, ShopFilters, type ShopFiltersActive, type ShopFiltersHrefs, type ShopFiltersLabels, type ShopFiltersProps, Specialty, type SpecialtyProps, Treatment, type TreatmentProps, buildShareUrls, formatPrice, isAllowedYouTubeHost, markdownToSafeHtml, readingTime, sanitizeHtml, shouldRenderShopFilters };
+/**
+ * `AddToCartButton` — presentational add-to-cart CTA (REB-829). RSC-safe by
+ * construction (same contract as `ShopFilters`'s `OptionLink`): passing
+ * `onAddToCart` only makes sense from a Client Component, but the component
+ * itself carries no `'use client'` directive, so a Server Component may
+ * still render it WITHOUT the prop (e.g. a disabled preview state).
+ */
+interface AddToCartButtonLabels {
+    add: string;
+    adding: string;
+    outOfStock: string;
+}
+interface AddToCartButtonProps {
+    onAddToCart?: () => void;
+    disabled?: boolean;
+    outOfStock?: boolean;
+    /** True while the add-to-cart call (or a navigation it triggers) is in flight. */
+    pending?: boolean;
+    labels?: Partial<AddToCartButtonLabels>;
+    className?: string;
+}
+declare function AddToCartButton({ onAddToCart, disabled, outOfStock, pending, labels, className, }: AddToCartButtonProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * `CartIcon` — presentational cart badge/link (REB-829). RSC-safe (plain
+ * `<a href>`, no hooks) — a Server Component can render it directly with a
+ * value already computed server-side; a Client Component drives `itemCount`
+ * from `@reblu/site-next/cart`'s `useCart().itemCount`.
+ */
+interface CartIconLabels {
+    cart: string;
+    itemsSuffix: (count: number) => string;
+}
+interface CartIconProps {
+    itemCount: number;
+    href: string;
+    labels?: Partial<CartIconLabels>;
+    className?: string;
+}
+declare function CartIcon({ itemCount, href, labels, className }: CartIconProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * `CartLineList` — presentational cart lines (REB-829), container/
+ * presentational split: it takes `items` + optional `onQuantityChange`/
+ * `onRemove` callbacks, never fetches or owns cart state itself. The
+ * consuming SITE wires these to `@reblu/site-next/cart`'s `useCart()`.
+ *
+ * RSC-safe by construction (same `OptionLink` contract as `ShopFilters`):
+ * the quantity stepper/remove buttons only do anything when `onQuantityChange`/
+ * `onRemove` are supplied from a Client Component — omit them from a Server
+ * Component to render a read-only summary instead.
+ */
+interface CartLineItemView {
+    productId: string;
+    variantId?: string | null;
+    name: string;
+    variantName?: string;
+    /** Integer cents. */
+    unitPrice: number;
+    quantity: number;
+    imageUrl?: string;
+    /** `null`/`undefined` = untracked stock — never clamps the stepper's max. */
+    maxStock?: number | null;
+}
+interface CartLineListLabels {
+    quantityLabel: string;
+    decrease: string;
+    increase: string;
+    remove: string;
+    unitPriceSuffix: string;
+}
+interface CartLineListProps {
+    items: CartLineItemView[];
+    onQuantityChange?: (productId: string, variantId: string | null | undefined, quantity: number) => void;
+    onRemove?: (productId: string, variantId: string | null | undefined) => void;
+    /**
+     * A visually-hidden `aria-live="polite"` announcement (e.g. "Cantidad
+     * actualizada", "Producto eliminado del carrito") — the consuming SITE
+     * decides WHEN to set it (after a successful mutation), this component
+     * only renders the live region.
+     */
+    liveMessage?: string;
+    labels?: Partial<CartLineListLabels>;
+    currencyCode?: string;
+    locale?: string;
+    className?: string;
+}
+declare function CartLineList({ items, onQuantityChange, onRemove, liveMessage, labels, currencyCode, locale, className, }: CartLineListProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * `CartSummary` — presentational price breakdown (REB-829): subtotal,
+ * optional discount, optional shipping (sourced from `ShopConfig` by the
+ * consuming SITE — this component only renders what it's given), and total.
+ * Pure data in, RSC-safe (no hooks, no callbacks).
+ */
+interface CartSummaryLabels {
+    subtotal: string;
+    discountPrefix: string;
+    shipping: string;
+    freeShipping: string;
+    /**
+     * Shown when `shipping` is `null`/`undefined` (unknown yet) — REB-829
+     * review finding: this is NOT the same state as `0` (confirmed free).
+     * Claiming "free shipping" for an amount the SITE simply hasn't computed
+     * yet understates the real total and is reversed at checkout.
+     */
+    shippingCalculated: string;
+    total: string;
+}
+interface CartSummaryProps {
+    /** Integer cents. */
+    subtotal: number;
+    /** Integer cents, positive. Omit (or `0`) to hide the discount line. */
+    discount?: number;
+    /** The applied discount code, shown next to the discount amount. */
+    discountCode?: string;
+    /** Integer cents. Only rendered when `shippingEnabled` is true. */
+    shipping?: number | null;
+    /** Whether this tenant's shop even has shipping cost — hides the line entirely when false/omitted. */
+    shippingEnabled?: boolean;
+    /** Integer cents — the final charged amount. */
+    total: number;
+    labels?: Partial<CartSummaryLabels>;
+    currencyCode?: string;
+    locale?: string;
+    className?: string;
+}
+declare function CartSummary({ subtotal, discount, discountCode, shipping, shippingEnabled, total, labels, currencyCode, locale, className, }: CartSummaryProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * `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.
+ */
+interface CheckoutLoginPromptLabels {
+    title: string;
+    description: string;
+    emailLabel: string;
+    emailPlaceholder: string;
+    continueWithEmail: string;
+    checking: string;
+    continueAsGuest: string;
+    close: string;
+}
+interface CheckoutLoginPromptProps {
+    open: boolean;
+    email: string;
+    onEmailChange: (value: string) => void;
+    onClose: () => void;
+    /** Called when the visitor confirms a (valid-looking) email. */
+    onSubmitEmail: () => void;
+    onContinueAsGuest: () => void;
+    checking?: boolean;
+    error?: string | null;
+    labels?: Partial<CheckoutLoginPromptLabels>;
+    className?: string;
+}
+declare function CheckoutLoginPrompt({ open, email, onEmailChange, onClose, onSubmitEmail, onContinueAsGuest, checking, error, labels, className, }: CheckoutLoginPromptProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * `CheckoutForm` — presentational guest-checkout form (REB-829): contact
+ * fields, a discount-code section, an optional `loginPrompt` slot, and the
+ * submit CTA. Fully controlled — `values`/callbacks only, no internal state,
+ * no fetch, no react-hook-form/zod dependency (keeping this package's
+ * dependency surface minimal); the consuming SITE owns validation and wires
+ * its own `onSubmit`.
+ *
+ * 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 +
+ * discount-code flow the issue named. A SITE that needs them renders its own
+ * fields via the `children` slot, rendered between the contact and discount
+ * sections.
+ */
+interface CheckoutContactValues {
+    name: string;
+    email: string;
+    phone?: string;
+}
+type CheckoutContactErrors = Partial<Record<keyof CheckoutContactValues, string>>;
+interface CheckoutAppliedDiscount {
+    code: string;
+    amount: number;
+}
+interface CheckoutFormLabels {
+    contactTitle: string;
+    nameLabel: string;
+    namePlaceholder: string;
+    emailLabel: string;
+    emailPlaceholder: string;
+    phoneLabel: string;
+    discountTitle: string;
+    discountPlaceholder: string;
+    applyDiscount: string;
+    applyingDiscount: string;
+    removeDiscount: string;
+    discountAppliedSuffix: (formattedAmount: string) => string;
+    submit: string;
+    submitting: string;
+}
+interface CheckoutFormProps {
+    contact: CheckoutContactValues;
+    onContactChange: (values: CheckoutContactValues) => void;
+    contactErrors?: CheckoutContactErrors;
+    discountCode: string;
+    onDiscountCodeChange: (value: string) => void;
+    onApplyDiscount: () => void;
+    onRemoveDiscount: () => void;
+    appliedDiscount?: CheckoutAppliedDiscount | null;
+    discountApplying?: boolean;
+    discountError?: string | null;
+    /**
+     * Rendered OUTSIDE the `<form>`, immediately before it — e.g. the
+     * `CheckoutLoginPrompt` dialog. It must never render inside the `<form>`:
+     * an Enter keypress in one of ITS inputs would otherwise submit checkout
+     * (REB-829 review finding — see `handleDiscountCodeKeyDown` below for the
+     * same defect class).
+     */
+    loginPrompt?: ReactNode;
+    /** Rendered between the contact and discount sections — e.g. shipping/billing fields. */
+    children?: ReactNode;
+    submitting?: boolean;
+    submitDisabled?: boolean;
+    onSubmit: (event: FormEvent<HTMLFormElement>) => void;
+    labels?: Partial<CheckoutFormLabels>;
+    currencyCode?: string;
+    locale?: string;
+    className?: string;
+}
+declare function CheckoutForm({ contact, onContactChange, contactErrors, discountCode, onDiscountCodeChange, onApplyDiscount, onRemoveDiscount, appliedDiscount, discountApplying, discountError, loginPrompt, children, submitting, submitDisabled, onSubmit, labels, currencyCode, locale, className, }: CheckoutFormProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * `OrderConfirmation` — presentational order-confirmation view (REB-829).
+ * Pure data + status in, RSC-safe (no hooks). The consuming SITE owns the
+ * actual lookup/polling (`client.shop.order(sessionId)` via a Route Handler
+ * built from `createShopOrderRoute`, retried while `'polling'` — the Stripe
+ * webhook that creates the order may not have landed yet) and passes the
+ * resulting `status`/`order` in.
+ */
+type OrderConfirmationOrder = ShopOrder;
+type OrderConfirmationStatus = 'polling' | 'found' | 'timeout';
+interface OrderConfirmationLabels {
+    pollingTitle: string;
+    pollingDescription: string;
+    foundTitle: string;
+    foundDescription: string;
+    timeoutTitle: string;
+    timeoutDescription: string;
+    orderNumberLabel: string;
+    totalLabel: string;
+    confirmationEmailPrefix: string;
+    sessionReferenceLabel: string;
+}
+interface OrderConfirmationProps {
+    status: OrderConfirmationStatus;
+    order: OrderConfirmationOrder | null;
+    /** Shown as a fallback reference when `status === 'timeout'` and no order was found. */
+    sessionId?: string;
+    labels?: Partial<OrderConfirmationLabels>;
+    currencyCode?: string;
+    locale?: string;
+    className?: string;
+}
+declare function OrderConfirmation({ status, order, sessionId, labels, currencyCode, locale, className, }: OrderConfirmationProps): react_jsx_runtime.JSX.Element;
+
+export { ALLOWED_YOUTUBE_HOSTS, AddToCartButton, type AddToCartButtonLabels, type AddToCartButtonProps, CartIcon, type CartIconLabels, type CartIconProps, 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_PRICE_BANDS, MarkdownRenderer, type MarkdownRendererProps, OrderConfirmation, type OrderConfirmationLabels, type OrderConfirmationOrder, type OrderConfirmationProps, type OrderConfirmationStatus, ProductCard, type ProductCardProps, ProfileCard, type ProfileCardProps, SafeHtml, type SafeHtmlProps, type ShareUrls, type ShopFilterPriceBand, ShopFilters, type ShopFiltersActive, type ShopFiltersHrefs, type ShopFiltersLabels, type ShopFiltersProps, Specialty, type SpecialtyProps, Treatment, type TreatmentProps, buildShareUrls, formatPrice, isAllowedYouTubeHost, markdownToSafeHtml, readingTime, sanitizeHtml, shouldRenderShopFilters };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PageDetail, PageListItem, ShopProductListItem, ShopFacets } from '@reblu/site-contracts';
+import { PageDetail, PageListItem, ShopProductListItem, ShopFacets, ShopOrder } from '@reblu/site-contracts';
+import { ReactNode, FormEvent } from 'react';
 
 declare function readingTime(content: string | null | undefined): number | null;
 
@@ -383,4 +384,275 @@ interface ShopFiltersProps {
 declare function shouldRenderShopFilters(facets: ShopFacets, active?: ShopFiltersActive): boolean;
 declare function ShopFilters({ facets, hrefs, active, onChange, priceBands, labels, currencyCode, locale, className, }: ShopFiltersProps): react_jsx_runtime.JSX.Element | null;
 
-export { ALLOWED_YOUTUBE_HOSTS, DEFAULT_SHOP_PRICE_BANDS, MarkdownRenderer, type MarkdownRendererProps, ProductCard, type ProductCardProps, ProfileCard, type ProfileCardProps, SafeHtml, type SafeHtmlProps, type ShareUrls, type ShopFilterPriceBand, ShopFilters, type ShopFiltersActive, type ShopFiltersHrefs, type ShopFiltersLabels, type ShopFiltersProps, Specialty, type SpecialtyProps, Treatment, type TreatmentProps, buildShareUrls, formatPrice, isAllowedYouTubeHost, markdownToSafeHtml, readingTime, sanitizeHtml, shouldRenderShopFilters };
+/**
+ * `AddToCartButton` — presentational add-to-cart CTA (REB-829). RSC-safe by
+ * construction (same contract as `ShopFilters`'s `OptionLink`): passing
+ * `onAddToCart` only makes sense from a Client Component, but the component
+ * itself carries no `'use client'` directive, so a Server Component may
+ * still render it WITHOUT the prop (e.g. a disabled preview state).
+ */
+interface AddToCartButtonLabels {
+    add: string;
+    adding: string;
+    outOfStock: string;
+}
+interface AddToCartButtonProps {
+    onAddToCart?: () => void;
+    disabled?: boolean;
+    outOfStock?: boolean;
+    /** True while the add-to-cart call (or a navigation it triggers) is in flight. */
+    pending?: boolean;
+    labels?: Partial<AddToCartButtonLabels>;
+    className?: string;
+}
+declare function AddToCartButton({ onAddToCart, disabled, outOfStock, pending, labels, className, }: AddToCartButtonProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * `CartIcon` — presentational cart badge/link (REB-829). RSC-safe (plain
+ * `<a href>`, no hooks) — a Server Component can render it directly with a
+ * value already computed server-side; a Client Component drives `itemCount`
+ * from `@reblu/site-next/cart`'s `useCart().itemCount`.
+ */
+interface CartIconLabels {
+    cart: string;
+    itemsSuffix: (count: number) => string;
+}
+interface CartIconProps {
+    itemCount: number;
+    href: string;
+    labels?: Partial<CartIconLabels>;
+    className?: string;
+}
+declare function CartIcon({ itemCount, href, labels, className }: CartIconProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * `CartLineList` — presentational cart lines (REB-829), container/
+ * presentational split: it takes `items` + optional `onQuantityChange`/
+ * `onRemove` callbacks, never fetches or owns cart state itself. The
+ * consuming SITE wires these to `@reblu/site-next/cart`'s `useCart()`.
+ *
+ * RSC-safe by construction (same `OptionLink` contract as `ShopFilters`):
+ * the quantity stepper/remove buttons only do anything when `onQuantityChange`/
+ * `onRemove` are supplied from a Client Component — omit them from a Server
+ * Component to render a read-only summary instead.
+ */
+interface CartLineItemView {
+    productId: string;
+    variantId?: string | null;
+    name: string;
+    variantName?: string;
+    /** Integer cents. */
+    unitPrice: number;
+    quantity: number;
+    imageUrl?: string;
+    /** `null`/`undefined` = untracked stock — never clamps the stepper's max. */
+    maxStock?: number | null;
+}
+interface CartLineListLabels {
+    quantityLabel: string;
+    decrease: string;
+    increase: string;
+    remove: string;
+    unitPriceSuffix: string;
+}
+interface CartLineListProps {
+    items: CartLineItemView[];
+    onQuantityChange?: (productId: string, variantId: string | null | undefined, quantity: number) => void;
+    onRemove?: (productId: string, variantId: string | null | undefined) => void;
+    /**
+     * A visually-hidden `aria-live="polite"` announcement (e.g. "Cantidad
+     * actualizada", "Producto eliminado del carrito") — the consuming SITE
+     * decides WHEN to set it (after a successful mutation), this component
+     * only renders the live region.
+     */
+    liveMessage?: string;
+    labels?: Partial<CartLineListLabels>;
+    currencyCode?: string;
+    locale?: string;
+    className?: string;
+}
+declare function CartLineList({ items, onQuantityChange, onRemove, liveMessage, labels, currencyCode, locale, className, }: CartLineListProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * `CartSummary` — presentational price breakdown (REB-829): subtotal,
+ * optional discount, optional shipping (sourced from `ShopConfig` by the
+ * consuming SITE — this component only renders what it's given), and total.
+ * Pure data in, RSC-safe (no hooks, no callbacks).
+ */
+interface CartSummaryLabels {
+    subtotal: string;
+    discountPrefix: string;
+    shipping: string;
+    freeShipping: string;
+    /**
+     * Shown when `shipping` is `null`/`undefined` (unknown yet) — REB-829
+     * review finding: this is NOT the same state as `0` (confirmed free).
+     * Claiming "free shipping" for an amount the SITE simply hasn't computed
+     * yet understates the real total and is reversed at checkout.
+     */
+    shippingCalculated: string;
+    total: string;
+}
+interface CartSummaryProps {
+    /** Integer cents. */
+    subtotal: number;
+    /** Integer cents, positive. Omit (or `0`) to hide the discount line. */
+    discount?: number;
+    /** The applied discount code, shown next to the discount amount. */
+    discountCode?: string;
+    /** Integer cents. Only rendered when `shippingEnabled` is true. */
+    shipping?: number | null;
+    /** Whether this tenant's shop even has shipping cost — hides the line entirely when false/omitted. */
+    shippingEnabled?: boolean;
+    /** Integer cents — the final charged amount. */
+    total: number;
+    labels?: Partial<CartSummaryLabels>;
+    currencyCode?: string;
+    locale?: string;
+    className?: string;
+}
+declare function CartSummary({ subtotal, discount, discountCode, shipping, shippingEnabled, total, labels, currencyCode, locale, className, }: CartSummaryProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * `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.
+ */
+interface CheckoutLoginPromptLabels {
+    title: string;
+    description: string;
+    emailLabel: string;
+    emailPlaceholder: string;
+    continueWithEmail: string;
+    checking: string;
+    continueAsGuest: string;
+    close: string;
+}
+interface CheckoutLoginPromptProps {
+    open: boolean;
+    email: string;
+    onEmailChange: (value: string) => void;
+    onClose: () => void;
+    /** Called when the visitor confirms a (valid-looking) email. */
+    onSubmitEmail: () => void;
+    onContinueAsGuest: () => void;
+    checking?: boolean;
+    error?: string | null;
+    labels?: Partial<CheckoutLoginPromptLabels>;
+    className?: string;
+}
+declare function CheckoutLoginPrompt({ open, email, onEmailChange, onClose, onSubmitEmail, onContinueAsGuest, checking, error, labels, className, }: CheckoutLoginPromptProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * `CheckoutForm` — presentational guest-checkout form (REB-829): contact
+ * fields, a discount-code section, an optional `loginPrompt` slot, and the
+ * submit CTA. Fully controlled — `values`/callbacks only, no internal state,
+ * no fetch, no react-hook-form/zod dependency (keeping this package's
+ * dependency surface minimal); the consuming SITE owns validation and wires
+ * its own `onSubmit`.
+ *
+ * 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 +
+ * discount-code flow the issue named. A SITE that needs them renders its own
+ * fields via the `children` slot, rendered between the contact and discount
+ * sections.
+ */
+interface CheckoutContactValues {
+    name: string;
+    email: string;
+    phone?: string;
+}
+type CheckoutContactErrors = Partial<Record<keyof CheckoutContactValues, string>>;
+interface CheckoutAppliedDiscount {
+    code: string;
+    amount: number;
+}
+interface CheckoutFormLabels {
+    contactTitle: string;
+    nameLabel: string;
+    namePlaceholder: string;
+    emailLabel: string;
+    emailPlaceholder: string;
+    phoneLabel: string;
+    discountTitle: string;
+    discountPlaceholder: string;
+    applyDiscount: string;
+    applyingDiscount: string;
+    removeDiscount: string;
+    discountAppliedSuffix: (formattedAmount: string) => string;
+    submit: string;
+    submitting: string;
+}
+interface CheckoutFormProps {
+    contact: CheckoutContactValues;
+    onContactChange: (values: CheckoutContactValues) => void;
+    contactErrors?: CheckoutContactErrors;
+    discountCode: string;
+    onDiscountCodeChange: (value: string) => void;
+    onApplyDiscount: () => void;
+    onRemoveDiscount: () => void;
+    appliedDiscount?: CheckoutAppliedDiscount | null;
+    discountApplying?: boolean;
+    discountError?: string | null;
+    /**
+     * Rendered OUTSIDE the `<form>`, immediately before it — e.g. the
+     * `CheckoutLoginPrompt` dialog. It must never render inside the `<form>`:
+     * an Enter keypress in one of ITS inputs would otherwise submit checkout
+     * (REB-829 review finding — see `handleDiscountCodeKeyDown` below for the
+     * same defect class).
+     */
+    loginPrompt?: ReactNode;
+    /** Rendered between the contact and discount sections — e.g. shipping/billing fields. */
+    children?: ReactNode;
+    submitting?: boolean;
+    submitDisabled?: boolean;
+    onSubmit: (event: FormEvent<HTMLFormElement>) => void;
+    labels?: Partial<CheckoutFormLabels>;
+    currencyCode?: string;
+    locale?: string;
+    className?: string;
+}
+declare function CheckoutForm({ contact, onContactChange, contactErrors, discountCode, onDiscountCodeChange, onApplyDiscount, onRemoveDiscount, appliedDiscount, discountApplying, discountError, loginPrompt, children, submitting, submitDisabled, onSubmit, labels, currencyCode, locale, className, }: CheckoutFormProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * `OrderConfirmation` — presentational order-confirmation view (REB-829).
+ * Pure data + status in, RSC-safe (no hooks). The consuming SITE owns the
+ * actual lookup/polling (`client.shop.order(sessionId)` via a Route Handler
+ * built from `createShopOrderRoute`, retried while `'polling'` — the Stripe
+ * webhook that creates the order may not have landed yet) and passes the
+ * resulting `status`/`order` in.
+ */
+type OrderConfirmationOrder = ShopOrder;
+type OrderConfirmationStatus = 'polling' | 'found' | 'timeout';
+interface OrderConfirmationLabels {
+    pollingTitle: string;
+    pollingDescription: string;
+    foundTitle: string;
+    foundDescription: string;
+    timeoutTitle: string;
+    timeoutDescription: string;
+    orderNumberLabel: string;
+    totalLabel: string;
+    confirmationEmailPrefix: string;
+    sessionReferenceLabel: string;
+}
+interface OrderConfirmationProps {
+    status: OrderConfirmationStatus;
+    order: OrderConfirmationOrder | null;
+    /** Shown as a fallback reference when `status === 'timeout'` and no order was found. */
+    sessionId?: string;
+    labels?: Partial<OrderConfirmationLabels>;
+    currencyCode?: string;
+    locale?: string;
+    className?: string;
+}
+declare function OrderConfirmation({ status, order, sessionId, labels, currencyCode, locale, className, }: OrderConfirmationProps): react_jsx_runtime.JSX.Element;
+
+export { ALLOWED_YOUTUBE_HOSTS, AddToCartButton, type AddToCartButtonLabels, type AddToCartButtonProps, CartIcon, type CartIconLabels, type CartIconProps, 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_PRICE_BANDS, MarkdownRenderer, type MarkdownRendererProps, OrderConfirmation, type OrderConfirmationLabels, type OrderConfirmationOrder, type OrderConfirmationProps, type OrderConfirmationStatus, ProductCard, type ProductCardProps, ProfileCard, type ProfileCardProps, SafeHtml, type SafeHtmlProps, type ShareUrls, type ShopFilterPriceBand, ShopFilters, type ShopFiltersActive, type ShopFiltersHrefs, type ShopFiltersLabels, type ShopFiltersProps, Specialty, type SpecialtyProps, Treatment, type TreatmentProps, buildShareUrls, formatPrice, isAllowedYouTubeHost, markdownToSafeHtml, readingTime, sanitizeHtml, shouldRenderShopFilters };