@shopbb/helium 0.4.0 → 0.5.0

package/dist/components/DiscountSelector.js

@@ -0,0 +1,111 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * <DiscountSelector>
+ *
+ * Cart 上的优惠券选择器 — 卡片式 UI，对齐拼多多 / 京东体验。
+ *
+ * 行为：
+ *   - 默认显示当前应用的券（服务端自动选了最佳，或买家显式选的）
+ *   - 点"切换"打开抽屉/弹窗，列出该买家所有可用券（从 useDiscounts().myDiscounts）
+ *   - 选另一张 → 调 cartDiscountSelect mutation
+ *   - 点"不使用优惠券" → cartDiscountClear
+ *
+ * 未登录买家：渲染"登录后享受优惠"提示。
+ *
+ * 设计目标：
+ *   - 这是 helium "脚手架" 的卡片式实现。商家可以替换为抽屉式 / 弹窗式自定义 UI。
+ *   - 商家也可以直接用 useDiscounts() 自己渲染（提供 hook-only 路径）。
+ */
+import * as React from 'react';
+import { useDiscounts } from './DiscountProvider';
+import { useCart } from './CartProvider';
+import { useShop } from './ShopProvider';
+import { useAnalytics } from './AnalyticsProvider';
+import { Money } from './Money';
+export function DiscountSelector(props) {
+    const { className, unauthenticatedFallback, renderApplied } = props;
+    const { myDiscounts, myDiscountsStatus, cartAllocations } = useDiscounts();
+    const { cart, refetch: refetchCart } = useCart();
+    const shop = useShop();
+    const analytics = useAnalytics();
+    const [open, setOpen] = React.useState(false);
+    const [pending, setPending] = React.useState(false);
+    // 服务端已经决定了 cart 上是哪张券
+    const appliedAlloc = cartAllocations[0];
+    const appliedClaimId = cart?.appliedDiscountClaim?.claimId ?? null;
+    const appliedTitle = cart?.appliedDiscountClaim?.title ?? appliedAlloc?.title;
+    const appliedCode = cart?.appliedDiscountClaim?.code ?? appliedAlloc?.code;
+    const callSelectMutation = async (claimId) => {
+        if (!cart)
+            return;
+        setPending(true);
+        try {
+            const token = (typeof localStorage !== 'undefined') ? (localStorage.getItem('shopbb:buyer_token') || localStorage.getItem('shopflare:buyer_token')) : null;
+            const mutation = claimId
+                ? `mutation S($id: ID!, $c: ID!) { cartDiscountSelect(cartId: $id, claimId: $c) { cart { id } userErrors { message } } }`
+                : `mutation C($id: ID!) { cartDiscountClear(cartId: $id) { cart { id } userErrors { message } } }`;
+            const variables = { id: cart.id };
+            if (claimId)
+                variables.c = claimId;
+            const res = await fetch(shop.apiUrl, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Storefront-Access-Token': shop.storefrontAccessToken,
+                    ...(token ? { Authorization: `Bearer ${token}` } : {}),
+                },
+                body: JSON.stringify({ query: mutation, variables }),
+                credentials: 'include',
+            });
+            await res.json();
+            // 重新拉 cart 让 UI 更新（拿到新的 discountAllocations）
+            await refetchCart();
+        }
+        finally {
+            setPending(false);
+            setOpen(false);
+        }
+    };
+    // 未登录
+    if (myDiscountsStatus === 'unauthenticated') {
+        return unauthenticatedFallback !== undefined ? _jsx(_Fragment, { children: unauthenticatedFallback }) : (_jsxs("div", { "data-discount-selector": true, "data-unauth": true, className: className, children: [_jsx("span", { children: "\u767B\u5F55\u540E\u53EF\u4F7F\u7528\u4F18\u60E0\u5238" }), _jsx("a", { href: "/login?next=/cart", children: "\u53BB\u767B\u5F55" })] }));
+    }
+    if (myDiscountsStatus === 'loading') {
+        return _jsx("div", { "data-discount-selector": true, "data-loading": true, className: className, children: "\u52A0\u8F7D\u4F18\u60E0\u5238\u2026" });
+    }
+    const availableClaims = myDiscounts.filter((c) => !c.isExpired && c.remainingUses > 0);
+    if (availableClaims.length === 0) {
+        return (_jsx("div", { "data-discount-selector": true, "data-no-discount": true, className: className, children: _jsx("span", { children: "\u6682\u65E0\u53EF\u7528\u4F18\u60E0\u5238" }) }));
+    }
+    return (_jsxs(_Fragment, { children: [_jsx("div", { "data-discount-selector": true, className: className, children: appliedClaimId ? (renderApplied ? renderApplied({
+                    code: appliedCode ?? null,
+                    title: appliedTitle ?? '',
+                    amount: appliedAlloc?.discountedAmount ?? { amount: '0', currencyCode: 'CNY' },
+                    onChange: () => setOpen(true),
+                    onClear: () => callSelectMutation(null),
+                }) : (_jsxs("div", { "data-applied": true, children: [_jsxs("div", { "data-info": true, children: [_jsx("span", { "data-label": true, children: "\u5DF2\u4F7F\u7528" }), _jsx("strong", { "data-title": true, children: appliedTitle }), appliedAlloc && (_jsxs("span", { "data-amount": true, children: ["\u2212 ", _jsx(Money, { data: { amount: appliedAlloc.discountedAmount.amount, currencyCode: appliedAlloc.discountedAmount.currencyCode } })] }))] }), _jsxs("div", { "data-actions": true, children: [_jsx("button", { type: "button", onClick: () => setOpen(true), disabled: pending, children: "\u5207\u6362" }), _jsx("button", { type: "button", onClick: () => callSelectMutation(null), disabled: pending, "data-clear": true, children: "\u4E0D\u4F7F\u7528" })] })] }))) : (_jsxs("div", { "data-empty-applied": true, children: [_jsx("div", { "data-info": true, children: _jsxs("span", { "data-label": true, children: ["\u6709 ", availableClaims.length, " \u5F20\u53EF\u7528\u4F18\u60E0\u5238"] }) }), _jsx("button", { type: "button", onClick: () => setOpen(true), disabled: pending, children: "\u9009\u62E9" })] })) }), open && (_jsx(DiscountPickerSheet, { claims: availableClaims, currentClaimId: appliedClaimId, onSelect: (claimId) => {
+                    analytics.emit('discount_select', { claimId });
+                    callSelectMutation(claimId);
+                }, onClose: () => setOpen(false), pending: pending }))] }));
+}
+/**
+ * 抽屉式选券面板。
+ * Demo 实现为屏底固定面板；商家可以替换为 modal / 抽屉等。
+ */
+function DiscountPickerSheet({ claims, currentClaimId, onSelect, onClose, pending, }) {
+    return (_jsx("div", { "data-discount-picker-overlay": true, onClick: onClose, children: _jsxs("div", { "data-discount-picker-sheet": true, onClick: (e) => e.stopPropagation(), children: [_jsxs("div", { "data-sheet-header": true, children: [_jsx("h3", { children: "\u9009\u62E9\u4F18\u60E0\u5238" }), _jsx("button", { type: "button", onClick: onClose, "data-sheet-close": true, children: "\u00D7" })] }), _jsx("div", { "data-sheet-list": true, children: claims.map((c) => {
+                        const id = c.id.replace(/^gid:\/\/shopbb\/DiscountClaim\//, '');
+                        const isCurrent = currentClaimId === id;
+                        return (_jsxs("button", { type: "button", "data-claim-card": true, "data-current": isCurrent ? '' : undefined, onClick: () => onSelect(id), disabled: pending, children: [_jsxs("div", { "data-claim-left": true, children: [_jsx("div", { "data-claim-value": true, children: formatValue(c) }), c.discount.minSubtotal && (_jsxs("div", { "data-claim-min": true, children: ["\u6EE1 ", _jsx(Money, { data: { amount: c.discount.minSubtotal.amount, currencyCode: c.discount.minSubtotal.currencyCode } }), " \u53EF\u7528"] }))] }), _jsxs("div", { "data-claim-right": true, children: [_jsx("div", { "data-claim-title": true, children: c.discount.title }), c.discount.code && _jsx("div", { "data-claim-code": true, children: c.discount.code }), c.expiresAt && (_jsxs("div", { "data-claim-expiry": true, children: [new Date(c.expiresAt).toLocaleDateString('zh-CN'), " \u8FC7\u671F"] }))] }), isCurrent && _jsx("span", { "data-claim-current-tag": true, children: "\u5F53\u524D\u4F7F\u7528" })] }, c.id));
+                    }) })] }) }));
+}
+function formatValue(c) {
+    if (c.discount.valueType === 'PERCENTAGE' && c.discount.valuePercentage != null) {
+        return `${100 - c.discount.valuePercentage} 折`;
+    }
+    if (c.discount.valueType === 'FIXED_AMOUNT' && c.discount.valueAmount) {
+        return `− ¥${c.discount.valueAmount.amount}`;
+    }
+    return '免运费';
+}
+//# sourceMappingURL=DiscountSelector.js.map

package/dist/components/DiscountSelector.js.map

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

package/dist/components/index.d.ts

@@ -48,6 +48,8 @@ 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 { DiscountCodeInput, AppliedDiscountList, BestDiscountHint, ClaimableDiscountList, DiscountClaimButton, MyDiscountList, } from './DiscountComponents';
-export type { DiscountCodeInputProps, AppliedDiscountListProps, BestDiscountHintProps, ClaimableDiscountListProps, DiscountClaimButtonProps, MyDiscountListProps, } from './DiscountComponents';
+export { AppliedDiscountList, ClaimableDiscountList, DiscountClaimButton, MyDiscountList, } from './DiscountComponents';
+export type { AppliedDiscountListProps, ClaimableDiscountListProps, DiscountClaimButtonProps, MyDiscountListProps, } from './DiscountComponents';
+export { DiscountSelector } from './DiscountSelector';
+export type { DiscountSelectorProps } from './DiscountSelector';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACjF,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGzG,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEvE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,YAAY,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAExF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"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"}

