storefront-layouts-staging 1.0.0-staging.0

package/dist/lib/utils/index.js

@@ -0,0 +1,197 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+import { getCurrencySymbolInfo, getCurrencySymbol } from "../../lib/currency-symbols.js";
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+/**
+ * Normalizes a price value to a number
+ * Handles string, number, null, undefined, and invalid values
+ */
+export function normalizePrice(price) {
+    if (typeof price === 'number') {
+        return isNaN(price) ? 0 : price;
+    }
+    if (typeof price === 'string') {
+        const parsed = parseFloat(price);
+        return isNaN(parsed) ? 0 : parsed;
+    }
+    return 0;
+}
+/**
+ * Formats display text with the first letter of each word capitalized.
+ * Normalizes ALL CAPS or inconsistent casing for UI labels (e.g. categories, brands).
+ */
+export function formatDisplayLabel(text) {
+    if (!text)
+        return text;
+    return text.replace(/\w\S*/g, (word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase());
+}
+/** Formats a store name for UI display with the first letter of each word capitalized. */
+export function formatStoreDisplayName(name) {
+    return formatDisplayLabel(name);
+}
+/**
+ * Formats a price amount with the correct currency symbol and code
+ * Uses explicit currency symbol mapping for accurate symbol display
+ * @param amount - The price amount to format
+ * @param currencyCode - The ISO 4217 currency code (e.g., 'USD', 'NGN', 'EUR')
+ * @param options - Optional formatting options
+ * @returns Formatted currency string (e.g., "$1,234.56" or "₦1,234.56")
+ */
+export function formatCurrency(amount, currencyCode, options) {
+    // Normalize the amount first
+    const normalizedAmount = normalizePrice(amount);
+    // Default to USD if currency code is invalid or missing
+    const validCurrencyCode = currencyCode && typeof currencyCode === 'string' && currencyCode.length === 3
+        ? currencyCode.toUpperCase()
+        : 'USD';
+    // Get currency symbol information from our mapping
+    const currencyInfo = getCurrencySymbolInfo(validCurrencyCode);
+    if (currencyInfo) {
+        // Use our explicit currency symbol mapping
+        // Determine decimal places: use provided options, or fall back to currency's standard decimal places
+        const defaultDecimalPlaces = currencyInfo.decimalPlaces;
+        const minFractionDigits = options?.minimumFractionDigits ?? (defaultDecimalPlaces === 0 ? 0 : defaultDecimalPlaces);
+        const maxFractionDigits = options?.maximumFractionDigits ?? defaultDecimalPlaces;
+        // Format the number using Intl.NumberFormat (for thousands separators, decimal formatting)
+        // But don't use style: 'currency' since we'll add the symbol ourselves
+        const formatter = new Intl.NumberFormat('en-US', {
+            minimumFractionDigits: minFractionDigits,
+            maximumFractionDigits: maxFractionDigits,
+        });
+        const formattedNumber = formatter.format(normalizedAmount);
+        // Position the symbol based on currency convention
+        if (currencyInfo.position === 'prefix') {
+            return `${currencyInfo.symbol}${formattedNumber}`;
+        }
+        else {
+            return `${formattedNumber} ${currencyInfo.symbol}`;
+        }
+    }
+    // Fallback: Use Intl.NumberFormat if currency not in our mapping
+    // This handles edge cases and ensures we always return a formatted value
+    try {
+        const formatter = new Intl.NumberFormat('en-US', {
+            style: 'currency',
+            currency: validCurrencyCode,
+            minimumFractionDigits: options?.minimumFractionDigits ?? 2,
+            maximumFractionDigits: options?.maximumFractionDigits ?? 2,
+        });
+        return formatter.format(normalizedAmount);
+    }
+    catch (error) {
+        // Final fallback: Use symbol from mapping or currency code itself
+        const fallbackSymbol = getCurrencySymbol(validCurrencyCode, validCurrencyCode);
+        const formatter = new Intl.NumberFormat('en-US', {
+            minimumFractionDigits: options?.minimumFractionDigits ?? 2,
+            maximumFractionDigits: options?.maximumFractionDigits ?? 2,
+        });
+        const formattedNumber = formatter.format(normalizedAmount);
+        return `${fallbackSymbol}${formattedNumber}`;
+    }
+}
+/**
+ * Converts API errors to user-friendly messages
+ */
+export function getUserFriendlyErrorMessage(error, defaultMessage = 'Something went wrong. Please try again.') {
+    // ApiError / axios errors without a response body
+    if (!error?.response) {
+        if (error?.message?.includes('timeout') || error?.code === 'ECONNABORTED') {
+            return 'Request timed out. Please check your connection and try again.';
+        }
+        if (error?.message?.includes('Network Error')) {
+            return 'Network error. Please check your internet connection and try again.';
+        }
+        if (error?.status === 500) {
+            return 'Server error. Please try again later.';
+        }
+        return error?.message || defaultMessage;
+    }
+    // Handle HTTP status codes
+    const status = error.response?.status;
+    const errorData = error.response?.data;
+    switch (status) {
+        case 400:
+            return errorData?.message || 'Invalid request. Please check your input and try again.';
+        case 401:
+            return 'You need to be logged in to perform this action.';
+        case 403:
+            return 'You do not have permission to perform this action.';
+        case 404:
+            return errorData?.message || 'The requested resource was not found.';
+        case 409:
+            return errorData?.message || 'This action conflicts with existing data.';
+        case 422:
+            return errorData?.message || 'Validation error. Please check your input.';
+        case 429:
+            return 'Too many requests. Please wait a moment and try again.';
+        case 500:
+            return 'Server error. Please try again later.';
+        case 502:
+        case 503:
+        case 504:
+            return 'Service temporarily unavailable. Please try again later.';
+        default:
+            return errorData?.message || error.message || defaultMessage;
+    }
+}
+export { filterActiveProducts, filterActiveServices, filterCategoriesForServices, } from './product-catalog.js';
+export { isEditorPreviewMode, resolveStoreProductsForDisplay, resolveProductBySlugForDisplay, resolveStoreCategoriesForDisplay, resolveCategoryBySlugForDisplay, resolveStoreServicesForDisplay, resolveServiceBySlugForDisplay, resolveCategoryProductsForDisplay, resolveCategoryServicesForDisplay, resolveMenuItemsForDisplay, productsToMenuItems, coalesceCatalog, applyEditorCatalogOverlay, applyStoreCatalogFromApi, syncFoodMenuItemsFromProducts, } from './editor-preview.js';
+export { resolveProductImageUrls, getPrimaryProductImageUrl, normalizeStoreProductForDisplay, normalizeStoreProductsForDisplay, EDITOR_PRODUCT_IMAGE_PLACEHOLDER, } from './product-images.js';
+/**
+ * Deep clones an object using structuredClone if available, or a fallback recursive clone.
+ * This is more efficient and handles more types than JSON.parse(JSON.stringify).
+ */
+export function deepClone(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (typeof structuredClone === 'function') {
+        try {
+            return structuredClone(obj);
+        }
+        catch (e) {
+            // Fallback if structuredClone fails (e.g. for some non-serializable objects)
+        }
+    }
+    // Fallback recursive clone
+    if (Array.isArray(obj)) {
+        const copy = [];
+        for (let i = 0; i < obj.length; i++) {
+            copy[i] = deepClone(obj[i]);
+        }
+        return copy;
+    }
+    const copy = {};
+    for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+            copy[key] = deepClone(obj[key]);
+        }
+    }
+    return copy;
+}
+/**
+ * Checks if two objects are deeply equal without using JSON.stringify.
+ * Optimized for performance by doing early exits and avoiding stringification.
+ */
+export function isDeepEqual(obj1, obj2) {
+    if (obj1 === obj2)
+        return true;
+    if (typeof obj1 !== 'object' ||
+        obj1 === null ||
+        typeof obj2 !== 'object' ||
+        obj2 === null) {
+        return false;
+    }
+    const keys1 = Object.keys(obj1);
+    const keys2 = Object.keys(obj2);
+    if (keys1.length !== keys2.length)
+        return false;
+    for (const key of keys1) {
+        if (!keys2.includes(key) || !isDeepEqual(obj1[key], obj2[key])) {
+            return false;
+        }
+    }
+    return true;
+}

