@liquidcommerce/elements-sdk 2.7.22 → 2.7.24

package/dist/types/auto-initialize/shared-utils.d.ts

@@ -39,6 +39,7 @@ export declare function getProductUrlsConfig(): ProductUrlsConfig | undefined;
 export declare function triggerAutoInit(initFunction: () => Promise<void>, errorPrefix: string): void;
 export declare function setupCheckout(script: HTMLScriptElement, injectFn: (params: IInjectCheckoutParams) => Promise<IInjectedComponent | null>, exitCheckoutFn: () => void, options: {
     errorPrefix: string;
+    warnIfMissing?: boolean;
 }): Promise<void>;
 export declare function setupExitCheckoutHandlers(exitCheckoutFn: () => void): void;
 export declare function addProductViaQueryParam(actions: IQueryParamActions, script: HTMLScriptElement, errorPrefix: string): Promise<void>;

package/dist/types/clients/builder.d.ts

@@ -1,3 +1,3 @@
 import type { ILiquidCommerceElementsBuilderClient } from '@/interfaces/client.interface';
 import type { ILiquidCommerceElementsBuilderConfig } from '@/interfaces/config.interface';
-export declare function ElementsBuilder(apiKey: string, config: ILiquidCommerceElementsBuilderConfig): Promise<ILiquidCommerceElementsBuilderClient | null>;
+export declare function ElementsBuilder(apiKey: string, config?: ILiquidCommerceElementsBuilderConfig): Promise<ILiquidCommerceElementsBuilderClient | null>;

package/dist/types/clients/checkout.d.ts

@@ -3,4 +3,4 @@ import type { ILiquidCommerceElementsCheckoutClientConfig } from '@/interfaces/c
 import '@/modules/theme-provider/styles/register-styles';
 import '@/modules/address/styles/register-styles';
 import '@/modules/checkout/styles/register-styles';
-export declare function ElementsCheckout(apiKey: string, config: ILiquidCommerceElementsCheckoutClientConfig): Promise<IElementsCheckoutClient | null>;
+export declare function ElementsCheckout(apiKey: string, config?: ILiquidCommerceElementsCheckoutClientConfig): Promise<IElementsCheckoutClient | null>;

package/dist/types/clients/main.d.ts

@@ -1,3 +1,3 @@
 import type { ILiquidCommerceElementsClient } from '@/interfaces/client.interface';
 import type { ILiquidCommerceElementsConfig } from '@/interfaces/config.interface';
-export declare function Elements(apiKey: string, config: ILiquidCommerceElementsConfig): Promise<ILiquidCommerceElementsClient | null>;
+export declare function Elements(apiKey: string, config?: ILiquidCommerceElementsConfig): Promise<ILiquidCommerceElementsClient | null>;

package/dist/types/interfaces/configs/global.interface.d.ts

@@ -40,6 +40,8 @@ export interface IGlobalLayout {
     personalizationCardStyle: 'outlined' | 'filled';
     allowPromoCodes: boolean;
     inputFieldStyle: 'outlined' | 'filled';
+    enableOrderedProductSizes: boolean;
+    orderedProductSizes: string[];
     showPoweredBy: boolean;
     poweredByMode: 'light' | 'dark';
 }

package/dist/types/modules/product/components/product-image-carousel.component.d.ts

