@pisell/materials 6.3.27 → 6.3.28

package/es/components/pisellFilter/index.js

@@ -1,5 +1,11 @@
-var _excluded = ["value", "quickFilterMaxLength", "formFiltersPrefix", "hiddenQuickFilter", "hiddenOtherFilter", "hasForm"];
+var _excluded = ["value", "quickFilterMaxLength", "formFiltersPrefix", "hiddenQuickFilter", "hiddenOtherFilter", "hasForm", "onChange"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 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); }
@@ -8,7 +14,7 @@ function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" !=
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
-import React, { useEffect, useState, useMemo } from 'react';
+import React, { useCallback, useEffect, useState, useMemo, useRef } from 'react';
 import FilterButton from "../filter/components/FilterButton";
 import { Form } from 'antd';
 var PisellFilter = function PisellFilter(props) {
@@ -21,34 +27,94 @@ var PisellFilter = function PisellFilter(props) {
     hiddenOtherFilter = _props$hiddenOtherFil === void 0 ? false : _props$hiddenOtherFil,
     _props$hasForm = props.hasForm,
     hasForm = _props$hasForm === void 0 ? true : _props$hasForm,
+    onChange = props.onChange,
     otherProps = _objectWithoutProperties(props, _excluded);
-  var _useState = useState({}),
+  var _Form$useForm = Form.useForm(),
+    _Form$useForm2 = _slicedToArray(_Form$useForm, 1),
+    form = _Form$useForm2[0];
+  var _useState = useState(function () {
+      return {
+        quickFilter: (originalValue === null || originalValue === void 0 ? void 0 : originalValue.quickFilter) || [],
+        otherFilter: (originalValue === null || originalValue === void 0 ? void 0 : originalValue.otherFilter) || [],
+        values: (originalValue === null || originalValue === void 0 ? void 0 : originalValue.values) || {}
+      };
+    }),
     _useState2 = _slicedToArray(_useState, 2),
     value = _useState2[0],
     setValue = _useState2[1];
+  var isInternalChange = useRef(false);
   useEffect(function () {
-    setValue({
-      quickFilter: (originalValue === null || originalValue === void 0 ? void 0 : originalValue.quickFilter) || [],
-      otherFilter: (originalValue === null || originalValue === void 0 ? void 0 : originalValue.otherFilter) || []
+    setValue(function (prev) {
+      var _originalValue$quickF, _originalValue$otherF, _ref, _originalValue$values;
+      return {
+        quickFilter: (_originalValue$quickF = originalValue === null || originalValue === void 0 ? void 0 : originalValue.quickFilter) !== null && _originalValue$quickF !== void 0 ? _originalValue$quickF : prev.quickFilter,
+        otherFilter: (_originalValue$otherF = originalValue === null || originalValue === void 0 ? void 0 : originalValue.otherFilter) !== null && _originalValue$otherF !== void 0 ? _originalValue$otherF : prev.otherFilter,
+        values: (_ref = (_originalValue$values = originalValue === null || originalValue === void 0 ? void 0 : originalValue.values) !== null && _originalValue$values !== void 0 ? _originalValue$values : prev.values) !== null && _ref !== void 0 ? _ref : {}
+      };
     });
-  }, [originalValue]);
+  }, [originalValue === null || originalValue === void 0 ? void 0 : originalValue.quickFilter, originalValue === null || originalValue === void 0 ? void 0 : originalValue.otherFilter, originalValue === null || originalValue === void 0 ? void 0 : originalValue.values]);
+  useEffect(function () {
+    var _originalValue$values2;
+    if (!hasForm || _typeof(originalValue === null || originalValue === void 0 ? void 0 : originalValue.values) !== 'object') return;
+    if (isInternalChange.current) {
+      isInternalChange.current = false;
+      return;
+    }
+    var nextValues = (_originalValue$values2 = originalValue === null || originalValue === void 0 ? void 0 : originalValue.values) !== null && _originalValue$values2 !== void 0 ? _originalValue$values2 : {};
+    if (Object.keys(nextValues).length === 0) {
+      var current = form.getFieldsValue(true);
+      var cleared = Object.keys(current).reduce(function (acc, k) {
+        acc[k] = undefined;
+        return acc;
+      }, {});
+      if (Object.keys(cleared).length > 0) {
+        form.setFieldsValue(cleared);
+      }
+    } else {
+      form.setFieldsValue(nextValues);
+    }
+  }, [hasForm, form, originalValue === null || originalValue === void 0 ? void 0 : originalValue.values]);
+  var handleChange = useCallback(function (newVal) {
+    setValue(function (prev) {
+      var _newVal$values;
+      return _objectSpread(_objectSpread(_objectSpread({}, prev), newVal), {}, {
+        values: (_newVal$values = newVal.values) !== null && _newVal$values !== void 0 ? _newVal$values : prev.values
+      });
+    });
+    onChange === null || onChange === void 0 || onChange(newVal);
+  }, [onChange]);
+  var handleFormValuesChange = useCallback(function (_, allValues) {
+    if (_typeof(allValues) !== 'object' || allValues === null) return;
+    isInternalChange.current = true;
+    var mergedValues = _objectSpread(_objectSpread({}, value.values), allValues);
+    var next = {
+      quickFilter: value.quickFilter,
+      otherFilter: value.otherFilter,
+      values: mergedValues
+    };
+    setValue(next);
+    onChange === null || onChange === void 0 || onChange(next);
+  }, [value.quickFilter, value.otherFilter, value.values, onChange]);
   var content = useMemo(function () {
     return /*#__PURE__*/React.createElement(FilterButton, _extends({}, otherProps, {
+      onChange: handleChange,
       value: {
         quickFilter: value.quickFilter,
         otherFilter: value.otherFilter
       },
       hiddenQuickFilter: hiddenQuickFilter,
       hiddenOtherFilter: hiddenOtherFilter,
-      onChange: setValue,
       quickFilterMaxLength: quickFilterMaxLength || 100,
       formFiltersPrefix: formFiltersPrefix || ''
     }));
-  }, [value, hiddenQuickFilter, hiddenOtherFilter, quickFilterMaxLength, formFiltersPrefix]);
+  }, [value, hiddenQuickFilter, hiddenOtherFilter, quickFilterMaxLength, formFiltersPrefix, handleChange]);
   if (hasForm) {
     return /*#__PURE__*/React.createElement(Form, _extends({
+      form: form,
       size: "large",
-      layout: "vertical"
+      layout: "vertical",
+      initialValues: value.values,
+      onValuesChange: handleFormValuesChange
     }, otherProps), content);
   }
   return content;

