@shopbb/helium 0.3.0-alpha.1 → 0.3.0

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;AAE/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,2CA+C1D"}
+{"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"}

package/dist/components/AddToCartButton.js

@@ -22,20 +22,32 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * Phase 2 后：组件会自动从 <CartProvider> 拿，无需 onAdd 也能用。
  */
 import * as React from 'react';
+import { useCartOptional } from './CartProvider';
+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 analytics = useAnalytics();
     const handleClick = async (e) => {
         e.preventDefault();
         if (adding || disabledProp)
             return;
-        if (!onAdd) {
-            console.warn('[AddToCartButton] onAdd not provided; this button does nothing in Phase 1');
-            return;
-        }
         setAdding(true);
         try {
-            await onAdd(variantId, quantity);
+            if (onAdd) {
+                // 商家显式传了 onAdd 优先用（Phase 1 兼容路径）
+                await onAdd(variantId, quantity);
+            }
+            else if (cart) {
+                // 自动从 <CartProvider> 取
+                await cart.linesAdd([{ merchandiseId: variantId, quantity }]);
+            }
+            else {
+                console.warn('[AddToCartButton] no onAdd and no <CartProvider> — button does nothing');
+                return;
+            }
+            analytics.emit('add_to_cart', { variantId, quantity });
             onAdded?.();
         }
         catch (err) {

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;AAmB/B,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;IAElD,MAAM,WAAW,GAAG,KAAK,EAAE,CAAsC,EAAE,EAAE;QACnE,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,IAAI,MAAM,IAAI,YAAY;YAAE,OAAO;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;YAC1F,OAAO;QACT,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACjC,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":";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"}

package/dist/components/AnalyticsProvider.d.ts

@@ -0,0 +1,106 @@
+/**
+ * <AnalyticsProvider> + useAnalytics() + <Analytics.*> 事件组件
+ *
+ * 简单事件总线：
+ *   - 商家注册 reporters（GA / Plausible / 自家 API）
+ *   - 通过 <Analytics.PageView /> / <Analytics.ProductView /> 等组件声明式触发
+ *   - 也可以 useAnalytics().emit(name, data)
+ *
+ * 用法：
+ *   <AnalyticsProvider
+ *     onEvent={(e) => {
+ *       fetch('/api/analytics', { method: 'POST', body: JSON.stringify(e) });
+ *       window.dataLayer?.push(e);
+ *     }}
+ *   >
+ *     <App />
+ *   </AnalyticsProvider>
+ *
+ *   // 在某页：
+ *   <Analytics.PageView path="/products" title="Products" />
+ *   <Analytics.ProductView product={product} />
+ *   <Analytics.AddToCart cart={cart} addedLineId={lineId} />
+ *
+ *   // 命令式：
+ *   const { emit } = useAnalytics();
+ *   emit('search', { query: 'wireless' });
+ */
+import * as React from 'react';
+export interface AnalyticsEvent {
+    /** 事件名，例如 'page_view' / 'product_view' / 'add_to_cart' */
+    name: string;
+    /** 时间戳 (ms) */
+    timestamp: number;
+    /** 当前 shop（如果在 ShopProvider 内） */
+    shop?: {
+        storeId: string;
+        shopName: string;
+    } | null;
+    /** 自定义 payload */
+    payload: Record<string, any>;
+}
+export interface AnalyticsContextValue {
+    emit: (name: string, payload?: Record<string, any>) => void;
+}
+export interface AnalyticsProviderProps {
+    children: React.ReactNode;
+    /** 接收所有事件的回调 */
+    onEvent?: (event: AnalyticsEvent) => void;
+    /** 是否自动监听 cart 变化触发 cart_updated 事件 */
+    trackCart?: boolean;
+}
+export declare function AnalyticsProvider(props: AnalyticsProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useAnalytics(): AnalyticsContextValue;
+declare function PageView(props: {
+    path?: string;
+    title?: string;
+    [key: string]: any;
+}): null;
+declare function ProductView(props: {
+    product: {
+        id: string;
+        handle?: string;
+        title?: string;
+    };
+    [key: string]: any;
+}): null;
+declare function CollectionView(props: {
+    collection: {
+        id: string;
+        handle?: string;
+    };
+    [key: string]: any;
+}): null;
+declare function SearchView(props: {
+    query: string;
+    results?: number;
+}): null;
+declare function AddToCart(props: {
+    variantId: string;
+    quantity?: number;
+    [key: string]: any;
+}): null;
+declare function CheckoutStart(props: {
+    cart?: {
+        id: string;
+        totalQuantity?: number;
+    };
+}): null;
+declare function Purchase(props: {
+    orderId: string;
+    total: number;
+    currencyCode: string;
+    [key: string]: any;
+}): null;
+/** 命名空间导出，让用户写 <Analytics.PageView /> */
+export declare const Analytics: {
+    PageView: typeof PageView;
+    ProductView: typeof ProductView;
+    CollectionView: typeof CollectionView;
+    SearchView: typeof SearchView;
+    AddToCart: typeof AddToCart;
+    CheckoutStart: typeof CheckoutStart;
+    Purchase: typeof Purchase;
+};
+export {};
+//# sourceMappingURL=AnalyticsProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsProvider.d.ts","sourceRoot":"","sources":["../../src/components/AnalyticsProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpD,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;CAC7D;AAID,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,gBAAgB;IAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,2CAkC9D;AAED,wBAAgB,YAAY,IAAI,qBAAqB,CAOpD;AAkBD,iBAAS,QAAQ,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,QAE7E;AAED,iBAAS,WAAW,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,QAQ3G;AAED,iBAAS,cAAc,CAAC,KAAK,EAAE;IAAE,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,QAOjG;AAED,iBAAS,UAAU,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,QAE7D;AAED,iBAAS,SAAS,CAAC,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,QAOrF;AAED,iBAAS,aAAa,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,QAK9E;AAED,iBAAS,QAAQ,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,QAEpG;AAED,yCAAyC;AACzC,eAAO,MAAM,SAAS;;;;;;;;CAQrB,CAAC"}

package/dist/components/AnalyticsProvider.js

@@ -0,0 +1,135 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * <AnalyticsProvider> + useAnalytics() + <Analytics.*> 事件组件
+ *
+ * 简单事件总线：
+ *   - 商家注册 reporters（GA / Plausible / 自家 API）
+ *   - 通过 <Analytics.PageView /> / <Analytics.ProductView /> 等组件声明式触发
+ *   - 也可以 useAnalytics().emit(name, data)
+ *
+ * 用法：
+ *   <AnalyticsProvider
+ *     onEvent={(e) => {
+ *       fetch('/api/analytics', { method: 'POST', body: JSON.stringify(e) });
+ *       window.dataLayer?.push(e);
+ *     }}
+ *   >
+ *     <App />
+ *   </AnalyticsProvider>
+ *
+ *   // 在某页：
+ *   <Analytics.PageView path="/products" title="Products" />
+ *   <Analytics.ProductView product={product} />
+ *   <Analytics.AddToCart cart={cart} addedLineId={lineId} />
+ *
+ *   // 命令式：
+ *   const { emit } = useAnalytics();
+ *   emit('search', { query: 'wireless' });
+ */
+import * as React from 'react';
+import { useCartOptional } from './CartProvider';
+import { useShopOptional } from './ShopProvider';
+const Ctx = React.createContext(null);
+export function AnalyticsProvider(props) {
+    const { children, onEvent, trackCart = true } = props;
+    const shop = useShopOptional();
+    const cartCtx = useCartOptional();
+    const onEventRef = React.useRef(onEvent);
+    React.useEffect(() => {
+        onEventRef.current = onEvent;
+    }, [onEvent]);
+    const emit = React.useCallback((name, payload = {}) => {
+        onEventRef.current?.({
+            name,
+            timestamp: Date.now(),
+            shop: shop ? { storeId: shop.storeId, shopName: shop.shopName } : null,
+            payload,
+        });
+    }, [shop]);
+    // cart 自动追踪
+    React.useEffect(() => {
+        if (!trackCart || !cartCtx)
+            return;
+        return cartCtx.subscribe((c) => {
+            emit('cart_updated', {
+                cartId: c?.id,
+                totalQuantity: c?.totalQuantity,
+                totalAmount: c?.cost.totalAmount,
+            });
+        });
+    }, [trackCart, cartCtx, emit]);
+    return _jsx(Ctx.Provider, { value: { emit }, children: children });
+}
+export function useAnalytics() {
+    const v = React.useContext(Ctx);
+    if (!v) {
+        // 没 Provider 时返回 noop（不 throw，便于组件可选嵌入）
+        return { emit: () => { } };
+    }
+    return v;
+}
+// ============================================================
+// 声明式事件组件
+// ============================================================
+function useEmitOnMount(name, payload) {
+    const { emit } = useAnalytics();
+    const payloadRef = React.useRef(payload);
+    payloadRef.current = payload;
+    React.useEffect(() => {
+        emit(name, payloadRef.current);
+        // 只 mount 时触发一次（路由切换会重新 mount）
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    return null;
+}
+function PageView(props) {
+    return useEmitOnMount('page_view', props);
+}
+function ProductView(props) {
+    const { product, ...rest } = props;
+    return useEmitOnMount('product_view', {
+        ...rest,
+        productId: product.id,
+        productHandle: product.handle,
+        productTitle: product.title,
+    });
+}
+function CollectionView(props) {
+    const { collection, ...rest } = props;
+    return useEmitOnMount('collection_view', {
+        ...rest,
+        collectionId: collection.id,
+        collectionHandle: collection.handle,
+    });
+}
+function SearchView(props) {
+    return useEmitOnMount('search', { query: props.query, results: props.results });
+}
+function AddToCart(props) {
+    const { variantId, quantity, ...rest } = props;
+    return useEmitOnMount('add_to_cart', {
+        ...rest,
+        variantId,
+        quantity: quantity ?? 1,
+    });
+}
+function CheckoutStart(props) {
+    return useEmitOnMount('checkout_start', {
+        cartId: props.cart?.id,
+        totalQuantity: props.cart?.totalQuantity,
+    });
+}
+function Purchase(props) {
+    return useEmitOnMount('purchase', props);
+}
+/** 命名空间导出，让用户写 <Analytics.PageView /> */
+export const Analytics = {
+    PageView,
+    ProductView,
+    CollectionView,
+    SearchView,
+    AddToCart,
+    CheckoutStart,
+    Purchase,
+};
+//# sourceMappingURL=AnalyticsProvider.js.map

package/dist/components/AnalyticsProvider.js.map

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

package/dist/components/CartProvider.d.ts

@@ -0,0 +1,111 @@
+/**
+ * <CartProvider> + useCart()
+ *
+ * 接管 cart 全生命周期：
+ *   - 自动从 cookie 读取 cart_id 并 fetch
+ *   - 不存在则懒创建
+ *   - linesAdd / linesUpdate / linesRemove 全部带 optimistic update + 失败回滚
+ *   - subscribe(callback) 给外部（如 Analytics）订阅 cart 变化
+ *
+ * 用法：
+ *   <ShopProvider {...}>
+ *     <CartProvider>
+ *       <App />
+ *     </CartProvider>
+ *   </ShopProvider>
+ *
+ *   const { cart, status, linesAdd, linesUpdate, linesRemove } = useCart();
+ *
+ * 注意：必须套在 <ShopProvider> 内（依赖它的 storefrontAccessToken + apiUrl）。
+ */
+import * as React from 'react';
+export interface CartLineMerchandise {
+    id: string;
+    title?: string;
+    image?: {
+        url: string;
+        altText?: string | null;
+        width?: number | null;
+        height?: number | null;
+    };
+    price?: {
+        amount: string;
+        currencyCode: string;
+    };
+    product?: {
+        title: string;
+        handle: string;
+    };
+}
+export interface CartLine {
+    id: string;
+    quantity: number;
+    merchandise: CartLineMerchandise;
+    cost: {
+        totalAmount: {
+            amount: string;
+            currencyCode: string;
+        };
+    };
+}
+export interface Cart {
+    id: string;
+    totalQuantity: number;
+    checkoutUrl: string;
+    lines: {
+        nodes: CartLine[];
+    };
+    cost: {
+        subtotalAmount: {
+            amount: string;
+            currencyCode: string;
+        };
+        totalAmount: {
+            amount: string;
+            currencyCode: string;
+        };
+    };
+}
+export type CartStatus = 'uninitialized' | 'loading' | 'idle' | 'updating' | 'error';
+export interface CartUserError {
+    field?: string[] | null;
+    message: string;
+    code?: string;
+}
+export interface CartContextValue {
+    cart: Cart | null;
+    status: CartStatus;
+    error: string | null;
+    /** 加 line */
+    linesAdd: (lines: Array<{
+        merchandiseId: string;
+        quantity?: number;
+    }>) => Promise<void>;
+    /** 更新数量（lineId, quantity）；quantity<=0 等价 remove */
+    linesUpdate: (lines: Array<{
+        id: string;
+        quantity: number;
+    }>) => Promise<void>;
+    /** 删 line */
+    linesRemove: (lineIds: string[]) => Promise<void>;
+    /** 重新从服务端拉 cart */
+    refetch: () => Promise<void>;
+    /** 订阅 cart 变化（Analytics 用） */
+    subscribe: (listener: (cart: Cart | null) => void) => () => void;
+}
+export interface CartProviderProps {
+    children: React.ReactNode;
+    /** 加载完成后是否自动拉 cart。默认 true */
+    fetchOnMount?: boolean;
+}
+export declare function CartProvider({ children, fetchOnMount }: CartProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * 拿 cart context。Provider 外 throw。
+ */
+export declare function useCart(): CartContextValue;
+/**
+ * 非 throw 版本：Provider 外返回 null。
+ * 给可选 fallback 用，比如 <AddToCartButton> 在没 Provider 时退化到 props.onAdd。
+ */
+export declare function useCartOptional(): CartContextValue | null;
+//# sourceMappingURL=CartProvider.d.ts.map

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

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