yt-uikit 0.8.17 → 0.8.18-freebie-milestone.0

package/dist/esm/types/components/Nudge/LeadGenerationNudge.d.ts

@@ -1,15 +1,15 @@
-import React from "react";
-import "./Nudge.scss";
-import "react-international-phone/style.css";
-type LeadGenerationNudgeProps = {
-    ctaButtonColor?: string;
-    headerColor?: string;
-    title?: string;
-    subtitle?: string;
-    handleLoginOrSignup?: (phoneNumber: string, email: string) => Promise<any>;
-    handleSubmit?: (phoneNumber: string, otp: string) => Promise<any>;
-    onClose?: () => void;
-    closeIconColor?: string;
-};
-declare const LeadGenerationNudge: ({ ctaButtonColor, headerColor, handleLoginOrSignup, handleSubmit, title, subtitle, onClose, closeIconColor, }: LeadGenerationNudgeProps) => React.JSX.Element;
-export default LeadGenerationNudge;
+import React from "react";
+import "./Nudge.scss";
+import "react-international-phone/style.css";
+type LeadGenerationNudgeProps = {
+    ctaButtonColor?: string;
+    headerColor?: string;
+    title?: string;
+    subtitle?: string;
+    handleLoginOrSignup?: (phoneNumber: string, email: string) => Promise<any>;
+    handleSubmit?: (phoneNumber: string, otp: string) => Promise<any>;
+    onClose?: () => void;
+    closeIconColor?: string;
+};
+declare const LeadGenerationNudge: ({ ctaButtonColor, headerColor, handleLoginOrSignup, handleSubmit, title, subtitle, onClose, closeIconColor, }: LeadGenerationNudgeProps) => React.JSX.Element;
+export default LeadGenerationNudge;

package/dist/esm/types/components/Nudge/Nudge.d.ts

@@ -1,40 +1,40 @@
-import React from "react";
-export interface NudgeProps {
-    title?: string;
-    text?: string;
-    highlightColor?: string;
-    backgroundColor?: string;
-    variant?: "campaign" | "delivery" | "checkout" | "postPurchase" | "registration" | "leadGeneration";
-    extraProps?: any;
-    cartValue?: number;
-    freeDeliveryValue?: number;
-    imageUrl?: string;
-    nudgeImageUrl?: string;
-    onClickCheckout?: () => void;
-    onClose?: () => void;
-    isDev?: boolean;
-    onGotoCartClick?: () => void;
-    bannerCtaAction?: () => void;
-    bannerCtaText?: string;
-    ctaButtonBackgroundColor?: string;
-    ctaTextColor?: string;
-    ctaButtonText?: string;
-    ctaButtonPosition?: "left" | "right" | "center";
-    postPurchaseCtaAction?: () => void;
-    postPurchaseCredits?: number;
-    largeScreenImageUrl?: string;
-    smallScreenImageUrl?: string;
-    ctaButtonLink?: string;
-    autoCloseTimeout?: number;
-    isCTAButtonEnabled?: boolean;
-    isCTARedirectionEnabled?: boolean;
-    borderRadius?: string;
-    padding?: string;
-    onClickCtaButton?: () => void;
-    position?: "right" | "left";
-    closeIconColor?: string;
-    handleLoginOrSignup?: (phoneNumber: string, email: string) => Promise<any>;
-    handleSubmit?: (phoneNumber: string, otp: string) => Promise<any>;
-}
-declare const Nudge: React.FC<NudgeProps>;
-export default Nudge;
+import React from "react";
+export interface NudgeProps {
+    title?: string;
+    text?: string;
+    highlightColor?: string;
+    backgroundColor?: string;
+    variant?: "campaign" | "delivery" | "checkout" | "postPurchase" | "registration" | "leadGeneration";
+    extraProps?: any;
+    cartValue?: number;
+    freeDeliveryValue?: number;
+    imageUrl?: string;
+    nudgeImageUrl?: string;
+    onClickCheckout?: () => void;
+    onClose?: () => void;
+    isDev?: boolean;
+    onGotoCartClick?: () => void;
+    bannerCtaAction?: () => void;
+    bannerCtaText?: string;
+    ctaButtonBackgroundColor?: string;
+    ctaTextColor?: string;
+    ctaButtonText?: string;
+    ctaButtonPosition?: "left" | "right" | "center";
+    postPurchaseCtaAction?: () => void;
+    postPurchaseCredits?: number;
+    largeScreenImageUrl?: string;
+    smallScreenImageUrl?: string;
+    ctaButtonLink?: string;
+    autoCloseTimeout?: number;
+    isCTAButtonEnabled?: boolean;
+    isCTARedirectionEnabled?: boolean;
+    borderRadius?: string;
+    padding?: string;
+    onClickCtaButton?: () => void;
+    position?: "right" | "left";
+    closeIconColor?: string;
+    handleLoginOrSignup?: (phoneNumber: string, email: string) => Promise<any>;
+    handleSubmit?: (phoneNumber: string, otp: string) => Promise<any>;
+}
+declare const Nudge: React.FC<NudgeProps>;
+export default Nudge;

