@envive-ai/react-toolkit 0.1.0 → 0.1.1

package/src/components/search/SearchInput/SearchInput.tsx

@@ -0,0 +1,135 @@
+import React, { useRef, useImperativeHandle } from 'react';
+import classNames from 'classnames';
+import MagnifyingGlassStarVariant from '@envive-ai/react-icons/src/MagnifyingGlassStarVariant';
+import CloseIcon from '@envive-ai/react-icons/src/IconClose';
+import { TextInput } from 'src/components/common/TextInput/TextInput';
+import { searchInputVariantClasses } from './searchInputVariants';
+import type { SearchInputVariant } from '../SearchInputForm/types';
+
+export interface SearchInputProps {
+  searchInputVariant?: SearchInputVariant;
+  value: string;
+  placeholder?: string;
+  suggestions?: string[];
+  className?: string;
+  dataTestId?: string;
+  ariaActivedescendant?: string;
+  onKeyDown?: (event: React.KeyboardEvent<HTMLInputElement>) => void;
+  onChange: (newValue: string) => void;
+  onFocus?: (event: React.FocusEvent<HTMLInputElement>) => void;
+  onBlur?: (event: React.FocusEvent<HTMLInputElement>) => void;
+}
+
+export const SearchInput = React.forwardRef<HTMLInputElement, SearchInputProps>(
+  (
+    {
+      searchInputVariant = 'standard',
+      value,
+      placeholder,
+      suggestions,
+      className,
+      dataTestId,
+      ariaActivedescendant,
+      onKeyDown,
+      onChange,
+      onFocus,
+      onBlur,
+    },
+    ref,
+  ) => {
+    const localInputRef = useRef<HTMLInputElement>(null);
+
+    const {
+      searchInputClasses: inputClassName,
+      searchInputIconColor: iconColor,
+      searchInputBorderColor: borderColor,
+      searchInputCloseIconClasses: closeIconClasses,
+      searchInputActiveStarClasses,
+      placeholderVariant,
+    } = searchInputVariantClasses[searchInputVariant];
+
+    // Expose the local ref through the forwarded ref
+    useImperativeHandle(ref, () => localInputRef.current!, []);
+    const magnifyingGlassClassesBase = [
+      'spiffy-tw-w-[24px]',
+      'spiffy-tw-h-[32px]',
+      'spiffy-tw-stroke-width-1',
+      'sm:spiffy-tw-w-[32px]',
+    ];
+
+    const magnifyingGlassClassesInactive = classNames(magnifyingGlassClassesBase);
+
+    const magnifyingGlassClassesActive = classNames([
+      ...magnifyingGlassClassesBase,
+      searchInputActiveStarClasses,
+    ]);
+
+    const containerClasses = classNames(
+      'spiffy-global-search-input-container',
+      'spiffy-tw-relative spiffy-tw-flex spiffy-tw-items-center',
+      className,
+    );
+
+    const inputClasses = classNames(
+      'spiffy-global-search-input',
+      'spiffy-tw-flex-grow spiffy-tw-p-2 spiffy-tw-px-[42px] sm:spiffy-tw-p-3 sm:spiffy-tw-px-[48px]',
+      'spiffy-tw-border',
+      'spiffy-tw-text-base',
+      inputClassName,
+    );
+    const closeButtonIconClassName = classNames([
+      'spiffy-tw-w-[16px]',
+      'spiffy-tw-h-[16px]',
+      'sm:spiffy-tw-w-[24px]',
+      'sm:spiffy-tw-h-[24px]',
+      'spiffy-tw-cursor-pointer',
+      closeIconClasses,
+    ]);
+
+    return (
+      <div className={containerClasses} data-testid={dataTestId}>
+        <div className="spiffy-tw-absolute spiffy-tw-left-3 spiffy-tw-top-1/2 spiffy-tw--translate-y-1/2">
+          <MagnifyingGlassStarVariant
+            className={
+              value.length > 0 ? magnifyingGlassClassesActive : magnifyingGlassClassesInactive
+            }
+            stroke={iconColor}
+            strokeWidth="1px"
+          />
+        </div>
+        <TextInput
+          value={value}
+          onChange={(event: React.ChangeEvent<HTMLInputElement>) => onChange(event.target.value)}
+          onFocus={onFocus}
+          onBlur={onBlur}
+          onKeyDown={onKeyDown}
+          placeholder={placeholder}
+          className={inputClasses}
+          placeholderVariant={placeholderVariant}
+          aria-label="Search"
+          aria-autocomplete="list"
+          aria-expanded={!!suggestions && suggestions.length > 0}
+          aria-controls="autocomplete-results"
+          aria-activedescendant={ariaActivedescendant}
+          borderRadius="xl"
+          borderColorClass={borderColor}
+          ref={localInputRef}
+        />
+
+        {value && (
+          <button
+            onClick={() => {
+              onChange('');
+              localInputRef.current?.focus();
+            }}
+            className="spiffy-tw-absolute spiffy-tw-right-5 spiffy-tw-top-1/2 spiffy-tw--translate-y-1/2 spiffy-tw-text-neutral-500 hover:spiffy-tw-text-neutral-700"
+            aria-label="Clear search input"
+            type="button"
+          >
+            <CloseIcon className={closeButtonIconClassName} />
+          </button>
+        )}
+      </div>
+    );
+  },
+);

