befly-shared 1.3.9 → 1.3.10

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "befly-shared",
-    "version": "1.3.9",
-    "gitHead": "f5d17c019a58e82cfacec5ce3a1f04e3225ba838",
+    "version": "1.3.10",
+    "gitHead": "1fb1ccce3a69fb6a57f42a1e269c307ed159ae9a",
     "private": false,
     "description": "Befly 纯函数与纯常量共享包（不包含 Node/浏览器特定实现）",
     "license": "Apache-2.0",
@@ -17,7 +17,8 @@
         "./types/*": "./types/*.ts"
     },
     "scripts": {
-        "test": "bun test"
+        "test": "bun test",
+        "typecheck": "bunx tsgo --noEmit"
     },
     "dependencies": {
         "es-toolkit": "^1.43.0"

package/utils/fieldClear.ts

@@ -1,39 +1,33 @@
-/**
- * @typedef {Object} FieldClearOptions
- * @property {string[]=} pickKeys
- * @property {string[]=} omitKeys
- * @property {any[]=} keepValues
- * @property {any[]=} excludeValues
- * @property {Record<string, any>=} keepMap
- */
-
-function isObject(val) {
+// fieldClear 工具函数实现（shared 版）
+// 支持 pick/omit/keepValues/excludeValues/keepMap，处理对象和数组
+
+export interface FieldClearOptions {
+    pickKeys?: string[];
+    omitKeys?: string[];
+    keepValues?: any[];
+    excludeValues?: any[];
+    keepMap?: Record<string, any>;
+}
+
+export type FieldClearResult<T> = T extends Array<infer U> ? Array<FieldClearResult<U>> : T extends object ? { [K in keyof T]?: T[K] } : T;
+
+function isObject(val: unknown): val is Record<string, any> {
     return val !== null && typeof val === "object" && !Array.isArray(val);
 }
 
-function isArray(val) {
+function isArray(val: unknown): val is any[] {
     return Array.isArray(val);
 }
 
-/**
- * 清理对象/数组字段
- * - 支持 pick/omit/keepValues/excludeValues
- * - 支持 keepMap 强制保留
- * @template T
- * @param {T|T[]} data
- * @param {FieldClearOptions=} options
- * @returns {any}
- */
-export function fieldClear(data, options = {}) {
+export function fieldClear<T = any>(data: T | T[], options: FieldClearOptions = {}): FieldClearResult<T> {
     const pickKeys = options.pickKeys;
     const omitKeys = options.omitKeys;
     const keepValues = options.keepValues;
     const excludeValues = options.excludeValues;
     const keepMap = options.keepMap;
 
-    const filterObj = (obj) => {
-        /** @type {Record<string, any>} */
-        const result = {};
+    const filterObj = (obj: Record<string, any>) => {
+        const result: Record<string, any> = {};
 
         let keys = Object.keys(obj);
         if (pickKeys && pickKeys.length) {
@@ -71,7 +65,7 @@ export function fieldClear(data, options = {}) {
     };
 
     if (isArray(data)) {
-        return data
+        return (data as any[])
             .map((item) => {
                 if (isObject(item)) {
                     return filterObj(item);
@@ -83,12 +77,12 @@ export function fieldClear(data, options = {}) {
                     return Object.keys(item).length > 0;
                 }
                 return true;
-            });
+            }) as FieldClearResult<T>;
     }
 
     if (isObject(data)) {
-        return filterObj(data);
+        return filterObj(data as Record<string, any>) as FieldClearResult<T>;
     }
 
-    return data;
+    return data as FieldClearResult<T>;
 }