@pisell/materials 6.3.25 → 6.3.27

package/es/components/pisellCurrency/components/EditView.js

@@ -0,0 +1,127 @@
+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 React, { useMemo } from 'react';
+import { InputNumber } from 'antd';
+import { useNumberInputState } from '@pisell/utils';
+/**
+ * PisellCurrency 编辑态视图组件
+ * 
+ * 负责渲染编辑态的输入框，基于 Ant Design InputNumber 组件
+ * 
+ * 功能：
+ * - 货币数值输入
+ * - 货币符号显示（prefix 或 addonAfter）
+ * - 负数校验
+ * - 实时或失焦校验
+ * - 错误提示展示
+ * 
+ * @param props 组件 Props
+ */
+var EditView = function EditView(props) {
+  var _props$currencySymbol = props.currencySymbol,
+    currencySymbol = _props$currencySymbol === void 0 ? '¥' : _props$currencySymbol,
+    _props$symbolPosition = props.symbolPosition,
+    symbolPosition = _props$symbolPosition === void 0 ? 'before' : _props$symbolPosition,
+    _props$showSymbol = props.showSymbol,
+    showSymbol = _props$showSymbol === void 0 ? true : _props$showSymbol,
+    _props$allowNegative = props.allowNegative,
+    allowNegative = _props$allowNegative === void 0 ? true : _props$allowNegative,
+    _props$precision = props.precision,
+    precision = _props$precision === void 0 ? 2 : _props$precision,
+    _props$useGrouping = props.useGrouping,
+    useGrouping = _props$useGrouping === void 0 ? true : _props$useGrouping,
+    min = props.min,
+    max = props.max,
+    step = props.step,
+    _props$placeholder = props.placeholder,
+    placeholder = _props$placeholder === void 0 ? '请输入金额' : _props$placeholder,
+    disabled = props.disabled,
+    autoFocus = props.autoFocus,
+    size = props.size,
+    keyboard = props.keyboard,
+    controls = props.controls,
+    className = props.className,
+    style = props.style,
+    ariaLabel = props['aria-label'],
+    ariaDescribedBy = props['aria-describedby'],
+    id = props.id,
+    name = props.name,
+    _onPressEnter = props.onPressEnter;
+
+  // 扩展校验逻辑：负数校验
+  var enhancedValidator = useMemo(function () {
+    return function (value) {
+      // 负数校验
+      if (!allowNegative && value !== null && value < 0) {
+        return '金额不能为负数';
+      }
+
+      // 调用原始校验函数
+      if (props.validator) {
+        return props.validator(value);
+      }
+      return true;
+    };
+  }, [allowNegative, props.validator]);
+
+  // 计算 min（考虑 allowNegative）
+  var computedMin = useMemo(function () {
+    if (min !== undefined) return min;
+    if (!allowNegative) return 0;
+    return undefined;
+  }, [min, allowNegative]);
+
+  // 使用状态管理 hook
+  var _useNumberInputState = useNumberInputState(_objectSpread(_objectSpread({}, props), {}, {
+      validator: enhancedValidator,
+      min: computedMin,
+      max: max,
+      precision: precision
+    })),
+    value = _useNumberInputState.value,
+    isValid = _useNumberInputState.isValid,
+    errors = _useNumberInputState.errors,
+    handleChange = _useNumberInputState.handleChange,
+    handleBlur = _useNumberInputState.handleBlur,
+    handleFocus = _useNumberInputState.handleFocus;
+
+  // 货币符号显示在 prefix（前置）或 addonAfter（后置）
+  var prefixNode = showSymbol && symbolPosition === 'before' ? currencySymbol : undefined;
+  var addonAfterNode = showSymbol && symbolPosition === 'after' ? currencySymbol : undefined;
+  return /*#__PURE__*/React.createElement("div", {
+    className: "pisell-currency pisell-currency-edit ".concat(className || '')
+  }, /*#__PURE__*/React.createElement(InputNumber, {
+    value: value !== null && value !== void 0 ? value : undefined,
+    onChange: handleChange,
+    onBlur: handleBlur,
+    onFocus: handleFocus,
+    onPressEnter: function onPressEnter() {
+      return _onPressEnter === null || _onPressEnter === void 0 ? void 0 : _onPressEnter(value !== null && value !== void 0 ? value : null);
+    },
+    min: computedMin,
+    max: max,
+    step: step,
+    precision: precision,
+    prefix: prefixNode,
+    addonAfter: addonAfterNode,
+    placeholder: placeholder,
+    disabled: disabled,
+    autoFocus: autoFocus,
+    size: size,
+    keyboard: keyboard,
+    controls: controls,
+    status: isValid ? undefined : 'error',
+    style: style,
+    "aria-label": ariaLabel,
+    "aria-describedby": ariaDescribedBy,
+    id: id,
+    name: name
+  }), !isValid && errors.length > 0 && /*#__PURE__*/React.createElement("div", {
+    className: "pisell-currency-error"
+  }, errors[0]));
+};
+export default EditView;

package/es/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/es/components/pisellCurrency/components/ReadOnlyView.js