package/src/components/search/SearchInput/searchInputVariants.ts

@@ -0,0 +1,27 @@
+import type { TextStyleVariantMap } from 'src/components/common/Text/textVariantClasses';
+import type { SearchInputVariant } from '../SearchInputForm/types';
+import { ColorNames, colorVar } from 'src/components/models/colorsConfig';
+
+interface SearchInputVariantClasses {
+  searchInputIconColor: string;
+  searchInputBorderColor: string;
+  searchInputCloseIconClasses: string;
+  searchInputActiveStarClasses: string;
+  autocompleteIconColor: string;
+  searchInputClasses: string;
+  placeholderVariant: keyof typeof TextStyleVariantMap;
+}
+
+export const searchInputVariantClasses: Record<SearchInputVariant, SearchInputVariantClasses> = {
+  standard: {
+    searchInputIconColor: 'transparent', // colorVar(ColorNames.TextSecondary),
+    searchInputBorderColor: 'spiffy-tw-border-[--spiffy-colors-border-medium]',
+    searchInputCloseIconClasses:
+      '[&>circle]:spiffy-tw-fill-[--spiffy-colors-text-secondary] [&>path]:spiffy-tw-fill-[#fff]',
+    searchInputActiveStarClasses: `first:[&>path]:spiffy-tw-stroke-[--spiffy-colors-accent-primary] first:[&>path]:spiffy-tw-fill-[--spiffy-colors-accent-primary]`,
+    autocompleteIconColor: colorVar(ColorNames.BackgroundPrimary),
+    searchInputClasses:
+      'spiffy-tw-text-[--spiffy-colors-text-primary] placeholder:spiffy-tw-text-[--spiffy-colors-text-secondary] spiffy-tw-text-[16px] spiffy-tw-font-normal spiffy-tw-leading-[148%] placeholder:spiffy-tw-font-medium placeholder:spiffy-tw-leading-[124%]',
+    placeholderVariant: 'h2',
+  },
+};

package/src/components/search/SearchInputAutocomplete/SearchAutocomplete.tsx

