@pisell/materials 1.8.6 → 1.8.8

package/es/components/pisellDateTimeDisplay/formats/dateTimeDisplayFormats.js

@@ -0,0 +1,81 @@
+/**
+ * PisellDateTimeDisplay 按语言预设的格式
+ * - zh-cn：完整日期 - 时间 星期（如 2025-12-31 - 2:00 周四）、相对日今天/昨天/明天
+ * - en：时间 星期, 日期（如 2:00 Sat, 21 Mar, 2026）、相对日 Today/Yesterday/Tomorrow
+ */
+export var DATETIME_DISPLAY_FORMATS = {
+  'zh-cn': {
+    dateFormat: {
+      order: 'YMD',
+      showYear: true,
+      separator: '-',
+      showChineseUnit: false,
+      showRelativeDay: true
+    },
+    timeFormat: {
+      use12Hour: false,
+      showSeconds: false
+    },
+    weekdayFormat: {
+      full: false,
+      singleLetter: false
+    },
+    fields: {
+      showTime: true,
+      showDate: true,
+      showWeekday: true,
+      fieldOrder: ['date', 'time', 'weekday'],
+      inlineSeparators: [' - ', ' ']
+    }
+  },
+  zh: {
+    // 兜底 zh
+    dateFormat: {
+      order: 'YMD',
+      showYear: true,
+      separator: '-',
+      showChineseUnit: false,
+      showRelativeDay: true
+    },
+    timeFormat: {
+      use12Hour: false,
+      showSeconds: false
+    },
+    weekdayFormat: {
+      full: false,
+      singleLetter: false
+    },
+    fields: {
+      showTime: true,
+      showDate: true,
+      showWeekday: true,
+      fieldOrder: ['date', 'time', 'weekday'],
+      inlineSeparators: [' - ', ' ']
+    }
+  },
+  en: {
+    dateFormat: {
+      order: 'DMY',
+      shortMonth: true,
+      showYear: true,
+      showRelativeDay: true,
+      useCommaBeforeYear: true
+    },
+    timeFormat: {
+      use12Hour: false,
+      showSeconds: false
+    },
+    weekdayFormat: {
+      full: false,
+      singleLetter: false,
+      trailingComma: true
+    },
+    fields: {
+      showTime: true,
+      showDate: true,
+      showWeekday: true,
+      fieldOrder: ['time', 'weekday', 'date'],
+      inlineSeparators: [' ', ' ']
+    }
+  }
+};

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

@@ -0,0 +1 @@
+export { DATETIME_DISPLAY_FORMATS } from './dateTimeDisplayFormats';

package/es/components/pisellDateTimeDisplay/formats/index.js

@@ -0,0 +1 @@
+export { DATETIME_DISPLAY_FORMATS } from "./dateTimeDisplayFormats";

package/es/components/pisellDateTimeDisplay/hooks/useCurrentTime.d.ts

