@envive-ai/react-toolkit 0.1.0 → 0.1.1

package/src/components/common/ProductCard/productCardVariants.ts

@@ -0,0 +1,63 @@
+import type {
+  ProductCardVariant,
+  ProductCardHoverVariant,
+  ProductCardLayoutVariant,
+} from './types';
+
+/**
+ * Shared variant mapping configurations for ProductCard components
+ */
+
+export const variantClassMap = new Map<ProductCardVariant, string[]>([
+  ['filled', ['spiffy-tw-bg-[--spiffy-colors-background-secondary]', 'spiffy-tw-shadow-md']],
+  [
+    'bordered',
+    [
+      'spiffy-tw-bg-[--spiffy-colors-background-secondary]',
+      'spiffy-tw-border',
+      'spiffy-tw-border-[--spiffy-colors-border-light]',
+    ],
+  ],
+  ['minimal', ['spiffy-tw-bg-transparent']],
+  [
+    'transparentBordered',
+    [
+      'spiffy-tw-bg-transparent',
+      'spiffy-tw-border',
+      'spiffy-tw-border-[--spiffy-colors-border-light]',
+    ],
+  ],
+]);
+
+export const variantHoverClassMap = new Map<ProductCardHoverVariant, string[]>([
+  ['backgroundDark', ['hover:spiffy-tw-bg-[--spiffy-colors-background-secondary-dark]']],
+  ['none', []],
+]);
+
+export const variantTitleColorMap = new Map<ProductCardVariant, string>([
+  ['filled', 'spiffy-tw-text-[--spiffy-colors-text-link]'],
+  ['bordered', 'spiffy-tw-text-[--spiffy-colors-text-primary]'],
+  ['minimal', 'spiffy-tw-text-[--spiffy-colors-text-primary]'],
+  ['transparentBordered', 'spiffy-tw-text-[--spiffy-colors-text-primary]'],
+]);
+
+export const productCardLayoutVariantClasses: Record<
+  ProductCardLayoutVariant,
+  Record<string, string[]>
+> = {
+  normal: {
+    productTitle: ['spiffy-product-card-title'],
+    container: ['spiffy-tw-w-[208px]'],
+    verticalContainer: ['spiffy-tw-rounded-[8px]', 'spiffy-tw-h-[268px]'],
+  },
+  tall: {
+    productTitle: ['spiffy-product-card-title-tall', 'spiffy-tw-pt-[8px]'],
+    container: ['spiffy-tw-w-[160px] lg:spiffy-tw-w-[300px]'],
+    verticalContainer: ['lg:spiffy-tw-h-[496px]'],
+  },
+  square: {
+    productTitle: ['spiffy-product-card-title-tall', 'spiffy-tw-pt-[8px]'],
+    container: ['spiffy-tw-w-[160px] lg:spiffy-tw-w-[280px]'],
+    verticalContainer: ['lg:spiffy-tw-h-[400px]'],
+  },
+};

package/src/components/common/ProductCard/types.ts