package/dist/esm/types/components/Nudge/index.d.ts

@@ -1 +1 @@
-export { default } from "./Nudge";
+export { default } from "./Nudge";

package/dist/esm/types/components/ProductOffersBlock/ProductOffersCoupon.d.ts

@@ -1,12 +1,12 @@
-import React from "react";
-import { CartCheckpoint } from "./ProductsOffers";
-import { ProductsOffersConfigType } from "./ProductsOffers";
-interface ProductOffersCouponProps {
-    offersToShow: CartCheckpoint[];
-    offersConfig?: ProductsOffersConfigType | null;
-    getOfferCardMessage: (offer: CartCheckpoint) => string;
-    setSelectedOffer: (offer: CartCheckpoint | null) => void;
-    setShowPopup: (show: boolean) => void;
-}
-export declare const ProductOffersCoupon: ({ offersToShow, offersConfig, getOfferCardMessage, setSelectedOffer, setShowPopup, }: ProductOffersCouponProps) => React.JSX.Element;
-export {};
+import React from "react";
+import { CartCheckpoint } from "./ProductsOffers";
+import { ProductsOffersConfigType } from "./ProductsOffers";
+interface ProductOffersCouponProps {
+    offersToShow: CartCheckpoint[];
+    offersConfig?: ProductsOffersConfigType | null;
+    getOfferCardMessage: (offer: CartCheckpoint) => string;
+    setSelectedOffer: (offer: CartCheckpoint | null) => void;
+    setShowPopup: (show: boolean) => void;
+}
+export declare const ProductOffersCoupon: ({ offersToShow, offersConfig, getOfferCardMessage, setSelectedOffer, setShowPopup, }: ProductOffersCouponProps) => React.JSX.Element;
+export {};

package/dist/esm/types/components/ProductOffersBlock/ProductOffersList.d.ts

@@ -1,12 +1,12 @@
-import React from "react";
-import { CartCheckpoint } from "./ProductsOffers";
-import { ProductsOffersConfigType } from "./ProductsOffers";
-interface ProductOffersListProps {
-    offersToShow: CartCheckpoint[];
-    offersConfig: ProductsOffersConfigType;
-    getOfferCardMessage: (offer: CartCheckpoint) => string;
-    setSelectedOffer: (offer: CartCheckpoint | null) => void;
-    setShowPopup: (show: boolean) => void;
-}
-export declare const ProductOffersList: ({ offersToShow, offersConfig, getOfferCardMessage, setSelectedOffer, setShowPopup, }: ProductOffersListProps) => React.JSX.Element;
-export {};
+import React from "react";
+import { CartCheckpoint } from "./ProductsOffers";
+import { ProductsOffersConfigType } from "./ProductsOffers";
+interface ProductOffersListProps {
+    offersToShow: CartCheckpoint[];
+    offersConfig: ProductsOffersConfigType;
+    getOfferCardMessage: (offer: CartCheckpoint) => string;
+    setSelectedOffer: (offer: CartCheckpoint | null) => void;
+    setShowPopup: (show: boolean) => void;
+}
+export declare const ProductOffersList: ({ offersToShow, offersConfig, getOfferCardMessage, setSelectedOffer, setShowPopup, }: ProductOffersListProps) => React.JSX.Element;
+export {};