package/dist/lib/utils/mobile-editor.d.ts

@@ -0,0 +1,13 @@
+/**
+ * True when the layout editor should use phone/tablet compact chrome (bottom nav, overlays).
+ * Real phones stay in mobile mode in landscape — viewport width alone is unreliable (e.g. iPhone ~844px wide).
+ */
+export declare function isMobileEditorViewport(): boolean;
+/** Inline same-document preview — avoids iframe double-runtime on mobile WebKit. */
+export declare function shouldUseInlineEditorPreview(): boolean;
+/** Touch / phone editors: single-tap inline text edit on canvas (no inspector hijack). */
+export declare function prefersInlineCanvasTextEdit(): boolean;
+export declare function isInlineCanvasTextElementKind(elementKind: string | undefined): boolean;
+/** Max logical width for desktop-layout preview on mobile inline canvas (WebKit memory). */
+export declare const MOBILE_INLINE_DESKTOP_MAX_WIDTH = 768;
+//# sourceMappingURL=mobile-editor.d.ts.map

package/dist/lib/utils/mobile-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-editor.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/mobile-editor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAUhD;AAED,oFAAoF;AACpF,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED,0FAA0F;AAC1F,wBAAgB,2BAA2B,IAAI,OAAO,CAIrD;AAED,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEtF;AAED,4FAA4F;AAC5F,eAAO,MAAM,+BAA+B,MAAM,CAAC"}

