@pisell/utils 3.0.5 → 3.0.7

package/es/arrayUtils.d.ts

@@ -1 +1,73 @@
 export declare const uniqueByKey: <T>(arr: T[], key: keyof T) => T[];
+/**
+ * 分组键的基础类型
+ * @description 分组条件计算后得到的标量值
+ */
+export declare type GroupKey = string | number | boolean;
+/**
+ * 分组规则
+ * @template T - 数据项类型
+ * @description
+ * - `string`：单字段路径，支持 `'a.b.c'` 点路径
+ * - `string[]`：多字段组合，按顺序拼接为组合键
+ * - `(item, index) => GroupKey | GroupKey[]`：完全自定义分组键
+ */
+export declare type GroupBySpec<T> = string | string[] | ((item: T, index: number) => GroupKey | GroupKey[]);
+/**
+ * 单个分组的结果模型
+ * @template T - 数据项类型
+ */
+export interface GroupResult<T> {
+    /** 分组唯一标识（默认由各分组键以 `|` 拼接） */
+    groupId: string;
+    /** 分组键值数组，与 `GroupBySpec` 顺序对应 */
+    keys: GroupKey[];
+    /** 字段名 -> 键值映射，便于头部直接按字段名取值（自定义函数分组时为空对象） */
+    keyMap: Record<string, GroupKey>;
+    /** 该分组内的原始数据项（保持原数组中的相对顺序） */
+    items: T[];
+    /** 分组的最终顺序下标 */
+    index: number;
+}
+/**
+ * 分组可选项
+ * @template T - 数据项类型
+ */
+export interface GroupByOptions<T> {
+    /** 自定义分组 id 生成（默认 `keys.join('|')`） */
+    getGroupId?: (keys: GroupKey[]) => string;
+    /** 分组之间的排序；不传则保持各分组首次出现的顺序 */
+    sortGroups?: (a: GroupResult<T>, b: GroupResult<T>) => number;
+    /** 分组内数据项的排序；不传则保持原始相对顺序 */
+    sortItems?: (a: T, b: T) => number;
+}
+/**
+ * 按点路径安全取值
+ * @param obj - 取值对象
+ * @param path - 字段路径，支持 `'a.b.c'`
+ * @returns 路径对应的值，路径不存在时返回 undefined
+ * @example
+ * getByPath({ a: { b: 1 } }, 'a.b') // 1
+ * getByPath({ id: 9 }, 'id') // 9
+ */
+export declare const getByPath: (obj: unknown, path: string) => unknown;
+/**
+ * 将数组按指定条件分组
+ * @template T - 数据项类型
+ * @param dataSource - 待分组的数据数组
+ * @param spec - 分组规则，详见 {@link GroupBySpec}
+ * @param options - 可选项（自定义 groupId、分组/组内排序）
+ * @returns 分组结果数组，默认保持各分组首次出现的顺序、组内保持原始相对顺序
+ * @description
+ * 该函数为纯函数，不修改入参（排序时对内部拷贝操作）。相同分组键的数据会被归入同一分组。
+ * @example
+ * // 单字段
+ * groupBy(list, 'productId');
+ * @example
+ * // 商品 + 时间组合
+ * groupBy(list, ['productId', 'time']);
+ * @example
+ * // 自定义键
+ * groupBy(list, (item) => `${item.productId}_${item.time}`);
+ */
+export declare const groupBy: <T>(dataSource: T[], spec: GroupBySpec<T>, options?: GroupByOptions<T>) => GroupResult<T>[];

package/es/arrayUtils.js