package/dist/esm/types/components/ProductOffersBlock/ProductOffersTermsMobilePopover.d.ts

@@ -1,10 +1,10 @@
-import React from "react";
-import { CartCheckpoint, OfferTermsAndConditions } from "./ProductsOffers";
-import { ProductsOffersConfigType } from "./ProductsOffers";
-export declare const ProductOffersTermsMobilePopover: ({ showPopup, selectedOffer, selectedOfferTerms, onClose, offersConfig, }: {
-    showPopup: boolean;
-    selectedOffer: CartCheckpoint | null;
-    selectedOfferTerms: OfferTermsAndConditions | null;
-    onClose: () => void;
-    offersConfig?: ProductsOffersConfigType | null | undefined;
-}) => React.ReactPortal | null;
+import React from "react";
+import { CartCheckpoint, OfferTermsAndConditions } from "./ProductsOffers";
+import { ProductsOffersConfigType } from "./ProductsOffers";
+export declare const ProductOffersTermsMobilePopover: ({ showPopup, selectedOffer, selectedOfferTerms, onClose, offersConfig, }: {
+    showPopup: boolean;
+    selectedOffer: CartCheckpoint | null;
+    selectedOfferTerms: OfferTermsAndConditions | null;
+    onClose: () => void;
+    offersConfig?: ProductsOffersConfigType | null | undefined;
+}) => React.ReactPortal | null;

package/dist/esm/types/components/ProductOffersBlock/ProductOffersTermsPopup.d.ts

@@ -1,10 +1,10 @@
-import React from "react";
-import { CartCheckpoint, OfferTermsAndConditions } from "./ProductsOffers";
-import { ProductsOffersConfigType } from "./ProductsOffers";
-export declare const ProductOffersTermsPopup: ({ showPopup, selectedOffer, selectedOfferTerms, onClose, offersConfig, }: {
-    showPopup: boolean;
-    selectedOffer: CartCheckpoint | null;
-    selectedOfferTerms: OfferTermsAndConditions | null;
-    onClose: () => void;
-    offersConfig?: ProductsOffersConfigType | null | undefined;
-}) => React.ReactPortal | null;
+import React from "react";
+import { CartCheckpoint, OfferTermsAndConditions } from "./ProductsOffers";
+import { ProductsOffersConfigType } from "./ProductsOffers";
+export declare const ProductOffersTermsPopup: ({ showPopup, selectedOffer, selectedOfferTerms, onClose, offersConfig, }: {
+    showPopup: boolean;
+    selectedOffer: CartCheckpoint | null;
+    selectedOfferTerms: OfferTermsAndConditions | null;
+    onClose: () => void;
+    offersConfig?: ProductsOffersConfigType | null | undefined;
+}) => React.ReactPortal | null;

package/dist/esm/types/components/ProductOffersBlock/ProductsOffers.d.ts