package/dist/lib/utils/mobile-editor.js

@@ -0,0 +1,34 @@
+/**
+ * True when the layout editor should use phone/tablet compact chrome (bottom nav, overlays).
+ * Real phones stay in mobile mode in landscape — viewport width alone is unreliable (e.g. iPhone ~844px wide).
+ */
+export function isMobileEditorViewport() {
+    if (typeof navigator !== 'undefined') {
+        const ua = navigator.userAgent;
+        if (/iPhone|iPod/i.test(ua))
+            return true;
+        if (/Android/i.test(ua) && /Mobile/i.test(ua))
+            return true;
+    }
+    if (typeof window !== 'undefined') {
+        return window.matchMedia('(max-width: 767px)').matches;
+    }
+    return false;
+}
+/** Inline same-document preview — avoids iframe double-runtime on mobile WebKit. */
+export function shouldUseInlineEditorPreview() {
+    return isMobileEditorViewport();
+}
+/** Touch / phone editors: single-tap inline text edit on canvas (no inspector hijack). */
+export function prefersInlineCanvasTextEdit() {
+    if (typeof window === 'undefined')
+        return false;
+    if (isMobileEditorViewport())
+        return true;
+    return window.matchMedia('(pointer: coarse)').matches;
+}
+export function isInlineCanvasTextElementKind(elementKind) {
+    return elementKind === 'plainText' || elementKind === 'richHtml';
+}
+/** Max logical width for desktop-layout preview on mobile inline canvas (WebKit memory). */
+export const MOBILE_INLINE_DESKTOP_MAX_WIDTH = 768;

package/dist/lib/utils/phone-format.d.ts

@@ -0,0 +1,6 @@
+export declare function validatePhone(value: string): boolean;
+export declare function formatPhoneInput(value: string): string;
+export declare function getPhonePlaceholder(): string;
+/** Strip spaces/dashes/parens before sending to Payaza SDK. Keeps + and digits. */
+export declare function normalizePhoneForPayaza(value: string): string;
+//# sourceMappingURL=phone-format.d.ts.map

package/dist/lib/utils/phone-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-format.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/phone-format.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKpD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/lib/utils/phone-format.js