@@ -8,11 +8,11 @@ export var uniqueByKey = function uniqueByKey(arr, key) {
     _step;
   try {
     for (_iterator.s(); !(_step = _iterator.n()).done;) {
-      var item = _step.value;
-      var keyValue = item[key];
+      var _item = _step.value;
+      var keyValue = _item[key];
       if (!seen.has(keyValue)) {
         seen.add(keyValue);
-        result.push(item);
+        result.push(_item);
       }
     }
   } catch (err) {
@@ -21,4 +21,143 @@ export var uniqueByKey = function uniqueByKey(arr, key) {
     _iterator.f();
   }
   return result;
+};
+
+/**
+ * 分组键的基础类型
+ * @description 分组条件计算后得到的标量值
+ */
+
+/**
+ * 分组规则
+ * @template T - 数据项类型
+ * @description
+ * - `string`：单字段路径，支持 `'a.b.c'` 点路径
+ * - `string[]`：多字段组合，按顺序拼接为组合键
+ * - `(item, index) => GroupKey | GroupKey[]`：完全自定义分组键
+ */
+
+/**
+ * 单个分组的结果模型
+ * @template T - 数据项类型
+ */
+
+/**
+ * 分组可选项
+ * @template T - 数据项类型
+ */
+
+/**
+ * 按点路径安全取值
+ * @param obj - 取值对象
+ * @param path - 字段路径，支持 `'a.b.c'`
+ * @returns 路径对应的值，路径不存在时返回 undefined
+ * @example
+ * getByPath({ a: { b: 1 } }, 'a.b') // 1
+ * getByPath({ id: 9 }, 'id') // 9
+ */
+export var getByPath = function getByPath(obj, path) {
+  if (obj === null || obj === undefined) {
+    return undefined;
+  }
+  if (path.indexOf('.') === -1) {
+    return obj[path];
+  }
+  return path.split('.').reduce(function (acc, key) {
+    if (acc === null || acc === undefined) {
+      return undefined;
+    }
+    return acc[key];
+  }, obj);
+};
+
+/**
+ * 将任意值规范化为可用于分组的标量键
+ * @description null/undefined 统一归一为空字符串，对象/数组等转为字符串，避免分组键不稳定
+ */
+var normalizeGroupKey = function normalizeGroupKey(value) {
+  if (value === null || value === undefined) {
+    return '';
+  }
+  if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+    return value;
+  }
+  return String(value);
+};
+
+/**
+ * 将数组按指定条件分组
+ * @template T - 数据项类型
+ * @param dataSource - 待分组的数据数组
+ * @param spec - 分组规则，详见 {@link GroupBySpec}
+ * @param options - 可选项（自定义 groupId、分组/组内排序）
+ * @returns 分组结果数组，默认保持各分组首次出现的顺序、组内保持原始相对顺序
+ * @description
+ * 该函数为纯函数，不修改入参（排序时对内部拷贝操作）。相同分组键的数据会被归入同一分组。
+ * @example
+ * // 单字段
+ * groupBy(list, 'productId');
+ * @example
+ * // 商品 + 时间组合
+ * groupBy(list, ['productId', 'time']);
+ * @example
+ * // 自定义键
+ * groupBy(list, (item) => `${item.productId}_${item.time}`);
+ */
+export var groupBy = function groupBy(dataSource, spec) {
+  var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  var getGroupId = options.getGroupId,
+    sortGroups = options.sortGroups,
+    sortItems = options.sortItems;
+
+  // 仅字段型分组才有可读字段名，用于 keyMap
+  var fieldNames = Array.isArray(spec) ? spec : typeof spec === 'string' ? [spec] : [];
+  var groupMap = new Map();
+  var order = [];
+  (dataSource || []).forEach(function (item, index) {
+    var keys;
+    if (typeof spec === 'function') {
+      var result = spec(item, index);
+      keys = (Array.isArray(result) ? result : [result]).map(normalizeGroupKey);
+    } else if (Array.isArray(spec)) {
+      keys = spec.map(function (field) {
+        return normalizeGroupKey(getByPath(item, field));
+      });
+    } else {
+      keys = [normalizeGroupKey(getByPath(item, spec))];
+    }
+    var groupId = getGroupId ? getGroupId(keys) : keys.join('|');
+    var group = groupMap.get(groupId);
+    if (!group) {
+      var keyMap = {};
+      fieldNames.forEach(function (field, i) {
+        keyMap[field] = keys[i];
+      });
+      group = {
+        groupId: groupId,
+        keys: keys,
+        keyMap: keyMap,
+        items: [],
+        index: order.length
+      };
+      groupMap.set(groupId, group);
+      order.push(groupId);
+    }
+    group.items.push(item);
+  });
+  var groups = order.map(function (id) {
+    return groupMap.get(id);
+  });
+  if (sortItems) {
+    groups.forEach(function (group) {
+      group.items.sort(sortItems);
+    });
+  }
+  if (sortGroups) {
+    groups = groups.slice().sort(sortGroups);
+    groups.forEach(function (group, i) {
+      group.index = i;
+    });
+  }
+  return groups;
 };

package/es/common/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 公共工具和类型导出
+ */
+export type { DisplayState, ValidationResult } from './types';
+export { getDisplayState } from './stateHelper';

package/es/common/index.js

@@ -0,0 +1,5 @@
+/**
+ * 公共工具和类型导出
+ */
+
+export { getDisplayState } from "./stateHelper";

package/es/common/stateHelper.d.ts

