@seekora-ai/ui-sdk-react 0.0.0-stage-20260517092419

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

@@ -0,0 +1,105 @@
+/**
+ * Seekora UI SDK
+ *
+ * Main entry point for the UI Components Library
+ */
+export { SearchBar } from './components/SearchBar';
+export { SearchResults } from './components/SearchResults';
+export { SearchProvider, useSearchContext } from './components/SearchProvider';
+export { Stats } from './components/Stats';
+export { Pagination } from './components/Pagination';
+export type { PaginationProps, PaginationTheme, } from './components/Pagination';
+export { SortBy } from './components/SortBy';
+export type { SortByProps, SortByTheme, SortOption, SortByVariant, SortBySize, } from './components/SortBy';
+export { Facets } from './components/Facets';
+export type { FacetsProps, FacetsTheme, Facet, FacetItem, FacetStats, FacetRangeItem, FacetRangeConfig, FacetVariant, FacetSize, } from './components/Facets';
+export { FacetDropdown } from './components/FacetDropdown';
+export type { FacetDropdownProps, FacetDropdownOption, FacetDropdownTheme, } from './components/FacetDropdown';
+export { CurrentRefinements } from './components/CurrentRefinements';
+export { ClearRefinements } from './components/ClearRefinements';
+export { SearchLayout } from './components/SearchLayout';
+export { RangeInput } from './components/RangeInput';
+export { HitsPerPage } from './components/HitsPerPage';
+export { InfiniteHits } from './components/InfiniteHits';
+export { Highlight, Snippet } from './components/Highlight';
+export { HierarchicalMenu } from './components/HierarchicalMenu';
+export { RangeSlider } from './components/RangeSlider';
+export { Breadcrumb } from './components/Breadcrumb';
+export { MobileFilters, MobileFiltersButton } from './components/MobileFilters';
+export { RelatedProducts, TrendingItems, FrequentlyBoughtTogether, RecentlyViewed, addToRecentlyViewed, } from './components/Recommendations';
+export { QuerySuggestions } from './components/QuerySuggestions';
+export { QuerySuggestionsDropdown } from './components/QuerySuggestionsDropdown';
+export { RichQuerySuggestions } from './components/RichQuerySuggestions';
+export { FederatedDropdown } from './components/FederatedDropdown';
+export { SearchBarWithSuggestions } from './components/SearchBarWithSuggestions';
+export { SuggestionsProvider, useSuggestionsContext, SearchInput, DropdownPanel, SuggestionList, SuggestionItem, ItemCard, ItemGrid, ProductCard, ProductGrid, CategoriesTabs, 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, SuggestionsErrorProps, ItemCardImageVariant, ProductCardImageVariant, } from './components/suggestions-primitives';
+export { ImageDisplay, ImageZoom, PriceDisplay, BadgeList, RatingDisplay, VariantSwatches, VariantSelector, ActionButtons, withAnalytics, AnalyticsProvider, useAnalyticsProvider, CustomSelect, } from './components/primitives';
+export type { ImageDisplayVariant, ImageDisplayProps, ImageZoomProps, ImageZoomMode, PriceDisplayProps, BadgeListProps, RatingDisplayProps, RatingVariant, RatingSize, VariantSwatchesProps, VariantSelectorProps, ActionButtonsProps, ActionButton, ActionButtonType, WithAnalyticsConfig, WithAnalyticsInjectedProps, AnalyticsProviderProps, CustomSelectProps, CustomSelectOption, CustomSelectTheme, } from './components/primitives';
+export { SectionSearchProvider, useSectionSearchContext, SectionItemGrid, SectionError, } from './components/section-primitives';
+export type { SectionSearchProviderProps, SectionSearchContextValue, RefinementInput, SectionItemGridProps, SectionErrorProps, } from './components/section-primitives';
+export { ProductGallery, ProductInfo, ProductRecommendations } from './components/product-page';
+export type { ProductGalleryProps, ProductInfoProps, ProductRecommendationsProps } from './components/product-page';
+export { SuggestionSearchBar, // All-in-one: input + dropdown + data fetching
+type SuggestionSearchBarProps, type SuggestionSearchBarRef, } from './components/suggestions';
+export { AmazonDropdown, // Amazon-style with department scoping
+GoogleDropdown, // Google-style clean search
+PinterestDropdown, // Visual discovery style
+SpotlightDropdown, // macOS Spotlight / Command palette
+ShopifyDropdown, // Modern e-commerce
+MobileSheetDropdown, // Mobile-first bottom sheet
+MinimalDropdown, // Ultra-clean editorial style
+SuggestionDropdownVariants, type SuggestionDropdownVariant, type BaseDropdownProps, type DropdownRef, type SuggestionFieldMapping, type ProductFieldMapping, type CategoryFieldMapping, type BrandFieldMapping, type SectionConfig, type ProductDisplayConfig, type SuggestionDisplayConfig, type DropdownThemeConfig, type AnalyticsConfig, type DropdownEventHandlers, type DropdownClassNames, extractSuggestion, extractProduct, extractCategory, extractBrand, formatPrice as formatSuggestionPrice, highlightText, getRecentSearches, addRecentSearch, removeRecentSearch, clearRecentSearches, useResponsive, breakpoints, mediaQueries, touchTargets, injectGlobalResponsiveStyles, useInjectResponsiveStyles, type ResponsiveState, } from './components/suggestions';
+export { DocSearch, DocSearchButton, useDocSearch, useKeyboard, getShortcutText, useSeekoraSearch as useDocSearchSeekoraSearch, } from './docsearch';
+export type { DocSearchProps, DocSearchButtonProps, DocSearchHit, DocSearchSuggestion, DocSearchResponse, DocSearchSuggestionsResponse, DocSearchTranslations, DocSearchState, DocSearchAction, SearchSource, UseSeekoraSearchOptions as UseDocSearchSeekoraSearchOptions, UseSeekoraSearchResult as UseDocSearchSeekoraSearchResult, } from './docsearch';
+export { useSeekoraSearch } from './hooks/useSeekoraSearch';
+export { useQuerySuggestions } from './hooks/useQuerySuggestions';
+export { useQuerySuggestionsEnhanced } from './hooks/useQuerySuggestionsEnhanced';
+export { useSuggestionsAnalytics } from './hooks/useSuggestionsAnalytics';
+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 { useFilters } from './hooks/useFilters';
+export type { UseFiltersOptions, UseFiltersReturn } from './hooks/useFilters';
+export { Fingerprint, getFingerprint, type FingerprintConfig, type FingerprintResult, type FingerprintComponents, } from '@seekora-ai/ui-sdk-core';
+export type { SearchBarProps, SearchBarTheme, SearchBarSize, } from './components/SearchBar';
+export type { SearchResultsProps, SearchResultsTheme } from './components/SearchResults';
+export type { ResultItem, FieldMapping, ViewMode, ProductOption, ProductVariant, ProductBadge, PriceRange, } from '@seekora-ai/ui-sdk-types';
+export type { FilterOptions, FacetSearchOptions, FilterValue, FilterStats, FilterField, FiltersResponse, FacetValuesSearchResponse, FilterSchemaField, FiltersSchemaResponse, } from '@seekora-ai/search-sdk';
+export type { QuerySuggestionsProps, QuerySuggestionsTheme, } from './components/QuerySuggestions';
+export type { QuerySuggestionsDropdownProps, QuerySuggestionsDropdownRef, } from './components/QuerySuggestionsDropdown';
+export type { RichQuerySuggestionsProps, RichQuerySuggestionsRef, } from './components/RichQuerySuggestions';
+export type { FederatedDropdownProps, FederatedDropdownRef, } from './components/FederatedDropdown';
+export type { SearchBarWithSuggestionsProps, SearchBarWithSuggestionsRef, } from './components/SearchBarWithSuggestions';
+export type { SearchProviderProps, } from './components/SearchProvider';
+export type { ClearRefinementsProps, ClearRefinementsTheme, } from './components/ClearRefinements';
+export type { HitsPerPageProps, HitsPerPageTheme, HitsPerPageItem, } from './components/HitsPerPage';
+export type { InfiniteHitsProps, InfiniteHitsTheme, } from './components/InfiniteHits';
+export type { HighlightProps, HighlightTheme, SnippetProps, SnippetTheme, } from './components/Highlight';
+export type { HierarchicalMenuProps, HierarchicalMenuTheme, HierarchicalMenuItem, } from './components/HierarchicalMenu';
+export type { RangeSliderProps, RangeSliderTheme, } from './components/RangeSlider';
+export type { BreadcrumbProps, BreadcrumbTheme, BreadcrumbItem, } from './components/Breadcrumb';
+export type { MobileFiltersProps, MobileFiltersTheme, MobileFiltersButtonProps, } from './components/MobileFilters';
+export type { RelatedProductsProps, TrendingItemsProps, FrequentlyBoughtTogetherProps, RecentlyViewedProps, RecommendationItem, RecommendationTheme, } from './components/Recommendations';
+export type { UseAnalyticsOptions, UseAnalyticsReturn, AnalyticsEventPayload, } from './hooks/useAnalytics';
+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';
+export { darkTheme } from './themes/dark';
+export { minimalTheme } from './themes/minimal';
+export { lightThemeVariables, darkThemeVariables, minimalThemeVariables, brandPresets, createSuggestionsTheme, generateSuggestionsStylesheet, injectSuggestionsStyles, updateSuggestionsStyles, } from './themes/suggestions';
+export type { SuggestionsThemeVariables } from './themes/suggestions';
+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

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

