@seekora-ai/ui-sdk-react 0.2.11 → 0.2.13

package/dist/docsearch/components/Results.js

@@ -79,7 +79,7 @@ function getHitKey(hit, index) {
         return hit.objectID;
     return `suggestion-${hit.url}-${index}`;
 }
-export function Results({ hits, groupedHits, selectedIndex, onSelect, onHover, scrollSelectionIntoViewRef, query, isLoading, error, translations = {}, sources: _sources = [], }) {
+export function Results({ hits, groupedHits, selectedIndex, onSelect, onHover, scrollSelectionIntoViewRef, query, isLoading, showLoadingState = false, error, translations = {}, sources: _sources = [], }) {
     void _sources;
     const listRef = useRef(null);
     useEffect(() => {
@@ -114,7 +114,7 @@ export function Results({ hits, groupedHits, selectedIndex, onSelect, onHover, s
         return (React.createElement("div", { className: "seekora-docsearch-empty" },
             React.createElement("p", { className: "seekora-docsearch-empty-text" }, translations.searchPlaceholder || 'Type to start searching...')));
     }
-    if (isLoading && hits.length === 0) {
+    if (isLoading && hits.length === 0 && showLoadingState) {
         return (React.createElement("div", { className: "seekora-docsearch-loading" },
             React.createElement("div", { className: "seekora-docsearch-loading-spinner" },
                 React.createElement("svg", { width: "24", height: "24", viewBox: "0 0 24 24", "aria-hidden": "true" },
@@ -122,6 +122,10 @@ export function Results({ hits, groupedHits, selectedIndex, onSelect, onHover, s
                         React.createElement("animateTransform", { attributeName: "transform", type: "rotate", from: "0 12 12", to: "360 12 12", dur: "0.8s", repeatCount: "indefinite" })))),
             React.createElement("p", { className: "seekora-docsearch-loading-text" }, translations.loadingText || 'Searching...')));
     }
+    if (isLoading && hits.length === 0) {
+        return React.createElement("div", { className: "seekora-docsearch-empty" });
+    }
+    // When loading with previous hits, fall through and show them (no loading screen)
     if (error) {
         return (React.createElement("div", { className: "seekora-docsearch-error" },
             React.createElement("p", { className: "seekora-docsearch-error-text" }, translations.errorText || error)));

package/dist/hooks/useProductAnalytics.d.ts

@@ -0,0 +1,49 @@
+/**
+ * useProductAnalytics – analytics event binding hook for custom components
+ *
+ * Returns event handler props ready to spread onto any element, plus imperative
+ * tracking methods. Builds on existing useAnalytics infrastructure.
+ */
+import type { SeekoraClient, SearchContext } from '@seekora-ai/search-sdk';
+import type { ProductItem, ProductVariant } from '@seekora-ai/ui-sdk-types';
+export interface UseProductAnalyticsOptions {
+    client: SeekoraClient;
+    product: ProductItem;
+    position?: number;
+    section?: string;
+    tabId?: string;
+    query?: string;
+    context?: SearchContext | Partial<SearchContext>;
+    enabled?: boolean;
+}
+export interface UseProductAnalyticsReturn {
+    /** Spread onto any clickable element to track product click */
+    clickProps: {
+        onClick: (e?: React.MouseEvent) => void;
+        'data-seekora-product-id': string;
+        'data-seekora-position': number;
+    };
+    /** Spread onto any element to track variant selection */
+    variantSelectProps: (optionName: string, value: string) => {
+        onClick: (e?: React.MouseEvent) => void;
+        'data-seekora-variant-option': string;
+        'data-seekora-variant-value': string;
+    };
+    /** Spread onto any element to track add-to-cart */
+    addToCartProps: (variant?: ProductVariant) => {
+        onClick: (e?: React.MouseEvent) => void;
+        'data-seekora-action': 'add-to-cart';
+    };
+    /** Spread onto any element to track impression (uses IntersectionObserver) */
+    impressionRef: React.RefCallback<HTMLElement>;
+    /** Imperative: track product click */
+    trackClick: () => void;
+    /** Imperative: track variant select */
+    trackVariantSelect: (optionName: string, value: string) => void;
+    /** Imperative: track add to cart */
+    trackAddToCart: (variant?: ProductVariant) => void;
+    /** Imperative: track custom event with product context */
+    trackCustomEvent: (eventName: string, metadata?: Record<string, any>) => void;
+}
+export declare function useProductAnalytics({ client, product, position, section, tabId, query, context, enabled, }: UseProductAnalyticsOptions): UseProductAnalyticsReturn;
+//# sourceMappingURL=useProductAnalytics.d.ts.map

package/dist/hooks/useProductAnalytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useProductAnalytics.d.ts","sourceRoot":"","sources":["../../src/hooks/useProductAnalytics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG5E,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,+DAA+D;IAC/D,UAAU,EAAE;QACV,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;QACxC,yBAAyB,EAAE,MAAM,CAAC;QAClC,uBAAuB,EAAE,MAAM,CAAC;KACjC,CAAC;IACF,yDAAyD;IACzD,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK;QACzD,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;QACxC,6BAA6B,EAAE,MAAM,CAAC;QACtC,4BAA4B,EAAE,MAAM,CAAC;KACtC,CAAC;IACF,mDAAmD;IACnD,cAAc,EAAE,CAAC,OAAO,CAAC,EAAE,cAAc,KAAK;QAC5C,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;QACxC,qBAAqB,EAAE,aAAa,CAAC;KACtC,CAAC;IACF,8EAA8E;IAC9E,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAC9C,sCAAsC;IACtC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,uCAAuC;IACvC,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,oCAAoC;IACpC,cAAc,EAAE,CAAC,OAAO,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IACnD,0DAA0D;IAC1D,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;CAC/E;AAED,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,OAAO,EACP,QAAY,EACZ,OAAO,EACP,KAAK,EACL,KAAK,EACL,OAAO,EACP,OAAc,GACf,EAAE,0BAA0B,GAAG,yBAAyB,CAyIxD"}

package/dist/hooks/useProductAnalytics.js

@@ -0,0 +1,116 @@
+/**
+ * useProductAnalytics – analytics event binding hook for custom components
+ *
+ * Returns event handler props ready to spread onto any element, plus imperative
+ * tracking methods. Builds on existing useAnalytics infrastructure.
+ */
+import { useCallback, useRef, useEffect } from 'react';
+import { log } from '@seekora-ai/ui-sdk-core';
+export function useProductAnalytics({ client, product, position = 0, section, tabId, query, context, enabled = true, }) {
+    const impressionTrackedRef = useRef(false);
+    const observerRef = useRef(null);
+    const elementRef = useRef(null);
+    const productId = product.id || product.objectID || '';
+    const sendEvent = useCallback(async (eventName, metadata) => {
+        if (!enabled || !client)
+            return;
+        try {
+            await client.trackEvent?.({
+                event_name: eventName,
+                metadata: {
+                    product_id: productId,
+                    product_title: product.title || product.name,
+                    product_price: product.price,
+                    position,
+                    section,
+                    tab_id: tabId,
+                    original_query: query,
+                    timestamp: Date.now(),
+                    source: 'product_analytics',
+                    ...metadata,
+                },
+            }, context);
+            log.verbose(`ProductAnalytics: ${eventName}`, metadata);
+        }
+        catch (error) {
+            log.warn(`Failed to track ${eventName}`, { error });
+        }
+    }, [client, enabled, productId, product, position, section, tabId, query, context]);
+    const trackClick = useCallback(() => {
+        sendEvent('product.click', {});
+        // Also fire via client.trackClick for V3 compat
+        if (client?.trackClick) {
+            Promise.resolve(client.trackClick(productId, position + 1, context)).catch(() => { });
+        }
+    }, [sendEvent, client, productId, position, context]);
+    const trackVariantSelect = useCallback((optionName, value) => {
+        sendEvent('product.variant_select', {
+            option_name: optionName,
+            option_value: value,
+        });
+    }, [sendEvent]);
+    const trackAddToCart = useCallback((variant) => {
+        sendEvent('product.add_to_cart', {
+            variant_id: variant?.id,
+            variant_sku: variant?.sku,
+            variant_title: variant?.title,
+            variant_price: variant?.price,
+        });
+    }, [sendEvent]);
+    const trackCustomEvent = useCallback((eventName, metadata) => {
+        sendEvent(eventName, metadata ?? {});
+    }, [sendEvent]);
+    // Impression tracking via IntersectionObserver
+    const impressionRef = useCallback((node) => {
+        // Cleanup previous observer
+        if (observerRef.current) {
+            observerRef.current.disconnect();
+            observerRef.current = null;
+        }
+        elementRef.current = node;
+        if (!node || !enabled || impressionTrackedRef.current)
+            return;
+        if (typeof IntersectionObserver === 'undefined')
+            return;
+        observerRef.current = new IntersectionObserver((entries) => {
+            for (const entry of entries) {
+                if (entry.isIntersecting && !impressionTrackedRef.current) {
+                    impressionTrackedRef.current = true;
+                    sendEvent('product.impression', {});
+                    observerRef.current?.disconnect();
+                }
+            }
+        }, { threshold: 0.5 });
+        observerRef.current.observe(node);
+    }, [enabled, sendEvent]);
+    // Cleanup on unmount
+    useEffect(() => {
+        return () => {
+            observerRef.current?.disconnect();
+        };
+    }, []);
+    const clickProps = {
+        onClick: () => trackClick(),
+        'data-seekora-product-id': productId,
+        'data-seekora-position': position,
+    };
+    const variantSelectProps = (optionName, value) => ({
+        onClick: () => trackVariantSelect(optionName, value),
+        'data-seekora-variant-option': optionName,
+        'data-seekora-variant-value': value,
+    });
+    const addToCartProps = (variant) => ({
+        onClick: () => trackAddToCart(variant),
+        'data-seekora-action': 'add-to-cart',
+    });
+    return {
+        clickProps,
+        variantSelectProps,
+        addToCartProps,
+        impressionRef,
+        trackClick,
+        trackVariantSelect,
+        trackAddToCart,
+        trackCustomEvent,
+    };
+}

package/dist/hooks/useQuerySuggestionsEnhanced.js

@@ -97,7 +97,8 @@ function transformFilteredTab(raw) {
 // Main Hook
 // ============================================================================
 export function useQuerySuggestionsEnhanced(options) {
-    const { client, query, enabled = true, debounceMs = 200, maxSuggestions = 10, minQueryLength = 1, includeDropdownRecommendations = false, includeDropdownProductList = true, includeFilteredTabs = true, includeCategories = true, includeFacets = false, maxCategories = 3, maxFacets = 5, filteredTabs, minPopularity, timeRange, disableTypoTolerance, analyticsTags, enableRecentSearches = true, maxRecentSearches = MAX_RECENT_SEARCHES_DEFAULT, recentSearchesKey = RECENT_SEARCHES_DEFAULT_KEY, onSuggestionsLoaded, onError, } = options;
+    const { client, query, enabled = true, debounceMs = 200, maxSuggestions = 10, minQueryLength = 1, includeDropdownRecommendations = false, includeDropdownProductList = true, includeFilteredTabs = true, includeCategories = true, includeFacets = true, // CHANGED: Enable facets by default
+    maxCategories = 3, maxFacets = 5, filteredTabs, minPopularity, timeRange, disableTypoTolerance, analyticsTags, enableRecentSearches = true, maxRecentSearches = MAX_RECENT_SEARCHES_DEFAULT, recentSearchesKey = RECENT_SEARCHES_DEFAULT_KEY, onSuggestionsLoaded, onError, } = options;
     // State
     const [suggestions, setSuggestions] = useState([]);
     const [loading, setLoading] = useState(false);

package/dist/hooks/useSuggestionsAnalytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSuggestionsAnalytics.d.ts","sourceRoot":"","sources":["../../src/hooks/useSuggestionsAnalytics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useSuggestionsAnalytics.d.ts","sourceRoot":"","sources":["../../src/hooks/useSuggestionsAnalytics.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useSuggestionsAnalytics.js

@@ -25,6 +25,12 @@ const EVENTS = {
     SEARCH_SUBMIT: 'suggestions.search_submit',
     DROPDOWN_OPEN: 'suggestions.dropdown_open',
     DROPDOWN_CLOSE: 'suggestions.dropdown_close',
+    // Variant & product interaction events
+    VARIANT_SELECT: 'product.variant_select',
+    VARIANT_HOVER: 'product.variant_hover',
+    ADD_TO_CART: 'product.add_to_cart',
+    PRODUCT_IMPRESSION: 'product.impression',
+    SWATCH_CLICK: 'product.swatch_click',
 };
 // ============================================================================
 // Hook Implementation

package/dist/hooks/useVariantSelection.d.ts

@@ -0,0 +1,28 @@
+/**
+ * useVariantSelection – manages variant selection state
+ *
+ * Single source of truth for variant interactions on product pages.
+ * Cards display variants passively; product pages use this hook.
+ */
+import type { ProductOption, ProductVariant } from '@seekora-ai/ui-sdk-types';
+export interface UseVariantSelectionOptions {
+    options?: ProductOption[];
+    variants?: ProductVariant[];
+    initialSelections?: Record<string, string>;
+    onVariantChange?: (variant: ProductVariant | null, selections: Record<string, string>) => void;
+}
+export interface UseVariantSelectionReturn {
+    selections: Record<string, string>;
+    setSelection: (optionName: string, value: string) => void;
+    resetSelections: () => void;
+    selectedVariant: ProductVariant | null;
+    availableValues: Record<string, {
+        value: string;
+        available: boolean;
+    }[]>;
+    isComplete: boolean;
+    effectivePrice: number | null;
+    effectiveComparePrice: number | null;
+}
+export declare function useVariantSelection({ options, variants, initialSelections, onVariantChange, }?: UseVariantSelectionOptions): UseVariantSelectionReturn;
+//# sourceMappingURL=useVariantSelection.d.ts.map

package/dist/hooks/useVariantSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVariantSelection.d.ts","sourceRoot":"","sources":["../../src/hooks/useVariantSelection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG9E,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;CAChG;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,eAAe,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC,CAAC;IACzE,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,wBAAgB,mBAAmB,CAAC,EAClC,OAAY,EACZ,QAAa,EACb,iBAAsB,EACtB,eAAe,GAChB,GAAE,0BAA+B,GAAG,yBAAyB,CAwD7D"}

package/dist/hooks/useVariantSelection.js

@@ -0,0 +1,44 @@
+/**
+ * useVariantSelection – manages variant selection state
+ *
+ * Single source of truth for variant interactions on product pages.
+ * Cards display variants passively; product pages use this hook.
+ */
+import { useState, useMemo, useCallback } from 'react';
+import { findVariantBySelections, getAvailableValuesForOption } from '../components/suggestions/utils';
+export function useVariantSelection({ options = [], variants = [], initialSelections = {}, onVariantChange, } = {}) {
+    const [selections, setSelections] = useState(initialSelections);
+    const selectedVariant = useMemo(() => findVariantBySelections(options, variants, selections), [options, variants, selections]);
+    const isComplete = useMemo(() => options.length > 0 && options.every((opt) => !!selections[opt.name]), [options, selections]);
+    const availableValues = useMemo(() => {
+        const result = {};
+        for (const option of options) {
+            result[option.name] = getAvailableValuesForOption(option.name, options, variants, selections);
+        }
+        return result;
+    }, [options, variants, selections]);
+    const effectivePrice = selectedVariant?.price ?? null;
+    const effectiveComparePrice = selectedVariant?.comparePrice ?? null;
+    const setSelection = useCallback((optionName, value) => {
+        setSelections((prev) => {
+            const next = { ...prev, [optionName]: value };
+            const variant = findVariantBySelections(options, variants, next);
+            onVariantChange?.(variant, next);
+            return next;
+        });
+    }, [options, variants, onVariantChange]);
+    const resetSelections = useCallback(() => {
+        setSelections({});
+        onVariantChange?.(null, {});
+    }, [onVariantChange]);
+    return {
+        selections,
+        setSelection,
+        resetSelections,
+        selectedVariant,
+        availableValues,
+        isComplete,
+        effectivePrice,
+        effectiveComparePrice,
+    };
+}

package/dist/index.d.ts

@@ -29,8 +29,8 @@ export { FederatedDropdown } from './components/FederatedDropdown';
 export { SearchBarWithSuggestions } from './components/SearchBarWithSuggestions';
 export { SuggestionsProvider, useSuggestionsContext, SearchInput, DropdownPanel, SuggestionList, SuggestionItem, ItemCard, ItemGrid, ProductCard, ProductGrid, CategoriesTabs, SuggestionsLoading, SuggestionsError, SuggestionsDropdownComposition, RecentSearchesList, TrendingList, parseHighlightMarkup, } from './components/suggestions-primitives';
 export type { SuggestionsDropdownCompositionProps, RecentSearchesListProps, TrendingListProps, SuggestionsContextValue, SuggestionsProviderProps, SearchInputProps, DropdownPanelProps, SuggestionListProps, SuggestionItemProps, HighlightMarkupOptions, GenericItem, ItemCardProps, ItemGridProps, ProductCardProps, ProductGridProps, CategoriesTabsProps, SuggestionsLoadingProps, SuggestionsErrorProps, ItemCardImageVariant, ProductCardImageVariant, } from './components/suggestions-primitives';
-export { ImageDisplay } from './components/primitives';
-export type { ImageDisplayVariant, ImageDisplayProps } from './components/primitives';
+export { ImageDisplay, ImageZoom, PriceDisplay, BadgeList, RatingDisplay, VariantSwatches, VariantSelector, ActionButtons, withAnalytics, AnalyticsProvider, useAnalyticsProvider, } from './components/primitives';
+export type { ImageDisplayVariant, ImageDisplayProps, ImageZoomProps, ImageZoomMode, PriceDisplayProps, BadgeListProps, RatingDisplayProps, RatingVariant, RatingSize, VariantSwatchesProps, VariantSelectorProps, ActionButtonsProps, ActionButton, ActionButtonType, WithAnalyticsConfig, WithAnalyticsInjectedProps, AnalyticsProviderProps, } from './components/primitives';
 export { SectionSearchProvider, useSectionSearchContext, SectionItemGrid, SectionLoading, SectionError, } from './components/section-primitives';
 export type { SectionSearchProviderProps, SectionSearchContextValue, RefinementInput, SectionItemGridProps, SectionLoadingProps, SectionErrorProps, } from './components/section-primitives';
 export { ProductGallery, ProductInfo, ProductRecommendations } from './components/product-page';
@@ -55,10 +55,12 @@ export { useAnalytics } from './hooks/useAnalytics';
 export { useSearchState } from './hooks/useSearchState';
 export { useSmartSuggestions } from './hooks/useSmartSuggestions';
 export { useNaturalLanguageFilters, formatParsedFilters } from './hooks/useNaturalLanguageFilters';
+export { useVariantSelection } from './hooks/useVariantSelection';
+export { useProductAnalytics } from './hooks/useProductAnalytics';
 export { Fingerprint, getFingerprint, type FingerprintConfig, type FingerprintResult, type FingerprintComponents, } from '@seekora-ai/ui-sdk-core';
 export type { SearchBarProps, SearchBarTheme, } from './components/SearchBar';
 export type { SearchResultsProps, SearchResultsTheme } from './components/SearchResults';
-export type { ResultItem, FieldMapping, ViewMode } from '@seekora-ai/ui-sdk-types';
+export type { ResultItem, FieldMapping, ViewMode, ProductOption, ProductVariant, ProductBadge, PriceRange, } from '@seekora-ai/ui-sdk-types';
 export type { QuerySuggestionsProps, QuerySuggestionsTheme, } from './components/QuerySuggestions';
 export type { QuerySuggestionsDropdownProps, QuerySuggestionsDropdownRef, } from './components/QuerySuggestionsDropdown';
 export type { RichQuerySuggestionsProps, RichQuerySuggestionsRef, } from './components/RichQuerySuggestions';
@@ -78,6 +80,8 @@ export type { UseAnalyticsOptions, UseAnalyticsReturn, AnalyticsEventPayload, }
 export type { UseQuerySuggestionsEnhancedOptions, UseQuerySuggestionsEnhancedReturn, NavigableItem, } from './hooks/useQuerySuggestionsEnhanced';
 export type { UseSuggestionsAnalyticsOptions, UseSuggestionsAnalyticsReturn, SuggestionClickEventData, ProductClickEventData, SuggestionImpressionEventData, } from './hooks/useSuggestionsAnalytics';
 export type { SmartSuggestion, SmartSuggestionsOptions, UseSmartSuggestionsReturn, } from './hooks/useSmartSuggestions';
+export type { UseVariantSelectionOptions, UseVariantSelectionReturn, } from './hooks/useVariantSelection';
+export type { UseProductAnalyticsOptions, UseProductAnalyticsReturn, } from './hooks/useProductAnalytics';
 export type { ParsedFilter, NaturalLanguageResult, NaturalLanguageFiltersOptions, } from './hooks/useNaturalLanguageFilters';
 export type { Theme, ThemeConfig, } from './themes/types';
 export { defaultTheme } from './themes/default';
@@ -89,4 +93,5 @@ export { createTheme } from './themes/createTheme';
 export { mergeThemes } from './themes/mergeThemes';
 export { getSuggestionsCache, createSuggestionsCache, clearSuggestionsCache, } from './components/suggestions/utils';
 export type { SuggestionsCache } from './components/suggestions/utils';
+export { extractBadges, getPriceRange, formatPriceRange, getAvailableValuesForOption, findVariantBySelections, } from './components/suggestions/utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -37,7 +37,7 @@ export { SearchBarWithSuggestions } from './components/SearchBarWithSuggestions'
 // Composable Suggestions Primitives (generic + product-specific)
 // ============================================================================
 export { SuggestionsProvider, useSuggestionsContext, SearchInput, DropdownPanel, SuggestionList, SuggestionItem, ItemCard, ItemGrid, ProductCard, ProductGrid, CategoriesTabs, SuggestionsLoading, SuggestionsError, SuggestionsDropdownComposition, RecentSearchesList, TrendingList, parseHighlightMarkup, } from './components/suggestions-primitives';
-export { ImageDisplay } from './components/primitives';
+export { ImageDisplay, ImageZoom, PriceDisplay, BadgeList, RatingDisplay, VariantSwatches, VariantSelector, ActionButtons, withAnalytics, AnalyticsProvider, useAnalyticsProvider, } from './components/primitives';
 export { SectionSearchProvider, useSectionSearchContext, SectionItemGrid, SectionLoading, SectionError, } from './components/section-primitives';
 export { ProductGallery, ProductInfo, ProductRecommendations } from './components/product-page';
 // ============================================================================
@@ -81,6 +81,8 @@ export { useAnalytics } from './hooks/useAnalytics';
 export { useSearchState } from './hooks/useSearchState';
 export { useSmartSuggestions } from './hooks/useSmartSuggestions';
 export { useNaturalLanguageFilters, formatParsedFilters } from './hooks/useNaturalLanguageFilters';
+export { useVariantSelection } from './hooks/useVariantSelection';
+export { useProductAnalytics } from './hooks/useProductAnalytics';
 // ============================================================================
 // Fingerprinting (from core - visitor ID for analytics/identity)
 // ============================================================================
@@ -102,3 +104,5 @@ export { createTheme } from './themes/createTheme';
 export { mergeThemes } from './themes/mergeThemes';
 // Cache utilities for suggestions
 export { getSuggestionsCache, createSuggestionsCache, clearSuggestionsCache, } from './components/suggestions/utils';
+// Variant utilities
+export { extractBadges, getPriceRange, formatPriceRange, getAvailableValuesForOption, findVariantBySelections, } from './components/suggestions/utils';