@@ -0,0 +1,70 @@
+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 React from 'react';
+import { formatCurrency } from "../utils/currencyFormatter";
+/**
+ * PisellCurrency 只读态视图组件
+ * 
+ * 负责渲染只读态的纯文本展示
+ * 
+ * 功能：
+ * - 格式化货币数值并展示
+ * - 添加货币符号（无空格）
+ * - 支持自定义字体样式
+ * - 处理空值显示
+ * 
+ * @param props 组件 Props
+ */
+var ReadOnlyView = function ReadOnlyView(props) {
+  var value = props.value,
+    _props$currencySymbol = props.currencySymbol,
+    currencySymbol = _props$currencySymbol === void 0 ? '¥' : _props$currencySymbol,
+    _props$symbolPosition = props.symbolPosition,
+    symbolPosition = _props$symbolPosition === void 0 ? 'before' : _props$symbolPosition,
+    _props$showSymbol = props.showSymbol,
+    showSymbol = _props$showSymbol === void 0 ? true : _props$showSymbol,
+    _props$precision = props.precision,
+    precision = _props$precision === void 0 ? 2 : _props$precision,
+    _props$useGrouping = props.useGrouping,
+    useGrouping = _props$useGrouping === void 0 ? true : _props$useGrouping,
+    _props$emptyText = props.emptyText,
+    emptyText = _props$emptyText === void 0 ? '-' : _props$emptyText,
+    fontSize = props.fontSize,
+    fontWeight = props.fontWeight,
+    color = props.color,
+    _props$textAlign = props.textAlign,
+    textAlign = _props$textAlign === void 0 ? 'left' : _props$textAlign,
+    className = props.className,
+    style = props.style,
+    ariaLabel = props['aria-label'];
+
+  // 格式化货币
+  var displayValue = formatCurrency(value, {
+    currencySymbol: currencySymbol,
+    symbolPosition: symbolPosition,
+    showSymbol: showSymbol,
+    precision: precision,
+    useGrouping: useGrouping
+  });
+
+  // 处理空值
+  var text = displayValue !== null && displayValue !== void 0 ? displayValue : emptyText;
+
+  // 组合样式
+  var combinedStyle = _objectSpread({
+    fontSize: fontSize,
+    fontWeight: fontWeight,
+    color: color,
+    textAlign: textAlign
+  }, style);
+  return /*#__PURE__*/React.createElement("span", {
+    className: "pisell-currency pisell-currency-read ".concat(className || ''),
+    style: combinedStyle,
+    "aria-label": ariaLabel
+  }, text);
+};
+export default ReadOnlyView;

package/es/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/es/components/pisellCurrency/components/index.js

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

package/es/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/es/components/pisellCurrency/index.js

@@ -0,0 +1,7 @@
+/**
+ * PisellCurrency 组件导出
+ */
+
+export { default as PisellCurrency } from "./PisellCurrency";
+
+// 公共类型从 types 中重新导出，方便使用

package/es/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/es/components/pisellCurrency/types.js

@@ -0,0 +1 @@
+export {};

package/es/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/es/components/pisellCurrency/utils/currencyFormatter.js

@@ -0,0 +1,50 @@
+import { formatNumber } from '@pisell/utils';
+
+/**
+ * 货币格式化选项
+ */
+
+/**
+ * 格式化货币数值
+ * 
+ * @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 function formatCurrency(value, options) {
+  if (value === null || value === undefined) {
+    return null;
+  }
+  var currencySymbol = options.currencySymbol,
+    symbolPosition = options.symbolPosition,
+    showSymbol = options.showSymbol,
+    precision = options.precision,
+    useGrouping = options.useGrouping;
+
+  // 1. 基础数值格式化（千分位 + 精度）
+  var formatted = formatNumber(value, {
+    precision: precision,
+    useGrouping: useGrouping
+  });
+  if (!formatted) {
+    return null;
+  }
+
+  // 2. 添加货币符号（符号与数值之间无空格）
+  if (!showSymbol) {
+    return formatted;
+  }
+  if (symbolPosition === 'before') {
+    return "".concat(currencySymbol).concat(formatted);
+  } else {
+    return "".concat(formatted).concat(currencySymbol);
+  }
+}

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

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

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

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

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

@@ -0,0 +1,35 @@
+import React from 'react';
+import 'dayjs/locale/zh-cn';
+import 'dayjs/locale/en';
+import type { PisellDateTimeDisplayProps } from './types';
+import './PisellDateTimeDisplay.less';
+/**
+ * PisellDateTimeDisplay 组件
+ *
+ * @description
+ * 专注于展示当前时间的组件，支持：
+ * - 当前日期、时间、星期展示
+ * - 多种布局方式（水平、垂直、单行）
+ * - 丰富的格式化配置
+ * - 自动刷新
+ * - 国际化支持
+ *
+ * @example
+ * // 基础用法
+ * <PisellDateTimeDisplay />
+ *
+ * // 自定义格式
+ * <PisellDateTimeDisplay
+ *   layout="vertical"
+ *   timeFormat={{ use12Hour: true, showSeconds: true }}
+ *   dateFormat={{ showYear: true, showChineseUnit: true }}
+ * />
+ *
+ * // 自定义格式化字符串
+ * <PisellDateTimeDisplay
+ *   customFormat="YYYY-MM-DD HH:mm:ss"
+ * />
+ */
+export declare const PisellDateTimeDisplay: React.FC<PisellDateTimeDisplayProps>;
+declare const _default: React.NamedExoticComponent<PisellDateTimeDisplayProps>;
+export default _default;