@shopbb/helium 0.6.4 → 0.7.0

package/dist/components/hooks/useOptimisticCart.js

@@ -1,146 +1,114 @@
 /**
- * useOptimisticCart — 对齐 Hydrogen React 同名 hook
+ * useOptimisticCart — 严格对齐 Shopify Hydrogen
  *
- * 接受 actualCart（来自 CartProvider），返回一个"叠加了所有 pending mutation"
- * 的 cart 视图。让 UI 在网络回来之前立刻反应用户操作（数量+1 / 删除等）。
+ * 源文件参考：packages/hydrogen/src/cart/optimistic/useOptimisticCart.tsx
  *
- *   const { cart: actualCart } = useCart();
- *   const cart = useOptimisticCart(actualCart);
- *   // cart 看起来已经"立刻应用了"，但 fetcher 还在跑后端
+ * 核心：用 RR7 `useFetchers()` 拿当前所有 in-flight fetcher，遍历它们的 formData
+ * 用 CartForm.getFormInput 解析出 action/inputs，合并到 actualCart 上。
  *
- * 实现：
- *   - <CartForm> submit 时把 pending action 注册到模块内 store
- *   - 完成后从 store 摘掉
- *   - useOptimisticCart 订阅 store，把 actualCart 复制一份 + 应用所有 pending
+ * 用法：
+ *   const data = useLoaderData<typeof loader>();
+ *   const cart = useOptimisticCart(data.cart);
+ *   // cart 包含 isOptimistic 字段、cart.lines 包含 in-flight 添加的 line（也带 isOptimistic）
  *
- * 简化点（vs Hydrogen 完整实现）：
- *   - 只支持 LinesAdd / LinesUpdate / LinesRemove（足够 cart 主流操作）
- *   - DiscountCodesUpdate / NoteUpdate 等不做 optimistic（这些在网络层用 applyCart 兜底）
- *   - 不持久化（页面刷新清空）
+ * 与之前 helium 0.6.x 区别：
+ *   - 删除自造 pendingStore 全局变量
+ *   - 直接用 RR7 useFetchers()
  */
-import * as React from 'react';
-import { useCartOptional } from '../CartProvider';
-// 关键：snapshot 必须是稳定引用，否则 useSyncExternalStore 每次比对都觉得变了 →
-// 无限 re-render（React #185）+ hydration mismatch（#418/#423）
-const EMPTY_SNAPSHOT = [];
-const pendingStore = {
-    items: new Map(),
-    listeners: new Set(),
-    cachedSnapshot: EMPTY_SNAPSHOT,
-    add(m) {
-        this.items.set(m.id, m);
-        this.cachedSnapshot = Array.from(this.items.values());
-        this.notify();
-    },
-    remove(id) {
-        if (this.items.delete(id)) {
-            this.cachedSnapshot = this.items.size === 0 ? EMPTY_SNAPSHOT : Array.from(this.items.values());
-            this.notify();
-        }
-    },
-    list() {
-        // 返回稳定引用（只在 add/remove 时改变）— 满足 useSyncExternalStore 契约
-        return this.cachedSnapshot;
-    },
-    subscribe(fn) {
-        this.listeners.add(fn);
-        return () => { this.listeners.delete(fn); };
-    },
-    notify() {
-        for (const fn of this.listeners)
-            fn();
-    },
-};
+import { useFetchers } from 'react-router';
+import { CartForm } from '../CartForm';
 /**
- * Internal: CartForm 提交时调用，注册一个 pending mutation。返回 unregister。
+ * 给 optimistic line 一个临时 id。Hydrogen 用 `gid://shopify/CartLine/optimistic-<variantId>`。
+ * 我们 shopbb 也用类似前缀。
  */
