befly-shared 1.3.8 → 1.3.10

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "befly-shared",
-    "version": "1.3.8",
-    "gitHead": "b2a7116ecbf488ef3e7e74c5cb1da1ff33a64f2c",
+    "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

@@ -0,0 +1,88 @@
+// 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: unknown): val is any[] {
+    return Array.isArray(val);
+}
+
+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: Record<string, any>) => {
+        const result: Record<string, any> = {};
+
+        let keys = Object.keys(obj);
+        if (pickKeys && pickKeys.length) {
+            keys = keys.filter((k) => pickKeys.includes(k));
+        }
+        if (omitKeys && omitKeys.length) {
+            keys = keys.filter((k) => !omitKeys.includes(k));
+        }
+
+        for (const key of keys) {
+            const value = obj[key];
+
+            // 1. keepMap 优先
+            if (keepMap && Object.prototype.hasOwnProperty.call(keepMap, key)) {
+                if (Object.is(keepMap[key], value)) {
+                    result[key] = value;
+                    continue;
+                }
+            }
+
+            // 2. keepValues
+            if (keepValues && keepValues.length && !keepValues.includes(value)) {
+                continue;
+            }
+
+            // 3. excludeValues
+            if (excludeValues && excludeValues.length && excludeValues.includes(value)) {
+                continue;
+            }
+
+            result[key] = value;
+        }
+
+        return result;
+    };
+
+    if (isArray(data)) {
+        return (data as any[])
+            .map((item) => {
+                if (isObject(item)) {
+                    return filterObj(item);
+                }
+                return item;
+            })
+            .filter((item) => {
+                if (isObject(item)) {
+                    return Object.keys(item).length > 0;
+                }
+                return true;
+            }) as FieldClearResult<T>;
+    }
+
+    if (isObject(data)) {
+        return filterObj(data as Record<string, any>) as FieldClearResult<T>;
+    }
+
+    return data as FieldClearResult<T>;
+}