@@ -1,32 +1,32 @@
-import React from "react";
-import { Checkpoint } from "../Cart/Cart";
-export interface ProductsOffersConfigType {
-    sectionType?: "coupon" | "list";
-    sectionTitle?: string;
-    sectionBackgroundColor?: string;
-    sectionBgContrastColor?: string;
-    cardBackgroundColor?: string;
-    cardBackgroundTransparent?: boolean;
-    textColor?: string;
-    accentColor?: string;
-    roundness?: number;
-    cardPadding?: number;
-    viewDetailsTitle?: string;
-    alignment?: "left" | "middle" | "right";
-    iconVisibility?: boolean;
-    popupIsolationStrategy?: "revert" | "revert-layer" | "unset" | "initial" | "inherit" | "none";
-}
-export interface CartCheckpoint extends Checkpoint {
-    customCartProgressBarCriteria?: string | null;
-    discountPercentage?: number | null;
-    discountId?: number | null;
-}
-export interface OfferTermsAndConditions {
-    offerMessage: string;
-    terms: string[];
-}
-declare const ProductsOffers: ({ offersConfig, offers, }: {
-    offersConfig?: ProductsOffersConfigType | null | undefined;
-    offers: CartCheckpoint[];
-}) => React.JSX.Element;
-export default ProductsOffers;
+import React from "react";
+import { Checkpoint } from "../Cart/Cart";
+export interface ProductsOffersConfigType {
+    sectionType?: "coupon" | "list";
+    sectionTitle?: string;
+    sectionBackgroundColor?: string;
+    sectionBgContrastColor?: string;
+    cardBackgroundColor?: string;
+    cardBackgroundTransparent?: boolean;
+    textColor?: string;
+    accentColor?: string;
+    roundness?: number;
+    cardPadding?: number;
+    viewDetailsTitle?: string;
+    alignment?: "left" | "middle" | "right";
+    iconVisibility?: boolean;
+    popupIsolationStrategy?: "revert" | "revert-layer" | "unset" | "initial" | "inherit" | "none";
+}
+export interface CartCheckpoint extends Checkpoint {
+    customCartProgressBarCriteria?: string | null;
+    discountPercentage?: number | null;
+    discountId?: number | null;
+}
+export interface OfferTermsAndConditions {
+    offerMessage: string;
+    terms: string[];
+}
+declare const ProductsOffers: ({ offersConfig, offers, }: {
+    offersConfig?: ProductsOffersConfigType | null | undefined;
+    offers: CartCheckpoint[];
+}) => React.JSX.Element;
+export default ProductsOffers;

package/dist/esm/types/components/SpinnerWheel/SpinnerWheel.d.ts

@@ -1,23 +1,23 @@
-import React from "react";
-import type { Dispatch, SetStateAction } from "react";
-interface SegmentProps {
-    label: string;
-    color: string;
-    outcome: "WIN" | "LOSE";
-    winHeading?: string;
-    winValue?: number;
-    probability?: number;
-}
-export interface WheelProps {
-    segments: SegmentProps[];
-    setWinningSegment: Dispatch<SetStateAction<number | null>>;
-    ctaButtonText?: string;
-    brandThemeColor?: string | undefined;
-    brandGameDefaultThemeColor?: string | undefined;
-    wheelSectionColor1?: string | undefined;
-    wheelSectionColor2?: string | undefined;
-    wheelCenterLogo?: string | undefined;
-    isStatic?: boolean | undefined;
-}
-declare const SpinnerWheel: React.FC<WheelProps>;
-export default SpinnerWheel;
+import React from "react";
+import type { Dispatch, SetStateAction } from "react";
+interface SegmentProps {
+    label: string;
+    color: string;
+    outcome: "WIN" | "LOSE";
+    winHeading?: string;
+    winValue?: number;
+    probability?: number;
+}
+export interface WheelProps {
+    segments: SegmentProps[];
+    setWinningSegment: Dispatch<SetStateAction<number | null>>;
+    ctaButtonText?: string;
+    brandThemeColor?: string | undefined;
+    brandGameDefaultThemeColor?: string | undefined;
+    wheelSectionColor1?: string | undefined;
+    wheelSectionColor2?: string | undefined;
+    wheelCenterLogo?: string | undefined;
+    isStatic?: boolean | undefined;
+}
+declare const SpinnerWheel: React.FC<WheelProps>;
+export default SpinnerWheel;

package/dist/esm/types/components/SpinnerWheel/WheelSection.d.ts

