@liquidcommerce/elements-sdk 2.4.4 → 2.5.0

package/dist/types/modules/product-list/product-list.component.d.ts

@@ -0,0 +1,76 @@
+import { BaseComponent, type IOnStoreChanged } from '@/core/base-component.service';
+import type { ProductListCardVariantType, ProductListFilterType } from '@/interfaces/core.interface';
+export interface IProductListComponentParams {
+    cardVariant: ProductListCardVariantType;
+    rows: number;
+    columns: number;
+    fillCard: boolean;
+    filters: ProductListFilterType[];
+    productUrl?: string;
+}
+export interface IProductListFilters {
+    personalized: boolean;
+    preOrder: boolean;
+    deliveryOptions: 'all' | 'shipping' | 'onDemand';
+}
+export declare class ProductListComponent extends BaseComponent<IProductListComponentParams> {
+    private products;
+    private retailers;
+    private pagination;
+    private currentFilters;
+    private cardsContainer;
+    private filtersContainer;
+    private sentinelElement;
+    private personalizedSwitch;
+    private preOrderSwitch;
+    private deliveryRadios;
+    private deliveryRadioLabels;
+    private loadingState;
+    private scrollObserver;
+    private initializationPromise;
+    get hostClasses(): string[];
+    constructor();
+    protected connected(): Promise<void>;
+    disconnectedCallback(): void;
+    private initializeComponent;
+    protected template(): HTMLElement[];
+    private setLoadingState;
+    private renderCurrentState;
+    private loadInitialProducts;
+    private loadMoreProducts;
+    private mergeRetailers;
+    private updatePagination;
+    private buildApiParams;
+    private buildFiltersFromState;
+    private syncFiltersFromResponse;
+    private onFilterChange;
+    private resetPagination;
+    private updateFiltersUI;
+    private updatePersonalizedSwitch;
+    private updatePreOrderSwitch;
+    private updateDeliveryOptions;
+    private updateRadioLabel;
+    private isPersonalizationDisabled;
+    private isPreOrderDisabled;
+    private isSameDayDeliveryDisabled;
+    private createCardsContainer;
+    private renderLoadingState;
+    private renderProducts;
+    private appendNewProducts;
+    private createProductCard;
+    private createFiltersContainer;
+    private storeFilterElementReferences;
+    private setupInfiniteScroll;
+    private createScrollSentinel;
+    private updateSentinel;
+    private updateSentinelContent;
+    private showSentinelError;
+    private createLoadingElement;
+    private createErrorElement;
+    private createInfoElement;
+    private showErrorState;
+    private clearCardsContainer;
+    private cleanupScrollObserver;
+    onStoreWatch(changes: IOnStoreChanged[]): Promise<void>;
+    private doCleanup;
+}

package/dist/types/modules/theme-provider/constants/component-groupings.d.ts

@@ -1,7 +1,5 @@
 import { type ComponentType } from '@/enums';
-export declare const mainComponents: ComponentType[];
 export declare const productGroupComponents: ComponentType[];
 export declare const addressGroupComponents: ComponentType[];
 export declare const cartGroupComponents: ComponentType[];
 export declare const checkoutGroupComponents: ComponentType[];
-export declare const isMainComponent: (componentType: ComponentType) => boolean;

package/dist/types/modules/theme-provider/styles/product-list/index.d.ts

@@ -0,0 +1 @@
+export * from './product-list.style';

package/dist/types/modules/theme-provider/styles/product-list/product-list.style.d.ts

@@ -0,0 +1 @@
+export declare const getProductListStyles: () => string;

package/dist/types/modules/theme-provider/styles/ui/loading.style.d.ts

@@ -1 +1,2 @@
 export declare const getProductLoadingStyles: () => string;
+export declare const getProductListCardLoadingStyles: () => string;

package/dist/types/modules/ui-components/alert/alert.component.d.ts

@@ -1,5 +1,5 @@
 import { BaseComponent, type IOnStoreChanged } from '@/core/base-component.service';