@@ -0,0 +1,17 @@
+export function validatePhone(value) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return false;
+    const digits = trimmed.replace(/\D/g, '');
+    return digits.length >= 7 && digits.length <= 15;
+}
+export function formatPhoneInput(value) {
+    return value;
+}
+export function getPhonePlaceholder() {
+    return 'e.g. +234 801 234 5678';
+}
+/** Strip spaces/dashes/parens before sending to Payaza SDK. Keeps + and digits. */
+export function normalizePhoneForPayaza(value) {
+    return value.trim().replace(/[\s\-\(\)]/g, '');
+}

package/dist/lib/utils/product-catalog.d.ts

@@ -0,0 +1,11 @@
+import type { StoreCategory, StoreProduct, StoreService } from '../store-types';
+/**
+ * Filters out inactive or deleted products
+ * Excludes products where isActive === false OR status === 'inactive' OR status === 'draft'
+ * If isActive/status are undefined (mock data), includes the product for backward compatibility
+ */
+export declare function filterActiveProducts(products: StoreProduct[]): StoreProduct[];
+export declare function filterActiveServices(services: StoreService[]): StoreService[];
+/** Keep only categories referenced by at least one active service (avoids product categories on booking pages). */
+export declare function filterCategoriesForServices(categories: StoreCategory[] | undefined, services: StoreService[]): StoreCategory[];
+//# sourceMappingURL=product-catalog.d.ts.map

package/dist/lib/utils/product-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-catalog.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/product-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAa7E;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAa7E;AAED,mHAAmH;AACnH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,aAAa,EAAE,GAAG,SAAS,EACvC,QAAQ,EAAE,YAAY,EAAE,GACvB,aAAa,EAAE,CAIjB"}

package/dist/lib/utils/product-catalog.js

@@ -0,0 +1,40 @@
+/**
+ * Filters out inactive or deleted products
+ * Excludes products where isActive === false OR status === 'inactive' OR status === 'draft'
+ * If isActive/status are undefined (mock data), includes the product for backward compatibility
+ */
+export function filterActiveProducts(products) {
+    if (!products || !Array.isArray(products)) {
+        return [];
+    }
+    return products.filter((product) => {
+        if (product.isActive === false) {
+            return false;
+        }
+        if (product.status === 'inactive' || product.status === 'draft') {
+            return false;
+        }
+        return true;
+    });
+}
+export function filterActiveServices(services) {
+    if (!services || !Array.isArray(services)) {
+        return [];
+    }
+    return services.filter((service) => {
+        if (service.isActive === false) {
+            return false;
+        }
+        if (service.status === 'inactive' || service.status === 'draft') {
+            return false;
+        }
+        return true;
+    });
+}
+/** Keep only categories referenced by at least one active service (avoids product categories on booking pages). */
+export function filterCategoriesForServices(categories, services) {
+    if (!categories?.length || !services.length)
+        return [];
+    const categoryIds = new Set(services.map((s) => s.categoryId).filter(Boolean));
+    return categories.filter((c) => categoryIds.has(c.id));
+}

package/dist/lib/utils/product-images.d.ts

@@ -0,0 +1,20 @@
+import type { StoreProduct } from '../store-types';
+/** Neutral product placeholder for editor preview when catalog rows have no image yet. */
+export declare const EDITOR_PRODUCT_IMAGE_PLACEHOLDER = "https://images.unsplash.com/photo-1523381210434-271e8be1f52b?q=80&w=800&auto=format&fit=crop";
+/**
+ * Normalize product `images` from API/editor payloads into display-ready URL strings.
+ * Handles string[], `{ url }[]`, JSON strings, and nested shapes.
+ */
+export declare function resolveProductImageUrls(images: unknown): string[];
+export declare function getPrimaryProductImageUrl(images: unknown, options?: {
+    placeholder?: string;
+}): string | undefined;
+export declare function normalizeStoreProductForDisplay(product: StoreProduct, options?: {
+    isPreview?: boolean;
+    placeholderInPreview?: boolean;
+}): StoreProduct;
+export declare function normalizeStoreProductsForDisplay(products: StoreProduct[] | undefined, options?: {
+    isPreview?: boolean;
+    placeholderInPreview?: boolean;
+}): StoreProduct[];
+//# sourceMappingURL=product-images.d.ts.map