@@ -1,9 +1,9 @@
-import React from "react";
-interface WheelSectionProps {
-    color: string;
-    label: string;
-    index: number;
-    total: number;
-}
-export declare const WheelSection: React.FC<WheelSectionProps>;
-export {};
+import React from "react";
+interface WheelSectionProps {
+    color: string;
+    label: string;
+    index: number;
+    total: number;
+}
+export declare const WheelSection: React.FC<WheelSectionProps>;
+export {};

package/dist/esm/types/components/SpinnerWheel/index.d.ts

@@ -1 +1 @@
-export { default } from "./SpinnerWheel";
+export { default } from "./SpinnerWheel";

package/dist/esm/types/components/index.d.ts

@@ -1,6 +1,6 @@
-export { default as Nudge } from "./Nudge";
-export { default as SpinnerWheel } from "./SpinnerWheel";
-export { default as Cart } from "./Cart";
-export { default as Bundle } from "./BundleBlock";
-export { default as BundleLoader } from "./BundleBlock/Loader";
-export { default as ProductOffers, ProductsOffersConfigType, CartCheckpoint, } from "./ProductOffersBlock/ProductsOffers";
+export { default as Nudge } from "./Nudge";
+export { default as SpinnerWheel } from "./SpinnerWheel";
+export { default as Cart } from "./Cart";
+export { default as Bundle } from "./BundleBlock";
+export { default as BundleLoader } from "./BundleBlock/Loader";
+export { default as ProductOffers, ProductsOffersConfigType, CartCheckpoint, } from "./ProductOffersBlock/ProductsOffers";

package/dist/esm/types/components/shared/Spinner.d.ts

@@ -0,0 +1,23 @@
+import React from "react";
+export interface SpinnerProps {
+    color?: string;
+    size?: number;
+    loading?: boolean;
+}
+/**
+ * A lightweight CSS-only spinner component to replace ClipLoader from react-spinners.
+ * Uses CSS animations for the spinning effect.
+ */
+export declare const Spinner: React.FC<SpinnerProps>;
+export interface ScaleLoaderProps {
+    color?: string;
+    loading?: boolean;
+    height?: number;
+    width?: number;
+}
+/**
+ * A lightweight CSS-only scale loader component to replace ScaleLoader from react-spinners.
+ * Displays animated bars that pulse in sequence.
+ */
+export declare const ScaleLoader: React.FC<ScaleLoaderProps>;
+export default Spinner;

package/dist/esm/types/components/shared/index.d.ts

@@ -0,0 +1,2 @@
+export { Spinner, ScaleLoader } from "./Spinner";
+export type { SpinnerProps, ScaleLoaderProps } from "./Spinner";

package/dist/esm/types/index.d.ts

@@ -1 +1 @@
-export * from "./components";
+export * from "./components";

package/dist/esm/types/utils/converter.d.ts

@@ -1,2 +1,2 @@
-export declare const getCurrencyValueFromShopifyPrice: (price: number, currency: string) => number;
-export declare const getCurrencySymbol: (cartData: any, currency?: string) => string;
+export declare const getCurrencyValueFromShopifyPrice: (price: number, currency: string) => number;
+export declare const getCurrencySymbol: (cartData: any, currency?: string) => string;

package/dist/esm/types/utils/customVariantOptions.d.ts