-import type { StorePaths } from '@/core/store';
+import type { StorePaths } from '@/core/store/interfaces/core.interface';
 export interface IAlertComponentParams {
     errorStorePath: StorePaths;
     fromEvents?: boolean;

package/dist/types/modules/ui-components/purchase-min-alert/helpers.d.ts

@@ -1,4 +1,4 @@
-import type { IRetailerFulfillmentStore } from '@/core/store';
+import type { IRetailerFulfillmentStore } from '@/core/store/interfaces/cart.interface';
 export declare const shouldShowMinimumPurchaseAlert: (fulfillment: IRetailerFulfillmentStore, isPack?: boolean) => boolean;
 export declare const getMinimumPurchaseMessage: (fulfillment: IRetailerFulfillmentStore, isPack?: boolean) => {
     message: string;

package/dist/types/modules/ui-components/ui.commands.d.ts

@@ -1,5 +1,5 @@
 import { BaseCommand } from '@/core/command/base-command.service';
-import type { IDrawerContentConfig } from '@/core/store';
+import type { IDrawerContentConfig } from '@/core/store/interfaces/core.interface';
 export declare class UICommands extends BaseCommand {
     static getInstance(): UICommands;
     openDrawer(contentType: IDrawerContentConfig['type'], data?: Record<string, any>): void;

package/docs/ACTIONS.md

@@ -212,6 +212,33 @@ if (address) {
 actions.address.clear();
 ```
 
+**Complete Reset Behavior:**
+The `actions.address.clear()` action performs a comprehensive reset of the user's address and shopping session:
+
+**What gets cleared:**
+- ✅ **Address Data**: All saved address information (street, city, state, zip, coordinates, Places ID)
+- ✅ **Cart Contents**: Complete cart reset (removes all items, totals, promo codes, retailers)
+- ✅ **Local Storage**: Completely removes the localStorage entry and its value
+- ✅ **Database**: Deletes the persisted store from the server database
+- ✅ **Checkout State**: Resets any pending checkout information
+
+**Why the cart is reset:**
+When an address is cleared, the cart must be reset because:
+- Cart items have location-specific pricing and availability
+- Fulfillment options are tied to specific addresses  
+- Delivery fees and shipping costs depend on location
+- Without a valid address, cart operations would fail or show incorrect data
+
+**Events fired:**
+- `lce:actions.address_cleared` - Address successfully cleared
+- `lce:actions.cart_reset` - Cart successfully reset
+
+**Use cases:**
+- Guest checkout option (clear previous user's data)
+- Location change (start fresh with new address)
+- Privacy compliance (complete data removal)
+- Testing/development (reset to clean state)
+
 **Real Business Uses:**
 - **One-Click Address**: Let customers select from saved Google Places
 - **Custom Address Forms**: Build your own address input forms with full control

package/docs/TROUBLESHOOTING.md

@@ -2,6 +2,27 @@
 
 Common issues and solutions for the LiquidCommerce Elements SDK.
 
+## Address Management Issues
+
+### Address Clear Behavior
+
+**Question:** What happens when I call `actions.address.clear()`?
+
+**Answer:** The `actions.address.clear()` action performs a comprehensive reset:
+
+- ✅ **Address Data**: Removes all saved address information
+- ✅ **Cart Contents**: Completely resets the cart (removes all items, totals, promo codes)
+- ✅ **Local Storage**: Completely removes the localStorage entry and its value
+- ✅ **Database**: Deletes the persisted store from the server database
+- ✅ **Checkout State**: Resets any pending checkout information
+
+**Why does it reset the cart?**
+Cart items have location-specific pricing, availability, and fulfillment options. Without a valid address, cart operations would fail or show incorrect data. The reset ensures data integrity.
+
+**Events fired:**
+- `lce:actions.address_cleared` - Address successfully cleared
+- `lce:actions.cart_reset` - Cart successfully reset
+
 ## SDK Initialization Issues
 
 ### SDK Not Loading

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiquidCommerce Elements SDK",
   "license": "UNLICENSED",
   "author": "LiquidCommerce Team",
-  "version": "2.4.4",
+  "version": "2.5.0",
   "homepage": "https://docs.liquidcommerce.co/elements-sdk",
   "repository": {
     "type": "git",
@@ -71,23 +71,23 @@
     "embeddable commerce"
   ],
   "devDependencies": {
-    "@biomejs/biome": "2.2.7",
+    "@biomejs/biome": "2.3.3",
     "@commitlint/cli": "^20.1.0",
     "@commitlint/config-conventional": "^20.0.0",
-    "@rollup/plugin-alias": "^5.1.1",
-    "@rollup/plugin-commonjs": "^28.0.9",
+    "@rollup/plugin-alias": "^6.0.0",
+    "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-replace": "^6.0.2",
+    "@rollup/plugin-replace": "^6.0.3",
     "@rollup/plugin-terser": "^0.4.4",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^12.0.0",
+    "@semantic-release/github": "^12.0.1",
     "@semantic-release/npm": "^13.1.1",
     "@semantic-release/release-notes-generator": "^14.1.0",
     "@types/core-js": "^2.5.8",
-    "@types/node": "^24.9.1",
+    "@types/node": "^24.10.0",
     "conventional-changelog-cli": "^5.0.0",
     "husky": "^9.1.7",
     "process": "^0.11.10",
@@ -99,7 +99,7 @@
     "typescript": "^5.9.3"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "pnpm": {
     "peerDependencyRules": {
@@ -108,6 +108,9 @@
     "onlyBuiltDependencies": [
       "@biomejs/biome",
       "javascript-obfuscator"
-    ]
+    ],
+    "overrides": {
+      "@conventional-changelog/git-client@<2.0.0": ">=2.0.0"
+    }
   }
 }