@pisell/utils 3.0.6 → 3.0.7

package/es/weighing.d.ts

@@ -1,65 +1,62 @@
-//#region src/weighing.d.ts
 /** 商品配置与 NativeScale 使用的重量单位。 */
-type WeightUnitName = 'KILOGRAMS' | 'GRAMS' | 'POUNDS' | 'OUNCES';
+export declare type WeightUnitName = 'KILOGRAMS' | 'GRAMS' | 'POUNDS' | 'OUNCES';
 /** 订单快照与 UI 使用的标准单位符号。 */
-type WeightUnitSymbol = 'kg' | 'g' | 'lb' | 'oz';
-type WeightUnit = WeightUnitName | WeightUnitSymbol;
+export declare type WeightUnitSymbol = 'kg' | 'g' | 'lb' | 'oz';
+export declare type WeightUnit = WeightUnitName | WeightUnitSymbol;
 /**
  * Pisell 的标准重量单位。目录单价、缺省秤单位和缺省展示均以它为准。
  * 后续标准单位变化时，应优先只修改此处。
  */
-declare const STANDARD_WEIGHT_UNIT: WeightUnitName;
-declare const WEIGHT_PRECISION = 3;
-declare const UNIT_PRICE_PRECISION = 2;
-declare const MAX_RETAIL_SCALE_WEIGHT_KG = 1000;
-declare const WEIGHT_UNIT_SYMBOLS: Record<WeightUnitName, WeightUnitSymbol>;
-declare const WEIGHT_UNIT_NAMES: Record<WeightUnitSymbol, WeightUnitName>;
+export declare const STANDARD_WEIGHT_UNIT: WeightUnitName;
+export declare const WEIGHT_PRECISION = 3;
+export declare const UNIT_PRICE_PRECISION = 2;
+export declare const MAX_RETAIL_SCALE_WEIGHT_KG = 1000;
+export declare const WEIGHT_UNIT_SYMBOLS: Record<WeightUnitName, WeightUnitSymbol>;
+export declare const WEIGHT_UNIT_NAMES: Record<WeightUnitSymbol, WeightUnitName>;
 /** 单位对应的克数，作为不依赖 NativeScale 的目录价格换算基准。 */
-declare const WEIGHT_UNIT_GRAMS: Record<WeightUnit, number>;
-declare const STANDARD_WEIGHT_UNIT_SYMBOL: WeightUnitSymbol;
-declare const normalizeWeightUnit: (unit?: string | null, fallback?: WeightUnitName) => WeightUnitName;
-declare const getWeightUnitSymbol: (unit?: string | null) => string;
-declare const getWeightUnitGrams: (unit?: string | null) => number | undefined;
+export declare const WEIGHT_UNIT_GRAMS: Record<WeightUnit, number>;
+export declare const STANDARD_WEIGHT_UNIT_SYMBOL: WeightUnitSymbol;
+export declare const normalizeWeightUnit: (unit?: string | null, fallback?: WeightUnitName) => WeightUnitName;
+export declare const getWeightUnitSymbol: (unit?: string | null) => string;
+export declare const getWeightUnitGrams: (unit?: string | null) => number | undefined;
 /**
  * 将“每 sourceUnitValue 个 sourceUnit 的价格”换算到每 1 个目标单位的倍率。
  * 这里只处理目录单价的单位关系；实际秤读数计价仍应使用 NativeScale。
  */