@@ -0,0 +1,62 @@
+import React from 'react';
+import { motion } from 'framer-motion';
+import classNames from 'classnames';
+import OutlinedStar from '@envive-ai/react-icons/src/OutlinedStar';
+
+interface GlobalSearchAutocompleteProps {
+  id: string;
+  results: string[];
+  focusedIndex: number;
+  onSuggestionSelect: (suggestion: string, rankPosition: number) => void;
+  iconColor?: string;
+}
+
+export const SearchAutocomplete: React.FC<GlobalSearchAutocompleteProps> = ({
+  id,
+  results,
+  focusedIndex,
+  onSuggestionSelect,
+  iconColor,
+}) => {
+  if (results.length === 0) {
+    return null;
+  }
+
+  return (
+    <motion.div
+      className="spiffy-tw-h-full"
+      initial={{ opacity: 0, y: -10 }}
+      animate={{ opacity: 1, y: 0 }}
+      exit={{ opacity: 0, y: -10 }}
+      transition={{ duration: 0.2 }}
+    >
+      <ul id={id} role="listbox" className="spiffy-tw-mt-4 spiffy-tw-space-y-2">
+        {results.map((result, index) => (
+          <li
+            key={index}
+            id={`option-${index}`}
+            role="option"
+            aria-selected={index === focusedIndex}
+            className={classNames(
+              'spiffy-tw-flex spiffy-tw-items-center spiffy-tw-cursor-pointer spiffy-tw-py-1',
+              { 'spiffy-tw-bg-neutral-200': index === focusedIndex },
+              'hover:spiffy-tw-bg-neutral-100',
+            )}
+            onClick={() => onSuggestionSelect(result, index)}
+            onKeyDown={(event) => {
+              if (event.key === 'Enter' || event.keyCode === 13) {
+                onSuggestionSelect(result, index);
+              }
+            }}
+          >
+            <OutlinedStar
+              className="spiffy-tw-w-[16px] spiffy-tw-h-[16px] spiffy-tw-mr-2"
+              fill={iconColor}
+            />
+            <span className="spiffy-tw-font-bold">{result}</span>
+          </li>
+        ))}
+      </ul>
+    </motion.div>
+  );
+};

package/src/components/search/SearchInputForm/SearchInputForm.tsx

@@ -0,0 +1,66 @@
+import type { SearchInputVariant } from './types';
+import { SearchAutocomplete } from '../SearchInputAutocomplete/SearchAutocomplete';
+import { searchInputVariantClasses } from '../SearchInput/searchInputVariants';
+import { SearchInput } from '../SearchInput/SearchInput';
+
+interface SearchInputFormProps {
+  searchInputVariant: SearchInputVariant;
+  searchText: string;
+  autocompleteResults: string[];
+  searchBoxPlaceholder: string;
+  focusedOptionId: string | undefined;
+  isDirty: boolean;
+  focusedIndex: number;
+  onKeyDown: (event: React.KeyboardEvent<HTMLInputElement>) => void;
+  onAutocompleteSelect: (suggestion: string) => void;
+  onSearchInputChange: (value: string) => void;
+  onSearchSubmit: () => void;
+}
+
+export const SearchInputForm = ({
+  searchInputVariant,
+  searchText,
+  autocompleteResults,
+  searchBoxPlaceholder,
+  focusedOptionId,
+  isDirty,
+  focusedIndex,
+  onKeyDown,
+  onAutocompleteSelect,
+  onSearchInputChange,
+  onSearchSubmit,
+}: SearchInputFormProps) => {
+  const { searchInputIconColor } = searchInputVariantClasses[searchInputVariant];
+
+  return (
+    <>
+      <form
+        onSubmit={(e) => {
+          e.preventDefault();
+          onSearchSubmit();
+        }}
+        className="spiffy-tw-grow"
+      >
+        <SearchInput
+          value={searchText}
+          placeholder={searchBoxPlaceholder}
+          suggestions={autocompleteResults}
+          ariaActivedescendant={focusedOptionId}
+          searchInputVariant={searchInputVariant}
+          // dataTestId={SEARCH_INPUT_TESTID}
+          onKeyDown={onKeyDown}
+          onChange={onSearchInputChange}
+        />
+      </form>
+      {isDirty && (
+        <SearchAutocomplete
+          id="autocomplete-results"
+          results={autocompleteResults}
+          focusedIndex={focusedIndex}
+          iconColor={searchInputIconColor}
+          onSuggestionSelect={onAutocompleteSelect}
+        />
+      )}
+    </>
+  );
+};