@@ -0,0 +1,49 @@
+import type { ResponseCategory, SearchResponseProduct } from 'src/types/external';
+import type { CamelCasedPropertiesDeep } from 'src/util/camelCasedPropertiesDeep';
+
+export enum ProductCardSkeletonOverrides {
+  PRODUCT_CARD_SKELETON_CONTAINER = 'spiffy-product-card-skeleton-container',
+  PRODUCT_CARD_SKELETON = 'spiffy-product-card-skeleton',
+}
+
+export enum AnimatedProductCardOverrides {
+  PRODUCT_CARD_ANIMATED_CONTAINER = 'spiffy-product-card-animated-container',
+  PRODUCT_CARD_ANIMATED_IMAGE_CONTAINER = 'spiffy-product-card-animated',
+}
+
+export type ProductGridVariant = 'standard' | 'square';
+
+export type ProductCardVariant = 'filled' | 'bordered' | 'minimal' | 'transparentBordered';
+
+export type ProductCardHoverVariant = 'backgroundDark' | 'none';
+
+export type ProductCardLayoutVariant = 'normal' | 'tall' | 'square';
+export type ProductCardImageAspectRatio = '1/1' | '4/3' | '3/4' | '16/9' | '9/16';
+
+export interface ProductCardConfig {
+  variant: ProductCardVariant;
+  hoverVariant: ProductCardHoverVariant;
+  layoutVariant: ProductCardLayoutVariant;
+  pricePrefix?: string;
+}
+
+export interface SearchResponseProductAttributes {
+  category: ResponseCategory.Product;
+  attributes: CamelCasedPropertiesDeep<SearchResponseProduct>;
+}
+
+export interface ProductCardSkeletonProps {
+  layoutVariant: ProductCardLayoutVariant;
+  aspectRatio: ProductCardImageAspectRatio;
+  growWithContainer?: boolean;
+}
+
+export interface ProductGridProps {
+  productList: SearchResponseProductAttributes['attributes'][];
+  productGridVariant: ProductGridVariant;
+  productGridClasses: string;
+  productCardConfig?: ProductCardConfig;
+  merchantShortName: string;
+  searchResponseId: string;
+  cardsGrowWithContainer?: boolean;
+}

package/src/components/common/ProductGrid/ProductGrid.tsx

@@ -0,0 +1,73 @@
+import type { ProductCardConfig, ProductGridVariant } from '../ProductCard/types';
+import { ProductCard } from '../ProductCard/ProductCard';
+import { productGridVariantClasses } from './productGridVariants';
+import classNames from 'classnames';
+import { ChatElementDisplayLocation } from 'src/config/chatElementDisplayLocation';
+import { SearchResponseProduct } from 'src/types/external';
+
+interface ProductGridProps {
+  productList: SearchResponseProduct[];
+  productGridVariant: ProductGridVariant;
+  productGridClasses: string;
+  productCardConfig?: ProductCardConfig;
+  merchantShortName: string;
+  searchResponseId: string;
+  cardsGrowWithContainer?: boolean;
+  handleClick: (clickedUrl: string) => void;
+}
+
+export const ProductGrid = ({
+  productList,
+  productGridVariant,
+  productGridClasses,
+  productCardConfig,
+  merchantShortName,
+  searchResponseId,
+  cardsGrowWithContainer = true,
+  handleClick,
+}: ProductGridProps) => {
+  const {
+    productCardVariant,
+    productCardHoverVariant,
+    productCardLayoutVariant,
+    productCardImageAspectRatio,
+    zoomOnHover,
+  } = productGridVariantClasses[productGridVariant];
+
+  const cardContainerClasses = classNames({
+    'spiffy-tw-w-full': cardsGrowWithContainer,
+    'spiffy-tw-h-full': cardsGrowWithContainer,
+  });
+
+  return (
+    <div className={productGridClasses}>
+      {productList.map((product: (typeof productList)[0], index: number) => (
+        <div key={product.id} className={cardContainerClasses}>
+          <ProductCard
+            productCardConfig={productCardConfig}
+            merchantShortName={merchantShortName}
+            key={product.id}
+            imageUrl={product.imageUrl}
+            searchResponseId={searchResponseId}
+            productResponseId={product.responseId}
+            title={product.title}
+            url={product.url}
+            originalPrice={product.originalPrice}
+            salePrice={product.salePrice}
+            averageRating={product.averageRating}
+            numberReviews={product.numberReviews}
+            cardDisplayLocation={ChatElementDisplayLocation.PRODUCT_GRID}
+            layoutVariant={productCardLayoutVariant}
+            variant={productCardVariant}
+            hoverVariant={productCardHoverVariant}
+            zoomOnHover={zoomOnHover}
+            aspectRatio={productCardImageAspectRatio}
+            clickPosition={index}
+            growWithContainer={cardsGrowWithContainer}
+            handleClick={handleClick}
+          />
+        </div>
+      ))}
+    </div>
+  );
+};