@@ -1,20 +1,20 @@
-export interface CustomVariantValue {
-    name: string;
-    value: string;
-}
-export interface CustomVariantOption {
-    id?: string;
-    name: string;
-    type?: "text" | "image" | "color" | string;
-    values: CustomVariantValue[];
-}
-export interface CustomVariantOptions {
-    options: CustomVariantOption[];
-}
-export declare const normalizeVariantLabel: (label?: string) => string;
-export declare const extractHexFromLabel: (label?: string) => string | null;
-export declare const loadCustomVariantOptions: () => CustomVariantOptions | null;
-export declare const saveCustomVariantOptions: (input: CustomVariantOptions | CustomVariantOption[]) => void;
-export declare const clearCustomVariantOptions: () => void;
-export declare const findMatchingCustomVariantValue: (customOption: CustomVariantOption | undefined, optionValue?: string) => CustomVariantValue | undefined;
-export declare const useCustomVariantOptions: () => CustomVariantOptions | null;
+export interface CustomVariantValue {
+    name: string;
+    value: string;
+}
+export interface CustomVariantOption {
+    id?: string;
+    name: string;
+    type?: "text" | "image" | "color" | string;
+    values: CustomVariantValue[];
+}
+export interface CustomVariantOptions {
+    options: CustomVariantOption[];
+}
+export declare const normalizeVariantLabel: (label?: string) => string;
+export declare const extractHexFromLabel: (label?: string) => string | null;
+export declare const loadCustomVariantOptions: () => CustomVariantOptions | null;
+export declare const saveCustomVariantOptions: (input: CustomVariantOptions | CustomVariantOption[]) => void;
+export declare const clearCustomVariantOptions: () => void;
+export declare const findMatchingCustomVariantValue: (customOption: CustomVariantOption | undefined, optionValue?: string) => CustomVariantValue | undefined;
+export declare const useCustomVariantOptions: () => CustomVariantOptions | null;

package/dist/esm/types/utils/freebieErrorLogger.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Centralized error logging utility for Freebie Claim components
+ * Provides detailed error logging with context to help debug issues across stores
+ */
+export declare enum FreebieErrorSeverity {
+    WARNING = "WARNING",
+    ERROR = "ERROR",
+    CRITICAL = "CRITICAL"
+}
+export interface FreebieErrorContext {
+    component?: string;
+    productId?: string;
+    productTitle?: string;
+    variantId?: string;
+    checkpointId?: number;
+    storeData?: any;
+    additionalData?: any;
+}
+export interface FreebieError {
+    severity: FreebieErrorSeverity;
+    message: string;
+    context: FreebieErrorContext;
+    timestamp: string;
+}
+declare class FreebieErrorLogger {
+    private errors;
+    private maxErrors;
+    /**
+     * Log an error with context
+     */
+    log(severity: FreebieErrorSeverity, message: string, context?: FreebieErrorContext): void;
+    /**
+     * Log a warning
+     */
+    warn(message: string, context?: FreebieErrorContext): void;
+    /**
+     * Log an error
+     */
+    error(message: string, context?: FreebieErrorContext): void;
+    /**
+     * Log a critical error
+     */
+    critical(message: string, context?: FreebieErrorContext): void;
+    /**
+     * Get all logged errors
+     */
+    getErrors(): FreebieError[];
+    /**
+     * Get errors by severity
+     */
+    getErrorsBySeverity(severity: FreebieErrorSeverity): FreebieError[];
+    /**
+     * Clear all errors
+     */
+    clearErrors(): void;
+    /**
+     * Export errors as JSON for debugging
+     */
+    exportErrors(): string;
+}
+export declare const freebieErrorLogger: FreebieErrorLogger;
+export declare const logMissingProp: (component: string, propName: string, additionalContext?: any) => void;
+export declare const logInvalidData: (component: string, dataType: string, issue: string, data?: any) => void;
+export declare const logProductError: (component: string, message: string, productId?: string, productTitle?: string, additionalData?: any) => void;
+export declare const logVariantError: (component: string, message: string, productId?: string, variantId?: string, additionalData?: any) => void;
+export declare const logCheckpointError: (component: string, message: string, checkpointId?: number, additionalData?: any) => void;
+export declare const logWarning: (component: string, message: string, context?: FreebieErrorContext) => void;
+export {};

package/dist/esm/types/utils/freebieProductUtils.d.ts

