@shopbb/helium 0.5.10 → 0.6.0

package/dist/components/CartCost.js

@@ -0,0 +1,34 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useCart } from './CartProvider';
+import { Money } from './Money';
+export function CartCost(props) {
+    const { amountType = 'total', children, ...moneyProps } = props;
+    const { cart } = useCart();
+    if (!cart?.cost)
+        return null;
+    const cost = cart.cost;
+    let money = null;
+    switch (amountType) {
+        case 'total':
+            money = cost.totalAmount ?? null;
+            break;
+        case 'subtotal':
+            money = cost.subtotalAmount ?? null;
+            break;
+        case 'tax':
+            money = cost.totalTaxAmount ?? cost.taxAmount ?? null;
+            break;
+        case 'duty':
+            money = cost.totalDutyAmount ?? cost.dutyAmount ?? null;
+            break;
+        case 'discount':
+            money = cost.totalDiscountAmount ?? null;
+            break;
+    }
+    if (!money)
+        return null;
+    if (children)
+        return _jsx(_Fragment, { children: children(money) });
+    return _jsx(Money, { data: money, ...moneyProps });
+}
+//# sourceMappingURL=CartCost.js.map

package/dist/components/CartCost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CartCost.js","sourceRoot":"","sources":["../../src/components/CartCost.tsx"],"names":[],"mappings":";AAwBA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAmB,MAAM,SAAS,CAAC;AAqBjD,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,MAAM,EAAE,UAAU,GAAG,OAAO,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,KAAK,CAAC;IAChE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,IAAI;QAAE,OAAO,IAAI,CAAC;IAE7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAW,CAAC;IAC9B,IAAI,KAAK,GAAsB,IAAI,CAAC;IACpC,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,OAAO;YAAE,KAAK,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC;YAAC,MAAM;QACtD,KAAK,UAAU;YAAE,KAAK,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC;YAAC,MAAM;QAC5D,KAAK,KAAK;YAAE,KAAK,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;YAAC,MAAM;QACzE,KAAK,MAAM;YAAE,KAAK,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;YAAC,MAAM;QAC5E,KAAK,UAAU;YAAE,KAAK,GAAG,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC;YAAC,MAAM;IACnE,CAAC;IACD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,IAAI,QAAQ;QAAE,OAAO,4BAAG,QAAQ,CAAC,KAAK,CAAC,GAAI,CAAC;IAC5C,OAAO,KAAC,KAAK,IAAC,IAAI,EAAE,KAAK,KAAM,UAAU,GAAI,CAAC;AAChD,CAAC"}

package/dist/components/CartForm.d.ts

