@pisell/materials 1.8.12 → 1.8.13

package/lib/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/lib/components/pisellDateTimeDisplay/utils/formatDateOrRelative.d.ts

@@ -0,0 +1,17 @@
+import type { Dayjs } from 'dayjs';
+import type { DateFormatConfig, WeekdayFormatConfig } from '../types';
+/**
+ * 获取「日期部分」的展示文案（相对日内置在 datetime）
+ * - 若开启 showRelativeDay 且日期为今天/昨天/明天，返回相对日文案（如「今天」「Yesterday」）
+ * - 否则返回「星期, 日期」格式（用于时间区间跨天等场景）
+ *
+ * 供 PisellDateTimeDisplay、PisellTimeRangeDisplay 等统一使用，相对时间逻辑只在此处维护
+ */
+export declare function getDatePartDisplay(params: {
+    date: Dayjs;
+    dateFormat?: DateFormatConfig;
+    weekdayFormat?: WeekdayFormatConfig;
+    referenceDate: Dayjs;
+    /** 覆盖日期格式（如跨天时的 order: 'DMY', shortMonth: true） */
+    dateFormatOverride?: Partial<DateFormatConfig>;
+}): string;

package/lib/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/lib/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/lib/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/lib/components/pisellDateTimeDisplay/utils/localeUtils.js

@@ -24,6 +24,7 @@ __export(localeUtils_exports, {
   normalizeLocale: () => normalizeLocale
 });
 module.exports = __toCommonJS(localeUtils_exports);
