@pisell/utils 3.0.5 → 3.0.7

package/lib/arrayUtils.js

@@ -19,6 +19,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/arrayUtils.ts
 var arrayUtils_exports = {};
 __export(arrayUtils_exports, {
+  getByPath: () => getByPath,
+  groupBy: () => groupBy,
   uniqueByKey: () => uniqueByKey
 });
 module.exports = __toCommonJS(arrayUtils_exports);
@@ -34,7 +36,80 @@ var uniqueByKey = (arr, key) => {
   }
   return result;
 };
+var getByPath = (obj, path) => {
+  if (obj === null || obj === void 0) {
+    return void 0;
+  }
+  if (path.indexOf(".") === -1) {
+    return obj[path];
+  }
+  return path.split(".").reduce((acc, key) => {
+    if (acc === null || acc === void 0) {
+      return void 0;
+    }
+    return acc[key];
+  }, obj);
+};
+var normalizeGroupKey = (value) => {
+  if (value === null || value === void 0) {
+    return "";
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return value;
+  }
+  return String(value);
+};
+var groupBy = (dataSource, spec, options = {}) => {
+  const { getGroupId, sortGroups, sortItems } = options;
+  const fieldNames = Array.isArray(spec) ? spec : typeof spec === "string" ? [spec] : [];
+  const groupMap = /* @__PURE__ */ new Map();
+  const order = [];
+  (dataSource || []).forEach((item, index) => {
+    let keys;
+    if (typeof spec === "function") {
+      const result = spec(item, index);
+      keys = (Array.isArray(result) ? result : [result]).map(normalizeGroupKey);
+    } else if (Array.isArray(spec)) {
+      keys = spec.map((field) => normalizeGroupKey(getByPath(item, field)));
+    } else {
+      keys = [normalizeGroupKey(getByPath(item, spec))];
+    }
+    const groupId = getGroupId ? getGroupId(keys) : keys.join("|");
+    let group = groupMap.get(groupId);
+    if (!group) {
+      const keyMap = {};
+      fieldNames.forEach((field, i) => {
+        keyMap[field] = keys[i];
+      });
+      group = {
+        groupId,
+        keys,
+        keyMap,
+        items: [],
+        index: order.length
+      };
+      groupMap.set(groupId, group);
+      order.push(groupId);
+    }
+    group.items.push(item);
+  });
+  let groups = order.map((id) => groupMap.get(id));
+  if (sortItems) {
+    groups.forEach((group) => {
+      group.items.sort(sortItems);
+    });
+  }
+  if (sortGroups) {
+    groups = groups.slice().sort(sortGroups);
+    groups.forEach((group, i) => {
+      group.index = i;
+    });
+  }
+  return groups;
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  getByPath,
+  groupBy,
   uniqueByKey
 });

package/lib/common/index.d.ts

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

package/lib/common/index.js

@@ -0,0 +1,29 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/common/index.ts
+var common_exports = {};
+__export(common_exports, {
+  getDisplayState: () => import_stateHelper.getDisplayState
+});
+module.exports = __toCommonJS(common_exports);
+var import_stateHelper = require("./stateHelper");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getDisplayState
+});

package/lib/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/lib/common/stateHelper.js

@@ -0,0 +1,34 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/common/stateHelper.ts
+var stateHelper_exports = {};
+__export(stateHelper_exports, {
+  getDisplayState: () => getDisplayState
+});
+module.exports = __toCommonJS(stateHelper_exports);
+function getDisplayState(mode, disabled) {
+  if (disabled) {
+    return "disabled";
+  }
+  return mode || "edit";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getDisplayState
+});

package/lib/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/lib/common/types.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/common/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/lib/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/lib/componentStorage.js