@@ -0,0 +1,18 @@
+import type { DisplayState } from './types';
+/**
+ * 根据 mode 和 disabled 计算组件的显示状态
+ *
+ * 状态优先级：disabled > mode
+ * 当 disabled=true 时，无论 mode 是什么，都显示为禁用态
+ *
+ * @param mode 状态模式（'read' | 'edit'）
+ * @param disabled 是否禁用
+ * @returns 显示状态（'read' | 'edit' | 'disabled'）
+ *
+ * @example
+ * getDisplayState('edit', false) // 'edit'
+ * getDisplayState('read', false) // 'read'
+ * getDisplayState('edit', true)  // 'disabled'
+ * getDisplayState('read', true)  // 'disabled'
+ */
+export declare function getDisplayState(mode?: 'read' | 'edit', disabled?: boolean): DisplayState;

package/es/common/stateHelper.js

@@ -0,0 +1,25 @@
+/**
+ * 根据 mode 和 disabled 计算组件的显示状态
+ * 
+ * 状态优先级：disabled > mode
+ * 当 disabled=true 时，无论 mode 是什么，都显示为禁用态
+ * 
+ * @param mode 状态模式（'read' | 'edit'）
+ * @param disabled 是否禁用
+ * @returns 显示状态（'read' | 'edit' | 'disabled'）
+ * 
+ * @example
+ * getDisplayState('edit', false) // 'edit'
+ * getDisplayState('read', false) // 'read'
+ * getDisplayState('edit', true)  // 'disabled'
+ * getDisplayState('read', true)  // 'disabled'
+ */
+export function getDisplayState(mode, disabled) {
+  // disabled 优先级最高
+  if (disabled) {
+    return 'disabled';
+  }
+
+  // 返回基础模式，默认为 edit
+  return mode || 'edit';
+}

package/es/common/types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 公共类型定义
+ * 供所有输入组件使用
+ */
+/**
+ * 显示状态类型
+ *
+ * 所有输入组件的三种状态：
+ * - read: 只读态，纯文本展示
+ * - edit: 编辑态，显示输入控件
+ * - disabled: 禁用态，禁用的输入控件
+ */
+export declare type DisplayState = 'read' | 'edit' | 'disabled';
+/**
+ * 校验结果类型
+ *
+ * 所有输入组件的校验结果统一格式
+ */
+export interface ValidationResult {
+    /**
+     * 是否校验通过
+     */
+    isValid: boolean;
+    /**
+     * 错误信息数组
+     */
+    errors: string[];
+}

package/es/common/types.js

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

package/es/componentStorage.d.ts

@@ -0,0 +1,36 @@
+/** 生成存储 key 的路径后缀：pathname 或 pathname#memory_key（来自 URL memory_key 参数） */
+export declare function getStorageKeySuffix(): string;
+/**
+ * 生成组件实例的存储 key。
+ * @param componentId 组件实例 id（如 __id）
+ * @param prefix 前缀，如 'table-setting'、'record-board-column-visibility'
+ */
+export declare function getComponentStorageKey(componentId: string, prefix: string): string;
+export interface ColumnSettingStorageItem {
+    key: string;
+    dataIndex: string;
+    title?: unknown;
+    titleString?: string;
+    isShow: boolean;
+    sortIndex?: number;
+    fixed?: 'left' | 'right' | boolean;
+}
+export declare function saveColumnSettingToLocal(params: {
+    componentId: string;
+    columnSetting: ColumnSettingStorageItem[];
+}): void;
+export declare function getColumnSettingFromLocal(componentId?: string): ColumnSettingStorageItem[] | null;
+export declare function clearColumnSettingFromLocal(componentId?: string): void;
+export declare function saveColumnVisibilityToLocal(params: {
+    componentId: string;
+    columnVisibility: Record<string, boolean>;
+    /** 列 key 顺序，用于列设置弹层拖拽排序后持久化 */
+    columnOrder?: string[];
+}): void;
+export declare function getColumnVisibilityFromLocal(componentId?: string): Record<string, boolean> | null;
+/** RecordBoard 列设置（显隐 + 顺序）从 localStorage 读取，用于列设置弹层拖拽排序与显隐持久化 */
+export declare function getRecordBoardColumnSettingFromLocal(componentId?: string): {
+    columnVisibility: Record<string, boolean>;
+    columnOrder: string[] | null;
+} | null;
+export declare function clearColumnVisibilityFromLocal(componentId?: string): void;

package/es/componentStorage.js