@@ -0,0 +1,201 @@
+/**
+ * <CartForm> — 对齐 Shopify Hydrogen 的 CartForm 组件
+ *
+ * Hydrogen 文档：https://shopify.dev/docs/api/hydrogen/latest/components/cartform
+ *
+ * 用法：
+ *
+ *   import { CartForm } from '@shopby/helium';
+ *
+ *   // 加入购物车
+ *   <CartForm
+ *     action={CartForm.ACTIONS.LinesAdd}
+ *     inputs={{ lines: [{ merchandiseId, quantity: 1 }] }}
+ *     route="/cart"
+ *   >
+ *     <button type="submit">加入购物车</button>
+ *   </CartForm>
+ *
+ *   // 自定义按钮渲染
+ *   <CartForm action={CartForm.ACTIONS.LinesAdd} inputs={{ lines }}>
+ *     {(fetcher) => (
+ *       <button disabled={fetcher.state !== 'idle'}>
+ *         {fetcher.state === 'submitting' ? '添加中…' : '加入购物车'}
+ *       </button>
+ *     )}
+ *   </CartForm>
+ *
+ * 服务端（route action）：
+ *
+ *   import { CartForm } from '@shopbb/helium';
+ *
+ *   export async function action(request, context) {
+ *     const formData = await request.formData();
+ *     const { action, inputs } = CartForm.getFormInput(formData);
+ *     // ... switch(action) { ... }
+ *   }
+ *
+ * ─────────────────────────────────────────────────────────────────
+ *
+ * 实现说明：
+ *
+ *   - 渲染原生 <form method="POST">，无 JS 也能工作（form 默认提交 = 整页 POST）
+ *   - INPUT_NAME = "cartFormInput"（hidden input，value = JSON.stringify({action, inputs})）
+ *   - JS 加载后，由 helium 提供的 useCartFormFetcher hook（或 useFetcher 实现） 拦截 submit 实现"不跳页"
+ *   - 当前简化实现：hydrate 后 onSubmit preventDefault，自己用 fetch 调，调完后通过 CartProvider.applyCart 更新
+ */
+import * as React from 'react';
+export declare const CART_FORM_ACTIONS: {
+    /** Update cart attributes */
+    readonly AttributesUpdateInput: "AttributesUpdateInput";
+    /** Update buyer identity (email, customerAccessToken, country, etc.) */
+    readonly BuyerIdentityUpdate: "BuyerIdentityUpdate";
+    /** Create a new cart */
+    readonly Create: "Create";
+    /** Replace discount codes */
+    readonly DiscountCodesUpdate: "DiscountCodesUpdate";
+    /** Replace gift card codes */
+    readonly GiftCardCodesUpdate: "GiftCardCodesUpdate";
+    /** Append gift card codes */
+    readonly GiftCardCodesAdd: "GiftCardCodesAdd";
+    /** Remove specific gift card codes */
+    readonly GiftCardCodesRemove: "GiftCardCodesRemove";
+    /** Add cart lines */
+    readonly LinesAdd: "LinesAdd";
+    /** Update cart lines (quantity / attributes) */
+    readonly LinesUpdate: "LinesUpdate";
+    /** Remove cart lines */
+    readonly LinesRemove: "LinesRemove";
+    /** Update cart note */
+    readonly NoteUpdate: "NoteUpdate";
+    /** Update selected delivery options */
+    readonly SelectedDeliveryOptionsUpdate: "SelectedDeliveryOptionsUpdate";
+    /** Set metafields */
+    readonly MetafieldsSet: "MetafieldsSet";
+    /** Delete metafields */
+    readonly MetafieldsDelete: "MetafieldsDelete";
+};
+export type CartFormAction = (typeof CART_FORM_ACTIONS)[keyof typeof CART_FORM_ACTIONS] | `Custom${string}`;
+export type CartLineInput = {
+    merchandiseId: string;
+    quantity?: number;
+    attributes?: Array<{
+        key: string;
+        value: string;
+    }>;
+};
+export type CartLineUpdateInput = {
+    id: string;
+    quantity?: number;
+    merchandiseId?: string;
+    attributes?: Array<{
+        key: string;
+        value: string;
+    }>;
+};
+interface OtherFormData {
+    [key: string]: unknown;
+}
+export type CartFormInput = {
+    action: 'LinesAdd';
+    inputs: {
+        lines: CartLineInput[];
+    } & OtherFormData;
+} | {
+    action: 'LinesUpdate';
+    inputs: {
+        lines: CartLineUpdateInput[];
+    } & OtherFormData;
+} | {
+    action: 'LinesRemove';
+    inputs: {
+        lineIds: string[];
+    } & OtherFormData;
+} | {
+    action: 'DiscountCodesUpdate';
+    inputs: {
+        discountCodes: string[];
+    } & OtherFormData;
+} | {
+    action: 'NoteUpdate';
+    inputs: {
+        note: string;
+    } & OtherFormData;
+} | {
+    action: 'BuyerIdentityUpdate';
+    inputs: {
+        buyerIdentity: Record<string, unknown>;
+    } & OtherFormData;
+} | {
+    action: 'AttributesUpdateInput';
+    inputs: {
+        attributes: Array<{
+            key: string;
+            value: string;
+        }>;
+    } & OtherFormData;
+} | {
+    action: 'Create';
+    inputs: {
+        input: Record<string, unknown>;
+    } & OtherFormData;
+} | {
+    action: `Custom${string}`;
+    inputs: Record<string, unknown>;
+};
+/** 服务端 / 客户端共享的 hidden field name — 对齐 Hydrogen */
+declare const INPUT_NAME = "cartFormInput";
+/**
+ * Fetcher 状态对象 — 模仿 Remix useFetcher
+ *
+ * 关键属性：
+ *   - state: 'idle' | 'submitting' | 'loading'
+ *   - data: 服务端 action 返回的 JSON（成功时）
+ *   - error: 错误信息
+ */
+export interface CartFormFetcher {
+    state: 'idle' | 'submitting' | 'loading';
+    data: any;
+    error: string | null;
+    /** 取最近一次提交的 form data（optimistic UI 用） */
+    formData: FormData | null;
+}
+/**
+ * 在 <CartForm> 内部任何深度的组件里拿 fetcher 状态。
+ *
+ *   <CartForm action="LinesAdd" inputs={{lines}}>
+ *     <MyButton />
+ *   </CartForm>
+ *
+ *   function MyButton() {
+ *     const fetcher = useFetcher();
+ *     return <button disabled={fetcher.state !== 'idle'}>添加</button>;
+ *   }
+ */
+export declare function useFetcher(): CartFormFetcher;
+export interface CartFormCommonProps {
+    /** children 可以是普通节点，也可以是 (fetcher) => ReactNode */
+    children: React.ReactNode | ((fetcher: CartFormFetcher) => React.ReactNode);
+    /** 提交的 route。默认 "/cart" */
+    route?: string;
+    /** Optional key — 同一 key 的 fetcher state 共享。当前简化版未使用 */
+    fetcherKey?: string;
+    /** 表单 className（不影响行为） */
+    className?: string;
+}
+export type CartFormProps = CartFormInput & CartFormCommonProps;
+interface CartFormImpl {
+    (props: CartFormProps): React.ReactElement;
+    ACTIONS: typeof CART_FORM_ACTIONS;
+    INPUT_NAME: typeof INPUT_NAME;
+    /**
+     * 服务端 helper：从 request.formData() 解析出 { action, inputs }
+     *
+     *   const formData = await request.formData();
+     *   const { action, inputs } = CartForm.getFormInput(formData);
+     */
+    getFormInput: (formData: FormData) => CartFormInput;
+}
+declare const CartForm: CartFormImpl;
+export { CartForm };
+//# sourceMappingURL=CartForm.d.ts.map

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

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

