@lime-bundles/widget 1.0.0 → 2.1.0

package/dist/index.d.cts

@@ -1,62 +1,26 @@
-/**
- * <lime-bundle> Web Component — renders Lime Bundles on any storefront.
- *
- * ## The two modes
- *
- * Single-bundle (pinned):
- *   <lime-bundle
- *     shop-domain="my-shop.myshopify.com"
- *     storefront-token="shpat_..."
- *     bundle-gid="gid://shopify/Metaobject/42"
- *   ></lime-bundle>
- *
- * Product-aware (matches classic Liquid theme block behaviour — one snippet
- * on the product page renders every active bundle configured against that
- * product):
- *   <lime-bundle
- *     shop-domain="my-shop.myshopify.com"
- *     storefront-token="shpat_..."
- *   ></lime-bundle>
- *
- * Product resolution cascade (when no `bundle-gid` is set):
- *   1. explicit `product-handle` attribute
- *   2. <meta name="shopify:product-handle" content="..."> on the page
- *   3. /products/<handle> segment of window.location.pathname
- *   4. fallthrough: renders nothing, fires `lime-bundle:error`
- *
- * ## Add-to-cart behaviour
- *
- * Merchants who do nothing get a default: the widget calls Shopify's
- * Storefront Cart API (tokenless — no extra scopes required) and redirects
- * the browser to the returned checkoutUrl. One-click-to-checkout is the
- * right UX for most merchants pasting the widget into Webflow / Wix /
- * Squarespace / static HTML.
- *
- * Merchants with their own cart state (Hydrogen's useCart, a custom cart
- * drawer, etc.) opt out by attaching a listener that calls
- * `event.preventDefault()`:
- *
- *   document.querySelector("lime-bundle").addEventListener(
- *     "lime-bundle:add-to-cart",
- *     (ev) => {
- *       ev.preventDefault();           // suppress the default redirect
- *       myCart.linesAdd(ev.detail.lines);
- *     },
- *   );
- *
- * The event is always dispatched; only the default action is conditional.
- */
-
 declare class LimeBundleElement extends HTMLElement {
     static observedAttributes: string[];
     private shadow;
     private bundles;
     private abortController;
     private impressionCleanups;
+    /**
+     * Tick / observer / listener cleanups registered by individual renderers
+     * (e.g. countdown setInterval handles). Flushed in disconnectedCallback
+     * so we never leak timers or event listeners when the widget is removed.
+     */
+    private renderCleanups;
+    /**
+     * Merchant custom CSS fetched from the shop metafield. Injected inside
+     * the shadow root alongside the bundle stylesheets so selectors like
+     * `.lb-bundle-widget { ... }` reach the widget's DOM.
+     */
+    private shopCustomCss;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
     private teardownImpressions;
+    private teardownRenderers;
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     private get shopDomain();
     private get storefrontToken();
@@ -65,6 +29,15 @@ declare class LimeBundleElement extends HTMLElement {
     private get appUrl();
     private get analyticsEnabled();
     private fetchBundle;
+    /**
+     * Resolve the visitor's A/B bucket for every bundle with an active test
+     * and merge Variant B overrides where applicable. Runs in parallel; any
+     * assignment failure logs internally but still renders Variant A (safe
+     * default). The `getABTestAssignment` helper also persists the bucket
+     * via a first-party cookie + POSTs to /api/ab-assign for server-side
+     * analytics.
+     */
+    private applyABVariants;
     private fetchSingleBundle;
     private fetchProductBundles;
     /**
@@ -87,7 +60,6 @@ declare class LimeBundleElement extends HTMLElement {
     private setupImpressionFor;
     private renderLoading;
     private renderError;
-    private render;
 }
 
 export { LimeBundleElement };

package/dist/index.d.ts

@@ -1,62 +1,26 @@
-/**
- * <lime-bundle> Web Component — renders Lime Bundles on any storefront.
- *
- * ## The two modes
- *
- * Single-bundle (pinned):
- *   <lime-bundle
- *     shop-domain="my-shop.myshopify.com"
- *     storefront-token="shpat_..."
- *     bundle-gid="gid://shopify/Metaobject/42"
- *   ></lime-bundle>
- *
- * Product-aware (matches classic Liquid theme block behaviour — one snippet
- * on the product page renders every active bundle configured against that
- * product):
- *   <lime-bundle
- *     shop-domain="my-shop.myshopify.com"
- *     storefront-token="shpat_..."
- *   ></lime-bundle>
- *
- * Product resolution cascade (when no `bundle-gid` is set):
- *   1. explicit `product-handle` attribute
- *   2. <meta name="shopify:product-handle" content="..."> on the page
- *   3. /products/<handle> segment of window.location.pathname
- *   4. fallthrough: renders nothing, fires `lime-bundle:error`
- *
- * ## Add-to-cart behaviour
- *
- * Merchants who do nothing get a default: the widget calls Shopify's
- * Storefront Cart API (tokenless — no extra scopes required) and redirects
- * the browser to the returned checkoutUrl. One-click-to-checkout is the
- * right UX for most merchants pasting the widget into Webflow / Wix /
- * Squarespace / static HTML.
- *
- * Merchants with their own cart state (Hydrogen's useCart, a custom cart
- * drawer, etc.) opt out by attaching a listener that calls
- * `event.preventDefault()`:
- *
- *   document.querySelector("lime-bundle").addEventListener(
- *     "lime-bundle:add-to-cart",
- *     (ev) => {
- *       ev.preventDefault();           // suppress the default redirect
- *       myCart.linesAdd(ev.detail.lines);
- *     },
- *   );
- *
- * The event is always dispatched; only the default action is conditional.
- */
-
 declare class LimeBundleElement extends HTMLElement {
     static observedAttributes: string[];
     private shadow;
     private bundles;
     private abortController;
     private impressionCleanups;
+    /**
+     * Tick / observer / listener cleanups registered by individual renderers
+     * (e.g. countdown setInterval handles). Flushed in disconnectedCallback
+     * so we never leak timers or event listeners when the widget is removed.
+     */
+    private renderCleanups;
+    /**
+     * Merchant custom CSS fetched from the shop metafield. Injected inside
+     * the shadow root alongside the bundle stylesheets so selectors like
+     * `.lb-bundle-widget { ... }` reach the widget's DOM.
+     */
+    private shopCustomCss;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
     private teardownImpressions;
+    private teardownRenderers;
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     private get shopDomain();
     private get storefrontToken();
@@ -65,6 +29,15 @@ declare class LimeBundleElement extends HTMLElement {
     private get appUrl();
     private get analyticsEnabled();
     private fetchBundle;
+    /**
+     * Resolve the visitor's A/B bucket for every bundle with an active test
+     * and merge Variant B overrides where applicable. Runs in parallel; any
+     * assignment failure logs internally but still renders Variant A (safe
+     * default). The `getABTestAssignment` helper also persists the bucket
+     * via a first-party cookie + POSTs to /api/ab-assign for server-side
+     * analytics.
+     */
+    private applyABVariants;
     private fetchSingleBundle;
     private fetchProductBundles;
     /**
@@ -87,7 +60,6 @@ declare class LimeBundleElement extends HTMLElement {
     private setupImpressionFor;
     private renderLoading;
     private renderError;
-    private render;
 }
 
 export { LimeBundleElement };