package/src/components/search/SearchResultsFilterSidebar/SearchResultsFilter.tsx

@@ -0,0 +1,82 @@
+import { useCallback } from 'react';
+
+import { SearchFilter } from '../SearchFilter/SearchFilter';
+import { SearchFilterHeader } from '../SearchFilter/SearchFilterHeader';
+import type { SearchFilter as SearchFilterType, SelectFilterItem } from '../SearchFilter/types';
+import type { SearchFilterSidebarVariant } from './types';
+import { searchFilterSidebarVariantClasses } from './searchFilterSidebarVariants';
+import { ButtonBase } from 'src/components/common/ButtonBase/ButtonBase';
+
+export type SearchResultsFilterProps = {
+  productCount: number;
+  isOpen: boolean;
+  setIsOpen: (isOpen: boolean) => void;
+  searchFilters: SearchFilterType[];
+  searchFilterSidebarVariant: SearchFilterSidebarVariant;
+  searchText: string;
+  onSelectFilterItem: SelectFilterItem;
+  onClearAllFilters: () => void;
+  filterButtonText: string;
+};
+
+export const SearchResultsFilter = ({
+  productCount,
+  isOpen,
+  setIsOpen,
+  searchFilters,
+  searchFilterSidebarVariant,
+  onSelectFilterItem,
+  onClearAllFilters,
+  filterButtonText,
+}: SearchResultsFilterProps) => {
+  const {
+    applyFiltersUnchangedClasses,
+    applyFiltersChangedClasses,
+    searchFilterHeaderClasses,
+    radioButtonFillColor,
+    radioButtonHoverColor,
+    radioButtonUncheckedBorderColor,
+    filterCloseIconVariant,
+  } = searchFilterSidebarVariantClasses[searchFilterSidebarVariant];
+
+  const openFilter = useCallback(() => {
+    setIsOpen(true);
+  }, [setIsOpen]);
+
+  return (
+    <>
+      <SearchFilter
+        isOpen={isOpen}
+        setIsOpen={setIsOpen}
+        filters={searchFilters}
+        productCount={productCount}
+        selectFilterItem={onSelectFilterItem}
+        clearAllFilters={onClearAllFilters}
+        applyFiltersUnchangedClasses={applyFiltersUnchangedClasses}
+        applyFiltersChangedClasses={applyFiltersChangedClasses}
+        filterButtonText={filterButtonText}
+        radioButtonFillColor={radioButtonFillColor}
+        radioButtonHoverColor={radioButtonHoverColor}
+        radioButtonUncheckedBorderColor={radioButtonUncheckedBorderColor}
+        filterCloseIconVariant={filterCloseIconVariant}
+        headerContent={
+          <SearchFilterHeader
+            closeModal={() => setIsOpen(false)}
+            productCount={productCount}
+            headerClassName={searchFilterHeaderClasses}
+            filterCloseIconVariant={filterCloseIconVariant}
+          />
+        }
+      />
+      <ButtonBase
+        onClick={openFilter}
+        // icon={SettingsVariant} // Icon is handled by user
+        iconClass="spiffy-tw-w-[28px] spiffy-tw-h-[28px] spiffy-tw-object-center"
+        text={filterButtonText}
+        textClass="spiffy-tw-uppercase spiffy-tw-text-[--spiffy-colors-text-primary] spiffy-tw-hidden md:spiffy-tw-block"
+        buttonClass="spiffy-tw-flex-row spiffy-tw-pl-[16px] sm:spiffy-tw-pl-0 sm:spiffy-tw-px-4 sm:spiffy-tw-gap-[8px]"
+        disablePadding
+      />
+    </>
+  );
+};

