@rovela-ai/sdk 0.4.1 → 0.4.2

package/dist/cart/components/CartSummary.js

@@ -0,0 +1,60 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * @rovela/sdk/cart/components/CartSummary
+ *
+ * Cart summary component showing subtotal and optional estimates.
+ */
+import { cn, formatPrice } from '../../core/utils';
+import { useStoreSettingsOptional } from '../../core/StoreSettingsProvider';
+import { useCart } from '../store';
+// =============================================================================
+// Component
+// =============================================================================
+/**
+ * CartSummary component for displaying cart totals.
+ *
+ * @example
+ * ```tsx
+ * import { CartSummary } from '@rovela/sdk/cart'
+ *
+ * function CartDrawer() {
+ *   return (
+ *     <div>
+ *       {// cart items...}
+ *       <CartSummary
+ *         showShipping
+ *         showTax
+ *         showTotal
+ *       />
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export function CartSummary({ showShipping = true, shippingCost = null, showTax = false, taxAmount = null, showTotal = true, currency, locale, className, compact = false, }) {
+    // Get currency from context if not provided via props
+    const storeSettings = useStoreSettingsOptional();
+    const resolvedCurrency = currency ?? storeSettings?.currency ?? 'USD';
+    const resolvedLocale = locale ?? storeSettings?.locale ?? 'en-US';
+    const subtotal = useCart((state) => {
+        // Calculate subtotal from items
+        return state.items.reduce((sum, item) => sum + item.price * item.quantity, 0);
+    });
+    // Calculate total if all values are known
+    const hasAllValues = shippingCost !== null && (taxAmount !== null || !showTax);
+    const total = hasAllValues
+        ? subtotal + (shippingCost || 0) + (taxAmount || 0)
+        : null;
+    const formatOptions = { currency: resolvedCurrency, locale: resolvedLocale };
+    return (_jsxs("div", { className: cn('space-y-2', className), children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: cn('text-muted-foreground', compact ? 'text-sm' : 'text-base'), children: "Subtotal" }), _jsx("span", { className: cn('font-medium text-foreground', compact ? 'text-sm' : 'text-base'), children: formatPrice(subtotal, formatOptions) })] }), showShipping && (_jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: cn('text-muted-foreground', compact ? 'text-sm' : 'text-base'), children: "Shipping" }), _jsx("span", { className: cn('text-muted-foreground', compact ? 'text-sm' : 'text-base'), children: shippingCost !== null
+                            ? shippingCost === 0
+                                ? 'Free'
+                                : formatPrice(shippingCost, formatOptions)
+                            : 'Calculated at checkout' })] })), showTax && (_jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: cn('text-muted-foreground', compact ? 'text-sm' : 'text-base'), children: "Tax" }), _jsx("span", { className: cn('text-muted-foreground', compact ? 'text-sm' : 'text-base'), children: taxAmount !== null
+                            ? formatPrice(taxAmount, formatOptions)
+                            : 'Calculated at checkout' })] })), showTotal && (_jsxs(_Fragment, { children: [_jsx("div", { className: "my-3 border-t border-border" }), _jsxs("div", { className: "flex items-center justify-between", children: [_jsx("span", { className: cn('font-medium text-foreground', compact ? 'text-base' : 'text-lg'), children: hasAllValues ? 'Total' : 'Estimated Total' }), _jsx("span", { className: cn('font-semibold text-foreground', compact ? 'text-base' : 'text-lg'), children: total !== null
+                                    ? formatPrice(total, formatOptions)
+                                    : formatPrice(subtotal, formatOptions) })] }), !hasAllValues && (_jsx("p", { className: "text-xs text-muted-foreground text-right", children: "Shipping and taxes calculated at checkout" }))] }))] }));
+}
+//# sourceMappingURL=CartSummary.js.map

package/dist/cart/components/CartSummary.js.map

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

package/dist/cart/components/QuantitySelector.d.ts

@@ -0,0 +1,39 @@
+export interface QuantitySelectorProps {
+    /** Current quantity value */
+    value: number;
+    /** Callback when quantity changes */
+    onChange: (value: number) => void;
+    /** Minimum allowed quantity */
+    min?: number;
+    /** Maximum allowed quantity */
+    max?: number;
+    /** Disable the selector */
+    disabled?: boolean;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Custom className */
+    className?: string;
+    /** Aria label for accessibility */
+    ariaLabel?: string;
+}
+/**
+ * QuantitySelector component for adjusting item quantities.
+ *
+ * @example
+ * ```tsx
+ * import { QuantitySelector } from '@rovela/sdk/cart'
+ *
+ * function CartItem({ item, onUpdate }) {
+ *   return (
+ *     <QuantitySelector
+ *       value={item.quantity}
+ *       onChange={onUpdate}
+ *       min={1}
+ *       max={99}
+ *     />
+ *   )
+ * }
+ * ```
+ */
+export declare function QuantitySelector({ value, onChange, min, max, disabled, size, className, ariaLabel, }: QuantitySelectorProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=QuantitySelector.d.ts.map

package/dist/cart/components/QuantitySelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuantitySelector.d.ts","sourceRoot":"","sources":["../../../src/cart/components/QuantitySelector.tsx"],"names":[],"mappings":"AAgBA,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,qCAAqC;IACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mBAAmB;IACnB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,QAAQ,EACR,GAAO,EACP,GAAQ,EACR,QAAgB,EAChB,IAAW,EACX,SAAS,EACT,SAAsB,GACvB,EAAE,qBAAqB,2CA+HvB"}

package/dist/cart/components/QuantitySelector.js

@@ -0,0 +1,85 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @rovela/sdk/cart/components/QuantitySelector
+ *
+ * Quantity selector component with +/- buttons.
+ */
+import { useCallback } from 'react';
+import { Minus, Plus } from 'lucide-react';
+import { cn } from '../../core/utils';
+// =============================================================================
+// Component
+// =============================================================================
+/**
+ * QuantitySelector component for adjusting item quantities.
+ *
+ * @example
+ * ```tsx
+ * import { QuantitySelector } from '@rovela/sdk/cart'
+ *
+ * function CartItem({ item, onUpdate }) {
+ *   return (
+ *     <QuantitySelector
+ *       value={item.quantity}
+ *       onChange={onUpdate}
+ *       min={1}
+ *       max={99}
+ *     />
+ *   )
+ * }
+ * ```
+ */
+export function QuantitySelector({ value, onChange, min = 1, max = 99, disabled = false, size = 'md', className, ariaLabel = 'Quantity', }) {
+    const handleDecrement = useCallback(() => {
+        if (value > min && !disabled) {
+            onChange(value - 1);
+        }
+    }, [value, min, disabled, onChange]);
+    const handleIncrement = useCallback(() => {
+        if (value < max && !disabled) {
+            onChange(value + 1);
+        }
+    }, [value, max, disabled, onChange]);
+    const handleInputChange = useCallback((e) => {
+        const newValue = parseInt(e.target.value, 10);
+        if (!isNaN(newValue)) {
+            onChange(Math.max(min, Math.min(max, newValue)));
+        }
+    }, [min, max, onChange]);
+    const handleKeyDown = useCallback((e) => {
+        if (e.key === 'ArrowUp') {
+            e.preventDefault();
+            handleIncrement();
+        }
+        else if (e.key === 'ArrowDown') {
+            e.preventDefault();
+            handleDecrement();
+        }
+    }, [handleIncrement, handleDecrement]);
+    const sizeClasses = {
+        sm: {
+            container: 'h-8',
+            button: 'w-8 h-8',
+            input: 'w-10 text-sm',
+            icon: 'h-3 w-3',
+        },
+        md: {
+            container: 'h-10',
+            button: 'w-10 h-10',
+            input: 'w-12 text-sm',
+            icon: 'h-4 w-4',
+        },
+        lg: {
+            container: 'h-12',
+            button: 'w-12 h-12',
+            input: 'w-14 text-base',
+            icon: 'h-5 w-5',
+        },
+    };
+    const classes = sizeClasses[size];
+    const isAtMin = value <= min;
+    const isAtMax = value >= max;
+    return (_jsxs("div", { className: cn('inline-flex items-center rounded-md border border-border', disabled && 'opacity-50', className), role: "group", "aria-label": ariaLabel, children: [_jsx("button", { type: "button", onClick: handleDecrement, disabled: disabled || isAtMin, className: cn('flex items-center justify-center text-muted-foreground transition-colors', 'hover:text-foreground hover:bg-muted', 'disabled:cursor-not-allowed disabled:opacity-50 disabled:hover:bg-transparent', 'focus:outline-none focus-visible:ring-2 focus-visible:ring-primary focus-visible:ring-inset', 'rounded-l-md', classes.button), "aria-label": "Decrease quantity", children: _jsx(Minus, { className: classes.icon }) }), _jsx("input", { type: "number", value: value, onChange: handleInputChange, onKeyDown: handleKeyDown, disabled: disabled, min: min, max: max, className: cn('border-x border-border bg-transparent text-center focus:outline-none', 'disabled:cursor-not-allowed', '[appearance:textfield] [&::-webkit-inner-spin-button]:appearance-none [&::-webkit-outer-spin-button]:appearance-none', classes.container, classes.input), "aria-label": ariaLabel }), _jsx("button", { type: "button", onClick: handleIncrement, disabled: disabled || isAtMax, className: cn('flex items-center justify-center text-muted-foreground transition-colors', 'hover:text-foreground hover:bg-muted', 'disabled:cursor-not-allowed disabled:opacity-50 disabled:hover:bg-transparent', 'focus:outline-none focus-visible:ring-2 focus-visible:ring-primary focus-visible:ring-inset', 'rounded-r-md', classes.button), "aria-label": "Increase quantity", children: _jsx(Plus, { className: classes.icon }) })] }));
+}
+//# sourceMappingURL=QuantitySelector.js.map

package/dist/cart/components/QuantitySelector.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * @rovela/sdk/cart/components
+ *
+ * Cart UI components
+ */
+export { CartDrawer } from './CartDrawer';
+export type { CartDrawerProps } from './CartDrawer';
+export { CartItem } from './CartItem';
+export type { CartItemProps } from './CartItem';
+export { CartSummary } from './CartSummary';
+export type { CartSummaryProps } from './CartSummary';
+export { CartIcon } from './CartIcon';
+export type { CartIconProps } from './CartIcon';
+export { AddToCartButton } from './AddToCartButton';
+export type { AddToCartButtonProps } from './AddToCartButton';
+export { QuantitySelector } from './QuantitySelector';
+export type { QuantitySelectorProps } from './QuantitySelector';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cart/components/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/cart/components/index.js

@@ -0,0 +1,12 @@
+/**
+ * @rovela/sdk/cart/components
+ *
+ * Cart UI components
+ */
+export { CartDrawer } from './CartDrawer';
+export { CartItem } from './CartItem';
+export { CartSummary } from './CartSummary';
+export { CartIcon } from './CartIcon';
+export { AddToCartButton } from './AddToCartButton';
+export { QuantitySelector } from './QuantitySelector';
+//# sourceMappingURL=index.js.map

package/dist/cart/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cart/components/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAGzC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGrC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAG3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGrC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAGnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/cart/index.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @rovela/sdk/cart
+ *
+ * Shopping cart module: Zustand state management with localStorage persistence.
+ *
+ * Store:
+ * - useCart: Zustand store with all cart operations
+ *
+ * Components:
+ * - CartDrawer: Slide-out cart panel
+ * - CartItem: Individual cart line item
+ * - CartSummary: Subtotal and totals display
+ * - CartIcon: Header icon with item count badge
+ * - AddToCartButton: Button with feedback animations
+ * - QuantitySelector: +/- quantity control
+ *
+ * Provider:
+ * - CartProvider: SSR-safe hydration wrapper
+ *
+ * @example
+ * ```tsx
+ * // In app/layout.tsx
+ * import { CartProvider, CartDrawer } from '@rovela/sdk/cart'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <CartProvider>
+ *           {children}
+ *           <CartDrawer />
+ *         </CartProvider>
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // In header component
+ * import { CartIcon } from '@rovela/sdk/cart'
+ *
+ * function Header() {
+ *   return (
+ *     <header>
+ *       <nav>
+ *         <CartIcon showCount />
+ *       </nav>
+ *     </header>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // In product page
+ * import { AddToCartButton, useCart } from '@rovela/sdk/cart'
+ *
+ * function ProductPage({ product, selectedVariant }) {
+ *   return (
+ *     <div>
+ *       <h1>{product.name}</h1>
+ *       <AddToCartButton
+ *         product={product}
+ *         variant={selectedVariant}
+ *         showFeedback
+ *         openCartAfterAdd
+ *       />
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Direct store access
+ * import { useCart } from '@rovela/sdk/cart'
+ *
+ * function CartManager() {
+ *   const {
+ *     items,
+ *     itemCount,
+ *     subtotal,
+ *     addItem,
+ *     removeItem,
+ *     updateQuantity,
+ *     clearCart,
+ *     openCart,
+ *     closeCart,
+ *   } = useCart()
+ *
+ *   return (
+ *     <div>
+ *       <p>Items: {itemCount}</p>
+ *       <p>Subtotal: ${subtotal.toFixed(2)}</p>
+ *       <button onClick={clearCart}>Clear Cart</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export { useCart, hydrateCart, isCartHydrated, getCartItemsWithFallback } from './store';
+export type { CartState, CartActions, CartGetters, CartStore } from './store';
+export { CartProvider, useCartHydrated } from './CartProvider';
+export type { CartProviderProps } from './CartProvider';
+export { CartDrawer, CartItem, CartSummary, CartIcon, AddToCartButton, QuantitySelector, } from './components';
+export type { CartDrawerProps, CartItemProps, CartSummaryProps, CartIconProps, AddToCartButtonProps, QuantitySelectorProps, } from './components';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cart/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqGG;AAMH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AACxF,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAM7E,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC9D,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAMvD,OAAO,EACL,UAAU,EACV,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAA;AAErB,YAAY,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,cAAc,CAAA"}

package/dist/cart/index.js

@@ -0,0 +1,115 @@
+/**
+ * @rovela/sdk/cart
+ *
+ * Shopping cart module: Zustand state management with localStorage persistence.
+ *
+ * Store:
+ * - useCart: Zustand store with all cart operations
+ *
+ * Components:
+ * - CartDrawer: Slide-out cart panel
+ * - CartItem: Individual cart line item
+ * - CartSummary: Subtotal and totals display
+ * - CartIcon: Header icon with item count badge
+ * - AddToCartButton: Button with feedback animations
+ * - QuantitySelector: +/- quantity control
+ *
+ * Provider:
+ * - CartProvider: SSR-safe hydration wrapper
+ *
+ * @example
+ * ```tsx
+ * // In app/layout.tsx
+ * import { CartProvider, CartDrawer } from '@rovela/sdk/cart'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <CartProvider>
+ *           {children}
+ *           <CartDrawer />
+ *         </CartProvider>
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // In header component
+ * import { CartIcon } from '@rovela/sdk/cart'
+ *
+ * function Header() {
+ *   return (
+ *     <header>
+ *       <nav>
+ *         <CartIcon showCount />
+ *       </nav>
+ *     </header>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // In product page
+ * import { AddToCartButton, useCart } from '@rovela/sdk/cart'
+ *
+ * function ProductPage({ product, selectedVariant }) {
+ *   return (
+ *     <div>
+ *       <h1>{product.name}</h1>
+ *       <AddToCartButton
+ *         product={product}
+ *         variant={selectedVariant}
+ *         showFeedback
+ *         openCartAfterAdd
+ *       />
+ *     </div>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Direct store access
+ * import { useCart } from '@rovela/sdk/cart'
+ *
+ * function CartManager() {
+ *   const {
+ *     items,
+ *     itemCount,
+ *     subtotal,
+ *     addItem,
+ *     removeItem,
+ *     updateQuantity,
+ *     clearCart,
+ *     openCart,
+ *     closeCart,
+ *   } = useCart()
+ *
+ *   return (
+ *     <div>
+ *       <p>Items: {itemCount}</p>
+ *       <p>Subtotal: ${subtotal.toFixed(2)}</p>
+ *       <button onClick={clearCart}>Clear Cart</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+// =============================================================================
+// Store
+// =============================================================================
+export { useCart, hydrateCart, isCartHydrated, getCartItemsWithFallback } from './store';
+// =============================================================================
+// Provider
+// =============================================================================
+export { CartProvider, useCartHydrated } from './CartProvider';
+// =============================================================================
+// Components
+// =============================================================================
+export { CartDrawer, CartItem, CartSummary, CartIcon, AddToCartButton, QuantitySelector, } from './components';
+//# sourceMappingURL=index.js.map

package/dist/cart/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cart/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqGG;AAEH,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAGxF,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAG9D,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,OAAO,EACL,UAAU,EACV,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAA"}

package/dist/cart/store.d.ts

@@ -0,0 +1,150 @@
+/**
+ * @rovela/sdk/cart/store
+ *
+ * Zustand cart store with localStorage persistence.
+ * Client-side only - no database, no API calls.
+ */
+import type { Product, ProductVariant, CartItem } from '../core/types';
+export interface CartState {
+    /** Items in the cart */
+    items: CartItem[];
+    /**
+     * Cart-level metadata (string keys → string values).
+     *
+     * Persisted with the cart and forwarded to Stripe Checkout Session
+     * `payment_intent_data.metadata` at checkout time. Used by feature cards
+     * that need to attach data to an order without modifying the line items
+     * (e.g. Q15 order notes / gift message).
+     *
+     * Hard caps (enforced by `setMetadata`):
+     *   - max 10 keys
+     *   - max 200 chars per value
+     *
+     * Stripe Checkout Session metadata accepts up to 50 keys / 500 chars; we
+     * set tighter caps here to leave headroom for Stripe-side additions.
+     */
+    metadata: Record<string, string>;
+    /** Whether the cart drawer is open */
+    isOpen: boolean;
+}
+export interface CartActions {
+    /**
+     * Add an item to the cart.
+     * If the same product+variant exists, quantity is incremented.
+     */
+    addItem: (product: Product, variant?: ProductVariant | null, quantity?: number) => void;
+    /**
+     * Update the quantity of an item in the cart.
+     * If quantity is 0 or less, the item is removed.
+     */
+    updateQuantity: (itemId: string, quantity: number) => void;
+    /** Remove an item from the cart */
+    removeItem: (itemId: string) => void;
+    /** Clear all items from the cart */
+    clearCart: () => void;
+    /** Open the cart drawer */
+    openCart: () => void;
+    /** Close the cart drawer */
+    closeCart: () => void;
+    /** Toggle the cart drawer */
+    toggleCart: () => void;
+    /**
+     * Set a single metadata key. Throws if the key cap (10) or value length
+     * cap (200 chars) is exceeded. `value` must be a string — non-string
+     * values must be JSON-stringified by the caller (Stripe metadata is
+     * string-valued).
+     */
+    setMetadata: (key: string, value: string) => void;
+    /** Remove a single metadata key. */
+    removeMetadata: (key: string) => void;
+    /** Clear all metadata. Items are NOT touched. */
+    clearMetadata: () => void;
+}
+export interface CartGetters {
+    /** Total number of items in the cart */
+    readonly itemCount: number;
+    /** Subtotal of all items (price * quantity) */
+    readonly subtotal: number;
+    /** Get an item by product ID and optional variant ID */
+    getItem: (productId: string, variantId?: string) => CartItem | undefined;
+    /** Check if a product is in the cart */
+    hasItem: (productId: string, variantId?: string) => boolean;
+}
+export type CartStore = CartState & CartActions & CartGetters;
+/**
+ * Cart store with localStorage persistence.
+ *
+ * @example
+ * ```tsx
+ * import { useCart } from '@rovela/sdk/cart'
+ *
+ * function CartButton() {
+ *   const { itemCount, openCart } = useCart()
+ *   return (
+ *     <button onClick={openCart}>
+ *       Cart ({itemCount})
+ *     </button>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * import { useCart } from '@rovela/sdk/cart'
+ *
+ * function ProductPage({ product, variant }) {
+ *   const { addItem } = useCart()
+ *
+ *   const handleAddToCart = () => {
+ *     addItem(product, variant, 1)
+ *   }
+ *
+ *   return <button onClick={handleAddToCart}>Add to Cart</button>
+ * }
+ * ```
+ */
+export declare const useCart: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<CartStore>, "setState" | "persist"> & {
+    setState(partial: CartStore | Partial<CartStore> | ((state: CartStore) => CartStore | Partial<CartStore>), replace?: false | undefined): unknown;
+    setState(state: CartStore | ((state: CartStore) => CartStore), replace: true): unknown;
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<CartStore, unknown, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: CartStore) => void) => () => void;
+        onFinishHydration: (fn: (state: CartStore) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<CartStore, unknown, unknown>>;
+    };
+}>;
+/**
+ * Manually trigger hydration from localStorage.
+ * Call this in CartProvider's useEffect.
+ */
+export declare function hydrateCart(): void;
+/**
+ * Check if the cart has been hydrated.
+ */
+export declare function isCartHydrated(): boolean;
+/**
+ * Get cart items with lazy hydration fallback.
+ *
+ * This function handles webpack module duplication issues in Next.js where
+ * different route chunks may get separate instances of the useCart store.
+ * When CartProvider hydrates one instance, other instances remain empty.
+ *
+ * This helper reads directly from localStorage if the store instance is empty,
+ * ensuring reliable cart data regardless of which module instance is used.
+ *
+ * @example
+ * ```tsx
+ * import { getCartItemsWithFallback } from '@rovela-ai/sdk/cart'
+ *
+ * function CartPage() {
+ *   const items = getCartItemsWithFallback()
+ *   const itemCount = items.reduce((sum, item) => sum + item.quantity, 0)
+ *   // ...
+ * }
+ * ```
+ */
+export declare function getCartItemsWithFallback(): CartItem[];
+//# sourceMappingURL=store.d.ts.map

package/dist/cart/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/cart/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAoBtE,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,sCAAsC;IACtC,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,EAAE,CACP,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,EAC/B,QAAQ,CAAC,EAAE,MAAM,KACd,IAAI,CAAA;IAET;;;OAGG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IAE1D,mCAAmC;IACnC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAEpC,oCAAoC;IACpC,SAAS,EAAE,MAAM,IAAI,CAAA;IAErB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,IAAI,CAAA;IAEpB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,IAAI,CAAA;IAErB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,IAAI,CAAA;IAEtB;;;;;OAKG;IACH,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAEjD,oCAAoC;IACpC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,iDAAiD;IACjD,aAAa,EAAE,MAAM,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAE1B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IAEzB,wDAAwD;IACxD,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAA;IAExE,wCAAwC;IACxC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;CAC5D;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAA;AA+C7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;EAoLnB,CAAA;AAMD;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,IAAI,QAAQ,EAAE,CAiCrD"}