@pisell/materials 1.8.6 → 1.8.8

package/lib/components/pisellCurrency/PisellCurrency.stories.d.ts

@@ -0,0 +1,56 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellCurrency } from './PisellCurrency';
+/**
+ * PisellCurrency 组件 Storybook
+ */
+declare const meta: Meta<typeof PisellCurrency>;
+export default meta;
+declare type Story = StoryObj<typeof PisellCurrency>;
+/**
+ * 基础示例 - 人民币
+ */
+export declare const Basic: Story;
+/**
+ * 不同货币
+ */
+export declare const DifferentCurrencies: Story;
+/**
+ * 只读态展示
+ */
+export declare const ReadOnly: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 不显示货币符号
+ */
+export declare const WithoutSymbol: Story;
+/**
+ * 禁止负数（商品价格）
+ */
+export declare const NoNegative: Story;
+/**
+ * 允许负数（退款金额）
+ */
+export declare const AllowNegative: Story;
+/**
+ * 表单场景
+ */
+export declare const InForm: Story;
+/**
+ * 表格场景
+ */
+export declare const InTable: Story;
+/**
+ * 不同精度
+ */
+export declare const DifferentPrecision: Story;
+/**
+ * 只读态样式
+ */
+export declare const ReadOnlyStyles: Story;
+/**
+ * 空值处理
+ */
+export declare const EmptyValue: Story;

package/lib/components/pisellCurrency/components/DisabledView.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { PisellCurrencyProps } from '../types';
+/**
+ * PisellCurrency 禁用态视图组件
+ *
+ * 负责渲染禁用态的输入框
+ *
+ * @param props 组件 Props
+ */
+declare const DisabledView: React.FC<PisellCurrencyProps>;
+export default DisabledView;

package/lib/components/pisellCurrency/components/EditView.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { PisellCurrencyProps } from '../types';
+/**
+ * PisellCurrency 编辑态视图组件
+ *
+ * 负责渲染编辑态的输入框，基于 Ant Design InputNumber 组件
+ *
+ * 功能：
+ * - 货币数值输入
+ * - 货币符号显示（prefix 或 addonAfter）
+ * - 负数校验
+ * - 实时或失焦校验
+ * - 错误提示展示
+ *
+ * @param props 组件 Props
+ */
+declare const EditView: React.FC<PisellCurrencyProps>;
+export default EditView;

package/lib/components/pisellCurrency/components/ReadOnlyView.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { PisellCurrencyProps } from '../types';
+/**
+ * PisellCurrency 只读态视图组件
+ *
+ * 负责渲染只读态的纯文本展示
+ *
+ * 功能：
+ * - 格式化货币数值并展示
+ * - 添加货币符号（无空格）
+ * - 支持自定义字体样式
+ * - 处理空值显示
+ *
+ * @param props 组件 Props
+ */
+declare const ReadOnlyView: React.FC<PisellCurrencyProps>;
+export default ReadOnlyView;

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

@@ -0,0 +1,6 @@
+/**
+ * PisellCurrency 子组件导出
+ */
+export { default as ReadOnlyView } from './ReadOnlyView';
+export { default as EditView } from './EditView';
+export { default as DisabledView } from './DisabledView';

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

@@ -0,0 +1,6 @@
+/**
+ * PisellCurrency 组件导出
+ */
+export { default as PisellCurrency } from './PisellCurrency';
+export type { PisellCurrencyProps } from './types';
+export type { DisplayState, ValidationResult, NumberInputState, BaseNumberInputProps } from './types';

package/lib/components/pisellCurrency/types.d.ts