@@ -0,0 +1,142 @@
+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); }
+/**
+ * 组件级 localStorage 存储：列设置、列显隐等。
+ * 供 pisellDataSourceContainer、pisellRecordBoard 等复用，key 含 pathname 与 memory_key 以区分页面。
+ */
+import { isJson } from "./typeUtils";
+
+/** 生成存储 key 的路径后缀：pathname 或 pathname#memory_key（来自 URL memory_key 参数） */
+export function getStorageKeySuffix() {
+  if (typeof window === 'undefined' || typeof window.location === 'undefined') {
+    return '/';
+  }
+  var _window$location = window.location,
+    pathname = _window$location.pathname,
+    search = _window$location.search;
+  var appendPath = pathname || '/';
+  var memoryKey = '';
+  try {
+    var params = new URLSearchParams(search || '');
+    var mk = params.get('memory_key');
+    if (mk && mk.trim() !== '') memoryKey = mk.trim();
+  } catch (_unused) {
+    // ignore
+  }
+  return memoryKey ? "".concat(appendPath, "#").concat(memoryKey) : appendPath;
+}
+
+/**
+ * 生成组件实例的存储 key。
+ * @param componentId 组件实例 id（如 __id）
+ * @param prefix 前缀，如 'table-setting'、'record-board-column-visibility'
+ */
+export function getComponentStorageKey(componentId, prefix) {
+  if (typeof window === 'undefined' || typeof window.location === 'undefined') {
+    return "".concat(prefix, "-").concat(componentId);
+  }
+  var suffix = getStorageKeySuffix();
+  return "".concat(prefix, "-").concat(componentId, "-").concat(suffix);
+}
+
+// ---------- 列设置（DataSourceContainer Table 列显隐+排序等，数组格式） ----------
+
+export function saveColumnSettingToLocal(params) {
+  var componentId = params.componentId,
+    columnSetting = params.columnSetting;
+  if (!componentId) return;
+  if (typeof window === 'undefined' || !window.localStorage) return;
+  var storageKey = getComponentStorageKey(componentId, 'table-setting');
+  var data = {
+    column_setting: columnSetting,
+    updatedAt: Date.now()
+  };
+  try {
+    window.localStorage.setItem(storageKey, JSON.stringify(data));
+  } catch (_unused2) {
+    // ignore
+  }
+}
+export function getColumnSettingFromLocal(componentId) {
+  if (!componentId) return null;
+  if (typeof window === 'undefined' || !window.localStorage) return null;
+  var storageKey = getComponentStorageKey(componentId, 'table-setting');
+  var raw = window.localStorage.getItem(storageKey);
+  if (raw && isJson(raw)) {
+    var data = JSON.parse(raw);
+    var arr = data === null || data === void 0 ? void 0 : data.column_setting;
+    return Array.isArray(arr) ? arr : null;
+  }
+  return null;
+}
+export function clearColumnSettingFromLocal(componentId) {
+  if (!componentId) return;
+  if (typeof window === 'undefined' || !window.localStorage) return;
+  var storageKey = getComponentStorageKey(componentId, 'table-setting');
+  window.localStorage.removeItem(storageKey);
+}
+
+// ---------- 列显隐（RecordBoard，Record<列 key, boolean> 格式） ----------
+
+var RECORD_BOARD_VISIBILITY_PREFIX = 'record-board-column-visibility';
+export function saveColumnVisibilityToLocal(params) {
+  var componentId = params.componentId,
+    columnVisibility = params.columnVisibility,
+    columnOrder = params.columnOrder;
+  if (!componentId) return;
+  if (typeof window === 'undefined' || !window.localStorage) return;
+  var storageKey = getComponentStorageKey(componentId, RECORD_BOARD_VISIBILITY_PREFIX);
+  var data = _objectSpread(_objectSpread({
+    column_visibility: columnVisibility
+  }, columnOrder != null && {
+    column_order: columnOrder
+  }), {}, {
+    updatedAt: Date.now()
+  });
+  try {
+    window.localStorage.setItem(storageKey, JSON.stringify(data));
+  } catch (_unused3) {
+    // ignore
+  }
+}
+export function getColumnVisibilityFromLocal(componentId) {
+  if (!componentId) return null;
+  if (typeof window === 'undefined' || !window.localStorage) return null;
+  var storageKey = getComponentStorageKey(componentId, RECORD_BOARD_VISIBILITY_PREFIX);
+  var raw = window.localStorage.getItem(storageKey);
+  if (raw && isJson(raw)) {
+    var data = JSON.parse(raw);
+    var vis = data === null || data === void 0 ? void 0 : data.column_visibility;
+    return vis && _typeof(vis) === 'object' && vis !== null ? vis : null;
+  }
+  return null;
+}
+
+/** RecordBoard 列设置（显隐 + 顺序）从 localStorage 读取，用于列设置弹层拖拽排序与显隐持久化 */
+export function getRecordBoardColumnSettingFromLocal(componentId) {
+  if (!componentId) return null;
+  if (typeof window === 'undefined' || !window.localStorage) return null;
+  var storageKey = getComponentStorageKey(componentId, RECORD_BOARD_VISIBILITY_PREFIX);
+  var raw = window.localStorage.getItem(storageKey);
+  if (raw && isJson(raw)) {
+    var data = JSON.parse(raw);
+    var vis = data === null || data === void 0 ? void 0 : data.column_visibility;
+    var columnVisibility = vis && _typeof(vis) === 'object' && vis !== null ? vis : {};
+    var columnOrder = Array.isArray(data === null || data === void 0 ? void 0 : data.column_order) ? data.column_order : null;
+    return {
+      columnVisibility: columnVisibility,
+      columnOrder: columnOrder
+    };
+  }
+  return null;
+}
+export function clearColumnVisibilityFromLocal(componentId) {
+  if (!componentId) return;
+  if (typeof window === 'undefined' || !window.localStorage) return;
+  var storageKey = getComponentStorageKey(componentId, RECORD_BOARD_VISIBILITY_PREFIX);
+  window.localStorage.removeItem(storageKey);
+}

