@shopbb/helium 0.2.0 → 0.3.0-alpha.2

package/src/components/index.ts

@@ -0,0 +1,71 @@
+/**
+ * @shopbb/helium/components — 商家用 React 组件
+ *
+ * 用法：
+ *   import {
+ *     ShopProvider, CartProvider, AnalyticsProvider,
+ *     useShop, useCart, useAnalytics,
+ *     Money, Image, ProductPrice,
+ *     AddToCartButton, CartLineQuantityAdjustButton,
+ *     VariantSelector, ProductOptionsProvider, useProductOptions,
+ *     Analytics,
+ *   } from '@shopbb/helium/components';
+ *
+ * 设计原则：
+ *   - 无样式：组件只管行为 + 语义化 DOM，样式商家自己写
+ *   - data-* 钩子：方便选择器
+ *   - 对齐 Shopify Hydrogen 同名组件的 API，迁移成本低
+ *   - Provider 链：<ShopProvider> > <CartProvider> > <AnalyticsProvider> > App
+ *     组件优先从 Provider 拿；Provider 缺省时回退到 props 或 noop
+ */
+
+// Providers + hooks
+export { ShopProvider, useShop, useShopOptional } from './ShopProvider';
+export type { ShopContextValue, ShopProviderProps } from './ShopProvider';
+
+export { CartProvider, useCart, useCartOptional } from './CartProvider';
+export type {
+  Cart,
+  CartLine,
+  CartLineMerchandise,
+  CartStatus,
+  CartUserError,
+  CartContextValue,
+  CartProviderProps,
+} from './CartProvider';
+
+export {
+  ProductOptionsProvider,
+  useProductOptions,
+} from './ProductOptionsProvider';
+export type {
+  ProductOptionsContextValue,
+  ProductOptionsProviderProps,
+  ProductOptionItem,
+} from './ProductOptionsProvider';
+
+export { AnalyticsProvider, useAnalytics, Analytics } from './AnalyticsProvider';
+export type { AnalyticsEvent, AnalyticsContextValue, AnalyticsProviderProps } from './AnalyticsProvider';
+
+// 展示型组件
+export { Money } from './Money';
+export type { MoneyProps, MoneyData, MoneyMeasurement } from './Money';
+
+export { Image } from './Image';
+export type { ImageProps, ImageData } from './Image';
+
+export { ProductPrice } from './ProductPrice';
+export type { ProductPriceProps } from './ProductPrice';
+
+export { AddToCartButton } from './AddToCartButton';
+export type { AddToCartButtonProps } from './AddToCartButton';
+
+export { CartLineQuantityAdjustButton } from './CartLineQuantityAdjustButton';
+export type { CartLineQuantityAdjustButtonProps } from './CartLineQuantityAdjustButton';
+
+export { VariantSelector } from './VariantSelector';
+export type {
+  VariantSelectorProps,
+  VariantSelectorRenderProps,
+  VariantOption,
+} from './VariantSelector';