@@ -1,23 +1,23 @@
-export declare const isVariantAvailable: (product: any, variantNode: any) => boolean;
-export interface ProcessedFreebieProduct {
-    selectedVariantId?: string;
-    selectedVariantGid?: string;
-    selectedVariantPrice: number;
-    availableVariants: any[];
-    displayVariantCount: number;
-    effectiveDiscount: number;
-    effectivePrice: number;
-    dealAmount: number;
-    showOptions: boolean;
-    isFree: boolean;
-}
-/**
- * Process freebie product data to extract pricing, variant, and display information
- * Consolidates expensive calculations that were happening in multiple components
- */
-export declare const processFreebieProduct: (product: any, freebieCouponTemplates?: any[], localVariantId?: string) => ProcessedFreebieProduct;
-/**
- * Get initial variant ID with deal amount preference
- * Used by FreebieClaimSectionCard for smart variant selection
- */
-export declare const getInitialVariantWithDealAmount: (availableVariants: any[], freebieCouponTemplates?: any[]) => string | undefined;
+export declare const isVariantAvailable: (product: any, variantNode: any) => boolean;
+export interface ProcessedFreebieProduct {
+    selectedVariantId?: string;
+    selectedVariantGid?: string;
+    selectedVariantPrice: number;
+    availableVariants: any[];
+    displayVariantCount: number;
+    effectiveDiscount: number;
+    effectivePrice: number;
+    dealAmount: number;
+    showOptions: boolean;
+    isFree: boolean;
+}
+/**
+ * Process freebie product data to extract pricing, variant, and display information
+ * Consolidates expensive calculations that were happening in multiple components
+ */
+export declare const processFreebieProduct: (product: any, freebieCouponTemplates?: any[], localVariantId?: string) => ProcessedFreebieProduct;
+/**
+ * Get initial variant ID with deal amount preference
+ * Used by FreebieClaimSectionCard for smart variant selection
+ */
+export declare const getInitialVariantWithDealAmount: (availableVariants: any[], freebieCouponTemplates?: any[]) => string | undefined;

package/dist/esm/types/utils/freebieUtils.d.ts

@@ -1,5 +1,5 @@
-/**
- * Shared utility function for adding freebie products to cart
- * Used by both FreebieClaimManager and FreebieClaimSection to avoid code duplication
- */
-export declare const addFreebieProductsToCart: (selectedProductIds: string[], freebieProductsInCart: any[], addFreebieToCart?: ((variantId: string, originalAllowedVariantIds?: string[]) => Promise<void>) | undefined) => Promise<void>;
+/**
+ * Shared utility function for adding freebie products to cart
+ * Used by both FreebieClaimManager and FreebieClaimSection to avoid code duplication
+ */
+export declare const addFreebieProductsToCart: (selectedProductIds: string[], freebieProductsInCart: any[], addFreebieToCart?: ((variantId: string, originalAllowedVariantIds?: string[]) => Promise<void>) | undefined) => Promise<void>;

package/dist/esm/types/utils/freebieValidation.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Validation utilities for Freebie Claim components
+ * Validates product data, configuration, and required props
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate that required props are present
+ */
+export declare const validateRequiredProps: (component: string, props: {
+    freebieProductsInCart?: any[];
+    addFreebieToCart?: Function;
+    freebiesInCart?: string[];
+}) => ValidationResult;
+/**
+ * Validate product data structure
+ */
+export declare const validateProductData: (component: string, product: any, index?: number) => ValidationResult;
+/**
+ * Validate all products in cart
+ */
+export declare const validateAllProducts: (component: string, products: any[]) => ValidationResult;
+/**
+ * Validate variant data
+ */
+export declare const validateVariantData: (component: string, variant: any, productId?: string) => ValidationResult;
+/**
+ * Validate checkpoint data
+ */
+export declare const validateCheckpoint: (component: string, checkpoint: any) => ValidationResult;
+/**
+ * Validate freebie claim configuration
+ */
+export declare const validateFreebieClaimData: (component: string, freebieClaimData: any) => ValidationResult;
+/**
+ * Validate that products match inventory requirements
+ */
+export declare const validateInventoryQuantity: (component: string, product: any, shouldCheckInventoryQuantity: boolean) => ValidationResult;
+/**
+ * Log validation summary
+ */
+export declare const logValidationSummary: (component: string, validationResults: ValidationResult[]) => void;