@@ -0,0 +1,56 @@
+import type { PisellNumberProps } from '../pisellNumber';
+/**
+ * 从 @pisell/utils 重新导出公共类型
+ */
+export type { DisplayState, ValidationResult, NumberInputState, BaseNumberInputProps, } from '@pisell/utils';
+/**
+ * PisellCurrency 组件 Props 类型定义
+ *
+ * 基于 PisellNumber 扩展，专门处理货币数据
+ */
+export interface PisellCurrencyProps extends PisellNumberProps {
+    /**
+     * 货币符号
+     * @default '¥'
+     * @example '¥', '$', '€', '£', '₩', '₽'
+     */
+    currencySymbol?: string;
+    /**
+     * 货币符号位置
+     * - before: 前置，如 ¥100
+     * - after: 后置，如 100€
+     * @default 'before'
+     */
+    symbolPosition?: 'before' | 'after';
+    /**
+     * 是否显示货币符号
+     * @default true
+     */
+    showSymbol?: boolean;
+    /**
+     * 货币代码（用于国际化标识）
+     * @example 'CNY', 'USD', 'EUR', 'GBP'
+     */
+    currencyCode?: string;
+    /**
+     * 是否允许负数
+     * @default true
+     * @description
+     * - true: 允许负数（如退款场景）
+     * - false: 不允许负数（如商品价格）
+     */
+    allowNegative?: boolean;
+    /**
+     * 小数精度
+     * @default 2
+     * @description 货币默认保留2位小数，符合财务规范
+     */
+    precision?: number;
+    /**
+     * 是否使用千分位分隔符
+     * @default true
+     * @description 货币默认启用千分位，符合财务规范
+     * @example 1234.56 → 1,234.56
+     */
+    useGrouping?: boolean;
+}

package/lib/components/pisellCurrency/utils/currencyFormatter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 货币格式化选项
+ */
+export interface CurrencyFormatOptions {
+    /** 货币符号 */
+    currencySymbol: string;
+    /** 符号位置 */
+    symbolPosition: 'before' | 'after';
+    /** 是否显示符号 */
+    showSymbol: boolean;
+    /** 小数精度 */
+    precision: number;
+    /** 是否使用千分位 */
+    useGrouping: boolean;
+}
+/**
+ * 格式化货币数值
+ *
+ * @param value 数值
+ * @param options 格式化选项
+ * @returns 格式化后的货币字符串
+ *
+ * @example
+ * formatCurrency(1234.56, { currencySymbol: '¥', symbolPosition: 'before', showSymbol: true, precision: 2, useGrouping: true })
+ * // 返回: '¥1,234.56'
+ *
+ * @example
+ * formatCurrency(999.99, { currencySymbol: '€', symbolPosition: 'after', showSymbol: true, precision: 2, useGrouping: true })
+ * // 返回: '999.99€'
+ */
+export declare function formatCurrency(value: number | null | undefined, options: CurrencyFormatOptions): string | null;

package/lib/components/pisellCurrency/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * PisellCurrency 工具函数导出
+ */
+export { formatCurrency } from './currencyFormatter';
+export type { CurrencyFormatOptions } from './currencyFormatter';

package/lib/components/pisellDataSourceContainer/PisellDataSourceContainer.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { DataSourceContainerProps } from './type';
 declare const PisellDataSourceContainer: (props: DataSourceContainerProps) => JSX.Element;
 export default PisellDataSourceContainer;

package/lib/components/pisellDataSourceContainer/components/ColumnsSetting/utils.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+export declare const saveColumnSettingToLocal: ({ componentId, columnSetting, }: {
+    componentId: string;
+    columnSetting: Array<{
+        key: string;
+        dataIndex: string;
+        title?: React.ReactNode;
+        titleString?: string;
+        isShow: boolean;
+        sortIndex?: number;
+        fixed?: 'left' | 'right' | boolean;
+    }>;
+}) => void;
+export declare const getColumnSettingFromLocal: (componentId?: string) => any;
+export declare const mergeColumnSettingSimple: ({ columns, componentId, }: {
+    columns: Record<string, any>[];
+    componentId?: string | undefined;
+}) => {
+    isShow: any;
+    sortIndex: any;
+}[];
+export declare const clearColumnSettingFromLocal: (componentId?: string) => void;

