@pisell/materials 6.3.25 → 6.3.27

package/es/components/pisellLookup/components/SearchHistory.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { SearchHistoryProps } from '../types';
+/**
+ * SearchHistory 组件
+ * 展示搜索历史记录
+ */
+export declare const SearchHistory: React.FC<SearchHistoryProps>;

package/es/components/pisellLookup/components/SearchHistory.js

@@ -0,0 +1,68 @@
+import React from 'react';
+import { Tag } from 'antd';
+import { CloseOutlined } from '@ant-design/icons';
+/**
+ * SearchHistory 组件
+ * 展示搜索历史记录
+ */
+export var SearchHistory = function SearchHistory(props) {
+  var history = props.history,
+    onSelect = props.onSelect,
+    onRemove = props.onRemove,
+    onClear = props.onClear,
+    render = props.render,
+    className = props.className,
+    style = props.style;
+
+  // 如果没有历史记录，不显示
+  if (!history || history.length === 0) {
+    return null;
+  }
+
+  // 使用自定义渲染
+  if (render) {
+    return /*#__PURE__*/React.createElement(React.Fragment, null, render(history, onSelect));
+  }
+
+  /**
+   * 处理点击历史记录
+   */
+  var handleClick = function handleClick(keyword) {
+    onSelect(keyword);
+  };
+
+  /**
+   * 处理删除历史记录
+   */
+  var handleRemove = function handleRemove(e, keyword) {
+    e.stopPropagation();
+    onRemove === null || onRemove === void 0 || onRemove(keyword);
+  };
+
+  /**
+   * 处理清除全部历史记录
+   */
+  var handleClearAll = function handleClearAll() {
+    onClear === null || onClear === void 0 || onClear();
+  };
+  return /*#__PURE__*/React.createElement("div", {
+    className: "pisell-lookup-history ".concat(className || ''),
+    style: style
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "pisell-lookup-history-list"
+  }, history.map(function (item, index) {
+    return /*#__PURE__*/React.createElement(Tag, {
+      key: "".concat(item, "-").concat(index),
+      className: "pisell-lookup-history-item",
+      onClick: function onClick() {
+        return handleClick(item);
+      },
+      closable: !!onRemove,
+      onClose: function onClose(e) {
+        return handleRemove(e, item);
+      },
+      closeIcon: /*#__PURE__*/React.createElement(CloseOutlined, null)
+    }, item);
+  })));
+};
+SearchHistory.displayName = 'SearchHistory';

package/es/components/pisellLookup/components/SuggestWords.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { SuggestWordsProps } from '../types';
+/**
+ * SuggestWords 组件
+ * 展示搜索联想词
+ */
+export declare const SuggestWords: React.FC<SuggestWordsProps>;

package/es/components/pisellLookup/components/SuggestWords.js

@@ -0,0 +1,53 @@
+import React from 'react';
+import { List } from 'antd';
+import { SearchOutlined } from '@ant-design/icons';
+/**
+ * SuggestWords 组件
+ * 展示搜索联想词
+ */
+export var SuggestWords = function SuggestWords(props) {
+  var suggestions = props.suggestions,
+    onSelect = props.onSelect,
+    render = props.render,
+    className = props.className,
+    style = props.style;
+
+  // 如果没有联想词，不显示
+  if (!suggestions || suggestions.length === 0) {
+    return null;
+  }
+
+  // 使用自定义渲染
+  if (render) {
+    return /*#__PURE__*/React.createElement(React.Fragment, null, render(suggestions, onSelect));
+  }
+
+  /**
+   * 处理点击联想词
+   */
+  var handleClick = function handleClick(keyword) {
+    onSelect(keyword);
+  };
+  return /*#__PURE__*/React.createElement("div", {
+    className: "pisell-lookup-suggestions ".concat(className || ''),
+    style: style
+  }, /*#__PURE__*/React.createElement(List, {
+    className: "pisell-lookup-suggestions-list",
+    size: "small",
+    dataSource: suggestions,
+    renderItem: function renderItem(item) {
+      return /*#__PURE__*/React.createElement(List.Item, {
+        className: "pisell-lookup-suggestions-item",
+        onClick: function onClick() {
+          return handleClick(item);
+        }
+      }, /*#__PURE__*/React.createElement(SearchOutlined, {
+        style: {
+          marginRight: 8,
+          color: '#667085'
+        }
+      }), item);
+    }
+  }));
+};
+SuggestWords.displayName = 'SuggestWords';

