@cimplify/sdk 0.8.14 → 0.9.1

package/dist/react.d.ts

@@ -1,8 +1,8 @@
 import React, { ReactNode } from 'react';
-import { A as AdSlot, a as AdPosition, e as AdContextValue } from './ads-t3FBTU8p.js';
-export { c as AdConfig } from './ads-t3FBTU8p.js';
-import { C as CimplifyClient, Y as ProcessCheckoutResult, _ as CheckoutStatus, $ as CheckoutStatusContext, bq as Location, bn as Business, aS as Order, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, P as PriceQuote, g as QuoteUiMessage, w as ElementsOptions, cK as AuthenticatedData, cG as AddressInfo, cH as PaymentMethodInfo, s as CimplifyElements, cM as ElementsCheckoutResult, X as ProcessCheckoutOptions } from './client-9gpFQIeG.js';
-import { r as Product, d as Pagination, h as CimplifyError, s as ProductWithDetails, L as Category, ax as BundleSelectionInput, a8 as ComponentSelectionInput, O as Collection, Y as BundleWithDetails, a4 as CompositeWithDetails, a9 as CompositePriceResult, C as CurrencyCode } from './payment-BKjX2fAs.js';
+import { A as AdSlot, a as AdPosition, e as AdContextValue } from './ads-DeL3PGzf.js';
+export { c as AdConfig, g as getVariantDisplayName } from './ads-DeL3PGzf.js';
+import { C as CimplifyClient, Y as ProcessCheckoutResult, _ as CheckoutStatus, $ as CheckoutStatusContext, bq as Location, bn as Business, aS as Order, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, P as PriceQuote, g as QuoteUiMessage, w as ElementsOptions, cK as AuthenticatedData, cG as AddressInfo, cH as PaymentMethodInfo, s as CimplifyElements, cM as ElementsCheckoutResult, X as ProcessCheckoutOptions } from './client-vi6GsbUP.js';
+import { r as Product, d as Pagination, h as CimplifyError, s as ProductWithDetails, L as Category, ax as BundleSelectionInput, a8 as ComponentSelectionInput, O as Collection, Y as BundleWithDetails, a4 as CompositeWithDetails, a9 as CompositePriceResult, C as CurrencyCode, t as ProductVariant, w as VariantAxisWithValues, M as Money, G as AddOnWithOptions } from './payment-BNlyzm_Q.js';
 
 interface UserIdentity {
     uid: string;
@@ -404,4 +404,119 @@ declare function useCheckout(): {
     isLoading: boolean;
 };
 
-export { Ad, AdPosition, type AdProps, AdProvider, AdSlot, type AddToCartOptions, AddressElement, AuthElement, CimplifyCheckout, type CimplifyCheckoutProps, type CimplifyContextValue, CimplifyProvider, type CimplifyProviderProps, ElementsProvider, PaymentElement, Price, type PriceProps, type UseBundleOptions, type UseBundleResult, type UseCartItem, type UseCartOptions, type UseCartResult, type UseCategoriesOptions, type UseCategoriesResult, type UseCollectionOptions, type UseCollectionResult, type UseCollectionsOptions, type UseCollectionsResult, type UseCompositeOptions, type UseCompositeResult, type UseLocationsOptions, type UseLocationsResult, type UseOrderOptions, type UseOrderResult, type UseProductOptions, type UseProductResult, type UseProductsOptions, type UseProductsResult, type UseQuoteInput, type UseQuoteOptions, type UseQuoteResult, type UseSearchOptions, type UseSearchResult, useAds, useBundle, useCart, useCategories, useCheckout, useCimplify, useCollection, useCollections, useComposite, useElements, useElementsReady, useLocations, useOptionalCimplify, useOrder, useProduct, useProducts, useQuote, useSearch };
+interface QuantitySelectorProps {
+    value: number;
+    onChange: (value: number) => void;
+    min?: number;
+    max?: number;
+    className?: string;
+}
+/**
+ * QuantitySelector — controlled increment/decrement input.
+ *
+ * Pure presentation. Pass `value` and `onChange` to drive it.
+ */
+declare function QuantitySelector({ value, onChange, min, max, className, }: QuantitySelectorProps): React.ReactElement;
+
+interface VariantSelectorProps {
+    variants: ProductVariant[];
+    variantAxes?: VariantAxisWithValues[];
+    basePrice?: Money;
+    selectedVariantId?: string;
+    onVariantChange: (variantId: string | undefined, variant: ProductVariant | undefined) => void;
+    className?: string;
+}
+/**
+ * VariantSelector — select product variants via axis chips or direct list.
+ *
+ * Axis mode: one row of chips per axis (e.g. Size, Temperature).
+ * Direct mode: a vertical list showing variant name + full effective price.
+ */
+declare function VariantSelector({ variants, variantAxes, basePrice, selectedVariantId, onVariantChange, className, }: VariantSelectorProps): React.ReactElement | null;
+
+interface AddOnSelectorProps {
+    addOns: AddOnWithOptions[];
+    selectedOptions: string[];
+    onOptionsChange: (optionIds: string[]) => void;
+    className?: string;
+}
+/**
+ * AddOnSelector — modifier groups with single-select (radio) or multi-select (checkbox).
+ *
+ * Respects min/max constraints, required flags, and mutual exclusivity.
+ */
+declare function AddOnSelector({ addOns, selectedOptions, onOptionsChange, className, }: AddOnSelectorProps): React.ReactElement | null;
+
+interface CompositeSelectorProps {
+    productId: string;
+    onSelectionsChange: (selections: ComponentSelectionInput[]) => void;
+    onPriceChange?: (price: CompositePriceResult | null) => void;
+    onReady?: (ready: boolean) => void;
+    className?: string;
+}
+/**
+ * CompositeSelector — "build your own" product configurator.
+ *
+ * Renders component groups (e.g. "Choose your base", "Pick toppings") with
+ * min/max selection constraints. Calculates real-time pricing via the SDK.
+ */
+declare function CompositeSelector({ productId, onSelectionsChange, onPriceChange, onReady, className, }: CompositeSelectorProps): React.ReactElement | null;
+
+interface BundleSelectorProps {
+    bundleIdOrSlug: string;
+    onSelectionsChange: (selections: BundleSelectionInput[]) => void;
+    onReady?: (ready: boolean) => void;
+    className?: string;
+}
+/**
+ * BundleSelector — curated product set with optional variant choices.
+ *
+ * Each bundle component shows the included product. If `allow_variant_choice`
+ * is true, the customer can pick which variant they want for that slot.
+ */
+declare function BundleSelector({ bundleIdOrSlug, onSelectionsChange, onReady, className, }: BundleSelectorProps): React.ReactElement | null;
+
+interface ProductCustomizerProps {
+    product: ProductWithDetails;
+    onAddToCart?: (product: ProductWithDetails, quantity: number, options: AddToCartOptions) => void | Promise<void>;
+    className?: string;
+}
+/**
+ * ProductCustomizer — full product customization + add-to-cart flow.
+ *
+ * Auto-detects product_type and routes to CompositeSelector / BundleSelector /
+ * VariantSelector + AddOnSelector. Ships a built-in "Add to Cart" button with
+ * QuantitySelector. When `onAddToCart` is provided it calls that instead of
+ * using the SDK cart (escape hatch for custom logic like toasts).
+ */
+declare function ProductCustomizer({ product, onAddToCart, className, }: ProductCustomizerProps): React.ReactElement;
+
+interface ProductImageGalleryProps {
+    images: string[];
+    productName: string;
+    aspectRatio?: "square" | "4/3" | "16/10" | "3/4";
+    className?: string;
+}
+/**
+ * ProductImageGallery — main image + thumbnail strip.
+ *
+ * Uses plain `<img>` for framework-agnostic rendering (not Next.js Image).
+ */
+declare function ProductImageGallery({ images, productName, aspectRatio, className, }: ProductImageGalleryProps): React.ReactElement | null;
+
+interface CartSummaryProps {
+    onCheckout?: () => void;
+    onItemRemove?: (itemId: string) => void;
+    onQuantityChange?: (itemId: string, quantity: number) => void;
+    emptyMessage?: string;
+    className?: string;
+}
+/**
+ * CartSummary — renders cart line items + totals.
+ *
+ * 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;
+
+export { Ad, AdPosition, type AdProps, AdProvider, AdSlot, AddOnSelector, type AddOnSelectorProps, type AddToCartOptions, AddressElement, AuthElement, BundleSelector, type BundleSelectorProps, CartSummary, type CartSummaryProps, CimplifyCheckout, type CimplifyCheckoutProps, type CimplifyContextValue, CimplifyProvider, type CimplifyProviderProps, CompositeSelector, type CompositeSelectorProps, ElementsProvider, PaymentElement, Price, type PriceProps, ProductCustomizer, type ProductCustomizerProps, ProductImageGallery, type ProductImageGalleryProps, QuantitySelector, type QuantitySelectorProps, type UseBundleOptions, type UseBundleResult, type UseCartItem, type UseCartOptions, type UseCartResult, type UseCategoriesOptions, type UseCategoriesResult, type UseCollectionOptions, type UseCollectionResult, type UseCollectionsOptions, type UseCollectionsResult, type UseCompositeOptions, type UseCompositeResult, type UseLocationsOptions, type UseLocationsResult, type UseOrderOptions, type UseOrderResult, type UseProductOptions, type UseProductResult, type UseProductsOptions, type UseProductsResult, type UseQuoteInput, type UseQuoteOptions, type UseQuoteResult, type UseSearchOptions, type UseSearchResult, VariantSelector, type VariantSelectorProps, useAds, useBundle, useCart, useCategories, useCheckout, useCimplify, useCollection, useCollections, useComposite, useElements, useElementsReady, useLocations, useOptionalCimplify, useOrder, useProduct, useProducts, useQuote, useSearch };