package/dist/lib/utils/product-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-images.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/product-images.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,0FAA0F;AAC1F,eAAO,MAAM,gCAAgC,iGACmD,CAAC;AAEjG;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAEjE;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,YAAY,CASd;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,YAAY,EAAE,GAAG,SAAS,EACpC,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAE,GAChE,YAAY,EAAE,CAGhB"}

package/dist/lib/utils/product-images.js

@@ -0,0 +1,31 @@
+import { extractImageUrls } from '../store-config-utils.js';
+/** Neutral product placeholder for editor preview when catalog rows have no image yet. */
+export const EDITOR_PRODUCT_IMAGE_PLACEHOLDER = 'https://images.unsplash.com/photo-1523381210434-271e8be1f52b?q=80&w=800&auto=format&fit=crop';
+/**
+ * Normalize product `images` from API/editor payloads into display-ready URL strings.
+ * Handles string[], `{ url }[]`, JSON strings, and nested shapes.
+ */
+export function resolveProductImageUrls(images) {
+    return extractImageUrls(images).filter((url) => typeof url === 'string' && url.trim().length > 0);
+}
+export function getPrimaryProductImageUrl(images, options) {
+    const urls = resolveProductImageUrls(images);
+    if (urls.length > 0)
+        return urls[0];
+    return options?.placeholder;
+}
+export function normalizeStoreProductForDisplay(product, options) {
+    const images = resolveProductImageUrls(product.images);
+    if (images.length > 0) {
+        return images === product.images ? product : { ...product, images };
+    }
+    if (options?.isPreview && options?.placeholderInPreview) {
+        return { ...product, images: [EDITOR_PRODUCT_IMAGE_PLACEHOLDER] };
+    }
+    return { ...product, images: [] };
+}
+export function normalizeStoreProductsForDisplay(products, options) {
+    if (!Array.isArray(products) || products.length === 0)
+        return [];
+    return products.map((product) => normalizeStoreProductForDisplay(product, options));
+}

package/dist/lib/utils/product-share.d.ts

@@ -0,0 +1,17 @@
+/** Keep only the first URL path segment of a product slug (no trailing description text). */
+export declare function sanitizeProductSlug(slug: string | undefined | null): string;
+/** Relative product page path for the current store (custom domain or platform slug). */
+export declare function getProductPagePath(storeSlug: string, productSlug: string): string;
+/** Absolute product page URL for sharing/copying. */
+export declare function getAbsoluteProductPageUrl(storeSlug: string, productSlug: string): string;
+export interface ShareProductLinkOptions {
+    storeSlug: string;
+    productSlug: string;
+    productName?: string;
+}
+/**
+ * Share or copy a product link. Only the canonical product URL is shared/copied —
+ * description or other metadata is never appended (avoids broken links on paste).
+ */
+export declare function shareProductLink({ storeSlug, productSlug, productName, }: ShareProductLinkOptions): Promise<'shared' | 'copied'>;
+//# sourceMappingURL=product-share.d.ts.map

package/dist/lib/utils/product-share.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-share.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/product-share.ts"],"names":[],"mappings":"AAEA,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAI3E;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAIjF;AAED,qDAAqD;AACrD,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAIxF;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,SAAS,EACT,WAAW,EACX,WAAW,GACZ,EAAE,uBAAuB,GAAG,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAuBxD"}

package/dist/lib/utils/product-share.js

