@anker-in/shopify-react 0.1.1-beta.43 → 0.1.1-beta.44

package/dist/hooks/index.d.mts

@@ -2,14 +2,14 @@ import * as swr_mutation from 'swr/mutation';
 import { SWRMutationConfiguration } from 'swr/mutation';
 import * as _anker_in_shopify_sdk from '@anker-in/shopify-sdk';
 import { CartLineInput, NormalizedCart, NormalizedProduct, NormalizedProductVariant, NormalizedLineItem, UpdateCartLinesOptions, HasMetafieldsIdentifier, NormalizedAttribute, Media, NormalizedCollection, CollectionsConnection, NormalizedBlog, NormalizedArticle } from '@anker-in/shopify-sdk';
-import { U as UseAddToCartOptions, a as AddToCartInput, A as AddToCartLineItem, G as GtmParams, B as BuyNowTrackConfig, d as PlusMemberShippingMethodConfig, e as PlusMemberSettingsMetafields, D as DeliveryPlusType, f as SelectedPlusMemberVariant } from '../types-CMMWxyUF.mjs';
+import { U as UseAddToCartOptions, a as AddToCartInput, A as AddToCartLineItem, G as GtmParams, B as BuyNowTrackConfig, e as PlusMemberSettingsMetafields, d as PlusMemberShippingMethodConfig, D as DeliveryPlusType, f as SelectedPlusMemberVariant } from '../types-CMMWxyUF.mjs';
 export { g as DeliveryCustomData, P as PLUS_MEMBER_TYPE, b as PlusMemberMode, c as PlusMemberShippingMethodMetafields, S as ShippingMethodMode } from '../types-CMMWxyUF.mjs';
 import Decimal from 'decimal.js';
 import * as swr from 'swr';
 import swr__default, { SWRConfiguration } from 'swr';
 import * as swr__internal from 'swr/_internal';
 import * as React$1 from 'react';