@@ -8,6 +8,7 @@ export interface IImageCarouselParams {
 export declare class ProductImageCarouselComponent extends BaseComponent<IImageCarouselParams, IProductComponent> {
     get hostClasses(): string[];
     private mainImageElement;
+    private mainImageMediaElement;
     private galleryViewport;
     private galleryContainer;
     private thumbnails;

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

@@ -5,6 +5,7 @@ export interface IProductListProductPreCartComponentParams {
     productId: string;
 }
 export declare class ProductListProductPreCartComponent extends BaseComponent<IProductListProductPreCartComponentParams, IProductListComponent> {
+    get hostClasses(): string[];
     private showRetailersContent;
     private showEngravingForm;
     private isInitialRender;

package/dist/types/utils/image-bg-removal.d.ts

@@ -0,0 +1,3 @@
+export declare const IMG_BG_REMOVAL_HOST_CLASS = "lc-bg-removal";
+export declare function applyImageBackgroundTreatment(target: HTMLElement | null, imageUrl: string | undefined | null, bgProbe?: Element): void;
+export declare const getImageBgRemovalStyles: () => string;

package/dist/types/utils/product.d.ts

@@ -7,4 +7,9 @@ export interface IPrepareApiProductForStoreParams {
     retailers: IProductAvailabilityResponse['retailers'];
     enableShippingFulfillment: boolean;
 }
+export declare function buildSizeLabel(size: {
+    size: string;
+    pack: boolean;
+    packDesc: string;
+}): string;
 export declare function prepareApiProductForStore({ context, product, retailers, enableShippingFulfillment, }: IPrepareApiProductForStoreParams): IProductStore | IPLProductStore;

package/docs/v1/guides/product-component.md

@@ -157,6 +157,28 @@ For products with multiple sizes:
 - Availability checking per size
 - Out-of-stock indication
 
+#### Preselect a Size via URL
+
+Use the `lce_size` query parameter to preselect a size when the product page loads:
+
+```
+https://yoursite.com/products/buffalo-trace?lce_size=750ml
+```
+
+- The value is compared against each size's full label as shown on the page.
+- Matching is case-insensitive and ignores spacing and punctuation — only letters, digits, and decimal points are compared — so `750 ML`, `750ml`, and `750ML` all select a `750ml` size, while decimals are kept so `1.0L` and `1.75L` stay distinct.
+- If the value matches no size, the default size selection is used.
+
+**Pack sizes:** the label includes the pack description when present (e.g. `50 ML (12PK)`). To select that size, include the pack in the value:
+
+```
+https://yoursite.com/products/mini-bottles?lce_size=50ml(12pk)
+```
+
+Both `50ml(12pk)` and `50ml12pk` match `50 ML (12PK)` (punctuation is ignored). A value of just `50ml` only matches a size whose label is `50 ML` with no pack.
+
+`lce_size` is a fixed parameter name (not configured through a script attribute) and only applies to the product page.
+
 ### Fulfillment Types
 
 Two fulfillment options:

package/package.json

@@ -3,7 +3,7 @@
   "description": "LiquidCommerce Elements SDK",
   "license": "UNLICENSED",
   "author": "LiquidCommerce Team",
-  "version": "2.7.22",
+  "version": "2.7.24",
   "homepage": "https://docs.liquidcommerce.co/elements-sdk",
   "repository": {
     "type": "git",
@@ -14,7 +14,7 @@
   },
   "module": "./dist/index.esm.js",
   "types": "./dist/types/index.d.ts",
-  "packageManager": "pnpm@11.8.0",
+  "packageManager": "pnpm@11.10.0",
   "exports": {
     ".": {
       "types": "./dist/types/index.d.ts",
@@ -53,6 +53,7 @@
     "build": "rollup -c",
     "build:checkout": "rollup -c rollup.config.checkout.mjs",
     "build:all": "pnpm build && pnpm build:checkout",
+    "build:demo-site": "pnpm build:all && mkdir -p demo-site/sdk && cp umd/elements.js umd/elements-checkout.js demo-site/sdk/",
     "dev": "rollup -c -w",
     "type-check": "tsc --noEmit",
     "lint": "pnpm biome lint --write",
@@ -77,9 +78,9 @@
     "embeddable commerce"
   ],
   "devDependencies": {
-    "@biomejs/biome": "^2.5.0",
-    "@commitlint/cli": "^21.0.2",
-    "@commitlint/config-conventional": "^21.0.2",
+    "@biomejs/biome": "^2.5.2",
+    "@commitlint/cli": "^21.2.0",
+    "@commitlint/config-conventional": "^21.2.0",
     "@rollup/plugin-alias": "^6.0.0",
     "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-json": "^6.1.0",
@@ -89,12 +90,12 @@
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^12.0.8",
+    "@semantic-release/github": "^12.0.9",
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.1",
     "@types/core-js": "^2.5.8",
-    "@types/node": "^26.0.0",
-    "conventional-changelog": "^7.2.1",
+    "@types/node": "^26.1.0",
+    "conventional-changelog": "8.0.1",
     "husky": "^9.1.7",
     "process": "^0.11.10",
     "rollup": "^4.62.2",