@@ -15,7 +15,7 @@ export interface UseCurrentTimeOptions {
     disabled?: boolean;
     /**
      * dayjs locale
-     * @default 优先使用全局配置，其次使用浏览器语言
+     * @default 优先使用全局配置，其次使用 i18n 当前语言（getCurrentLocale）
      * @example 'zh-CN' | 'zh-HK' | 'en' | 'en-US' | 'ja'
      */
     locale?: string;
@@ -30,7 +30,7 @@ export interface UseCurrentTimeOptions {
  * @description
  * - 自动创建定时器刷新时间
  * - 支持自定义刷新间隔
- * - 支持国际化（locale）：优先级为 用户指定 > 全局配置 > 浏览器语言
+ * - 支持国际化（locale）：优先级为 用户指定 > 全局配置 > i18n 当前语言
  * - 组件卸载时自动清除定时器
  *
  * @example

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

@@ -19,7 +19,7 @@ import usePisellConfig from "../../pisell-config-provider/hooks/usePisellConfig"
  * @description
  * - 自动创建定时器刷新时间
  * - 支持自定义刷新间隔
- * - 支持国际化（locale）：优先级为 用户指定 > 全局配置 > 浏览器语言
+ * - 支持国际化（locale）：优先级为 用户指定 > 全局配置 > i18n 当前语言
  * - 组件卸载时自动清除定时器
  *
  * @example
@@ -45,7 +45,7 @@ export function useCurrentTime(options) {
   var globalConfig = usePisellConfig();
   var globalLocale = globalConfig === null || globalConfig === void 0 ? void 0 : globalConfig.locale;
 
-  // 获取实际使用的 locale（优先级：用户指定 > 全局配置 > 浏览器语言）
+  // 获取实际使用的 locale（优先级：用户指定 > 全局配置 > i18n 当前语言）
   var dayjsLocale = getDayjsLocale(userLocale || globalLocale);
 
   // 初始化时间

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

@@ -1,2 +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/index.js

@@ -1 +1,2 @@
-export { default as PisellDateTimeDisplay } from "./PisellDateTimeDisplay";
+export { default as PisellDateTimeDisplay } from "./PisellDateTimeDisplay";
+export { default } from "./PisellDateTimeDisplay";

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

@@ -99,6 +99,26 @@ export interface DateFormatConfig {
      * @default true
      */
     showDay?: boolean;
+    /**
+     * 英文 DMY 时年月之间是否加逗号（如 21 Mar, 2026；false 时为 22 Jan 2025）
+     * @default true
+     */
+    useCommaBeforeYear?: boolean;
+    /**
+     * 是否在「今天/昨天/明天」时用相对日替换具体日期
+     * 开启后：与参考日同天显示「今天」，前一天「昨天」，后一天「明天」；其他日期仍按原格式
+     * @default false
+     */
+    showRelativeDay?: boolean;
+    /**
+     * 相对日文案覆盖（用于 i18n 或自定义）
+     * 不传时按 locale 使用默认：zh 今天/昨天/明天，en Today/Yesterday/Tomorrow
+     */
+    relativeDayLabels?: {
+        today?: string;
+        yesterday?: string;
+        tomorrow?: string;
+    };
 }
 /**
  * 星期格式配置
@@ -116,6 +136,11 @@ export interface WeekdayFormatConfig {
      * @example true -> "S" / "六" | false -> "Sat" / "周六"
      */
     singleLetter?: boolean;
+    /**
+     * 是否在星期后加逗号（用于与日期拼接如 "Sat, 21 Mar, 2026"）
+     * @default false
+     */
+    trailingComma?: boolean;
 }
 /**
  * 字段配置
@@ -141,6 +166,12 @@ export interface FieldConfig {
      * @default ['time', 'date', 'weekday']
      */
     fieldOrder?: FieldType[];
+    /**
+     * 单行布局时每段之间的分隔符，按顺序对应字段之间
+     * 如 ['date','time','weekday'] 配 inlineSeparators: [' - ', ' '] => "2025-12-31 - 2:00 周四"
+     * 不足时用组件 inlineSeparator 补齐
+     */
+    inlineSeparators?: string[];
 }
 /**
  * 文本样式配置
@@ -202,6 +233,16 @@ export interface ContainerStyleConfig {
      */
     gap?: number | string;
 }
+/**
+ * 多语言格式预设（日期/时间/星期 + 字段顺序与分隔符）
+ * 用于 formatByLocale[locale] 或默认多语言配置
+ */
+export interface DateTimeDisplayFormatPreset {
+    dateFormat?: DateFormatConfig;
+    timeFormat?: TimeFormatConfig;
+    weekdayFormat?: WeekdayFormatConfig;
+    fields?: FieldConfig;
+}
 /**
  * PisellDateTimeDisplay 组件 Props
  */
