@shopbb/helium 0.5.10 → 0.6.1

package/dist/cache/withCache.d.ts

@@ -0,0 +1,49 @@
+/**
+ * createWithCache + InMemoryCache — 对齐 Hydrogen
+ *
+ * Hydrogen 的 `createWithCache({cache, waitUntil})` 返回一个高阶函数，
+ * 用 `withCache.run(strategy, cacheKey, fn)` 包裹任意异步函数，自动加 cache。
+ *
+ * 在 Cloudflare Workers 上 cache 可以是：
+ *   - `caches.default` / `caches.open(...)` (Cache API — 真正的 edge cache)
+ *   - `InMemoryCache` (本 worker 实例内存，per-instance；轻量缓存)
+ *
+ * 用法：
+ *
+ *   const withCache = createWithCache({ cache: await caches.open('helium'), waitUntil });
+ *
+ *   const products = await withCache.run(
+ *     CacheLong(),
+ *     ['products', 'page', '1'],
+ *     async () => storefront.query(PRODUCTS_QUERY, { variables }),
+ *   );
+ *
+ * 简化点（vs Hydrogen）：
+ *   - 不实现 stale-while-revalidate 后台 revalidate（Workers 内复杂，先做基础）
+ *   - 不实现 stale-if-error
+ *   - 提供 InMemoryCache 兜底（test / 没 caches.open 的环境）
+ */
+import type { CacheStrategy } from '../types';
+export type CachingStrategy = CacheStrategy;
+export type CacheKey = string | (string | number)[];
+export interface WithCacheOptions {
+    cache: Cache | InMemoryCache;
+    waitUntil?: (p: Promise<any>) => void;
+}
+export interface WithCache {
+    /** 用 cache 包裹异步函数。命中 cache 直接返回；未命中执行 fn 写入 */
+    run<T>(strategy: CachingStrategy, key: CacheKey, fn: () => Promise<T>): Promise<T>;
+    /** 直接读 cache（不执行 fn） */
+    get<T>(key: CacheKey): Promise<T | null>;
+    /** 写 cache */
+    set<T>(strategy: CachingStrategy, key: CacheKey, value: T): Promise<void>;
+}
+export declare function createWithCache(opts: WithCacheOptions): WithCache;
+export declare class InMemoryCache {
+    private store;
+    get<T = any>(key: string): T | null;
+    set<T = any>(key: string, value: T, maxAgeSeconds: number): void;
+    delete(key: string): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=withCache.d.ts.map

package/dist/cache/withCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withCache.d.ts","sourceRoot":"","sources":["../../src/cache/withCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC;AAE5C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,GAAG,aAAa,CAAC;IAC7B,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnF,wBAAwB;IACxB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzC,cAAc;IACd,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAgBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,CA8CjE;AAWD,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAA+B;IAE5C,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAUnC,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAKhE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,IAAI,IAAI;CAGd"}

package/dist/cache/withCache.js

@@ -0,0 +1,117 @@
+/**
+ * createWithCache + InMemoryCache — 对齐 Hydrogen
+ *
+ * Hydrogen 的 `createWithCache({cache, waitUntil})` 返回一个高阶函数，
+ * 用 `withCache.run(strategy, cacheKey, fn)` 包裹任意异步函数，自动加 cache。
+ *
+ * 在 Cloudflare Workers 上 cache 可以是：
+ *   - `caches.default` / `caches.open(...)` (Cache API — 真正的 edge cache)
+ *   - `InMemoryCache` (本 worker 实例内存，per-instance；轻量缓存)
+ *
+ * 用法：
+ *
+ *   const withCache = createWithCache({ cache: await caches.open('helium'), waitUntil });
+ *
+ *   const products = await withCache.run(
+ *     CacheLong(),
+ *     ['products', 'page', '1'],
+ *     async () => storefront.query(PRODUCTS_QUERY, { variables }),
+ *   );
+ *
+ * 简化点（vs Hydrogen）：
+ *   - 不实现 stale-while-revalidate 后台 revalidate（Workers 内复杂，先做基础）
+ *   - 不实现 stale-if-error
+ *   - 提供 InMemoryCache 兜底（test / 没 caches.open 的环境）
+ */
+function toCacheKey(key) {
+    if (typeof key === 'string')
+        return key;
+    return key.map(String).join(':');
+}
+function buildCacheControl(strategy) {
+    const dirs = [];
+    if (strategy.mode === 'NONE')
+        return 'no-store';
+    if (strategy.mode === 'PUBLIC')
+        dirs.push('public');
+    if (strategy.maxAge != null)
+        dirs.push(`max-age=${strategy.maxAge}`);
+    if (strategy.staleWhileRevalidate != null)
+        dirs.push(`stale-while-revalidate=${strategy.staleWhileRevalidate}`);
+    return dirs.join(', ');
+}
+export function createWithCache(opts) {
+    const { cache, waitUntil } = opts;
+    async function get(key) {
+        const cacheKey = toCacheKey(key);
+        if (cache instanceof InMemoryCache) {
+            return cache.get(cacheKey);
+        }
+        const req = new Request(`https://helium.cache/${encodeURIComponent(cacheKey)}`);
+        const cached = await cache.match(req);
+        if (!cached)
+            return null;
+        try {
+            return (await cached.json());
+        }
+        catch {
+            return null;
+        }
+    }
+    async function set(strategy, key, value) {
+        if (strategy.mode === 'NONE')
+            return;
+        const cacheKey = toCacheKey(key);
+        if (cache instanceof InMemoryCache) {
+            cache.set(cacheKey, value, strategy.maxAge ?? 0);
+            return;
+        }
+        const req = new Request(`https://helium.cache/${encodeURIComponent(cacheKey)}`);
+        const res = new Response(JSON.stringify(value), {
+            headers: {
+                'Content-Type': 'application/json',
+                'Cache-Control': buildCacheControl(strategy),
+            },
+        });
+        const p = cache.put(req, res);
+        if (waitUntil)
+            waitUntil(p);
+        else
+            await p;
+    }
+    async function run(strategy, key, fn) {
+        if (strategy.mode === 'NONE')
+            return fn();
+        const cached = await get(key);
+        if (cached !== null)
+            return cached;
+        const value = await fn();
+        await set(strategy, key, value);
+        return value;
+    }
+    return { run, get, set };
+}
+export class InMemoryCache {
+    store = new Map();
+    get(key) {
+        const e = this.store.get(key);
+        if (!e)
+            return null;
+        if (e.expiresAt > 0 && Date.now() > e.expiresAt) {
+            this.store.delete(key);
+            return null;
+        }
+        return e.value;
+    }
+    set(key, value, maxAgeSeconds) {
+        const expiresAt = maxAgeSeconds > 0 ? Date.now() + maxAgeSeconds * 1000 : 0;
+        this.store.set(key, { value, expiresAt });
+    }
+    delete(key) {
+        return this.store.delete(key);
+    }
+    clear() {
+        this.store.clear();
+    }
+}
+//# sourceMappingURL=withCache.js.map

package/dist/cache/withCache.js.map

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

package/dist/components/AddToCartButton.d.ts

@@ -1,41 +1,47 @@
 /**
  * <AddToCartButton> — 加入购物车按钮
  *
- * 对齐 @shopify/hydrogen <AddToCartButton>：
- *   - 内置 loading 态、disabled、error 处理
- *   - 支持 onAdd 回调（实际加购逻辑由外部 cart hook 提供）
- *   - 触发 analytics 事件钩子
- *   - 不带样式，商家自己控制
+ * 对齐 Shopify Hydrogen：本质是包了一个 <CartForm action={LinesAdd}> + <button type="submit">。
  *
- * 用法（Phase 1，需要传 onAdd）：
- *   const { addLine } = useCart();
- *   <AddToCartButton
- *     variantId={selectedVariant.id}
- *     quantity={1}
- *     disabled={!selectedVariant.availableForSale}
- *     onAdd={(vid, qty) => addLine(vid, qty)}
- *   >
- *     加入购物车
- *   </AddToCartButton>
+ *   - SSR HTML 是原生 <form>，无 JS 也能加购（form 提交 → 服务端 redirect 回 referrer）
+ *   - hydrate 后 JS 拦截 submit → fetch /cart → CartProvider.applyCart → 无刷新
+ *   - loading 状态由 CartForm.fetcher 暴露，通过 useFetcher() 读取
  *
- * Phase 2 后：组件会自动从 <CartProvider> 拿，无需 onAdd 也能用。
+ * 商家也可以直接组合 <CartForm>，不用我们这个 wrapper：
+ *
+ *   <CartForm route="/cart" action={CartForm.ACTIONS.LinesAdd} inputs={{ lines: [...] }}>
+ *     <button type="submit">加入购物车</button>
+ *   </CartForm>
  */
 import * as React from 'react';
-export interface AddToCartButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onClick' | 'onError'> {
+export interface AddToCartButtonProps {
     /** 必传：variant 的 GID（gid://shopbb/ProductVariant/...） */
     variantId: string;
     /** 数量，默认 1 */
     quantity?: number;
-    /** 实际加购回调。Phase 1 必传；Phase 2 后可从 Provider 自动获取 */
-    onAdd?: (variantId: string, quantity: number) => Promise<void>;
-    /** 加购成功回调（如导航到 /cart） */
+    /** 行级 attributes（如 gift_message） */
+    attributes?: Array<{
+        key: string;
+        value: string;
+    }>;
+    /** 加购成功回调（仅 hydrated 后触发） */
     onAdded?: () => void;
     /** 加购失败回调 */
     onError?: (err: Error) => void;
-    /** 加购中显示的文本，默认 "加入中..." */
+    /** 加购中显示的文本 */
     loadingText?: React.ReactNode;
-    /** 不可用时显示的文本，默认 "缺货" */
+    /** 不可用时显示的文本 */
     unavailableText?: React.ReactNode;
+    /** disabled */
+    disabled?: boolean;
+    /** 包装 form className */
+    className?: string;
+    /** 按钮 className */
+    buttonClassName?: string;
+    /** 提交的 route，默认 /cart */
+    route?: string;
+    /** 按钮内容 */
+    children?: React.ReactNode;
 }
 export declare function AddToCartButton(props: AddToCartButtonProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=AddToCartButton.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AddToCartButton.d.ts","sourceRoot":"","sources":["../../src/components/AddToCartButton.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACtH,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,aAAa;IACb,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,2BAA2B;IAC3B,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,wBAAwB;IACxB,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACnC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,2CAwD1D"}
+{"version":3,"file":"AddToCartButton.d.ts","sourceRoot":"","sources":["../../src/components/AddToCartButton.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,aAAa;IACb,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,eAAe;IACf,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,gBAAgB;IAChB,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAClC,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW;IACX,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,2CAwC1D"}

package/dist/components/AddToCartButton.js

@@ -2,62 +2,51 @@ import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * <AddToCartButton> — 加入购物车按钮
  *
- * 对齐 @shopify/hydrogen <AddToCartButton>：
- *   - 内置 loading 态、disabled、error 处理
- *   - 支持 onAdd 回调（实际加购逻辑由外部 cart hook 提供）
- *   - 触发 analytics 事件钩子
- *   - 不带样式，商家自己控制
+ * 对齐 Shopify Hydrogen：本质是包了一个 <CartForm action={LinesAdd}> + <button type="submit">。
  *
- * 用法（Phase 1，需要传 onAdd）：
- *   const { addLine } = useCart();
- *   <AddToCartButton
- *     variantId={selectedVariant.id}
- *     quantity={1}
- *     disabled={!selectedVariant.availableForSale}
- *     onAdd={(vid, qty) => addLine(vid, qty)}
- *   >
- *     加入购物车
- *   </AddToCartButton>
+ *   - SSR HTML 是原生 <form>，无 JS 也能加购（form 提交 → 服务端 redirect 回 referrer）
+ *   - hydrate 后 JS 拦截 submit → fetch /cart → CartProvider.applyCart → 无刷新
+ *   - loading 状态由 CartForm.fetcher 暴露，通过 useFetcher() 读取
  *
- * Phase 2 后：组件会自动从 <CartProvider> 拿，无需 onAdd 也能用。
+ * 商家也可以直接组合 <CartForm>，不用我们这个 wrapper：
+ *
+ *   <CartForm route="/cart" action={CartForm.ACTIONS.LinesAdd} inputs={{ lines: [...] }}>
+ *     <button type="submit">加入购物车</button>
+ *   </CartForm>
  */
 import * as React from 'react';
-import { useCartOptional } from './CartProvider';
+import { CartForm, useFetcher } from './CartForm';
 import { useAnalytics } from './AnalyticsProvider';
 export function AddToCartButton(props) {
-    const { variantId, quantity = 1, onAdd, onAdded, onError, loadingText = '加入中...', unavailableText = '缺货', children = '加入购物车', disabled: disabledProp, ...rest } = props;
-    const [adding, setAdding] = React.useState(false);
-    const cart = useCartOptional();
+    const { variantId, quantity = 1, attributes, onAdded, onError, loadingText = '加入中...', unavailableText = '缺货', disabled = false, className, buttonClassName, route = '/cart', children = '加入购物车', } = props;
+    const line = { merchandiseId: variantId, quantity };
+    if (attributes && attributes.length > 0)
+        line.attributes = attributes;
+    return (_jsx(CartForm, { route: route, action: CartForm.ACTIONS.LinesAdd, inputs: { lines: [line] }, className: className, children: _jsx(AddToCartButtonInner, { disabled: disabled, buttonClassName: buttonClassName, loadingText: loadingText, unavailableText: unavailableText, variantId: variantId, quantity: quantity, onAdded: onAdded, onError: onError, children: children }) }));
+}
+/**
+ * Inner component — 合法地 useFetcher / useEffect，监听 fetcher.state 变化。
+ */
+function AddToCartButtonInner({ disabled, buttonClassName, loadingText, unavailableText, children, variantId, quantity, onAdded, onError, }) {
+    const fetcher = useFetcher();
     const analytics = useAnalytics();
-    const handleClick = async (e) => {
-        e.preventDefault();
-        if (adding || disabledProp)
-            return;
-        setAdding(true);
-        try {
-            if (onAdd) {
-                // 商家显式传了 onAdd 优先用（Phase 1 兼容路径）
-                await onAdd(variantId, quantity);
+    // 监听 fetcher 完成
+    const prevState = React.useRef(fetcher.state);
+    React.useEffect(() => {
+        const wasNonIdle = prevState.current !== 'idle';
+        const isIdle = fetcher.state === 'idle';
+        if (wasNonIdle && isIdle) {
+            if (fetcher.error) {
+                onError?.(new Error(fetcher.error));
             }
-            else if (cart) {
-                // 自动从 <CartProvider> 取
-                await cart.linesAdd([{ merchandiseId: variantId, quantity }]);
+            else if (fetcher.data?.cart) {
+                analytics.emit('add_to_cart', { variantId, quantity });
+                onAdded?.();
             }
-            else {
-                console.warn('[AddToCartButton] no onAdd and no <CartProvider> — button does nothing');
-                return;
-            }
-            analytics.emit('add_to_cart', { variantId, quantity });
-            onAdded?.();
-        }
-        catch (err) {
-            console.error('[AddToCartButton] add failed:', err);
-            onError?.(err instanceof Error ? err : new Error(String(err)));
-        }
-        finally {
-            setAdding(false);
         }
-    };
-    return (_jsx("button", { type: "button", ...rest, "data-add-to-cart": true, "data-loading": adding ? '' : undefined, disabled: disabledProp || adding, onClick: handleClick, children: adding ? loadingText : disabledProp ? unavailableText : children }));
+        prevState.current = fetcher.state;
+    }, [fetcher.state, fetcher.error, fetcher.data, onAdded, onError, analytics, variantId, quantity]);
+    const adding = fetcher.state !== 'idle';
+    return (_jsx("button", { type: "submit", className: buttonClassName, disabled: disabled || adding, "data-add-to-cart": true, "data-loading": adding ? '' : undefined, children: adding ? loadingText : disabled ? unavailableText : children }));
 }
 //# sourceMappingURL=AddToCartButton.js.map

package/dist/components/AddToCartButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"AddToCartButton.js","sourceRoot":"","sources":["../../src/components/AddToCartButton.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAmBnD,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EACJ,SAAS,EACT,QAAQ,GAAG,CAAC,EACZ,KAAK,EACL,OAAO,EACP,OAAO,EACP,WAAW,GAAG,QAAQ,EACtB,eAAe,GAAG,IAAI,EACtB,QAAQ,GAAG,OAAO,EAClB,QAAQ,EAAE,YAAY,EACtB,GAAG,IAAI,EACR,GAAG,KAAK,CAAC;IAEV,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IAEjC,MAAM,WAAW,GAAG,KAAK,EAAE,CAAsC,EAAE,EAAE;QACnE,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,IAAI,MAAM,IAAI,YAAY;YAAE,OAAO;QAEnC,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,CAAC;gBACV,iCAAiC;gBACjC,MAAM,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACnC,CAAC;iBAAM,IAAI,IAAI,EAAE,CAAC;gBAChB,uBAAuB;gBACvB,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;gBACvF,OAAO;YACT,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;YACpD,OAAO,EAAE,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;gBAAS,CAAC;YACT,SAAS,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CACL,iBACE,IAAI,EAAC,QAAQ,KACT,IAAI,4CAEM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EACrC,QAAQ,EAAE,YAAY,IAAI,MAAM,EAChC,OAAO,EAAE,WAAW,YAEnB,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,GAC1D,CACV,CAAC;AACJ,CAAC"}
+{"version":3,"file":"AddToCartButton.js","sourceRoot":"","sources":["../../src/components/AddToCartButton.tsx"],"names":[],"mappings":"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"}

package/dist/components/BuyNowButton.d.ts

@@ -0,0 +1,45 @@
+/**
+ * <BuyNowButton> — 对齐 Hydrogen React
+ *
+ * "立即购买" — 创建/添加 line + 跳 checkout，一步到位。
+ *
+ * 实现：
+ *   1. 内部包 <CartForm action="LinesAdd" inputs={{lines, navigateOnSuccess: '/checkout'}}>
+ *   2. submit 成功后 client 自动 navigate 到 checkoutUrl（或 fallback /checkout）
+ *   3. 无 JS 时：浏览器走 form POST，服务端 303 跳 /checkout
+ *
+ * 用法：
+ *   <BuyNowButton variantId="gid://..." quantity={1}>立即购买</BuyNowButton>
+ */
+import * as React from 'react';
+export interface BuyNowButtonProps {
+    /** 必传 variant GID */
+    variantId: string;
+    /** 数量，默认 1 */
+    quantity?: number;
+    /** 行级 attributes */
+    attributes?: Array<{
+        key: string;
+        value: string;
+    }>;
+    /** 加购后跳转的 URL（client 端），默认走 cart.checkoutUrl，回退 /checkout */
+    redirectTo?: string;
+    /** 失败回调 */
+    onError?: (err: Error) => void;
+    /** Loading 文案 */
+    loadingText?: React.ReactNode;
+    /** Disabled 文案 */
+    unavailableText?: React.ReactNode;
+    /** disabled */
+    disabled?: boolean;
+    /** Form className */
+    className?: string;
+    /** 按钮 className */
+    buttonClassName?: string;
+    /** 按钮 content */
+    children?: React.ReactNode;
+    /** 提交 route，默认 /cart */
+    route?: string;
+}
+export declare function BuyNowButton(props: BuyNowButtonProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BuyNowButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BuyNowButton.d.ts","sourceRoot":"","sources":["../../src/components/BuyNowButton.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,iBAAiB;IACjB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,kBAAkB;IAClB,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAClC,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,2CAwCpD"}

package/dist/components/BuyNowButton.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * <BuyNowButton> — 对齐 Hydrogen React
+ *
+ * "立即购买" — 创建/添加 line + 跳 checkout，一步到位。
+ *
+ * 实现：
+ *   1. 内部包 <CartForm action="LinesAdd" inputs={{lines, navigateOnSuccess: '/checkout'}}>
+ *   2. submit 成功后 client 自动 navigate 到 checkoutUrl（或 fallback /checkout）
+ *   3. 无 JS 时：浏览器走 form POST，服务端 303 跳 /checkout
+ *
+ * 用法：
+ *   <BuyNowButton variantId="gid://..." quantity={1}>立即购买</BuyNowButton>
+ */
+import * as React from 'react';
+import { CartForm, useFetcher } from './CartForm';
+import { useAnalytics } from './AnalyticsProvider';
+export function BuyNowButton(props) {
+    const { variantId, quantity = 1, attributes, redirectTo, onError, loadingText = '处理中...', unavailableText = '暂不可购', disabled = false, className, buttonClassName, children = '立即购买', route = '/cart', } = props;
+    const line = { merchandiseId: variantId, quantity };
+    if (attributes && attributes.length > 0)
+        line.attributes = attributes;
+    return (_jsx(CartForm, { route: route, action: CartForm.ACTIONS.LinesAdd, inputs: { lines: [line] }, className: className, children: _jsx(BuyNowButtonInner, { disabled: disabled, buttonClassName: buttonClassName, loadingText: loadingText, unavailableText: unavailableText, variantId: variantId, quantity: quantity, redirectTo: redirectTo, onError: onError, children: children }) }));
+}
+function BuyNowButtonInner({ disabled, buttonClassName, loadingText, unavailableText, children, variantId, quantity, redirectTo, onError, }) {
+    const fetcher = useFetcher();
+    const analytics = useAnalytics();
+    const prevState = React.useRef(fetcher.state);
+    React.useEffect(() => {
+        const wasNonIdle = prevState.current !== 'idle';
+        const isIdle = fetcher.state === 'idle';
+        if (wasNonIdle && isIdle) {
+            if (fetcher.error) {
+                onError?.(new Error(fetcher.error));
+            }
+            else if (fetcher.data?.cart) {
+                analytics.emit('buy_now', { variantId, quantity });
+                const target = redirectTo || fetcher.data.cart.checkoutUrl || '/checkout';
+                if (typeof window !== 'undefined') {
+                    window.location.href = target;
+                }
+            }
+        }
+        prevState.current = fetcher.state;
+    }, [fetcher.state, fetcher.error, fetcher.data, redirectTo, onError, analytics, variantId, quantity]);
+    const pending = fetcher.state !== 'idle';
+    return (_jsx("button", { type: "submit", className: buttonClassName, disabled: disabled || pending, "data-buy-now": true, "data-loading": pending ? '' : undefined, children: pending ? loadingText : disabled ? unavailableText : children }));
+}
+//# sourceMappingURL=BuyNowButton.js.map

package/dist/components/BuyNowButton.js.map

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

package/dist/components/CartCheckoutButton.d.ts

@@ -0,0 +1,39 @@
+/**
+ * <CartCheckoutButton> — 对齐 Hydrogen React
+ *
+ * 渲染一个跳到 cart.checkoutUrl 的按钮。最常见的"去结算"入口。
+ *
+ * 行为：
+ *   - 取 cart.checkoutUrl，无 cart / 空 cart 时按钮 disabled
+ *   - 默认 <a> 元素（无 JS 也能用），可改成 <button> + onClick
+ *   - 渲染纯样式，行为非业务逻辑
+ *
+ * 用法：
+ *   <CartCheckoutButton>去结算</CartCheckoutButton>
+ *
+ *   // 自定义渲染
+ *   <CartCheckoutButton>
+ *     {(href, disabled) => (
+ *       <a href={href} className="my-cta" aria-disabled={disabled}>
+ *         结算 {cart.totalQuantity} 件
+ *       </a>
+ *     )}
+ *   </CartCheckoutButton>
+ */
+import * as React from 'react';
+export interface CartCheckoutButtonProps {
+    /** className */
+    className?: string;
+    /** 强制 disabled（即使 cart 有 checkoutUrl） */
+    disabled?: boolean;
+    /** 按钮内容；不传默认 "去结算" */
+    children?: React.ReactNode | ((href: string, disabled: boolean) => React.ReactNode);
+    /** 自定义渲染元素，默认 a */
+    as?: 'a' | 'button';
+    /** 点击回调（事件触发） */
+    onClick?: React.MouseEventHandler;
+    /** 透传其它 props 到根元素 */
+    [key: string]: any;
+}
+export declare function CartCheckoutButton(props: CartCheckoutButtonProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CartCheckoutButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CartCheckoutButton.d.ts","sourceRoot":"","sources":["../../src/components/CartCheckoutButton.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,WAAW,uBAAuB;IACtC,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;IACpF,mBAAmB;IACnB,EAAE,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAC;IACpB,iBAAiB;IACjB,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC;IAClC,sBAAsB;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,2CAuDhE"}

package/dist/components/CartCheckoutButton.js

@@ -0,0 +1,32 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useCart } from './CartProvider';
+export function CartCheckoutButton(props) {
+    const { className, disabled: disabledProp, children, as = 'a', onClick, ...rest } = props;
+    const { cart } = useCart();
+    const href = cart?.checkoutUrl;
+    const noCart = !cart || cart.totalQuantity === 0 || !href;
+    const disabled = !!disabledProp || noCart;
+    if (typeof children === 'function') {
+        return _jsx(_Fragment, { children: children(href || '#', disabled) });
+    }
+    const label = children ?? '去结算';
+    if (as === 'button') {
+        return (_jsx("button", { type: "button", className: className, disabled: disabled, "data-cart-checkout-button": true, onClick: (e) => {
+                if (disabled)
+                    return;
+                onClick?.(e);
+                if (!e.defaultPrevented && href) {
+                    window.location.href = href;
+                }
+            }, ...rest, children: label }));
+    }
+    // <a> 形式：无 JS 也能跳
+    return (_jsx("a", { href: disabled ? undefined : href, className: className, "aria-disabled": disabled || undefined, "data-cart-checkout-button": true, "data-disabled": disabled ? '' : undefined, onClick: (e) => {
+            if (disabled) {
+                e.preventDefault();
+                return;
+            }
+            onClick?.(e);
+        }, ...rest, children: label }));
+}
+//# sourceMappingURL=CartCheckoutButton.js.map

package/dist/components/CartCheckoutButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CartCheckoutButton.js","sourceRoot":"","sources":["../../src/components/CartCheckoutButton.tsx"],"names":[],"mappings":";AAwBA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAiBzC,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAC/D,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAC1F,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;IAE3B,MAAM,IAAI,GAAI,IAAY,EAAE,WAAiC,CAAC;IAC9D,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAC1D,MAAM,QAAQ,GAAG,CAAC,CAAC,YAAY,IAAI,MAAM,CAAC;IAE1C,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,4BAAG,QAAQ,CAAC,IAAI,IAAI,GAAG,EAAE,QAAQ,CAAC,GAAI,CAAC;IAChD,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,IAAI,KAAK,CAAC;IAEhC,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;QACpB,OAAO,CACL,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,qCAElB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;gBACb,IAAI,QAAQ;oBAAE,OAAO;gBACrB,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;gBACb,IAAI,CAAC,CAAC,CAAC,gBAAgB,IAAI,IAAI,EAAE,CAAC;oBAChC,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;gBAC9B,CAAC;YACH,CAAC,KACG,IAAI,YAEP,KAAK,GACC,CACV,CAAC;IACJ,CAAC;IAED,kBAAkB;IAClB,OAAO,CACL,YACE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EACjC,SAAS,EAAE,SAAS,mBACL,QAAQ,IAAI,SAAS,sDAErB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EACxC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YACb,IAAI,QAAQ,EAAE,CAAC;gBACb,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,OAAO;YACT,CAAC;YACD,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACf,CAAC,KACG,IAAI,YAEP,KAAK,GACJ,CACL,CAAC;AACJ,CAAC"}

package/dist/components/CartCost.d.ts

@@ -0,0 +1,43 @@
+/**
+ * <CartCost> — 对齐 Hydrogen React
+ *
+ * 从 <CartProvider> 拿 cart.cost 渲染金额。amountType 控制渲染哪个：
+ *   "total"      → cost.totalAmount (默认)
+ *   "subtotal"   → cost.subtotalAmount
+ *   "tax"        → cost.totalTaxAmount
+ *   "duty"       → cost.totalDutyAmount
+ *   "discount"   → cost.totalDiscountAmount（shopbb-extension）
+ *
+ * 内部用 <Money> 渲染，自动按 currencyCode 加货币符号。
+ *
+ * 用法：
+ *   <CartCost amountType="subtotal" />      ¥300.00
+ *   <CartCost amountType="discount" as="strong" />  ¥30.00
+ *   <CartCost amountType="total" withoutTrailingZeros />
+ *
+ * 自定义渲染：
+ *   <CartCost amountType="total">
+ *     {(money) => <strong>{money.amount} {money.currencyCode}</strong>}
+ *   </CartCost>
+ */
+import * as React from 'react';
+import { type MoneyProps } from './Money';
+export interface MoneyValue {
+    amount: string;
+    currencyCode: string;
+}
+export interface CartCostProps extends Omit<MoneyProps, 'data' | 'children'> {
+    /**
+     * 渲染哪一项 cost。默认 "total"。
+     * - "total"    : 含运费 / 税 / 折扣的最终金额
+     * - "subtotal" : 商品小计（折扣前 / 运费前）
+     * - "tax"      : 税
+     * - "duty"     : 关税
+     * - "discount" : 优惠金额（shopbb extension）
+     */
+    amountType?: 'total' | 'subtotal' | 'tax' | 'duty' | 'discount';
+    /** 自定义渲染：(money) => ReactNode */
+    children?: (money: MoneyValue) => React.ReactNode;
+}
+export declare function CartCost(props: CartCostProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=CartCost.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CartCost.d.ts","sourceRoot":"","sources":["../../src/components/CartCost.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1E;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;IAChE,iCAAiC;IACjC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;CACnD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,kDAkB5C"}