@liquidcommerce/elements-sdk 2.5.0 → 2.5.2-beta.1

package/docs/CONFIGURATION.md

@@ -494,6 +494,100 @@ data-product-2="00832889005513"
 <div data-lce-product="00832889005513"></div>
 ```
 
+### Product List Configuration
+
+```html
+<div data-liquid-commerce-elements-products-list
+     data-card="standard"
+     data-rows="3"
+     data-columns="4"
+     data-card-fill
+     data-filters="personalization,pre-order,delivery-options"
+     data-product-url="/product/{upc}">
+</div>
+```
+
+**Attributes:**
+
+##### `data-liquid-commerce-elements-products-list`
+
+**Type:** flag (no value)
+
+Enables product list on this div element.
+
+##### `data-card`
+
+**Type:** `'standard'`  
+**Default:** `'standard'`
+
+Card variant style.
+
+```html
+data-card="standard"
+```
+
+##### `data-rows`
+
+**Type:** `number`  
+**Default:** `3`
+
+Number of rows to display per page.
+
+```html
+data-rows="4"
+```
+
+##### `data-columns`
+
+**Type:** `number`  
+**Default:** `4`
+
+Number of columns in the grid.
+
+```html
+data-columns="4"
+```
+
+##### `data-card-fill`
+
+**Type:** flag (no value)
+
+Whether cards should fill the whole card with white background color to match the image background color.
+
+```html
+data-card-fill
+```
+
+##### `data-filters`
+
+**Type:** `string` (comma-separated)
+
+Filter types to enable: `personalization`, `pre-order`, `delivery-options`.
+
+```html
+data-filters="personalization,pre-order,delivery-options"
+```
+
+**Available filters:**
+- `personalization` - Show filter for personalized/engravable products
+- `pre-order` - Show filter for pre-order products
+- `delivery-options` - Show filter for delivery type (all, shipping, onDemand)
+
+##### `data-product-url`
+
+**Type:** `string`
+
+Product detail page URL template. Use `{upc}` or `{grouping}` placeholder.
+
+```html
+data-product-url="/product/{upc}"
+data-product-url="/products/{grouping}"
+```
+
+**Placeholders:**
+- `{upc}` - Replaced with product UPC
+- `{grouping}` - Replaced with Salsify grouping ID
+
 ### URL Parameter Configuration
 
 #### `data-product-param`

package/docs/DOCUMENTATION_INDEX.md

@@ -237,6 +237,7 @@ docs/
 
 ### Features
 - [Product Engraving](../README.md#product-engraving)
+- [Product List](../README.md#product-list)
 - [Gift Options](../README.md#gift-options)
 - [Promo Codes](../README.md#promo-codes)
 - [Gift Cards](../README.md#gift-cards)

package/package.json

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