package/es/components/pisellLookup/components/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 子组件统一导出
+ */
+export { SearchHistory } from './SearchHistory';
+export { SuggestWords } from './SuggestWords';
+export { HotWords } from './HotWords';
+export { LookupAuxiliary } from './LookupAuxiliary';
+export { LookupTrigger } from './LookupTrigger';
+export { LookupResultHost } from './LookupResultHost';

package/es/components/pisellLookup/components/index.js

@@ -0,0 +1,10 @@
+/**
+ * 子组件统一导出
+ */
+
+export { SearchHistory } from "./SearchHistory";
+export { SuggestWords } from "./SuggestWords";
+export { HotWords } from "./HotWords";
+export { LookupAuxiliary } from "./LookupAuxiliary";
+export { LookupTrigger } from "./LookupTrigger";
+export { LookupResultHost } from "./LookupResultHost";

package/es/components/pisellLookup/hooks/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 自定义 Hooks 统一导出
+ */
+export * from './useSearchState';
+export * from './useSearchHistory';
+export * from './useDebounceSearch';

package/es/components/pisellLookup/hooks/index.js

@@ -0,0 +1,7 @@
+/**
+ * 自定义 Hooks 统一导出
+ */
+
+export * from "./useSearchState";
+export * from "./useSearchHistory";
+export * from "./useDebounceSearch";

package/es/components/pisellLookup/hooks/useDebounceSearch.js

@@ -0,0 +1,78 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useEffect, useRef, useState } from 'react';
+
+/**
+ * 防抖搜索 Hook
+ */
+
+/**
+ * 防抖搜索 Hook
+ * 用于实时搜索模式的防抖处理
+ */
+export var useDebounceSearch = function useDebounceSearch(options) {
+  var keyword = options.keyword,
+    debounceTime = options.debounceTime,
+    onSearch = options.onSearch,
+    _options$enabled = options.enabled,
+    enabled = _options$enabled === void 0 ? true : _options$enabled,
+    lastSearchKeyword = options.lastSearchKeyword;
+  var _useState = useState(keyword),
+    _useState2 = _slicedToArray(_useState, 2),
+    debouncedKeyword = _useState2[0],
+    setDebouncedKeyword = _useState2[1];
+  var timerRef = useRef(null);
+
+  /**
+   * 防抖处理
+   */
+  useEffect(function () {
+    if (!enabled) {
+      // 不启用防抖时，直接更新
+      setDebouncedKeyword(keyword);
+      return;
+    }
+
+    // 清除之前的定时器
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+    }
+
+    // 设置新的定时器
+    timerRef.current = setTimeout(function () {
+      setDebouncedKeyword(keyword);
+    }, debounceTime);
+
+    // 清理函数
+    return function () {
+      if (timerRef.current) {
+        clearTimeout(timerRef.current);
+      }
+    };
+  }, [keyword, debounceTime, enabled]);
+
+  /**
+   * 触发搜索回调
+   */
+  useEffect(function () {
+    // 只有在启用防抖时才触发搜索（包括空关键词，用于恢复数据）
+    if (enabled && onSearch && debouncedKeyword !== undefined) {
+      // 如果和上次搜索的关键词相同，跳过（避免重复触发）
+      if (lastSearchKeyword !== undefined && debouncedKeyword === lastSearchKeyword) {
+        return;
+      }
+      try {
+        onSearch(debouncedKeyword);
+      } catch (error) {
+        console.error('Failed to trigger search:', error);
+      }
+    }
+  }, [debouncedKeyword, onSearch, enabled, lastSearchKeyword]);
+  return {
+    debouncedKeyword: debouncedKeyword
+  };
+};