package/lib/components/pisellDataSourceContainer/hooks/useDataSourceKey.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 declare const useDataSourceKey: () => {
     dataSourceKey: string | import("../../dataSourceComponents/provider/dataSource/DataSourceContext").DataSourceType | undefined;
     dataSourceKeyRef: import("react").MutableRefObject<string | import("../../dataSourceComponents/provider/dataSource/DataSourceContext").DataSourceType | undefined>;

package/lib/components/pisellDataSourceContainer/utils/formatData.d.ts

@@ -0,0 +1,9 @@
+declare const formatListResult: (result: any) => {
+    list: any;
+    count: any;
+};
+declare const formatListParams: (params: any) => {
+    page: any;
+    pageSize: any;
+};
+export { formatListParams, formatListResult };

package/lib/components/pisellDatePicker/datePickerCpt.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { PickerDateProps } from 'antd/es/date-picker/generatePicker';
 import { Dayjs } from 'dayjs';
 import './detePickerCpt.less';

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

@@ -1,3 +1,2 @@
-/// <reference types="react" />
 declare const PisellDatePicker: (props: any) => JSX.Element;
 export default PisellDatePicker;

package/lib/components/pisellDateTimeDisplay/PisellDateTimeDisplay.js

@@ -34,17 +34,20 @@ __export(PisellDateTimeDisplay_exports, {
 });
 module.exports = __toCommonJS(PisellDateTimeDisplay_exports);
 var import_react = __toESM(require("react"));
+var import_dayjs = __toESM(require("dayjs"));
 var import_zh_cn = require("dayjs/locale/zh-cn");
 var import_en = require("dayjs/locale/en");
 var import_hooks = require("./hooks");
 var import_utils = require("./utils");
 var import_components = require("./components");
+var import_dateTimeDisplayFormats = require("./formats/dateTimeDisplayFormats");
 var import_PisellDateTimeDisplay = require("./PisellDateTimeDisplay.less");
 var PisellDateTimeDisplay = (props) => {
   const {
     layout = "horizontal",
     textAlign = "center",
     fields,
+    formatByLocale,
     timeFormat,
     dateFormat,
     weekdayFormat,
@@ -62,7 +65,15 @@ var PisellDateTimeDisplay = (props) => {
     className,
     style
   } = props;
-  const computedRefreshInterval = refreshInterval ?? (0, import_utils.getRefreshInterval)(timeFormat);
+  const localeKey = (0, import_utils.getDayjsLocale)(locale);
+  const baseLocale = localeKey.split("-")[0];
+  const presetSource = formatByLocale ?? import_dateTimeDisplayFormats.DATETIME_DISPLAY_FORMATS;
+  const preset = presetSource[localeKey] ?? presetSource[baseLocale] ?? {};
+  const effectiveFields = { ...preset.fields, ...fields };
+  const effectiveDateFormat = { ...preset.dateFormat, ...dateFormat };
+  const effectiveTimeFormat = { ...preset.timeFormat, ...timeFormat };
+  const effectiveWeekdayFormat = { ...preset.weekdayFormat, ...weekdayFormat };
+  const computedRefreshInterval = refreshInterval ?? (0, import_utils.getRefreshInterval)(effectiveTimeFormat);
   const currentTime = (0, import_hooks.useCurrentTime)({
     refreshInterval: computedRefreshInterval,
     disabled: disableAutoRefresh,
@@ -95,7 +106,10 @@ var PisellDateTimeDisplay = (props) => {
     showDate = true,
     showWeekday = true,
     fieldOrder = ["time", "date", "weekday"]
-  } = fields || {};
+  } = effectiveFields || {};
+  const referenceDate = (0, import_dayjs.default)();
+  const relativeDay = (effectiveDateFormat == null ? void 0 : effectiveDateFormat.showRelativeDay) ? (0, import_utils.getRelativeDay)(currentTime, referenceDate) : null;
+  const hideWeekdayWhenDateRelative = showDate && relativeDay !== null;
   const containerInlineStyle = {
     background: containerStyle == null ? void 0 : containerStyle.background,
     borderRadius: containerStyle == null ? void 0 : containerStyle.borderRadius,
@@ -114,7 +128,7 @@ var PisellDateTimeDisplay = (props) => {
           {
             key: "time",
             time: currentTime,
-            format: timeFormat,
+            format: effectiveTimeFormat,
             style: timeStyle
           }
         ) : null;
@@ -124,17 +138,18 @@ var PisellDateTimeDisplay = (props) => {
           {
             key: "date",
             date: currentTime,
-            format: dateFormat,
+            format: effectiveDateFormat,
+            referenceDate: (0, import_dayjs.default)(),
             style: dateStyle
           }
         ) : null;
       case "weekday":
-        return showWeekday ? /* @__PURE__ */ import_react.default.createElement(
+        return showWeekday && !hideWeekdayWhenDateRelative ? /* @__PURE__ */ import_react.default.createElement(
           import_components.WeekdayDisplay,
           {
             key: "weekday",
             weekday: currentTime,
-            format: weekdayFormat,
+            format: effectiveWeekdayFormat,
             style: weekdayStyle
           }
         ) : null;
@@ -143,6 +158,7 @@ var PisellDateTimeDisplay = (props) => {
     }
   };
   if (layout === "inline") {
+    const inlineSeparators = effectiveFields == null ? void 0 : effectiveFields.inlineSeparators;
     const renderedFields2 = fieldOrder.map(renderField).filter((field) => field !== null);
     if (renderedFields2.length === 0) {
       return null;
@@ -154,7 +170,7 @@ var PisellDateTimeDisplay = (props) => {
         style: containerInlineStyle,
         onClick
       },
-      renderedFields2.map((field, index) => /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, { key: index }, field, index < renderedFields2.length - 1 && /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-datetime-display-separator" }, inlineSeparator)))
+      renderedFields2.map((field, index) => /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, { key: index }, field, index < renderedFields2.length - 1 && /* @__PURE__ */ import_react.default.createElement("span", { className: "pisell-datetime-display-separator" }, (inlineSeparators == null ? void 0 : inlineSeparators[index]) ?? inlineSeparator)))
     );
   }
   const renderedFields = fieldOrder.map(renderField).filter((field) => field !== null);
@@ -166,16 +182,10 @@ var PisellDateTimeDisplay = (props) => {
     const currentLocale = currentTime.locale();
     const isChinese = (0, import_utils.isChinese)(currentLocale);
     if (showDate && showWeekday) {
-      let combinedStr = "";
-      if (isChinese) {
-        const weekdayStr = currentTime.format("ddd");
-        const dateStr = currentTime.format("M月D日");
-        combinedStr = `${weekdayStr} ${dateStr}`;
-      } else {
-        const weekdayStr = currentTime.format("ddd");
-        const dateStr = currentTime.format("D MMM");
-        combinedStr = `${weekdayStr}, ${dateStr}`;
-      }
+      const labels = effectiveDateFormat == null ? void 0 : effectiveDateFormat.relativeDayLabels;
+      const dateStr = relativeDay ? (labels == null ? void 0 : labels[relativeDay]) ?? (0, import_utils.getRelativeDayLabel)(relativeDay, currentTime.locale()) : isChinese ? currentTime.format("M月D日") : currentTime.format("D MMM");
+      const weekdayStr = currentTime.format("ddd");
+      const combinedStr = relativeDay ? dateStr : isChinese ? `${weekdayStr} ${dateStr}` : `${weekdayStr}, ${dateStr}`;
       const dateInlineStyle = {
         fontSize: dateStyle == null ? void 0 : dateStyle.fontSize,
         fontWeight: dateStyle == null ? void 0 : dateStyle.fontWeight,

package/lib/components/pisellDateTimeDisplay/PisellDateTimeDisplay.stories.d.ts

@@ -26,6 +26,11 @@ export declare const InlineLayout: Story;
  * 单行布局 - 自定义分隔符
  */
 export declare const InlineWithCustomSeparator: Story;
+/**
+ * 中文完整日期格式：2025-12-31 - 2:00 周四
+ * 单行、日期在前、日期与时间之间 " - "、时间与星期之间空格
+ */
+export declare const InlineDateTimeWeekdayZh: Story;
 /**
  * 12小时制
  */
@@ -62,6 +67,20 @@ export declare const DateDMY: Story;
  * 中文日期带单位
  */
 export declare const DateChinese: Story;
+/**
+ * 相对日：今天/昨天/明天
+ * 与「当前日期」同天显示「今天」，前一天「昨天」，后一天「明天」；其他日期仍按原格式。
+ * 参考日为 dayjs()，随时间变化：例如 2 月 4 日当天，2 月 4 日显示「今天」，2 月 3 日显示「昨天」。
+ */
+export declare const RelativeDay: Story;
+/**
+ * 相对日 - 英文
+ */
+export declare const RelativeDayEn: Story;
+/**
+ * 相对日 - 自定义文案
+ */
+export declare const RelativeDayCustomLabels: Story;
 /**
  * 英文完整月份
  */

package/lib/components/pisellDateTimeDisplay/PisellDateTimeDisplay.stories.js

@@ -49,6 +49,7 @@ __export(PisellDateTimeDisplay_stories_exports, {
   DateMDY: () => DateMDY,
   DisableRefresh: () => DisableRefresh,
   HorizontalLayout: () => HorizontalLayout,
+  InlineDateTimeWeekdayZh: () => InlineDateTimeWeekdayZh,
   InlineLayout: () => InlineLayout,
   InlineWithCustomSeparator: () => InlineWithCustomSeparator,
   LocaleChinese: () => LocaleChinese,
@@ -56,6 +57,9 @@ __export(PisellDateTimeDisplay_stories_exports, {
   MultiLanguage: () => MultiLanguage,
   OnlyDate: () => OnlyDate,
   OnlyTime: () => OnlyTime,
+  RelativeDay: () => RelativeDay,
+  RelativeDayCustomLabels: () => RelativeDayCustomLabels,
+  RelativeDayEn: () => RelativeDayEn,
   ScenarioDashboard: () => ScenarioDashboard,
   ScenarioLargeScreen: () => ScenarioLargeScreen,
   ScenarioStatusBar: () => ScenarioStatusBar,
@@ -122,6 +126,23 @@ var InlineWithCustomSeparator = {
     inlineSeparator: " | "
   }
 };
+var InlineDateTimeWeekdayZh = {
+  args: {
+    layout: "inline",
+    locale: "zh-cn",
+    fields: {
+      fieldOrder: ["date", "time", "weekday"],
+      inlineSeparators: [" - ", " "]
+    },
+    dateFormat: {
+      order: "YMD",
+      showYear: true,
+      separator: "-",
+      showChineseUnit: false,
+      showRelativeDay: false
+    }
+  }
+};
 var Time12Hour = {
   args: {
     timeFormat: {
@@ -196,6 +217,44 @@ var DateChinese = {
     }
   }
 };
+var RelativeDay = {
+  args: {
+    layout: "horizontal",
+    dateFormat: {
+      showRelativeDay: true,
+      showYear: true,
+      showChineseUnit: true
+    },
+    locale: "zh-cn"
+  }
+};
+var RelativeDayEn = {
+  args: {
+    layout: "horizontal",
+    dateFormat: {
+      showRelativeDay: true,
+      order: "MDY",
+      showYear: true
+    },
+    locale: "en"
+  }
+};
+var RelativeDayCustomLabels = {
+  args: {
+    layout: "horizontal",
+    dateFormat: {
+      showRelativeDay: true,
+      relativeDayLabels: {
+        today: "今日",
+        yesterday: "昨日",
+        tomorrow: "翌日"
+      },
+      showYear: true,
+      showChineseUnit: true
+    },
+    locale: "zh-cn"
+  }
+};
 var DateFullMonth = {
   args: {
     locale: "en",
@@ -758,6 +817,7 @@ var DarkTheme = {
   DateMDY,
   DisableRefresh,
   HorizontalLayout,
+  InlineDateTimeWeekdayZh,
   InlineLayout,
   InlineWithCustomSeparator,
   LocaleChinese,
@@ -765,6 +825,9 @@ var DarkTheme = {
   MultiLanguage,
   OnlyDate,
   OnlyTime,
+  RelativeDay,
+  RelativeDayCustomLabels,
+  RelativeDayEn,
   ScenarioDashboard,
   ScenarioLargeScreen,
   ScenarioStatusBar,

package/lib/components/pisellDateTimeDisplay/components/DateDisplay.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { Dayjs } from 'dayjs';
+import { type Dayjs } from 'dayjs';
 import type { DateFormatConfig, TextStyleConfig } from '../types';
 /**
  * DateDisplay 组件 Props
@@ -13,6 +13,10 @@ export interface DateDisplayProps {
      * 日期格式配置
      */
     format?: DateFormatConfig;
+    /**
+     * 参考日期（用于「今天/昨天/明天」判定，默认当前时间 dayjs()）
+     */
+    referenceDate?: Dayjs;
     /**
      * 文本样式
      */
@@ -27,6 +31,7 @@ export interface DateDisplayProps {
  *
  * @description
  * - 格式化并展示日期
+ * - 支持 showRelativeDay：今天/昨天/明天时用相对日替换原日期展示，不展示具体日期
  * - 支持不同的日期顺序（YMD/MDY/DMY）
  * - 支持年月日字段显隐
  * - 支持中文单位（年、月、日）

package/lib/components/pisellDateTimeDisplay/components/DateDisplay.js

@@ -34,14 +34,18 @@ __export(DateDisplay_exports, {
 });
 module.exports = __toCommonJS(DateDisplay_exports);
 var import_react = __toESM(require("react"));
+var import_dayjs = __toESM(require("dayjs"));
 var import_utils = require("../utils");
 var DateDisplay = ({
   date,
   format,
+  referenceDate = (0, import_dayjs.default)(),
   style,
   className
 }) => {
-  const formattedDate = (0, import_utils.formatDate)(date, format);
+  const labels = format == null ? void 0 : format.relativeDayLabels;
+  const relativeDay = (format == null ? void 0 : format.showRelativeDay) ? (0, import_utils.getRelativeDay)(date, referenceDate) : null;
+  const formattedDate = relativeDay ? (labels == null ? void 0 : labels[relativeDay]) ?? (0, import_utils.getRelativeDayLabel)(relativeDay, date.locale()) : (0, import_utils.formatDate)(date, format);
   if (!formattedDate) {
     return null;
   }

package/lib/components/pisellDateTimeDisplay/formats/dateTimeDisplayFormats.d.ts

@@ -0,0 +1,7 @@
+import type { DateTimeDisplayFormatPreset } from '../types';
+/**
+ * PisellDateTimeDisplay 按语言预设的格式
+ * - zh-cn：完整日期 - 时间 星期（如 2025-12-31 - 2:00 周四）、相对日今天/昨天/明天
+ * - en：时间 星期, 日期（如 2:00 Sat, 21 Mar, 2026）、相对日 Today/Yesterday/Tomorrow
+ */
+export declare const DATETIME_DISPLAY_FORMATS: Record<string, Partial<DateTimeDisplayFormatPreset>>;