package/dist/components/CartForm.js

@@ -0,0 +1,213 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * <CartForm> — 对齐 Shopify Hydrogen 的 CartForm 组件
+ *
+ * Hydrogen 文档：https://shopify.dev/docs/api/hydrogen/latest/components/cartform
+ *
+ * 用法：
+ *
+ *   import { CartForm } from '@shopby/helium';
+ *
+ *   // 加入购物车
+ *   <CartForm
+ *     action={CartForm.ACTIONS.LinesAdd}
+ *     inputs={{ lines: [{ merchandiseId, quantity: 1 }] }}
+ *     route="/cart"
+ *   >
+ *     <button type="submit">加入购物车</button>
+ *   </CartForm>
+ *
+ *   // 自定义按钮渲染
+ *   <CartForm action={CartForm.ACTIONS.LinesAdd} inputs={{ lines }}>
+ *     {(fetcher) => (
+ *       <button disabled={fetcher.state !== 'idle'}>
+ *         {fetcher.state === 'submitting' ? '添加中…' : '加入购物车'}
+ *       </button>
+ *     )}
+ *   </CartForm>
+ *
+ * 服务端（route action）：
+ *
+ *   import { CartForm } from '@shopbb/helium';
+ *
+ *   export async function action(request, context) {
+ *     const formData = await request.formData();
+ *     const { action, inputs } = CartForm.getFormInput(formData);
+ *     // ... switch(action) { ... }
+ *   }
+ *
+ * ─────────────────────────────────────────────────────────────────
+ *
+ * 实现说明：
+ *
+ *   - 渲染原生 <form method="POST">，无 JS 也能工作（form 默认提交 = 整页 POST）
+ *   - INPUT_NAME = "cartFormInput"（hidden input，value = JSON.stringify({action, inputs})）
+ *   - JS 加载后，由 helium 提供的 useCartFormFetcher hook（或 useFetcher 实现） 拦截 submit 实现"不跳页"
+ *   - 当前简化实现：hydrate 后 onSubmit preventDefault，自己用 fetch 调，调完后通过 CartProvider.applyCart 更新
+ */
+import * as React from 'react';
+import { useCartOptional } from './CartProvider';
+import { __registerPendingMutation } from './hooks/useOptimisticCart';
+// ============================================================
+// Action 枚举 — 对齐 Hydrogen CartForm.ACTIONS
+// ============================================================
+export const CART_FORM_ACTIONS = {
+    /** Update cart attributes */
+    AttributesUpdateInput: 'AttributesUpdateInput',
+    /** Update buyer identity (email, customerAccessToken, country, etc.) */
+    BuyerIdentityUpdate: 'BuyerIdentityUpdate',
+    /** Create a new cart */
+    Create: 'Create',
+    /** Replace discount codes */
+    DiscountCodesUpdate: 'DiscountCodesUpdate',
+    /** Replace gift card codes */
+    GiftCardCodesUpdate: 'GiftCardCodesUpdate',
+    /** Append gift card codes */
+    GiftCardCodesAdd: 'GiftCardCodesAdd',
+    /** Remove specific gift card codes */
+    GiftCardCodesRemove: 'GiftCardCodesRemove',
+    /** Add cart lines */
+    LinesAdd: 'LinesAdd',
+    /** Update cart lines (quantity / attributes) */
+    LinesUpdate: 'LinesUpdate',
+    /** Remove cart lines */
+    LinesRemove: 'LinesRemove',
+    /** Update cart note */
+    NoteUpdate: 'NoteUpdate',
+    /** Update selected delivery options */
+    SelectedDeliveryOptionsUpdate: 'SelectedDeliveryOptionsUpdate',
+    /** Set metafields */
+    MetafieldsSet: 'MetafieldsSet',
+    /** Delete metafields */
+    MetafieldsDelete: 'MetafieldsDelete',
+};
+// ============================================================
+// <CartForm> 组件
+// ============================================================
+/** 服务端 / 客户端共享的 hidden field name — 对齐 Hydrogen */
+const INPUT_NAME = 'cartFormInput';
+/**
+ * CartFormFetcher Context — 让 CartForm 内部任何位置都能用 useFetcher() 拿状态
+ *
+ * Hydrogen 是用 Remix global fetcher，我们用一个本地 Context。children 既可以是
+ * render prop（推荐），也可以是普通节点 + useFetcher() 调用。
+ */
+const FetcherContext = React.createContext(null);
+/**
+ * 在 <CartForm> 内部任何深度的组件里拿 fetcher 状态。
+ *
+ *   <CartForm action="LinesAdd" inputs={{lines}}>
+ *     <MyButton />
+ *   </CartForm>
+ *
+ *   function MyButton() {
+ *     const fetcher = useFetcher();
+ *     return <button disabled={fetcher.state !== 'idle'}>添加</button>;
+ *   }
+ */
+export function useFetcher() {
+    const ctx = React.useContext(FetcherContext);
+    if (!ctx) {
+        throw new Error('useFetcher must be used inside a <CartForm>');
+    }
+    return ctx;
+}
+const CartFormBase = (props) => {
+    const { children, route = '/cart', className, action, inputs, ...rest } = props;
+    const cartCtx = useCartOptional();
+    // 序列化 { action, inputs } 一并放进 hidden input
+    // 服务端用 CartForm.getFormInput(formData) 反序列化
+    const payload = React.useMemo(() => JSON.stringify({ action, inputs }), [action, inputs]);
+    const [fetcher, setFetcher] = React.useState({
+        state: 'idle',
+        data: null,
+        error: null,
+        formData: null,
+    });
+    // hydrate 后拦截 submit；SSR 时 onSubmit 不存在 → form 原生 POST
+    const handleSubmit = React.useCallback(async (e) => {
+        e.preventDefault();
+        const form = e.currentTarget;
+        const formData = new FormData(form);
+        setFetcher({ state: 'submitting', data: null, error: null, formData });
+        // 注册到 pending store — useOptimisticCart 会看到这个 mutation 立刻应用
+        // 只对 cart line 类型的 action 做（DiscountCodesUpdate / Custom* 等不做 optimistic）
+        let unregisterPending = null;
+        if (action === 'LinesAdd' || action === 'LinesUpdate' || action === 'LinesRemove') {
+            const pendingId = `${action}_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+            unregisterPending = __registerPendingMutation({ id: pendingId, action: action, inputs });
+        }
+        try {
+            // 显式标记 X-Helium-Fetch — 让服务端知道这是 JS fetch 不是原生 form POST
+            // 服务端 handleCartFormAction 看到此 header 会返回 JSON 而不是 303 redirect
+            const res = await fetch(route, {
+                method: 'POST',
+                body: formData,
+                credentials: 'include',
+                headers: { 'Accept': 'application/json', 'X-Helium-Fetch': '1' },
+            });
+            const data = await res.json().catch(() => null);
+            if (!res.ok || data?.error || data?.userErrors?.length) {
+                throw new Error(data?.error || data?.userErrors?.[0]?.message || `HTTP ${res.status}`);
+            }
+            // 服务端约定：成功时返回 { cart: Cart }
+            // 这里直接 applyCart 到 CartProvider，避免 refetch
+            if (data?.cart && cartCtx?.applyCart) {
+                cartCtx.applyCart(data.cart);
+            }
+            setFetcher({ state: 'idle', data, error: null, formData: null });
+        }
+        catch (err) {
+            setFetcher({ state: 'idle', data: null, error: err.message || String(err), formData: null });
+        }
+        finally {
+            unregisterPending?.();
+        }
+    }, [route, cartCtx, action, inputs]);
+    const renderedChildren = typeof children === 'function' ? children(fetcher) : children;
+    return (_jsx(FetcherContext.Provider, { value: fetcher, children: _jsxs("form", { method: "POST", action: route, onSubmit: handleSubmit, className: className, "data-cart-form": true, "data-cart-action": action, children: [_jsx("input", { type: "hidden", name: INPUT_NAME, value: payload }), renderedChildren] }) }));
+};
+/**
+ * 服务端 helper：从 request.formData() 还原出 { action, inputs }
+ *
+ * 与 Hydrogen 完全一致的 API：
+ *
+ *   const formData = await request.formData();
+ *   const { action, inputs } = CartForm.getFormInput(formData);
+ */
+function getFormInput(formData) {
+    const raw = formData.get(INPUT_NAME);
+    if (typeof raw !== 'string') {
+        throw new Error(`CartForm.getFormInput: missing field "${INPUT_NAME}" in form data`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`CartForm.getFormInput: field "${INPUT_NAME}" is not valid JSON`);
+    }
+    if (!parsed || typeof parsed.action !== 'string') {
+        throw new Error('CartForm.getFormInput: missing "action" in parsed payload');
+    }
+    // 合并 form 里的其它字段进 inputs（对齐 Hydrogen 的 OtherFormData 设计）
+    // <CartForm action=NoteUpdate><input name="note" /></CartForm> 这种场景
+    // FormData 里同时有 cartFormInput 和 note 两个字段，inputs.note 来自 FormData 而不是 JSON。
+    const otherInputs = {};
+    for (const [key, value] of formData.entries()) {
+        if (key === INPUT_NAME)
+            continue;
+        otherInputs[key] = value;
+    }
+    return {
+        action: parsed.action,
+        inputs: { ...otherInputs, ...(parsed.inputs || {}) },
+    };
+}
+// 把 ACTIONS / INPUT_NAME / getFormInput 挂到 CartForm 对象上 — 对齐 Hydrogen
+const CartForm = CartFormBase;
+CartForm.ACTIONS = CART_FORM_ACTIONS;
+CartForm.INPUT_NAME = INPUT_NAME;
+CartForm.getFormInput = getFormInput;
+export { CartForm };
+//# sourceMappingURL=CartForm.js.map

package/dist/components/CartForm.js.map

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

package/dist/components/CartLineProvider.d.ts

@@ -0,0 +1,78 @@
+/**
+ * <CartLineProvider> + useCartLine() — 对齐 Hydrogen React
+ *
+ * 在 cart 渲染时，把单行 cart line 通过 Context 提供给子组件。子组件如
+ * <CartLineQuantity>、<CartLineQuantityAdjustButton>、商品图缩略图等都能直接
+ * useCartLine() 拿到 line 数据，无需 prop drilling。
+ *
+ * 用法：
+ *
+ *   {cart.lines.nodes.map((line) => (
+ *     <CartLineProvider key={line.id} line={line}>
+ *       <CartLineImage />
+ *       <CartLineTitle />
+ *       <CartLineQuantity />
+ *       <CartLineQuantityAdjustButton />
+ *     </CartLineProvider>
+ *   ))}
+ *
+ *   function CartLineImage() {
+ *     const line = useCartLine();
+ *     return <Image data={line.merchandise.image} />;
+ *   }
+ */
+import * as React from 'react';
+/**
+ * Cart line 的核心字段。任何符合此 shape 的对象都能传入。
+ * 实际可以包含更多字段（merchandise / attributes / 等），由 oxygen Storefront
+ * GraphQL schema 决定。
+ */
+export interface CartLineLike {
+    id: string;
+    quantity: number;
+    merchandise?: {
+        id?: string;
+        title?: string;
+        image?: {
+            url: string;
+            altText?: string | null;
+        } | null;
+        price?: {
+            amount: string;
+            currencyCode: string;
+        };
+        product?: {
+            title?: string;
+            handle?: string;
+        } | null;
+    };
+    cost?: {
+        totalAmount: {
+            amount: string;
+            currencyCode: string;
+        };
+        amountPerQuantity?: {
+            amount: string;
+            currencyCode: string;
+        };
+    };
+    attributes?: Array<{
+        key: string;
+        value: string;
+    }>;
+    [key: string]: any;
+}
+export interface CartLineProviderProps {
+    line: CartLineLike;
+    children: React.ReactNode;
+}
+export declare function CartLineProvider({ line, children }: CartLineProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * 拿当前 cart line。Provider 外抛错。
+ */
+export declare function useCartLine(): CartLineLike;
+/**
+ * 非 throw 版本：Provider 外返回 null。供能在 Provider 内外都工作的组件用。
+ */
+export declare function useCartLineOptional(): CartLineLike | null;
+//# sourceMappingURL=CartLineProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CartLineProvider.d.ts","sourceRoot":"","sources":["../../src/components/CartLineProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,CAAC;QACxD,KAAK,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC;QACjD,OAAO,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;KACtD,CAAC;IACF,IAAI,CAAC,EAAE;QACL,WAAW,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC;QACtD,iBAAiB,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC;KAC9D,CAAC;IACF,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAID,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,qBAAqB,2CAEzE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,YAAY,CAM1C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,GAAG,IAAI,CAEzD"}

package/dist/components/CartLineProvider.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * <CartLineProvider> + useCartLine() — 对齐 Hydrogen React
+ *
+ * 在 cart 渲染时，把单行 cart line 通过 Context 提供给子组件。子组件如
+ * <CartLineQuantity>、<CartLineQuantityAdjustButton>、商品图缩略图等都能直接
+ * useCartLine() 拿到 line 数据，无需 prop drilling。
+ *
+ * 用法：
+ *
+ *   {cart.lines.nodes.map((line) => (
+ *     <CartLineProvider key={line.id} line={line}>
+ *       <CartLineImage />
+ *       <CartLineTitle />
+ *       <CartLineQuantity />
+ *       <CartLineQuantityAdjustButton />
+ *     </CartLineProvider>
+ *   ))}
+ *
+ *   function CartLineImage() {
+ *     const line = useCartLine();
+ *     return <Image data={line.merchandise.image} />;
+ *   }
+ */
+import * as React from 'react';
+const CartLineContext = React.createContext(null);
+export function CartLineProvider({ line, children }) {
+    return _jsx(CartLineContext.Provider, { value: line, children: children });
+}
+/**
+ * 拿当前 cart line。Provider 外抛错。
+ */
+export function useCartLine() {
+    const line = React.useContext(CartLineContext);
+    if (!line) {
+        throw new Error('useCartLine must be used inside <CartLineProvider>');
+    }
+    return line;
+}
+/**
+ * 非 throw 版本：Provider 外返回 null。供能在 Provider 内外都工作的组件用。
+ */
+export function useCartLineOptional() {
+    return React.useContext(CartLineContext);
+}
+//# sourceMappingURL=CartLineProvider.js.map

package/dist/components/CartLineProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CartLineProvider.js","sourceRoot":"","sources":["../../src/components/CartLineProvider.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAyB/B,MAAM,eAAe,GAAG,KAAK,CAAC,aAAa,CAAsB,IAAI,CAAC,CAAC;AAOvE,MAAM,UAAU,gBAAgB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAyB;IACxE,OAAO,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YAAG,QAAQ,GAA4B,CAAC;AACtF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AAC3C,CAAC"}

package/dist/components/CartLineQuantity.d.ts

@@ -0,0 +1,24 @@
+/**
+ * <CartLineQuantity> — 对齐 Hydrogen React
+ *
+ * 渲染当前 cart line 的数量。从 <CartLineProvider> Context 拿 line.quantity。
+ *
+ * 用法：
+ *   <CartLineProvider line={line}>
+ *     数量：<CartLineQuantity />
+ *   </CartLineProvider>
+ *
+ * 自定义渲染元素：
+ *   <CartLineQuantity as="strong" className="qty-badge" />
+ */
+import * as React from 'react';
+export interface CartLineQuantityProps {
+    /** 渲染标签，默认 span */
+    as?: keyof JSX.IntrinsicElements;
+    /** className */
+    className?: string;
+    /** 子节点 — 数字会显示在 children 之前；通常不传 */
+    children?: React.ReactNode;
+}
+export declare function CartLineQuantity(props: CartLineQuantityProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CartLineQuantity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CartLineQuantity.d.ts","sourceRoot":"","sources":["../../src/components/CartLineQuantity.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,WAAW,qBAAqB;IACpC,mBAAmB;IACnB,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,iBAAiB,CAAC;IACjC,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,2CAU5D"}

package/dist/components/CartLineQuantity.js

@@ -0,0 +1,9 @@
+import { jsxs as _jsxs } from "react/jsx-runtime";
+import { useCartLine } from './CartLineProvider';
+export function CartLineQuantity(props) {
+    const { as, className, children } = props;
+    const line = useCartLine();
+    const Tag = as || 'span';
+    return (_jsxs(Tag, { className: className, "data-cart-line-quantity": true, children: [line.quantity, children] }));
+}
+//# sourceMappingURL=CartLineQuantity.js.map

package/dist/components/CartLineQuantity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CartLineQuantity.js","sourceRoot":"","sources":["../../src/components/CartLineQuantity.tsx"],"names":[],"mappings":";AAeA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAWjD,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAC1C,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAQ,EAAE,IAAI,MAAM,CAAC;IAC9B,OAAO,CACL,MAAC,GAAG,IAAC,SAAS,EAAE,SAAS,8CACtB,IAAI,CAAC,QAAQ,EACb,QAAQ,IACL,CACP,CAAC;AACJ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"DiscountSelector.d.ts","sourceRoot":"","sources":["../../src/components/DiscountSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,uBAAuB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1C,YAAY;IACZ,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;KAAE,KAAK,KAAK,CAAC,SAAS,CAAC;CAC5J;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,2CAuG5D"}
+{"version":3,"file":"DiscountSelector.d.ts","sourceRoot":"","sources":["../../src/components/DiscountSelector.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,uBAAuB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1C,YAAY;IACZ,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;KAAE,KAAK,KAAK,CAAC,SAAS,CAAC;CAC5J;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,2CAsF5D"}