@salla.sa/twilight-components 3.0.17 → 3.0.19

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-10-29T07:59:13",
+  "timestamp": "2026-11-02T03:54:55",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.35.1",
@@ -2482,28 +2482,43 @@
             "docs": ""
           },
           "complexType": {
-            "signature": "(silent?: boolean) => Promise<void>",
+            "signature": "(silent?: boolean, trigger?: SelectorTrigger) => Promise<void>",
             "parameters": [
               {
                 "name": "silent",
                 "type": "boolean",
                 "docs": ""
+              },
+              {
+                "name": "trigger",
+                "type": "\"first_visit\" | \"after_add_to_cart\" | \"on_cart_click\" | \"incomplete_intent\" | \"checkout_gate\" | \"after_login\" | \"customer_requested\"",
+                "docs": ""
               }
             ],
             "references": {
               "Promise": {
                 "location": "global",
                 "id": "global::Promise"
+              },
+              "SelectorTrigger": {
+                "location": "import",
+                "path": "./selector-tracker",
+                "id": "src/components/salla-bullet-delivery/selector-tracker.ts::SelectorTrigger"
               }
             },
             "return": "Promise<void>"
           },
-          "signature": "open(silent?: boolean) => Promise<void>",
+          "signature": "open(silent?: boolean, trigger?: SelectorTrigger) => Promise<void>",
           "parameters": [
             {
               "name": "silent",
               "type": "boolean",
               "docs": ""
+            },
+            {
+              "name": "trigger",
+              "type": "\"first_visit\" | \"after_add_to_cart\" | \"on_cart_click\" | \"incomplete_intent\" | \"checkout_gate\" | \"after_login\" | \"customer_requested\"",
+              "docs": ""
             }
           ],
           "docs": "Opens the bullet delivery modal. Pass `silent: true` to run the same state/data\nloading below without showing the modal — used by tryAutoConfirmAfterLogin() so a\nsuccessful auto-confirm never flashes the saved-addresses list; the caller is\nresponsible for revealing the modal itself if it still needs the customer's input.",
@@ -10999,7 +11014,7 @@
       "encapsulation": "none",
       "tag": "salla-free-shipping-banner",
       "readme": "# salla-free-shipping-banner\n\n\n",