@@ -0,0 +1,48 @@
+import { getStoreUrl } from './url-helpers.js';
+/** Keep only the first URL path segment of a product slug (no trailing description text). */
+export function sanitizeProductSlug(slug) {
+    const trimmed = (slug || '').trim();
+    if (!trimmed)
+        return '';
+    return trimmed.split(/\s+/)[0];
+}
+/** Relative product page path for the current store (custom domain or platform slug). */
+export function getProductPagePath(storeSlug, productSlug) {
+    const cleanSlug = sanitizeProductSlug(productSlug);
+    if (!cleanSlug)
+        return getStoreUrl(storeSlug, '/products');
+    return getStoreUrl(storeSlug, `/products/${encodeURIComponent(cleanSlug)}`);
+}
+/** Absolute product page URL for sharing/copying. */
+export function getAbsoluteProductPageUrl(storeSlug, productSlug) {
+    const path = getProductPagePath(storeSlug, productSlug);
+    if (typeof window === 'undefined')
+        return path;
+    return `${window.location.origin}${path}`;
+}
+/**
+ * Share or copy a product link. Only the canonical product URL is shared/copied —
+ * description or other metadata is never appended (avoids broken links on paste).
+ */
+export async function shareProductLink({ storeSlug, productSlug, productName, }) {
+    const url = getAbsoluteProductPageUrl(storeSlug, productSlug);
+    if (typeof navigator !== 'undefined' && navigator.share) {
+        try {
+            await navigator.share({
+                title: productName,
+                url,
+            });
+            return 'shared';
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw error;
+            }
+        }
+    }
+    if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
+        await navigator.clipboard.writeText(url);
+        return 'copied';
+    }
+    throw new Error('Sharing is not supported in this browser');
+}

package/dist/lib/utils/scroll-to-top.util.d.ts

@@ -0,0 +1,9 @@
+export declare const STORE_SCROLL_ROOT_SELECTOR = "[data-store-scroll-root]";
+/**
+ * Scrolls the viewport and any in-layout scroll containers to the top.
+ * Used on client-side navigation so product/detail pages start at the top on mobile.
+ */
+export declare function scrollToTop(options?: {
+    behavior?: ScrollBehavior;
+}): void;
+//# sourceMappingURL=scroll-to-top.util.d.ts.map

package/dist/lib/utils/scroll-to-top.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-to-top.util.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/scroll-to-top.util.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AAErE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,cAAc,CAAA;CAAE,GAAG,IAAI,CAczE"}

package/dist/lib/utils/scroll-to-top.util.js

@@ -0,0 +1,18 @@
+export const STORE_SCROLL_ROOT_SELECTOR = '[data-store-scroll-root]';
+/**
+ * Scrolls the viewport and any in-layout scroll containers to the top.
+ * Used on client-side navigation so product/detail pages start at the top on mobile.
+ */
+export function scrollToTop(options) {
+    if (typeof window === 'undefined')
+        return;
+    const behavior = options?.behavior ?? 'auto';
+    window.scrollTo({ top: 0, left: 0, behavior });
+    document.documentElement.scrollTop = 0;
+    document.body.scrollTop = 0;
+    document.querySelectorAll(STORE_SCROLL_ROOT_SELECTOR).forEach((element) => {
+        if (element instanceof HTMLElement) {
+            element.scrollTop = 0;
+        }
+    });
+}

package/dist/lib/utils/url-helpers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * URL helper utilities for handling both custom domain and platform domain URLs
+ */
+/**
+ * Get the store URL prefix based on whether we're on a custom domain
+ * For custom domains: returns empty string (no slug in URL)
+ * For platform domains: returns /{storeSlug}
+ *
+ * @param storeSlug - The store slug
+ * @returns The URL prefix (empty for custom domains, /{slug} for platform)
+ */
+export declare function getStoreUrlPrefix(storeSlug: string): string;
+/**
+ * Generate a store-relative URL that works for both custom and platform domains
+ *
+ * @param storeSlug - The store slug
+ * @param path - The path (e.g., '/products', '/account/orders/123')
+ * @returns The full URL path
+ */
+export declare function getStoreUrl(storeSlug: string, path: string): string;
+/**
+ * Generate a store-relative URL with query parameters
+ *
+ * @param storeSlug - The store slug
+ * @param path - The path
+ * @param queryParams - Query parameters object
+ * @returns The full URL path with query string
+ */
+export declare function getStoreUrlWithQuery(storeSlug: string, path: string, queryParams: Record<string, string | number | null | undefined>): string;
+//# sourceMappingURL=url-helpers.d.ts.map