package/src/components/common/ProductGrid/productGridVariants.ts

@@ -0,0 +1,31 @@
+import type {
+  ProductCardHoverVariant,
+  ProductCardLayoutVariant,
+  ProductCardVariant,
+  ProductGridVariant,
+} from '../ProductCard/types';
+
+interface ProductGridVariantClasses {
+  productCardVariant: ProductCardVariant;
+  productCardHoverVariant: ProductCardHoverVariant;
+  productCardLayoutVariant: ProductCardLayoutVariant;
+  productCardImageAspectRatio: '3:4' | 'square' | 'none';
+  zoomOnHover: boolean;
+}
+
+export const productGridVariantClasses: Record<ProductGridVariant, ProductGridVariantClasses> = {
+  standard: {
+    productCardVariant: 'minimal',
+    productCardHoverVariant: 'backgroundDark',
+    productCardLayoutVariant: 'tall',
+    productCardImageAspectRatio: '3:4',
+    zoomOnHover: true,
+  },
+  square: {
+    productCardVariant: 'minimal',
+    productCardHoverVariant: 'backgroundDark',
+    productCardLayoutVariant: 'square',
+    productCardImageAspectRatio: 'square',
+    zoomOnHover: true,
+  },
+};

package/src/components/common/SparkleAnimation/SparkleAnimation.tsx

@@ -0,0 +1,105 @@
+import { useEffect, useState } from 'react';
+import { type Transition, motion } from 'framer-motion';
+import classNames from 'classnames';
+
+import FourPointStar from '@envive-ai/react-icons/src/FourPointStar';
+import { SparkleAnimationOverride } from './types';
+
+// Animation timing constants
+const ANIMATION_CYCLE_TIME = 1000; // 1 second between cycles
+const STAR_DELAY_OFFSET = 250; // 250ms delay between each star
+
+interface SparkleAnimationProps {
+  color: string;
+  className?: string;
+  animate?: boolean; // Whether to animate the sparkles, defaults to true
+}
+
+export const SparkleAnimation = ({ color, className, animate = true }: SparkleAnimationProps) => {
+  // Star visibility states - start visible if not animating, invisible if animating
+  const [mainStarScale, setMainStarScale] = useState(animate ? 0 : 1);
+  const [smallStar1Scale, setSmallStar1Scale] = useState(animate ? 0 : 1);
+  const [smallStar2Scale, setSmallStar2Scale] = useState(animate ? 0 : 1);
+
+  // Container: 24px x 24px with relative positioning
+  const containerClasses = classNames(
+    SparkleAnimationOverride.CONTAINER,
+    'spiffy-tw-w-6 spiffy-tw-h-6 spiffy-tw-relative',
+    className,
+  );
+
+  // When animation is disabled, ensure all stars are visible
+  useEffect(() => {
+    if (!animate) {
+      setMainStarScale(1);
+      setSmallStar1Scale(1);
+      setSmallStar2Scale(1);
+      return;
+    }
+  }, [animate]);
+
+  // Animation cycle effect
+  useEffect(() => {
+    if (!animate) return;
+
+    // Toggle between visible (1) and invisible (0)
+    const newScale = mainStarScale === 1 ? 0 : 1;
+
+    // Stagger the star animations
+    setTimeout(() => setMainStarScale(newScale), ANIMATION_CYCLE_TIME);
+    setTimeout(() => setSmallStar1Scale(newScale), ANIMATION_CYCLE_TIME + STAR_DELAY_OFFSET);
+    setTimeout(() => setSmallStar2Scale(newScale), ANIMATION_CYCLE_TIME + 2 * STAR_DELAY_OFFSET);
+  }, [mainStarScale, animate]);
+
+  // Animation transition settings
+  const starTransition: Transition = { duration: 0.3, ease: 'easeOut' };
+
+  return (
+    <div className={containerClasses}>
+      {/* Main star - center, slightly above container */}
+      <div
+        className={classNames(
+          SparkleAnimationOverride.STAR_ONE_CONTAINER,
+          'spiffy-tw-absolute -spiffy-tw-top-[2px] spiffy-tw-left-0',
+        )}
+      >
+        <motion.div animate={{ scale: mainStarScale }} transition={starTransition}>
+          <FourPointStar
+            fill={color}
+            className="spiffy-tw-w-4 spiffy-tw-h-4 spiffy-tw-inline-block"
+          />
+        </motion.div>
+      </div>
+
+      {/* Small star 1 - upper right */}
+      <div
+        className={classNames(
+          SparkleAnimationOverride.STAR_TWO_CONTAINER,
+          'spiffy-tw-absolute -spiffy-tw-top-[7px] spiffy-tw-left-[10px]',
+        )}
+      >
+        <motion.div animate={{ scale: smallStar1Scale }} transition={starTransition}>
+          <FourPointStar
+            fill={color}
+            className="spiffy-tw-w-2 spiffy-tw-h-2 spiffy-tw-inline-block"
+          />
+        </motion.div>
+      </div>
+
+      {/* Small star 2 - lower right */}
+      <div
+        className={classNames(
+          SparkleAnimationOverride.STAR_THREE_CONTAINER,
+          'spiffy-tw-absolute spiffy-tw-top-[1px] spiffy-tw-left-[12px]',
+        )}
+      >
+        <motion.div animate={{ scale: smallStar2Scale }} transition={starTransition}>
+          <FourPointStar
+            fill={color}
+            className="spiffy-tw-w-2 spiffy-tw-h-2 spiffy-tw-inline-block"
+          />
+        </motion.div>
+      </div>
+    </div>
+  );
+};