package/src/components/search/SearchResultsFilterSidebar/searchFilterSidebarVariants.ts

@@ -0,0 +1,45 @@
+import type { SearchFilterSidebarVariant, CloseIconVariant } from './types';
+import { ColorNames, colorVar } from 'src/components/models/colorsConfig';
+
+interface SearchFilterSidebarVariantClasses {
+  searchFilterHeaderClasses: string;
+  radioButtonFillColor: string;
+  radioButtonHoverColor: string;
+  radioButtonUncheckedBorderColor: string;
+  filterDefaultClasses: string;
+  filterActiveClasses: string;
+  filterHoverClasses: string;
+  appliedFilterBackgroundClasses: string;
+  applyFiltersUnchangedClasses: string;
+  applyFiltersChangedClasses: string;
+  filterCloseIconVariant: CloseIconVariant;
+}
+
+export const searchFilterSidebarVariantClasses: Record<SearchFilterSidebarVariant, SearchFilterSidebarVariantClasses> = {
+  darkButton: {
+    radioButtonFillColor: colorVar(ColorNames.BackgroundDark),
+    radioButtonHoverColor: colorVar(ColorNames.BackgroundSecondaryDark),
+    radioButtonUncheckedBorderColor: colorVar(ColorNames.BorderMedium),
+    searchFilterHeaderClasses: 'spiffy-tw-text-[--spiffy-colors-text-light]',
+    filterDefaultClasses: 'spiffy-tw-border-[--spiffy-colors-border-medium] spiffy-tw-bg-[--spiffy-colors-background-light] spiffy-tw-text-[--spiffy-colors-text-secondary]',
+    filterHoverClasses: 'hover:spiffy-tw-border-[--spiffy-colors-background-secondary-dark] hover:spiffy-tw-bg-[--spiffy-colors-background-secondary-dark] hover:spiffy-tw-text-[--spiffy-colors-text-primary]',
+    filterActiveClasses: 'spiffy-tw-border-[--spiffy-colors-border-outline] spiffy-tw-bg-[--spiffy-colors-background-dark] spiffy-tw-text-[--spiffy-colors-text-light]',
+    appliedFilterBackgroundClasses: 'spiffy-tw-bg-[--spiffy-colors-border-light]',
+    applyFiltersUnchangedClasses: 'spiffy-tw-bg-[--spiffy-colors-border-light] spiffy-tw-text-[--spiffy-colors-text-secondary]',
+    applyFiltersChangedClasses: 'spiffy-tw-bg-[--spiffy-colors-background-dark] spiffy-tw-text-[--spiffy-colors-text-light]',
+    filterCloseIconVariant: 'light',
+  },
+  lightButton: {
+    radioButtonFillColor: colorVar(ColorNames.BackgroundDark),
+    radioButtonHoverColor: colorVar(ColorNames.BackgroundSecondaryDark),
+    radioButtonUncheckedBorderColor: colorVar(ColorNames.BorderMedium),
+    searchFilterHeaderClasses: 'spiffy-tw-text-[--spiffy-colors-text-primary]',
+    filterDefaultClasses: 'spiffy-tw-border-[--spiffy-colors-border-medium] spiffy-tw-bg-[--spiffy-colors-background-light] spiffy-tw-text-[--spiffy-colors-text-secondary]',
+    filterHoverClasses: 'hover:spiffy-tw-border-[--spiffy-colors-background-secondary-dark] hover:spiffy-tw-bg-[--spiffy-colors-background-secondary-dark] hover:spiffy-tw-text-[--spiffy-colors-text-primary]',
+    filterActiveClasses: 'spiffy-tw-border-[--spiffy-colors-border-outline] spiffy-tw-bg-[--spiffy-colors-background-dark] spiffy-tw-text-[--spiffy-colors-text-light]',
+    appliedFilterBackgroundClasses: 'spiffy-tw-bg-[--spiffy-colors-border-light]',
+    applyFiltersUnchangedClasses: 'spiffy-tw-bg-[--spiffy-colors-border-light] spiffy-tw-text-[--spiffy-colors-text-secondary]',
+    applyFiltersChangedClasses: 'spiffy-tw-bg-[--spiffy-colors-background-primary] spiffy-tw-text-[--spiffy-colors-text-link]',
+    filterCloseIconVariant: 'dark',
+  },
+};

