@seekora-ai/ui-sdk-react 0.2.15 → 0.2.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (122) hide show
  1. package/dist/components/FacetDropdown.d.ts +2 -0
  2. package/dist/components/FacetDropdown.d.ts.map +1 -1
  3. package/dist/components/FacetDropdown.js +47 -25
  4. package/dist/components/Facets.d.ts +4 -0
  5. package/dist/components/Facets.d.ts.map +1 -1
  6. package/dist/components/Facets.js +21 -2
  7. package/dist/components/InfiniteHits.d.ts +0 -7
  8. package/dist/components/InfiniteHits.d.ts.map +1 -1
  9. package/dist/components/InfiniteHits.js +2 -13
  10. package/dist/components/Pagination.d.ts.map +1 -1
  11. package/dist/components/Pagination.js +27 -9
  12. package/dist/components/QuerySuggestions.d.ts +0 -4
  13. package/dist/components/QuerySuggestions.d.ts.map +1 -1
  14. package/dist/components/QuerySuggestions.js +1 -17
  15. package/dist/components/QuerySuggestionsDropdown.d.ts +0 -4
  16. package/dist/components/QuerySuggestionsDropdown.d.ts.map +1 -1
  17. package/dist/components/QuerySuggestionsDropdown.js +1 -16
  18. package/dist/components/Recommendations.d.ts +0 -7
  19. package/dist/components/Recommendations.d.ts.map +1 -1
  20. package/dist/components/Recommendations.js +3 -23
  21. package/dist/components/RichQuerySuggestions.d.ts +0 -4
  22. package/dist/components/RichQuerySuggestions.d.ts.map +1 -1
  23. package/dist/components/RichQuerySuggestions.js +1 -10
  24. package/dist/components/SearchBar.d.ts +0 -4
  25. package/dist/components/SearchBar.d.ts.map +1 -1
  26. package/dist/components/SearchBar.js +2 -4
  27. package/dist/components/SearchBarWithSuggestions.js +1 -1
  28. package/dist/components/SearchLayout.d.ts.map +1 -1
  29. package/dist/components/SearchLayout.js +13 -17
  30. package/dist/components/SearchProvider.d.ts.map +1 -1
  31. package/dist/components/SearchProvider.js +1 -3
  32. package/dist/components/SearchResults.d.ts +0 -6
  33. package/dist/components/SearchResults.d.ts.map +1 -1
  34. package/dist/components/SearchResults.js +1 -14
  35. package/dist/components/primitives/ImageDisplay.d.ts.map +1 -1
  36. package/dist/components/primitives/ImageDisplay.js +24 -14
  37. package/dist/components/primitives/ImageZoom.d.ts.map +1 -1
  38. package/dist/components/primitives/ImageZoom.js +59 -4
  39. package/dist/components/primitives/VariantSwatches.d.ts.map +1 -1
  40. package/dist/components/primitives/VariantSwatches.js +25 -10
  41. package/dist/components/section-primitives/SectionItemGrid.d.ts +1 -3
  42. package/dist/components/section-primitives/SectionItemGrid.d.ts.map +1 -1
  43. package/dist/components/section-primitives/SectionItemGrid.js +1 -4
  44. package/dist/components/section-primitives/index.d.ts +0 -1
  45. package/dist/components/section-primitives/index.d.ts.map +1 -1
  46. package/dist/components/section-primitives/index.js +0 -1
  47. package/dist/components/suggestions/AmazonDropdown.d.ts.map +1 -1
  48. package/dist/components/suggestions/AmazonDropdown.js +3 -21
  49. package/dist/components/suggestions/GoogleDropdown.d.ts.map +1 -1
  50. package/dist/components/suggestions/GoogleDropdown.js +3 -20
  51. package/dist/components/suggestions/MinimalDropdown.d.ts.map +1 -1
  52. package/dist/components/suggestions/MinimalDropdown.js +2 -2
  53. package/dist/components/suggestions/MobileSheetDropdown.d.ts.map +1 -1
  54. package/dist/components/suggestions/MobileSheetDropdown.js +60 -60
  55. package/dist/components/suggestions/PinterestDropdown.d.ts.map +1 -1
  56. package/dist/components/suggestions/PinterestDropdown.js +41 -41
  57. package/dist/components/suggestions/ShopifyDropdown.d.ts.map +1 -1
  58. package/dist/components/suggestions/ShopifyDropdown.js +3 -4
  59. package/dist/components/suggestions/SpotlightDropdown.d.ts.map +1 -1
  60. package/dist/components/suggestions/SpotlightDropdown.js +2 -3
  61. package/dist/components/suggestions/SuggestionSearchBar.d.ts.map +1 -1
  62. package/dist/components/suggestions/SuggestionSearchBar.js +2 -15
  63. package/dist/components/suggestions/types.d.ts +0 -6
  64. package/dist/components/suggestions/types.d.ts.map +1 -1
  65. package/dist/components/suggestions-primitives/ItemCard.d.ts.map +1 -1
  66. package/dist/components/suggestions-primitives/ItemCard.js +32 -8
  67. package/dist/components/suggestions-primitives/ItemGrid.d.ts.map +1 -1
  68. package/dist/components/suggestions-primitives/ItemGrid.js +9 -2
  69. package/dist/components/suggestions-primitives/ProductCard.d.ts.map +1 -1
  70. package/dist/components/suggestions-primitives/ProductCard.js +14 -5
  71. package/dist/components/suggestions-primitives/ProductCardLayouts.d.ts.map +1 -1
  72. package/dist/components/suggestions-primitives/ProductCardLayouts.js +32 -12
  73. package/dist/components/suggestions-primitives/ProductGrid.d.ts.map +1 -1
  74. package/dist/components/suggestions-primitives/ProductGrid.js +8 -3
  75. package/dist/components/suggestions-primitives/RecentSearchesList.d.ts.map +1 -1
  76. package/dist/components/suggestions-primitives/RecentSearchesList.js +12 -5
  77. package/dist/components/suggestions-primitives/SearchInput.d.ts.map +1 -1
  78. package/dist/components/suggestions-primitives/SearchInput.js +1 -1
  79. package/dist/components/suggestions-primitives/SuggestionItem.d.ts.map +1 -1
  80. package/dist/components/suggestions-primitives/SuggestionItem.js +5 -3
  81. package/dist/components/suggestions-primitives/SuggestionList.d.ts +1 -8
  82. package/dist/components/suggestions-primitives/SuggestionList.d.ts.map +1 -1
  83. package/dist/components/suggestions-primitives/SuggestionList.js +1 -7
  84. package/dist/components/suggestions-primitives/TrendingList.d.ts.map +1 -1
  85. package/dist/components/suggestions-primitives/TrendingList.js +14 -7
  86. package/dist/components/suggestions-primitives/index.d.ts +1 -3
  87. package/dist/components/suggestions-primitives/index.d.ts.map +1 -1
  88. package/dist/components/suggestions-primitives/index.js +1 -2
  89. package/dist/docsearch/components/DocSearch.d.ts.map +1 -1
  90. package/dist/docsearch/components/DocSearch.js +1 -1
  91. package/dist/docsearch/components/Results.d.ts +1 -3
  92. package/dist/docsearch/components/Results.d.ts.map +1 -1
  93. package/dist/docsearch/components/Results.js +1 -9
  94. package/dist/docsearch/components/SearchBox.d.ts +1 -2
  95. package/dist/docsearch/components/SearchBox.d.ts.map +1 -1
  96. package/dist/docsearch/components/SearchBox.js +4 -6
  97. package/dist/docsearch/hooks/useSeekoraSearch.d.ts.map +1 -1
  98. package/dist/docsearch/hooks/useSeekoraSearch.js +6 -0
  99. package/dist/docsearch/types.d.ts +0 -1
  100. package/dist/docsearch/types.d.ts.map +1 -1
  101. package/dist/docsearch.css +2 -5
  102. package/dist/hooks/useClickTracking.d.ts.map +1 -1
  103. package/dist/hooks/useClickTracking.js +4 -11
  104. package/dist/hooks/useExperiment.d.ts.map +1 -1
  105. package/dist/hooks/useExperiment.js +10 -33
  106. package/dist/hooks/useFilters.d.ts +27 -0
  107. package/dist/hooks/useFilters.d.ts.map +1 -0
  108. package/dist/hooks/useFilters.js +66 -0
  109. package/dist/index.d.ts +7 -4
  110. package/dist/index.d.ts.map +1 -1
  111. package/dist/index.js +3 -2
  112. package/dist/index.umd.js +1 -1
  113. package/dist/src/index.d.ts +39 -79
  114. package/dist/src/index.esm.js +800 -452
  115. package/dist/src/index.esm.js.map +1 -1
  116. package/dist/src/index.js +800 -453
  117. package/dist/src/index.js.map +1 -1
  118. package/dist/utils/responsive.d.ts +130 -0
  119. package/dist/utils/responsive.d.ts.map +1 -0
  120. package/dist/utils/responsive.js +231 -0
  121. package/package.json +5 -5
  122. package/src/docsearch/docsearch.css +2 -5