-import { PropsWithChildren, Dispatch, SetStateAction, RefObject } from 'react';
+import { Dispatch, SetStateAction, PropsWithChildren, RefObject } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 interface CreateCartInput {
@@ -57,7 +57,10 @@ interface CreateCartInput {
  * })
  * ```
  */
-declare function useCreateCart(options?: SWRMutationConfiguration<NormalizedCart | undefined, Error, 'create-cart', CreateCartInput>): swr_mutation.SWRMutationResponse<NormalizedCart | undefined, Error, "create-cart", CreateCartInput>;
+declare function useCreateCart({ updateCookie, options, }: {
+    updateCookie?: boolean;
+    options?: SWRMutationConfiguration<NormalizedCart | undefined, Error, 'create-cart', CreateCartInput>;
+}): swr_mutation.SWRMutationResponse<NormalizedCart | undefined, Error, "create-cart", CreateCartInput>;
 
 interface AddCartLinesInput {
     /** Cart ID (optional, will create new cart if not provided) */
@@ -585,6 +588,7 @@ interface Campaign {
     }>;
     includeTags?: string[];
     useTotalAmount?: boolean;
+    requireLogin?: boolean;
 }
 interface UseScriptAutoFreeGiftResult {
     involvedLines: NormalizedLineItem[];
@@ -595,12 +599,13 @@ interface UseScriptAutoFreeGiftResult {
     involvedSubTotal: Decimal;
     giftProductsResult?: NormalizedProduct[];
 }
-declare const useScriptAutoFreeGift: ({ campaign, _giveaway, cart, locale: providedLocale, lines, }: {
+declare const useScriptAutoFreeGift: ({ campaign, _giveaway, cart, locale: providedLocale, lines, profile, }: {
     campaign: Campaign | null;
     _giveaway: string;
     cart: NormalizedCart | undefined;
     locale?: string;
     lines?: AddToCartLineItem[];
+    profile?: any;
 }) => UseScriptAutoFreeGiftResult;
 
 interface UseCalcGiftsFromLinesOptions {
@@ -685,223 +690,90 @@ interface OrderDiscountResult {
  */
 declare const useCalcOrderDiscount: (cart: any, orderDiscountConfig?: OrderDiscountConfig[], customer?: any) => OrderDiscountResult;
 
-interface ShippingMethodsContext {
-    freeShippingMethods: PlusMemberShippingMethodConfig[];
-    paymentShippingMethods: PlusMemberShippingMethodConfig[];
-    nddOverweight: boolean;
-    tddOverweight: boolean;
-    nddCoupon?: string;
-    tddCoupon?: string;
-    isLoadingCoupon: boolean;
-}
-interface PlusMemberContextValue<TProduct = any, TVariant = any, TProfile extends {
-    isPlus?: boolean;
-} = any> {
-    plusMemberMetafields: PlusMemberSettingsMetafields;
-    selectedPlusMemberMode: DeliveryPlusType;
-    setSelectedPlusMemberMode: (value: DeliveryPlusType) => void;
-    selectedShippingMethod?: PlusMemberShippingMethodConfig;
-    setSelectedShippingMethod: (value: PlusMemberShippingMethodConfig) => void;
-    showMoreShippingMethod: boolean;
-    setShowMoreShippingMethod: (value: boolean) => void;
-    variant: TVariant;
-    product: TProduct;
-    shippingMethodsContext: ShippingMethodsContext;
-    selectedPlusMemberVariant: SelectedPlusMemberVariant;
-    showPlusMemberBenefit: boolean;
-    setShowPlusMemberBenefit: (value: boolean) => void;
-    profile?: TProfile;
-}
-declare const PlusMemberContext: React$1.Context<PlusMemberContextValue<any, any, any>>;
-
-/**
- * Hook to access Plus Member Context
- */
-declare function usePlusMemberContext<TProfile extends {
-    isPlus?: boolean;
-} = any>(): PlusMemberContextValue<any, any, any>;
-
-/**
- * Hook to get Plus Member Product Variants (Monthly and Annual)
- */
-
-interface UsePlusMemberVariantsOptions {
-    /** Plus member metafields configuration */
-    memberSetting: PlusMemberSettingsMetafields;
-}
-interface UsePlusMemberVariantsResult {
-    monthlyVariant?: NormalizedProductVariant & {
-        product: NormalizedProduct | undefined;
-    };
-    annualVariant?: NormalizedProductVariant & {
-        product: NormalizedProduct | undefined;
-    };
-}
-/**
- * Get Plus Member product variants (monthly and annual)
- *
- * @param options - Configuration options
- * @returns Monthly and annual variants
- *
- * @example
- * ```tsx
- * const { monthlyVariant, annualVariant } = usePlusMemberVariants({
- *   plusMemberMetafields
- * })
- * ```
- */
-declare function usePlusMemberVariants({ memberSetting, }: UsePlusMemberVariantsOptions): UsePlusMemberVariantsResult;
-
+declare const getReferralAttributes: () => {
+    key: string;
+    value: any;
+}[];
 /**
- * Hook to calculate available shipping methods based on product weight and member status
+ * Get user type based on customer information
  */
-
-interface UseShippingMethodsOptions<TVariant = any, TProfile extends {
-    isPlus?: boolean;
-} = any> {
-    /** Product variant with weight information */
-    variant: TVariant;
-    /** Plus member metafields configuration */
-    plusMemberMetafields: PlusMemberSettingsMetafields;
-    /** Selected plus member mode */
-    selectedPlusMemberMode: DeliveryPlusType;
-    profile?: TProfile;
-}
-interface UseShippingMethodsResult {
-    freeShippingMethods: PlusMemberShippingMethodConfig[];
-    paymentShippingMethods: PlusMemberShippingMethodConfig[];
-    nddOverweight: boolean;
-    tddOverweight: boolean;
-    nddCoupon?: string;
-    tddCoupon?: string;
-    isLoadingCoupon: boolean;
+declare const getUserType: (customer?: any) => string;
+interface GetCartAttributesProps {
+    profile?: any;
+    customer?: any;
+    cart?: NormalizedCart;
+    memberType?: string;
+    currentUrl?: string;
 }
 /**
- * Calculate available shipping methods based on product weight, member status, and available coupons
- *
- * @param options - Configuration options
- * @returns Shipping methods categorized by free/payment and overweight status
- *
- * @example
- * ```tsx
- * const { freeShippingMethods, paymentShippingMethods, nddOverweight, tddOverweight } = useShippingMethods({
- *   variant,
- *   plusMemberMetafields,
- *   selectedPlusMemberMode,
- * })
- * ```
- */
-declare function useShippingMethods<TVariant extends {
-    weight?: number;
-} = any>(options: UseShippingMethodsOptions<TVariant>): UseShippingMethodsResult;
-
-/**
- * Hook to replace cart plus member product
- *
- * When adding a monthly membership while an annual membership exists in cart,
- * the annual membership will be replaced and vice versa.
- *
- * @returns Handler function to replace conflicting membership products
- *
- * @example
- * ```tsx
- * const replaceCartPlusMember = useReplaceCartPlusMember()
- *
- * // Call before adding new membership product
- * await replaceCartPlusMember()
- * ```
- */
-declare const useReplaceCartPlusMember: () => () => Promise<void>;
-
-/**
- * Hook to get delivery discount codes from delivery data
- *
- * Extracts and returns the discount codes from the delivery custom data.
- *
- * @returns Array of discount codes or undefined
- *
- * @example
- * ```tsx
- * const deliveryCodes = usePlusMemberDeliveryCodes()
- * ```
+ * Get cart attributes (pure function version)
  */
-declare const usePlusMemberDeliveryCodes: () => (string | undefined)[];
-
-declare const usePlusMemberCheckoutCustomAttributes: ({ disableShipping, isPresaleContains, }: {
-    disableShipping?: boolean;
-    isPresaleContains?: boolean;
-}) => NormalizedAttribute[];
-
+declare function getCartAttributes({ profile, customer, cart, memberType, currentUrl, }: GetCartAttributesProps): Array<{
+    key: string;
+    value: any;
+}>;
 /**
- * useAutoRemovePlusMemberInCart Hook
- * 付费会员身份自动移除购物车中的会员产品
- * 年费会员删除月费会员产品，月费会员删除年费会员产品
+ * Hook to get cart attributes
  */
-
-interface UseAutoRemovePlusMemberInCartProps {
+declare const useCartAttributes: ({ profile, customer, cart, memberType, }: {
     profile: any;
+    customer: any;
     cart?: NormalizedCart;
-    memberSetting: PlusMemberSettingsMetafields;
-}
-/**
- * 自动移除购物车中的会员产品
- *
- * @param props - Hook 参数
- * @param props.memberSetting - Plus Member 配置
- * @param props.isMonthlyPlus - 用户是否是月费会员
- * @param props.isAnnualPlus - 用户是否是年费会员
- *
- * @example
- * ```tsx
- * const { profile } = useProfile()
- *
- * useAutoRemovePlusMemberInCart({
- *   cart,
- *   profile,
- * })
- * ```
- */
-declare function useAutoRemovePlusMemberInCart({ cart, profile, memberSetting, }: UseAutoRemovePlusMemberInCartProps): void;
+    memberType?: string;
+}) => {
+    attributes: Array<{
+        key: string;
+        value: any;
+    }>;
+};
+
+declare const useCartItemQuantityLimit: ({ cart, cartItem, config, }: {
+    cart?: NormalizedCart;
+    cartItem: NormalizedLineItem;
+    config: {
+        handle: Record<string, {
+            min: number;
+            max: number;
+        }>;
+        sku: Record<string, {
+            min: number;
+            max: number;
+        }>;
+    };
+}) => {
+    min: number;
+    max: number;
+};
 
 /**
- * Has Plus Member In Cart
- * 判断购物车中是否包含年费会员或月费会员产品
+ * Hook to check if plus member products are in line items
+ * 判断加购的 line 中是否包含付费会员产品
  */
 
-interface HasPlusMemberInCartProps {
+interface UseHasPlusMemberInLinesProps {
     /** Plus Member 配置 */
     memberSetting?: PlusMemberSettingsMetafields;
-    /** 购物车数据 */
-    cart?: NormalizedCart;
+    /** 加购的 line items */
+    lines: AddToCartLineItem[];
 }
-interface HasPlusMemberInCartResult {
-    /** 购物车中是否有任何会员产品 */
+interface HasPlusMemberInLinesResult {
+    /** 加购的 lines 中是否有任何会员产品 */
     hasPlusMember: boolean;
-    /** 购物车中是否有月费会员产品 */
+    /** 加购的 lines 中是否有月费会员产品 */
     hasMonthlyPlus: boolean;
-    /** 购物车中是否有年费会员产品 */
+    /** 加购的 lines 中是否有年费会员产品 */
     hasAnnualPlus: boolean;
     /** 月费会员产品的 line item */
-    monthlyPlusItem?: {
-        id: string;
-        quantity: number;
-        handle?: string;
-        sku?: string;
-    };
+    monthlyPlusLine?: AddToCartLineItem;
     /** 年费会员产品的 line item */
-    annualPlusItem?: {
-        id: string;
-        quantity: number;
-        handle?: string;
-        sku?: string;
-    };
+    annualPlusLine?: AddToCartLineItem;
 }
 /**
- * 判断购物车中是否包含年费会员或月费会员产品（纯函数版本）
+ * 判断加购的 line items 中是否包含付费会员产品（纯函数版本）
  *
  * @param props - 函数参数
  * @param props.memberSetting - Plus Member 配置
- * @param props.cart - 购物车数据
+ * @param props.lines - 加购的 line items
  * @returns 会员产品信息
  *
  * @example
@@ -910,27 +782,25 @@ interface HasPlusMemberInCartResult {
  *   hasPlusMember,
  *   hasMonthlyPlus,
  *   hasAnnualPlus,
- *   monthlyPlusItem,
- *   annualPlusItem,
- * } = hasPlusMemberInCart({
+ * } = hasPlusMemberInLines({
  *   memberSetting: plusMemberSettings,
- *   cart: currentCart,
+ *   lines: lineItems,
  * })
  *
  * if (hasPlusMember) {
- *   console.log('购物车中有会员产品')
+ *   console.log('加购的商品中包含会员产品')
  * }
  * ```
  */
