@quantabit/search-sdk 1.0.0

package/dist/index.esm.js

@@ -0,0 +1,1547 @@
+import { BaseApiClient } from '@quantabit/sdk-config';
+import React, { useState, useRef, useEffect, useCallback, useMemo } from 'react';
+
+/**
+ * Search SDK - API 客户端
+ * 搜索系统后端接口封装
+ * 
+ * 使用 BaseApiClient 基类简化代码
+ */
+
+
+/**
+ * 搜索 API 客户端
+ */
+class SearchApiClient extends BaseApiClient {
+  constructor(config = {}) {
+    super('/search', config);
+  }
+
+  // ============ 搜索 ============
+
+  /**
+   * 全局搜索
+   * @param {string} query - 搜索关键词
+   * @param {Object} options - 搜索选项
+   */
+  async search(query, options = {}) {
+    return this.get('/', {
+      q: query,
+      ...options
+    });
+  }
+
+  /**
+   * 搜索用户
+   * @param {string} query - 搜索关键词
+   * @param {Object} options - 搜索选项
+   */
+  async searchUsers(query, options = {}) {
+    return this.get('/users', {
+      q: query,
+      ...options
+    });
+  }
+
+  /**
+   * 搜索内容
+   * @param {string} query - 搜索关键词
+   * @param {Object} options - 搜索选项
+   */
+  async searchContent(query, options = {}) {
+    return this.get('/content', {
+      q: query,
+      ...options
+    });
+  }
+
+  /**
+   * 搜索商品
+   * @param {string} query - 搜索关键词
+   * @param {Object} options - 搜索选项
+   */
+  async searchProducts(query, options = {}) {
+    return this.get('/products', {
+      q: query,
+      ...options
+    });
+  }
+
+  /**
+   * 搜索话题
+   * @param {string} query - 搜索关键词
+   * @param {Object} options - 搜索选项
+   */
+  async searchTopics(query, options = {}) {
+    return this.get('/topics', {
+      q: query,
+      ...options
+    });
+  }
+
+  // ============ 搜索建议 ============
+
+  /**
+   * 获取搜索建议
+   * @param {string} query - 输入内容
+   * @param {number} limit - 返回数量
+   */
+  async getSuggestions(query, limit = 10) {
+    return this.get('/suggestions', {
+      q: query,
+      limit
+    });
+  }
+
+  /**
+   * 获取热门搜索
+   * @param {number} limit - 返回数量
+   */
+  async getHotSearches(limit = 10) {
+    return this.get('/hot', {
+      limit
+    });
+  }
+
+  /**
+   * 获取搜索发现
+   */
+  async getDiscovery() {
+    return this.get('/discovery');
+  }
+
+  // ============ 搜索历史 ============
+
+  /**
+   * 获取搜索历史
+   * @param {number} limit - 返回数量
+   */
+  async getHistory(limit = 20) {
+    return this.get('/history', {
+      limit
+    });
+  }
+
+  /**
+   * 清除搜索历史
+   */
+  async clearHistory() {
+    return this.delete('/history');
+  }
+
+  /**
+   * 删除单条历史
+   * @param {string} historyId - 历史记录 ID
+   */
+  async deleteHistoryItem(historyId) {
+    return this.delete(`/history/${historyId}`);
+  }
+
+  // ============ 高级搜索 ============
+
+  /**
+   * 高级搜索
+   * @param {Object} filters - 过滤条件
+   */
+  async advancedSearch(filters) {
+    return this.post('/advanced', filters);
+  }
+
+  /**
+   * 筛选搜索
+   * @param {string} query - 搜索关键词
+   * @param {Object} filters - 过滤条件
+   */
+  async filterSearch(query, filters = {}) {
+    return this.post('/filter', {
+      q: query,
+      filters
+    });
+  }
+
+  // ============ 索引管理（管理员）============
+
+  /**
+   * 获取索引状态
+   */
+  async getIndexStatus() {
+    return this.get('/admin/index/status');
+  }
+
+  /**
+   * 重建索引
+   * @param {string} indexType - 索引类型
+   */
+  async rebuildIndex(indexType) {
+    return this.post(`/admin/index/${indexType}/rebuild`);
+  }
+
+  /**
+   * 获取搜索统计
+   * @param {Object} params - 统计参数
+   */
+  async getStats(params = {}) {
+    return this.get('/admin/stats', params);
+  }
+
+  // ============ 隐私合规 ============
+
+  /**
+   * 清除所有搜索数据 — GDPR 第17条
+   * 删除搜索历史 + 个性化搜索偏好
+   * @returns {Promise<object>} 清除结果
+   */
+  async clearAllUserData() {
+    const results = {};
+    try {
+      results.history = await this.clearHistory();
+    } catch (e) {
+      results.historyError = e.message;
+    }
+    try {
+      results.preferences = await this.delete('/preferences');
+    } catch (e) {
+      results.preferencesError = e.message;
+    }
+    return {
+      cleared: true,
+      timestamp: new Date().toISOString(),
+      ...results
+    };
+  }
+
+  /**
+   * 导出搜索数据 — GDPR 第20条
+   */
+  async exportSearchData() {
+    try {
+      const history = await this.getHistory(100);
+      return {
+        exportDate: new Date().toISOString(),
+        format: 'QBit Search Export (GDPR Art. 20)',
+        searchHistory: history?.data || []
+      };
+    } catch (e) {
+      return {
+        error: e.message,
+        exportDate: new Date().toISOString()
+      };
+    }
+  }
+
+  /**
+   * 获取隐私数据声明
+   */
+  getDataDisclosure() {
+    return {
+      sdk: '@quantabit/search-sdk',
+      privacyLevel: 'functional',
+      consentRequired: false,
+      collected: [{
+        type: 'search_queries',
+        description: 'User search keywords',
+        retention: '90 days',
+        anonymizedAfter: '30 days'
+      }, {
+        type: 'search_history',
+        description: 'Search history records',
+        retention: 'Until cleared by user'
+      }, {
+        type: 'search_preferences',
+        description: 'Personalized search settings',
+        retention: 'Until cleared'
+      }],
+      gdprCapabilities: ['delete', 'export'],
+      note: 'Search queries are anonymized after 30 days. Users can clear history anytime.'
+    };
+  }
+}
+
+// 创建默认实例
+const searchApi = new SearchApiClient();
+
+function SearchInput({
+  placeholder = 'Search...',
+  suggestions = [],
+  onSearch,
+  onSelect,
+  debounce = 300,
+  shortcut = 'mod+k',
+  showIcon = true,
+  size = 'medium',
+  className = ''
+}) {
+  const [query, setQuery] = useState('');
+  const [open, setOpen] = useState(false);
+  const [active, setActive] = useState(-1);
+  const inputRef = useRef(null);
+  const timerRef = useRef(null);
+  const sz = {
+    small: {
+      pad: '6px 10px',
+      font: 13
+    },
+    medium: {
+      pad: '8px 14px',
+      font: 14
+    },
+    large: {
+      pad: '10px 16px',
+      font: 15
+    }
+  };
+  const s = sz[size] || sz.medium;
+  const filtered = query ? suggestions.filter(s => {
+    const label = typeof s === 'string' ? s : s.label;
+    return label.toLowerCase().includes(query.toLowerCase());
+  }) : [];
+  const handleChange = e => {
+    const v = e.target.value;
+    setQuery(v);
+    setActive(-1);
+    clearTimeout(timerRef.current);
+    timerRef.current = setTimeout(() => onSearch?.(v), debounce);
+    setOpen(!!v);
+  };
+  const handleSelect = item => {
+    const label = typeof item === 'string' ? item : item.label;
+    setQuery(label);
+    setOpen(false);
+    onSelect?.(item);
+  };
+  const handleKey = e => {
+    if (e.key === 'ArrowDown') {
+      e.preventDefault();
+      setActive(a => Math.min(a + 1, filtered.length - 1));
+    } else if (e.key === 'ArrowUp') {
+      e.preventDefault();
+      setActive(a => Math.max(a - 1, -1));
+    } else if (e.key === 'Enter' && active >= 0) {
+      handleSelect(filtered[active]);
+    } else if (e.key === 'Escape') {
+      setOpen(false);
+    }
+  };
+  return /*#__PURE__*/React.createElement("div", {
+    className: `qsr-search ${className}`,
+    style: {
+      position: 'relative',
+      width: '100%'
+    }
+  }, /*#__PURE__*/React.createElement("div", {
+    style: {
+      display: 'flex',
+      alignItems: 'center',
+      gap: 8,
+      padding: s.pad,
+      border: '1px solid #e4e4e7',
+      borderRadius: 10,
+      background: '#fff',
+      transition: 'all 0.2s',
+      fontSize: s.font
+    },
+    className: "qsr-input-wrap"
+  }, showIcon && /*#__PURE__*/React.createElement("svg", {
+    width: "16",
+    height: "16",
+    viewBox: "0 0 24 24",
+    fill: "none",
+    stroke: "#a1a1aa",
+    strokeWidth: "2"
+  }, /*#__PURE__*/React.createElement("circle", {
+    cx: "11",
+    cy: "11",
+    r: "8"
+  }), /*#__PURE__*/React.createElement("path", {
+    d: "m21 21-4.3-4.3"
+  })), /*#__PURE__*/React.createElement("input", {
+    ref: inputRef,
+    value: query,
+    onChange: handleChange,
+    onKeyDown: handleKey,
+    onFocus: () => query && setOpen(true),
+    placeholder: placeholder,
+    style: {
+      border: 'none',
+      outline: 'none',
+      flex: 1,
+      fontSize: s.font,
+      background: 'transparent'
+    }
+  }), query && /*#__PURE__*/React.createElement("button", {
+    onClick: () => {
+      setQuery('');
+      setOpen(false);
+      onSearch?.('');
+    },
+    style: {
+      border: 'none',
+      background: 'none',
+      cursor: 'pointer',
+      color: '#a1a1aa',
+      fontSize: 16,
+      padding: 0
+    }
+  }, "\u2715")), open && filtered.length > 0 && /*#__PURE__*/React.createElement("div", {
+    className: "qsr-dropdown",
+    style: {
+      position: 'absolute',
+      top: '100%',
+      left: 0,
+      right: 0,
+      marginTop: 4,
+      background: '#fff',
+      borderRadius: 10,
+      border: '1px solid #e4e4e7',
+      boxShadow: '0 8px 32px rgba(0,0,0,0.1)',
+      maxHeight: 280,
+      overflowY: 'auto',
+      padding: 4,
+      zIndex: 9999
+    }
+  }, filtered.map((item, i) => {
+    const label = typeof item === 'string' ? item : item.label;
+    const desc = item.description;
+    return /*#__PURE__*/React.createElement("button", {
+      key: i,
+      onClick: () => handleSelect(item),
+      className: `qsr-option ${i === active ? 'qsr-active' : ''}`,
+      style: {
+        display: 'block',
+        width: '100%',
+        padding: '8px 12px',
+        borderRadius: 6,
+        border: 'none',
+        background: i === active ? 'rgba(59,130,246,0.06)' : 'transparent',
+        cursor: 'pointer',
+        textAlign: 'left',
+        fontSize: 13,
+        color: '#18181b',
+        transition: 'all 0.1s'
+      }
+    }, /*#__PURE__*/React.createElement("div", {
+      style: {
+        fontWeight: i === active ? 600 : 400
+      }
+    }, label), desc && /*#__PURE__*/React.createElement("div", {
+      style: {
+        fontSize: 11,
+        color: '#a1a1aa',
+        marginTop: 2
+      }
+    }, desc));
+  })));
+}
+
+function CommandPalette({
+  visible,
+  onClose,
+  commands = [],
+  placeholder = 'Type a command...',
+  className = ''
+}) {
+  const [query, setQuery] = useState('');
+  const [active, setActive] = useState(0);
+  const inputRef = useRef(null);
+  const filtered = commands.filter(c => c.label.toLowerCase().includes(query.toLowerCase()));
+  useEffect(() => {
+    if (visible) {
+      setQuery('');
+      setActive(0);
+      setTimeout(() => inputRef.current?.focus(), 50);
+    }
+  }, [visible]);
+  useEffect(() => {
+    if (!visible) return;
+    const h = e => {
+      if (e.key === 'Escape') onClose?.();
+    };
+    document.addEventListener('keydown', h);
+    return () => document.removeEventListener('keydown', h);
+  }, [visible, onClose]);
+  const handleKey = e => {
+    if (e.key === 'ArrowDown') {
+      e.preventDefault();
+      setActive(a => (a + 1) % filtered.length);
+    } else if (e.key === 'ArrowUp') {
+      e.preventDefault();
+      setActive(a => (a - 1 + filtered.length) % filtered.length);
+    } else if (e.key === 'Enter' && filtered[active]) {
+      filtered[active].action?.();
+      onClose?.();
+    }
+  };
+  if (!visible) return null;
+  return /*#__PURE__*/React.createElement("div", {
+    onClick: onClose,
+    style: {
+      position: 'fixed',
+      inset: 0,
+      zIndex: 99999,
+      background: 'rgba(0,0,0,0.5)',
+      backdropFilter: 'blur(4px)',
+      display: 'flex',
+      justifyContent: 'center',
+      paddingTop: '20vh'
+    }
+  }, /*#__PURE__*/React.createElement("div", {
+    onClick: e => e.stopPropagation(),
+    className: `qsr-palette ${className}`,
+    style: {
+      width: 520,
+      maxHeight: 400,
+      background: '#fff',
+      borderRadius: 16,
+      boxShadow: '0 24px 80px rgba(0,0,0,0.2)',
+      overflow: 'hidden',
+      animation: 'qsr-scale-in 0.15s ease-out'
+    }
+  }, /*#__PURE__*/React.createElement("div", {
+    style: {
+      display: 'flex',
+      alignItems: 'center',
+      gap: 8,
+      padding: '12px 16px',
+      borderBottom: '1px solid #f4f4f5'
+    }
+  }, /*#__PURE__*/React.createElement("svg", {
+    width: "18",
+    height: "18",
+    viewBox: "0 0 24 24",
+    fill: "none",
+    stroke: "#a1a1aa",
+    strokeWidth: "2"
+  }, /*#__PURE__*/React.createElement("circle", {
+    cx: "11",
+    cy: "11",
+    r: "8"
+  }), /*#__PURE__*/React.createElement("path", {
+    d: "m21 21-4.3-4.3"
+  })), /*#__PURE__*/React.createElement("input", {
+    ref: inputRef,
+    value: query,
+    onChange: e => {
+      setQuery(e.target.value);
+      setActive(0);
+    },
+    onKeyDown: handleKey,
+    placeholder: placeholder,
+    style: {
+      border: 'none',
+      outline: 'none',
+      flex: 1,
+      fontSize: 15,
+      background: 'transparent'
+    }
+  })), /*#__PURE__*/React.createElement("div", {
+    style: {
+      maxHeight: 300,
+      overflowY: 'auto',
+      padding: 4
+    }
+  }, filtered.map((cmd, i) => /*#__PURE__*/React.createElement("button", {
+    key: i,
+    onClick: () => {
+      cmd.action?.();
+      onClose?.();
+    },
+    style: {
+      display: 'flex',
+      alignItems: 'center',
+      gap: 10,
+      width: '100%',
+      padding: '10px 12px',
+      borderRadius: 8,
+      border: 'none',
+      background: i === active ? 'rgba(59,130,246,0.06)' : 'transparent',
+      cursor: 'pointer',
+      textAlign: 'left',
+      fontSize: 14,
+      color: '#18181b',
+      transition: 'all 0.1s'
+    }
+  }, cmd.icon && /*#__PURE__*/React.createElement("span", {
+    style: {
+      width: 20,
+      height: 20,
+      display: 'flex',
+      flexShrink: 0,
+      color: '#71717a'
+    }
+  }, cmd.icon), /*#__PURE__*/React.createElement("span", {
+    style: {
+      flex: 1,
+      fontWeight: i === active ? 600 : 400
+    }
+  }, cmd.label), cmd.shortcut && /*#__PURE__*/React.createElement("kbd", {
+    style: {
+      fontSize: 11,
+      padding: '2px 6px',
+      borderRadius: 4,
+      background: 'rgba(128,128,128,0.08)',
+      color: '#a1a1aa',
+      border: '1px solid rgba(128,128,128,0.1)'
+    }
+  }, cmd.shortcut))))));
+}
+
+/**
+ * Search SDK - React Hooks
+ * 搜索系统相关的状态管理
+ */
+
+
+/**
+ * 搜索功能
+ */
+function useSearch(options = {}) {
+  const [query, setQuery] = useState('');
+  const [results, setResults] = useState([]);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const [pagination, setPagination] = useState({
+    page: 1,
+    total: 0,
+    hasMore: false
+  });
+
+  // Handle options with fallback to old opts naming/keys
+  const type = options.type || 'all';
+  const sort = options.sort || 'relevance';
+  const limit = options.limit || 20;
+  const debounce = options.debounce !== undefined ? options.debounce : options.debounceMs !== undefined ? options.debounceMs : 300;
+  const debounceRef = useRef(null);
+  const search = useCallback(async (searchQuery, page = 1) => {
+    const q = searchQuery !== undefined ? searchQuery : query;
+    if (!q || !q.trim()) {
+      setResults([]);
+      setLoading(false);
+      return;
+    }
+    try {
+      setLoading(true);
+      setError(null);
+      const response = await searchApi.search(q, {
+        type,
+        sort,
+        page,
+        limit
+      });
+      const items = response?.data || response?.items || response || [];
+      if (page === 1) {
+        setResults(items);
+      } else {
+        setResults(prev => [...prev, ...items]);
+      }
+      setPagination({
+        page,
+        total: response?.total || items.length,
+        hasMore: !!response?.hasMore
+      });
+    } catch (err) {
+      setError(err?.message || String(err));
+    } finally {
+      setLoading(false);
+    }
+  }, [type, sort, limit, query]);
+
+  // 带防抖的搜索
+  const debouncedSearch = useCallback(value => {
+    setQuery(value);
+    if (debounceRef.current) {
+      clearTimeout(debounceRef.current);
+    }
+    debounceRef.current = setTimeout(() => {
+      search(value, 1);
+    }, debounce);
+  }, [search, debounce]);
+
+  // 清理
+  useEffect(() => {
+    return () => {
+      if (debounceRef.current) {
+        clearTimeout(debounceRef.current);
+      }
+    };
+  }, []);
+  const loadMore = useCallback(() => {
+    if (!loading && pagination.hasMore) {
+      search(query, pagination.page + 1);
+    }
+  }, [loading, pagination, search, query]);
+  const clear = useCallback(() => {
+    setQuery('');
+    setResults([]);
+    setPagination({
+      page: 1,
+      total: 0,
+      hasMore: false
+    });
+    setLoading(false);
+  }, []);
+  return {
+    query,
+    setQuery: debouncedSearch,
+    results,
+    loading,
+    error,
+    pagination,
+    search: q => search(q !== undefined ? q : query, 1),
+    loadMore,
+    clear
+  };
+}
+
+/**
+ * 搜索建议
+ */
+function useSuggestions(query, limit = 10) {
+  const [suggestions, setSuggestions] = useState([]);
+  const [loading, setLoading] = useState(false);
+  const debounceRef = useRef(null);
+  useEffect(() => {
+    if (!query || query.length < 2) {
+      setSuggestions([]);
+      return;
+    }
+    if (debounceRef.current) {
+      clearTimeout(debounceRef.current);
+    }
+    debounceRef.current = setTimeout(async () => {
+      try {
+        setLoading(true);
+        const response = await searchApi.getSuggestions(query, limit);
+        setSuggestions(response?.data || response?.suggestions || response || []);
+      } catch (err) {
+        console.error('Get suggestions error:', err);
+      } finally {
+        setLoading(false);
+      }
+    }, 200);
+    return () => {
+      if (debounceRef.current) {
+        clearTimeout(debounceRef.current);
+      }
+    };
+  }, [query, limit]);
+  return {
+    suggestions,
+    loading
+  };
+}
+
+/**
+ * 带输入状态的搜索建议
+ */
+function useSearchSuggestions(limit = 10) {
+  const [query, setQuery] = useState('');
+  const {
+    suggestions,
+    loading
+  } = useSuggestions(query, limit);
+  return {
+    query,
+    setQuery,
+    suggestions,
+    loading
+  };
+}
+
+/**
+ * 搜索历史
+ */
+function useSearchHistory(storageKey = 'eco-search-history') {
+  const [history, setHistory] = useState([]);
+  const maxItems = 10;
+
+  // 初始化
+  useEffect(() => {
+    if (typeof localStorage === 'undefined') return;
+    const saved = localStorage.getItem(storageKey);
+    if (saved) {
+      try {
+        const parsed = JSON.parse(saved);
+        // Ensure items are normalized as objects { query }
+        const normalized = parsed.map(item => typeof item === 'string' ? {
+          query: item
+        } : item);
+        setHistory(normalized);
+      } catch {
+        setHistory([]);
+      }
+    }
+  }, [storageKey]);
+  const addToHistory = useCallback(item => {
+    const queryStr = typeof item === 'string' ? item : item?.query || '';
+    if (!queryStr || !queryStr.trim()) return;
+    setHistory(prev => {
+      const filtered = prev.filter(entry => (typeof entry === 'string' ? entry : entry.query) !== queryStr);
+      const newHistory = [{
+        query: queryStr
+      }, ...filtered].slice(0, maxItems);
+      if (typeof localStorage !== 'undefined') {
+        localStorage.setItem(storageKey, JSON.stringify(newHistory));
+      }
+      return newHistory;
+    });
+  }, [storageKey]);
+  const removeFromHistory = useCallback(item => {
+    const queryStr = typeof item === 'string' ? item : item?.query || '';
+    setHistory(prev => {
+      const filtered = prev.filter(entry => (typeof entry === 'string' ? entry : entry.query) !== queryStr);
+      if (typeof localStorage !== 'undefined') {
+        localStorage.setItem(storageKey, JSON.stringify(filtered));
+      }
+      return filtered;
+    });
+  }, [storageKey]);
+  const clearHistory = useCallback(() => {
+    setHistory([]);
+    if (typeof localStorage !== 'undefined') {
+      localStorage.removeItem(storageKey);
+    }
+  }, [storageKey]);
+  return {
+    history,
+    addToHistory,
+    removeFromHistory,
+    clearHistory
+  };
+}
+
+/**
+ * 热门搜索
+ */
+function useTrendingSearches(limit = 10) {
+  const [trending, setTrending] = useState([]);
+  const [loading, setLoading] = useState(true);
+  const fetchTrending = useCallback(async () => {
+    try {
+      setLoading(true);
+      const response = await searchApi.getHotSearches(limit);
+      setTrending(response?.data || response?.keywords || response || []);
+    } catch (err) {
+      console.error('Get trending error:', err);
+    } finally {
+      setLoading(false);
+    }
+  }, [limit]);
+  useEffect(() => {
+    fetchTrending();
+  }, [fetchTrending]);
+  return {
+    trending,
+    loading,
+    refresh: fetchTrending
+  };
+}
+
+/**
+ * 筛选器
+ */
+function useSearchFilters(initialFilters = {}) {
+  const [filters, setFilters] = useState(initialFilters);
+  const updateFilter = useCallback((key, value) => {
+    setFilters(prev => ({
+      ...prev,
+      [key]: value
+    }));
+  }, []);
+  const setFilter = updateFilter;
+  const clearFilters = useCallback(() => {
+    setFilters({});
+  }, []);
+  const hasFilters = useMemo(() => {
+    return Object.values(filters).some(v => v !== null && v !== undefined && v !== '');
+  }, [filters]);
+  const activeCount = useMemo(() => {
+    return Object.values(filters).filter(v => v !== null && v !== undefined && v !== '').length;
+  }, [filters]);
+  return {
+    filters,
+    updateFilter,
+    setFilter,
+    clearFilters,
+    hasFilters,
+    activeCount
+  };
+}
+
+/**
+ * 语音搜索
+ */
+function useVoiceSearch(onResult) {
+  const [isListening, setIsListening] = useState(false);
+  const [isSupported, setIsSupported] = useState(false);
+  const recognitionRef = useRef(null);
+  useEffect(() => {
+    if (typeof window === 'undefined') return;
+    const SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;
+    if (SpeechRecognition) {
+      setIsSupported(true);
+      const rec = new SpeechRecognition();
+      rec.continuous = false;
+      rec.interimResults = false;
+      rec.onresult = event => {
+        const transcript = event.results?.[0]?.[0]?.transcript || '';
+        onResult?.(transcript);
+      };
+      rec.onend = () => {
+        setIsListening(false);
+      };
+      recognitionRef.current = rec;
+    }
+  }, [onResult]);
+  const startListening = useCallback(() => {
+    if (recognitionRef.current && !isListening) {
+      try {
+        recognitionRef.current.start();
+        setIsListening(true);
+      } catch (err) {
+        console.error('Speech recognition start error:', err);
+      }
+    }
+  }, [isListening]);
+  const stopListening = useCallback(() => {
+    if (recognitionRef.current && isListening) {
+      try {
+        recognitionRef.current.stop();
+      } catch (err) {
+        console.error('Speech recognition stop error:', err);
+      }
+      setIsListening(false);
+    }
+  }, [isListening]);
+  return {
+    isListening,
+    isSupported,
+    startListening,
+    stopListening
+  };
+}
+
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+const messages = {
+  en: {
+    'search.placeholder': 'Search...',
+    'search.noResults': 'No results found',
+    'search.recent': 'Recent Searches',
+    'search.clear': 'Clear'
+  },
+  zh: {
+    'search.placeholder': '搜索...',
+    'search.noResults': '未找到结果',
+    'search.recent': '最近搜索',
+    'search.clear': '清空'
+  },
+  ja: {
+    'search.placeholder': '検索...',
+    'search.noResults': '結果が見つかりません',
+    'search.recent': '最近の検索',
+    'search.clear': 'クリア'
+  },
+  ko: {
+    'search.placeholder': '검색...',
+    'search.noResults': '결과가 없습니다',
+    'search.recent': '최근 검색',
+    'search.clear': '지우기'
+  }
+};
+let currentLang = 'en';
+function setLanguage(l) {
+  if (SUPPORTED_LANGUAGES.includes(l)) currentLang = l;
+}
+function getLanguage() {
+  return currentLang;
+}
+function t(k, params = {}) {
+  let text = messages[currentLang]?.[k] || messages.en?.[k] || k;
+  Object.entries(params).forEach(([key, val]) => {
+    text = text.replace(new RegExp(`\\{${key}\\}`, 'g'), val);
+  });
+  return text;
+}
+
+/**
+ * Search SDK - React 组件
+ * 搜索系统可视化组件
+ */
+
+
+/**
+ * 搜索建议下拉
+ */
+function SearchSuggestions({
+  query,
+  onSelect
+}) {
+  const {
+    suggestions,
+    loading
+  } = useSuggestions(query);
+  const {
+    history,
+    addToHistory,
+    removeFromHistory,
+    clearHistory
+  } = useSearchHistory();
+  const {
+    trending
+  } = useTrendingSearches();
+  const handleSelect = useCallback(item => {
+    addToHistory(item);
+    onSelect?.(item);
+  }, [addToHistory, onSelect]);
+
+  // 没有输入时显示历史和热门
+  if (!query || query.length < 2) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-search-dropdown"
+    }, history.length > 0 && /*#__PURE__*/React.createElement("div", {
+      className: "eco-search-section"
+    }, /*#__PURE__*/React.createElement("div", {
+      className: "eco-search-section-header"
+    }, /*#__PURE__*/React.createElement("span", null, t('recentSearches')), /*#__PURE__*/React.createElement("button", {
+      onClick: clearHistory
+    }, t('clearHistory'))), /*#__PURE__*/React.createElement("div", {
+      className: "eco-search-list"
+    }, history.map((item, qbit) => {
+      const queryText = typeof item === 'string' ? item : item?.query || '';
+      return /*#__PURE__*/React.createElement("div", {
+        key: qbit,
+        className: "eco-search-item"
+      }, /*#__PURE__*/React.createElement("span", {
+        className: "eco-search-item-icon"
+      }, "\uD83D\uDD50"), /*#__PURE__*/React.createElement("span", {
+        className: "eco-search-item-text",
+        onClick: () => handleSelect(queryText)
+      }, queryText), /*#__PURE__*/React.createElement("button", {
+        className: "eco-search-item-remove",
+        onClick: () => removeFromHistory(queryText)
+      }, "\xD7"));
+    }))), trending.length > 0 && /*#__PURE__*/React.createElement("div", {
+      className: "eco-search-section"
+    }, /*#__PURE__*/React.createElement("div", {
+      className: "eco-search-section-header"
+    }, /*#__PURE__*/React.createElement("span", null, t('trending'))), /*#__PURE__*/React.createElement("div", {
+      className: "eco-search-tags"
+    }, trending.map((item, qbit) => /*#__PURE__*/React.createElement("button", {
+      key: qbit,
+      className: "eco-search-tag",
+      onClick: () => handleSelect(item.keyword)
+    }, /*#__PURE__*/React.createElement("span", {
+      className: "eco-search-tag-rank"
+    }, qbit + 1), item.keyword)))));
+  }
+
+  // 显示搜索建议
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-dropdown"
+  }, loading ? /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-loading"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-spinner"
+  })) : suggestions.length > 0 ? /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-list"
+  }, suggestions.map((item, qbit) => /*#__PURE__*/React.createElement("div", {
+    key: qbit,
+    className: "eco-search-item",
+    onClick: () => handleSelect(item.text)
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-search-item-icon"
+  }, "\uD83D\uDD0D"), /*#__PURE__*/React.createElement("span", {
+    className: "eco-search-item-text"
+  }, /*#__PURE__*/React.createElement(HighlightedText$1, {
+    text: item.text,
+    highlight: query
+  }))))) : /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-no-suggestions"
+  }, t('noResults')));
+}
+
+/**
+ * 高亮匹配文本
+ */
+function HighlightedText$1({
+  text,
+  highlight
+}) {
+  if (!highlight) return text;
+  const parts = text.split(new RegExp(`(${highlight})`, 'gi'));
+  return parts.map((part, qbit) => part.toLowerCase() === highlight.toLowerCase() ? /*#__PURE__*/React.createElement("mark", {
+    key: qbit
+  }, part) : part);
+}
+
+/**
+ * 搜索结果项
+ */
+function SearchResultItem({
+  result,
+  onClick
+}) {
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-result",
+    onClick: () => onClick?.(result)
+  }, result.image && /*#__PURE__*/React.createElement("img", {
+    className: "eco-search-result-image",
+    src: result.image,
+    alt: result.title
+  }), /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-result-content"
+  }, /*#__PURE__*/React.createElement("h4", {
+    className: "eco-search-result-title"
+  }, result.title), result.description && /*#__PURE__*/React.createElement("p", {
+    className: "eco-search-result-desc"
+  }, result.description), /*#__PURE__*/React.createElement("span", {
+    className: "eco-search-result-type"
+  }, result.type)));
+}
+
+/**
+ * 搜索结果列表
+ */
+function SearchResults({
+  results,
+  loading,
+  total,
+  onResultClick,
+  onLoadMore,
+  hasMore
+}) {
+  if (loading && results.length === 0) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-search-results eco-search-loading-full"
+    }, /*#__PURE__*/React.createElement("div", {
+      className: "eco-search-spinner"
+    }), /*#__PURE__*/React.createElement("span", null, t('searching')));
+  }
+  if (results.length === 0) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: "eco-search-results eco-search-empty"
+    }, /*#__PURE__*/React.createElement("span", {
+      className: "eco-search-empty-icon"
+    }, "\uD83D\uDD0D"), /*#__PURE__*/React.createElement("span", null, t('noResults')));
+  }
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-results"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-results-header"
+  }, t('found'), " ", total, " ", t('items')), /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-results-list"
+  }, results.map((result, qbit) => /*#__PURE__*/React.createElement(SearchResultItem, {
+    key: result.id || qbit,
+    result: result,
+    onClick: onResultClick
+  }))), hasMore && /*#__PURE__*/React.createElement("button", {
+    className: "eco-search-load-more",
+    onClick: onLoadMore,
+    disabled: loading
+  }, loading ? '...' : t('loading')));
+}
+
+/**
+ * 语音搜索按钮
+ */
+function VoiceSearchButton({
+  onResult
+}) {
+  const {
+    isListening,
+    isSupported,
+    startListening,
+    stopListening
+  } = useVoiceSearch(onResult);
+  if (!isSupported) return null;
+  return /*#__PURE__*/React.createElement("button", {
+    className: `eco-search-voice ${isListening ? 'listening' : ''}`,
+    onClick: isListening ? stopListening : startListening
+  }, isListening ? '🔴' : '🎤');
+}
+
+/**
+ * 类型筛选tabs
+ */
+function SearchTypeTabs({
+  active,
+  onChange
+}) {
+  const types = [{
+    key: 'all',
+    label: t('all')
+  }, {
+    key: 'products',
+    label: t('products')
+  }, {
+    key: 'users',
+    label: t('users')
+  }, {
+    key: 'posts',
+    label: t('posts')
+  }, {
+    key: 'nfts',
+    label: t('nfts')
+  }];
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-type-tabs"
+  }, types.map(type => /*#__PURE__*/React.createElement("button", {
+    key: type.key,
+    className: `eco-search-type-tab ${active === type.key ? 'active' : ''}`,
+    onClick: () => onChange(type.key)
+  }, type.label)));
+}
+
+/**
+ * Search SDK - React 组件
+ * 搜索服务可视化组件
+ */
+
+
+/**
+ * 搜索框
+ */
+function SearchBox({
+  placeholder,
+  onSearch,
+  onSelect,
+  showSuggestions = true,
+  showHistory = true,
+  autoFocus = false
+}) {
+  const [isOpen, setIsOpen] = useState(false);
+  const inputRef = useRef(null);
+  const {
+    query,
+    setQuery,
+    suggestions,
+    loading: loadingSuggestions
+  } = useSearchSuggestions();
+  const {
+    history,
+    addToHistory,
+    removeFromHistory,
+    clearHistory
+  } = useSearchHistory();
+  const {
+    trending
+  } = useTrendingSearches();
+  const handleSubmit = e => {
+    e?.preventDefault();
+    if (query.trim()) {
+      addToHistory(query);
+      onSearch?.(query);
+      setIsOpen(false);
+    }
+  };
+  const handleSelect = value => {
+    setQuery(value);
+    addToHistory(value);
+    onSelect?.(value);
+    onSearch?.(value);
+    setIsOpen(false);
+  };
+  const handleFocus = () => {
+    setIsOpen(true);
+  };
+  const handleBlur = () => {
+    // 延迟关闭，允许点击建议项
+    setTimeout(() => setIsOpen(false), 200);
+  };
+  useEffect(() => {
+    if (autoFocus && inputRef.current) {
+      inputRef.current.focus();
+    }
+  }, [autoFocus]);
+
+  // 键盘事件
+  useEffect(() => {
+    const handleKeyDown = e => {
+      if (e.key === 'Escape') {
+        setIsOpen(false);
+        inputRef.current?.blur();
+      }
+    };
+    document.addEventListener('keydown', handleKeyDown);
+    return () => document.removeEventListener('keydown', handleKeyDown);
+  }, []);
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-box"
+  }, /*#__PURE__*/React.createElement("form", {
+    className: "eco-search-form",
+    onSubmit: handleSubmit
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-search-icon"
+  }, "\uD83D\uDD0D"), /*#__PURE__*/React.createElement("input", {
+    ref: inputRef,
+    type: "text",
+    className: "eco-search-input",
+    placeholder: placeholder || t('searchPlaceholder'),
+    value: query,
+    onChange: e => setQuery(e.target.value),
+    onFocus: handleFocus,
+    onBlur: handleBlur
+  }), query && /*#__PURE__*/React.createElement("button", {
+    type: "button",
+    className: "eco-search-clear",
+    onClick: () => setQuery('')
+  }, "\xD7"), loadingSuggestions && /*#__PURE__*/React.createElement("span", {
+    className: "eco-search-loading"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-search-spinner"
+  }))), isOpen && (showSuggestions || showHistory) && /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-dropdown"
+  }, showSuggestions && suggestions.length > 0 && /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-section"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-section-header"
+  }, t('suggestions')), /*#__PURE__*/React.createElement("ul", {
+    className: "eco-search-list"
+  }, suggestions.map((item, index) => /*#__PURE__*/React.createElement("li", {
+    key: index,
+    className: "eco-search-item",
+    onClick: () => handleSelect(item.text || item)
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-search-item-icon"
+  }, "\uD83D\uDD0D"), /*#__PURE__*/React.createElement("span", {
+    className: "eco-search-item-text"
+  }, /*#__PURE__*/React.createElement(HighlightedText, {
+    text: item.text || item,
+    highlight: query
+  })))))), showHistory && history.length > 0 && !query && /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-section"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-section-header"
+  }, /*#__PURE__*/React.createElement("span", null, t('recentSearches')), /*#__PURE__*/React.createElement("button", {
+    className: "eco-search-clear-btn",
+    onClick: clearHistory
+  }, t('clearHistory'))), /*#__PURE__*/React.createElement("ul", {
+    className: "eco-search-list"
+  }, history.map((item, index) => /*#__PURE__*/React.createElement("li", {
+    key: index,
+    className: "eco-search-item",
+    onClick: () => handleSelect(item.query)
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-search-item-icon"
+  }, "\uD83D\uDD52"), /*#__PURE__*/React.createElement("span", {
+    className: "eco-search-item-text"
+  }, item.query), /*#__PURE__*/React.createElement("button", {
+    className: "eco-search-item-remove",
+    onClick: e => {
+      e.stopPropagation();
+      removeFromHistory(item.query);
+    }
+  }, "\xD7"))))), trending.length > 0 && !query && /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-section"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-section-header"
+  }, "\uD83D\uDD25 ", t('trending')), /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-tags"
+  }, trending.map((item, index) => /*#__PURE__*/React.createElement("button", {
+    key: index,
+    className: "eco-search-tag",
+    onClick: () => handleSelect(item.keyword || item)
+  }, item.keyword || item))))));
+}
+
+/**
+ * 筛选侧边栏
+ */
+function SearchFilters({
+  config,
+  onChange
+}) {
+  const {
+    filters,
+    setFilter,
+    clearFilters,
+    activeCount
+  } = useSearchFilters();
+  useEffect(() => {
+    onChange?.(filters);
+  }, [filters, onChange]);
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-filters"
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-filters-header"
+  }, /*#__PURE__*/React.createElement("h4", null, t('filters')), activeCount > 0 && /*#__PURE__*/React.createElement("button", {
+    className: "eco-search-filters-clear",
+    onClick: clearFilters
+  }, t('clearFilters'))), config?.map(group => /*#__PURE__*/React.createElement("div", {
+    key: group.key,
+    className: "eco-search-filter-group"
+  }, /*#__PURE__*/React.createElement("h5", null, group.label), /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-filter-options"
+  }, group.options.map(option => /*#__PURE__*/React.createElement("label", {
+    key: option.value,
+    className: "eco-search-filter-option"
+  }, /*#__PURE__*/React.createElement("input", {
+    type: group.type === 'radio' ? 'radio' : 'checkbox',
+    name: group.key,
+    checked: group.type === 'radio' ? filters[group.key] === option.value : (filters[group.key] || []).includes(option.value),
+    onChange: () => {
+      if (group.type === 'radio') {
+        setFilter(group.key, option.value);
+      } else {
+        const current = filters[group.key] || [];
+        const exists = current.includes(option.value);
+        setFilter(group.key, exists ? current.filter(v => v !== option.value) : [...current, option.value]);
+      }
+    }
+  }), /*#__PURE__*/React.createElement("span", null, option.label), option.count !== undefined && /*#__PURE__*/React.createElement("span", {
+    className: "eco-search-filter-count"
+  }, "(", option.count, ")")))))));
+}
+
+/**
+ * 分页控件
+ */
+function SearchPagination({
+  page,
+  totalPages,
+  onPageChange
+}) {
+  if (totalPages <= 1) return null;
+  const getPageNumbers = () => {
+    const pages = [];
+    const showPages = 5;
+    let start = Math.max(1, page - Math.floor(showPages / 2));
+    let end = Math.min(totalPages, start + showPages - 1);
+    if (end - start < showPages - 1) {
+      start = Math.max(1, end - showPages + 1);
+    }
+    for (let i = start; i <= end; i++) {
+      pages.push(i);
+    }
+    return pages;
+  };
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-pagination"
+  }, /*#__PURE__*/React.createElement("button", {
+    className: "eco-search-page-btn",
+    disabled: page <= 1,
+    onClick: () => onPageChange(page - 1)
+  }, t('prevPage')), /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-page-numbers"
+  }, getPageNumbers().map(p => /*#__PURE__*/React.createElement("button", {
+    key: p,
+    className: `eco-search-page-num ${p === page ? 'active' : ''}`,
+    onClick: () => onPageChange(p)
+  }, p))), /*#__PURE__*/React.createElement("button", {
+    className: "eco-search-page-btn",
+    disabled: page >= totalPages,
+    onClick: () => onPageChange(page + 1)
+  }, t('nextPage')));
+}
+
+/**
+ * 排序选择器
+ */
+function SortSelector({
+  value,
+  onChange,
+  options
+}) {
+  const defaultOptions = [{
+    value: 'relevance',
+    label: t('relevance')
+  }, {
+    value: 'newest',
+    label: t('newest')
+  }, {
+    value: 'oldest',
+    label: t('oldest')
+  }, {
+    value: 'popular',
+    label: t('popular')
+  }];
+  return /*#__PURE__*/React.createElement("div", {
+    className: "eco-search-sort"
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "eco-search-sort-label"
+  }, t('sortBy'), ":"), /*#__PURE__*/React.createElement("select", {
+    className: "eco-search-sort-select",
+    value: value,
+    onChange: e => onChange(e.target.value)
+  }, (options || defaultOptions).map(opt => /*#__PURE__*/React.createElement("option", {
+    key: opt.value,
+    value: opt.value
+  }, opt.label))));
+}
+
+/**
+ * 高亮文本
+ */
+function HighlightedText({
+  text,
+  highlight
+}) {
+  if (!highlight || !text) return /*#__PURE__*/React.createElement(React.Fragment, null, text);
+  const regex = new RegExp(`(${highlight})`, 'gi');
+  const parts = text.split(regex);
+  return /*#__PURE__*/React.createElement(React.Fragment, null, parts.map((part, i) => regex.test(part) ? /*#__PURE__*/React.createElement("mark", {
+    key: i,
+    className: "eco-search-highlight"
+  }, part) : part));
+}
+
+/**
+ * Search SDK - 类型定义
+ */
+
+// 搜索类型
+const SearchType = {
+  ALL: 'all',
+  CONTENT: 'content',
+  USER: 'user',
+  PRODUCT: 'product',
+  TAG: 'tag',
+  CATEGORY: 'category'
+};
+
+// 排序方式
+const SortBy = {
+  RELEVANCE: 'relevance',
+  LATEST: 'latest',
+  OLDEST: 'oldest',
+  POPULAR: 'popular',
+  ALPHABETICAL: 'alphabetical'
+};
+
+// 过滤类型
+const FilterType = {
+  TERM: 'term',
+  RANGE: 'range',
+  DATE_RANGE: 'date_range',
+  GEO: 'geo',
+  EXISTS: 'exists'
+};
+
+// 高亮配置
+const HighlightStyle = {
+  BOLD: 'bold',
+  MARK: 'mark',
+  CUSTOM: 'custom'
+};
+
+// 建议类型
+const SuggestionType = {
+  COMPLETION: 'completion',
+  PHRASE: 'phrase',
+  TERM: 'term',
+  HISTORY: 'history'
+};
+
+/**
+ * @quantabit/search-sdk
+ * 
+ * QuantaBit Search SDK — 全局搜索组件
+ */
+
+
+// Shortcut Methods
+const search = searchApi.search.bind(searchApi);
+const getSuggestions = searchApi.getSuggestions.bind(searchApi);
+const getTrending = searchApi.getHotSearches.bind(searchApi);
+
+export { CommandPalette, FilterType, HighlightStyle, SUPPORTED_LANGUAGES, SearchApiClient, SearchBox, SearchFilters, SearchInput, SearchPagination, SearchResultItem, SearchResults, SearchSuggestions, SearchType, SearchTypeTabs, SortBy, SortSelector, SuggestionType, VoiceSearchButton, getLanguage, getSuggestions, getTrending, messages, search, searchApi, setLanguage, t, useSearch, useSearchFilters, useSearchHistory, useSearchSuggestions, useSuggestions, useTrendingSearches, useVoiceSearch };
+//# sourceMappingURL=index.esm.js.map