package/src/components/common/SparkleAnimation/types.ts

@@ -0,0 +1,6 @@
+export enum SparkleAnimationOverride {
+  CONTAINER = 'spiffy-sparkle-animation-container',
+  STAR_ONE_CONTAINER = 'spiffy-sparkle-animation-star-one-container',
+  STAR_TWO_CONTAINER = 'spiffy-sparkle-animation-star-two-container',
+  STAR_THREE_CONTAINER = 'spiffy-sparkle-animation-star-three-container',
+}

package/src/components/common/Spinner/Spinner.tsx

@@ -0,0 +1,30 @@
+import classNames from "classnames";
+
+type SpinnerProps = {
+  className?: string;
+}
+
+export const Spinner = ({ className }: SpinnerProps) => {
+  const svgClassnames = classNames({
+    'spiffy-tw-w-4': true,
+    'spiffy-tw-h-4': true,
+    'spiffy-tw-text-gray-200': true,
+    'spiffy-tw-animate-spin': true,
+    'spiffy-tw-dark:text-gray-600': true,
+    'spiffy-tw-fill-black': true,
+  }, className);
+
+  const spanClassnames = classNames({
+    'spiffy-tw-sr-only': true,
+  });
+
+  return (
+    <div role="status">
+      <svg aria-hidden="true" className={svgClassnames} viewBox="0 0 100 101" fill="none" xmlns="http://www.w3.org/2000/svg">
+        <path d="M100 50.5908C100 78.2051 77.6142 100.591 50 100.591C22.3858 100.591 0 78.2051 0 50.5908C0 22.9766 22.3858 0.59082 50 0.59082C77.6142 0.59082 100 22.9766 100 50.5908ZM9.08144 50.5908C9.08144 73.1895 27.4013 91.5094 50 91.5094C72.5987 91.5094 90.9186 73.1895 90.9186 50.5908C90.9186 27.9921 72.5987 9.67226 50 9.67226C27.4013 9.67226 9.08144 27.9921 9.08144 50.5908Z" fill="currentColor"/>
+        <path d="M93.9676 39.0409C96.393 38.4038 97.8624 35.9116 97.0079 33.5539C95.2932 28.8227 92.871 24.3692 89.8167 20.348C85.8452 15.1192 80.8826 10.7238 75.2124 7.41289C69.5422 4.10194 63.2754 1.94025 56.7698 1.05124C51.7666 0.367541 46.6976 0.446843 41.7345 1.27873C39.2613 1.69328 37.813 4.19778 38.4501 6.62326C39.0873 9.04874 41.5694 10.4717 44.0505 10.1071C47.8511 9.54855 51.7191 9.52689 55.5402 10.0491C60.8642 10.7766 65.9928 12.5457 70.6331 15.2552C75.2735 17.9648 79.3347 21.5619 82.5849 25.841C84.9175 28.9121 86.7997 32.2913 88.1811 35.8758C89.083 38.2158 91.5421 39.6781 93.9676 39.0409Z" fill="currentFill"/>
+      </svg>
+      <span className={spanClassnames}>Loading...</span>
+    </div>
+  );
+};