-declare function hasPlusMemberInCart({ memberSetting, cart, }: HasPlusMemberInCartProps): HasPlusMemberInCartResult;
+declare function hasPlusMemberInLines({ memberSetting, lines, }: UseHasPlusMemberInLinesProps): HasPlusMemberInLinesResult;
 /**
- * 判断购物车中是否包含年费会员或月费会员产品（Hook 版本）
+ * 判断加购的 line items 中是否包含付费会员产品（Hook 版本）
  *
- * 内部使用 hasPlusMemberInCart 纯函数，并通过 useMemo 优化性能
+ * 内部使用 hasPlusMemberInLines 纯函数，并通过 useMemo 优化性能
  *
  * @param props - Hook 参数
  * @param props.memberSetting - Plus Member 配置
- * @param props.cart - 购物车数据
+ * @param props.lines - 加购的 line items
  * @returns 会员产品信息
  *
  * @example
@@ -939,130 +809,22 @@ declare function hasPlusMemberInCart({ memberSetting, cart, }: HasPlusMemberInCa
  *   hasPlusMember,
  *   hasMonthlyPlus,
  *   hasAnnualPlus,
- *   monthlyPlusItem,
- *   annualPlusItem,
- * } = useHasPlusMemberInCart({
+ *   monthlyPlusLine,
+ *   annualPlusLine,
+ * } = useHasPlusMemberInLines({
  *   memberSetting: plusMemberSettings,
- *   cart: currentCart,
+ *   lines: lineItems,
  * })
  *
  * if (hasPlusMember) {
- *   console.log('购物车中有会员产品')
+ *   console.log('加购的商品中包含会员产品')
  * }
  * ```
  */
