@cimplify/sdk 0.19.0 → 0.20.0

package/dist/react.d.ts

@@ -1,9 +1,9 @@
 import React, { ReactNode } from 'react';
 import { A as AdSlot, a as AdPosition, e as AdContextValue } from './ads-BxbWrwqp.js';
 export { c as AdConfig, g as getVariantDisplayName } from './ads-BxbWrwqp.js';
-import { C as CimplifyClient, $ as ProcessCheckoutResult, a1 as CheckoutStatus, a2 as CheckoutStatusContext, bt as Location, bq as Business, aV as Order, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, P as PriceQuote, g as QuoteUiMessage, aI as OrderStatus, bG as Service, bJ as AvailableSlot, bK as DayAvailability, bP as CustomerBooking, bV as CancelBookingResult, z as ElementsOptions, cJ as AuthenticatedData, cF as AddressInfo, cG as PaymentMethodInfo, v as CimplifyElements, cL as ElementsCheckoutResult, _ as ProcessCheckoutOptions, aU as LineItem, bH as Staff } from './client-FNZzXO_v.js';
-import { y as Product, b as Pagination, g as CimplifyError, z as ProductWithDetails, _ as Category, M as Money, aW as BundleSelectionInput, ao as ComponentSelectionInput, a0 as Collection, aw as ProductTaxonomy, ax as TaxonomyWithChildren, av as ProductTimeProfile, aA as Deal, aB as ProductDealInfo, aC as DiscountValidation, a5 as BundleSummary, ap as CompositePriceResult, C as CurrencyCode, B as ProductVariant, J as VariantAxisWithValues, U as AddOnWithOptions, aa as BundleComponentView, a3 as BundlePriceType, al as CompositeGroupView } from './payment-CO2tRThu.js';
-import { P as ProductWithPrice } from './price-Bp6JlVzW.js';
+import { C as CimplifyClient, a7 as ProcessCheckoutResult, a9 as CheckoutStatus, aa as CheckoutStatusContext, bJ as Location, bG as Business, b1 as Order, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, P as PriceQuote, g as QuoteUiMessage, aQ as OrderStatus, bW as Service, bZ as AvailableSlot, b_ as DayAvailability, c3 as CustomerBooking, c9 as CancelBookingResult, v as ActivityStateResponse, t as SessionMessage, w as ActivityRecommendation, z as DeliveryFeeResponse, cL as FxRateResponse, bQ as StorefrontBootstrap, X as ElementsOptions, cZ as AuthenticatedData, cV as AddressInfo, cW as PaymentMethodInfo, J as CimplifyElements, c$ as ElementsCheckoutResult, a6 as ProcessCheckoutOptions, b0 as LineItem, bX as Staff } from './client-VyO6Bqz2.js';
+import { J as Product, d as Pagination, h as CimplifyError, L as ProductWithDetails, a5 as Category, M as Money, b0 as BundleSelectionInput, av as ComponentSelectionInput, b3 as BundleSelectionData, b6 as CompositeSelectionData, a7 as Collection, aD as ProductTaxonomy, aE as TaxonomyWithChildren, aC as ProductTimeProfile, aH as Deal, aI as ProductDealInfo, aJ as DiscountValidation, ac as BundleSummary, aw as CompositePriceResult, y as CustomAttributeDefinition, G as PropertyFacet, bI as ProductBillingPlan, N as VariantView, W as VariantAxisWithValues, a as CurrencyCode, a1 as AddOnWithOptions, ah as BundleComponentView, aa as BundlePriceType, as as CompositeGroupView, bb as DisplayCart } from './payment-CKqMU4xT.js';
+import { P as ProductWithPrice } from './price-e4beObLZ.js';
 import { ClassValue } from 'clsx';
 
 interface UserIdentity {
@@ -211,6 +211,11 @@ interface UseCartItem {
     scheduledStart?: string;
     scheduledEnd?: string;
     staffId?: string;
+    lineType?: "simple" | "service" | "bundle" | "composite" | "digital";
+    confirmationCode?: string;
+    serviceStatus?: string;
+    bundleResolved?: BundleSelectionData;
+    compositeResolved?: CompositeSelectionData;
 }
 interface AddToCartOptions {
     locationId?: string;
@@ -557,6 +562,171 @@ interface UseBookingsResult {
 }
 declare function useBookings(options?: UseBookingsOptions): UseBookingsResult;
 
+interface UseAttributeDefinitionsOptions {
+    enabled?: boolean;
+    namespace?: string;
+    client?: CimplifyClient;
+}
+interface UseAttributeDefinitionsResult {
+    definitions: CustomAttributeDefinition[];
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useAttributeDefinitions(options?: UseAttributeDefinitionsOptions): UseAttributeDefinitionsResult;
+
+interface UsePropertyFacetsOptions {
+    enabled?: boolean;
+    client?: CimplifyClient;
+    category_id?: string;
+    product_type?: string;
+}
+interface UsePropertyFacetsResult {
+    facets: PropertyFacet[];
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function usePropertyFacets(options?: UsePropertyFacetsOptions): UsePropertyFacetsResult;
+
+interface UseBillingPlansOptions {
+    enabled?: boolean;
+    client?: CimplifyClient;
+    customerId?: string;
+    quantity?: number;
+    orderValue?: number;
+}
+interface UseBillingPlansResult {
+    plans: ProductBillingPlan[];
+    subscriptionPlans: ProductBillingPlan[];
+    installmentPlans: ProductBillingPlan[];
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+/**
+ * Fetch eligible billing plans for a product, filtered by customer/quantity/order value.
+ *
+ * For unfiltered plans, use `product.billing_plans` directly from `useProduct` instead —
+ * they are included in the product response and require no extra API call.
+ */
+declare function useBillingPlans(productId: string | null | undefined, options?: UseBillingPlansOptions): UseBillingPlansResult;
+
+interface UseVariantSelectorOptions {
+    variants: VariantView[];
+    axes: VariantAxisWithValues[];
+}
+interface UseVariantSelectorResult {
+    selectedValues: Record<string, string>;
+    selectedVariant: VariantView | null;
+    variantImage: string | null;
+    availableValues: Record<string, Set<string>>;
+    selectValue: (axisId: string, valueId: string) => void;
+    reset: () => void;
+}
+/**
+ * Multi-axis variant selector. Resolves a variant from axis selections
+ * and computes which values remain available as the user narrows choices.
+ *
+ * ```tsx
+ * const { selectedValues, selectedVariant, availableValues, selectValue } =
+ *   useVariantSelector({ variants: product.variants, axes: product.variant_axes });
+ *
+ * // Render axes
+ * axes.map(axis => axis.values.map(value => (
+ *   <button
+ *     disabled={!availableValues[axis.id]?.has(value.id)}
+ *     onClick={() => selectValue(axis.id, value.id)}
+ *     style={value.color_hex ? { backgroundColor: value.color_hex } : undefined}
+ *   />
+ * )));
+ * ```
+ */
+declare function useVariantSelector(options: UseVariantSelectorOptions): UseVariantSelectorResult;
+
+interface UseActivityStateOptions {
+    enabled?: boolean;
+    client?: CimplifyClient;
+}
+interface UseActivityStateResult {
+    state: ActivityStateResponse | null;
+    messages: SessionMessage[];
+    intent: string;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+    dismissMessage: (code: string) => Promise<void>;
+}
+/**
+ * useActivityState — fetches the current session activity state including messages and intent.
+ *
+ * Wraps `client.activity.getState()` with global caching and in-flight dedup.
+ * Provides a `dismissMessage` action to dismiss individual messages and refetch.
+ */
+declare function useActivityState(options?: UseActivityStateOptions): UseActivityStateResult;
+
+interface UseRecommendationsOptions {
+    locationId?: string;
+    limit?: number;
+    enabled?: boolean;
+    client?: CimplifyClient;
+}
+interface UseRecommendationsResult {
+    recommendations: ActivityRecommendation[];
+    intent: string;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+/**
+ * useRecommendations — fetches personalized product recommendations based on session activity.
+ *
+ * Wraps `client.activity.getRecommendations()` with global caching and in-flight dedup.
+ * Cache key includes locationId and limit.
+ */
+declare function useRecommendations(options?: UseRecommendationsOptions): UseRecommendationsResult;
+
+interface UseDeliveryFeeOptions {
+    latitude: number;
+    longitude: number;
+    country?: string;
+    enabled?: boolean;
+    client?: CimplifyClient;
+}
+interface UseDeliveryFeeResult {
+    fee: DeliveryFeeResponse | null;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useDeliveryFee(options: UseDeliveryFeeOptions): UseDeliveryFeeResult;
+
+interface UseFxRateOptions {
+    from: CurrencyCode;
+    to: CurrencyCode;
+    enabled?: boolean;
+    client?: CimplifyClient;
+}
+interface UseFxRateResult {
+    rate: FxRateResponse | null;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useFxRate(options: UseFxRateOptions): UseFxRateResult;
+
+interface UseBootstrapOptions {
+    enabled?: boolean;
+    client?: CimplifyClient;
+}
+interface UseBootstrapResult {
+    bootstrap: StorefrontBootstrap | null;
+    isLoading: boolean;
+    error: CimplifyError | null;
+    refetch: () => Promise<void>;
+}
+declare function useBootstrap(options?: UseBootstrapOptions): UseBootstrapResult;
+
 declare function useElements(): CimplifyElements | null;
 declare function useElementsReady(): boolean;
 interface ElementsProviderProps {
@@ -641,11 +811,11 @@ interface VariantSelectorClassNames {
     adjustment?: string;
 }
 interface VariantSelectorProps {
-    variants: ProductVariant[];
+    variants: VariantView[];
     variantAxes?: VariantAxisWithValues[];
     basePrice?: Money;
     selectedVariantId?: string;
-    onVariantChange: (variantId: string | undefined, variant: ProductVariant | undefined) => void;
+    onVariantChange: (variantId: string | undefined, variant: VariantView | undefined) => void;
     productName?: string;
     className?: string;
     classNames?: VariantSelectorClassNames;
@@ -683,6 +853,9 @@ interface BundleSelectorClassNames {
     componentHeader?: string;
     componentQty?: string;
     componentName?: string;
+    typeBadge?: string;
+    serviceBadge?: string;
+    digitalBadge?: string;
     variantPicker?: string;
     variantOption?: string;
     variantOptionSelected?: string;
@@ -717,6 +890,9 @@ interface CompositeSelectorClassNames {
     componentSelected?: string;
     componentInfo?: string;
     componentName?: string;
+    typeBadge?: string;
+    serviceBadge?: string;
+    digitalBadge?: string;
     badgePopular?: string;
     badgePremium?: string;
     componentDescription?: string;
@@ -748,14 +924,19 @@ interface ProductCustomizerClassNames {
     submitButton?: string;
     submitButtonAdded?: string;
     validation?: string;
+    specialInstructions?: string;
+    depositInfo?: string;
+    allergens?: string;
+    duration?: string;
 }
 interface ProductCustomizerProps {
     product: ProductWithDetails;
     onAddToCart?: (product: ProductWithDetails, quantity: number, options: AddToCartOptions) => void | Promise<void>;
+    showSpecialInstructions?: boolean;
     className?: string;
     classNames?: ProductCustomizerClassNames;
 }
-declare function ProductCustomizer({ product, onAddToCart, className, classNames, }: ProductCustomizerProps): React.ReactElement;
+declare function ProductCustomizer({ product, onAddToCart, showSpecialInstructions, className, classNames, }: ProductCustomizerProps): React.ReactElement;
 
 interface ProductImageGalleryProps {
     images: string[];
@@ -770,12 +951,36 @@ interface ProductImageGalleryProps {
  */
 declare function ProductImageGallery({ images, productName, aspectRatio, className, }: ProductImageGalleryProps): React.ReactElement | null;
 
+interface CartSummaryClassNames {
+    root?: string;
+    item?: string;
+    itemName?: string;
+    itemPrice?: string;
+    quantity?: string;
+    removeButton?: string;
+    totals?: string;
+    subtotal?: string;
+    tax?: string;
+    deliveryFee?: string;
+    serviceCharge?: string;
+    discount?: string;
+    total?: string;
+    checkout?: string;
+    empty?: string;
+    serviceInfo?: string;
+    digitalInfo?: string;
+    bundleBreakdown?: string;
+    compositeBreakdown?: string;
+}
 interface CartSummaryProps {
+    /** Optional server cart for extended pricing details (delivery fee, service charge, discounts). */
+    cart?: DisplayCart;
     onCheckout?: () => void;
     onItemRemove?: (itemId: string) => void;
     onQuantityChange?: (itemId: string, quantity: number) => void;
     emptyMessage?: string;
     className?: string;
+    classNames?: CartSummaryClassNames;
 }
 /**
  * CartSummary — renders cart line items + totals.
@@ -783,12 +988,14 @@ interface CartSummaryProps {
  * NOT a drawer or modal — just the cart content. Templates wrap this in
  * their own drawer/modal shell with animations.
  */
-declare function CartSummary({ onCheckout, onItemRemove, onQuantityChange, emptyMessage, className, }: CartSummaryProps): React.ReactElement;
+declare function CartSummary({ cart: serverCart, onCheckout, onItemRemove, onQuantityChange, emptyMessage, className, classNames, }: CartSummaryProps): React.ReactElement;
 
 interface AvailabilityBadgeClassNames {
     root?: string;
     dot?: string;
     label?: string;
+    lowStock?: string;
+    stockCount?: string;
 }
 interface AvailabilityBadgeProps {
     /** The product to check availability for. */
@@ -797,6 +1004,12 @@ interface AvailabilityBadgeProps {
     isAvailable?: boolean;
     /** Override stock status (e.g. from location_availability). */
     isInStock?: boolean;
+    /** Current stock quantity. When provided, enables "Only X left" display. */
+    stockQuantity?: number;
+    /** Threshold at which stock is considered low. Default: 5. */
+    lowStockThreshold?: number;
+    /** Location context for availability checks. Passed through as a data attribute. */
+    locationId?: string;
     className?: string;
     classNames?: AvailabilityBadgeClassNames;
 }
@@ -806,7 +1019,7 @@ interface AvailabilityBadgeProps {
  * Returns `null` for products that don't have inventory tracking enabled,
  * since there's no meaningful stock state to show.
  */
-declare function AvailabilityBadge({ product, isAvailable, isInStock, className, classNames, }: AvailabilityBadgeProps): React.ReactElement | null;
+declare function AvailabilityBadge({ product, isAvailable, isInStock, stockQuantity, lowStockThreshold, locationId, className, classNames, }: AvailabilityBadgeProps): React.ReactElement | null;
 
 interface SaleBadgeClassNames {
     root?: string;
@@ -965,6 +1178,10 @@ interface SearchInputClassNames {
     resultItem?: string;
     empty?: string;
     loading?: string;
+    resultImage?: string;
+    resultName?: string;
+    resultPrice?: string;
+    categoryFilter?: string;
 }
 interface SearchInputProps {
     /** Placeholder text for the input. */
@@ -977,6 +1194,10 @@ interface SearchInputProps {
     renderResult?: (product: Product) => React.ReactNode;
     /** Show inline results dropdown. Default: true. */
     showResults?: boolean;
+    /** Optional category ID to scope search results. */
+    categoryId?: string;
+    /** Display name for the active category filter. */
+    categoryName?: string;
     className?: string;
     classNames?: SearchInputClassNames;
 }
@@ -986,7 +1207,7 @@ interface SearchInputProps {
  * Wraps `useSearch` with a controlled input and optional inline results list.
  * Uses Base UI Field.Root + Input for accessible form semantics.
  */
-declare function SearchInput({ placeholder, searchOptions, onResultClick, renderResult, showResults, className, classNames, }: SearchInputProps): React.ReactElement;
+declare function SearchInput({ placeholder, searchOptions, onResultClick, renderResult, showResults, categoryId, categoryName, className, classNames, }: SearchInputProps): React.ReactElement;
 
 interface CategoryFilterClassNames {
     root?: string;
@@ -1114,11 +1335,20 @@ interface OrderSummaryClassNames {
     header?: string;
     orderId?: string;
     status?: string;
+    paymentState?: string;
+    fulfillmentDetails?: string;
+    deliveryAddress?: string;
     items?: string;
     lineItem?: string;
+    notes?: string;
     totals?: string;
     customer?: string;
     loading?: string;
+    serviceInfo?: string;
+    digitalInfo?: string;
+    bundleBreakdown?: string;
+    compositeBreakdown?: string;
+    trackingLink?: string;
 }
 interface OrderSummaryProps {
     /** Pass an Order object directly (skips fetch). */
@@ -1813,10 +2043,15 @@ interface BookingPageClassNames {
     confirmButton?: string;
     backButton?: string;
     error?: string;
+    rescheduleInfo?: string;
+    depositInfo?: string;
+    cancellationPolicy?: string;
 }
 interface BookingPageProps {
     /** The service being booked. */
     service: Service;
+    /** The underlying product (for deposit/cancellation fields). Falls back to service fields. */
+    product?: Product;
     /** Optional staff list for staff selection step. */
     staff?: Staff[];
     /** Number of participants. */
@@ -1827,12 +2062,16 @@ interface BookingPageProps {
     onBooked?: (slot: AvailableSlot, staffId: string | null) => void;
     /** Called when user wants to go back. */
     onBack?: () => void;
+    /** Existing booking for reschedule mode. */
+    existingBooking?: CustomerBooking;
+    /** Called after a successful reschedule. */
+    onRescheduled?: (booking: CustomerBooking, newSlot: AvailableSlot) => void;
     /** Show price on slots. Default: true. */
     showPrice?: boolean;
     className?: string;
     classNames?: BookingPageClassNames;
 }
-declare function BookingPage({ service, staff, participantCount, title, onBooked, onBack, showPrice, className, classNames, }: BookingPageProps): React.ReactElement;
+declare function BookingPage({ service, product, staff, participantCount, title, onBooked, onBack, existingBooking, onRescheduled, showPrice, className, classNames, }: BookingPageProps): React.ReactElement;
 
 interface BookingsPageClassNames {
     root?: string;
@@ -1864,4 +2103,217 @@ interface BookingsPageProps {
 }
 declare function BookingsPage({ title, bookings: bookingsProp, onBookingNavigate, onCancel, onReschedule, showFilters, renderBooking, className, classNames, }: BookingsPageProps): React.ReactElement;
 
-export { Ad, AdPosition, type AdProps, AdProvider, AdSlot, AddOnSelector, type AddOnSelectorClassNames, type AddOnSelectorProps, type AddToCartOptions, AddressElement, AuthElement, AvailabilityBadge, type AvailabilityBadgeClassNames, type AvailabilityBadgeProps, BookingCard, type BookingCardClassNames, type BookingCardProps, BookingList, type BookingListClassNames, type BookingListProps, BookingPage, type BookingPageClassNames, type BookingPageProps, BookingsPage, type BookingsPageClassNames, type BookingsPageProps, BundleSelector, type BundleSelectorClassNames, type BundleSelectorProps, type CartAddOnOptionSelection, CartPage, type CartPageClassNames, type CartPageProps, CartSummary, type CartSummaryProps, type CartVariantSelection, CataloguePage, type CataloguePageClassNames, type CataloguePageProps, CategoryFilter, type CategoryFilterClassNames, type CategoryFilterProps, CategoryGrid, type CategoryGridClassNames, type CategoryGridProps, CheckoutPage, type CheckoutPageClassNames, type CheckoutPageProps, CimplifyCheckout, type CimplifyCheckoutProps, type CimplifyClientContextValue, type CimplifyContextValue, CimplifyProvider, type CimplifyProviderProps, CollectionPage, type CollectionPageClassNames, type CollectionPageProps, CompositeSelector, type CompositeSelectorClassNames, type CompositeSelectorProps, DateSlotPicker, type DateSlotPickerClassNames, type DateSlotPickerProps, DealBanner, type DealBannerClassNames, type DealBannerProps, DealsPage, type DealsPageClassNames, type DealsPageProps, DiscountInput, type DiscountInputClassNames, type DiscountInputProps, ElementsProvider, OrderDetailPage, type OrderDetailPageClassNames, type OrderDetailPageProps, OrderHistory, type OrderHistoryClassNames, OrderHistoryPage, type OrderHistoryPageClassNames, type OrderHistoryPageProps, type OrderHistoryProps, OrderSummary, type OrderSummaryClassNames, type OrderSummaryProps, PaymentElement, Price, type PriceProps, ProductCard, type ProductCardClassNames, type ProductCardProps, ProductCustomizer, type ProductCustomizerClassNames, type ProductCustomizerProps, ProductGrid, type ProductGridClassNames, type ProductGridProps, ProductImageGallery, type ProductImageGalleryProps, ProductPage, type ProductPageClassNames, type ProductPageProps, ProductSheet, type ProductSheetClassNames, type ProductSheetProps, QuantitySelector, type QuantitySelectorClassNames, type QuantitySelectorProps, SaleBadge, type SaleBadgeClassNames, type SaleBadgeProps, SearchInput, type SearchInputClassNames, type SearchInputProps, SearchPage, type SearchPageClassNames, type SearchPageProps, ServiceCard, type ServiceCardClassNames, type ServiceCardProps, ServiceGrid, type ServiceGridClassNames, type ServiceGridProps, SlotPicker, type SlotPickerClassNames, type SlotPickerProps, StaffPicker, type StaffPickerClassNames, type StaffPickerProps, StoreNav, type StoreNavClassNames, type StoreNavProps, type UseAvailableSlotsOptions, type UseAvailableSlotsResult, type UseBookingsOptions, type UseBookingsResult, type UseBundlesOptions, type UseBundlesResult, type UseCartItem, type UseCartOptions, type UseCartResult, type UseCategoriesOptions, type UseCategoriesResult, type UseCollectionOptions, type UseCollectionResult, type UseCollectionsOptions, type UseCollectionsResult, type UseDealsOptions, type UseDealsResult, type UseLocationsOptions, type UseLocationsResult, type UseOrderOptions, type UseOrderResult, type UseOrdersOptions, type UseOrdersResult, type UseProductAvailabilityOptions, type UseProductAvailabilityResult, type UseProductDealsOptions, type UseProductDealsResult, type UseProductOptions, type UseProductPriceInput, type UseProductPriceResult, type UseProductResult, type UseProductSchedulesOptions, type UseProductSchedulesResult, type UseProductsOnSaleOptions, type UseProductsOnSaleResult, type UseProductsOptions, type UseProductsResult, type UseQuoteInput, type UseQuoteOptions, type UseQuoteResult, type UseSearchOptions, type UseSearchResult, type UseServiceAvailabilityOptions, type UseServiceAvailabilityResult, type UseServicesOptions, type UseServicesResult, type UseTaxonomiesOptions, type UseTaxonomiesResult, type UseTaxonomyOptions, type UseTaxonomyPathOptions, type UseTaxonomyPathResult, type UseTaxonomyResult, type UseValidateDiscountOptions, type UseValidateDiscountResult, VariantSelector, type VariantSelectorClassNames, type VariantSelectorProps, cn, useAds, useAvailableSlots, useBookings, useBundles, useCart, useCategories, useCheckout, useCimplify, useCimplifyClient, useCollection, useCollections, useDeals, useElements, useElementsReady, useLocations, useOptionalCimplify, useOrder, useOrders, useProduct, useProductAvailability, useProductDeals, useProductPrice, useProductSchedules, useProducts, useProductsOnSale, useQuote, useSearch, useServiceAvailability, useServices, useTaxonomies, useTaxonomy, useTaxonomyPath, useValidateDiscount };
+interface LocationPickerClassNames {
+    root?: string;
+    item?: string;
+    activeItem?: string;
+    empty?: string;
+    loading?: string;
+}
+interface LocationPickerProps {
+    /** Override locations (skips useLocations fetch). For SSR, pass pre-fetched locations. */
+    locations?: Location[];
+    /** Override the current location. */
+    currentLocation?: Location | null;
+    /** Called when a location is selected. */
+    onLocationChange?: (location: Location) => void;
+    /** Custom location renderer. */
+    renderLocation?: (location: Location, isActive: boolean) => React.ReactNode;
+    /** Text shown when no locations are available. */
+    emptyMessage?: string;
+    className?: string;
+    classNames?: LocationPickerClassNames;
+}
+/**
+ * LocationPicker — renders a location selector for multi-location businesses.
+ *
+ * Uses `useLocations` to fetch locations unless overridden via props.
+ * Returns `null` when there is only one location (no picker needed).
+ */
+declare function LocationPicker({ locations: locationsProp, currentLocation: currentLocationProp, onLocationChange, renderLocation, emptyMessage, className, classNames, }: LocationPickerProps): React.ReactElement | null;
+
+interface RecommendationCarouselClassNames {
+    root?: string;
+    item?: string;
+    reason?: string;
+    empty?: string;
+    loading?: string;
+}
+interface RecommendationCarouselProps {
+    /** Override recommendations (skips fetch). For SSR, pass pre-fetched data. */
+    recommendations?: ActivityRecommendation[];
+    /** Location ID for location-specific recommendations. */
+    locationId?: string;
+    /** Maximum recommendations to fetch. */
+    limit?: number;
+    /** Called when a product recommendation is clicked. */
+    onProductClick?: (recommendation: ActivityRecommendation) => void;
+    /** Custom product card renderer. */
+    renderProduct?: (recommendation: ActivityRecommendation) => React.ReactNode;
+    /** Text shown when no recommendations are available. */
+    emptyMessage?: string;
+    className?: string;
+    classNames?: RecommendationCarouselClassNames;
+}
+/**
+ * RecommendationCarousel — displays personalized product recommendations.
+ *
+ * Renders a horizontal scrollable list of product cards with reason labels.
+ * Returns `null` when there are no recommendations.
+ */
+declare function RecommendationCarousel({ recommendations: recommendationsProp, locationId, limit, onProductClick, renderProduct, emptyMessage, className, classNames, }: RecommendationCarouselProps): React.ReactElement | null;
+
+interface SessionMessageBannerClassNames {
+    root?: string;
+    message?: string;
+    text?: string;
+    dismissButton?: string;
+    empty?: string;
+}
+interface SessionMessageBannerProps {
+    /** Override messages (skips fetch). For SSR, pass pre-fetched messages. */
+    messages?: SessionMessage[];
+    /** Called when a message is dismissed. Receives the message code. */
+    onDismiss?: (code: string) => void;
+    /** Custom message renderer. */
+    renderMessage?: (message: SessionMessage) => React.ReactNode;
+    className?: string;
+    classNames?: SessionMessageBannerClassNames;
+}
+/**
+ * SessionMessageBanner — renders activity-based session messages.
+ *
+ * Displays dismissible message cards with level-based styling (info, promotion, urgency, suggestion).
+ * Returns `null` when there are no messages.
+ */
+declare function SessionMessageBanner({ messages: messagesProp, onDismiss, renderMessage, className, classNames, }: SessionMessageBannerProps): React.ReactElement | null;
+
+interface ViewedProduct {
+    product_id: string;
+    product_name?: string;
+    category_id?: string;
+}
+interface RecentlyViewedClassNames {
+    root?: string;
+    item?: string;
+    empty?: string;
+    loading?: string;
+}
+interface RecentlyViewedProps {
+    /** Maximum number of viewed products to display. */
+    limit?: number;
+    /** Called when a viewed product is clicked. */
+    onProductClick?: (product: ViewedProduct) => void;
+    /** Custom product renderer. */
+    renderProduct?: (product: ViewedProduct) => React.ReactNode;
+    /** Text shown when no viewed products exist. */
+    emptyMessage?: string;
+    className?: string;
+    classNames?: RecentlyViewedClassNames;
+}
+/**
+ * RecentlyViewed — displays products the user has recently viewed during their session.
+ *
+ * Extracts `state.activity.viewed_products` from the activity state.
+ * Returns `null` when there are no viewed products.
+ */
+declare function RecentlyViewed({ limit, onProductClick, renderProduct, emptyMessage, className, classNames, }: RecentlyViewedProps): React.ReactElement | null;
+
+interface BillingPlanSelectorClassNames {
+    root?: string;
+    plan?: string;
+    activePlan?: string;
+    frequency?: string;
+    price?: string;
+    setupFee?: string;
+    trialBadge?: string;
+    empty?: string;
+    loading?: string;
+}
+interface BillingPlanSelectorProps {
+    /** Product ID to fetch billing plans for. */
+    productId: string;
+    /** Override plans (skips fetch). For SSR, pass pre-fetched plans. */
+    plans?: ProductBillingPlan[];
+    /** Called when a plan is selected. */
+    onPlanSelect?: (plan: ProductBillingPlan | null) => void;
+    /** Currently selected plan ID. */
+    selectedPlanId?: string | null;
+    /** Show a "One-time purchase" option at the top. */
+    showOneTimePurchase?: boolean;
+    /** Label for the one-time purchase option. Default: "One-time purchase". */
+    oneTimePurchaseLabel?: string;
+    /** Custom plan card renderer. */
+    renderPlan?: (plan: ProductBillingPlan, isActive: boolean) => React.ReactNode;
+    className?: string;
+    classNames?: BillingPlanSelectorClassNames;
+}
+/**
+ * BillingPlanSelector — subscription/installment plan comparison and selection.
+ *
+ * Renders plan cards with frequency, markup, trial, and setup fee details.
+ * Returns `null` when no plans are available (and one-time purchase is hidden).
+ */
+declare function BillingPlanSelector({ productId, plans: plansProp, onPlanSelect, selectedPlanId, showOneTimePurchase, oneTimePurchaseLabel, renderPlan, className, classNames, }: BillingPlanSelectorProps): React.ReactElement | null;
+
+interface DeliveryEstimateClassNames {
+    root?: string;
+    fee?: string;
+    currency?: string;
+    notServiceable?: string;
+    loading?: string;
+    error?: string;
+}
+interface DeliveryEstimateProps {
+    /** Drop-off latitude. */
+    latitude: number;
+    /** Drop-off longitude. */
+    longitude: number;
+    /** Country code for regional fee lookup. */
+    country?: string;
+    /** Called when the delivery fee is successfully calculated. */
+    onFeeCalculated?: (fee: DeliveryFeeResponse) => void;
+    className?: string;
+    classNames?: DeliveryEstimateClassNames;
+}
+/**
+ * DeliveryEstimate — displays a pre-checkout delivery fee estimate.
+ *
+ * Fetches the delivery fee from `client.delivery.getFee` when coordinates change.
+ * Shows fee amount with currency, a "not serviceable" message, or loading state.
+ */
+declare function DeliveryEstimate({ latitude, longitude, country, onFeeCalculated, className, classNames, }: DeliveryEstimateProps): React.ReactElement | null;
+
+interface CurrencySelectorClassNames {
+    root?: string;
+    option?: string;
+    activeOption?: string;
+    rate?: string;
+    label?: string;
+    loading?: string;
+}
+interface CurrencySelectorProps {
+    /** Available currencies to display. */
+    currencies: CurrencyCode[];
+    /** Currently selected currency. */
+    currentCurrency?: CurrencyCode;
+    /** Called when a currency is selected. */
+    onCurrencyChange?: (currency: CurrencyCode) => void;
+    /** Show the exchange rate next to each currency. Requires `baseCurrency`. */
+    showRate?: boolean;
+    /** Base currency used for rate display. */
+    baseCurrency?: CurrencyCode;
+    /** Custom currency option renderer. */
+    renderCurrency?: (currency: CurrencyCode, isActive: boolean, rate: FxRateResponse | null) => React.ReactNode;
+    className?: string;
+    classNames?: CurrencySelectorClassNames;
+}
+/**
+ * CurrencySelector — currency switcher for international customers.
+ *
+ * Renders selectable currency options with optional exchange rate display.
+ * Returns `null` when there is only one currency (no selector needed).
+ */
+declare function CurrencySelector({ currencies, currentCurrency, onCurrencyChange, showRate, baseCurrency, renderCurrency, className, classNames, }: CurrencySelectorProps): React.ReactElement | null;
+
+export { Ad, AdPosition, type AdProps, AdProvider, AdSlot, AddOnSelector, type AddOnSelectorClassNames, type AddOnSelectorProps, type AddToCartOptions, AddressElement, AuthElement, AvailabilityBadge, type AvailabilityBadgeClassNames, type AvailabilityBadgeProps, BillingPlanSelector, type BillingPlanSelectorClassNames, type BillingPlanSelectorProps, BookingCard, type BookingCardClassNames, type BookingCardProps, BookingList, type BookingListClassNames, type BookingListProps, BookingPage, type BookingPageClassNames, type BookingPageProps, BookingsPage, type BookingsPageClassNames, type BookingsPageProps, BundleSelector, type BundleSelectorClassNames, type BundleSelectorProps, type CartAddOnOptionSelection, CartPage, type CartPageClassNames, type CartPageProps, CartSummary, type CartSummaryClassNames, type CartSummaryProps, type CartVariantSelection, CataloguePage, type CataloguePageClassNames, type CataloguePageProps, CategoryFilter, type CategoryFilterClassNames, type CategoryFilterProps, CategoryGrid, type CategoryGridClassNames, type CategoryGridProps, CheckoutPage, type CheckoutPageClassNames, type CheckoutPageProps, CimplifyCheckout, type CimplifyCheckoutProps, type CimplifyClientContextValue, type CimplifyContextValue, CimplifyProvider, type CimplifyProviderProps, CollectionPage, type CollectionPageClassNames, type CollectionPageProps, CompositeSelector, type CompositeSelectorClassNames, type CompositeSelectorProps, CurrencySelector, type CurrencySelectorClassNames, type CurrencySelectorProps, DateSlotPicker, type DateSlotPickerClassNames, type DateSlotPickerProps, DealBanner, type DealBannerClassNames, type DealBannerProps, DealsPage, type DealsPageClassNames, type DealsPageProps, DeliveryEstimate, type DeliveryEstimateClassNames, type DeliveryEstimateProps, DiscountInput, type DiscountInputClassNames, type DiscountInputProps, ElementsProvider, LocationPicker, type LocationPickerClassNames, type LocationPickerProps, OrderDetailPage, type OrderDetailPageClassNames, type OrderDetailPageProps, OrderHistory, type OrderHistoryClassNames, OrderHistoryPage, type OrderHistoryPageClassNames, type OrderHistoryPageProps, type OrderHistoryProps, OrderSummary, type OrderSummaryClassNames, type OrderSummaryProps, PaymentElement, Price, type PriceProps, ProductCard, type ProductCardClassNames, type ProductCardProps, ProductCustomizer, type ProductCustomizerClassNames, type ProductCustomizerProps, ProductGrid, type ProductGridClassNames, type ProductGridProps, ProductImageGallery, type ProductImageGalleryProps, ProductPage, type ProductPageClassNames, type ProductPageProps, ProductSheet, type ProductSheetClassNames, type ProductSheetProps, QuantitySelector, type QuantitySelectorClassNames, type QuantitySelectorProps, RecentlyViewed, type RecentlyViewedClassNames, type RecentlyViewedProps, RecommendationCarousel, type RecommendationCarouselClassNames, type RecommendationCarouselProps, SaleBadge, type SaleBadgeClassNames, type SaleBadgeProps, SearchInput, type SearchInputClassNames, type SearchInputProps, SearchPage, type SearchPageClassNames, type SearchPageProps, ServiceCard, type ServiceCardClassNames, type ServiceCardProps, ServiceGrid, type ServiceGridClassNames, type ServiceGridProps, SessionMessageBanner, type SessionMessageBannerClassNames, type SessionMessageBannerProps, SlotPicker, type SlotPickerClassNames, type SlotPickerProps, StaffPicker, type StaffPickerClassNames, type StaffPickerProps, StoreNav, type StoreNavClassNames, type StoreNavProps, type UseActivityStateOptions, type UseActivityStateResult, type UseAttributeDefinitionsOptions, type UseAttributeDefinitionsResult, type UseAvailableSlotsOptions, type UseAvailableSlotsResult, type UseBillingPlansOptions, type UseBillingPlansResult, type UseBookingsOptions, type UseBookingsResult, type UseBootstrapOptions, type UseBootstrapResult, type UseBundlesOptions, type UseBundlesResult, type UseCartItem, type UseCartOptions, type UseCartResult, type UseCategoriesOptions, type UseCategoriesResult, type UseCollectionOptions, type UseCollectionResult, type UseCollectionsOptions, type UseCollectionsResult, type UseDealsOptions, type UseDealsResult, type UseDeliveryFeeOptions, type UseDeliveryFeeResult, type UseFxRateOptions, type UseFxRateResult, type UseLocationsOptions, type UseLocationsResult, type UseOrderOptions, type UseOrderResult, type UseOrdersOptions, type UseOrdersResult, type UseProductAvailabilityOptions, type UseProductAvailabilityResult, type UseProductDealsOptions, type UseProductDealsResult, type UseProductOptions, type UseProductPriceInput, type UseProductPriceResult, type UseProductResult, type UseProductSchedulesOptions, type UseProductSchedulesResult, type UseProductsOnSaleOptions, type UseProductsOnSaleResult, type UseProductsOptions, type UseProductsResult, type UsePropertyFacetsOptions, type UsePropertyFacetsResult, type UseQuoteInput, type UseQuoteOptions, type UseQuoteResult, type UseRecommendationsOptions, type UseRecommendationsResult, type UseSearchOptions, type UseSearchResult, type UseServiceAvailabilityOptions, type UseServiceAvailabilityResult, type UseServicesOptions, type UseServicesResult, type UseTaxonomiesOptions, type UseTaxonomiesResult, type UseTaxonomyOptions, type UseTaxonomyPathOptions, type UseTaxonomyPathResult, type UseTaxonomyResult, type UseValidateDiscountOptions, type UseValidateDiscountResult, type UseVariantSelectorOptions, type UseVariantSelectorResult, VariantSelector, type VariantSelectorClassNames, type VariantSelectorProps, cn, useActivityState, useAds, useAttributeDefinitions, useAvailableSlots, useBillingPlans, useBookings, useBootstrap, useBundles, useCart, useCategories, useCheckout, useCimplify, useCimplifyClient, useCollection, useCollections, useDeals, useDeliveryFee, useElements, useElementsReady, useFxRate, useLocations, useOptionalCimplify, useOrder, useOrders, useProduct, useProductAvailability, useProductDeals, useProductPrice, useProductSchedules, useProducts, useProductsOnSale, usePropertyFacets, useQuote, useRecommendations, useSearch, useServiceAvailability, useServices, useTaxonomies, useTaxonomy, useTaxonomyPath, useValidateDiscount, useVariantSelector };