-declare const getWeightUnitPriceConversionFactor: (params: {
-  sourceUnit?: string | null;
-  sourceUnitValue?: string | number | null;
-  targetUnit?: string | null;
+export declare const getWeightUnitPriceConversionFactor: (params: {
+    sourceUnit?: string | null;
+    sourceUnitValue?: string | number | null;
+    targetUnit?: string | null;
 }) => number | undefined;
-declare const isSupportedWeightUnit: (unit?: unknown) => unit is WeightUnit;
-declare const formatWeightValue: (value: unknown, precision?: number) => string;
-declare const formatUnitPriceValue: (value: unknown, precision?: number) => string;
-type ScaleReadingStatus = 'stable' | 'unstable' | 'overload' | 'negative' | string | null;
-declare const INVALID_SCALE_READING_STATUSES: readonly ["overload", "negative"];
-declare const isInvalidScaleReadingStatus: (status?: ScaleReadingStatus) => boolean;
-declare const getUsableScaleWeight: (status: ScaleReadingStatus | undefined, weight: number) => number;
-interface WeighingSnapshot {
-  open_sold_weight?: number | string | boolean;
-  mode?: 'auto' | 'manual' | string;
-  weight_source?: 'auto' | 'manual' | string;
-  weight?: string | number;
-  tare?: {
-    id?: string;
-    label?: string;
-    value?: string | number;
+export declare const isSupportedWeightUnit: (unit?: unknown) => unit is WeightUnit;
+export declare const formatWeightValue: (value: unknown, precision?: number) => string;
+export declare const formatUnitPriceValue: (value: unknown, precision?: number) => string;
+export declare type ScaleReadingStatus = 'stable' | 'unstable' | 'overload' | 'negative' | string | null;
+export declare const INVALID_SCALE_READING_STATUSES: readonly ["overload", "negative"];
+export declare const isInvalidScaleReadingStatus: (status?: ScaleReadingStatus) => boolean;
+export declare const getUsableScaleWeight: (status: ScaleReadingStatus | undefined, weight: number) => number;
+export interface WeighingSnapshot {
+    open_sold_weight?: number | string | boolean;
+    mode?: 'auto' | 'manual' | string;
+    weight_source?: 'auto' | 'manual' | string;
+    weight?: string | number;
+    tare?: {
+        id?: string;
+        label?: string;
+        value?: string | number;
+        unit?: WeightUnit | string;
+    };
+    tare_name?: string;
+    tare_weight?: string | number;
+    net_weight?: string | number;
+    unit_price?: string | number;
     unit?: WeightUnit | string;
-  };
-  tare_name?: string;
-  tare_weight?: string | number;
-  net_weight?: string | number;
-  unit_price?: string | number;
-  unit?: WeightUnit | string;
-  unit_weight?: string | number;
-  unit_data_snapshot?: unknown;
-  scalePriceProduct?: unknown;
-  total_amount?: string | number;
+    unit_weight?: string | number;
+    unit_data_snapshot?: unknown;
+    scalePriceProduct?: unknown;
+    total_amount?: string | number;
 }
 /**
  * 解析订单行称重快照：product_sku 是权威源，_extend.weighing 仅用于旧流程兼容。
  */
-declare const resolveWeighingSnapshot: (dataSource?: Record<string, any> | null) => WeighingSnapshot | undefined;
-//#endregion
-export { INVALID_SCALE_READING_STATUSES, MAX_RETAIL_SCALE_WEIGHT_KG, STANDARD_WEIGHT_UNIT, STANDARD_WEIGHT_UNIT_SYMBOL, ScaleReadingStatus, UNIT_PRICE_PRECISION, WEIGHT_PRECISION, WEIGHT_UNIT_GRAMS, WEIGHT_UNIT_NAMES, WEIGHT_UNIT_SYMBOLS, WeighingSnapshot, WeightUnit, WeightUnitName, WeightUnitSymbol, formatUnitPriceValue, formatWeightValue, getUsableScaleWeight, getWeightUnitGrams, getWeightUnitPriceConversionFactor, getWeightUnitSymbol, isInvalidScaleReadingStatus, isSupportedWeightUnit, normalizeWeightUnit, resolveWeighingSnapshot };
+export declare const resolveWeighingSnapshot: (dataSource?: Record<string, any> | null) => WeighingSnapshot | undefined;

package/es/weighing.js

@@ -1,96 +1,119 @@
-//#region src/weighing.ts
+/** 商品配置与 NativeScale 使用的重量单位。 */
+
+/** 订单快照与 UI 使用的标准单位符号。 */
+
 /**
-* Pisell 的标准重量单位。目录单价、缺省秤单位和缺省展示均以它为准。
-* 后续标准单位变化时，应优先只修改此处。
-*/
-const STANDARD_WEIGHT_UNIT = "KILOGRAMS";
-const WEIGHT_PRECISION = 3;
-const UNIT_PRICE_PRECISION = 2;
-const MAX_RETAIL_SCALE_WEIGHT_KG = 1e3;
-const WEIGHT_UNIT_SYMBOLS = {
-	KILOGRAMS: "kg",
-	GRAMS: "g",
-	POUNDS: "lb",
-	OUNCES: "oz"
+ * Pisell 的标准重量单位。目录单价、缺省秤单位和缺省展示均以它为准。
+ * 后续标准单位变化时，应优先只修改此处。
+ */
+export var STANDARD_WEIGHT_UNIT = 'KILOGRAMS';
+export var WEIGHT_PRECISION = 3;
+export var UNIT_PRICE_PRECISION = 2;
+export var MAX_RETAIL_SCALE_WEIGHT_KG = 1000;
+export var WEIGHT_UNIT_SYMBOLS = {
+  KILOGRAMS: 'kg',
+  GRAMS: 'g',
+  POUNDS: 'lb',
+  OUNCES: 'oz'
 };
-const WEIGHT_UNIT_NAMES = {
-	kg: "KILOGRAMS",
-	g: "GRAMS",
-	lb: "POUNDS",
-	oz: "OUNCES"
+export var WEIGHT_UNIT_NAMES = {
+  kg: 'KILOGRAMS',
+  g: 'GRAMS',
+  lb: 'POUNDS',
+  oz: 'OUNCES'
 };
+
 /** 单位对应的克数，作为不依赖 NativeScale 的目录价格换算基准。 */
-const WEIGHT_UNIT_GRAMS = {
-	KILOGRAMS: 1e3,
-	GRAMS: 1,
-	POUNDS: 453.59237,
-	OUNCES: 28.349523125,
-	kg: 1e3,
-	g: 1,
-	lb: 453.59237,
-	oz: 28.349523125
+export var WEIGHT_UNIT_GRAMS = {
+  KILOGRAMS: 1000,
+  GRAMS: 1,
+  POUNDS: 453.59237,
+  OUNCES: 28.349523125,
+  kg: 1000,
+  g: 1,
+  lb: 453.59237,
+  oz: 28.349523125
 };
-const STANDARD_WEIGHT_UNIT_SYMBOL = WEIGHT_UNIT_SYMBOLS[STANDARD_WEIGHT_UNIT];
-const normalizeWeightUnit = (unit, fallback = STANDARD_WEIGHT_UNIT) => {
-	if (unit && unit in WEIGHT_UNIT_SYMBOLS) return unit;
-	if (unit && unit in WEIGHT_UNIT_NAMES) return WEIGHT_UNIT_NAMES[unit];
-	return fallback;
+export var STANDARD_WEIGHT_UNIT_SYMBOL = WEIGHT_UNIT_SYMBOLS[STANDARD_WEIGHT_UNIT];
+export var normalizeWeightUnit = function normalizeWeightUnit(unit) {
+  var fallback = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : STANDARD_WEIGHT_UNIT;
+  if (unit && unit in WEIGHT_UNIT_SYMBOLS) {
+    return unit;
+  }
+  if (unit && unit in WEIGHT_UNIT_NAMES) {
+    return WEIGHT_UNIT_NAMES[unit];
+  }
+  return fallback;
 };
-const getWeightUnitSymbol = (unit) => {
-	if (unit && unit in WEIGHT_UNIT_SYMBOLS) return WEIGHT_UNIT_SYMBOLS[unit];
-	if (unit && unit in WEIGHT_UNIT_NAMES) return unit;
-	return unit || STANDARD_WEIGHT_UNIT_SYMBOL;
+export var getWeightUnitSymbol = function getWeightUnitSymbol(unit) {
+  if (unit && unit in WEIGHT_UNIT_SYMBOLS) {
+    return WEIGHT_UNIT_SYMBOLS[unit];
+  }
+  if (unit && unit in WEIGHT_UNIT_NAMES) {
+    return unit;
+  }
+  return unit || STANDARD_WEIGHT_UNIT_SYMBOL;
 };
-const getWeightUnitGrams = (unit) => unit ? WEIGHT_UNIT_GRAMS[unit] : WEIGHT_UNIT_GRAMS[STANDARD_WEIGHT_UNIT];
+export var getWeightUnitGrams = function getWeightUnitGrams(unit) {
+  return unit ? WEIGHT_UNIT_GRAMS[unit] : WEIGHT_UNIT_GRAMS[STANDARD_WEIGHT_UNIT];
+};
+
 /**
-* 将“每 sourceUnitValue 个 sourceUnit 的价格”换算到每 1 个目标单位的倍率。
-* 这里只处理目录单价的单位关系；实际秤读数计价仍应使用 NativeScale。
-*/
-const getWeightUnitPriceConversionFactor = (params) => {
-	var _params$sourceUnitVal;
-	const sourceGrams = getWeightUnitGrams(params.sourceUnit || "KILOGRAMS");
-	const targetGrams = getWeightUnitGrams(params.targetUnit || "KILOGRAMS");
-	const sourceUnitValue = Number((_params$sourceUnitVal = params.sourceUnitValue) !== null && _params$sourceUnitVal !== void 0 ? _params$sourceUnitVal : 1);
-	if (!sourceGrams || !targetGrams || !Number.isFinite(sourceUnitValue) || sourceUnitValue <= 0) return;
-	return targetGrams / (sourceGrams * sourceUnitValue);
+ * 将“每 sourceUnitValue 个 sourceUnit 的价格”换算到每 1 个目标单位的倍率。
+ * 这里只处理目录单价的单位关系；实际秤读数计价仍应使用 NativeScale。
+ */
+export var getWeightUnitPriceConversionFactor = function getWeightUnitPriceConversionFactor(params) {
+  var _params$sourceUnitVal;
+  var sourceGrams = getWeightUnitGrams(params.sourceUnit || STANDARD_WEIGHT_UNIT);
+  var targetGrams = getWeightUnitGrams(params.targetUnit || STANDARD_WEIGHT_UNIT);
+  var sourceUnitValue = Number((_params$sourceUnitVal = params.sourceUnitValue) !== null && _params$sourceUnitVal !== void 0 ? _params$sourceUnitVal : 1);
+  if (!sourceGrams || !targetGrams || !Number.isFinite(sourceUnitValue) || sourceUnitValue <= 0) {
+    return undefined;
+  }
+  return targetGrams / (sourceGrams * sourceUnitValue);
 };
-const isSupportedWeightUnit = (unit) => typeof unit === "string" && unit in WEIGHT_UNIT_GRAMS;
-const formatWeightValue = (value, precision = 3) => {
-	const parsedValue = Number(value);
-	return (Number.isFinite(parsedValue) ? parsedValue : 0).toFixed(precision);
+export var isSupportedWeightUnit = function isSupportedWeightUnit(unit) {
+  return typeof unit === 'string' && unit in WEIGHT_UNIT_GRAMS;
 };
-const formatUnitPriceValue = (value, precision = 2) => {
-	const parsedValue = Number(value);
-	return (Number.isFinite(parsedValue) ? parsedValue : 0).toFixed(precision);
+export var formatWeightValue = function formatWeightValue(value) {
+  var precision = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : WEIGHT_PRECISION;
+  var parsedValue = Number(value);
+  return (Number.isFinite(parsedValue) ? parsedValue : 0).toFixed(precision);
 };
-const INVALID_SCALE_READING_STATUSES = ["overload", "negative"];
-const isInvalidScaleReadingStatus = (status) => INVALID_SCALE_READING_STATUSES.includes(status);
-const getUsableScaleWeight = (status, weight) => isInvalidScaleReadingStatus(status) ? 0 : weight;
-const hasDisplayWeight = (value) => Boolean(value && (Number(value.weight) > 0 || Number(value.net_weight) > 0));
-const resolveProductSkuSnapshot = (value) => {
-	const snapshot = value;
-	return Number(snapshot === null || snapshot === void 0 ? void 0 : snapshot.open_sold_weight) === 1 && hasDisplayWeight(snapshot) ? snapshot : void 0;
+export var formatUnitPriceValue = function formatUnitPriceValue(value) {
+  var precision = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : UNIT_PRICE_PRECISION;
+  var parsedValue = Number(value);
+  return (Number.isFinite(parsedValue) ? parsedValue : 0).toFixed(precision);
 };
-/**
-* 解析订单行称重快照：product_sku 是权威源，_extend.weighing 仅用于旧流程兼容。
-*/
-const resolveWeighingSnapshot = (dataSource) => {
-	var _dataSource$_origin, _dataSource$metadata, _dataSource$_origin2, _dataSource$_extend, _dataSource$metadata2;
-	if (!dataSource) return void 0;
-	const productSkuCandidates = [
-		dataSource.product_sku,
-		(_dataSource$_origin = dataSource._origin) === null || _dataSource$_origin === void 0 ? void 0 : _dataSource$_origin.product_sku,
-		(_dataSource$metadata = dataSource.metadata) === null || _dataSource$metadata === void 0 || (_dataSource$metadata = _dataSource$metadata.origin) === null || _dataSource$metadata === void 0 ? void 0 : _dataSource$metadata.product_sku
-	];
-	for (const candidate of productSkuCandidates) {
-		const snapshot = resolveProductSkuSnapshot(candidate);
-		if (snapshot) return snapshot;
-	}
-	return [
-		(_dataSource$_origin2 = dataSource._origin) === null || _dataSource$_origin2 === void 0 || (_dataSource$_origin2 = _dataSource$_origin2._extend) === null || _dataSource$_origin2 === void 0 ? void 0 : _dataSource$_origin2.weighing,
-		(_dataSource$_extend = dataSource._extend) === null || _dataSource$_extend === void 0 ? void 0 : _dataSource$_extend.weighing,
-		(_dataSource$metadata2 = dataSource.metadata) === null || _dataSource$metadata2 === void 0 || (_dataSource$metadata2 = _dataSource$metadata2.origin) === null || _dataSource$metadata2 === void 0 || (_dataSource$metadata2 = _dataSource$metadata2._extend) === null || _dataSource$metadata2 === void 0 ? void 0 : _dataSource$metadata2.weighing
-	].find((candidate) => hasDisplayWeight(candidate));
+export var INVALID_SCALE_READING_STATUSES = ['overload', 'negative'];
+export var isInvalidScaleReadingStatus = function isInvalidScaleReadingStatus(status) {
+  return INVALID_SCALE_READING_STATUSES.includes(status);
+};
+export var getUsableScaleWeight = function getUsableScaleWeight(status, weight) {
+  return isInvalidScaleReadingStatus(status) ? 0 : weight;
 };
-//#endregion
-export { INVALID_SCALE_READING_STATUSES, MAX_RETAIL_SCALE_WEIGHT_KG, STANDARD_WEIGHT_UNIT, STANDARD_WEIGHT_UNIT_SYMBOL, UNIT_PRICE_PRECISION, WEIGHT_PRECISION, WEIGHT_UNIT_GRAMS, WEIGHT_UNIT_NAMES, WEIGHT_UNIT_SYMBOLS, formatUnitPriceValue, formatWeightValue, getUsableScaleWeight, getWeightUnitGrams, getWeightUnitPriceConversionFactor, getWeightUnitSymbol, isInvalidScaleReadingStatus, isSupportedWeightUnit, normalizeWeightUnit, resolveWeighingSnapshot };
+var hasDisplayWeight = function hasDisplayWeight(value) {
+  return Boolean(value && (Number(value.weight) > 0 || Number(value.net_weight) > 0));
+};
+var resolveProductSkuSnapshot = function resolveProductSkuSnapshot(value) {
+  var snapshot = value;
+  return Number(snapshot === null || snapshot === void 0 ? void 0 : snapshot.open_sold_weight) === 1 && hasDisplayWeight(snapshot) ? snapshot : undefined;
+};
+
+/**
+ * 解析订单行称重快照：product_sku 是权威源，_extend.weighing 仅用于旧流程兼容。
+ */
+export var resolveWeighingSnapshot = function resolveWeighingSnapshot(dataSource) {
+  var _dataSource$_origin, _dataSource$metadata, _dataSource$_origin2, _dataSource$_extend, _dataSource$metadata2;
+  if (!dataSource) return undefined;
+  var productSkuCandidates = [dataSource.product_sku, (_dataSource$_origin = dataSource._origin) === null || _dataSource$_origin === void 0 ? void 0 : _dataSource$_origin.product_sku, (_dataSource$metadata = dataSource.metadata) === null || _dataSource$metadata === void 0 || (_dataSource$metadata = _dataSource$metadata.origin) === null || _dataSource$metadata === void 0 ? void 0 : _dataSource$metadata.product_sku];
+  for (var _i = 0, _productSkuCandidates = productSkuCandidates; _i < _productSkuCandidates.length; _i++) {
+    var candidate = _productSkuCandidates[_i];
+    var snapshot = resolveProductSkuSnapshot(candidate);
+    if (snapshot) return snapshot;
+  }
+  var legacyCandidates = [(_dataSource$_origin2 = dataSource._origin) === null || _dataSource$_origin2 === void 0 || (_dataSource$_origin2 = _dataSource$_origin2._extend) === null || _dataSource$_origin2 === void 0 ? void 0 : _dataSource$_origin2.weighing, (_dataSource$_extend = dataSource._extend) === null || _dataSource$_extend === void 0 ? void 0 : _dataSource$_extend.weighing, (_dataSource$metadata2 = dataSource.metadata) === null || _dataSource$metadata2 === void 0 || (_dataSource$metadata2 = _dataSource$metadata2.origin) === null || _dataSource$metadata2 === void 0 || (_dataSource$metadata2 = _dataSource$metadata2._extend) === null || _dataSource$metadata2 === void 0 ? void 0 : _dataSource$metadata2.weighing];
+  return legacyCandidates.find(function (candidate) {
+    return hasDisplayWeight(candidate);
+  });
+};

package/lib/arrayUtils.d.ts

@@ -1,10 +1,9 @@
-//#region src/arrayUtils.d.ts
-declare const uniqueByKey: <T>(arr: T[], key: keyof T) => T[];
+export declare const uniqueByKey: <T>(arr: T[], key: keyof T) => T[];
 /**
  * 分组键的基础类型
  * @description 分组条件计算后得到的标量值
  */
-type GroupKey = string | number | boolean;
+export declare type GroupKey = string | number | boolean;
 /**
  * 分组规则
  * @template T - 数据项类型
@@ -13,34 +12,34 @@ type GroupKey = string | number | boolean;
  * - `string[]`：多字段组合，按顺序拼接为组合键
  * - `(item, index) => GroupKey | GroupKey[]`：完全自定义分组键
  */
-type GroupBySpec<T> = string | string[] | ((item: T, index: number) => GroupKey | GroupKey[]);
+export declare type GroupBySpec<T> = string | string[] | ((item: T, index: number) => GroupKey | GroupKey[]);
 /**
  * 单个分组的结果模型
  * @template T - 数据项类型
  */
-interface GroupResult<T> {
-  /** 分组唯一标识（默认由各分组键以 `|` 拼接） */
-  groupId: string;
-  /** 分组键值数组，与 `GroupBySpec` 顺序对应 */
-  keys: GroupKey[];
-  /** 字段名 -> 键值映射，便于头部直接按字段名取值（自定义函数分组时为空对象） */
-  keyMap: Record<string, GroupKey>;
-  /** 该分组内的原始数据项（保持原数组中的相对顺序） */
-  items: T[];
-  /** 分组的最终顺序下标 */
-  index: number;
+export interface GroupResult<T> {
+    /** 分组唯一标识（默认由各分组键以 `|` 拼接） */
+    groupId: string;
+    /** 分组键值数组，与 `GroupBySpec` 顺序对应 */
+    keys: GroupKey[];
+    /** 字段名 -> 键值映射，便于头部直接按字段名取值（自定义函数分组时为空对象） */
+    keyMap: Record<string, GroupKey>;
+    /** 该分组内的原始数据项（保持原数组中的相对顺序） */
+    items: T[];
+    /** 分组的最终顺序下标 */
+    index: number;
 }
 /**
  * 分组可选项
  * @template T - 数据项类型
  */
-interface GroupByOptions<T> {
-  /** 自定义分组 id 生成（默认 `keys.join('|')`） */
-  getGroupId?: (keys: GroupKey[]) => string;
-  /** 分组之间的排序；不传则保持各分组首次出现的顺序 */
-  sortGroups?: (a: GroupResult<T>, b: GroupResult<T>) => number;
-  /** 分组内数据项的排序；不传则保持原始相对顺序 */
-  sortItems?: (a: T, b: T) => number;
+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;
 }
 /**
  * 按点路径安全取值
@@ -51,7 +50,7 @@ interface GroupByOptions<T> {
  * getByPath({ a: { b: 1 } }, 'a.b') // 1
  * getByPath({ id: 9 }, 'id') // 9
  */
-declare const getByPath: (obj: unknown, path: string) => unknown;
+export declare const getByPath: (obj: unknown, path: string) => unknown;
 /**
  * 将数组按指定条件分组
  * @template T - 数据项类型
@@ -71,6 +70,4 @@ declare const getByPath: (obj: unknown, path: string) => unknown;
  * // 自定义键
  * groupBy(list, (item) => `${item.productId}_${item.time}`);
  */
-declare const groupBy: <T>(dataSource: T[], spec: GroupBySpec<T>, options?: GroupByOptions<T>) => GroupResult<T>[];
-//#endregion
-export { GroupByOptions, GroupBySpec, GroupKey, GroupResult, getByPath, groupBy, uniqueByKey };
+export declare const groupBy: <T>(dataSource: T[], spec: GroupBySpec<T>, options?: GroupByOptions<T>) => GroupResult<T>[];

package/lib/arrayUtils.js

@@ -1,105 +1,115 @@
-//#region src/arrayUtils.ts
-const uniqueByKey = (arr, key) => {
-	const seen = /* @__PURE__ */ new Set();
-	const result = [];
-	for (const item of arr) {
-		const keyValue = item[key];
-		if (!seen.has(keyValue)) {
-			seen.add(keyValue);
-			result.push(item);
-		}
-	}
-	return result;
+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 });
 };
-/**
-* 按点路径安全取值
-* @param obj - 取值对象
-* @param path - 字段路径，支持 `'a.b.c'`
-* @returns 路径对应的值，路径不存在时返回 undefined
-* @example
-* getByPath({ a: { b: 1 } }, 'a.b') // 1
-* getByPath({ id: 9 }, 'id') // 9
-*/
-const getByPath = (obj, path) => {
-	if (obj === null || obj === void 0) return;
-	if (path.indexOf(".") === -1) return obj[path];
-	return path.split(".").reduce((acc, key) => {
-		if (acc === null || acc === void 0) return;
-		return acc[key];
-	}, obj);
+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;
 };
-/**
-* 将任意值规范化为可用于分组的标量键
-* @description null/undefined 统一归一为空字符串，对象/数组等转为字符串，避免分组键不稳定
-*/
-const 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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/arrayUtils.ts
+var arrayUtils_exports = {};
+__export(arrayUtils_exports, {
+  getByPath: () => getByPath,
+  groupBy: () => groupBy,
+  uniqueByKey: () => uniqueByKey
+});
+module.exports = __toCommonJS(arrayUtils_exports);
+var uniqueByKey = (arr, key) => {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const item of arr) {
+    const keyValue = item[key];
+    if (!seen.has(keyValue)) {
+      seen.add(keyValue);
+      result.push(item);
+    }
+  }
+  return result;
 };
-/**
-* 将数组按指定条件分组
-* @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}`);
-*/
-const 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;
+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);
 };
-//#endregion
-exports.getByPath = getByPath;
-exports.groupBy = groupBy;
-exports.uniqueByKey = uniqueByKey;
+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';