zzz-pc-view 0.0.89 → 0.0.90

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zzz-pc-view",
-  "version": "0.0.89",
+  "version": "0.0.90",
   "main": "src/index.umd.js",
   "module": "src/index.es.js",
   "types": "src/index.d.ts",

package/src/index.es.js

@@ -1926,20 +1926,28 @@ const selectCtrlByAll = (param) => {
 };
 const selectCtrlByInvert = (param) => {
   const { keyProp, selected, defaultBoolean } = param;
-  return param.toMap ? param.list.reduce(
-    (map2, item) => {
-      const key2 = item[keyProp];
-      map2[key2] = Object.prototype.hasOwnProperty.call(selected, key2) ? !selected[key2] : defaultBoolean;
-      return map2;
-    },
-    {}
-  ) : param.list.reduce((list2, item) => {
-    const key2 = item[keyProp];
-    if (Object.prototype.hasOwnProperty.call(selected, key2) ? !selected[key2] : defaultBoolean) {
-      list2.push(key2);
-    }
-    return list2;
-  }, []);
+  return (
+    // 根据 toMap 的值选择不同的处理方式
+    param.toMap ? param.list.reduce(
+      // 将列表转换为映射对象，反转每个元素的选择状态
+      (map2, item) => {
+        const key2 = item[keyProp];
+        map2[key2] = Object.prototype.hasOwnProperty.call(selected, key2) ? !selected[key2] : defaultBoolean;
+        return map2;
+      },
+      {}
+    ) : param.list.reduce(
+      // 将列表转换为数组，只包含反转后选择状态为 true 的元素
+      (list2, item) => {
+        const key2 = item[keyProp];
+        if (Object.prototype.hasOwnProperty.call(selected, key2) ? !selected[key2] : defaultBoolean) {
+          list2.push(key2);
+        }
+        return list2;
+      },
+      []
+    )
+  );
 };
 const index$c = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,

package/src/utils/operator/selectCtrl.d.ts

@@ -1,10 +1,44 @@
 import { KeyMatch, KeyValType } from '../DeclareType';
+/**
+ * 定义 `selectCtrl` 系列函数的返回类型。
+ * 根据泛型参数 `M` 的值，决定返回一个映射对象或者一个值数组。
+ *
+ * @template M - 可选的布尔类型，用于指示是否将结果转换为映射对象，可为 `undefined`。
+ * @returns 如果 `M` 为 `true`，返回以 `KeyValType` 为键、布尔值为值的映射对象；
+ *          否则，返回 `KeyValType` 类型的数组。
+ */
 export type SelectCtrlResponse<M extends undefined | boolean> = M extends true ? Record<KeyValType, boolean> : KeyValType[];
+/**
+ * 根据给定列表，选择所有元素并根据配置返回结果。
+ * 可以选择将列表元素的特定属性提取出来，也可以将结果转换为映射对象。
+ *
+ * @template T - 输入列表中元素的类型。
+ * @template M - 可选的布尔类型，用于指示是否将结果转换为映射对象，可为 `undefined`。
+ * @param param - 包含操作所需参数的对象。
+ * @param param.list - 输入的元素列表。
+ * @param param.keyProp - 用于从列表元素中提取特定属性的键。
+ * @param param.toMap - 可选的布尔值，指示是否将结果转换为映射对象。
+ * @returns 根据 `M` 的值，返回 `KeyValType` 类型的数组或者以 `KeyValType` 为键、布尔值为值的映射对象。
+ */
 export declare const selectCtrlByAll: <T, M extends undefined | boolean>(param: {
     list: T[];
     keyProp: KeyMatch<T, KeyValType>;
     toMap?: M;
 }) => SelectCtrlResponse<M>;
+/**
+ * 根据给定列表和已选状态，反转选择状态并根据配置返回结果。
+ * 可以选择将列表元素的特定属性提取出来，也可以将结果转换为映射对象。
+ *
+ * @template T - 输入列表中元素的类型。
+ * @template M - 可选的布尔类型，用于指示是否将结果转换为映射对象，可为 `undefined`。
+ * @param param - 包含操作所需参数的对象。
+ * @param param.list - 输入的元素列表。
+ * @param param.keyProp - 用于从列表元素中提取特定属性的键。
+ * @param param.toMap - 可选的布尔值，指示是否将结果转换为映射对象。
+ * @param param.selected - 已选状态的映射对象，键为 `KeyValType`，值为布尔值。
+ * @param param.defaultBoolean - 当元素不在 `selected` 中时的默认选择状态。
+ * @returns 根据 `M` 的值，返回 `KeyValType` 类型的数组或者以 `KeyValType` 为键、布尔值为值的映射对象。
+ */
 export declare const selectCtrlByInvert: <T, M extends undefined | boolean>(param: {
     list: T[];
     keyProp: KeyMatch<T, KeyValType>;