package/dist/index.js

@@ -0,0 +1,110 @@
+/**
+ * Seekora UI SDK
+ *
+ * Main entry point for the UI Components Library
+ */
+// ============================================================================
+// Core Components
+// ============================================================================
+export { SearchBar } from './components/SearchBar';
+export { SearchResults } from './components/SearchResults';
+export { SearchProvider, useSearchContext } from './components/SearchProvider';
+export { Stats } from './components/Stats';
+export { Pagination } from './components/Pagination';
+export { SortBy } from './components/SortBy';
+export { Facets } from './components/Facets';
+export { FacetDropdown } from './components/FacetDropdown';
+export { CurrentRefinements } from './components/CurrentRefinements';
+export { ClearRefinements } from './components/ClearRefinements';
+export { SearchLayout } from './components/SearchLayout';
+export { RangeInput } from './components/RangeInput';
+export { HitsPerPage } from './components/HitsPerPage';
+export { InfiniteHits } from './components/InfiniteHits';
+export { Highlight, Snippet } from './components/Highlight';
+export { HierarchicalMenu } from './components/HierarchicalMenu';
+export { RangeSlider } from './components/RangeSlider';
+export { Breadcrumb } from './components/Breadcrumb';
+export { MobileFilters, MobileFiltersButton } from './components/MobileFilters';
+export { RelatedProducts, TrendingItems, FrequentlyBoughtTogether, RecentlyViewed, addToRecentlyViewed, } from './components/Recommendations';
+// ============================================================================
+// Query Suggestions Components
+// ============================================================================
+export { QuerySuggestions } from './components/QuerySuggestions';
+export { QuerySuggestionsDropdown } from './components/QuerySuggestionsDropdown';
+export { RichQuerySuggestions } from './components/RichQuerySuggestions';
+export { FederatedDropdown } from './components/FederatedDropdown';
+export { SearchBarWithSuggestions } from './components/SearchBarWithSuggestions';
+// ============================================================================
+// Composable Suggestions Primitives (generic + product-specific)
+// ============================================================================
+export { SuggestionsProvider, useSuggestionsContext, SearchInput, DropdownPanel, SuggestionList, SuggestionItem, ItemCard, ItemGrid, ProductCard, ProductGrid, CategoriesTabs, SuggestionsError, SuggestionsDropdownComposition, RecentSearchesList, TrendingList, parseHighlightMarkup, } from './components/suggestions-primitives';
+export { ImageDisplay, ImageZoom, PriceDisplay, BadgeList, RatingDisplay, VariantSwatches, VariantSelector, ActionButtons, withAnalytics, AnalyticsProvider, useAnalyticsProvider, CustomSelect, } from './components/primitives';
+export { SectionSearchProvider, useSectionSearchContext, SectionItemGrid, SectionError, } from './components/section-primitives';
+export { ProductGallery, ProductInfo, ProductRecommendations } from './components/product-page';
+// ============================================================================
+// Premium Query Suggestions (Responsive & Mobile-Ready)
+// ============================================================================
+// Main Integration Component - Use this for easy setup
+// Just pass the client and variant, handles everything automatically
+export { SuggestionSearchBar, // All-in-one: input + dropdown + data fetching
+ } from './components/suggestions';
+// Individual Dropdown Variants - For custom implementations
+export { 
+// Components - 7 Premium Variants
+AmazonDropdown, // Amazon-style with department scoping
+GoogleDropdown, // Google-style clean search
+PinterestDropdown, // Visual discovery style
+SpotlightDropdown, // macOS Spotlight / Command palette
+ShopifyDropdown, // Modern e-commerce
+MobileSheetDropdown, // Mobile-first bottom sheet
+MinimalDropdown, // Ultra-clean editorial style
+// Variant map for dynamic selection
+SuggestionDropdownVariants, 
+// Field Extraction Utilities (Data Agnostic)
+extractSuggestion, extractProduct, extractCategory, extractBrand, formatPrice as formatSuggestionPrice, highlightText, 
+// Recent Searches (LocalStorage)
+getRecentSearches, addRecentSearch, removeRecentSearch, clearRecentSearches, 
+// Responsive Utilities
+useResponsive, breakpoints, mediaQueries, touchTargets, injectGlobalResponsiveStyles, useInjectResponsiveStyles, } from './components/suggestions';
+// ============================================================================
+// DocSearch (documentation search modal - built-in, no seekora-docsearch dependency)
+// Full Seekora SDK integration: API (client.search) and analytics (trackDocClick + SearchContext).
+// ============================================================================
+export { DocSearch, DocSearchButton, useDocSearch, useKeyboard, getShortcutText, useSeekoraSearch as useDocSearchSeekoraSearch, } from './docsearch';
+// ============================================================================
+// Hooks
+// ============================================================================
+export { useSeekoraSearch } from './hooks/useSeekoraSearch';
+export { useQuerySuggestions } from './hooks/useQuerySuggestions';
+export { useQuerySuggestionsEnhanced } from './hooks/useQuerySuggestionsEnhanced';
+export { useSuggestionsAnalytics } from './hooks/useSuggestionsAnalytics';
+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 { useFilters } from './hooks/useFilters';
+// ============================================================================
+// Fingerprinting (from core - visitor ID for analytics/identity)
+// ============================================================================
+export { Fingerprint, getFingerprint, } from '@seekora-ai/ui-sdk-core';
+// ============================================================================
+// Themes
+// ============================================================================
+export { defaultTheme } from './themes/default';
+export { darkTheme } from './themes/dark';
+export { minimalTheme } from './themes/minimal';
+// Query Suggestions Themes
+export { lightThemeVariables, darkThemeVariables, minimalThemeVariables, brandPresets, createSuggestionsTheme, generateSuggestionsStylesheet, injectSuggestionsStyles, updateSuggestionsStyles, } from './themes/suggestions';
+// Analytics V3 query API and types: import from '@seekora/search-sdk' or '@seekora-ai/search-sdk':
+//   createAnalyticsV3Api, AnalyticsV3Api, GenericResponse, SearchMetrics, etc.
+// ============================================================================
+// Utilities
+// ============================================================================
+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';