-export function __registerPendingMutation(m) {
-    pendingStore.add(m);
-    return () => pendingStore.remove(m.id);
+function getOptimisticLineId(variantId) {
+    return `optimistic-${variantId}`;
 }
-export function useOptimisticCart(actualCart) {
-    // 订阅 pending store 重渲染
-    const subscribe = React.useCallback((cb) => pendingStore.subscribe(cb), []);
-    const getSnapshot = React.useCallback(() => pendingStore.list(), []);
-    const pendings = React.useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
-    // 如果没有 pending，CartProvider 内部的 cart 已经是最新（因为 applyCart 同步过）
-    const fallback = useCartOptional();
-    const baseCart = (actualCart ?? fallback?.cart);
-    return React.useMemo(() => {
-        if (!baseCart) {
-            // 如果没有 actual cart 但有 pending LinesAdd → 模拟一个空 cart + 即将添加的行
-            if (pendings.length === 0)
-                return null;
-            const optimisticLines = [];
-            for (const p of pendings) {
-                if (p.action === 'LinesAdd' && Array.isArray(p.inputs?.lines)) {
-                    for (const ln of p.inputs.lines) {
-                        optimisticLines.push({
-                            id: `__optimistic_${p.id}_${ln.merchandiseId}`,
-                            quantity: ln.quantity ?? 1,
-                            merchandise: { id: ln.merchandiseId },
-                            isOptimistic: true,
-                        });
-                    }
-                }
-            }
-            if (optimisticLines.length === 0)
-                return null;
-            return {
-                isOptimistic: true,
-                totalQuantity: optimisticLines.reduce((s, l) => s + l.quantity, 0),
-                lines: { nodes: optimisticLines },
-            };
+function isOptimisticLineId(id) {
+    return id.startsWith('optimistic-');
+}
+export function useOptimisticCart(cart) {
+    const fetchers = useFetchers();
+    if (!fetchers || !fetchers.length) {
+        return cart;
+    }
+    // 用 structuredClone 拷贝 cart（不污染 useLoaderData 的引用）
+    const optimisticCart = cart?.lines
+        ? (typeof structuredClone === 'function' ? structuredClone(cart) : JSON.parse(JSON.stringify(cart)))
+        : { lines: { nodes: [] } };
+    const cartLines = optimisticCart.lines?.nodes ?? [];
+    let isOptimistic = false;
+    for (const { formData } of fetchers) {
+        if (!formData)
+            continue;
+        let cartFormData;
+        try {
+            cartFormData = CartForm.getFormInput(formData);
+        }
+        catch {
+            continue;
         }
-        if (pendings.length === 0)
-            return baseCart;
-        // 复制 lines（不深拷贝整个 cart — 只动 lines 节点列表）
-        const linesNodes = (baseCart.lines?.nodes ?? []).slice();
-        for (const p of pendings) {
-            if (p.action === 'LinesAdd' && Array.isArray(p.inputs?.lines)) {
-                for (const ln of p.inputs.lines) {
-                    // 简化：若已有相同 merchandiseId 累加，否则追加
-                    const idx = linesNodes.findIndex((l) => l.merchandise?.id === ln.merchandiseId);
-                    if (idx >= 0) {
-                        linesNodes[idx] = {
-                            ...linesNodes[idx],
-                            quantity: linesNodes[idx].quantity + (ln.quantity ?? 1),
-                            isOptimistic: true,
-                        };
-                    }
-                    else {
-                        linesNodes.push({
-                            id: `__optimistic_${p.id}_${ln.merchandiseId}`,
-                            quantity: ln.quantity ?? 1,
-                            merchandise: { id: ln.merchandiseId },
-                            isOptimistic: true,
-                        });
-                    }
+        if (!cartFormData?.action)
+            continue;
+        if (cartFormData.action === CartForm.ACTIONS.LinesAdd) {
+            const lines = cartFormData.inputs?.lines ?? [];
+            for (const input of lines) {
+                if (!input.selectedVariant) {
+                    // 没传 selectedVariant，无法 optimistic 显示具体信息 — Hydrogen 的约束相同
+                    continue;
+                }
+                const variantId = input.selectedVariant?.id;
+                const existingLine = cartLines.find((line) => line.merchandise?.id === variantId);
+                isOptimistic = true;
+                if (existingLine) {
+                    existingLine.quantity = (existingLine.quantity || 1) + (input.quantity || 1);
+                    existingLine.isOptimistic = true;
+                }
+                else {
+                    cartLines.unshift({
+                        id: getOptimisticLineId(variantId),
+                        merchandise: input.selectedVariant,
+                        quantity: input.quantity || 1,
+                        isOptimistic: true,
+                    });
                 }
             }
-            else if (p.action === 'LinesUpdate' && Array.isArray(p.inputs?.lines)) {
-                for (const ln of p.inputs.lines) {
-                    const idx = linesNodes.findIndex((l) => l.id === ln.id);
-                    if (idx >= 0) {
-                        linesNodes[idx] = { ...linesNodes[idx], quantity: ln.quantity ?? linesNodes[idx].quantity, isOptimistic: true };
-                    }
+        }
+        else if (cartFormData.action === CartForm.ACTIONS.LinesRemove) {
+            const lineIds = cartFormData.inputs?.lineIds ?? [];
+            for (const lineId of lineIds) {
+                const idx = cartLines.findIndex((line) => line.id === lineId);
+                if (idx !== -1) {
+                    if (isOptimisticLineId(cartLines[idx].id))
+                        continue;
+                    cartLines.splice(idx, 1);
+                    isOptimistic = true;
                 }
             }
-            else if (p.action === 'LinesRemove' && Array.isArray(p.inputs?.lineIds)) {
-                for (const id of p.inputs.lineIds) {
-                    const idx = linesNodes.findIndex((l) => l.id === id);
-                    if (idx >= 0)
-                        linesNodes.splice(idx, 1);
+        }
+        else if (cartFormData.action === CartForm.ACTIONS.LinesUpdate) {
+            const lines = cartFormData.inputs?.lines ?? [];
+            for (const line of lines) {
+                const idx = cartLines.findIndex((optimisticLine) => line.id === optimisticLine.id);
+                if (idx > -1) {
+                    if (isOptimisticLineId(cartLines[idx].id))
+                        continue;
+                    cartLines[idx].quantity = line.quantity;
+                    if (cartLines[idx].quantity === 0)
+                        cartLines.splice(idx, 1);
+                    isOptimistic = true;
                 }
             }
         }
-        const totalQuantity = linesNodes.reduce((s, l) => s + l.quantity, 0);
-        return {
-            ...baseCart,
-            isOptimistic: true,
-            totalQuantity,
-            lines: { ...baseCart.lines, nodes: linesNodes },
-        };
-    }, [baseCart, pendings]);
+    }
+    if (isOptimistic)
+        optimisticCart.isOptimistic = isOptimistic;
+    optimisticCart.totalQuantity = cartLines.reduce((sum, line) => sum + (line.quantity || 0), 0);
+    optimisticCart.lines = { ...optimisticCart.lines, nodes: cartLines };
+    return optimisticCart;
+}
+// 旧 API 兼容（pendingStore 已废弃）
+export function __registerPendingMutation() {
+    return () => { };
 }
 //# sourceMappingURL=useOptimisticCart.js.map

package/dist/components/hooks/useOptimisticCart.js.map

@@ -1 +1 @@
-{"version":3,"file":"useOptimisticCart.js","sourceRoot":"","sources":["../../../src/components/hooks/useOptimisticCart.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useOptimisticCart.js","sourceRoot":"","sources":["../../../src/components/hooks/useOptimisticCart.ts"],"names":[],"mappings":"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"}

package/dist/components/index.d.ts

@@ -1,76 +1,55 @@
 /**
  * @shopbb/helium/components — 商家用 React 组件
  *
- * 用法：
- *   import {
- *     ShopProvider, CartProvider, AnalyticsProvider,
- *     useShop, useCart, useAnalytics,
- *     Money, Image, ProductPrice,
- *     AddToCartButton, CartLineQuantityAdjustButton,
- *     VariantSelector, ProductOptionsProvider, useProductOptions,
- *     Analytics,
- *   } from '@shopbb/helium/components';
- *
- * 设计原则：
- *   - 无样式：组件只管行为 + 语义化 DOM，样式商家自己写
- *   - data-* 钩子：方便选择器
- *   - 对齐 Shopify Hydrogen 同名组件的 API，迁移成本低
- *   - Provider 链：<ShopProvider> > <CartProvider> > <AnalyticsProvider> > App
- *     组件优先从 Provider 拿；Provider 缺省时回退到 props 或 noop
+ * 0.7 起严格对齐 Shopify Hydrogen 设计原则：
+ *   - 数据流：服务端 loader → useLoaderData → 组件 props（不通过 Provider）
+ *   - mutation：<CartForm> + RR7 useFetcher（自动 revalidate loader）
+ *   - 删除 CartProvider / DiscountProvider / AddressBookProvider
  */
 export { ShopProvider, useShop, useShopOptional } from './ShopProvider';
 export type { ShopContextValue, ShopProviderProps } from './ShopProvider';
 export { ShopProvider as ShopifyProvider } from './ShopProvider';
 export type { ShopProviderProps as ShopifyProviderProps } from './ShopProvider';
-export { CartProvider, useCart, useCartOptional } from './CartProvider';
-export type { Cart, CartLine, CartLineMerchandise, CartStatus, CartUserError, CartContextValue, CartProviderProps, } from './CartProvider';
 export { ProductOptionsProvider, useProductOptions, } from './ProductOptionsProvider';
 export type { ProductOptionsContextValue, ProductOptionsProviderProps, ProductOptionItem, } from './ProductOptionsProvider';
 export { AnalyticsProvider, useAnalytics, Analytics } from './AnalyticsProvider';
 export type { AnalyticsEvent, AnalyticsContextValue, AnalyticsProviderProps } from './AnalyticsProvider';
+export { CartLineProvider, useCartLine, useCartLineOptional } from './CartLineProvider';
+export type { CartLineProviderProps, CartLineLike } from './CartLineProvider';
 export { Money } from './Money';
 export type { MoneyProps, MoneyData, MoneyMeasurement } from './Money';
 export { Image } from './Image';
 export type { ImageProps, ImageData } from './Image';
 export { ProductPrice } from './ProductPrice';
 export type { ProductPriceProps } from './ProductPrice';
-export { AddToCartButton } from './AddToCartButton';
-export type { AddToCartButtonProps } from './AddToCartButton';
-export { CartLineQuantityAdjustButton } from './CartLineQuantityAdjustButton';
-export type { CartLineQuantityAdjustButtonProps } from './CartLineQuantityAdjustButton';
 export { VariantSelector } from './VariantSelector';
 export type { VariantSelectorProps, VariantSelectorRenderProps, VariantOption, } from './VariantSelector';
-export { AddressBookProvider, useAddressBook, useAddressBookOptional, } from './AddressBookProvider';
-export type { Address, AddressInput, AddressBookStatus, AddressBookUserError, AddressBookContextValue, AddressBookProviderProps, } from './AddressBookProvider';
-export { AddressList } from './AddressList';
-export type { AddressListProps, AddressListItemActions } from './AddressList';
-export { AddressForm } from './AddressForm';
-export type { AddressFormProps, AddressFormI18n } from './AddressForm';
-export { AddressPicker } from './AddressPicker';
-export type { AddressPickerProps } from './AddressPicker';
-export { DiscountProvider, useDiscounts, useDiscountsOptional, useProductDiscounts, } from './DiscountProvider';
-export type { Discount, DiscountClaim, DiscountValueType, DiscountValuePercentage, DiscountValueAmount, DiscountValueFreeShipping, CartDiscountCode, CartDiscountAllocation, DiscountUserError, DiscountContextValue, DiscountProviderProps, } from './DiscountProvider';
-export { AppliedDiscountList, ClaimableDiscountList, DiscountClaimButton, MyDiscountList, } from './DiscountComponents';
-export type { AppliedDiscountListProps, ClaimableDiscountListProps, DiscountClaimButtonProps, MyDiscountListProps, } from './DiscountComponents';
-export { DiscountSelector } from './DiscountSelector';
-export type { DiscountSelectorProps } from './DiscountSelector';
-export { useMounted } from './hooks/useMounted';
-export { useOptimisticCart } from './hooks/useOptimisticCart';
-export type { OptimisticCart, OptimisticCartLine, PendingMutation } from './hooks/useOptimisticCart';
-export { useMoney } from './hooks/useMoney';
-export type { MoneyV2, MoneyParts } from './hooks/useMoney';
-export { CartForm, CART_FORM_ACTIONS, useFetcher } from './CartForm';
-export type { CartFormProps, CartFormInput, CartFormFetcher, CartFormAction, CartLineInput, CartLineUpdateInput, } from './CartForm';
-export { CartLineProvider, useCartLine, useCartLineOptional } from './CartLineProvider';
-export type { CartLineProviderProps, CartLineLike } from './CartLineProvider';
 export { CartLineQuantity } from './CartLineQuantity';
 export type { CartLineQuantityProps } from './CartLineQuantity';
 export { CartCost } from './CartCost';
 export type { CartCostProps, MoneyValue } from './CartCost';
 export { CartCheckoutButton } from './CartCheckoutButton';
 export type { CartCheckoutButtonProps } from './CartCheckoutButton';
+export { CartForm, CART_FORM_ACTIONS, useFetcher } from './CartForm';
+export type { CartFormProps, CartFormInput, CartFormFetcher, CartFormAction, CartLineInput, CartLineUpdateInput, FetcherWithComponents, } from './CartForm';
+export { AddToCartButton } from './AddToCartButton';
+export type { AddToCartButtonProps } from './AddToCartButton';
 export { BuyNowButton } from './BuyNowButton';
 export type { BuyNowButtonProps } from './BuyNowButton';
+export { useOptimisticCart } from './hooks/useOptimisticCart';
+export type { OptimisticCart, OptimisticCartLine, PendingMutation } from './hooks/useOptimisticCart';
+export { useMoney } from './hooks/useMoney';
+export type { MoneyV2, MoneyParts } from './hooks/useMoney';
+export { AddressList } from './AddressList';
+export type { AddressListProps, AddressListItemActions, Address } from './AddressList';
+export { AddressForm } from './AddressForm';
+export type { AddressFormProps, AddressFormI18n, AddressInput, AddressBookUserError, AddressFormSubmitResult } from './AddressForm';
+export { AddressPicker } from './AddressPicker';
+export type { AddressPickerProps } from './AddressPicker';
+export { AppliedDiscountList, ClaimableDiscountList, DiscountClaimButton, MyDiscountList, } from './DiscountComponents';
+export type { AppliedDiscountListProps, ClaimableDiscountListProps, DiscountClaimButtonProps, MyDiscountListProps, Discount, DiscountClaim, DiscountValueType, DiscountValuePercentage, DiscountValueAmount, DiscountValueFreeShipping, DiscountAllocation, } from './DiscountComponents';
+export { DiscountSelector } from './DiscountSelector';
+export type { DiscountSelectorProps, AppliedDiscountClaim, } from './DiscountSelector';
 export { RichText } from './RichText';
 export type { RichTextProps, RichTextNode, RichTextComponents } from './RichText';
 export { Pagination, getPaginationVariables } from './Pagination';

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"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"}

package/dist/components/index.js

@@ -1,58 +1,42 @@
 /**
  * @shopbb/helium/components — 商家用 React 组件
  *
- * 用法：
- *   import {
- *     ShopProvider, CartProvider, AnalyticsProvider,
- *     useShop, useCart, useAnalytics,
- *     Money, Image, ProductPrice,
- *     AddToCartButton, CartLineQuantityAdjustButton,
- *     VariantSelector, ProductOptionsProvider, useProductOptions,
- *     Analytics,
- *   } from '@shopbb/helium/components';
- *
- * 设计原则：
- *   - 无样式：组件只管行为 + 语义化 DOM，样式商家自己写
- *   - data-* 钩子：方便选择器
- *   - 对齐 Shopify Hydrogen 同名组件的 API，迁移成本低
- *   - Provider 链：<ShopProvider> > <CartProvider> > <AnalyticsProvider> > App
- *     组件优先从 Provider 拿；Provider 缺省时回退到 props 或 noop
+ * 0.7 起严格对齐 Shopify Hydrogen 设计原则：
+ *   - 数据流：服务端 loader → useLoaderData → 组件 props（不通过 Provider）
+ *   - mutation：<CartForm> + RR7 useFetcher（自动 revalidate loader）
+ *   - 删除 CartProvider / DiscountProvider / AddressBookProvider
  */
-// Providers + hooks
+// Providers + hooks（保留：仅 Shop / ProductOptions / CartLine / Analytics，对齐 Hydrogen）
 export { ShopProvider, useShop, useShopOptional } from './ShopProvider';
-// Hydrogen-compatible alias: <ShopifyProvider> 在我们叫 <ShopProvider>，提供别名让 Hydrogen 代码无痛迁移
 export { ShopProvider as ShopifyProvider } from './ShopProvider';
-export { CartProvider, useCart, useCartOptional } from './CartProvider';
 export { ProductOptionsProvider, useProductOptions, } from './ProductOptionsProvider';
 export { AnalyticsProvider, useAnalytics, Analytics } from './AnalyticsProvider';
+// CartLine context（Hydrogen 标准：cart line 子组件用 useCartLine 拿当前 line）
+export { CartLineProvider, useCartLine, useCartLineOptional } from './CartLineProvider';
 // 展示型组件
 export { Money } from './Money';
 export { Image } from './Image';
 export { ProductPrice } from './ProductPrice';
-export { AddToCartButton } from './AddToCartButton';
-export { CartLineQuantityAdjustButton } from './CartLineQuantityAdjustButton';
 export { VariantSelector } from './VariantSelector';
-// 地址簿（W4a）
-export { AddressBookProvider, useAddressBook, useAddressBookOptional, } from './AddressBookProvider';
+export { CartLineQuantity } from './CartLineQuantity';
+export { CartCost } from './CartCost';
+export { CartCheckoutButton } from './CartCheckoutButton';
+// CartForm + useFetcher 透传（Hydrogen 标准）
+export { CartForm, CART_FORM_ACTIONS, useFetcher } from './CartForm';
+// 按钮组件（内部用 CartForm）
+export { AddToCartButton } from './AddToCartButton';
+export { BuyNowButton } from './BuyNowButton';
+// useOptimisticCart — 用 RR7 useFetchers() 实现（对齐 Hydrogen）
+export { useOptimisticCart } from './hooks/useOptimisticCart';
+// useMoney hook
+export { useMoney } from './hooks/useMoney';
+// 地址簿（接 props，不再用 Provider）
 export { AddressList } from './AddressList';
 export { AddressForm } from './AddressForm';
 export { AddressPicker } from './AddressPicker';
-// 优惠券（W4b）
-export { DiscountProvider, useDiscounts, useDiscountsOptional, useProductDiscounts, } from './DiscountProvider';
+// 优惠券（接 props，不再用 Provider）
 export { AppliedDiscountList, ClaimableDiscountList, DiscountClaimButton, MyDiscountList, } from './DiscountComponents';
 export { DiscountSelector } from './DiscountSelector';
-// SSR / hydrate 辅助 hook
-export { useMounted } from './hooks/useMounted';
-export { useOptimisticCart } from './hooks/useOptimisticCart';
-export { useMoney } from './hooks/useMoney';
-// CartForm — Hydrogen-compatible form-based cart mutation API
-export { CartForm, CART_FORM_ACTIONS, useFetcher } from './CartForm';
-// Cart line context + 子组件
-export { CartLineProvider, useCartLine, useCartLineOptional } from './CartLineProvider';
-export { CartLineQuantity } from './CartLineQuantity';
-export { CartCost } from './CartCost';
-export { CartCheckoutButton } from './CartCheckoutButton';
-export { BuyNowButton } from './BuyNowButton';
 // Rich text
 export { RichText } from './RichText';
 // Pagination

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAExE,yFAAyF;AACzF,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAWxE,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGjF,QAAQ;AACR,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAG9E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD,WAAW;AACX,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAU/B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,WAAW;AACX,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAe5B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,wBAAwB;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,8DAA8D;AAC9D,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAMrE,0BAA0B;AAC1B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAExF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGlE,MAAM;AACN,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAG5B,OAAO;AACP,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mFAAmF;AACnF,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjE,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGjF,oEAAoE;AACpE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGxF,QAAQ;AACR,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,wCAAwC;AACxC,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAMrE,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,0DAA0D;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,gBAAgB;AAChB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,4BAA4B;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,4BAA4B;AAC5B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAe9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAMtD,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGlE,MAAM;AACN,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAG5B,OAAO;AACP,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -17,8 +17,6 @@ export { createStorefrontClient } from './createStorefrontClient';
 export { createCartHandler, DEFAULT_CART_FRAGMENT } from './createCartHandler';
 export { cartGetIdDefault, cartSetIdDefault } from './cart-id';
 export type { CartSetIdOptions } from './cart-id';
-export { handleCartFormAction } from './handleCartFormAction';
-export type { HandleCartFormActionOptions } from './handleCartFormAction';
 export { CacheNone, CacheShort, CacheLong, CacheCustom } from './cache';
 export { createWithCache, InMemoryCache } from './cache/withCache';
 export type { WithCache, WithCacheOptions, CacheKey } from './cache/withCache';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGxE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAClH,OAAO,EAAE,2BAA2B,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzF,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EACV,eAAe,EAAE,iBAAiB,EAAE,sBAAsB,GAC3D,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG9E,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGxE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AACrF,YAAY,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAClH,OAAO,EAAE,2BAA2B,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzF,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChE,YAAY,EACV,eAAe,EAAE,iBAAiB,EAAE,sBAAsB,GAC3D,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG9E,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -16,7 +16,6 @@ export { createHeliumContext } from './createHeliumContext';
 export { createStorefrontClient } from './createStorefrontClient';
 export { createCartHandler, DEFAULT_CART_FRAGMENT } from './createCartHandler';
 export { cartGetIdDefault, cartSetIdDefault } from './cart-id';
-export { handleCartFormAction } from './handleCartFormAction';
 export { CacheNone, CacheShort, CacheLong, CacheCustom } from './cache';
 // 服务端工具
 export { createWithCache, InMemoryCache } from './cache/withCache';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAExE,QAAQ;AACR,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAErF,OAAO,EAAE,2BAA2B,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEzF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKhE,KAAK;AACL,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAExE,QAAQ;AACR,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAErF,OAAO,EAAE,2BAA2B,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEzF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKhE,KAAK;AACL,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopbb/helium",
-  "version": "0.6.4",
+  "version": "0.7.0",
   "description": "shopbb storefront framework — components, React SSR, GraphQL client, cart handler, cache for Cloudflare Workers",
   "license": "MIT",
   "type": "module",
@@ -49,15 +49,8 @@
   "repository": "https://github.com/shopbb/shopbb",
   "peerDependencies": {
     "react": ">=18",
-    "react-dom": ">=18"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    },
-    "react-dom": {
-      "optional": true
-    }
+    "react-dom": ">=18",
+    "react-router": ">=7"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20240117.0",
@@ -65,6 +58,7 @@
     "@types/react-dom": "^18",
     "react": "^18.3.0",
     "react-dom": "^18.3.0",
+    "react-router": "^7.0.0",
     "typescript": "^5.3.3"
   },
   "engines": {