-      "docs": "Non-dismissible banner announcing the store's free shipping offer.\nWhere it is rendered (`placement`) decides which banner data is requested, and the\nresponse decides whether it is shown.",
+      "docs": "",
       "docsTags": [],
       "usage": {},
       "props": [
@@ -11059,7 +11074,7 @@
       "encapsulation": "none",
       "tag": "salla-free-shipping-tag",
       "readme": "# salla-free-shipping-tag\n\n\n",
-      "docs": "Small \"free shipping\" tag for a product. Meant to be placed below the price in any\nproduct card.",
+      "docs": "Small \"free shipping\" tag for a product. Meant to be placed below the price in any\nproduct card. It follows the free shipping banner: while the banner's countdown is over and the\nbanner is hidden, the tag is hidden too.",
       "docsTags": [],
       "usage": {},
       "props": [
@@ -30937,6 +30952,11 @@
       "docstring": "Header context update event payload (for syncing with global header)",
       "path": "src/components/salla-bullet-delivery/interfaces.ts"
     },
+    "src/components/salla-bullet-delivery/selector-tracker.ts::SelectorTrigger": {
+      "declaration": "export type SelectorTrigger =\n\t| \"first_visit\"\n\t| \"after_add_to_cart\"\n\t| \"on_cart_click\"\n\t| \"incomplete_intent\"\n\t| \"checkout_gate\"\n\t| \"after_login\"\n\t| \"customer_requested\";",
+      "docstring": "",
+      "path": "src/components/salla-bullet-delivery/selector-tracker.ts"
+    },
     "src/components/salla-cart-coupons/interfaces.ts::Coupon": {
       "declaration": "export interface Coupon {\n  /** Unique coupon code */\n  code: string;\n  \n  /** Discount amount (number, string, or CouponAmount object for fixed coupons) */\n  amount: number | string | CouponAmount;\n  \n  /** Type of discount - percentage or fixed */\n  type: 'percentage' | 'fixed';\n  \n  /** Minimum cart amount required to use this coupon */\n  minimum_amount?: CouponAmount;\n  \n  /** Maximum discount amount (for percentage coupons) */\n  maximum_amount?: CouponAmount;\n  \n  /** Remaining days until expiry */\n  remaining_days?: number;\n  \n  /** Whether this coupon includes free shipping */\n  free_shipping?: number | boolean;\n}",
       "docstring": "Coupon data structure interface (matches API response)",

package/dist/esm/{Helper-POCi7J93.js → Helper-I0CAizv1.js}

@@ -1,7 +1,7 @@
 /*!
  * Crafted with ❤ by Salla
  */
-import './index-DmGAR42j.js';
+import './index-C9zdeQFI.js';
 
 var FilterOptionTypes;
 (function (FilterOptionTypes) {

package/dist/esm/{filepond-Ct76xW02.js → filepond-DTUYXV0J.js}

@@ -1,7 +1,7 @@
 /*!
  * Crafted with ❤ by Salla
  */
-import { d as getDefaultExportFromCjs } from './index-DmGAR42j.js';
+import { d as getDefaultExportFromCjs } from './index-C9zdeQFI.js';
 
 function _mergeNamespaces(n, m) {
     m.forEach(function (e) {

package/dist/esm/{filepond-plugin-file-poster-C1OkzGRs.js → filepond-plugin-file-poster-DydZjneT.js}

@@ -1,7 +1,7 @@
 /*!
  * Crafted with ❤ by Salla
  */
-import { d as getDefaultExportFromCjs } from './index-DmGAR42j.js';
+import { d as getDefaultExportFromCjs } from './index-C9zdeQFI.js';
 
 function _mergeNamespaces(n, m) {
   m.forEach(function (e) {

package/dist/esm/{filepond-plugin-file-validate-size-gdd-69cO.js → filepond-plugin-file-validate-size-nbsCU2t9.js}

@@ -1,7 +1,7 @@
 /*!
  * Crafted with ❤ by Salla
  */
-import { d as getDefaultExportFromCjs } from './index-DmGAR42j.js';
+import { d as getDefaultExportFromCjs } from './index-C9zdeQFI.js';
 
 function _mergeNamespaces(n, m) {
     m.forEach(function (e) {

package/dist/esm/{filepond-plugin-file-validate-type-BaZ2QTzl.js → filepond-plugin-file-validate-type-Cl5B_DIy.js}

@@ -1,7 +1,7 @@
 /*!
  * Crafted with ❤ by Salla
  */
-import { d as getDefaultExportFromCjs } from './index-DmGAR42j.js';
+import { d as getDefaultExportFromCjs } from './index-C9zdeQFI.js';
 
 function _mergeNamespaces(n, m) {
     m.forEach(function (e) {

package/dist/esm/{filepond-plugin-image-edit-CsoNvf0i.js → filepond-plugin-image-edit-bzskFyFR.js}

@@ -1,7 +1,7 @@
 /*!
  * Crafted with ❤ by Salla
  */
-import { d as getDefaultExportFromCjs } from './index-DmGAR42j.js';
+import { d as getDefaultExportFromCjs } from './index-C9zdeQFI.js';
 
 function _mergeNamespaces(n, m) {
   m.forEach(function (e) {

package/dist/esm/{filepond-plugin-image-exif-orientation-BHDSe3nH.js → filepond-plugin-image-exif-orientation-MBDuxLaX.js}

@@ -1,7 +1,7 @@
 /*!
  * Crafted with ❤ by Salla
  */
-import { d as getDefaultExportFromCjs } from './index-DmGAR42j.js';
+import { d as getDefaultExportFromCjs } from './index-C9zdeQFI.js';
 
 function _mergeNamespaces(n, m) {
   m.forEach(function (e) {

package/dist/esm/{filepond-plugin-image-preview-CD_S17z3.js → filepond-plugin-image-preview-N6wzEryW.js}

@@ -1,7 +1,7 @@
 /*!
  * Crafted with ❤ by Salla
  */
-import { d as getDefaultExportFromCjs } from './index-DmGAR42j.js';
+import { d as getDefaultExportFromCjs } from './index-C9zdeQFI.js';
 
 function _mergeNamespaces(n, m) {
   m.forEach(function (e) {

package/dist/esm/free-shipping-timer-CnTwkF6y.js

@@ -0,0 +1,150 @@
+/*!
+ * Crafted with ❤ by Salla
+ */
+const cache = new Map();
+async function request(productId) {
+    const endpoint = 'products/eligible-for-free-shipping' + (productId ? `/${productId}` : '');
+    try {
+        // 403 (feature off or plan not supported) and 410 (product gone) mean "not eligible",
+        // not a failure worth a toast.
+        const response = await salla.api.withoutNotifier(() => salla.api.request(endpoint));
+        return response?.data?.eligible === true;
+    }
+    catch (e) {
+        return false;
+    }
+}
+/**
+ * Whether free shipping applies: to the store when no product is given (banner),
+ * or to the product (tag, product page banner). Same calls share one request.
+ */
+function isEligibleForFreeShipping(productId) {
+    const key = String(productId ?? '');
+    if (!cache.has(key)) {
+        cache.set(key, request(productId));
+    }
+    return cache.get(key);
+}
+
+const HOUR = 60 * 60 * 1000;
+const DAY = 24 * HOUR;
+const MAX_TIMEOUT = 2 ** 31 - 1;
+// Used only when storage is not available (private mode, blocked site data).
+let memoryStartedAt = null;
+const DEFAULT_COUNTDOWN_HOURS = 45;
+const DEFAULT_HIDDEN_DAYS = 7;
+const positive = (value, fallback) => {
+    const number = Number(value);
+    return Number.isFinite(number) && number > 0 ? number : fallback;
+};
+/** The countdown and hidden period, from the store settings with 45 hours and 7 days as the fallback. */
+function getTimerSettings() {
+    const settings = salla.config?.get?.('store.settings.free_shipping_banner');
+    return {
+        countdownMs: positive(settings?.countdown_hours, DEFAULT_COUNTDOWN_HOURS) * HOUR,
+        hiddenMs: positive(settings?.hidden_days, DEFAULT_HIDDEN_DAYS) * DAY,
+    };
+}
+/** The timer exists only for visitors the backend allowed the banner for. */
+function isTimerEnabled() {
+    return !!salla.config?.get?.('store.features')?.includes('free-shipping-banner');
+}
+const storageKey = () => `free-shipping-timer_${salla.config?.get?.('store.id')}`;
+/** When the visitor first saw the banner, or null if they have not yet. */
+function getStartedAt() {
+    try {
+        const stored = Number(salla.storage.get(storageKey()));
+        if (Number.isFinite(stored) && stored > 0) {
+            return stored;
+        }
+    }
+    catch (e) {
+        // fall through to the in-memory value
+    }
+    return memoryStartedAt;
+}
+/**
+ * Records the first time the visitor saw the banner. Does nothing when it is already recorded
+ * or when the feature is off.
+ */
+function startTimerIfNeeded(now = Date.now()) {
+    if (!isTimerEnabled()) {
+        return null;
+    }
+    const existing = getStartedAt();
+    if (existing) {
+        return existing;
+    }
+    memoryStartedAt = now;
+    try {
+        salla.storage.set(storageKey(), now);
+    }
+    catch (e) {
+        // keep the in-memory value
+    }
+    schedule();
+    notify();
+    return now;
+}
+/**
+ * Where the visitor is in the repeating cycle: `countdown` visible, then `hidden` hidden, again and again.
+ * Nothing but the first-seen time is stored, so changed settings apply on the next check.
+ */
+function computeTimerState(startedAt, now, countdownMs, hiddenMs) {
+    const elapsed = Math.max(0, now - startedAt);
+    const position = elapsed % (countdownMs + hiddenMs);
+    if (position < countdownMs) {
+        return { visible: true, remainingMs: countdownMs - position, nextChangeMs: countdownMs - position };
+    }
+    return { visible: false, remainingMs: 0, nextChangeMs: countdownMs + hiddenMs - position };
+}
+/**
+ * The state the banner and tags follow. `null` means there is nothing to follow: the feature is off
+ * or the visitor has not seen the banner yet.
+ */
+function getFreeShippingTimerState(now = Date.now()) {
+    if (!isTimerEnabled()) {
+        return null;
+    }
+    const startedAt = getStartedAt();
+    if (!startedAt) {
+        return null;
+    }
+    const { countdownMs, hiddenMs } = getTimerSettings();
+    return computeTimerState(startedAt, now, countdownMs, hiddenMs);
+}
+const listeners = new Set();
+let timeout;
+function notify() {
+    listeners.forEach((listener) => listener());
+}
+// One timeout for the whole page, set for the next visible/hidden change.
+function schedule() {
+    clearTimeout(timeout);
+    timeout = undefined;
+    if (!listeners.size) {
+        return;
+    }
+    const state = getFreeShippingTimerState();
+    if (!state) {
+        return;
+    }
+    timeout = setTimeout(() => {
+        notify();
+        schedule();
+    }, Math.min(state.nextChangeMs + 50, MAX_TIMEOUT));
+}
+/** Calls back whenever the banner and tags have to show or hide. Returns the unsubscribe function. */
+function subscribeToFreeShippingTimer(listener) {
+    listeners.add(listener);
+    schedule();
+    return () => {
+        listeners.delete(listener);
+        if (!listeners.size) {
+            clearTimeout(timeout);
+            timeout = undefined;
+        }
+    };
+}
+
+export { isTimerEnabled as a, subscribeToFreeShippingTimer as b, getFreeShippingTimerState as g, isEligibleForFreeShipping as i, startTimerIfNeeded as s };