@@ -0,0 +1,144 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/componentStorage.ts
+var componentStorage_exports = {};
+__export(componentStorage_exports, {
+  clearColumnSettingFromLocal: () => clearColumnSettingFromLocal,
+  clearColumnVisibilityFromLocal: () => clearColumnVisibilityFromLocal,
+  getColumnSettingFromLocal: () => getColumnSettingFromLocal,
+  getColumnVisibilityFromLocal: () => getColumnVisibilityFromLocal,
+  getComponentStorageKey: () => getComponentStorageKey,
+  getRecordBoardColumnSettingFromLocal: () => getRecordBoardColumnSettingFromLocal,
+  getStorageKeySuffix: () => getStorageKeySuffix,
+  saveColumnSettingToLocal: () => saveColumnSettingToLocal,
+  saveColumnVisibilityToLocal: () => saveColumnVisibilityToLocal
+});
+module.exports = __toCommonJS(componentStorage_exports);
+var import_typeUtils = require("./typeUtils");
+function getStorageKeySuffix() {
+  if (typeof window === "undefined" || typeof window.location === "undefined") {
+    return "/";
+  }
+  const { pathname, search } = window.location;
+  const appendPath = pathname || "/";
+  let memoryKey = "";
+  try {
+    const params = new URLSearchParams(search || "");
+    const mk = params.get("memory_key");
+    if (mk && mk.trim() !== "") memoryKey = mk.trim();
+  } catch {
+  }
+  return memoryKey ? `${appendPath}#${memoryKey}` : appendPath;
+}
+function getComponentStorageKey(componentId, prefix) {
+  if (typeof window === "undefined" || typeof window.location === "undefined") {
+    return `${prefix}-${componentId}`;
+  }
+  const suffix = getStorageKeySuffix();
+  return `${prefix}-${componentId}-${suffix}`;
+}
+function saveColumnSettingToLocal(params) {
+  const { componentId, columnSetting } = params;
+  if (!componentId) return;
+  if (typeof window === "undefined" || !window.localStorage) return;
+  const storageKey = getComponentStorageKey(componentId, "table-setting");
+  const data = { column_setting: columnSetting, updatedAt: Date.now() };
+  try {
+    window.localStorage.setItem(storageKey, JSON.stringify(data));
+  } catch {
+  }
+}
+function getColumnSettingFromLocal(componentId) {
+  if (!componentId) return null;
+  if (typeof window === "undefined" || !window.localStorage) return null;
+  const storageKey = getComponentStorageKey(componentId, "table-setting");
+  const raw = window.localStorage.getItem(storageKey);
+  if (raw && (0, import_typeUtils.isJson)(raw)) {
+    const data = JSON.parse(raw);
+    const arr = data == null ? void 0 : data.column_setting;
+    return Array.isArray(arr) ? arr : null;
+  }
+  return null;
+}
+function clearColumnSettingFromLocal(componentId) {
+  if (!componentId) return;
+  if (typeof window === "undefined" || !window.localStorage) return;
+  const storageKey = getComponentStorageKey(componentId, "table-setting");
+  window.localStorage.removeItem(storageKey);
+}
+var RECORD_BOARD_VISIBILITY_PREFIX = "record-board-column-visibility";
+function saveColumnVisibilityToLocal(params) {
+  const { componentId, columnVisibility, columnOrder } = params;
+  if (!componentId) return;
+  if (typeof window === "undefined" || !window.localStorage) return;
+  const storageKey = getComponentStorageKey(componentId, RECORD_BOARD_VISIBILITY_PREFIX);
+  const data = {
+    column_visibility: columnVisibility,
+    ...columnOrder != null && { column_order: columnOrder },
+    updatedAt: Date.now()
+  };
+  try {
+    window.localStorage.setItem(storageKey, JSON.stringify(data));
+  } catch {
+  }
+}
+function getColumnVisibilityFromLocal(componentId) {
+  if (!componentId) return null;
+  if (typeof window === "undefined" || !window.localStorage) return null;
+  const storageKey = getComponentStorageKey(componentId, RECORD_BOARD_VISIBILITY_PREFIX);
+  const raw = window.localStorage.getItem(storageKey);
+  if (raw && (0, import_typeUtils.isJson)(raw)) {
+    const data = JSON.parse(raw);
+    const vis = data == null ? void 0 : data.column_visibility;
+    return vis && typeof vis === "object" && vis !== null ? vis : null;
+  }
+  return null;
+}
+function getRecordBoardColumnSettingFromLocal(componentId) {
+  if (!componentId) return null;
+  if (typeof window === "undefined" || !window.localStorage) return null;
+  const storageKey = getComponentStorageKey(componentId, RECORD_BOARD_VISIBILITY_PREFIX);
+  const raw = window.localStorage.getItem(storageKey);
+  if (raw && (0, import_typeUtils.isJson)(raw)) {
+    const data = JSON.parse(raw);
+    const vis = data == null ? void 0 : data.column_visibility;
+    const columnVisibility = vis && typeof vis === "object" && vis !== null ? vis : {};
+    const columnOrder = Array.isArray(data == null ? void 0 : data.column_order) ? data.column_order : null;
+    return { columnVisibility, columnOrder };
+  }
+  return null;
+}
+function clearColumnVisibilityFromLocal(componentId) {
+  if (!componentId) return;
+  if (typeof window === "undefined" || !window.localStorage) return;
+  const storageKey = getComponentStorageKey(componentId, RECORD_BOARD_VISIBILITY_PREFIX);
+  window.localStorage.removeItem(storageKey);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearColumnSettingFromLocal,
+  clearColumnVisibilityFromLocal,
+  getColumnSettingFromLocal,
+  getColumnVisibilityFromLocal,
+  getComponentStorageKey,
+  getRecordBoardColumnSettingFromLocal,
+  getStorageKeySuffix,
+  saveColumnSettingToLocal,
+  saveColumnVisibilityToLocal
+});