package/es/components/pisellLookup/hooks/useSearchHistory.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 搜索历史管理 Hook
+ */
+export interface UseSearchHistoryOptions {
+    /**
+     * 存储 key
+     */
+    historyKey: string;
+    /**
+     * 最大历史记录数量
+     */
+    maxHistoryCount: number;
+    /**
+     * 自定义加载历史记录函数
+     */
+    onLoadHistory?: () => string[];
+    /**
+     * 自定义保存历史记录函数
+     */
+    onSaveHistory?: (history: string[]) => void;
+}
+export interface UseSearchHistoryResult {
+    /**
+     * 历史记录数组
+     */
+    history: string[];
+    /**
+     * 添加历史记录
+     */
+    addHistory: (keyword: string) => void;
+    /**
+     * 删除历史记录
+     */
+    removeHistory: (keyword: string) => void;
+    /**
+     * 清除全部历史记录
+     */
+    clearAllHistory: () => void;
+    /**
+     * 重新加载历史记录
+     */
+    reloadHistory: () => void;
+}
+/**
+ * 搜索历史管理 Hook
+ * 支持自定义存储逻辑
+ */
+export declare const useSearchHistory: (options: UseSearchHistoryOptions) => UseSearchHistoryResult;

package/es/components/pisellLookup/hooks/useSearchHistory.js

@@ -0,0 +1,125 @@
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useCallback, useEffect, useState } from 'react';
+import { addHistoryItem, clearHistory, loadHistory, removeHistoryItem } from "../utils";
+
+/**
+ * 搜索历史管理 Hook
+ */
+
+/**
+ * 搜索历史管理 Hook
+ * 支持自定义存储逻辑
+ */
+export var useSearchHistory = function useSearchHistory(options) {
+  var historyKey = options.historyKey,
+    maxHistoryCount = options.maxHistoryCount,
+    onLoadHistory = options.onLoadHistory,
+    onSaveHistory = options.onSaveHistory;
+  var _useState = useState([]),
+    _useState2 = _slicedToArray(_useState, 2),
+    history = _useState2[0],
+    setHistory = _useState2[1];
+
+  /**
+   * 加载历史记录
+   */
+  var reloadHistory = useCallback(function () {
+    try {
+      if (onLoadHistory) {
+        // 使用自定义加载函数
+        var loadedHistory = onLoadHistory();
+        setHistory(Array.isArray(loadedHistory) ? loadedHistory : []);
+      } else {
+        // 使用默认的 localStorage 加载
+        var _loadedHistory = loadHistory(historyKey);
+        setHistory(Array.isArray(_loadedHistory) ? _loadedHistory : []);
+      }
+    } catch (error) {
+      console.error('Failed to reload history:', error);
+      setHistory([]);
+    }
+  }, [historyKey, onLoadHistory]);
+
+  /**
+   * 初始化：加载历史记录
+   */
+  useEffect(function () {
+    reloadHistory();
+  }, [reloadHistory]);
+
+  /**
+   * 添加历史记录
+   */
+  var addHistory = useCallback(function (keyword) {
+    // 忽略空关键词
+    if (!keyword || !keyword.trim()) {
+      return;
+    }
+    var trimmedKeyword = keyword.trim();
+    if (onSaveHistory) {
+      // 使用自定义保存函数
+      // 去重并添加到开头
+      var safeHistory = Array.isArray(history) ? history : [];
+      var filteredHistory = safeHistory.filter(function (h) {
+        return h !== trimmedKeyword;
+      });
+      var newHistory = [trimmedKeyword].concat(_toConsumableArray(filteredHistory)).slice(0, maxHistoryCount);
+      setHistory(newHistory);
+      onSaveHistory(newHistory);
+    } else {
+      // 使用默认的 localStorage 保存
+      var _newHistory = addHistoryItem(historyKey, trimmedKeyword, maxHistoryCount);
+      setHistory(_newHistory);
+    }
+  }, [history, historyKey, maxHistoryCount, onSaveHistory]);
+
+  /**
+   * 删除历史记录
+   */
+  var removeHistory = useCallback(function (keyword) {
+    if (onSaveHistory) {
+      // 使用自定义保存函数
+      var safeHistory = Array.isArray(history) ? history : [];
+      var newHistory = safeHistory.filter(function (h) {
+        return h !== keyword;
+      });
+      setHistory(newHistory);
+      onSaveHistory(newHistory);
+    } else {
+      // 使用默认的 localStorage 删除
+      var _newHistory2 = removeHistoryItem(historyKey, keyword);
+      setHistory(_newHistory2);
+    }
+  }, [history, historyKey, onSaveHistory]);
+
+  /**
+   * 清除全部历史记录
+   */
+  var clearAllHistory = useCallback(function () {
+    if (onSaveHistory) {
+      // 使用自定义保存函数
+      setHistory([]);
+      onSaveHistory([]);
+    } else {
+      // 使用默认的 localStorage 清除
+      clearHistory(historyKey);
+      setHistory([]);
+    }
+  }, [historyKey, onSaveHistory]);
+  return {
+    history: history,
+    addHistory: addHistory,
+    removeHistory: removeHistory,
+    clearAllHistory: clearAllHistory,
+    reloadHistory: reloadHistory
+  };
+};