package/dist/components/index.js

@@ -37,5 +37,6 @@ export { AddressForm } from './AddressForm';
 export { AddressPicker } from './AddressPicker';
 // 优惠券（W4b）
 export { DiscountProvider, useDiscounts, useDiscountsOptional, useProductDiscounts, } from './DiscountProvider';
-export { DiscountCodeInput, AppliedDiscountList, BestDiscountHint, ClaimableDiscountList, DiscountClaimButton, MyDiscountList, } from './DiscountComponents';
+export { AppliedDiscountList, ClaimableDiscountList, DiscountClaimButton, MyDiscountList, } from './DiscountComponents';
+export { DiscountSelector } from './DiscountSelector';
 //# sourceMappingURL=index.js.map

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;AAGxE,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,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GACf,MAAM,sBAAsB,CAAC"}
+{"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;AAGxE,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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopbb/helium",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "shopbb storefront framework — components, React SSR, GraphQL client, cart handler, cache for Cloudflare Workers",
   "license": "MIT",
   "type": "module",

package/src/components/CartProvider.tsx

@@ -101,8 +101,17 @@ const CART_FRAGMENT = /* GraphQL */ `
     }
     cost {
       subtotalAmount { amount currencyCode }
+      totalDiscountAmount { amount currencyCode }
       totalAmount { amount currencyCode }
     }
+    discountCodes { code applicable }
+    discountAllocations {
+      discountedAmount { amount currencyCode }
+      targetType
+      targetId
+      title
+      code
+    }
   }
 `;
 

package/src/components/DiscountComponents.tsx

@@ -1,13 +1,15 @@
 /**
- * Discount UI 组件集（W4b）
+ * Discount UI 组件集
  *
- *   <DiscountCodeInput>          cart / checkout 输入框
- *   <AppliedDiscountList>        当前 cart 已应用的码列表
- *   <BestDiscountHint>           "可省 ¥X" 提示
+ *   <AppliedDiscountList>        当前 cart 已应用的折扣分配（只读）
  *   <ClaimableDiscountList>      可领取的优惠券列表（首页 / 商品页）
  *   <DiscountClaimButton>        单个领取按钮
  *   <MyDiscountList>             我的卡包
  *
+ * 注：W5 已删除以下组件（旧设计）：
+ *   - <DiscountCodeInput>: 输入框范式已过时。请用 <DiscountSelector> + <ClaimableDiscountList>。
+ *   - <BestDiscountHint>: 服务端自动选择最佳券，不需要前端提示。用户在 <DiscountSelector> 看到 / 切换。
+ *
  * 全部无样式 + data-* 钩子。
  */
 
@@ -17,70 +19,7 @@ import { useAnalytics } from './AnalyticsProvider';
 import { Money } from './Money';
 
 // ============================================================
-// 1. DiscountCodeInput
-// ============================================================
-
-export interface DiscountCodeInputProps {
-  placeholder?: string;
-  buttonText?: string;
-  onApplied?: (code: string) => void;
-  onError?: (msg: string) => void;
-  className?: string;
-}
-
-export function DiscountCodeInput(props: DiscountCodeInputProps) {
-  const { placeholder = '输入优惠码', buttonText = '应用', onApplied, onError, className } = props;
-  const { applyToCart } = useDiscounts();
-  const analytics = useAnalytics();
-  const [code, setCode] = React.useState('');
-  const [loading, setLoading] = React.useState(false);
-  const [err, setErr] = React.useState<string | null>(null);
-
-  const submit = async () => {
-    const c = code.trim();
-    if (!c) return;
-    setLoading(true);
-    setErr(null);
-    try {
-      const r = await applyToCart(c);
-      if (r.userErrors.length > 0) {
-        const msg = r.userErrors[0].message;
-        setErr(msg);
-        onError?.(msg);
-      } else {
-        setCode('');
-        onApplied?.(c);
-        analytics.emit('discount_apply_to_cart', { code: c });
-      }
-    } finally {
-      setLoading(false);
-    }
-  };
-
-  return (
-    <form
-      data-discount-code-input
-      className={className}
-      onSubmit={(e) => { e.preventDefault(); submit(); }}
-    >
-      <div data-row>
-        <input
-          value={code}
-          onChange={(e) => setCode(e.target.value)}
-          placeholder={placeholder}
-          disabled={loading}
-        />
-        <button type="submit" disabled={loading || !code.trim()}>
-          {loading ? '...' : buttonText}
-        </button>
-      </div>
-      {err && <div data-error>{err}</div>}
-    </form>
-  );
-}
-
-// ============================================================
-// 2. AppliedDiscountList
+// AppliedDiscountList
 // ============================================================
 
 export interface AppliedDiscountListProps {
@@ -90,96 +29,37 @@ export interface AppliedDiscountListProps {
 
 export function AppliedDiscountList(props: AppliedDiscountListProps) {
   const { className, emptyText = null } = props;
-  const { appliedToCart, cartAllocations, removeFromCart } = useDiscounts();
-  const analytics = useAnalytics();
+  const { cartAllocations } = useDiscounts();
 
-  if (appliedToCart.length === 0) return <>{emptyText}</>;
+  if (cartAllocations.length === 0) return <>{emptyText}</>;
 
   return (
     <div data-applied-discount-list className={className}>
-      {appliedToCart.map((dc) => {
-        const alloc = cartAllocations.find((a) => a.code === dc.code);
-        return (
-          <div
-            key={dc.code}
-            data-applied-item
-            data-applicable={dc.applicable ? '' : undefined}
-          >
-            <div data-info>
-              <span data-code>{dc.code}</span>
-              {alloc && (
-                <span data-discount-amount>
-                  − <Money data={{ amount: alloc.discountedAmount.amount, currencyCode: alloc.discountedAmount.currencyCode }} />
-                </span>
-              )}
-              {!dc.applicable && <span data-warning>不适用</span>}
-            </div>
-            <button
-              type="button"
-              data-remove
-              onClick={async () => {
-                await removeFromCart(dc.code);
-                analytics.emit('discount_remove_from_cart', { code: dc.code });
-              }}
-            >
-              ×
-            </button>
+      {cartAllocations.map((alloc, i) => (
+        <div key={alloc.code || i} data-applied-item>
+          <div data-info>
+            <span data-title>{alloc.title}</span>
+            {alloc.code && <span data-code>{alloc.code}</span>}
           </div>
-        );
-      })}
-    </div>
-  );
-}
-
-// ============================================================
-// 3. BestDiscountHint
-// ============================================================
-
-export interface BestDiscountHintProps {
-  className?: string;
-  /** 自定义渲染（高级用法） */
-  render?: (best: { discount: DiscountClaim; estimatedAmount: number; apply: () => Promise<void> }) => React.ReactNode;
-}
-
-export function BestDiscountHint(props: BestDiscountHintProps) {
-  const { className, render } = props;
-  const { bestApplicableForCart, applyToCart } = useDiscounts();
-  const analytics = useAnalytics();
-  if (!bestApplicableForCart) return null;
-  const { discount: claim, estimatedAmount } = bestApplicableForCart;
-  const code = claim.discount.code;
-  if (!code) return null;
-
-  const apply = async () => {
-    await applyToCart(code);
-    analytics.emit('discount_apply_to_cart', { code, source: 'best_hint' });
-  };
-
-  if (render) return <>{render({ discount: claim, estimatedAmount, apply })}</>;
-
-  return (
-    <div data-best-discount-hint className={className}>
-      <div data-msg>
-        使用 <strong data-code>{code}</strong> 可省{' '}
-        <strong data-amount><Money data={{ amount: String(estimatedAmount), currencyCode: 'CNY' }} /></strong>
-      </div>
-      <button type="button" onClick={apply} data-apply>立即使用</button>
+          <span data-discount-amount>
+            − <Money data={{ amount: alloc.discountedAmount.amount, currencyCode: alloc.discountedAmount.currencyCode }} />
+          </span>
+        </div>
+      ))}
     </div>
   );
 }
 
 // ============================================================
-// 4. ClaimableDiscountList
+// ClaimableDiscountList
 // ============================================================
 
 export interface ClaimableDiscountListProps {
   scope?: 'store' | 'product';
-  /** scope='product' 时必传 */
   productHandle?: string;
   first?: number;
   className?: string;
   emptyText?: React.ReactNode;
-  /** 自定义渲染（高级用法） */
   renderItem?: (discount: Discount) => React.ReactNode;
 }
 
@@ -226,17 +106,13 @@ function DefaultClaimableItem({ discount: d }: { discount: Discount }) {
 }
 
 function formatDiscountValue(d: Discount): string {
-  if (d.value.__typename === 'DiscountPercentage') {
-    return `${100 - d.value.percentage} 折`;
-  }
-  if (d.value.__typename === 'DiscountAmount') {
-    return `减 ¥${d.value.amount.amount}`;
-  }
+  if (d.value.__typename === 'DiscountPercentage') return `${100 - d.value.percentage} 折`;
+  if (d.value.__typename === 'DiscountAmount') return `减 ¥${d.value.amount.amount}`;
   return '免运费';
 }
 
 // ============================================================
-// 5. DiscountClaimButton
+// DiscountClaimButton
 // ============================================================
 
 export interface DiscountClaimButtonProps {
@@ -244,6 +120,8 @@ export interface DiscountClaimButtonProps {
   children?: React.ReactNode;
   loadingText?: React.ReactNode;
   claimedText?: React.ReactNode;
+  /** 未登录时跳转的路径。默认 `/login?next=` + 当前路径 */
+  loginPath?: string;
   onClaimed?: () => void;
   onError?: (msg: string) => void;
   className?: string;
@@ -253,9 +131,10 @@ export function DiscountClaimButton(props: DiscountClaimButtonProps) {
   const {
     discount, children = '领取',
     loadingText = '领取中…', claimedText = '已领取',
+    loginPath,
     onClaimed, onError, className,
   } = props;
-  const { claim, myDiscounts } = useDiscounts();
+  const { claim, myDiscounts, myDiscountsStatus } = useDiscounts();
   const analytics = useAnalytics();
   const [loading, setLoading] = React.useState(false);
   const [err, setErr] = React.useState<string | null>(null);
@@ -263,6 +142,13 @@ export function DiscountClaimButton(props: DiscountClaimButtonProps) {
   const alreadyClaimed = myDiscounts.some((c) => c.discount.id === discount.id);
 
   const handleClaim = async () => {
+    // 未登录 → 跳 login
+    if (myDiscountsStatus === 'unauthenticated') {
+      if (typeof window === 'undefined') return;
+      const next = encodeURIComponent(window.location.pathname + window.location.search);
+      window.location.href = loginPath || `/login?next=${next}`;
+      return;
+    }
     if (!discount.code) return;
     setLoading(true);
     setErr(null);
@@ -303,13 +189,12 @@ export function DiscountClaimButton(props: DiscountClaimButtonProps) {
 }
 
 // ============================================================
-// 6. MyDiscountList (我的卡包)
+// MyDiscountList (我的卡包)
 // ============================================================
 
 export interface MyDiscountListProps {
   className?: string;
   emptyText?: React.ReactNode;
-  /** 过滤 tabs（available / used / expired），默认显示 available */
   filter?: 'available' | 'used' | 'expired' | 'all';
 }
 
@@ -324,7 +209,6 @@ export function MyDiscountList(props: MyDiscountListProps) {
     if (filter === 'all') return true;
     if (filter === 'expired') return c.isExpired;
     if (filter === 'used') return c.remainingUses === 0 && !c.isExpired;
-    // available
     return !c.isExpired && c.remainingUses > 0;
   });
 

package/src/components/DiscountProvider.tsx

@@ -87,19 +87,19 @@ export interface DiscountContextValue {
   /** 我领过的有效券 */
   myDiscounts: DiscountClaim[];
   myDiscountsStatus: 'unauthenticated' | 'idle' | 'loading' | 'error';
-  /** 当前 cart 上应用的码 */
-  appliedToCart: CartDiscountCode[];
-  /** 当前 cart 上的折扣分配明细 */
+  /**
+   * 当前 cart 上的折扣分配明细。
+   * W5 起：cart 上最多一张券（自动选最佳 / 买家手动选）。
+   * 数组语义保留兼容（未来可能允许多张叠加）。
+   */
   cartAllocations: CartDiscountAllocation[];
-  /** 当前 cart 上最大可省（计算了用户已领但未应用的券） */
-  bestApplicableForCart: { discount: DiscountClaim; estimatedAmount: number } | null;
+  /** 当前应用的 claim ID（W5），null = 无折扣或买家未登录 */
+  appliedClaimId: string | null;
   /** 错误 */
   error: string | null;
 
   // 操作
   claim: (code: string) => Promise<{ claim?: DiscountClaim; userErrors: DiscountUserError[] }>;
-  applyToCart: (code: string) => Promise<{ userErrors: DiscountUserError[] }>;
-  removeFromCart: (code: string) => Promise<{ userErrors: DiscountUserError[] }>;
   refetchMyDiscounts: () => Promise<void>;
   refetchPublicDiscounts: () => Promise<void>;
 }
@@ -280,95 +280,30 @@ export function DiscountProvider(props: DiscountProviderProps) {
     [customerGql, refetchMyDiscounts],
   );
 
-  // ----- cart apply / remove -----
-  const appliedToCart = cartCtx?.cart && (cartCtx.cart as any).discountCodes ? (cartCtx.cart as any).discountCodes as CartDiscountCode[] : [];
-  const cartAllocations = cartCtx?.cart && (cartCtx.cart as any).discountAllocations ? (cartCtx.cart as any).discountAllocations as CartDiscountAllocation[] : [];
-
-  const applyCodes = React.useCallback(
-    async (codes: string[]) => {
-      if (!cartCtx?.cart) return { userErrors: [{ code: 'NO_CART', message: 'cart 不存在' }] };
-      const result = await storefrontGql<{ cartDiscountCodesUpdate: { cart: any; userErrors: DiscountUserError[] } }>(
-        `mutation U($id: ID!, $codes: [String!]!) {
-           cartDiscountCodesUpdate(cartId: $id, discountCodes: $codes) {
-             cart { id }
-             userErrors { field code message }
-           }
-         }`,
-        { id: cartCtx.cart.id, codes },
-      );
-      if (result.errors?.length) {
-        return { userErrors: [{ code: 'NETWORK_ERROR', message: result.errors[0].message }] };
-      }
-      // 刷 cart（拉新的 discountCodes / allocations）
-      await cartCtx.refetch();
-      return { userErrors: result.data!.cartDiscountCodesUpdate.userErrors };
-    },
-    [cartCtx, storefrontGql],
-  );
-
-  const applyToCart = React.useCallback(
-    async (code: string) => {
-      const existing = appliedToCart.map((d) => d.code);
-      if (existing.includes(code.toUpperCase())) return { userErrors: [] };
-      return applyCodes([...existing, code.toUpperCase()]);
-    },
-    [appliedToCart, applyCodes],
-  );
-
-  const removeFromCart = React.useCallback(
-    async (code: string) => {
-      const next = appliedToCart.map((d) => d.code).filter((c) => c !== code.toUpperCase());
-      return applyCodes(next);
-    },
-    [appliedToCart, applyCodes],
-  );
-
-  // ----- best applicable for cart -----
-  const bestApplicableForCart = React.useMemo(() => {
-    if (!cartCtx?.cart || myDiscounts.length === 0) return null;
-    const subtotalStr = (cartCtx.cart as any).cost?.subtotalAmount?.amount;
-    const subtotal = Number(subtotalStr || 0);
-    if (subtotal <= 0) return null;
-
-    const currentApplied = new Set(appliedToCart.map((d) => d.code));
-
-    let best: { discount: DiscountClaim; estimatedAmount: number } | null = null;
-    for (const claimed of myDiscounts) {
-      const d = claimed.discount;
-      if (!d.code || claimed.isExpired) continue;
-      if (currentApplied.has(d.code)) continue;
-      // 门槛
-      if (d.minSubtotal && Number(d.minSubtotal.amount) > subtotal) continue;
-      // 估算折扣
-      let amount = 0;
-      if (d.valueType === 'PERCENTAGE' && d.valuePercentage != null) {
-        amount = Math.floor(subtotal * (d.valuePercentage / 100) * 100) / 100;
-      } else if (d.valueType === 'FIXED_AMOUNT' && d.valueAmount) {
-        amount = Math.min(Number(d.valueAmount.amount), subtotal);
-      }
-      if (amount > 0 && (best == null || amount > best.estimatedAmount)) {
-        best = { discount: claimed, estimatedAmount: amount };
-      }
-    }
-    return best;
-  }, [cartCtx, myDiscounts, appliedToCart]);
+  // ----- 当前 cart 上的折扣（服务端算好的） -----
+  const cartAllocations = cartCtx?.cart && (cartCtx.cart as any).discountAllocations
+    ? (cartCtx.cart as any).discountAllocations as CartDiscountAllocation[]
+    : [];
+  // W5: 服务端的 appliedDiscountClaim（哪张被选中应用了）
+  const appliedClaimId: string | null = cartCtx?.cart && (cartCtx.cart as any).appliedDiscountClaim?.claimId
+    ? (cartCtx.cart as any).appliedDiscountClaim.claimId
+    : null;
 
   const value: DiscountContextValue = React.useMemo(
     () => ({
       publicDiscounts, publicDiscountsStatus,
       myDiscounts, myDiscountsStatus,
-      appliedToCart, cartAllocations,
-      bestApplicableForCart,
+      cartAllocations,
+      appliedClaimId,
       error,
-      claim, applyToCart, removeFromCart,
+      claim,
       refetchMyDiscounts, refetchPublicDiscounts,
     }),
     [
       publicDiscounts, publicDiscountsStatus,
       myDiscounts, myDiscountsStatus,
-      appliedToCart, cartAllocations,
-      bestApplicableForCart, error,
-      claim, applyToCart, removeFromCart,
+      cartAllocations, appliedClaimId, error,
+      claim,
       refetchMyDiscounts, refetchPublicDiscounts,
     ],
   );