@@ -1,6 +1,7 @@
1
1
  import * as React$1 from 'react';
2
2
  import React__default, { ReactNode, CSSProperties } from 'react';
3
- import { SearchOptions, SearchResponse, SeekoraClient, SearchContext, DataTypesEventPayload, ExtendedEventPayload } from '@seekora-ai/search-sdk';
3
+ import { SearchOptions, SearchResponse, SeekoraClient, SearchContext, DataTypesEventPayload, ExtendedEventPayload, FilterOptions, FilterField, FiltersSchemaResponse, FacetValuesSearchResponse } from '@seekora-ai/search-sdk';
4
+ export { FacetSearchOptions, FacetValuesSearchResponse, FilterField, FilterOptions, FilterSchemaField, FilterStats, FilterValue, FiltersResponse, FiltersSchemaResponse } from '@seekora-ai/search-sdk';
4
5
  import * as _seekora_ai_ui_sdk_types from '@seekora-ai/ui-sdk-types';
5
6
  import { ResultItem, ViewMode, FieldMapping, ThemeConfig, Theme, QuerySuggestionsEventHandlers, HighlightConfig, KeyboardNavConfig, AnimationConfig, QuerySuggestionsClassNames, SuggestionItem as SuggestionItem$3, RecentSearch, DropdownSectionConfig, SuggestionCategory, TrendingSearch, ProductItem, PopularBrand, FilteredTab, QuerySuggestionsVariant, QuerySuggestionsResponse, DropdownRecommendations, TopSearch, RelatedSearch, PriceRange, ProductBadge, ProductOption, ProductVariant } from '@seekora-ai/ui-sdk-types';