package/lib/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/lib/format.js

@@ -53,12 +53,28 @@ var formatAmount = (amount = 0, precision = 2, symbol = "") => {
     return amount;
   }
 };
-var formatAmountWithOptions = (amount = 0, symbol = "", options) => {
+var applyCurrencyFormat = (params) => {
+  const { amount, symbol, currencyCode, currencyFormat } = params;
+  const 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 `${amount}${symbol}`;
+    if (currencyCode) return `${amount} ${currencyCode}`;
+    return amount;
+  }
+  if (symbol) return `${symbol}${amount}`;
+  return currencyCode ? `${amount} ${currencyCode}` : amount;
+};
+var formatAmountWithOptions = (amount = 0, symbol = "", options = {}) => {
   const {
     precision = 2,
     useThousandsSeparator = false,
     showCurrencySymbol = true,
-    hideDecimalForWholeNumbers = true
+    hideDecimalForWholeNumbers = true,
+    currencyCode = "",
+    currencyFormat = ""
   } = options;
   if (!(0, import_typeUtils.isString)(amount) && !(0, import_typeUtils.isNumber)(amount)) {
     console.error("amount is not a number");
@@ -69,17 +85,41 @@ var formatAmountWithOptions = (amount = 0, symbol = "", options) => {
     const absoluteAmount = Math.abs(roundedAmount);
     const integerPart = Math.floor(absoluteAmount);
     const decimalPart = (absoluteAmount - integerPart).toFixed(precision).substring(2);
+    if (!currencyCode && !currencyFormat) {
+      let 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;
+    }
     let formattedAmount = useThousandsSeparator ? integerPart.toLocaleString() : integerPart.toString();
-    formattedAmount = showCurrencySymbol ? symbol + formattedAmount : formattedAmount;
     if (precision > 0) {
       formattedAmount += "." + decimalPart;
-      if (hideDecimalForWholeNumbers && formattedAmount.indexOf(".00") !== -1) {
+      if (hideDecimalForWholeNumbers && Number(decimalPart) === 0) {
         formattedAmount = formattedAmount.substring(
           0,
-          formattedAmount.length - 3
+          formattedAmount.length - precision - 1
         );
       }
     }
+    if (showCurrencySymbol) {
+      formattedAmount = applyCurrencyFormat({
+        amount: formattedAmount,
+        symbol,
+        currencyCode,
+        currencyFormat
+      });
+    }
     if (roundedAmount < 0) {
       formattedAmount = "-" + formattedAmount;
     }

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

@@ -26,6 +26,7 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 __reExport(src_exports, require("./otherUtils"), module.exports);
 __reExport(src_exports, require("./typeUtils"), module.exports);
+__reExport(src_exports, require("./componentStorage"), module.exports);
 __reExport(src_exports, require("./document"), module.exports);
 __reExport(src_exports, require("./date"), module.exports);
 __reExport(src_exports, require("./platform"), module.exports);
@@ -38,6 +39,11 @@ __reExport(src_exports, require("./image"), module.exports);
 __reExport(src_exports, require("./locales"), module.exports);
 __reExport(src_exports, require("./arrayUtils"), module.exports);
 __reExport(src_exports, require("./walletValidity"), module.exports);
+__reExport(src_exports, require("./weighing"), module.exports);
+__reExport(src_exports, require("./common"), module.exports);
+__reExport(src_exports, require("./text-input"), module.exports);
+__reExport(src_exports, require("./number-input"), module.exports);
+__reExport(src_exports, require("./select"), module.exports);
 var setPisellUtilsConfig = (config) => {
   globalThis.pisellUtilsConfig = {
     ...globalThis.pisellUtilsConfig || {},
@@ -55,6 +61,7 @@ var getPisellUtilsConfig = () => {
   setPisellUtilsConfig,
   ...require("./otherUtils"),
   ...require("./typeUtils"),
+  ...require("./componentStorage"),
   ...require("./document"),
   ...require("./date"),
   ...require("./platform"),
@@ -66,5 +73,10 @@ var getPisellUtilsConfig = () => {
   ...require("./image"),
   ...require("./locales"),
   ...require("./arrayUtils"),
-  ...require("./walletValidity")
+  ...require("./walletValidity"),
+  ...require("./weighing"),
+  ...require("./common"),
+  ...require("./text-input"),
+  ...require("./number-input"),
+  ...require("./select")
 });