-declare function useHasPlusMemberInCart({ memberSetting, cart, }: HasPlusMemberInCartProps): HasPlusMemberInCartResult;
+declare function useHasPlusMemberInLines({ memberSetting, lines, }: UseHasPlusMemberInLinesProps): HasPlusMemberInLinesResult;
 
 /**
- * 返回需要添加到购物车的 Plus Member 产品
- *
- * 该 hook 会根据用户选择的会员模式和购物车现有状态，
- * 返回需要添加的会员产品。如果不需要添加会员产品，则返回 undefined。
- *
- * @param props - Hook 参数
- * @param props.cart - 购物车数据
- * @returns Plus Member 产品对象或 undefined
- *
- * @example
- * ```tsx
- * const plusMemberVariant = usePlusMemberNeedAddToCart({
- *   cart,
- * })
- *
- * ```
- */
-declare function usePlusMemberNeedAddToCart({ cart, profile, }: {
-    cart: NormalizedCart;
-    profile?: any;
-}): (_anker_in_shopify_sdk.NormalizedProductVariant & {
-    product: _anker_in_shopify_sdk.NormalizedProduct | undefined;
-}) | undefined;
-
-interface UseAvailableDeliveryCouponResult {
-    nddCoupon?: string;
-    tddCoupon?: string;
-    isLoading: boolean;
-}
-declare const useAvailableDeliveryCoupon: ({ profile, }: {
-    profile?: any;
-}) => UseAvailableDeliveryCouponResult;
-
-interface PlusMemberProviderProps<TProduct = any, TVariant = any, TProfile extends {
-    isPlus?: boolean;
-} = any> {
-    variant: TVariant;
-    product: TProduct;
-    memberSetting: PlusMemberSettingsMetafields;
-    initialSelectedPlusMemberMode?: DeliveryPlusType;
-    profile?: TProfile;
-}
-/**
- * Plus Member Provider Component
- *
- * Provides Plus Member context and state management to child components.
- *
- * @param variant - Product variant
- * @param product - Product
- * @param metafields - Plus member settings from metafields
- * @param initialSelectedPlusMemberMode - Initial selected mode (default: 'free')
- * @param profile - User profile
- * @param locale - Locale code
- * @param children - Child components
- *
- * @example
- * ```tsx
- * <PlusMemberProvider
- *   variant={variant}
- *   product={product}
- *   memberSetting={memberSetting}
- *   profile={profile}
- * >
- *   <YourComponent />
- * </PlusMemberProvider>
- * ```
- */
-declare const PlusMemberProvider: <TProduct = any, TVariant extends {
-    weight?: number;
-} = any, TProfile extends {
-    isPlus?: boolean;
-} = any>({ variant, product, memberSetting, initialSelectedPlusMemberMode, profile, children, }: PropsWithChildren<PlusMemberProviderProps<TProduct, TVariant, TProfile>>) => react_jsx_runtime.JSX.Element;
-
-declare const getReferralAttributes: () => {
-    key: string;
-    value: any;
-}[];
-declare const useCartAttributes: ({ profile, customer, cart, memberSetting, }: {
-    profile: any;
-    customer: any;
-    cart?: NormalizedCart;
-    memberSetting?: PlusMemberSettingsMetafields;
-}) => {
-    attributes: Array<{
-        key: string;
-        value: any;
-    }>;
-};
-
-declare const useCartItemQuantityLimit: ({ cart, cartItem, config, }: {
-    cart?: NormalizedCart;
-    cartItem: NormalizedLineItem;
-    config: {
-        handle: Record<string, {
-            min: number;
-            max: number;
-        }>;
-        sku: Record<string, {
-            min: number;
-            max: number;
-        }>;
-    };
-}) => {
-    min: number;
-    max: number;
-};
-
-/**
- * 更新购物车中各个 item 的折后价相关的属性
+ * 更新购物车中各个 item 的折后价相关的属性
  */
 declare const useUpdateLineCodeAmountAttributes: ({ cart, mutateCart, isCartLoading, setLoadingState, metafieldIdentifiers, }: {
     cart?: NormalizedCart;
@@ -1659,6 +1421,334 @@ interface UseSiteOptions extends SWRConfiguration<SiteInfo | undefined> {
 }
 declare function useSite(options?: UseSiteOptions): swr.SWRResponse<SiteInfo | undefined, any, SWRConfiguration<SiteInfo | undefined, any, ((arg: readonly [any, ...unknown[]]) => swr__internal.FetcherResponse<SiteInfo | undefined>) | ((arg: readonly [any, ...unknown[]]) => swr__internal.FetcherResponse<SiteInfo | undefined>)> | undefined>;
 
+interface ShippingMethodsContext {
+    freeShippingMethods: PlusMemberShippingMethodConfig[];
+    paymentShippingMethods: PlusMemberShippingMethodConfig[];
+    nddOverweight: boolean;
+    tddOverweight: boolean;
+    nddCoupon?: string;
+    tddCoupon?: string;
+    isLoadingCoupon: boolean;
+}
+interface PlusMemberContextValue<TProduct = any, TVariant = any, TProfile extends {
+    isPlus?: boolean;
+} = any> {
+    plusMemberMetafields: PlusMemberSettingsMetafields;
+    selectedPlusMemberMode: DeliveryPlusType;
+    setSelectedPlusMemberMode: (value: DeliveryPlusType) => void;
+    selectedShippingMethod?: PlusMemberShippingMethodConfig;
+    setSelectedShippingMethod: (value: PlusMemberShippingMethodConfig) => void;
+    showMoreShippingMethod: boolean;
+    setShowMoreShippingMethod: (value: boolean) => void;
+    variant: TVariant;
+    product: TProduct;
+    shippingMethodsContext: ShippingMethodsContext;
+    selectedPlusMemberVariant: SelectedPlusMemberVariant;
+    showPlusMemberBenefit: boolean;
+    setShowPlusMemberBenefit: (value: boolean) => void;
+    profile?: TProfile;
+}
+declare const PlusMemberContext: React$1.Context<PlusMemberContextValue<any, any, any>>;
+
+/**
+ * Hook to access Plus Member Context
+ */
+declare function usePlusMemberContext<TProfile extends {
+    isPlus?: boolean;
+} = any>(): PlusMemberContextValue<any, any, any>;
+
+/**
+ * Hook to get Plus Member Product Variants (Monthly and Annual)
+ */
+
+interface UsePlusMemberVariantsOptions {
+    /** Plus member metafields configuration */
+    memberSetting: PlusMemberSettingsMetafields;
+}
+interface UsePlusMemberVariantsResult {
+    monthlyVariant?: NormalizedProductVariant & {
+        product: NormalizedProduct | undefined;
+    };
+    annualVariant?: NormalizedProductVariant & {
+        product: NormalizedProduct | undefined;
+    };
+}
+/**
+ * Get Plus Member product variants (monthly and annual)
+ *
+ * @param options - Configuration options
+ * @returns Monthly and annual variants
+ *
+ * @example
+ * ```tsx
+ * const { monthlyVariant, annualVariant } = usePlusMemberVariants({
+ *   plusMemberMetafields
+ * })
+ * ```
+ */
+declare function usePlusMemberVariants({ memberSetting, }: UsePlusMemberVariantsOptions): UsePlusMemberVariantsResult;
+
+/**
+ * Hook to calculate available shipping methods based on product weight and member status
+ */
+
+interface UseShippingMethodsOptions<TVariant = any, TProfile extends {
+    isPlus?: boolean;
+} = any> {
+    /** Product variant with weight information */
+    variant: TVariant;
+    /** Plus member metafields configuration */
+    plusMemberMetafields: PlusMemberSettingsMetafields;
+    /** Selected plus member mode */
+    selectedPlusMemberMode: DeliveryPlusType;
+    profile?: TProfile;
+}
+interface UseShippingMethodsResult {
+    freeShippingMethods: PlusMemberShippingMethodConfig[];
+    paymentShippingMethods: PlusMemberShippingMethodConfig[];
+    nddOverweight: boolean;
+    tddOverweight: boolean;
+    nddCoupon?: string;
+    tddCoupon?: string;
+    isLoadingCoupon: boolean;
+}
+/**
+ * Calculate available shipping methods based on product weight, member status, and available coupons
+ *
+ * @param options - Configuration options
+ * @returns Shipping methods categorized by free/payment and overweight status
+ *
+ * @example
+ * ```tsx
+ * const { freeShippingMethods, paymentShippingMethods, nddOverweight, tddOverweight } = useShippingMethods({
+ *   variant,
+ *   plusMemberMetafields,
+ *   selectedPlusMemberMode,
+ * })
+ * ```
+ */
+declare function useShippingMethods<TVariant extends {
+    weight?: number;
+} = any>(options: UseShippingMethodsOptions<TVariant>): UseShippingMethodsResult;
+
+/**
+ * Hook to replace cart plus member product
+ *
+ * When adding a monthly membership while an annual membership exists in cart,
+ * the annual membership will be replaced and vice versa.
+ *
+ * @returns Handler function to replace conflicting membership products
+ *
+ * @example
+ * ```tsx
+ * const replaceCartPlusMember = useReplaceCartPlusMember()
+ *
+ * // Call before adding new membership product
+ * await replaceCartPlusMember()
+ * ```
+ */
+declare const useReplaceCartPlusMember: () => () => Promise<void>;
+
+declare const usePlusMemberCheckoutCustomAttributes: ({ disableShipping, isPresaleContains, }: {
+    disableShipping?: boolean;
+    isPresaleContains?: boolean;
+}) => NormalizedAttribute[];
+
+/**
+ * useAutoRemovePlusMemberInCart Hook
+ * 付费会员身份自动移除购物车中的会员产品
+ * 年费会员删除月费会员产品，月费会员删除年费会员产品
+ */
+
+interface UseAutoRemovePlusMemberInCartProps {
+    profile: any;
+    cart?: NormalizedCart;
+    memberSetting: PlusMemberSettingsMetafields;
+}
+/**
+ * 自动移除购物车中的会员产品
+ *
+ * @param props - Hook 参数
+ * @param props.memberSetting - Plus Member 配置
+ * @param props.isMonthlyPlus - 用户是否是月费会员
+ * @param props.isAnnualPlus - 用户是否是年费会员
+ *
+ * @example
+ * ```tsx
+ * const { profile } = useProfile()
+ *
+ * useAutoRemovePlusMemberInCart({
+ *   cart,
+ *   profile,
+ * })
+ * ```
+ */
+declare function useAutoRemovePlusMemberInCart({ cart, profile, memberSetting, }: UseAutoRemovePlusMemberInCartProps): void;
+
+/**
+ * Has Plus Member In Cart
+ * 判断购物车中是否包含年费会员或月费会员产品
+ */
+
+interface HasPlusMemberInCartProps {
+    /** Plus Member 配置 */
+    memberSetting?: PlusMemberSettingsMetafields;
+    /** 购物车数据 */
+    cart?: NormalizedCart;
+}
+interface HasPlusMemberInCartResult {
+    /** 购物车中是否有任何会员产品 */
+    hasPlusMember: boolean;
+    /** 购物车中是否有月费会员产品 */
+    hasMonthlyPlus: boolean;
+    /** 购物车中是否有年费会员产品 */
+    hasAnnualPlus: boolean;
+    /** 月费会员产品的 line item */
+    monthlyPlusItem?: {
+        id: string;
+        quantity: number;
+        handle?: string;
+        sku?: string;
+    };
+    /** 年费会员产品的 line item */
+    annualPlusItem?: {
+        id: string;
+        quantity: number;
+        handle?: string;
+        sku?: string;
+    };
+}
+/**
+ * 判断购物车中是否包含年费会员或月费会员产品（纯函数版本）
+ *
+ * @param props - 函数参数
+ * @param props.memberSetting - Plus Member 配置
+ * @param props.cart - 购物车数据
+ * @returns 会员产品信息
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   hasPlusMember,
+ *   hasMonthlyPlus,
+ *   hasAnnualPlus,
+ *   monthlyPlusItem,
+ *   annualPlusItem,
+ * } = hasPlusMemberInCart({
+ *   memberSetting: plusMemberSettings,
+ *   cart: currentCart,
+ * })
+ *
+ * if (hasPlusMember) {
+ *   console.log('购物车中有会员产品')
+ * }
+ * ```
+ */
+declare function hasPlusMemberInCart({ memberSetting, cart, }: HasPlusMemberInCartProps): HasPlusMemberInCartResult;
+/**
+ * 判断购物车中是否包含年费会员或月费会员产品（Hook 版本）
+ *
+ * 内部使用 hasPlusMemberInCart 纯函数，并通过 useMemo 优化性能
+ *
+ * @param props - Hook 参数
+ * @param props.memberSetting - Plus Member 配置
+ * @param props.cart - 购物车数据
+ * @returns 会员产品信息
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   hasPlusMember,
+ *   hasMonthlyPlus,
+ *   hasAnnualPlus,
+ *   monthlyPlusItem,
+ *   annualPlusItem,
+ * } = useHasPlusMemberInCart({
+ *   memberSetting: plusMemberSettings,
+ *   cart: currentCart,
+ * })
+ *
+ * if (hasPlusMember) {
+ *   console.log('购物车中有会员产品')
+ * }
+ * ```
+ */
+declare function useHasPlusMemberInCart({ memberSetting, cart, }: HasPlusMemberInCartProps): HasPlusMemberInCartResult;
+
+/**
+ * 返回需要添加到购物车的 Plus Member 产品
+ *
+ * 该 hook 会根据用户选择的会员模式和购物车现有状态，
+ * 返回需要添加的会员产品。如果不需要添加会员产品，则返回 undefined。
+ *
+ * @param props - Hook 参数
+ * @param props.cart - 购物车数据
+ * @returns Plus Member 产品对象或 undefined
+ *
+ * @example
+ * ```tsx
+ * const plusMemberVariant = usePlusMemberNeedAddToCart({
+ *   cart,
+ * })
+ *
+ * ```
+ */
+declare function usePlusMemberNeedAddToCart({ cart, profile, }: {
+    cart: NormalizedCart;
+    profile?: any;
+}): (_anker_in_shopify_sdk.NormalizedProductVariant & {
+    product: _anker_in_shopify_sdk.NormalizedProduct | undefined;
+}) | undefined;
+
+interface UseAvailableDeliveryCouponResult {
+    nddCoupon?: string;
+    tddCoupon?: string;
+    isLoading: boolean;
+}
+declare const useAvailableDeliveryCoupon: ({ profile, }: {
+    profile?: any;
+}) => UseAvailableDeliveryCouponResult;
+
+interface PlusMemberProviderProps<TProduct = any, TVariant = any, TProfile extends {
+    isPlus?: boolean;
+} = any> {
+    variant: TVariant;
+    product: TProduct;
+    memberSetting: PlusMemberSettingsMetafields;
+    initialSelectedPlusMemberMode?: DeliveryPlusType;
+    profile?: TProfile;
+}
+/**
+ * Plus Member Provider Component
+ *
+ * Provides Plus Member context and state management to child components.
+ *
+ * @param variant - Product variant
+ * @param product - Product
+ * @param metafields - Plus member settings from metafields
+ * @param initialSelectedPlusMemberMode - Initial selected mode (default: 'free')
+ * @param profile - User profile
+ * @param locale - Locale code
+ * @param children - Child components
+ *
+ * @example
+ * ```tsx
+ * <PlusMemberProvider
+ *   variant={variant}
+ *   product={product}
+ *   memberSetting={memberSetting}
+ *   profile={profile}
+ * >
+ *   <YourComponent />
+ * </PlusMemberProvider>
+ * ```
+ */
+declare const PlusMemberProvider: <TProduct = any, TVariant extends {
+    weight?: number;
+} = any, TProfile extends {
+    isPlus?: boolean;
+} = any>({ variant, product, memberSetting, initialSelectedPlusMemberMode, profile, children, }: PropsWithChildren<PlusMemberProviderProps<TProduct, TVariant, TProfile>>) => react_jsx_runtime.JSX.Element;
+
 /**
  * useIntersection Hook
  *
@@ -1894,4 +1984,4 @@ declare function getCachedGeoLocation(cacheKey?: string): GeoLocationData | unde
  */
 declare function clearGeoLocationCache(cacheKey?: string): void;
 
-export { type AddCartLinesInput, AddToCartInput, AddToCartLineItem, type ApplyCartCodesInput, type AutoFreeGift, type AutoFreeGiftCartLineInput, type AutoFreeGiftConfig, type AutoFreeGiftItem, type AutoFreeGiftList, type AutoFreeGiftMainProduct, type BuyNowInput, BuyRuleType, CODE_AMOUNT_KEY, CUSTOMER_ATTRIBUTE_KEY, CUSTOMER_SCRIPT_GIFT_KEY, type Config, type CreateCartInput, DeliveryPlusType, type DiscountLabel, type FormattedGift, type FunctionGiftResult, type GeoLocationData, type GiftProduct, type GiftProductItem, type GiftTier, type HasPlusMemberInCartProps, type HasPlusMemberInCartResult, type ImageMedia, type LocaleMapping, MAIN_PRODUCT_CODE, MEMBER_PRICE_ATTRIBUTE_KEY, type MainProductInfo, type NormalizedSearchResultItem, type Options, OrderBasePriceType, type OrderDiscountConfig, type OrderDiscountResult, OrderDiscountType, PlusMemberContext, type PlusMemberContextValue, PlusMemberProvider, type PlusMemberProviderProps, PlusMemberSettingsMetafields, PlusMemberShippingMethodConfig, PriceBasePriceType, type PriceDiscountConfig, PriceDiscountType, type RemoveCartCodesInput, type RemoveCartLinesInput, type RewardItem, type RuleCondition, RuleType, SCRIPT_CODE_AMOUNT_KEY, type SearchResult, type SearchResultType, type SelectedOptionsResult, SelectedPlusMemberVariant, type ShippingMethodsContext, type SiteInfo, SpendMoneyType, type TieredDiscount, type UpdateCartAttributesInput, UseAddToCartOptions, type UseAllBlogsOptions, type UseAllCollectionsOptions, type UseAllProductsOptions, type UseArticleOptions, type UseArticlesInBlogOptions, type UseArticlesOptions, type UseAutoRemovePlusMemberInCartProps, type UseAvailableDeliveryCouponResult, type UseBlogOptions, type UseBuyNowOptions, type UseCalcGiftsFromLinesOptions, type UseCalcGiftsFromLinesResult, type UseCollectionOptions, type UseCollectionsOptions, type UseExposureOptions, type UseGeoLocationOptions, type UseIntersectionOptions, type UsePlusMemberVariantsOptions, type UsePlusMemberVariantsResult, type UsePriceOptions, type UsePriceResult, type UseProductOptions, type UseProductsByHandlesOptions, type UseScriptAutoFreeGiftResult, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingMethodsResult, type UseSiteOptions, type UseUpdateCartAttributesOptions, type VariantItem, type VariantMedia, type VideoMedia, checkAttributesUpdateNeeded, clearGeoLocationCache, createMockCartFromLines, currencyCodeMapping, defaultSWRMutationConfiguration, formatFunctionAutoFreeGift, formatScriptAutoFreeGift, getCachedGeoLocation, getDiscountEnvAttributeValue, getMatchedMainProductSubTotal, getQuery, getReferralAttributes, hasPlusMemberInCart, normalizeAddToCartLines, preCheck, safeParse, useAddCartLines, useAddToCart, useAllBlogs, useAllCollections, useAllProducts, useApplyCartCodes, useArticle, useArticles, useArticlesInBlog, useAutoRemovePlusMemberInCart, useAvailableDeliveryCoupon, useBlog, useBuyNow, useCalcAutoFreeGift, useCalcGiftsFromLines, useCalcOrderDiscount, useCartAttributes, useCartItemQuantityLimit, useCollection, useCollections, useCreateCart, useExposure, useGeoLocation, useHasPlusMemberInCart, useIntersection, usePlusMemberCheckoutCustomAttributes, usePlusMemberContext, usePlusMemberDeliveryCodes, usePlusMemberNeedAddToCart, usePlusMemberVariants, usePrice, useProduct, useProductUrl, useProductsByHandles, useRemoveCartCodes, useRemoveCartLines, useReplaceCartPlusMember, useScriptAutoFreeGift, useSearch, useSelectedOptions, useShippingMethods, useSite, useUpdateCartAttributes, useUpdateCartLines, useUpdateLineCodeAmountAttributes, useUpdateVariantQuery, useVariant, useVariantMedia };
+export { type AddCartLinesInput, AddToCartInput, AddToCartLineItem, type ApplyCartCodesInput, type AutoFreeGift, type AutoFreeGiftCartLineInput, type AutoFreeGiftConfig, type AutoFreeGiftItem, type AutoFreeGiftList, type AutoFreeGiftMainProduct, type BuyNowInput, BuyRuleType, CODE_AMOUNT_KEY, CUSTOMER_ATTRIBUTE_KEY, CUSTOMER_SCRIPT_GIFT_KEY, type Config, type CreateCartInput, DeliveryPlusType, type DiscountLabel, type FormattedGift, type FunctionGiftResult, type GeoLocationData, type GetCartAttributesProps, type GiftProduct, type GiftProductItem, type GiftTier, type HasPlusMemberInCartProps, type HasPlusMemberInCartResult, type HasPlusMemberInLinesResult, type ImageMedia, type LocaleMapping, MAIN_PRODUCT_CODE, MEMBER_PRICE_ATTRIBUTE_KEY, type MainProductInfo, type NormalizedSearchResultItem, type Options, OrderBasePriceType, type OrderDiscountConfig, type OrderDiscountResult, OrderDiscountType, PlusMemberContext, type PlusMemberContextValue, PlusMemberProvider, type PlusMemberProviderProps, PlusMemberSettingsMetafields, PlusMemberShippingMethodConfig, PriceBasePriceType, type PriceDiscountConfig, PriceDiscountType, type RemoveCartCodesInput, type RemoveCartLinesInput, type RewardItem, type RuleCondition, RuleType, SCRIPT_CODE_AMOUNT_KEY, type SearchResult, type SearchResultType, type SelectedOptionsResult, SelectedPlusMemberVariant, type ShippingMethodsContext, type SiteInfo, SpendMoneyType, type TieredDiscount, type UpdateCartAttributesInput, UseAddToCartOptions, type UseAllBlogsOptions, type UseAllCollectionsOptions, type UseAllProductsOptions, type UseArticleOptions, type UseArticlesInBlogOptions, type UseArticlesOptions, type UseAutoRemovePlusMemberInCartProps, type UseAvailableDeliveryCouponResult, type UseBlogOptions, type UseBuyNowOptions, type UseCalcGiftsFromLinesOptions, type UseCalcGiftsFromLinesResult, type UseCollectionOptions, type UseCollectionsOptions, type UseExposureOptions, type UseGeoLocationOptions, type UseHasPlusMemberInLinesProps, type UseIntersectionOptions, type UsePlusMemberVariantsOptions, type UsePlusMemberVariantsResult, type UsePriceOptions, type UsePriceResult, type UseProductOptions, type UseProductsByHandlesOptions, type UseScriptAutoFreeGiftResult, type UseSearchOptions, type UseShippingMethodsOptions, type UseShippingMethodsResult, type UseSiteOptions, type UseUpdateCartAttributesOptions, type VariantItem, type VariantMedia, type VideoMedia, checkAttributesUpdateNeeded, clearGeoLocationCache, createMockCartFromLines, currencyCodeMapping, defaultSWRMutationConfiguration, formatFunctionAutoFreeGift, formatScriptAutoFreeGift, getCachedGeoLocation, getCartAttributes, getDiscountEnvAttributeValue, getMatchedMainProductSubTotal, getQuery, getReferralAttributes, getUserType, hasPlusMemberInCart, hasPlusMemberInLines, normalizeAddToCartLines, preCheck, safeParse, useAddCartLines, useAddToCart, useAllBlogs, useAllCollections, useAllProducts, useApplyCartCodes, useArticle, useArticles, useArticlesInBlog, useAutoRemovePlusMemberInCart, useAvailableDeliveryCoupon, useBlog, useBuyNow, useCalcAutoFreeGift, useCalcGiftsFromLines, useCalcOrderDiscount, useCartAttributes, useCartItemQuantityLimit, useCollection, useCollections, useCreateCart, useExposure, useGeoLocation, useHasPlusMemberInCart, useHasPlusMemberInLines, useIntersection, usePlusMemberCheckoutCustomAttributes, usePlusMemberContext, usePlusMemberNeedAddToCart, usePlusMemberVariants, usePrice, useProduct, useProductUrl, useProductsByHandles, useRemoveCartCodes, useRemoveCartLines, useReplaceCartPlusMember, useScriptAutoFreeGift, useSearch, useSelectedOptions, useShippingMethods, useSite, useUpdateCartAttributes, useUpdateCartLines, useUpdateLineCodeAmountAttributes, useUpdateVariantQuery, useVariant, useVariantMedia };