package/es/components/pisellLookup/hooks/useSearchState.js

@@ -0,0 +1,113 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useCallback, useState } from 'react';
+
+/**
+ * 搜索状态管理 Hook
+ */
+
+/**
+ * 搜索状态管理 Hook
+ * 支持受控和非受控模式
+ */
+export var useSearchState = function useSearchState(options) {
+  var value = options.value,
+    _options$defaultValue = options.defaultValue,
+    defaultValue = _options$defaultValue === void 0 ? '' : _options$defaultValue,
+    visibleProp = options.visible,
+    _options$defaultVisib = options.defaultVisible,
+    defaultVisible = _options$defaultVisib === void 0 ? false : _options$defaultVisib,
+    onChange = options.onChange,
+    onVisibleChange = options.onVisibleChange,
+    onOpen = options.onOpen,
+    onClose = options.onClose;
+
+  // 判断是否为受控模式
+  var isControlledKeyword = value !== undefined;
+  var isControlledVisible = visibleProp !== undefined;
+
+  // 内部状态（非受控模式使用）
+  var _useState = useState(defaultValue),
+    _useState2 = _slicedToArray(_useState, 2),
+    internalKeyword = _useState2[0],
+    setInternalKeyword = _useState2[1];
+  var _useState3 = useState(defaultVisible),
+    _useState4 = _slicedToArray(_useState3, 2),
+    internalVisible = _useState4[0],
+    setInternalVisible = _useState4[1];
+
+  // 当前值（受控优先）
+  var keyword = isControlledKeyword ? value : internalKeyword;
+  var visible = isControlledVisible ? visibleProp : internalVisible;
+
+  /**
+   * 设置关键词
+   */
+  var setKeyword = useCallback(function (newValue) {
+    // 非受控模式下更新内部状态
+    if (!isControlledKeyword) {
+      setInternalKeyword(newValue);
+    }
+
+    // 触发回调
+    onChange === null || onChange === void 0 || onChange(newValue);
+  }, [isControlledKeyword, onChange]);
+
+  /**
+   * 设置可见性
+   */
+  var setVisible = useCallback(function (newVisible) {
+    var oldVisible = visible;
+
+    // 非受控模式下更新内部状态
+    if (!isControlledVisible) {
+      setInternalVisible(newVisible);
+    }
+
+    // 触发回调
+    onVisibleChange === null || onVisibleChange === void 0 || onVisibleChange(newVisible);
+
+    // 触发打开/关闭回调
+    if (newVisible && !oldVisible) {
+      onOpen === null || onOpen === void 0 || onOpen();
+    } else if (!newVisible && oldVisible) {
+      onClose === null || onClose === void 0 || onClose();
+    }
+  }, [isControlledVisible, visible, onVisibleChange, onOpen, onClose]);
+
+  /**
+   * 打开
+   */
+  var open = useCallback(function () {
+    setVisible(true);
+  }, [setVisible]);
+
+  /**
+   * 关闭
+   */
+  var close = useCallback(function () {
+    setVisible(false);
+  }, [setVisible]);
+
+  /**
+   * 切换可见性
+   */
+  var toggle = useCallback(function () {
+    setVisible(!visible);
+  }, [setVisible, visible]);
+  return {
+    keyword: keyword,
+    setKeyword: setKeyword,
+    visible: visible,
+    setVisible: setVisible,
+    open: open,
+    close: close,
+    toggle: toggle,
+    isControlledKeyword: isControlledKeyword,
+    isControlledVisible: isControlledVisible
+  };
+};

package/es/components/pisellLookup/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PisellLookup 组件导出
+ */
+export { PisellLookup } from './PisellLookup';
+export type { PisellLookupRef } from './types';
+export type * from './types';

package/es/components/pisellLookup/index.js

@@ -0,0 +1,5 @@
+/**
+ * PisellLookup 组件导出
+ */
+
+export { PisellLookup } from "./PisellLookup";