6
7
  export { FieldMapping, PriceRange, ProductBadge, ProductOption, ProductVariant, ResultItem, Theme, ThemeConfig, ViewMode } from '@seekora-ai/ui-sdk-types';
@@ -22,7 +23,6 @@ interface SearchBarTheme {
22
23
  suggestionItem?: string;
23
24
  suggestionItemHover?: string;
24
25
  suggestionItemActive?: string;
25
- loadingIndicator?: string;
26
26
  searchIcon?: string;
27
27
  clearButton?: string;
28
28
  submitButton?: string;
@@ -45,10 +45,7 @@ interface SearchBarProps {
45
45
  className?: string;
46
46
  style?: React__default.CSSProperties;
47
47
  theme?: SearchBarTheme;
48
- /** Show loading state when fetching and no previous suggestions (default false: show previous results until new render) */
49
- showLoadingState?: boolean;
50
48
  renderSuggestion?: (suggestion: string, index: number) => React__default.ReactNode;
51
- renderLoading?: () => React__default.ReactNode;
52
49
  /** Custom render for the search icon. If not provided, a default magnifying glass SVG is rendered. */
53
50
  renderSearchIcon?: () => React__default.ReactNode;
54
51
  /** Whether to show a clear button when the query is non-empty (default: true) */
@@ -82,7 +79,6 @@ interface SearchResultsTheme {
82
79
  resultImage?: string;
83
80
  resultPrice?: string;
84
81
  emptyState?: string;
85
- loadingState?: string;
86
82
  errorState?: string;
87
83
  pagination?: string;
88
84
  /** Custom min-height class override */
@@ -97,9 +93,6 @@ interface SearchResultsProps {
97
93
  onResultClick?: (result: ResultItem, index: number) => void;
98
94
  renderResult?: (result: ResultItem, index: number, isActive?: boolean) => React__default.ReactNode;
99
95
  renderEmpty?: () => React__default.ReactNode;
100
- /** Show loading state when fetching and no previous results (default false: show previous results until new render) */
101
- showLoadingState?: boolean;
102
- renderLoading?: () => React__default.ReactNode;
103
96
  renderError?: (error: Error) => React__default.ReactNode;
104
97
  className?: string;
105
98
  style?: React__default.CSSProperties;
@@ -120,8 +113,6 @@ interface SearchResultsProps {
120
113
  minHeight?: string;
121
114
  /** Minimum width to prevent container shrinking (default: '100%') */
122
115
  minWidth?: string;
123
- /** Opacity applied to results while loading new results (default: 0.7, set to 1 to disable) */
124
- loadingOpacity?: number;
125
116
  }
126
117
  declare const SearchResults: React__default.FC<SearchResultsProps>;
127
118
 
@@ -483,6 +474,10 @@ interface FacetsProps {
483
474
  size?: FacetSize;
484
475
  /** Pre-configured range button definitions for numeric facets */
485
476
  facetRanges?: FacetRangeConfig[];
477
+ /** Use dedicated Filters API instead of extracting facets from search results */
478
+ useFiltersApi?: boolean;
479
+ /** Fields that should use disjunctive (OR) faceting (only with useFiltersApi) */
480
+ disjunctiveFacets?: string[];
486
481
  }
487
482
  declare const Facets: React__default.FC<FacetsProps>;
488
483
 
@@ -574,6 +569,8 @@ interface FacetDropdownProps {
574
569
  navigateOnSelect?: boolean;
575
570
  /** Base URL for navigation (e.g., "/search") */
576
571
  searchPageUrl?: string;
572
+ /** Use dedicated Filters API instead of search API for fetching facet values */
573
+ useFiltersApi?: boolean;
577
574
  }
578
575
  declare const FacetDropdown: React__default.FC<FacetDropdownProps>;
579
576
 
@@ -827,7 +824,6 @@ interface InfiniteHitsTheme {
827
824
  item?: string;
828
825
  loadMore?: string;
829
826
  loadMoreDisabled?: string;
830
- loading?: string;
831
827
  empty?: string;
832
828
  sentinel?: string;
833
829
  }
@@ -836,10 +832,6 @@ interface InfiniteHitsProps {
836
832
  renderHit?: (hit: ResultItem, index: number) => React__default.ReactNode;
837
833
  /** Custom render for empty state */
838
834
  renderEmpty?: () => React__default.ReactNode;
839
- /** Show initial loading when fetching and no hits yet (default false: no loading screen) */
840
- showInitialLoading?: boolean;
841
- /** Custom render for loading state */
842
- renderLoading?: () => React__default.ReactNode;
843
835
  /** Custom render for "Show More" button */
844
836
  renderShowMore?: (props: {
845
837
  isLoading: boolean;
@@ -856,8 +848,6 @@ interface InfiniteHitsProps {
856
848
  fieldMapping?: FieldMapping;
857
849
  /** Text for "Show More" button */
858
850
  showMoreLabel?: string;
859
- /** Text for loading state */
860
- loadingLabel?: string;
861
851
  /** Callback when a hit is clicked */
862
852
  onHitClick?: (hit: ResultItem, index: number) => void;
863
853
  /** Custom className */
@@ -1163,7 +1153,6 @@ interface RecommendationTheme {
1163
1153
  content?: string;
1164
1154
  name?: string;
1165
1155
  price?: string;
1166
- loading?: string;
1167
1156
  empty?: string;
1168
1157
  }
1169
1158
  interface BaseRecommendationProps {
@@ -1193,8 +1182,6 @@ interface RelatedProductsProps extends BaseRecommendationProps {
1193
1182
  items?: RecommendationItem[];
1194
1183
  /** Loading state */
1195
1184
  loading?: boolean;
1196
- /** Show loading state when fetching and no previous items (default false: show previous results until new render) */
1197
- showLoadingState?: boolean;
1198
1185
  }
1199
1186
  declare const RelatedProducts: React__default.FC<RelatedProductsProps>;
1200
1187
  interface TrendingItemsProps extends BaseRecommendationProps {
@@ -1202,8 +1189,6 @@ interface TrendingItemsProps extends BaseRecommendationProps {
1202
1189
  items?: RecommendationItem[];
1203
1190
  /** Loading state */
1204
1191
  loading?: boolean;
1205
- /** Show loading state when fetching and no previous items (default false: show previous results until new render) */
1206
- showLoadingState?: boolean;
1207
1192
  /** Facet name for trending (if using facet data) */
1208
1193
  facetName?: string;
1209
1194
  }
@@ -1215,8 +1200,6 @@ interface FrequentlyBoughtTogetherProps extends BaseRecommendationProps {
1215
1200
  items?: RecommendationItem[];
1216
1201
  /** Loading state */
1217
1202
  loading?: boolean;
1218
- /** Show loading state when fetching and no previous items (default false: show previous results until new render) */
1219
- showLoadingState?: boolean;
1220
1203
  /** Show "Add all to cart" button */
1221
1204
  showAddAllButton?: boolean;
1222
1205
  /** Callback when "Add all" is clicked */
@@ -1253,7 +1236,6 @@ interface QuerySuggestionsTheme {
1253
1236
  suggestionItem?: string;
1254
1237
  suggestionItemHover?: string;
1255
1238
  suggestionItemActive?: string;
1256
- loadingState?: string;
1257
1239
  emptyState?: string;
1258
1240
  }
1259
1241
  interface QuerySuggestionsProps {
@@ -1263,9 +1245,6 @@ interface QuerySuggestionsProps {
1263
1245
  minQueryLength?: number;
1264
1246
  onSuggestionClick?: (suggestion: string) => void;
1265
1247
  renderSuggestion?: (suggestion: SuggestionItem$2, index: number) => React__default.ReactNode;
1266
- /** Show loading state when fetching and no previous suggestions (default false: show previous results until new render) */
1267
- showLoadingState?: boolean;
1268
- renderLoading?: () => React__default.ReactNode;
1269
1248
  renderEmpty?: () => React__default.ReactNode;
1270
1249
  showTitle?: boolean;
1271
1250
  title?: string;
@@ -1304,8 +1283,6 @@ interface QuerySuggestionsDropdownProps extends QuerySuggestionsEventHandlers {
1304
1283
  maxRecentSearches?: number;
1305
1284
  /** Show suggestion counts */
1306
1285
  showCounts?: boolean;
1307
- /** Show loading state (default false: show previous results until new results render) */
1308
- showLoading?: boolean;
1309
1286
  /** Show empty state when no results */
1310
1287
  showEmptyState?: boolean;
1311
1288
  /** Highlight configuration */
@@ -1322,8 +1299,6 @@ interface QuerySuggestionsDropdownProps extends QuerySuggestionsEventHandlers {
1322
1299
  renderSuggestion?: (suggestion: SuggestionItem$3, index: number, isActive: boolean, highlight: (text: string) => React__default.ReactNode) => React__default.ReactNode;
1323
1300
  /** Custom render for recent search item */
1324
1301
  renderRecentSearch?: (search: RecentSearch, index: number, isActive: boolean) => React__default.ReactNode;
1325
- /** Custom render for loading state */
1326
- renderLoading?: () => React__default.ReactNode;
1327
1302
  /** Custom render for empty state */
1328
1303
  renderEmpty?: () => React__default.ReactNode;
1329
1304
  /** Custom footer content */
@@ -1417,10 +1392,6 @@ interface RichQuerySuggestionsProps extends QuerySuggestionsEventHandlers {
1417
1392
  header?: React__default.ReactNode;
1418
1393
  /** Custom footer content */
1419
1394
  footer?: React__default.ReactNode;
1420
- /** Show loading overlay when fetching (default false: show previous results until new results render) */
1421
- showLoadingOverlay?: boolean;
1422
- /** Custom render for loading overlay (only when showLoadingOverlay is true) */
1423
- renderLoading?: () => React__default.ReactNode;
1424
1395
  /** Dropdown width */
1425
1396
  width?: string | number;
1426
1397
  /** Dropdown max height */
@@ -1922,13 +1893,6 @@ interface SuggestionListProps {
1922
1893
  className?: string;
1923
1894
  style?: React__default.CSSProperties;
1924
1895
  listClassName?: string;
1925
- /**
1926
- * When true, show a loading state when fetching and no previous suggestions exist.
1927
- * When false (default), show previous results until new results render; no loading screen.
1928
- */
1929
- showLoadingState?: boolean;
1930
- /** Custom render for loading state (only when showLoadingState is true and loading with no items). */
1931
- renderLoading?: () => React__default.ReactNode;
1932
1896
  /**
1933
1897
  * When true (default), suggestion text with <mark>...</mark> is rendered
1934
1898
  * with those segments highlighted. When false, plain text is shown.
@@ -1939,7 +1903,7 @@ interface SuggestionListProps {
1939
1903
  highlightMarkupOptions?: HighlightMarkupOptions;
1940
1904
  renderItem?: (suggestion: _seekora_ai_ui_sdk_types.SuggestionItem, index: number, isActive: boolean, onSelect: () => void) => React__default.ReactNode;
1941
1905
  }
1942
- declare function SuggestionList({ maxItems, className, style, listClassName, showLoadingState, renderLoading, enableHighlightMarkup, highlightMarkupOptions, renderItem, }: SuggestionListProps): React__default.JSX.Element | null;
1906
+ declare function SuggestionList({ maxItems, className, style, listClassName, enableHighlightMarkup, highlightMarkupOptions, renderItem, }: SuggestionListProps): React__default.JSX.Element | null;
1943
1907
 
1944
1908
  /**
1945
1909
  * SuggestionItem – single text suggestion row (primitive)
@@ -2456,10 +2420,6 @@ interface BaseDropdownProps<TSuggestion = any, TProduct = any, TCategory = any,
2456
2420
  header?: ReactNode;
2457
2421
  /** Custom footer */
2458
2422
  footer?: ReactNode;
2459
- /** Custom loading state */
2460
- /** Show loading state when fetching and no previous items (default false: show previous results until new render) */
2461
- showLoadingState?: boolean;
2462
- renderLoading?: () => ReactNode;
2463
2423
  /** Custom empty state */
2464
2424
  renderEmpty?: (query: string) => ReactNode;
2465
2425
  /** Custom error state */
@@ -2525,8 +2485,6 @@ interface DropdownClassNames {
2525
2485
  tabItem: string;
2526
2486
  tabItemActive: string;
2527
2487
  tabCount: string;
2528
- loading: string;
2529
- loadingSpinner: string;
2530
2488
  empty: string;
2531
2489
  emptyIcon: string;
2532
2490
  emptyText: string;
@@ -2680,17 +2638,6 @@ interface TrendingListProps {
2680
2638
  }
2681
2639
  declare function TrendingList({ title, maxItems, className, style, listClassName, renderItem, }: TrendingListProps): React__default.JSX.Element | null;
2682
2640
 
2683
- /**
2684
- * SuggestionsLoading – loading indicator (primitive)
2685
- */
2686
-
2687
- interface SuggestionsLoadingProps {
2688
- className?: string;
2689
- style?: React__default.CSSProperties;
2690
- text?: string;
2691
- }
2692
- declare function SuggestionsLoading({ className, style, text }: SuggestionsLoadingProps): React__default.JSX.Element | null;
2693
-
2694
2641
  /**
2695
2642
  * SuggestionsError – error message (primitive)
2696
2643
  */
@@ -3009,8 +2956,6 @@ interface SectionItemGridProps {
3009
2956
  maxItems?: number;
3010
2957
  className?: string;
3011
2958
  style?: React__default.CSSProperties;
3012
- /** Show loading state when fetching and no previous items (default false: show previous results until new render) */
3013
- showLoadingState?: boolean;
3014
2959
  getItemId?: (item: unknown) => string;
3015
2960
  getItemTitle?: (item: unknown) => string;
3016
2961
  getItemImage?: (item: unknown) => string | undefined;
@@ -3018,18 +2963,7 @@ interface SectionItemGridProps {
3018
2963
  getItemUrl?: (item: unknown) => string | undefined;
3019
2964
  renderItem?: (item: unknown, index: number) => React__default.ReactNode;
3020
2965
  }
3021
- declare function SectionItemGrid({ columns, maxItems, className, style, showLoadingState, getItemId, getItemTitle, getItemImage, getItemDescription, getItemUrl, renderItem, }: SectionItemGridProps): React__default.JSX.Element;
3022
-
3023
- /**
3024
- * SectionLoading – loading state for section (primitive)
3025
- */
3026
-
3027
- interface SectionLoadingProps {
3028
- className?: string;
3029
- style?: React__default.CSSProperties;
3030
- text?: string;
3031
- }
3032
- declare function SectionLoading({ className, style, text }: SectionLoadingProps): React__default.JSX.Element | null;
2966
+ declare function SectionItemGrid({ columns, maxItems, className, style, getItemId, getItemTitle, getItemImage, getItemDescription, getItemUrl, renderItem, }: SectionItemGridProps): React__default.JSX.Element;
3033
2967
 
3034
2968
  /**
3035
2969
  * SectionError – error state for section (primitive)
@@ -3808,7 +3742,6 @@ interface DocSearchTranslations {
3808
3742
  buttonAriaLabel?: string;
3809
3743
  searchPlaceholder?: string;
3810
3744
  noResultsText?: string;
3811
- loadingText?: string;
3812
3745
  errorText?: string;
3813
3746
  footerText?: string;
3814
3747
  closeText?: string;
@@ -4306,6 +4239,33 @@ interface UseProductAnalyticsReturn {
4306
4239
  }
4307
4240
  declare function useProductAnalytics({ client, product, position, section, tabId, query, context, enabled, }: UseProductAnalyticsOptions): UseProductAnalyticsReturn;
4308
4241
 
4242
+ /**
4243
+ * useFilters Hook
4244
+ *
4245
+ * React hook for fetching filter values, searching facet values,
4246
+ * and retrieving filter schema via the dedicated Filters API.
4247
+ */
4248
+
4249
+ interface UseFiltersOptions extends FilterOptions {
4250
+ /** Whether to automatically refetch filters when query or refinements change (default: true) */
4251
+ autoFetch?: boolean;
4252
+ }
4253
+ interface UseFiltersReturn {
4254
+ /** Filter fields with values and counts */
4255
+ filters: FilterField[];
4256
+ /** Filter schema metadata (fetched once on mount) */
4257
+ schema: FiltersSchemaResponse | null;
4258
+ /** Whether filters are currently loading */
4259
+ loading: boolean;
4260
+ /** Error from the last fetch, if any */
4261
+ error: Error | null;
4262
+ /** Search within a facet's values (for typeahead/autocomplete) */
4263
+ searchFacetValues: (facetName: string, query: string) => Promise<FacetValuesSearchResponse>;
4264
+ /** Manually refetch filters */
4265
+ refetch: () => Promise<void>;
4266
+ }
4267
+ declare const useFilters: (options?: UseFiltersOptions) => UseFiltersReturn;
4268
+
4309
4269
  /**
4310
4270
  * Default Theme
4311
4271
  */
@@ -4443,5 +4403,5 @@ declare function updateSuggestionsStyles(theme: SuggestionsThemeVariables): void
4443
4403
 
4444
4404
  declare const createTheme: (config: ThemeConfig) => _seekora_ai_ui_sdk_types.Theme;
4445
4405
 
4446
- export { ActionButtons, AmazonDropdown, AnalyticsProvider, BadgeList, Breadcrumb, CategoriesTabs, ClearRefinements, CurrentRefinements, DocSearch, DocSearchButton, DropdownPanel, FacetDropdown, Facets, FederatedDropdown, FrequentlyBoughtTogether, GoogleDropdown, HierarchicalMenu, Highlight, HitsPerPage, ImageDisplay, ImageZoom, InfiniteHits, ItemCard, ItemGrid, MinimalDropdown, MobileFilters, MobileFiltersButton, MobileSheetDropdown, Pagination, PinterestDropdown, PriceDisplay, ProductCard, ProductGallery, ProductGrid, ProductInfo, ProductRecommendations, QuerySuggestions, QuerySuggestionsDropdown, RangeInput, RangeSlider, RatingDisplay, RecentSearchesList, RecentlyViewed, RelatedProducts, RichQuerySuggestions, SearchBar, SearchBarWithSuggestions, SearchInput, SearchLayout, SearchProvider, SearchResults, SectionError, SectionItemGrid, SectionLoading, SectionSearchProvider, ShopifyDropdown, Snippet, SortBy, SpotlightDropdown, Stats, SuggestionDropdownVariants, SuggestionItem$1 as SuggestionItem, SuggestionList, SuggestionSearchBar, SuggestionsCache, SuggestionsDropdownComposition, SuggestionsError, SuggestionsLoading, SuggestionsProvider, TrendingItems, TrendingList, VariantSelector, VariantSwatches, addRecentSearch, addToRecentlyViewed, brandPresets, breakpoints, clearRecentSearches, clearSuggestionsCache, createSuggestionsCache, createSuggestionsTheme, createTheme, darkTheme, darkThemeVariables, defaultTheme, extractBadges, extractBrand, extractCategory, extractProduct, extractSuggestion, findVariantBySelections, formatParsedFilters, formatPriceRange, formatPrice as formatSuggestionPrice, generateSuggestionsStylesheet, getAvailableValuesForOption, getPriceRange, getRecentSearches, getShortcutText, getSuggestionsCache, highlightText, injectGlobalResponsiveStyles, injectSuggestionsStyles, lightThemeVariables, mediaQueries, minimalTheme, minimalThemeVariables, parseHighlightMarkup, removeRecentSearch, touchTargets, updateSuggestionsStyles, useAnalytics, useAnalyticsProvider, useDocSearch, useSeekoraSearch$1 as useDocSearchSeekoraSearch, useInjectResponsiveStyles, useKeyboard, useNaturalLanguageFilters, useProductAnalytics, useQuerySuggestions, useQuerySuggestionsEnhanced, useResponsive, useSearchContext, useSearchState, useSectionSearchContext, useSeekoraSearch, useSmartSuggestions, useSuggestionsAnalytics, useSuggestionsContext, useVariantSelection, withAnalytics };
4447
- export type { ActionButton, ActionButtonType, ActionButtonsProps, AnalyticsConfig, AnalyticsEventPayload, AnalyticsProviderProps, BadgeListProps, BaseDropdownProps, BrandFieldMapping, BreadcrumbItem, BreadcrumbProps, BreadcrumbTheme, CategoriesTabsProps, CategoryFieldMapping, ClearRefinementsProps, ClearRefinementsTheme, DocSearchAction, DocSearchButtonProps, DocSearchHit, DocSearchProps, DocSearchResponse, DocSearchState, DocSearchSuggestion, DocSearchSuggestionsResponse, DocSearchTranslations, DropdownClassNames, DropdownEventHandlers, DropdownPanelProps, DropdownRef, DropdownThemeConfig, Facet, FacetDropdownOption, FacetDropdownProps, FacetDropdownTheme, FacetItem, FacetRangeConfig, FacetRangeItem, FacetSize, FacetStats, FacetVariant, FacetsProps, FacetsTheme, FederatedDropdownProps, FederatedDropdownRef, FrequentlyBoughtTogetherProps, GenericItem, HierarchicalMenuItem, HierarchicalMenuProps, HierarchicalMenuTheme, HighlightMarkupOptions, HighlightProps, HighlightTheme, HitsPerPageItem, HitsPerPageProps, HitsPerPageTheme, ImageDisplayProps, ImageDisplayVariant, ImageZoomMode, ImageZoomProps, InfiniteHitsProps, InfiniteHitsTheme, ImageDisplayVariant$1 as ItemCardImageVariant, ItemCardProps, ItemGridProps, MobileFiltersButtonProps, MobileFiltersProps, MobileFiltersTheme, NaturalLanguageFiltersOptions, NaturalLanguageResult, NavigableItem, PaginationProps, PaginationTheme, ParsedFilter, PriceDisplayProps, ProductCardImageVariant, ProductCardProps, ProductClickEventData, ProductDisplayConfig, ProductFieldMapping, ProductGalleryProps, ProductGridProps, ProductInfoProps, ProductRecommendationsProps, QuerySuggestionsDropdownProps, QuerySuggestionsDropdownRef, QuerySuggestionsProps, QuerySuggestionsTheme, RangeSliderProps, RangeSliderTheme, RatingDisplayProps, RatingSize, RatingVariant, RecentSearchesListProps, RecentlyViewedProps, RecommendationItem, RecommendationTheme, RefinementInput, RelatedProductsProps, ResponsiveState, RichQuerySuggestionsProps, RichQuerySuggestionsRef, SearchBarProps, SearchBarSize, SearchBarTheme, SearchBarWithSuggestionsProps, SearchBarWithSuggestionsRef, SearchInputProps, SearchProviderProps, SearchResultsProps, SearchResultsTheme, SearchSource, SectionConfig, SectionErrorProps, SectionItemGridProps, SectionLoadingProps, SectionSearchContextValue, SectionSearchProviderProps, SmartSuggestion, SmartSuggestionsOptions, SnippetProps, SnippetTheme, SortByProps, SortBySize, SortByTheme, SortByVariant, SortOption, SuggestionClickEventData, SuggestionDisplayConfig, SuggestionDropdownVariant, SuggestionFieldMapping, SuggestionImpressionEventData, SuggestionItemProps, SuggestionListProps, SuggestionSearchBarProps, SuggestionSearchBarRef, SuggestionsContextValue, SuggestionsDropdownCompositionProps, SuggestionsErrorProps, SuggestionsLoadingProps, SuggestionsProviderProps, SuggestionsThemeVariables, TrendingItemsProps, TrendingListProps, UseAnalyticsOptions, UseAnalyticsReturn, UseSeekoraSearchOptions$1 as UseDocSearchSeekoraSearchOptions, UseSeekoraSearchResult as UseDocSearchSeekoraSearchResult, UseProductAnalyticsOptions, UseProductAnalyticsReturn, UseQuerySuggestionsEnhancedOptions, UseQuerySuggestionsEnhancedReturn, UseSmartSuggestionsReturn, UseSuggestionsAnalyticsOptions, UseSuggestionsAnalyticsReturn, UseVariantSelectionOptions, UseVariantSelectionReturn, VariantSelectorProps, VariantSwatchesProps, WithAnalyticsConfig, WithAnalyticsInjectedProps };
4406
+ export { ActionButtons, AmazonDropdown, AnalyticsProvider, BadgeList, Breadcrumb, CategoriesTabs, ClearRefinements, CurrentRefinements, DocSearch, DocSearchButton, DropdownPanel, FacetDropdown, Facets, FederatedDropdown, FrequentlyBoughtTogether, GoogleDropdown, HierarchicalMenu, Highlight, HitsPerPage, ImageDisplay, ImageZoom, InfiniteHits, ItemCard, ItemGrid, MinimalDropdown, MobileFilters, MobileFiltersButton, MobileSheetDropdown, Pagination, PinterestDropdown, PriceDisplay, ProductCard, ProductGallery, ProductGrid, ProductInfo, ProductRecommendations, QuerySuggestions, QuerySuggestionsDropdown, RangeInput, RangeSlider, RatingDisplay, RecentSearchesList, RecentlyViewed, RelatedProducts, RichQuerySuggestions, SearchBar, SearchBarWithSuggestions, SearchInput, SearchLayout, SearchProvider, SearchResults, SectionError, SectionItemGrid, SectionSearchProvider, ShopifyDropdown, Snippet, SortBy, SpotlightDropdown, Stats, SuggestionDropdownVariants, SuggestionItem$1 as SuggestionItem, SuggestionList, SuggestionSearchBar, SuggestionsCache, SuggestionsDropdownComposition, SuggestionsError, SuggestionsProvider, TrendingItems, TrendingList, VariantSelector, VariantSwatches, addRecentSearch, addToRecentlyViewed, brandPresets, breakpoints, clearRecentSearches, clearSuggestionsCache, createSuggestionsCache, createSuggestionsTheme, createTheme, darkTheme, darkThemeVariables, defaultTheme, extractBadges, extractBrand, extractCategory, extractProduct, extractSuggestion, findVariantBySelections, formatParsedFilters, formatPriceRange, formatPrice as formatSuggestionPrice, generateSuggestionsStylesheet, getAvailableValuesForOption, getPriceRange, getRecentSearches, getShortcutText, getSuggestionsCache, highlightText, injectGlobalResponsiveStyles, injectSuggestionsStyles, lightThemeVariables, mediaQueries, minimalTheme, minimalThemeVariables, parseHighlightMarkup, removeRecentSearch, touchTargets, updateSuggestionsStyles, useAnalytics, useAnalyticsProvider, useDocSearch, useSeekoraSearch$1 as useDocSearchSeekoraSearch, useFilters, useInjectResponsiveStyles, useKeyboard, useNaturalLanguageFilters, useProductAnalytics, useQuerySuggestions, useQuerySuggestionsEnhanced, useResponsive, useSearchContext, useSearchState, useSectionSearchContext, useSeekoraSearch, useSmartSuggestions, useSuggestionsAnalytics, useSuggestionsContext, useVariantSelection, withAnalytics };
4407
+ export type { ActionButton, ActionButtonType, ActionButtonsProps, AnalyticsConfig, AnalyticsEventPayload, AnalyticsProviderProps, BadgeListProps, BaseDropdownProps, BrandFieldMapping, BreadcrumbItem, BreadcrumbProps, BreadcrumbTheme, CategoriesTabsProps, CategoryFieldMapping, ClearRefinementsProps, ClearRefinementsTheme, DocSearchAction, DocSearchButtonProps, DocSearchHit, DocSearchProps, DocSearchResponse, DocSearchState, DocSearchSuggestion, DocSearchSuggestionsResponse, DocSearchTranslations, DropdownClassNames, DropdownEventHandlers, DropdownPanelProps, DropdownRef, DropdownThemeConfig, Facet, FacetDropdownOption, FacetDropdownProps, FacetDropdownTheme, FacetItem, FacetRangeConfig, FacetRangeItem, FacetSize, FacetStats, FacetVariant, FacetsProps, FacetsTheme, FederatedDropdownProps, FederatedDropdownRef, FrequentlyBoughtTogetherProps, GenericItem, HierarchicalMenuItem, HierarchicalMenuProps, HierarchicalMenuTheme, HighlightMarkupOptions, HighlightProps, HighlightTheme, HitsPerPageItem, HitsPerPageProps, HitsPerPageTheme, ImageDisplayProps, ImageDisplayVariant, ImageZoomMode, ImageZoomProps, InfiniteHitsProps, InfiniteHitsTheme, ImageDisplayVariant$1 as ItemCardImageVariant, ItemCardProps, ItemGridProps, MobileFiltersButtonProps, MobileFiltersProps, MobileFiltersTheme, NaturalLanguageFiltersOptions, NaturalLanguageResult, NavigableItem, PaginationProps, PaginationTheme, ParsedFilter, PriceDisplayProps, ProductCardImageVariant, ProductCardProps, ProductClickEventData, ProductDisplayConfig, ProductFieldMapping, ProductGalleryProps, ProductGridProps, ProductInfoProps, ProductRecommendationsProps, QuerySuggestionsDropdownProps, QuerySuggestionsDropdownRef, QuerySuggestionsProps, QuerySuggestionsTheme, RangeSliderProps, RangeSliderTheme, RatingDisplayProps, RatingSize, RatingVariant, RecentSearchesListProps, RecentlyViewedProps, RecommendationItem, RecommendationTheme, RefinementInput, RelatedProductsProps, ResponsiveState, RichQuerySuggestionsProps, RichQuerySuggestionsRef, SearchBarProps, SearchBarSize, SearchBarTheme, SearchBarWithSuggestionsProps, SearchBarWithSuggestionsRef, SearchInputProps, SearchProviderProps, SearchResultsProps, SearchResultsTheme, SearchSource, SectionConfig, SectionErrorProps, SectionItemGridProps, SectionSearchContextValue, SectionSearchProviderProps, SmartSuggestion, SmartSuggestionsOptions, SnippetProps, SnippetTheme, SortByProps, SortBySize, SortByTheme, SortByVariant, SortOption, SuggestionClickEventData, SuggestionDisplayConfig, SuggestionDropdownVariant, SuggestionFieldMapping, SuggestionImpressionEventData, SuggestionItemProps, SuggestionListProps, SuggestionSearchBarProps, SuggestionSearchBarRef, SuggestionsContextValue, SuggestionsDropdownCompositionProps, SuggestionsErrorProps, SuggestionsProviderProps, SuggestionsThemeVariables, TrendingItemsProps, TrendingListProps, UseAnalyticsOptions, UseAnalyticsReturn, UseSeekoraSearchOptions$1 as UseDocSearchSeekoraSearchOptions, UseSeekoraSearchResult as UseDocSearchSeekoraSearchResult, UseFiltersOptions, UseFiltersReturn, UseProductAnalyticsOptions, UseProductAnalyticsReturn, UseQuerySuggestionsEnhancedOptions, UseQuerySuggestionsEnhancedReturn, UseSmartSuggestionsReturn, UseSuggestionsAnalyticsOptions, UseSuggestionsAnalyticsReturn, UseVariantSelectionOptions, UseVariantSelectionReturn, VariantSelectorProps, VariantSwatchesProps, WithAnalyticsConfig, WithAnalyticsInjectedProps };