package/dist/lib/utils/url-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/url-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAoB3D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAC9D,MAAM,CAYR"}

package/dist/lib/utils/url-helpers.js

@@ -0,0 +1,61 @@
+/**
+ * URL helper utilities for handling both custom domain and platform domain URLs
+ */
+/**
+ * Get the store URL prefix based on whether we're on a custom domain
+ * For custom domains: returns empty string (no slug in URL)
+ * For platform domains: returns /{storeSlug}
+ *
+ * @param storeSlug - The store slug
+ * @returns The URL prefix (empty for custom domains, /{slug} for platform)
+ */
+export function getStoreUrlPrefix(storeSlug) {
+    // Check if we're on a custom domain by checking if hostname doesn't match platform domains
+    if (typeof window === 'undefined') {
+        // Server-side: we can't detect custom domain here, assume platform domain
+        return `/${storeSlug}`;
+    }
+    const hostname = window.location.hostname;
+    // Platform domains include shopaza/payaza hosts — custom domains omit the store slug prefix
+    const isPlatformDomain = hostname === 'shopaza.africa' ||
+        hostname.endsWith('.shopaza.africa') ||
+        hostname === 'payaza.africa' ||
+        hostname.endsWith('.payaza.africa') ||
+        hostname.includes('store.payaza.africa') ||
+        hostname.includes('localhost') ||
+        hostname.endsWith('.vercel.app');
+    // If on platform domain, include slug. If on custom domain, no slug.
+    return isPlatformDomain ? `/${storeSlug}` : '';
+}
+/**
+ * Generate a store-relative URL that works for both custom and platform domains
+ *
+ * @param storeSlug - The store slug
+ * @param path - The path (e.g., '/products', '/account/orders/123')
+ * @returns The full URL path
+ */
+export function getStoreUrl(storeSlug, path) {
+    const prefix = getStoreUrlPrefix(storeSlug);
+    // Ensure path starts with /
+    const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+    return `${prefix}${normalizedPath}`;
+}
+/**
+ * Generate a store-relative URL with query parameters
+ *
+ * @param storeSlug - The store slug
+ * @param path - The path
+ * @param queryParams - Query parameters object
+ * @returns The full URL path with query string
+ */
+export function getStoreUrlWithQuery(storeSlug, path, queryParams) {
+    const baseUrl = getStoreUrl(storeSlug, path);
+    const params = new URLSearchParams();
+    Object.entries(queryParams).forEach(([key, value]) => {
+        if (value !== null && value !== undefined) {
+            params.append(key, String(value));
+        }
+    });
+    const queryString = params.toString();
+    return queryString ? `${baseUrl}?${queryString}` : baseUrl;
+}

package/dist/lib/utils/video-helpers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Video platform detection and URL conversion utilities
+ */
+export type VideoPlatform = 'youtube' | 'vimeo' | 'instagram' | 'tiktok' | 'direct' | 'unknown';
+export interface VideoInfo {
+    platform: VideoPlatform;
+    videoId?: string;
+    embedUrl?: string;
+    directUrl?: string;
+    thumbnailUrl?: string;
+}
+/**
+ * Detects the video platform from a URL
+ */
+export declare function detectVideoPlatform(url: string): VideoPlatform;
+/**
+ * Parses a video URL and returns platform information
+ */
+export declare function parseVideoUrl(url: string): VideoInfo;
+/**
+ * Gets embed URL for background video (autoplay, muted, loop, no controls)
+ */
+export declare function getBackgroundVideoEmbedUrl(url: string): string | null;
+/**
+ * Gets embed URL for embedded video (with controls, no autoplay by default)
+ */
+export declare function getEmbedVideoUrl(url: string, autoplay?: boolean): string | null;
+/**
+ * Checks if a URL is a video URL (any platform)
+ */
+export declare function isVideoUrl(url: string): boolean;
+//# sourceMappingURL=video-helpers.d.ts.map

package/dist/lib/utils/video-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/video-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhG,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAoC9D;AAkFD;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAuEpD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAe,GAAG,MAAM,GAAG,IAAI,CAoBtF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG/C"}