package/{dist/packages/components/src/components/search/SearchResultsFilterSidebar/types.d.ts → src/components/search/SearchResultsFilterSidebar/types.ts}

@@ -1,2 +1,2 @@
 export type SearchFilterSidebarVariant = 'darkButton' | 'lightButton';
-export type CloseIconVariant = 'light' | 'tertiary' | 'dark';
+export type CloseIconVariant = 'light' | 'tertiary' | 'dark';

package/src/components/search/SearchResultsStates/NoSearchResultsFound.tsx

@@ -0,0 +1,41 @@
+import classNames from 'classnames';
+import Sparkles from '@envive-ai/react-icons/src/Sparkles';
+import { Text } from 'src/components/common/Text/Text';
+
+interface NoSearchResultsFoundProps {
+  containerPaddingClasses: string;
+  includeBottomMargin?: boolean; // manually add about a page of bottom margin to push unsupressed content down
+  noResultsFoundText?: string;
+  sparkleIconColor?: string; // example format: var(--spiffy-colors-accent-primary)
+}
+
+export const NoSearchResultsFound = ({
+  containerPaddingClasses,
+  includeBottomMargin = false,
+  noResultsFoundText,
+  sparkleIconColor = 'var(--spiffy-colors-accent-primary)',
+}: NoSearchResultsFoundProps) => {
+  const containerClasses = classNames(
+    containerPaddingClasses,
+    includeBottomMargin ? 'spiffy-tw-mb-[100vh]' : '',
+    'spiffy-tw-mt-6',
+  );
+
+  const textPrompt =
+    noResultsFoundText ||
+    'I’m sorry, I wasn’t able to find an exact match. Try changing your filters or adjusting your search query.';
+
+  return (
+    <div className={containerClasses}>
+      <div className="spiffy-tw-flex spiffy-tw-items-start spiffy-tw-gap-2">
+        <div>
+          <Sparkles
+            className="spiffy-tw-w-[24px] spiffy-tw-h-[24px]"
+            style={{ color: sparkleIconColor }}
+          />
+        </div>
+        <Text variant="body2">{textPrompt}</Text>
+      </div>
+    </div>
+  );
+};

package/src/components/search/SearchResultsStates/SearchResultsGrid.tsx