package/es/components/pisellFind/index.js

@@ -3,6 +3,7 @@ function _extends() { _extends = Object.assign ? Object.assign.bind() : function
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 import React, { forwardRef } from 'react';
+import { locales as utilsLocales } from '@pisell/utils';
 import { PisellLookup } from "../pisellLookup";
 import { getText } from "../../locales";
 
@@ -47,9 +48,17 @@ export var PisellFind = /*#__PURE__*/forwardRef(function (props, ref) {
   var _props$triggerType = props.triggerType,
     triggerType = _props$triggerType === void 0 ? 'button' : _props$triggerType,
     _props$buttonText = props.buttonText,
-    buttonText = _props$buttonText === void 0 ? getText('pisell-find-button-text') : _props$buttonText,
+    buttonText = _props$buttonText === void 0 ? function () {
+      var key = 'pisell2.recordBoard.toolbar.find';
+      var u = utilsLocales.getText(key);
+      return u && u !== key ? u : getText(key) || getText('pisell-find-button-text');
+    }() : _props$buttonText,
     _props$placeholder = props.placeholder,
-    placeholder = _props$placeholder === void 0 ? getText('pisell-find-placeholder') : _props$placeholder,
+    placeholder = _props$placeholder === void 0 ? function () {
+      var key = 'pisell2.recordBoard.toolbar.findPlaceholder';
+      var u = utilsLocales.getText(key);
+      return u && u !== key ? u : getText(key) || getText('pisell-find-placeholder');
+    }() : _props$placeholder,
     _props$showConfirmBut = props.showConfirmButton,
     showConfirmButton = _props$showConfirmBut === void 0 ? false : _props$showConfirmBut,
     _props$showHistory = props.showHistory,

package/es/components/pisellGridPro/GridPro.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import './index.less';
+export interface GridProProps {
+    className?: string;
+    children?: React.ReactNode;
+    style?: React.CSSProperties;
+}
+declare const PisellGridPro: (props: GridProProps) => React.JSX.Element;
+export default PisellGridPro;

package/es/components/pisellGridPro/GridView/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import './index.less';
+import { GridViewProps } from './type';
+export type { GridViewProps };
+declare const GridView: (props: GridViewProps) => React.JSX.Element;
+export default GridView;

package/es/components/pisellGridPro/GridView/type.d.ts

@@ -0,0 +1,3 @@
+import { PisellScrollViewProps } from '../../PisellScrollView/types';
+export interface GridViewProps extends PisellScrollViewProps {
+}

package/es/components/pisellGridPro/ToolBar/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import './index.less';
+import { ToolBarProps } from './type';
+export type { ToolBarProps };
+declare const Toolbar: React.FC<ToolBarProps>;
+export default Toolbar;

package/es/components/pisellGridPro/ToolBar/index.less

@@ -14,6 +14,7 @@
   /**
    * 工具栏行通用样式
    */
+
   &-row {
     display: flex;
     flex-direction: row;
@@ -21,8 +22,10 @@
     gap: 12px;
     align-self: stretch;
   }
+
   .toolbar-row {
     justify-content: space-between;
+
     &-left {
       display: flex;
       flex-direction: row;
@@ -40,3 +43,23 @@
     }
   }
 }
+
+/**
+ * 手机版宽度：左侧区域与右侧区域换行，避免挤在一行
+ */
+@media (max-width: 768px) {
+  .pisell-grid-pro-toolbar .toolbar-row {
+    flex-wrap: wrap;
+  }
+
+  .pisell-grid-pro-toolbar .toolbar-row-left {
+    flex: 1 1 100%;
+    min-width: 0;
+  }
+
+  .pisell-grid-pro-toolbar .toolbar-row-right {
+    flex: 1 1 100%;
+    min-width: 0;
+    justify-content: flex-start;
+  }
+}

package/es/components/pisellGridPro/ToolBar/type.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+export interface ToolBarProps {
+    className?: string;
+    style?: React.CSSProperties;
+    tabs?: React.ReactNode;
+    topLeft?: React.ReactNode;
+    topRight?: React.ReactNode;
+    bottomLeft?: React.ReactNode;
+    bottomRight?: React.ReactNode;
+}

package/es/components/pisellGridPro/components/DataCard/components/StatCard/index.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { StatCardItem } from '../../types';
+import './index.less';
+/**
+ * StatCard 统计卡片组件
+ * @description 用于展示单个统计数据，包含标题、数值和对比信息
+ * @author Pisell Team
+ */
+declare const StatCard: React.FC<StatCardItem>;
+export default StatCard;

package/es/components/pisellGridPro/components/DataCard/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { DataCardProps } from './types';
+export type { DataCardProps };
+import './index.less';
+declare const DataCard: (props: DataCardProps) => React.JSX.Element | null;
+export default DataCard;

package/es/components/pisellGridPro/components/DataCard/types.d.ts

@@ -0,0 +1,70 @@
+import React from 'react';
+/**
+ * PisellGridProDataCard 组件属性接口
+ */
+export interface DataCardProps {
+    /**
+     * 统计卡片数据列表
+     */
+    dataItems?: StatCardItem[];
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: React.CSSProperties;
+}
+/**
+ * 统计卡片数据项接口
+ */
+export interface StatCardItem {
+    /**
+     * 唯一标识
+     */
+    key: string;
+    /**
+     * 卡片标题
+     * @example "Total Orders"
+     */
+    title: React.ReactNode;
+    /**
+     * 主要数值
+     * @example 50 或 "$1580"
+     */
+    value: React.ReactNode;
+    /**
+     * 对比数值
+     * @example "+12" 或 "-230"
+     */
+    compareValue?: React.ReactNode;
+    /**
+     * 对比趋势
+     * @description up-增长(绿色), down-下降(红色)
+     * @default undefined
+     */
+    trend?: 'up' | 'down';
+    /**
+     * 对比前缀文本
+     * @default "v.s. pre"
+     */
+    comparePrefix?: string;
+    /**
+     * 是否显示对比信息
+     * @default true
+     */
+    showCompare?: boolean;
+    /**
+     * 自定义卡片样式
+     */
+    style?: React.CSSProperties;
+    /**
+     * 自定义卡片类名
+     */
+    className?: string;
+    /**
+     * 点击回调
+     */
+    onClick?: () => void;
+}

package/es/components/pisellGridPro/components/Footer/index.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import './index.less';
+export interface FooterProps {
+    className?: string;
+    children?: React.ReactNode;
+    style?: React.CSSProperties;
+}
+declare const Footer: (props: FooterProps) => React.JSX.Element;
+export default Footer;

package/es/components/pisellGridPro/components/Header/index.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import './index.less';
+export interface HeaderProps {
+    title?: React.ReactNode;
+    badge?: React.ReactNode;
+    subTitle?: React.ReactNode;
+    actionsList?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const Header: React.FC<HeaderProps>;
+export default Header;

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

@@ -0,0 +1,4 @@
+import { GridProProps } from './GridPro';
+export type { GridProProps };
+declare const PisellGridPro: any;
+export default PisellGridPro;

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

@@ -0,0 +1,14 @@
+import type { LayoutProps } from 'antd';
+import { Layout } from 'antd';
+import React from 'react';
+export interface PisellLayoutProps extends LayoutProps {
+    children?: React.ReactNode;
+}
+export interface CompoundedComponent extends React.FC<PisellLayoutProps> {
+    Header: typeof Layout.Header;
+    Content: typeof Layout.Content;
+    Footer: typeof Layout.Footer;
+    Sider: typeof Layout.Sider;
+}
+declare const PisellLayout: CompoundedComponent;
+export default PisellLayout;

package/es/components/pisellLongText/PisellLongText.less

@@ -1,5 +1,6 @@
 /**
  * PisellLongText 组件样式
+ * 基于 Figma 设计规范，与 SingleLineText 设计体系一致
  */
 
 .pisell-long-text {
@@ -7,16 +8,78 @@
     position: relative;
     width: 100%;
 
-    // 基于 Figma 设计规范的 TextArea 样式
+    // TextArea 样式（Figma 设计规范，覆盖时使用 pisell-lowcode-xxx）
     .pisell-lowcode-input {
-      padding: 12px 14px; // Figma: 垂直12px，水平14px（比 Input 小2px）
+      // 基础样式
+      font-size: 16px !important;
+      line-height: 24px !important;
+
+      // 边框和圆角
+      border-radius: 8px !important;
+      border: 1px solid #d0d5dd !important; // Gray/300
+
+      // 内边距（Figma: 垂直 12px，水平 14px）
+      padding: 12px 14px !important;
+      min-height: 80px !important; // 多行最小高度，由 rows 进一步控制
+
+      // 颜色
+      color: #101828 !important; // Gray/900
+      background-color: #ffffff !important;
+
+      &::placeholder {
+        color: #667085 !important; // Gray/500
+      }
+
+      // 聚焦态
+      &:focus,
+      &:focus-within {
+        border-color: #d6bbfb !important; // Primary/300
+        box-shadow: 0 0 0 4px #f4ebff !important; // Primary/100
+        outline: none !important;
+      }
+
+      // Hover 态
+      &:hover:not(:focus):not(:focus-within):not([disabled]) {
+        border-color: #b692f6 !important; // Primary/400
+      }
+
+      // 禁用态
+      &[disabled],
+      &.pisell-lowcode-input-disabled {
+        background-color: #f9fafb !important; // Gray/50
+        color: #98a2b3 !important; // Gray/400
+        border-color: #d0d5dd !important;
+        cursor: not-allowed !important;
+      }
+    }
+
+    // 字数统计样式（TextArea showCount）
+    .pisell-lowcode-input-data-count,
+    .pisell-lowcode-input-show-count-suffix {
+      color: #667085 !important; // Gray/500
+      font-size: 14px !important;
+    }
+
+    // 错误状态
+    .pisell-lowcode-input-status-error {
+      border-color: #fda29b !important; // Error/300
+
+      &:focus,
+      &:focus-within {
+        border-color: #f97066 !important; // Error/400
+        box-shadow: 0 0 0 4px #fee4e2 !important; // Error/100
+      }
+
+      &:hover:not(:focus):not(:focus-within) {
+        border-color: #f97066 !important; // Error/400
+      }
     }
   }
 
   &-error {
     margin-top: 4px;
     font-size: 12px;
-    color: #ff4d4f;
+    color: #d92d20; // Error/600
     line-height: 1.5;
     animation: fadeIn 0.3s ease-in-out;
   }
@@ -32,12 +95,17 @@
     height: auto;
     font-size: 14px;
     margin-top: 8px;
+    color: #6d48c4;
+
+    &:hover {
+      color: #6d48c4 !important;
+    }
   }
 
   &-word-count {
     margin-top: 8px;
     font-size: 12px;
-    color: #667085;
+    color: #667085; // Gray/500
     text-align: right;
   }
 

package/es/components/pisellLongText/PisellLongText.stories.js

@@ -18,7 +18,7 @@ import React from 'react';
  * - 字数统计
  */
 var meta = {
-  title: '表单/PisellLongText',
+  title: '表单/表单组件/PisellLongText',
   component: PisellLongText,
   parameters: {
     layout: 'centered',

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

@@ -1,6 +1,7 @@
 /**
  * PisellLongText 组件导出
  */
-export { default as PisellLongText } from './PisellLongText';
+import PisellLongText from './PisellLongText';
+export { PisellLongText };
 export type { PisellLongTextProps } from './types';
 export type { DisplayState, ValidationResult, TextInputState } from './types';

package/es/components/pisellLongText/index.js

@@ -2,6 +2,21 @@
  * PisellLongText 组件导出
  */
 
-export { default as PisellLongText } from "./PisellLongText";
+import { getText } from "../../locales";
+import PisellLongText from "./PisellLongText";
+
+/** RecordBoard 列 type 联动排序：内置 A → Z / Z → A */
+PisellLongText.SortOptions = {
+  getSortItems: function getSortItems(fieldKey) {
+    return [{
+      key: "".concat(fieldKey, ":asc"),
+      label: getText('sort-a-z')
+    }, {
+      key: "".concat(fieldKey, ":desc"),
+      label: getText('sort-z-a')
+    }];
+  }
+};
+export { PisellLongText };
 
 // 公共类型从 types 中重新导出，方便使用

package/es/components/pisellLookup/PisellLookup.js

@@ -399,11 +399,11 @@ var PisellLookupComponent = /*#__PURE__*/forwardRef(function (props, ref) {
   }, [displayType, close]);
 
   /**
-   * 处理确认触发（点击 Lookup 按钮或按 Enter 键）
+   * 处理确认触发（点击 Lookup 按钮或按 Enter 键）。支持传入当前输入值，回车时由 Trigger 传入以避免受控下 keyword 未更新导致历史未保存。
    */
-  var handleConfirm = useCallback(function () {
-    // 确认触发时保存历史记录
-    handleConfirmSearch(keyword);
+  var handleConfirm = useCallback(function (valueFromTrigger) {
+    var keywordToSearch = valueFromTrigger !== null && valueFromTrigger !== void 0 ? valueFromTrigger : keyword;
+    handleConfirmSearch(keywordToSearch);
   }, [keyword, handleConfirmSearch]);
 
   /**
@@ -428,15 +428,22 @@ var PisellLookupComponent = /*#__PURE__*/forwardRef(function (props, ref) {
 
   /**
    * 处理扫码
+   * 标记为手动操作，避免 setKeyword 触发的重渲染时防抖 effect 仍用旧的 debouncedKeyword('') 再触发一次 onSearch('')
    */
   var handleScan = useCallback(function (code) {
+    // 标记为手动操作，阻止实时搜索防抖在本次更新后误触 onSearch('')
+    isManualSelectRef.current = true;
     // 将扫码结果填入关键词
     setKeyword(code);
     // 触发搜索并保存历史记录
     handleConfirmSearch(code);
     // 触发扫码回调
     onScan === null || onScan === void 0 || onScan(code);
-  }, [setKeyword, handleConfirmSearch, onScan]);
+    // 延迟重置标记（与 handleClear 一致，等待防抖周期结束）
+    setTimeout(function () {
+      isManualSelectRef.current = false;
+    }, debounceTime + 100);
+  }, [setKeyword, handleConfirmSearch, onScan, debounceTime]);
 
   /**
    * 处理选择辅助项（历史/联想词/热门搜索）
@@ -548,17 +555,26 @@ var PisellLookupComponent = /*#__PURE__*/forwardRef(function (props, ref) {
     }, resultRender(keyword, close));
   };
 
+  /**
+   * 是否有辅助区内容（与 LookupAuxiliary 内判断一致，用于空时不展示 dropdown）
+   */
+  var hasAuxiliaryContent = showHistory && history.length > 0 || showSuggestions && suggestions.length > 0 && !!keyword || showHotWords && hotWords.length > 0 && !keyword;
+
+  /**
+   * 是否有结果区内容（loading 或有关键词且提供了 resultRender）
+   */
+  var hasResultsContent = Boolean(loading || keyword && resultRender);
+
   /**
    * 渲染内容区（辅助区 + 结果区）
    */
   var renderContent = function renderContent() {
-    var auxiliary = renderAuxiliary();
-    var results = renderResults();
-
-    // 如果没有任何内容，返回 null（避免显示空容器）
-    if (!auxiliary && !results) {
+    // 当无任何可展示内容时返回 null，避免 popup 展示空下拉框
+    if (!hasAuxiliaryContent && !hasResultsContent) {
       return null;
     }
+    var auxiliary = renderAuxiliary();
+    var results = renderResults();
     return /*#__PURE__*/React.createElement("div", {
       className: "pisell-lookup-content"
     }, auxiliary, results);