package/src/components/common/SuggestionButton/SuggestionButton.tsx

@@ -0,0 +1,258 @@
+import classNames from 'classnames';
+import OutlinedStar from '@envive-ai/react-icons/src/OutlinedStar';
+import FourPointStar from '@envive-ai/react-icons/src/FourPointStar';
+import type { SuggestionButtonVariant } from './types';
+import { ButtonBase } from '../ButtonBase/ButtonBase';
+import { TestProps } from '../../test/types';
+
+export const SPIFFY_SUGGESTION_BUTTON_QUESTION_CLASS = 'spiffy-suggestion-button-question-class';
+export const SPIFFY_SUGGESTION_BUTTON_ANSWER_CLASS = 'spiffy-suggestion-button-answer-class';
+export const SPIFFY_SUGGESTION_BUTTON_TEXT_CLASS = 'spiffy-suggestion-button-text-class';
+
+// Add a comment that includes the hover prefix so that tailwind will pickup and generate the right css
+// Common class patterns to avoid duplication
+const BORDER_CLASS = 'spiffy-tw-border'; // hover:spiffy-tw-border
+const TEXT_LINK_CLASSES = [
+  'spiffy-tw-text-[--spiffy-colors-text-link]', // hover:spiffy-tw-text-[--spiffy-colors-text-link]
+  'spiffy-tw-fill-[--spiffy-colors-text-link]', // hover:spiffy-tw-fill-[--spiffy-colors-text-link]
+  'spiffy-tw-stroke-[--spiffy-colors-text-link]', // hover:spiffy-tw-stroke-[--spiffy-colors-text-link]
+];
+const TEXT_LIGHT_CLASSES = [
+  'spiffy-tw-text-[--spiffy-colors-text-light]', // hover:spiffy-tw-text-[--spiffy-colors-text-light]
+  'spiffy-tw-fill-[--spiffy-colors-text-light]', // hover:spiffy-tw-fill-[--spiffy-colors-text-light]
+  'spiffy-tw-stroke-[--spiffy-colors-text-light]', // hover:spiffy-tw-stroke-[--spiffy-colors-text-light]
+];
+const TEXT_PRIMARY_CLASSES = [
+  'spiffy-tw-text-[--spiffy-colors-text-primary]', // hover:spiffy-tw-text-[--spiffy-colors-text-primary]
+  'spiffy-tw-fill-[--spiffy-colors-text-primary]', // hover:spiffy-tw-fill-[--spiffy-colors-text-primary]
+  'spiffy-tw-stroke-[--spiffy-colors-text-primary]', // hover:spiffy-tw-stroke-[--spiffy-colors-text-primary]
+];
+const ACCENT_PRIMARY_CLASSES = [
+  'spiffy-tw-fill-[--spiffy-colors-accent-primary]', // hover:spiffy-tw-fill-[--spiffy-colors-accent-primary]
+  'spiffy-tw-stroke-[--spiffy-colors-accent-primary]', // hover:spiffy-tw-stroke-[--spiffy-colors-accent-primary]
+];
+const DARK_BACKGROUND_CLASSES = [
+  'spiffy-tw-bg-[--spiffy-colors-background-dark]', // hover:spiffy-tw-bg-[--spiffy-colors-background-dark]
+  'spiffy-tw-border-[--spiffy-colors-background-dark]', // hover:spiffy-tw-border-[--spiffy-colors-background-secondary]
+];
+const SECONDARY_DARK_BACKGROUND_CLASSES = [
+  'spiffy-tw-bg-[--spiffy-colors-background-secondary-dark]', // hover:spiffy-tw-bg-[--spiffy-colors-background-secondary-dark]
+  'spiffy-tw-border-[--spiffy-colors-background-secondary-dark]', // hover:spiffy-tw-border-[--spiffy-colors-background-secondary-dark]
+];
+
+const variantClassMap = new Map<SuggestionButtonVariant, string[]>([
+  [
+    'outlined',
+    [
+      'spiffy-tw-border-[--spiffy-colors-border-outline]', // hover:spiffy-tw-border-[--spiffy-colors-border-outline]
+      ...TEXT_LINK_CLASSES,
+    ],
+  ],
+  [
+    'outlinedLight',
+    [
+      'spiffy-tw-border-[--spiffy-colors-border-outline]', // hover:spiffy-tw-border-[--spiffy-colors-border-outline]
+      'spiffy-tw-bg-[--spiffy-colors-background-light]', // hover:spiffy-tw-bg-[--spiffy-colors-background-light]
+      ...TEXT_LINK_CLASSES,
+      BORDER_CLASS,
+    ],
+  ],
+  [
+    'primary',
+    [
+      'spiffy-tw-bg-[--spiffy-colors-background-primary]', // hover:spiffy-tw-bg-[--spiffy-colors-background-primary]
+      'spiffy-tw-border-[--spiffy-colors-background-primary]', // hover:spiffy-tw-border-[--spiffy-colors-background-secondary]
+      ...TEXT_LIGHT_CLASSES,
+      BORDER_CLASS,
+    ],
+  ],
+  [
+    'secondary',
+    [
+      'spiffy-tw-bg-[--spiffy-colors-background-secondary]', // hover:spiffy-tw-bg-[--spiffy-colors-background-secondary]
+      'spiffy-tw-text-[--spiffy-colors-text-link]', // hover:spiffy-tw-text-[--spiffy-colors-text-link]
+      'spiffy-tw-border-[--spiffy-colors-background-secondary]', // hover:spiffy-tw-border-[--spiffy-colors-background-secondary]
+      ...ACCENT_PRIMARY_CLASSES,
+      BORDER_CLASS,
+    ],
+  ],
+  [
+    'tertiary',
+    [
+      'spiffy-tw-bg-[--spiffy-colors-background-tertiary]', // hover:spiffy-tw-bg-[--spiffy-colors-background-tertiary]
+      'spiffy-tw-border-[--spiffy-colors-background-tertiary]', // hover:spiffy-tw-border-[--spiffy-colors-background-secondary]
+      ...TEXT_LINK_CLASSES,
+      BORDER_CLASS,
+    ],
+  ],
+  ['dark', [...DARK_BACKGROUND_CLASSES, ...TEXT_LIGHT_CLASSES, BORDER_CLASS]],
+  [
+    'darkPrimary',
+    [
+      ...DARK_BACKGROUND_CLASSES,
+      'spiffy-tw-text-[--spiffy-colors-text-light]', // hover:spiffy-tw-text-[--spiffy-colors-text-light]
+      ...ACCENT_PRIMARY_CLASSES,
+      BORDER_CLASS,
+    ],
+  ],
+  [
+    'darkAccent',
+    [
+      ...DARK_BACKGROUND_CLASSES,
+      'spiffy-tw-text-[--spiffy-colors-text-light]', // hover:spiffy-tw-text-[--spiffy-colors-text-light]
+      'spiffy-tw-fill-[--spiffy-colors-text-accent]', // hover:spiffy-tw-fill-[--spiffy-colors-text-accent]
+      'spiffy-tw-stroke-[--spiffy-colors-text-accent]', // hover:spiffy-tw-stroke-[--spiffy-colors-text-accent]
+      BORDER_CLASS,
+    ],
+  ],
+  [
+    'transparent',
+    [
+      'spiffy-tw-bg-transparent', // hover:spiffy-tw-bg-transparent
+      'spiffy-tw-border-[--spiffy-colors-background-light]', // hover:spiffy-tw-border-[--spiffy-colors-background-light]
+      'spiffy-tw-text-[--spiffy-colors-text-light]', // hover:spiffy-tw-text-[--spiffy-colors-text-light]
+      'spiffy-tw-fill-transparent', // hover:spiffy-tw-fill-transparent
+      'spiffy-tw-stroke-[--spiffy-colors-text-light]', // hover:spiffy-tw-stroke-[--spiffy-colors-text-light]
+      BORDER_CLASS,
+    ],
+  ],
+  [
+    'transparentDark',
+    [
+      'spiffy-tw-bg-transparent', // hover:spiffy-tw-bg-transparent
+      'spiffy-tw-border-[--spiffy-colors-border-light]', // hover:spiffy-tw-border-[--spiffy-colors-border-light]
+      'spiffy-tw-text-[--spiffy-colors-text-primary]', // hover:spiffy-tw-text-[--spiffy-colors-text-primary]
+      'spiffy-tw-fill-transparent', // hover:spiffy-tw-fill-transparent
+      'spiffy-tw-stroke-[--spiffy-colors-text-primary]', // hover:spiffy-tw-stroke-[--spiffy-colors-text-primary]
+      BORDER_CLASS,
+    ],
+  ],
+  // This is used as the hover state for transparent
+  ['secondaryDark', [...SECONDARY_DARK_BACKGROUND_CLASSES, ...TEXT_LINK_CLASSES, BORDER_CLASS]],
+  [
+    'secondaryAccent',
+    [
+      ...SECONDARY_DARK_BACKGROUND_CLASSES,
+      'spiffy-tw-text-[--spiffy-colors-text-link]', // hover:spiffy-tw-text-[--spiffy-colors-text-link]
+      ...ACCENT_PRIMARY_CLASSES,
+      BORDER_CLASS,
+    ],
+  ],
+  [
+    'lightDark',
+    [
+      'spiffy-tw-bg-[--spiffy-colors-background-light]', // hover:spiffy-tw-bg-[--spiffy-colors-background-light]
+      'spiffy-tw-border-[--spiffy-colors-background-dark]', // hover:spiffy-tw-border-[--spiffy-colors-background-dark]
+      ...TEXT_PRIMARY_CLASSES,
+      BORDER_CLASS,
+    ],
+  ],
+]);
+
+interface SuggestionButtonProps extends TestProps {
+  variant: SuggestionButtonVariant;
+  hoverVariant: SuggestionButtonVariant;
+  isDisabled: boolean;
+  content: string;
+  boldText?: boolean;
+  borderRadius?: 'sm' | 'md' | 'lg';
+  isAnswer?: boolean;
+  dataAttributes?: Record<string, string>;
+  onClick: () => void;
+}
+
+const borderedVariants = [
+  'outlined',
+  'outlinedLight',
+  'primary',
+  'secondary',
+  'tertiary',
+  'dark',
+  'darkAccent',
+  'darkPrimary',
+  'transparent',
+  'transparentDark',
+  'secondaryDark',
+  'secondaryAccent',
+  'lightDark',
+];
+
+const hoverTransform = (variantClass: string[]): string[] =>
+  variantClass?.map((className) => `hover:${className}`);
+
+export const SuggestionButton = ({
+  variant,
+  hoverVariant,
+  isDisabled,
+  content,
+  boldText,
+  borderRadius = 'lg',
+  isAnswer = false,
+  dataAttributes,
+  dataTestId,
+  onClick,
+}: SuggestionButtonProps) => {
+  const buttonClassName = classNames({
+    [SPIFFY_SUGGESTION_BUTTON_QUESTION_CLASS]: !isAnswer,
+    [SPIFFY_SUGGESTION_BUTTON_ANSWER_CLASS]: isAnswer,
+    '!spiffy-tw-rounded-[20px]': borderRadius === 'lg',
+    '!spiffy-tw-rounded-[8px]': borderRadius === 'md',
+    '!spiffy-tw-rounded-[0px]': borderRadius === 'sm',
+    'spiffy-tw-border-[1px]': borderedVariants.includes(variant),
+    'spiffy-tw-border-solid': borderedVariants.includes(variant),
+  });
+  const textClassName = classNames({
+    'spiffy-tw-text-[14px]': true,
+    'spiffy-tw-leading-[100%]': true,
+    '!spiffy-tw-font-bold': boldText,
+  });
+
+  const iconClass = classNames({
+    'spiffy-tw-w-[11px]': true,
+    'spiffy-tw-h-[11px]': true,
+    'spiffy-tw-stroke-inherit': true,
+    'spiffy-tw-fill-inherit': true,
+  });
+
+  const baseClasses = variantClassMap.get(variant) ?? [];
+  const hoverClasses = variantClassMap.get(hoverVariant) ?? [];
+
+  // Separate border classes for proper cascading
+  const baseBorderClasses = baseClasses.filter((cls) => cls.includes('border'));
+  const baseNonBorderClasses = baseClasses.filter((cls) => !cls.includes('border'));
+  const hoverBorderClasses = hoverClasses.filter((cls) => cls.includes('border'));
+  const hoverNonBorderClasses = hoverClasses.filter((cls) => !cls.includes('border'));
+
+  const variantClasses = [
+    ...baseNonBorderClasses,
+    ...hoverTransform(hoverNonBorderClasses),
+    ...baseBorderClasses,
+    ...hoverTransform(hoverBorderClasses),
+  ];
+
+  const buttonClass = `${buttonClassName} ${variantClasses.join(' ')}`;
+
+  // Choose icon based on variant to match legacy exactly
+  const getIcon = () => {
+    if (isAnswer) return undefined;
+    if (variant === 'transparentDark') {
+      return OutlinedStar;
+    }
+    return FourPointStar;
+  };
+
+  return (
+    <ButtonBase
+      text={content}
+      dataAttributes={dataAttributes}
+      dataTestId={dataTestId}
+      isDisabled={isDisabled}
+      // we may want to support custom icons in the future
+      icon={getIcon()}
+      iconClass={isAnswer ? undefined : iconClass}
+      textClass={`${SPIFFY_SUGGESTION_BUTTON_TEXT_CLASS} ${textClassName}`}
+      buttonClass={buttonClass}
+      onClick={onClick}
+    />
+  );
+};

package/src/components/common/SuggestionButton/types.ts

@@ -0,0 +1,14 @@
+export type SuggestionButtonVariant =
+  | 'outlined'
+  | 'outlinedLight'
+  | 'primary'
+  | 'secondary'
+  | 'tertiary'
+  | 'dark'
+  | 'darkAccent'
+  | 'darkPrimary'
+  | 'secondaryDark'
+  | 'secondaryAccent'
+  | 'transparent'
+  | 'transparentDark'
+  | 'lightDark';