@@ -0,0 +1,105 @@
+import { motion } from 'framer-motion';
+import type { SelectedFilterOption } from 'src/atoms/search/types';
+import classNames from 'classnames';
+import type { SearchResponseProduct } from 'src/types/external';
+import { ProductGrid } from 'src/components/common/ProductGrid/ProductGrid';
+import { AppliedFiltersScrollbar } from '../FilterScrollbar/AppliedFiltersScrollbar';
+import { DynamicFiltersScrollbar } from '../FilterScrollbar/DynamicFiltersScrollbar';
+import { searchFilterSidebarVariantClasses } from '../SearchResultsFilterSidebar/searchFilterSidebarVariants';
+import type { SearchFilterSidebarVariant } from '../SearchResultsFilterSidebar/types';
+import { ProductGridVariant } from 'src/components/common/ProductCard/types';
+
+interface SearchResultsGridProps {
+  productList: SearchResponseProduct[];
+  availableDynamicFilters: { name: string; displayName: string }[];
+  searchFilterSidebarVariant: SearchFilterSidebarVariant;
+  productGridVariant: ProductGridVariant;
+  selectedFilterOptions: SelectedFilterOption[];
+  searchResponseId: string;
+  containerXPaddingClasses: string;
+  productGridClasses: string;
+  onRemoveFilter: (filter: SelectedFilterOption) => void;
+  onToggleDynamicFilter: ({
+    filter,
+    dynamicFilterDisplayName,
+  }: {
+    filter: string;
+    dynamicFilterDisplayName: string;
+  }) => void;
+}
+
+export const SearchResultsGrid = ({
+  productList,
+  availableDynamicFilters,
+  searchFilterSidebarVariant,
+  productGridVariant,
+  selectedFilterOptions,
+  searchResponseId,
+  containerXPaddingClasses,
+  productGridClasses,
+  onRemoveFilter,
+  onToggleDynamicFilter,
+}: SearchResultsGridProps) => {
+  const sharedFilterBarClasses = classNames(
+    'spiffy-suggestion-bar',
+    'spiffy-tw-no-scrollbar',
+    'spiffy-tw-flex',
+    'spiffy-tw-flex-row',
+    'spiffy-tw-gap-2',
+    'spiffy-tw-mb-[16px]',
+    'spiffy-tw-overflow-x-scroll',
+    containerXPaddingClasses,
+  );
+
+  const filterBarClasses = classNames(sharedFilterBarClasses, 'spiffy-tw-mt-[24px]');
+
+  const appliedFilterBarClasses = classNames(
+    sharedFilterBarClasses,
+    'spiffy-tw-mb-[32px]',
+    'spiffy-tw-mt-[8px]',
+  );
+
+  const {
+    // We may want to pull these into their own variant separated from the filter sidebar (but also used in it) In this case, we need them for dynamic filters
+    filterDefaultClasses,
+    filterHoverClasses,
+    appliedFilterBackgroundClasses,
+  } = searchFilterSidebarVariantClasses[searchFilterSidebarVariant];
+
+  return (
+    <motion.div
+      className="spiffy-tw-justify-center spiffy-tw-w-full spiffy-tw-overflow-hidden"
+      initial={{ opacity: 0 }}
+      animate={{ opacity: 1 }}
+      exit={{ opacity: 0 }}
+      transition={{ duration: 0.2 }}
+    >
+      <AppliedFiltersScrollbar
+        selectedFilterOptions={selectedFilterOptions}
+        filterBarClassNames={appliedFilterBarClasses}
+        filterDefaultClasses={filterDefaultClasses}
+        filterHoverClasses={filterHoverClasses}
+        appliedFilterBackgroundClasses={appliedFilterBackgroundClasses}
+        onRemoveFilter={onRemoveFilter}
+      />
+      <DynamicFiltersScrollbar
+        availableDynamicFilters={availableDynamicFilters}
+        filterBarClassNames={filterBarClasses}
+        filterDefaultClasses={filterDefaultClasses}
+        filterHoverClasses={filterHoverClasses}
+        onToggleDynamicFilter={onToggleDynamicFilter}
+      />
+      <ProductGrid
+        productList={productList}
+        productGridVariant={productGridVariant}
+        productGridClasses={productGridClasses}
+        searchResponseId={searchResponseId}
+        merchantShortName={''}
+        handleClick={function (clickedUrl: string): void {
+          console.log(clickedUrl);
+          throw new Error('Function not implemented.');
+        }}
+      />
+    </motion.div>
+  );
+};

package/src/components/search/SearchResultsStates/SearchResultsLoadingGrid.tsx

