@liquidcommerce/elements-sdk 2.6.0-beta.37 → 2.6.0-beta.39

package/docs/{THEMING.md → theming.md}

@@ -180,6 +180,7 @@ interface IProductComponent {
   };
   layout: {
     showImages: boolean;
+    showOnlyMainImage: boolean;
     showTitle: boolean;
     showDescription: boolean;
     showQuantityCounter: boolean;
@@ -192,6 +193,8 @@ interface IProductComponent {
     addToCartButtonShowTotalPrice: boolean;
     buyNowButtonText: string;
     preSaleButtonText: string;
+    prioritizeEngraving: boolean;
+    noAvailabilityText: string;
   };
 }
 ```
@@ -205,6 +208,7 @@ customTheme: {
     },
     layout: {
       showImages: true,
+      showOnlyMainImage: false,
       showTitle: true,
       showDescription: true,
       showQuantityCounter: true,
@@ -216,7 +220,9 @@ customTheme: {
       addToCartButtonText: 'Add to Cart',
       addToCartButtonShowTotalPrice: true,
       buyNowButtonText: 'Buy Now',
-      preSaleButtonText: 'Pre-Order'
+      preSaleButtonText: 'Pre-Order',
+      prioritizeEngraving: false,
+      noAvailabilityText: 'Not available in your area'
     }
   }
 }
@@ -261,10 +267,6 @@ customTheme: {
 interface ICheckoutComponent {
   theme: {
     backgroundColor: string;
-    checkoutCompleted: {
-      customLogo: string;
-      customText: string | null;
-    };
   };
   layout: {
     emailOptIn: {
@@ -282,10 +284,15 @@ interface ICheckoutComponent {
       show: boolean;
       text: string;
     };
+    continueShoppingUrl: string;
     exitUrl: string;
     thankYouButtonText: string;
     drawerHeaderText: string;
     placeOrderButtonText: string;
+    checkoutCompleted: {
+      customLogo: string;
+      customText: string | null;
+    };
   };
 }
 ```