+var import_utils = require("@pisell/utils");
 var import_locale = require("../../../utils/locale");
 function normalizeLocale(locale) {
   return locale.toLowerCase();
@@ -32,11 +33,18 @@ function isChinese(locale) {
   const normalizedLocale = normalizeLocale(locale);
   return normalizedLocale.startsWith("zh");
 }
+function toDayjsLoadedLocale(normalized) {
+  if (normalized.startsWith("en")) return "en";
+  return normalized;
+}
 function getDayjsLocale(locale) {
   if (!locale) {
-    return normalizeLocale((0, import_locale.getCurrentLocale)());
+    const fromMaterials = (0, import_locale.getCurrentLocale)();
+    const fromUtils = typeof import_utils.locales.getLocale === "function" ? import_utils.locales.getLocale() : void 0;
+    const raw = (fromMaterials && fromMaterials !== "en-US" ? fromMaterials : void 0) || (typeof fromUtils === "string" && fromUtils ? fromUtils : void 0) || fromMaterials;
+    return toDayjsLoadedLocale(normalizeLocale(raw));
   }
-  return normalizeLocale(locale);
+  return toDayjsLoadedLocale(normalizeLocale(locale));
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/lib/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/lib/components/pisellDateTimeDisplay/utils/relativeDay.js

@@ -44,7 +44,8 @@ function getRelativeDay(date, reference) {
   return null;
 }
 function getRelativeDayLabel(day, locale) {
-  const isZh = locale ? (0, import_localeUtils.isChinese)(locale) : false;
+  const resolvedLocale = locale ?? (0, import_localeUtils.getDayjsLocale)();
+  const isZh = (0, import_localeUtils.isChinese)(resolvedLocale);
   return isZh ? LABELS_ZH[day] : LABELS_EN[day];
 }
 // Annotate the CommonJS export names for ESM import in node:

package/lib/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/lib/components/pisellEmail/PisellEmail.stories.js

@@ -60,7 +60,7 @@ module.exports = __toCommonJS(PisellEmail_stories_exports);
 var import_PisellEmail = require("./PisellEmail");
 var import_react = __toESM(require("react"));
 var meta = {
-  title: "表单/PisellEmail",
+  title: "表单/表单组件/PisellEmail",
   component: import_PisellEmail.PisellEmail,
   parameters: {
     layout: "centered",

package/lib/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/lib/components/pisellEmail/index.js

@@ -29,11 +29,19 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/components/pisellEmail/index.tsx
 var pisellEmail_exports = {};
 __export(pisellEmail_exports, {
-  PisellEmail: () => import_PisellEmail.PisellEmail,
-  default: () => import_PisellEmail.default
+  PisellEmail: () => import_PisellEmail.default,
+  default: () => pisellEmail_default
 });
 module.exports = __toCommonJS(pisellEmail_exports);
+var import_locales = require("../../locales");
 var import_PisellEmail = __toESM(require("./PisellEmail"));
+import_PisellEmail.default.SortOptions = {
+  getSortItems: (fieldKey) => [
+    { key: `${fieldKey}:asc`, label: (0, import_locales.getText)("sort-a-z") },
+    { key: `${fieldKey}:desc`, label: (0, import_locales.getText)("sort-z-a") }
+  ]
+};
+var pisellEmail_default = import_PisellEmail.default;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PisellEmail

package/lib/components/pisellFilter/index.js

@@ -43,38 +43,109 @@ var PisellFilter = (props) => {
     hiddenQuickFilter = true,
     hiddenOtherFilter = false,
     hasForm = true,
+    onChange,
     ...otherProps
   } = props;
-  const [value, setValue] = (0, import_react.useState)({});
+  const [form] = import_antd.Form.useForm();
+  const [value, setValue] = (0, import_react.useState)(() => ({
+    quickFilter: (originalValue == null ? void 0 : originalValue.quickFilter) || [],
+    otherFilter: (originalValue == null ? void 0 : originalValue.otherFilter) || [],
+    values: (originalValue == null ? void 0 : originalValue.values) || {}
+  }));
+  const isInternalChange = (0, import_react.useRef)(false);
   (0, import_react.useEffect)(() => {
-    setValue({
-      quickFilter: (originalValue == null ? void 0 : originalValue.quickFilter) || [],
-      otherFilter: (originalValue == null ? void 0 : originalValue.otherFilter) || []
-    });
-  }, [originalValue]);
+    setValue((prev) => ({
+      quickFilter: (originalValue == null ? void 0 : originalValue.quickFilter) ?? prev.quickFilter,
+      otherFilter: (originalValue == null ? void 0 : originalValue.otherFilter) ?? prev.otherFilter,
+      values: (originalValue == null ? void 0 : originalValue.values) ?? prev.values ?? {}
+    }));
+  }, [
+    originalValue == null ? void 0 : originalValue.quickFilter,
+    originalValue == null ? void 0 : originalValue.otherFilter,
+    originalValue == null ? void 0 : originalValue.values
+  ]);
+  (0, import_react.useEffect)(() => {
+    if (!hasForm || typeof (originalValue == null ? void 0 : originalValue.values) !== "object") return;
+    if (isInternalChange.current) {
+      isInternalChange.current = false;
+      return;
+    }
+    const nextValues = (originalValue == null ? void 0 : originalValue.values) ?? {};
+    if (Object.keys(nextValues).length === 0) {
+      const current = form.getFieldsValue(true);
+      const cleared = Object.keys(current).reduce(
+        (acc, k) => {
+          acc[k] = void 0;
+          return acc;
+        },
+        {}
+      );
+      if (Object.keys(cleared).length > 0) {
+        form.setFieldsValue(cleared);
+      }
+    } else {
+      form.setFieldsValue(nextValues);
+    }
+  }, [hasForm, form, originalValue == null ? void 0 : originalValue.values]);
+  const handleChange = (0, import_react.useCallback)(
+    (newVal) => {
+      setValue((prev) => ({
+        ...prev,
+        ...newVal,
+        values: newVal.values ?? prev.values
+      }));
+      onChange == null ? void 0 : onChange(newVal);
+    },
+    [onChange]
+  );
+  const handleFormValuesChange = (0, import_react.useCallback)(
+    (_, allValues) => {
+      if (typeof allValues !== "object" || allValues === null) return;
+      isInternalChange.current = true;
+      const mergedValues = { ...value.values, ...allValues };
+      const next = {
+        quickFilter: value.quickFilter,
+        otherFilter: value.otherFilter,
+        values: mergedValues
+      };
+      setValue(next);
+      onChange == null ? void 0 : onChange(next);
+    },
+    [value.quickFilter, value.otherFilter, value.values, onChange]
+  );
   const content = (0, import_react.useMemo)(() => {
     return /* @__PURE__ */ import_react.default.createElement(
       import_FilterButton.default,
       {
         ...otherProps,
+        onChange: handleChange,
         value: {
           quickFilter: value.quickFilter,
           otherFilter: value.otherFilter
         },
         hiddenQuickFilter,
         hiddenOtherFilter,
-        onChange: setValue,
         quickFilterMaxLength: quickFilterMaxLength || 100,
         formFiltersPrefix: formFiltersPrefix || ""
       }
     );
-  }, [value, hiddenQuickFilter, hiddenOtherFilter, quickFilterMaxLength, formFiltersPrefix]);
+  }, [
+    value,
+    hiddenQuickFilter,
+    hiddenOtherFilter,
+    quickFilterMaxLength,
+    formFiltersPrefix,
+    handleChange
+  ]);
   if (hasForm) {
     return /* @__PURE__ */ import_react.default.createElement(
       import_antd.Form,
       {
+        form,
         size: "large",
         layout: "vertical",
+        initialValues: value.values,
+        onValuesChange: handleFormValuesChange,
         ...otherProps
       },
       content

package/lib/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;

package/lib/components/pisellFind/index.d.ts

@@ -0,0 +1,40 @@
+import React from 'react';
+import type { PisellLookupProps, PisellLookupRef } from '../pisellLookup';
+/**
+ * PisellFind Props
+ * 继承 PisellLookup 的所有 Props
+ */
+export declare type PisellFindProps = PisellLookupProps;
+/**
+ * PisellFind Ref
+ * 继承 PisellLookup 的所有 Ref 方法
+ */
+export declare type PisellFindRef = PisellLookupRef;
+/**
+ * PisellFind 组件
+ * 基于 PisellLookup 的组件内查找优化版本
+ *
+ * 核心特点：
+ * - 默认使用 button 触发器
+ * - 默认不显示确认按钮（输入即搜索）
+ * - 默认开启搜索历史
+ * - 默认不展示结果区（结果在页面其他位置展示）
+ *
+ * @example
+ * ```tsx
+ * // 基础用法
+ * <PisellFind
+ *   onSearch={(keyword) => {
+ *     const filtered = data.filter(item => item.name.includes(keyword));
+ *     setFilteredData(filtered);
+ *   }}
+ * />
+ *
+ * // 切换为 Input 模式
+ * <PisellFind
+ *   triggerType="input"
+ *   onSearch={(keyword) => filterData(keyword)}
+ * />
+ * ```
+ */
+export declare const PisellFind: React.ForwardRefExoticComponent<PisellLookupProps & React.RefAttributes<PisellLookupRef>>;

package/lib/components/pisellFind/index.js

@@ -33,14 +33,23 @@ __export(pisellFind_exports, {
 });
 module.exports = __toCommonJS(pisellFind_exports);
 var import_react = __toESM(require("react"));
+var import_utils = require("@pisell/utils");
 var import_pisellLookup = require("../pisellLookup");
 var import_locales = require("../../locales");
 var PisellFind = (0, import_react.forwardRef)((props, ref) => {
   const {
     // 提取需要设置默认值的 Props
     triggerType = "button",
-    buttonText = (0, import_locales.getText)("pisell-find-button-text"),
-    placeholder = (0, import_locales.getText)("pisell-find-placeholder"),
+    buttonText = (() => {
+      const key = "pisell2.recordBoard.toolbar.find";
+      const u = import_utils.locales.getText(key);
+      return u && u !== key ? u : (0, import_locales.getText)(key) || (0, import_locales.getText)("pisell-find-button-text");
+    })(),
+    placeholder = (() => {
+      const key = "pisell2.recordBoard.toolbar.findPlaceholder";
+      const u = import_utils.locales.getText(key);
+      return u && u !== key ? u : (0, import_locales.getText)(key) || (0, import_locales.getText)("pisell-find-placeholder");
+    })(),
     showConfirmButton = false,
     showHistory = true,
     historyKey = "pisell_find_history",

package/lib/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;
+  }
+}