@@ -0,0 +1,50 @@
+import { Text } from 'src/components/common/Text/Text';
+import { SparkleAnimation } from 'src/components/common/SparkleAnimation/SparkleAnimation';
+import { motion } from 'framer-motion';
+import { ProductGridVariant } from 'src/components/common/ProductCard/types';
+import { ProductCardSkeleton } from 'src/components/common/ProductCard/ProductCardSkeleton';
+import { productGridVariantClasses } from 'src/components/common/ProductGrid/productGridVariants';
+
+export const SearchResultsLoadingGrid = ({
+  productGridVariant,
+  productGridClasses,
+  sparkleIconColor = 'var(--spiffy-colors-accent-primary)',
+}: {
+  productGridVariant: ProductGridVariant;
+  productGridClasses: string;
+  sparkleIconColor?: string;
+}) => {
+  const { productCardLayoutVariant, productCardImageAspectRatio } =
+    productGridVariantClasses[productGridVariant];
+
+  return (
+    <motion.div
+      className="spiffy-tw-justify-center spiffy-tw-w-full spiffy-tw-overflow-hidden"
+      initial={{ opacity: 0 }}
+      animate={{ opacity: 1 }}
+      exit={{ opacity: 0 }}
+      transition={{ duration: 0.2 }}
+    >
+      <div className="spiffy-tw-mt-6 spiffy-tw-w-full">
+        <div className="spiffy-tw-flex spiffy-tw-items-center spiffy-tw-justify-between spiffy-tw-mb-4">
+          <div className="spiffy-tw-flex spiffy-tw-items-center spiffy-tw-gap-2 spiffy-tw-ml-[16px] md:spiffy-tw-ml-[80px]">
+            <div className="spiffy-tw-width-[24px]">
+              <SparkleAnimation color={sparkleIconColor} animate={true} />
+            </div>
+            <Text variant="body2">Finding the best options for you...</Text>
+          </div>
+        </div>
+        <div className={productGridClasses}>
+          {Array.from({ length: 8 }).map((_, index) => (
+            <ProductCardSkeleton
+              key={index}
+              layoutVariant={productCardLayoutVariant}
+              aspectRatio={productCardImageAspectRatio}
+              growWithContainer={true}
+            />
+          ))}
+        </div>
+      </div>
+    </motion.div>
+  );
+};

package/src/components/search/types.ts

@@ -0,0 +1,5 @@
+export enum SearchResultsState {
+  NoResults = 'noResults',
+  Results = 'results',
+  Loading = 'loading',
+}

package/{dist/packages/components/src/components/test/types.d.ts → src/components/test/types.ts}

@@ -1,3 +1,3 @@
 export interface TestProps {
-    dataTestId?: string;
+  dataTestId?: string;
 }

package/src/config/chatElementDisplayLocation.ts

@@ -0,0 +1,22 @@
+// Chat element display location enum
+export enum ChatElementDisplayLocation {
+  IN_CHAT = 'in_chat',
+  CHAT_PREVIEW = 'chat_preview',
+  FLOATING_BUTTON = 'floating_button',
+  HELP_ME_CHOOSE = 'help_me_choose',
+  PLP_IMAGE_BANNER = 'plp_image_banner',
+  TOP_REVIEWS_SNIPPET = 'top_reviews_snippet',
+  BOTTOM_REVIEWS_SNIPPET = 'bottom_reviews_snippet',
+  BLOCK_BACK_BUTTON = 'block_back_button',
+  SWITCH_TO_AGENT = 'switch_to_agent',
+  CONVERSATIONAL_SEARCH = 'conversational_search',
+  GLOBAL_SEARCH_ENTRYPOINT = 'global_search_entrypoint',
+  SEARCH_NAV_ENTRYPOINT = 'search_nav_entrypoint',
+  SEARCH_PROMPT = 'search_prompt',
+  SEARCH_PROMPT_BUTTON = 'search_prompt_button',
+  PRODUCT_GRID = 'product_grid',
+  UNSPECIFIED = 'unspecified',
+  FILTER_MODAL = 'filter_modal',
+  PROMPT_CARD = 'prompt_card',
+  WINDOW_API_CALL = 'window_api_call',
+}