package/es/format.d.ts

@@ -18,6 +18,10 @@ export declare type FormatOptions = {
     useThousandsSeparator?: boolean;
     /** 整数位隐藏小数 指的是如果价格为整数，后面的".00" 将被省略以节省页面空间 */
     hideDecimalForWholeNumbers?: boolean;
+    /** 货币代码或虚拟币单位后缀 */
+    currencyCode?: string;
+    /** 货币展示格式，支持预置值和金额模板 */
+    currencyFormat?: string;
 };
 /**
  * 根据配置格式化金额
@@ -25,4 +29,4 @@ export declare type FormatOptions = {
  * @param symbol
  * @param options
  */
-export declare const formatAmountWithOptions: (amount: string | number | undefined, symbol: string | undefined, options: FormatOptions) => string | number;
+export declare const formatAmountWithOptions: (amount?: number | string, symbol?: string, options?: FormatOptions) => string | number;

package/es/format.js

@@ -53,6 +53,24 @@ export var formatAmount = function formatAmount() {
     return amount;
   }
 };
+var applyCurrencyFormat = function applyCurrencyFormat(params) {
+  var amount = params.amount,
+    symbol = params.symbol,
+    currencyCode = params.currencyCode,
+    currencyFormat = params.currencyFormat;
+  var format = currencyFormat.trim();
+  if (format.includes('{{amount}}') || format.includes('{amount}')) {
+    return format.split('{{amount}}').join(amount).split('{{sym}}').join(symbol).split('{{unit}}').join(currencyCode).split('{{symbol}}').join(symbol).split('{{unit_label}}').join(currencyCode).split('{{currency_code}}').join(currencyCode).split('{amount}').join(amount).split('{sym}').join(symbol).split('{unit}').join(currencyCode).split('{symbol}').join(symbol).split('{unit_label}').join(currencyCode).split('{currency_code}').join(currencyCode).trim();
+  }
+  if (format === 'symbol_last') {
+    if (symbol) return "".concat(amount).concat(symbol);
+    if (currencyCode) return "".concat(amount, " ").concat(currencyCode);
+    return amount;
+  }
+  if (symbol) return "".concat(symbol).concat(amount);
+  return currencyCode ? "".concat(amount, " ").concat(currencyCode) : amount;
+};
+
 /**
  * 根据配置格式化金额
  * @param amount
@@ -62,7 +80,7 @@ export var formatAmount = function formatAmount() {
 export var formatAmountWithOptions = function formatAmountWithOptions() {
   var amount = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 0;
   var symbol = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
-  var options = arguments.length > 2 ? arguments[2] : undefined;
+  var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
   var _options$precision = options.precision,
     precision = _options$precision === void 0 ? 2 : _options$precision,
     _options$useThousands = options.useThousandsSeparator,
@@ -70,7 +88,11 @@ export var formatAmountWithOptions = function formatAmountWithOptions() {
     _options$showCurrency = options.showCurrencySymbol,
     showCurrencySymbol = _options$showCurrency === void 0 ? true : _options$showCurrency,
     _options$hideDecimalF = options.hideDecimalForWholeNumbers,
-    hideDecimalForWholeNumbers = _options$hideDecimalF === void 0 ? true : _options$hideDecimalF;
+    hideDecimalForWholeNumbers = _options$hideDecimalF === void 0 ? true : _options$hideDecimalF,
+    _options$currencyCode = options.currencyCode,
+    currencyCode = _options$currencyCode === void 0 ? '' : _options$currencyCode,
+    _options$currencyForm = options.currencyFormat,
+    currencyFormat = _options$currencyForm === void 0 ? '' : _options$currencyForm;
   // 校验格式
   if (!isString(amount) && !isNumber(amount)) {
     console.error('amount is not a number');
@@ -86,22 +108,45 @@ export var formatAmountWithOptions = function formatAmountWithOptions() {
     // 截取小数部分并补零
     var decimalPart = (absoluteAmount - integerPart).toFixed(precision).substring(2);
 
+    // 新配置缺省时完整保留历史逻辑，避免影响现有调用方。
+    if (!currencyCode && !currencyFormat) {
+      var legacyFormattedAmount = useThousandsSeparator ? integerPart.toLocaleString() : integerPart.toString();
+      legacyFormattedAmount = showCurrencySymbol ? symbol + legacyFormattedAmount : legacyFormattedAmount;
+      if (precision > 0) {
+        legacyFormattedAmount += '.' + decimalPart;
+        if (hideDecimalForWholeNumbers && legacyFormattedAmount.indexOf('.00') !== -1) {
+          legacyFormattedAmount = legacyFormattedAmount.substring(0, legacyFormattedAmount.length - 3);
+        }
+      }
+      if (roundedAmount < 0) {
+        legacyFormattedAmount = '-' + legacyFormattedAmount;
+      }
+      return legacyFormattedAmount;
+    }
+
     // 增加千分位分隔符
     var formattedAmount = useThousandsSeparator ? integerPart.toLocaleString() : integerPart.toString();
 
-    // 拼接货币符号
-    formattedAmount = showCurrencySymbol ? symbol + formattedAmount : formattedAmount;
-
     // 添加小数点
     if (precision > 0) {
       formattedAmount += '.' + decimalPart;
 
-      // 如果小数位是 .00的话  抹去
-      if (hideDecimalForWholeNumbers && formattedAmount.indexOf('.00') !== -1) {
-        formattedAmount = formattedAmount.substring(0, formattedAmount.length - 3);
+      // 整数按配置隐藏全部小数位
+      if (hideDecimalForWholeNumbers && Number(decimalPart) === 0) {
+        formattedAmount = formattedAmount.substring(0, formattedAmount.length - precision - 1);
       }
     }
 
+    // 数值精度与币种排版分开处理，便于共享法币和虚拟币规则
+    if (showCurrencySymbol) {
+      formattedAmount = applyCurrencyFormat({
+        amount: formattedAmount,
+        symbol: symbol,
+        currencyCode: currencyCode,
+        currencyFormat: currencyFormat
+      });
+    }
+
     // 添加负号
     if (roundedAmount < 0) {
       formattedAmount = '-' + formattedAmount;

package/es/index.d.ts

@@ -1,5 +1,6 @@
 export * from './otherUtils';
 export * from './typeUtils';
+export * from './componentStorage';
 export * from './document';
 export * from './date';
 export * from './platform';
@@ -12,6 +13,11 @@ export * from './image';
 export * from './locales';
 export * from './arrayUtils';
 export * from './walletValidity';
+export * from './weighing';
+export * from './common';
+export * from './text-input';
+export * from './number-input';
+export * from './select';
 export declare const setPisellUtilsConfig: (config: {
     [key: string]: any;
 }) => void;

package/es/index.js

@@ -6,6 +6,7 @@ function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol"
 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); }
 export * from "./otherUtils";
 export * from "./typeUtils";
+export * from "./componentStorage";
 export * from "./document";
 export * from "./date";
 export * from "./platform";
@@ -18,6 +19,11 @@ export * from "./image";
 export * from "./locales";
 export * from "./arrayUtils";
 export * from "./walletValidity";
+export * from "./weighing";
+export * from "./common";
+export * from "./text-input";
+export * from "./number-input";
+export * from "./select";
 // export { default as firebase } from './firebase';
 
 export var setPisellUtilsConfig = function setPisellUtilsConfig(config) {