@@ -220,6 +261,11 @@ export interface PisellDateTimeDisplayProps {
      * 字段显示配置
      */
     fields?: FieldConfig;
+    /**
+     * 多语言格式配置：按 locale 取对应格式预设，再与下方单项配置合并（单项优先）
+     * @example formatByLocale={{ 'zh-cn': { dateFormat: {...}, fields: { fieldOrder: ['date','time','weekday'], inlineSeparators: [' - ', ' '] } }, 'en': {...} }}
+     */
+    formatByLocale?: Record<string, Partial<DateTimeDisplayFormatPreset>>;
     /**
      * 时间格式配置
      */
@@ -274,11 +320,11 @@ export interface PisellDateTimeDisplayProps {
     disableAutoRefresh?: boolean;
     /**
      * dayjs locale（语言代码）
-     * @default 优先使用全局配置（usePisellConfig），其次使用浏览器语言
+     * @default 优先使用全局配置（usePisellConfig），其次使用 i18n 当前语言（getCurrentLocale：全局配置 / umi_locale）
      * @example 'zh-CN' | 'zh-HK' | 'en' | 'en-US' | 'ja'
      * @description
      * - 支持标准 BCP 47 语言代码，会自动标准化为 dayjs 兼容格式
-     * - 优先级：组件 locale 属性 > PisellConfigProvider 全局配置 > 浏览器语言
+     * - 优先级：组件 locale 属性 > PisellConfigProvider 全局配置 > i18n 当前语言
      */
     locale?: string;
     /**

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

@@ -41,7 +41,9 @@ export function formatDate(date, config) {
     _ref$showMonth = _ref.showMonth,
     showMonth = _ref$showMonth === void 0 ? true : _ref$showMonth,
     _ref$showDay = _ref.showDay,
-    showDay = _ref$showDay === void 0 ? true : _ref$showDay;
+    showDay = _ref$showDay === void 0 ? true : _ref$showDay,
+    _ref$useCommaBeforeYe = _ref.useCommaBeforeYear,
+    useCommaBeforeYear = _ref$useCommaBeforeYe === void 0 ? true : _ref$useCommaBeforeYe;
 
   // 判断是否为中文环境
   var locale = date.locale();
@@ -99,13 +101,10 @@ export function formatDate(date, config) {
     return date.format(parts.join(''));
   }
 
-  // MDY 格式特殊处理（英文习惯）
+  // MDY 格式特殊处理（英文习惯）Mar 21, 2026
   if (order === 'MDY' && !isChinese) {
-    // 月日之间用空格，日年之间用逗号+空格
     var formatted = date.format(parts.join(' '));
-    // 如果有年份，在日和年之间加逗号
     if (showYear && showMonth && showDay) {
-      // 例如: "Mar 21 2026" -> "Mar 21, 2026"
       var _formatted$split = formatted.split(' '),
         _formatted$split2 = _slicedToArray(_formatted$split, 3),
         month = _formatted$split2[0],
@@ -114,7 +113,6 @@ export function formatDate(date, config) {
       return "".concat(month, " ").concat(day, ", ").concat(year);
     }
     if (showYear && showDay && !showMonth) {
-      // 例如: "21 2026" -> "21, 2026"
       var _formatted$split3 = formatted.split(' '),
         _formatted$split4 = _slicedToArray(_formatted$split3, 2),
         _day = _formatted$split4[0],
@@ -124,6 +122,27 @@ export function formatDate(date, config) {
     return formatted;
   }
 
+  // DMY 格式英文：21 Mar, 2026 或 22 Jan 2025（useCommaBeforeYear 控制）
+  if (order === 'DMY' && !isChinese) {
+    var _formatted = date.format(parts.join(' '));
+    if (showYear && showMonth && showDay && useCommaBeforeYear) {
+      var _formatted$split5 = _formatted.split(' '),
+        _formatted$split6 = _slicedToArray(_formatted$split5, 3),
+        _day2 = _formatted$split6[0],
+        _month = _formatted$split6[1],
+        _year2 = _formatted$split6[2];
+      return "".concat(_day2, " ").concat(_month, ", ").concat(_year2);
+    }
+    if (showYear && showDay && !showMonth && useCommaBeforeYear) {
+      var _formatted$split7 = _formatted.split(' '),
+        _formatted$split8 = _slicedToArray(_formatted$split7, 2),
+        _day3 = _formatted$split8[0],
+        _year3 = _formatted$split8[1];
+      return "".concat(_day3, ", ").concat(_year3);
+    }
+    return _formatted;
+  }
+
   // 其他情况使用分隔符
   return date.format(parts.join(separator));
 }

package/es/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/es/components/pisellDateTimeDisplay/utils/formatDateOrRelative.js

@@ -0,0 +1,38 @@
+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 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); }
+import { formatDate } from "./formatDate";
+import { formatWeekday } from "./formatWeekday";
+import { getRelativeDay, getRelativeDayLabel } from "./relativeDay";
+
+/**
+ * 获取「日期部分」的展示文案（相对日内置在 datetime）
+ * - 若开启 showRelativeDay 且日期为今天/昨天/明天，返回相对日文案（如「今天」「Yesterday」）
+ * - 否则返回「星期, 日期」格式（用于时间区间跨天等场景）
+ *
+ * 供 PisellDateTimeDisplay、PisellTimeRangeDisplay 等统一使用，相对时间逻辑只在此处维护
+ */
+export function getDatePartDisplay(params) {
+  var date = params.date,
+    dateFormat = params.dateFormat,
+    weekdayFormat = params.weekdayFormat,
+    referenceDate = params.referenceDate,
+    dateFormatOverride = params.dateFormatOverride;
+  if (dateFormat !== null && dateFormat !== void 0 && dateFormat.showRelativeDay) {
+    var rel = getRelativeDay(date, referenceDate);
+    if (rel) {
+      var _labels$rel;
+      var labels = dateFormat.relativeDayLabels;
+      return (_labels$rel = labels === null || labels === void 0 ? void 0 : labels[rel]) !== null && _labels$rel !== void 0 ? _labels$rel : getRelativeDayLabel(rel, date.locale());
+    }
+  }
+  var mergedDateConfig = _objectSpread(_objectSpread({}, dateFormat), dateFormatOverride);
+  var weekdayStr = formatWeekday(date, _objectSpread(_objectSpread({}, weekdayFormat), {}, {
+    trailingComma: true
+  }));
+  var dateStr = formatDate(date, mergedDateConfig);
+  return "".concat(weekdayStr, " ").concat(dateStr);
+}

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

@@ -32,32 +32,31 @@ export function formatWeekday(weekday, config) {
     _ref$full = _ref.full,
     full = _ref$full === void 0 ? false : _ref$full,
     _ref$singleLetter = _ref.singleLetter,
-    singleLetter = _ref$singleLetter === void 0 ? false : _ref$singleLetter;
+    singleLetter = _ref$singleLetter === void 0 ? false : _ref$singleLetter,
+    _ref$trailingComma = _ref.trailingComma,
+    trailingComma = _ref$trailingComma === void 0 ? false : _ref$trailingComma;
 
   // 判断是否为中文环境
   var locale = weekday.locale();
   var isChinese = checkIsChinese(locale);
+  var appendComma = function appendComma(s) {
+    return trailingComma ? isChinese ? "".concat(s, "\uFF0C") : "".concat(s, ",") : s;
+  };
 
   // 单字母展示
   if (singleLetter) {
     if (isChinese) {
-      // 中文：一、二、三、四、五、六、日
       var weekdayMap = ['日', '一', '二', '三', '四', '五', '六'];
-      return weekdayMap[weekday.day()];
-    } else {
-      // 英文：S, M, T, W, T, F, S
-      // 使用 format('dd') 获取缩写（如 Su, Mo），然后取第一个字母
-      return weekday.format('dd').charAt(0);
+      return appendComma(weekdayMap[weekday.day()]);
     }
+    return appendComma(weekday.format('dd').charAt(0));
   }
 
   // 完整展示
   if (full) {
-    // dddd: 星期一 / Monday
-    return weekday.format('dddd');
+    return appendComma(weekday.format('dddd'));
   }
 
-  // 默认（缩写）
-  // ddd: 周一 / Mon
-  return weekday.format('ddd');
+  // 默认（缩写）ddd: 周一 / Mon
+  return appendComma(weekday.format('ddd'));
 }

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

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

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

@@ -1,5 +1,7 @@
 export { formatTime } from "./formatTime";
 export { formatDate } from "./formatDate";
 export { formatWeekday } from "./formatWeekday";
+export { getDatePartDisplay } from "./formatDateOrRelative";
 export { getRefreshInterval } from "./getRefreshInterval";
-export { getBrowserLocale, normalizeLocale, isChinese, getDayjsLocale } from "./localeUtils";
+export { getRelativeDay, getRelativeDayLabel } from "./relativeDay";
+export { normalizeLocale, isChinese, getDayjsLocale } from "./localeUtils";

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

@@ -1,9 +1,3 @@
-/**
- * 获取浏览器语言
- * @returns 浏览器语言代码
- * @example 'zh-CN' | 'en' | 'zh-HK'
- */
-export declare function getBrowserLocale(): string;
 /**
  * 标准化 locale 代码
  * @param locale 原始 locale 代码
@@ -20,7 +14,8 @@ export declare function normalizeLocale(locale: string): string;
 export declare function isChinese(locale: string): boolean;
 /**
  * 获取 dayjs 兼容的 locale 代码
- * @param locale 原始 locale 代码
+ * 未传 locale 时使用 i18n 当前语言（全局配置 / umi_locale），不再使用浏览器语言
+ * @param locale 原始 locale 代码（可选）
  * @returns dayjs 兼容的 locale 代码
  * @example 'zh-CN' -> 'zh-cn', 'en-US' -> 'en'
  */

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

@@ -1,17 +1,4 @@
-/**
- * 获取浏览器语言
- * @returns 浏览器语言代码
- * @example 'zh-CN' | 'en' | 'zh-HK'
- */
-export function getBrowserLocale() {
-  if (typeof window === 'undefined' || typeof navigator === 'undefined') {
-    return 'en';
-  }
-
-  // 优先使用 navigator.language
-  var browserLang = navigator.language || navigator.userLanguage || 'en';
-  return browserLang;
-}
+import { getCurrentLocale } from "../../../utils/locale";
 
 /**
  * 标准化 locale 代码
@@ -36,14 +23,14 @@ export function isChinese(locale) {
 
 /**
  * 获取 dayjs 兼容的 locale 代码
- * @param locale 原始 locale 代码
+ * 未传 locale 时使用 i18n 当前语言（全局配置 / umi_locale），不再使用浏览器语言
+ * @param locale 原始 locale 代码（可选）
  * @returns dayjs 兼容的 locale 代码
  * @example 'zh-CN' -> 'zh-cn', 'en-US' -> 'en'
  */
 export function getDayjsLocale(locale) {
   if (!locale) {
-    var browserLocale = getBrowserLocale();
-    return normalizeLocale(browserLocale);
+    return normalizeLocale(getCurrentLocale());
   }
   return normalizeLocale(locale);
 }

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

@@ -0,0 +1,23 @@
+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 返回相对日期的展示文案
+ *
+ * @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

@@ -0,0 +1,45 @@
+import { isChinese as checkIsChinese } from "./localeUtils";
+var LABELS_ZH = {
+  today: '今天',
+  yesterday: '昨天',
+  tomorrow: '明天'
+};
+var LABELS_EN = {
+  today: 'Today',
+  yesterday: 'Yesterday',
+  tomorrow: '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 function getRelativeDay(date, reference) {
+  var d = date.startOf('day');
+  var r = reference.startOf('day');
+  var diff = d.diff(r, 'day');
+  if (diff === 0) return 'today';
+  if (diff === 1) return 'tomorrow';
+  if (diff === -1) return 'yesterday';
+  return null;
+}
+
+/**
+ * 根据 locale 返回相对日期的展示文案
+ *
+ * @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;
+  return isZh ? LABELS_ZH[day] : LABELS_EN[day];
+}

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

@@ -0,0 +1,37 @@
+import React from 'react';
+import type { PisellEmailProps } from './types';
+import './PisellEmail.less';
+/**
+ * PisellEmail 邮箱地址组件
+ *
+ * 邮箱地址输入/展示组件，支持只读、编辑、禁用三种状态。
+ * 基于 Ant Design AutoComplete 和 Input 组件开发，提供邮箱格式校验、域名智能补全、
+ * mailto 邮件发送和域名隐藏功能。
+ *
+ * @param props 组件 Props
+ *
+ * @example
+ * // 编辑态（邮箱输入）
+ * <PisellEmail
+ *   placeholder="请输入邮箱地址"
+ *   required
+ * />
+ *
+ * @example
+ * // 只读态（可发邮件）
+ * <PisellEmail
+ *   mode="read"
+ *   value="user@example.com"
+ *   enableMailto
+ * />
+ *
+ * @example
+ * // 域名补全
+ * <PisellEmail
+ *   enableAutoComplete
+ *   autoCompleteDomains={['gmail.com', 'company.com']}
+ * />
+ */
+export declare const PisellEmail: React.FC<PisellEmailProps>;
+declare const _default: React.NamedExoticComponent<PisellEmailProps>;
+export default _default;

package/es/components/pisellEmail/PisellEmail.less

@@ -20,7 +20,7 @@
     align-items: center;
 
     // 链接样式
-    .ant-typography-link {
+    .pisell-lowcode-typography-link {
       cursor: pointer;
       transition: all 0.3s;
 
@@ -42,7 +42,7 @@
 
 // AutoComplete 下拉样式优化
 .pisell-email-autocomplete-dropdown {
-  .ant-select-item-option-content {
+  .pisell-lowcode-select-item-option-content {
     display: flex;
     align-items: center;
     gap: 8px;