@pisell/materials 1.8.12 → 1.8.14

package/es/components/pisellDateTimeDisplay/hooks/useCurrentTime.js

@@ -8,6 +8,7 @@ import { useState, useEffect } from 'react';
 import dayjs from 'dayjs';
 import { getDayjsLocale } from "../utils/localeUtils";
 import usePisellConfig from "../../pisell-config-provider/hooks/usePisellConfig";
+import useEngineContext from "../../../hooks/useEngineContext";
 
 /**
  * useCurrentTime Hook 配置项
@@ -33,6 +34,7 @@ import usePisellConfig from "../../pisell-config-provider/hooks/usePisellConfig"
  * @returns 当前时间（Dayjs 对象）
  */
 export function useCurrentTime(options) {
+  var _context$engine;
   var _ref = options || {},
     _ref$refreshInterval = _ref.refreshInterval,
     refreshInterval = _ref$refreshInterval === void 0 ? 60000 : _ref$refreshInterval,
@@ -40,13 +42,13 @@ export function useCurrentTime(options) {
     disabled = _ref$disabled === void 0 ? false : _ref$disabled,
     userLocale = _ref.locale,
     onUpdate = _ref.onUpdate;
-
-  // 获取全局配置中的 locale
   var globalConfig = usePisellConfig();
+  var context = useEngineContext();
   var globalLocale = globalConfig === null || globalConfig === void 0 ? void 0 : globalConfig.locale;
+  var engineLocale = context === null || context === void 0 || (_context$engine = context.engine) === null || _context$engine === void 0 || (_context$engine = _context$engine.props) === null || _context$engine === void 0 ? void 0 : _context$engine.locale;
 
-  // 获取实际使用的 locale（优先级：用户指定 > 全局配置 > i18n 当前语言）
-  var dayjsLocale = getDayjsLocale(userLocale || globalLocale);
+  // 优先级：用户指定 > 全局配置 > engine.props.locale > 'en'
+  var dayjsLocale = getDayjsLocale(userLocale || globalLocale || engineLocale || 'en');
 
   // 初始化时间
   var _useState = useState(function () {

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

@@ -0,0 +1,3 @@
+export { default as PisellDateTimeDisplay } from './PisellDateTimeDisplay';
+export type { PisellDateTimeDisplayProps, LayoutDirection, DateOrder, TextAlign, FieldType, TimeFormatConfig, DateFormatConfig, WeekdayFormatConfig, FieldConfig, TextStyleConfig, ContainerStyleConfig, } from './types';
+export { default } from './PisellDateTimeDisplay';

package/es/components/pisellDateTimeDisplay/utils/formatDate.d.ts

@@ -0,0 +1,21 @@
+import type { Dayjs } from 'dayjs';
+import type { DateFormatConfig } from '../types';
+/**
+ * 格式化日期
+ * @param date dayjs 日期对象
+ * @param config 日期格式配置
+ * @returns 格式化后的日期字符串
+ *
+ * @example
+ * // 英文环境
+ * formatDate(dayjs(), { order: 'YMD', shortMonth: true, showYear: true })
+ * // => "2026-Mar-21"
+ *
+ * // 中文环境
+ * formatDate(dayjs(), { order: 'YMD', showChineseUnit: true, showYear: true })
+ * // => "2026年3月21日"
+ *
+ * formatDate(dayjs(), { order: 'MDY', shortMonth: false, showYear: true })
+ * // => "March 21, 2026"
+ */
+export declare function formatDate(date: Dayjs, config?: DateFormatConfig): string;

package/es/components/pisellDateTimeDisplay/utils/formatWeekday.d.ts

@@ -0,0 +1,30 @@
+import type { Dayjs } from 'dayjs';
+import type { WeekdayFormatConfig } from '../types';
+/**
+ * 格式化星期
+ * @param weekday dayjs 日期对象
+ * @param config 星期格式配置
+ * @returns 格式化后的星期字符串
+ *
+ * @example
+ * // 英文环境
+ * formatWeekday(dayjs(), { full: false, singleLetter: false })
+ * // => "Sat"
+ *
+ * formatWeekday(dayjs(), { full: true })
+ * // => "Saturday"
+ *
+ * formatWeekday(dayjs(), { singleLetter: true })
+ * // => "S"
+ *
+ * // 中文环境
+ * formatWeekday(dayjs(), { full: false, singleLetter: false })
+ * // => "周六"
+ *
+ * formatWeekday(dayjs(), { full: true })
+ * // => "星期六"
+ *
+ * formatWeekday(dayjs(), { singleLetter: true })
+ * // => "六"
+ */
+export declare function formatWeekday(weekday: Dayjs, config?: WeekdayFormatConfig): string;

package/es/components/pisellDateTimeDisplay/utils/index.d.ts

@@ -0,0 +1,7 @@
+export { formatTime } from './formatTime';
+export { formatDate } from './formatDate';
+export { formatWeekday } from './formatWeekday';
+export { getDatePartDisplay } from './formatDateOrRelative';
+export { getRefreshInterval } from './getRefreshInterval';
+export { getRelativeDay, getRelativeDayLabel, type RelativeDay, } from './relativeDay';
+export { normalizeLocale, isChinese, getDayjsLocale, } from './localeUtils';

package/es/components/pisellDateTimeDisplay/utils/localeUtils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 标准化 locale 代码
+ * @param locale 原始 locale 代码
+ * @returns 标准化后的 locale 代码（小写，用于 dayjs）
+ * @example 'zh-CN' -> 'zh-cn', 'en' -> 'en'
+ */
+export declare function normalizeLocale(locale: string): string;
+/**
+ * 判断是否为中文环境
+ * @param locale locale 代码
+ * @returns 是否为中文
+ * @example isChinese('zh-CN') -> true, isChinese('zh-HK') -> true, isChinese('en') -> false
+ */
+export declare function isChinese(locale: string): boolean;
+/**
+ * 获取 dayjs 兼容的 locale 代码
+ * 未传 locale 时：优先 materials 当前语言（globalConfig / umi_locale），若为默认 en-US 则用 @pisell/utils getLocale
+ * @param locale 原始 locale 代码（可选）
+ * @returns dayjs 兼容的 locale 代码（与已加载的 zh-cn、en 对齐）
+ * @example 'zh-CN' -> 'zh-cn', 'en-US' -> 'en'
+ */
+export declare function getDayjsLocale(locale?: string): string;

package/es/components/pisellDateTimeDisplay/utils/localeUtils.js

@@ -1,3 +1,4 @@
+import { locales as utilsLocales } from '@pisell/utils';
 import { getCurrentLocale } from "../../../utils/locale";
 
 /**
@@ -21,16 +22,26 @@ export function isChinese(locale) {
   return normalizedLocale.startsWith('zh');
 }
 
+/** dayjs 常用 locale 与项目已加载的 locale 对齐（zh-cn、en），en-us 等统一用 en */
+function toDayjsLoadedLocale(normalized) {
+  if (normalized.startsWith('en')) return 'en';
+  return normalized;
+}
+
 /**
  * 获取 dayjs 兼容的 locale 代码
- * 未传 locale 时使用 i18n 当前语言（全局配置 / umi_locale），不再使用浏览器语言
+ * 未传 locale 时：优先 materials 当前语言（globalConfig / umi_locale），若为默认 en-US 则用 @pisell/utils getLocale
  * @param locale 原始 locale 代码（可选）
- * @returns dayjs 兼容的 locale 代码
+ * @returns dayjs 兼容的 locale 代码（与已加载的 zh-cn、en 对齐）
  * @example 'zh-CN' -> 'zh-cn', 'en-US' -> 'en'
  */
 export function getDayjsLocale(locale) {
   if (!locale) {
-    return normalizeLocale(getCurrentLocale());
+    var fromMaterials = getCurrentLocale();
+    var fromUtils = typeof utilsLocales.getLocale === 'function' ? utilsLocales.getLocale() : undefined;
+    // 优先 materials（umi_locale / ConfigProvider），仅当为默认 en-US 时再用 utils，保证多语言能展示
+    var raw = (fromMaterials && fromMaterials !== 'en-US' ? fromMaterials : undefined) || (typeof fromUtils === 'string' && fromUtils ? fromUtils : undefined) || fromMaterials;
+    return toDayjsLoadedLocale(normalizeLocale(raw));
   }
-  return normalizeLocale(locale);
+  return toDayjsLoadedLocale(normalizeLocale(locale));
 }

package/es/components/pisellDateTimeDisplay/utils/relativeDay.d.ts

@@ -0,0 +1,24 @@
+import type { Dayjs } from 'dayjs';
+export declare type RelativeDay = 'today' | 'yesterday' | 'tomorrow';
+/**
+ * 判断日期相对于参考日期是今天、昨天还是明天
+ *
+ * @param date 要展示的日期
+ * @param reference 参考日期（通常为「当前」dayjs()）
+ * @returns 'today' | 'yesterday' | 'tomorrow' | null
+ *
+ * @example
+ * getRelativeDay(dayjs(), dayjs())           // => 'today'
+ * getRelativeDay(dayjs().add(1,'day'), dayjs()) // => 'tomorrow'
+ * getRelativeDay(dayjs().subtract(1,'day'), dayjs()) // => 'yesterday'
+ */
+export declare function getRelativeDay(date: Dayjs, reference: Dayjs): RelativeDay | null;
+/**
+ * 根据 locale 返回相对日期的展示文案
+ * 未传 locale 时使用 getDayjsLocale()（与 locales.getLocale 同源）
+ *
+ * @param day 'today' | 'yesterday' | 'tomorrow'
+ * @param locale dayjs locale，如 'zh-cn'、'en'
+ * @returns 如 '今天'、'Today'
+ */
+export declare function getRelativeDayLabel(day: RelativeDay, locale?: string): string;

package/es/components/pisellDateTimeDisplay/utils/relativeDay.js

@@ -1,4 +1,4 @@
-import { isChinese as checkIsChinese } from "./localeUtils";
+import { isChinese as checkIsChinese, getDayjsLocale } from "./localeUtils";
 var LABELS_ZH = {
   today: '今天',
   yesterday: '昨天',
@@ -34,12 +34,14 @@ export function getRelativeDay(date, reference) {
 
 /**
  * 根据 locale 返回相对日期的展示文案
+ * 未传 locale 时使用 getDayjsLocale()（与 locales.getLocale 同源）
  *
  * @param day 'today' | 'yesterday' | 'tomorrow'
  * @param locale dayjs locale，如 'zh-cn'、'en'
  * @returns 如 '今天'、'Today'
  */
 export function getRelativeDayLabel(day, locale) {
-  var isZh = locale ? checkIsChinese(locale) : false;
+  var resolvedLocale = locale !== null && locale !== void 0 ? locale : getDayjsLocale();
+  var isZh = checkIsChinese(resolvedLocale);
   return isZh ? LABELS_ZH[day] : LABELS_EN[day];
 }

package/es/components/pisellDraggable/components/Remove/Remove.d.ts

@@ -1,3 +1,3 @@
-/// <reference types="react" />
+import React from 'react';
 import { ActionProps } from '../Action';
-export declare function Remove(props: ActionProps): JSX.Element;
+export declare function Remove(props: ActionProps): React.JSX.Element;

package/es/components/pisellDraggable/components/TreeItem/SortableTreeItem.d.ts

@@ -5,5 +5,5 @@ interface Props extends TreeItemProps {
     id: UniqueIdentifier;
     __designMode?: string;
 }
-declare const _default: React.MemoExoticComponent<({ id, depth, ...props }: Props) => JSX.Element>;
+declare const _default: React.MemoExoticComponent<({ id, depth, ...props }: Props) => React.JSX.Element>;
 export default _default;

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

@@ -30,6 +30,6 @@ interface Props {
     /** 自定义拖拽判断函数，返回false时阻止拖拽 */
     canDrop?: (dragItem: FlattenedItem, dropTarget: FlattenedItem, parentId: UniqueIdentifier | null, parentNode: any) => boolean;
 }
-export declare function SortableTree({ collapsible, value, indicator, indentationWidth, removable, renderItem, onChange, onRemoveBefore, __designMode, maxLevel, canDrop, }: Props): JSX.Element;
-declare const Demo: (props: Props) => JSX.Element;
+export declare function SortableTree({ collapsible, value, indicator, indentationWidth, removable, renderItem, onChange, onRemoveBefore, __designMode, maxLevel, canDrop, }: Props): React.JSX.Element;
+declare const Demo: (props: Props) => React.JSX.Element;
 export default Demo;

package/es/components/pisellDropSort/components/SortableItem/index.d.ts

@@ -22,5 +22,5 @@ interface SortableItemProps {
     /** 获取item样式 */
     getItemStyle?: (itemProps: TreeItem) => React.CSSProperties;
 }
-declare const SortableItem: (props: SortableItemProps) => JSX.Element;
+declare const SortableItem: (props: SortableItemProps) => React.JSX.Element;
 export default SortableItem;

package/es/components/pisellEmail/PisellEmail.less

@@ -1,31 +1,129 @@
 /**
  * PisellEmail 组件样式
+ * 基于 Figma 设计规范，与 SingleLineText 设计体系一致
  */
 
 .pisell-email {
   &-edit {
+    position: relative;
     width: 100%;
 
-    // 错误提示样式
-    &-error {
-      margin-top: 4px;
-      font-size: 12px;
-      color: #ff4d4f;
-      line-height: 1.5;
+    // 仅对 affix-wrapper 设边框，避免与内层 input 双边框（Figma 设计规范）
+    .pisell-lowcode-input-affix-wrapper {
+      font-size: 16px !important;
+      line-height: 24px !important;
+      border-radius: 8px !important;
+      border: 1px solid #d0d5dd !important; // Gray/300
+      padding: 0 !important;
+      height: 48px !important;
+      color: #101828 !important; // Gray/900
+      background-color: #ffffff !important;
+
+      &:focus,
+      &:focus-within {
+        border-color: #d6bbfb !important; // Primary/300
+        box-shadow: 0 0 0 4px #f4ebff !important; // Primary/100
+        outline: none !important;
+      }
+
+      &: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;
+      }
     }
+
+    // 内层 input（无边框，由 wrapper 统一描边）
+    .pisell-lowcode-input-affix-wrapper .pisell-lowcode-input {
+      &::placeholder {
+        color: #667085 !important; // Gray/500
+      }
+    }
+
+    // 带前缀（邮箱图标）的 Input 容器
+    .pisell-lowcode-input-affix-wrapper {
+
+      .pisell-lowcode-input-prefix {
+        margin-right: 8px;
+        margin-left: 16px;
+        color: #667085; // Gray/500
+        font-size: 16px;
+      }
+
+      .pisell-lowcode-input-suffix {
+        margin-left: 8px;
+        margin-right: 16px;
+        color: #667085;
+        font-size: 16px;
+      }
+
+      .pisell-lowcode-input {
+        padding: 12px 0 !important;
+        border: none !important;
+        box-shadow: none !important;
+
+        &:focus {
+          box-shadow: none !important;
+        }
+      }
+    }
+
+    // 清空按钮
+    .pisell-lowcode-input-clear-icon {
+      color: #667085 !important;
+      font-size: 14px !important;
+
+      &:hover {
+        color: #344054 !important; // Gray/700
+      }
+    }
+
+    // 错误状态
+    .pisell-lowcode-input-status-error,
+    .pisell-lowcode-input-affix-wrapper-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
+      }
+    }
+  }
+
+  // 错误提示（与设计体系一致）
+  &-edit-error {
+    margin-top: 4px;
+    font-size: 12px;
+    color: #d92d20; // Error/600
+    line-height: 1.5;
+    animation: pisell-email-fadeIn 0.3s ease-in-out;
   }
 
   &-read {
     display: inline-flex;
     align-items: center;
 
-    // 链接样式
     .pisell-lowcode-typography-link {
       cursor: pointer;
-      transition: all 0.3s;
+      transition: color 0.2s ease-in-out;
 
       &:hover {
-        opacity: 0.8;
+        color: #6d48c4 !important;
+      }
+
+      &:active {
+        color: #5f3da8 !important;
       }
     }
   }
@@ -40,7 +138,7 @@
   }
 }
 
-// AutoComplete 下拉样式优化
+// AutoComplete 下拉样式
 .pisell-email-autocomplete-dropdown {
   .pisell-lowcode-select-item-option-content {
     display: flex;
@@ -48,3 +146,14 @@
     gap: 8px;
   }
 }
+
+@keyframes pisell-email-fadeIn {
+  from {
+    opacity: 0;
+    transform: translateY(-4px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}

package/es/components/pisellEmail/PisellEmail.stories.js

@@ -19,7 +19,7 @@ import React from 'react';
  * - 白名单/黑名单域名限制
  */
 var meta = {
-  title: '表单/PisellEmail',
+  title: '表单/表单组件/PisellEmail',
   component: PisellEmail,
   parameters: {
     layout: 'centered',

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

@@ -1,5 +1,7 @@
 /**
  * PisellEmail 组件导出文件
  */
-export { PisellEmail, default } from './PisellEmail';
+import PisellEmail from './PisellEmail';
+export { PisellEmail };
+export default PisellEmail;
 export type { PisellEmailProps, MailtoOptions } from './types';

package/es/components/pisellEmail/index.js

@@ -2,4 +2,20 @@
  * PisellEmail 组件导出文件
  */
 
-export { PisellEmail, default } from "./PisellEmail";
+import { getText } from "../../locales";
+import PisellEmail from "./PisellEmail";
+
+/** RecordBoard 列 type 联动排序：内置 A → Z / Z → A */
+PisellEmail.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 { PisellEmail };
+export default PisellEmail;

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

@@ -15,5 +15,5 @@ export interface PisellEmptyProps extends EmptyProps {
     /** 最大宽度 */
     maxWidth?: number;
 }
-declare const PisellEmpty: (props: PisellEmptyProps) => JSX.Element;
+declare const PisellEmpty: (props: PisellEmptyProps) => React.JSX.Element;
 export default PisellEmpty;

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

@@ -1,3 +1,4 @@
+import React from 'react';
 import { PisellFilterProps } from './type';
-declare const PisellFilter: (props: PisellFilterProps) => JSX.Element;
+declare const PisellFilter: (props: PisellFilterProps) => React.JSX.Element;
 export default PisellFilter;

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/PisellFind.stories.d.ts

@@ -0,0 +1,45 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellFind } from './index';
+/**
+ * PisellFind 组件 Storybook
+ * 基于 PisellLookup 的组件内查找优化版本
+ */
+declare const meta: Meta<typeof PisellFind>;
+export default meta;
+declare type Story = StoryObj<typeof PisellFind>;
+/**
+ * 基础示例 - 列表查找
+ */
+export declare const Basic: Story;
+/**
+ * 表格查找
+ */
+export declare const TableFind: Story;
+/**
+ * Input 模式查找
+ */
+export declare const InputMode: Story;
+/**
+ * 使用 Ref 控制
+ */
+export declare const WithRef: Story;
+/**
+ * 显示确认按钮
+ */
+export declare const WithConfirmButton: Story;
+/**
+ * 关闭历史记录
+ */
+export declare const NoHistory: Story;
+/**
+ * 多字段搜索
+ */
+export declare const MultiFieldSearch: Story;
+/**
+ * Drawer 模式
+ */
+export declare const DrawerMode: Story;
+/**
+ * Playground - 自由配置
+ */
+export declare const Playground: Story;