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

package/dist/components/suggestions/utils.d.ts

@@ -0,0 +1,259 @@
+/**
+ * Utility functions for Query Suggestions components
+ */
+import { type CSSProperties, type ReactNode } from 'react';
+import type { SuggestionFieldMapping, ProductFieldMapping, CategoryFieldMapping, BrandFieldMapping, DropdownThemeConfig, ProductDisplayConfig } from './types';
+import type { ProductBadge, ProductOption, ProductVariant, PriceRange } from '@seekora-ai/ui-sdk-types';
+/**
+ * Get nested value from object using dot notation
+ * @example getNestedValue({ a: { b: 'value' } }, 'a.b') => 'value'
+ */
+export declare const getNestedValue: (obj: any, path: string) => any;
+/**
+ * Extract suggestion fields from raw data
+ */
+export declare const extractSuggestion: (item: any, mapping?: SuggestionFieldMapping) => {
+    query: any;
+    count: any;
+    id: any;
+    categories: any;
+    highlighted: any;
+    _raw: any;
+};
+/**
+ * Extract product fields from raw data
+ */
+export declare const extractProduct: (item: any, mapping?: ProductFieldMapping) => {
+    id: any;
+    title: any;
+    image: any;
+    price: any;
+    comparePrice: any;
+    url: any;
+    brand: any;
+    category: any;
+    rating: any;
+    reviewCount: any;
+    discount: any;
+    inStock: any;
+    currency: any;
+    images: any;
+    originalPrice: any;
+    available: any;
+    options: any;
+    variants: any;
+    tags: any;
+    _raw: any;
+};
+/**
+ * Extract category fields from raw data
+ */
+export declare const extractCategory: (item: any, mapping?: CategoryFieldMapping) => {
+    id: any;
+    label: any;
+    count: any;
+    icon: any;
+    image: any;
+    _raw: any;
+};
+/**
+ * Extract brand fields from raw data
+ */
+export declare const extractBrand: (item: any, mapping?: BrandFieldMapping) => {
+    id: any;
+    name: any;
+    logo: any;
+    count: any;
+    _raw: any;
+};
+/**
+ * Format price with currency
+ */
+export declare const formatPrice: (value: number | string | undefined, config?: Pick<ProductDisplayConfig, "currency" | "currencyPosition" | "priceDecimals">) => string;
+/**
+ * Format count with abbreviation (1.2K, 3.4M, etc.)
+ */
+export declare const formatCount: (count: number | undefined) => string;
+/**
+ * Calculate discount percentage
+ */
+export declare const calculateDiscount: (price: number | undefined, comparePrice: number | undefined) => number | undefined;
+/**
+ * Escape HTML special characters
+ */
+export declare const escapeHtml: (text: string) => string;
+/**
+ * Highlight matching text in a string
+ */
+export declare const highlightText: (text: string, query: string, options?: {
+    tag?: string;
+    className?: string;
+    style?: CSSProperties;
+}) => string;
+/**
+ * Safe React-based highlight rendering (no dangerouslySetInnerHTML).
+ * Returns React nodes with matched text wrapped in the specified tag element.
+ */
+export declare const highlightTextReact: (text: string, query: string, options?: {
+    tag?: string;
+    className?: string;
+    style?: CSSProperties;
+}) => ReactNode;
+/**
+ * Truncate text to specified length
+ */
+export declare const truncateText: (text: string, maxLength: number, ellipsis?: string) => string;
+/**
+ * Extract badges from product tags (Shopify convention: "badge:new", "badge:limited")
+ * and auto-generate sale/soldOut badges from product data.
+ */
+export declare const extractBadges: (tags?: string[], product?: {
+    price?: number;
+    original_price?: number;
+    compare_at_price?: number;
+    available?: boolean;
+}) => ProductBadge[];
+/**
+ * Compute min/max price from variants. Returns null if all variants have the same price.
+ */
+export declare const getPriceRange: (variants?: ProductVariant[]) => PriceRange | null;
+/**
+ * Format a price range like "$54.00 - $72.00"
+ */
+export declare const formatPriceRange: (range: PriceRange, config?: Pick<ProductDisplayConfig, "currency" | "currencyPosition" | "priceDecimals">) => string;
+/**
+ * Given current selections, return which values for an option are still available
+ * based on variant availability.
+ */
+export declare const getAvailableValuesForOption: (optionName: string, options: ProductOption[], variants: ProductVariant[], selections: Record<string, string>) => {
+    value: string;
+    available: boolean;
+}[];
+/**
+ * Find the exact variant matching all selected options.
+ */
+export declare const findVariantBySelections: (options: ProductOption[], variants: ProductVariant[], selections: Record<string, string>) => ProductVariant | null;
+/**
+ * Generate CSS variables from theme config
+ */
+export declare const generateCSSVariables: (theme: DropdownThemeConfig, prefix?: string) => Record<string, string>;
+/**
+ * Merge class names, filtering out falsy values
+ */
+export declare const cx: (...classes: (string | undefined | null | false)[]) => string;
+/**
+ * Merge styles, filtering out undefined values
+ */
+export declare const mergeStyles: (...styles: (CSSProperties | undefined)[]) => CSSProperties;
+interface AnimationState {
+    opacity: number;
+    transform?: string;
+}
+interface AnimationConfig {
+    initial: AnimationState;
+    animate: AnimationState;
+    exit: AnimationState;
+}
+export declare const animations: Record<'fade' | 'slide' | 'scale' | 'spring', AnimationConfig>;
+/**
+ * Get animation keyframes CSS
+ */
+export declare const getAnimationCSS: (type: "fade" | "slide" | "scale" | "spring" | "none", duration?: number) => string;
+/**
+ * Create keyboard handler for dropdown navigation
+ */
+export declare const createKeyboardHandler: (handlers: {
+    onUp?: () => void;
+    onDown?: () => void;
+    onLeft?: () => void;
+    onRight?: () => void;
+    onEnter?: () => void;
+    onEscape?: () => void;
+    onTab?: (shift: boolean) => void;
+}) => (event: React.KeyboardEvent) => void;
+export declare const getRecentSearches: (storeId?: string) => string[];
+export declare const addRecentSearch: (query: string, storeId?: string) => string[];
+export declare const removeRecentSearch: (query: string, storeId?: string) => string[];
+export declare const clearRecentSearches: (storeId?: string) => void;
+/**
+ * Debounce function
+ */
+export declare const debounce: <T extends (...args: any[]) => any>(fn: T, delay: number) => ((...args: Parameters<T>) => void) & {
+    cancel: () => void;
+};
+/**
+ * Generate unique ID
+ */
+export declare const generateId: (prefix?: string) => string;
+/**
+ * Check if element is in viewport
+ */
+export declare const isInViewport: (element: HTMLElement) => boolean;
+/**
+ * Scroll element into view if needed
+ */
+export declare const scrollIntoViewIfNeeded: (element: HTMLElement, container: HTMLElement) => void;
+/**
+ * Simple in-memory cache with TTL support for suggestions
+ * Reduces API calls by caching results for quick repeated queries
+ */
+declare class SuggestionsCache {
+    private cache;
+    private maxSize;
+    private defaultTtl;
+    constructor(options?: {
+        maxSize?: number;
+        defaultTtlMs?: number;
+    });
+    /**
+     * Generate a cache key from query and options
+     */
+    generateKey(query: string, options?: Record<string, any>): string;
+    /**
+     * Get cached data if valid (not expired)
+     */
+    get<T>(key: string): T | null;
+    /**
+     * Store data in cache
+     */
+    set<T>(key: string, data: T, ttlMs?: number): void;
+    /**
+     * Check if key exists and is valid
+     */
+    has(key: string): boolean;
+    /**
+     * Clear all cached entries
+     */
+    clear(): void;
+    /**
+     * Clear expired entries
+     */
+    cleanup(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        maxSize: number;
+    };
+}
+/**
+ * Get the global suggestions cache instance
+ */
+export declare const getSuggestionsCache: (options?: {
+    maxSize?: number;
+    defaultTtlMs?: number;
+}) => SuggestionsCache;
+/**
+ * Create a new cache instance (for isolated caching per component)
+ */
+export declare const createSuggestionsCache: (options?: {
+    maxSize?: number;
+    defaultTtlMs?: number;
+}) => SuggestionsCache;
+/**
+ * Clear the global cache
+ */
+export declare const clearSuggestionsCache: () => void;
+export { SuggestionsCache };
+//# sourceMappingURL=utils.d.ts.map

package/dist/components/suggestions/utils.d.ts.map

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