@@ -295,11 +302,7 @@ interface ICheckoutComponent {
 customTheme: {
   checkout: {
     theme: {
-      backgroundColor: '#ffffff',
-      checkoutCompleted: {
-        customLogo: 'https://yourdomain.com/logo.png',
-        customText: 'Thank you for your order!'
-      }
+      backgroundColor: '#ffffff'
     },
     layout: {
       emailOptIn: {
@@ -317,15 +320,26 @@ customTheme: {
         show: true,
         text: 'By placing this order, you agree to our terms and conditions.'
       },
+      continueShoppingUrl: '/',
       exitUrl: '/',
       thankYouButtonText: 'Continue Shopping',
       drawerHeaderText: 'Checkout',
-      placeOrderButtonText: 'Place Order'
+      placeOrderButtonText: 'Place Order',
+      checkoutCompleted: {
+        customLogo: 'https://yourdomain.com/logo.png',
+        customText: 'Thank you for your order!'
+      }
     }
   }
 }
 ```
 
+**Layout Properties:**
+
+- **`continueShoppingUrl`** (string): URL to redirect to when customer clicks "Continue Shopping" after order completion
+- **`exitUrl`** (string): URL for the exit/close action in checkout
+- **`legalMessage.text`** (string): Supports rich text / HTML content
+
 ## Address Component
 
 ```typescript
@@ -347,6 +361,77 @@ customTheme: {
 }
 ```
 
+## Product List Component
+
+```typescript
+interface IProductListComponent {
+  theme: {
+    backgroundColor: string;
+  };
+  layout: {
+    productCard: {
+      style: 'card' | 'ghost';
+      cornerRadius: 'rounded' | 'sharp';
+      showPrice: boolean;
+      showSizeSelector: boolean;
+      showFulfillment: boolean;
+      showRetailerName: boolean;
+      showQuantityCounter: boolean;
+      enableShippingFulfillment: boolean;
+      enableOnDemandFulfillment: boolean;
+      showCollections: boolean;
+      enablePersonalization: boolean;
+    };
+    displayMode: 'modal' | 'drawer';
+  };
+}
+```
+
+**Example:**
+```javascript
+customTheme: {
+  productList: {
+    theme: {
+      backgroundColor: '#f8f9fa'
+    },
+    layout: {
+      productCard: {
+        style: 'card',
+        cornerRadius: 'rounded',
+        showPrice: true,
+        showSizeSelector: true,
+        showFulfillment: true,
+        showRetailerName: false,
+        showQuantityCounter: true,
+        enableShippingFulfillment: true,
+        enableOnDemandFulfillment: true,
+        showCollections: false,
+        enablePersonalization: true
+      },
+      displayMode: 'drawer'
+    }
+  }
+}
+```
+
+**Card Style Options:**
+
+- **`style`**: `'card'` shows a bordered card with background, `'ghost'` shows a minimal borderless card
+- **`cornerRadius`**: `'rounded'` uses rounded corners, `'sharp'` uses square corners
+- **`displayMode`**: `'modal'` opens product details in a modal, `'drawer'` opens in a side drawer
+
+**Card Feature Flags:**
+
+- **`showPrice`**: Display price on the product card
+- **`showSizeSelector`**: Show size/variant selector on the card
+- **`showFulfillment`**: Show fulfillment type indicator
+- **`showRetailerName`**: Show the retailer name
+- **`showQuantityCounter`**: Show quantity increment/decrement controls
+- **`enableShippingFulfillment`**: Allow shipping fulfillment option
+- **`enableOnDemandFulfillment`**: Allow on-demand fulfillment option
+- **`showCollections`**: Show product collection/tag labels
+- **`enablePersonalization`**: Show personalization/engraving option on cards
+
 ## Complete Configuration Example
 
 ```javascript
@@ -390,6 +475,7 @@ const client = await Elements('YOUR_API_KEY', {
       },
       layout: {
         showImages: true,
+        showOnlyMainImage: false,
         showTitle: true,
         showDescription: true,
         showQuantityCounter: true,
@@ -401,7 +487,9 @@ const client = await Elements('YOUR_API_KEY', {
         addToCartButtonText: 'Add to Cart',
         addToCartButtonShowTotalPrice: true,
         buyNowButtonText: 'Buy Now',
-        preSaleButtonText: 'Pre-Order'
+        preSaleButtonText: 'Pre-Order',
+        prioritizeEngraving: false,
+        noAvailabilityText: 'Not available in your area'
       }
     },
     cart: {
@@ -417,11 +505,7 @@ const client = await Elements('YOUR_API_KEY', {
     },
     checkout: {
       theme: {
-        backgroundColor: '#ffffff',
-        checkoutCompleted: {
-          customLogo: 'https://yourdomain.com/logo.png',
-          customText: null
-        }
+        backgroundColor: '#ffffff'
       },
       layout: {
         emailOptIn: {
@@ -439,10 +523,15 @@ const client = await Elements('YOUR_API_KEY', {
           show: false,
           text: ''
         },
+        continueShoppingUrl: '/',
         exitUrl: '/',
         thankYouButtonText: 'Continue Shopping',
         drawerHeaderText: 'Checkout',
-        placeOrderButtonText: 'Place Order'
+        placeOrderButtonText: 'Place Order',
+        checkoutCompleted: {
+          customLogo: 'https://yourdomain.com/logo.png',
+          customText: null
+        }
       }
     },
     address: {
@@ -588,5 +677,6 @@ customTheme: {
 
 ## Related Documentation
 
-- [Configuration Reference](./CONFIGURATION.md) - All SDK configuration options
-- [Troubleshooting Guide](./TROUBLESHOOTING.md) - Common theming issues
+- [Troubleshooting Guide](./troubleshooting.md) - Common theming issues
+- [Actions Reference](./actions.md) - Programmatic control
+- [Events Reference](./events.md) - Event system

package/docs/{TROUBLESHOOTING.md → troubleshooting.md}

@@ -54,7 +54,7 @@ Cart items have location-specific pricing, availability, and fulfillment options
 
 #### 3. Ad Blockers
 
-**Solution:** Configure a [proxy](./PROXY.md) to route requests through your domain.
+**Solution:** Configure a [proxy](./proxy.md) to route requests through your domain.
 
 ### Authentication Failures
 
@@ -785,9 +785,9 @@ If you're still experiencing issues:
 
 ## Related Documentation
 
-- [Configuration Reference](./CONFIGURATION.md) - Configuration options
-- [Actions Reference](./ACTIONS.md) - Programmatic control
-- [Events Reference](./EVENTS.md) - Event system
-- [Browser Support](./BROWSER_SUPPORT.md) - Browser compatibility
-- [Proxy Setup](./PROXY.md) - Proxy configuration
+- [Actions Reference](./actions.md) - Programmatic control
+- [Events Reference](./events.md) - Event system
+- [Browser Support](./browser-support.md) - Browser compatibility
+- [Proxy Setup](./proxy.md) - Proxy configuration
+- [Theming](./theming.md) - Customization options
 

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiquidCommerce Elements SDK",
   "license": "UNLICENSED",
   "author": "LiquidCommerce Team",
-  "version": "2.6.0-beta.37",
+  "version": "2.6.0-beta.39",
   "homepage": "https://docs.liquidcommerce.co/elements-sdk",
   "repository": {
     "type": "git",