bxs-tools-ui 3.2.0-0 → 3.2.0-2

package/es/product-info/index.js

@@ -9045,7 +9045,7 @@ function getHuomianPeriodValue() {
  * **将交费期间或者保险期间的值，转换成数值**
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2022-04-25
- * @param {string} value 必传。需要转换的值
+ * @param {string|number} value 必传。需要转换的值
  * @param {number} age 0 可不传。被保人年龄
  * @returns {number} 数值
  * @example
@@ -9077,7 +9077,7 @@ function getNumberFromYear(value) {
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2022-04-25
  * @param {number} value 必传
- * @returns {string} 单位为万的字符串
+ * @returns {number|string} 满足条件时返回单位为万的字符串，否则返回原数值
  * @example
  * converUnit10000(1000)
  * // returns 1000
@@ -9135,7 +9135,7 @@ function deepCopy(obj) {
  * **根据生日算年龄**
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2022-04-25
- * @param {Date|timestamp|dateStr} birth 必传。时间字符串或时间翟
+ * @param {Date|timestamp|dateStr} birth 必传。时间字符串或时间戳
  * @param {Date|timestamp|dateStr} cDate 可不传。指定时间，不传默认为当前时间
  * @returns {number} 年龄
  * @example
@@ -9181,7 +9181,9 @@ function getExpressionParamMap(personData, product, ins, options) {
     // 通用信息
     customVariable: null,
     // 自定义变量
-    cv: null // 简写，自定义变量
+    cv: null,
+    // 简写，自定义变量
+    t: {} // 事件目标
   };
   if (personData) {
     var insuredInfo = (personData.personOrderList || []).find(function (p) {
@@ -9229,8 +9231,13 @@ function getExpressionParamMap(personData, product, ins, options) {
       });
     }
   }
-  if (options && options.planbookId) {
-    map.planbookId = options.planbookId;
+  if (options) {
+    if (options.planbookId) {
+      map.planbookId = options.planbookId;
+    }
+    if (options.eventTarget) {
+      map.t = options.eventTarget;
+    }
   }
   if (ins && ins.customVariableExp) {
     var exp = ins.customVariableExp.replace(/(%)(\d+)(\.*\w*)(%)/g, 'map.i$2$3').replace(/(%)(\w*\.*\w*)(%)/g, 'map.$2');
@@ -9261,11 +9268,12 @@ function executeElementRule(personData, product, ins, ele) {
     }
     if (['cmCommonSelect', 'cmCommonRadioBtn', 'cmCommonRadio', 'cmCommonCheckbox'].includes(ele.componentName)) {
       if (ele.defaultValueExp) {
-        if (ele.value !== 0 && !ele.value) {
-          var _exp = ele.defaultValueExp.replace(/(%)(\d+)(\.*\w*)(%)/g, 'paramMap.i$2$3').replace(/(%)(\w*\.*\w*)(%)/g, 'paramMap.$2');
-          newEleMap.value = eval(_exp);
-          consoleLogWhenEnable("".concat(ele.key, ": defaultValueExp"), _exp, newEleMap.value);
+        var _exp = ele.defaultValueExp.replace(/(%)(\d+)(\.*\w*)(%)/g, 'paramMap.i$2$3').replace(/(%)(\w*\.*\w*)(%)/g, 'paramMap.$2');
+        var expValue = eval(_exp);
+        if (!['', null, undefined].includes(expValue)) {
+          newEleMap.value = expValue;
         }
+        consoleLogWhenEnable("".concat(ele.key, ": defaultValueExp"), _exp, newEleMap.value);
       }
       if (ele.underwriteExp) {
         var _exp2 = ele.underwriteExp.replace(/(%)(\d+)(\.*\w*)(%)/g, 'paramMap.i$2$3').replace(/(%)(\w*\.*\w*)(%)/g, 'paramMap.$2');
@@ -9293,11 +9301,12 @@ function executeElementRule(personData, product, ins, ele) {
     }
     if (['cmCommonInput'].includes(ele.componentName)) {
       if (ele.defaultValueExp) {
-        if (!ele.value) {
-          var _exp3 = ele.defaultValueExp.replace(/(%)(\d+)(\.*\w*)(%)/g, 'paramMap.i$2$3').replace(/(%)(\w*\.*\w*)(%)/g, 'paramMap.$2');
-          newEleMap.value = eval(_exp3);
-          consoleLogWhenEnable("".concat(ele.key, ": defaultValueExp"), _exp3, newEleMap.value);
+        var _exp3 = ele.defaultValueExp.replace(/(%)(\d+)(\.*\w*)(%)/g, 'paramMap.i$2$3').replace(/(%)(\w*\.*\w*)(%)/g, 'paramMap.$2');
+        var _expValue = eval(_exp3);
+        if (!['', null, undefined].includes(_expValue)) {
+          newEleMap.value = _expValue;
         }
+        consoleLogWhenEnable("".concat(ele.key, ": defaultValueExp"), _exp3, newEleMap.value);
       }
       if (ele.minExp) {
         var _exp4 = ele.minExp.replace(/(%)(\d+)(\.*\w*)(%)/g, 'paramMap.i$2$3').replace(/(%)(\w*\.*\w*)(%)/g, 'paramMap.$2');
@@ -9324,7 +9333,7 @@ function executeElementRule(personData, product, ins, ele) {
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2022-04-26
  * @param {IPbPersons} allPersonsData 必传。所有人员数据
- * @param {null|string} type 可不传。
+ * @param {null|string|string[]} type 可不传。
  * 不传，人员数据按原结构返回；
  * 字符串，返回指定的人员数据；
  * 数组，以数组形式，返回多个人员数据。
@@ -9693,10 +9702,10 @@ function _objectSpread$1(e) { for (var r = 1; r < arguments.length; r++) { var t
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2022-04-26
  * @param {IPbProduct} prodData 必传。产品数据（单个）
- * @param {object} productVerifyData 必传。产品校验条件（单个）
+ * @param {object} prodVerifyData 必传。产品校验条件（单个）
  * @param {IPbPersons} personData 必传。人员信息，包括被保人、投保人、投保人配偶
- * @param {object} parmas 补充参数，目前只有 planbookId
- * @returns {IPbProduct} 产品数据（单个）
+ * @param {object} [parmas] 可不传。补充参数，目前只有 planbookId
+ * @returns {Promise<IPbProduct>} 产品数据（单个）
  */
 function productDataHandler(_x, _x2, _x3, _x4) {
   return _productDataHandler.apply(this, arguments);
@@ -9704,6 +9713,7 @@ function productDataHandler(_x, _x2, _x3, _x4) {
 
 /**
  * **处理多被保人**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2024-02-28
  * @param {IPbPersons} personData 必传。人员信息，包括被保人、投保人、投保人配偶
@@ -9711,7 +9721,7 @@ function productDataHandler(_x, _x2, _x3, _x4) {
  */
 function _productDataHandler() {
   _productDataHandler = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee(prodData, prodVerifyData, personData, parmas) {
-    var productVerifyData, hasProduct, hasVerifyData, hasPersonData, personOrderList, _prodData$mulInsOrder3;
+    var productVerifyData, _parmas$eventTarget, insuranceKey, elementKey, groupInsurance, groupInsuranceIdEle, subInsurances, hasProduct, hasVerifyData, hasPersonData, personOrderList, _prodData$mulInsOrder3;
     return _regeneratorRuntime.wrap(function (_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
@@ -9738,6 +9748,29 @@ function _productDataHandler() {
         case 3:
           productVerifyData = prodVerifyData;
         case 4:
+          // 组合险种特殊处理：当用户点击组合险种的子险种选项时，将其他子险种的标题设置为未选中状态
+          if (parmas && parmas.eventTarget) {
+            _parmas$eventTarget = parmas.eventTarget, insuranceKey = _parmas$eventTarget.insuranceKey, elementKey = _parmas$eventTarget.elementKey;
+            if (insuranceKey && elementKey === 'insuranceId') {
+              groupInsurance = (prodData.mulInsOrderList || []).find(function (ins) {
+                return ins.key === insuranceKey;
+              });
+              groupInsuranceIdEle = ((groupInsurance === null || groupInsurance === void 0 ? void 0 : groupInsurance.eleOrderList) || []).find(function (e) {
+                return e.key === 'insuranceId';
+              });
+              subInsurances = (prodData.mulInsOrderList || []).filter(function (ins) {
+                return ins.groupKey === insuranceKey;
+              });
+              subInsurances.forEach(function (ins) {
+                var titleEle = (ins.eleOrderList || []).find(function (e) {
+                  return e.key === 'title';
+                });
+                if (titleEle && groupInsuranceIdEle && !Array.isArray(titleEle.value)) {
+                  titleEle.value = groupInsuranceIdEle.value === ins.key;
+                }
+              });
+            }
+          }
           hasProduct = prodData.mulInsOrderList;
           hasVerifyData = productVerifyData && Object.keys(productVerifyData).length;
           hasPersonData = personData && personData.personOrderList;
@@ -10022,6 +10055,7 @@ function multipleInsuredHandler(personData) {
 
 /**
  * 请求返回当前产品、当前条件的费率数据
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2024-02-28
  * @param {IPbProduct} prodData 必传。产品数据（单个）
@@ -10089,6 +10123,7 @@ function getSingleInsurancesVerifyData(prodData, personData) {
 
 /**
  * **多被保人，获取并缓存多个险种信息的费率信息**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2023-12-28
  * @param { any } params 必传。接口请求信息
@@ -10205,40 +10240,21 @@ function setCommonInfo(prodData) {
  * @returns {IPbProduct} 产品数据（单个）
  */
 function setGroupInsurance(prodData) {
-  if (!prodData.mulInsOrderList) {
-    return prodData;
-  }
-  var groupInsuranceList = prodData && prodData.mulInsOrderList && prodData.mulInsOrderList.filter(function (ins) {
-    return !!ins.groupKey;
-  });
-  if (!groupInsuranceList || !groupInsuranceList.length) {
-    return prodData;
-  }
-  var oldGroupInsList = prodData.mulInsOrderList.filter(function (ins) {
-    return ins.isGroup;
-  });
-  var newGroupInsMap = {};
-  //清空险种列表中的已有的险种组合
-  prodData.mulInsOrderList = prodData.mulInsOrderList.filter(function (ins) {
+  var mulInsOrderList = prodData && prodData.mulInsOrderList ? prodData.mulInsOrderList : [];
+  // 清空险种列表中的已有的险种组合
+  prodData.mulInsOrderList = mulInsOrderList.filter(function (ins) {
     return !ins.isGroup;
   });
-  groupInsuranceList.forEach(function (ins) {
-    //多险种选一，或多险种选多。生成一个组合，如多个险种合成豁免险
-    // ins.isCheckbox = true
-    var oldGroupIns = oldGroupInsList.find(function (gIns) {
-      return gIns.key === ins.groupKey;
-    });
-    var oldTitleEle = {};
-    var oldInsuranceIdEle = {};
-    if (oldGroupIns && oldGroupIns.eleOrderList) {
-      oldTitleEle = oldGroupIns.eleOrderList.find(function (e) {
-        return e.key === 'title';
-      });
-      oldInsuranceIdEle = oldGroupIns.eleOrderList.find(function (e) {
-        return e.key === 'insuranceId';
-      });
-    }
-    if (ins.groupKey) {
+
+  // 多险种选一，或多险种选多。生成一个组合，如多个险种合成豁免险
+  var groupInsuranceList = mulInsOrderList.filter(function (ins) {
+    return !!ins.groupKey;
+  });
+  if (groupInsuranceList.length) {
+    var newGroupInsMap = {};
+    groupInsuranceList.filter(function (ins) {
+      return ins.groupKey;
+    }).forEach(function (ins) {
       newGroupInsMap[ins.groupKey] = newGroupInsMap[ins.groupKey] || {
         key: ins.groupKey,
         name: ins.groupName,
@@ -10246,19 +10262,19 @@ function setGroupInsurance(prodData) {
         isGroup: true,
         eleOrderList: [{
           key: 'title',
-          value: oldTitleEle && oldTitleEle.value || false,
+          value: false,
           isDisabled: false,
           componentName: 'cmCommonTitle',
           labelName: ins.groupName
         }, {
           key: 'insuranceId',
-          value: oldInsuranceIdEle && oldInsuranceIdEle.value || (ins.isCheckbox ? [] : ''),
+          value: ins.isCheckbox ? [] : null,
           componentName: ins.isCheckbox ? 'cmCommonCheckbox' : 'cmCommonRadio',
           opts: []
         }]
       };
 
-      // 当险种转换成险种组合的选项
+      // 将子险种转换成险种组合的选项
       var titleEle = ins.eleOrderList.find(function (e) {
         return e.key === 'title';
       });
@@ -10271,119 +10287,73 @@ function setGroupInsurance(prodData) {
         desc: titleEle.labelName,
         isDisabled: titleEle.isDisabled
       });
-    }
-  });
-
-  // 处理组合险中的逻辑，并加入到产品险种列表中
-  var _loop = function _loop(k) {
-    var nGroupTitle = newGroupInsMap[k].eleOrderList.find(function (e) {
-      return e.key === 'title';
-    });
-    var nGroupInsuranceId = newGroupInsMap[k].eleOrderList.find(function (e) {
-      return e.key === 'insuranceId';
     });
-    if (nGroupTitle && nGroupInsuranceId) {
-      if (nGroupInsuranceId.opts && nGroupInsuranceId.opts.length) {
-        // 所有险种都不可选，则组合险不可修改且不选中。否则，组合险种可选
-        if (nGroupInsuranceId.opts.every(function (opt) {
-          return !!opt.isDisabled;
-        })) {
-          nGroupTitle.value = false;
-          nGroupTitle.isDisabled = true;
-        } else {
-          nGroupTitle.isDisabled = false;
-        }
-      }
-      var groupInsList = prodData.mulInsOrderList.filter(function (ins) {
+
+    // 处理组合险中的逻辑，并加入到产品险种列表中
+    var _loop = function _loop(k) {
+      var nGroupTitleEle = newGroupInsMap[k].eleOrderList.find(function (e) {
+        return e.key === 'title';
+      });
+      var nGroupInsuranceIdEle = newGroupInsMap[k].eleOrderList.find(function (e) {
+        return e.key === 'insuranceId';
+      });
+      var groupInsList = mulInsOrderList.filter(function (ins) {
         return ins.groupKey == k;
       });
-      if (groupInsList && groupInsList.length) {
-        // 如果组合险中有一款是必选的，则整个组合险为选中状态
-        if (groupInsList.some(function (ins) {
-          var subTitle = ins.eleOrderList.find(function (e) {
-            return e.key === 'title';
-          });
-          return ins.required && subTitle && !subTitle.isDisabled;
-        })) {
-          nGroupTitle.value = true;
-          nGroupTitle.isDisabled = true;
-        }
-
-        // 初始化时，设置组合险默认值
+      if (nGroupTitleEle && nGroupInsuranceIdEle && groupInsList.length) {
         var notDisabledInsurances = groupInsList.filter(function (ins) {
-          var subTitle = ins.eleOrderList.find(function (e) {
+          var titleEle = (ins.eleOrderList || []).find(function (e) {
             return e.key === 'title';
           });
-          return subTitle && !subTitle.isDisabled;
+          return titleEle && !titleEle.isDisabled;
         });
-        var checkedInsurances = notDisabledInsurances.find(function (ins) {
-          var subTitle = ins.eleOrderList.find(function (e) {
-            return e.key === 'title';
+        var checkedInsurances = notDisabledInsurances.filter(function (ins) {
+          var titleEle = (ins.eleOrderList || []).find(function (ele) {
+            return ele.key === 'title';
           });
-          return subTitle && subTitle.value;
+          return titleEle && titleEle.value;
         });
-        if (!nGroupInsuranceId.value) {
-          if (checkedInsurances) {
-            nGroupInsuranceId.value = checkedInsurances.key;
-            nGroupTitle.value = true;
-          } else if (nGroupTitle.value) {
-            if (notDisabledInsurances[0]) {
-              nGroupInsuranceId.value = notDisabledInsurances[0].key;
-            }
-          }
-        }
-      }
-    }
-    if (nGroupInsuranceId) {
-      if (nGroupInsuranceId.value) {
-        if (nGroupInsuranceId.value.constructor === Array) {
-          if (nGroupInsuranceId.opts) {
-            nGroupInsuranceId.opts = nGroupInsuranceId.opts.filter(function (opt) {
-              return nGroupInsuranceId.value.indexOf(opt.val) !== -1 && !opt.isDisabled;
-            });
-          }
-        } else {
-          var opt = nGroupInsuranceId.opts.find(function (o) {
-            return o.val === nGroupInsuranceId.value;
-          });
-          if (opt && opt.isDisabled) {
-            nGroupInsuranceId.value = '';
-          }
-        }
-      }
-      if (nGroupInsuranceId.value) {
-        var checkedIns = prodData.mulInsOrderList.find(function (ins) {
-          return ins.key === nGroupInsuranceId.value;
+        var hasRequiredIns = notDisabledInsurances.some(function (ins) {
+          return ins.required;
         });
-        if (checkedIns) {
-          //将当前选中险种的部分数据复制到组合险中
-          for (var ck in checkedIns) {
-            if (!['code', 'groupKey', 'groupName', 'isFollowing', 'key', 'name', 'accountData', 'reduceBaofData', 'duplicateReduceBaofData'].includes(ck)) {
-              // 定义组件险中的元素：自身eleOrderList + 所选险种的eleOrderList（不包含标题）
+        var checkedInsurance = checkedInsurances[0];
+        // hasRequiredIns：如果组合险中有一款是必选的，则整个组合险为选中状态
+        // 所有险种都不可选，则组合险不可修改且不选中。否则，组合险种可选
+        nGroupTitleEle.value = hasRequiredIns || (nGroupInsuranceIdEle.opts || []).some(function (opt) {
+          return !opt.isDisabled;
+        });
+        nGroupTitleEle.isDisabled = hasRequiredIns || (nGroupInsuranceIdEle.opts || []).every(function (opt) {
+          return !!opt.isDisabled;
+        });
+        nGroupInsuranceIdEle.value = checkedInsurance ? checkedInsurance.key : null;
+
+        //将当前选中险种的部分数据复制到组合险中
+        if (checkedInsurance) {
+          // 定义组件险中的元素：自身eleOrderList + 所选险种的eleOrderList（不包含标题）
+          var keys = ['code', 'groupKey', 'groupName', 'isFollowing', 'key', 'name', 'accountData', 'reduceBaofData', 'duplicateReduceBaofData'];
+          for (var ck in checkedInsurance) {
+            if (!keys.includes(ck)) {
               if (ck === 'eleOrderList') {
-                newGroupInsMap[k][ck] = newGroupInsMap[k][ck].concat(checkedIns[ck].filter(function (ele) {
+                newGroupInsMap[k][ck] = newGroupInsMap[k][ck].concat(checkedInsurance[ck].filter(function (ele) {
                   return ele.key !== 'title';
                 }));
               } else {
-                newGroupInsMap[k][ck] = checkedIns[ck];
+                newGroupInsMap[k][ck] = checkedInsurance[ck];
               }
             }
           }
         }
       }
-    }
-    var index = -1;
-    prodData.mulInsOrderList.forEach(function (ins, i) {
-      if (ins.groupKey === k) {
-        index = i;
+      var index = mulInsOrderList.findLastIndex(function (ins) {
+        return ins.groupKey === k;
+      });
+      if (index >= 0) {
+        prodData.mulInsOrderList.splice(index + 1, 0, newGroupInsMap[k]);
       }
-    });
-    if (index >= 0) {
-      prodData.mulInsOrderList.splice(index + 1, 0, newGroupInsMap[k]);
+    };
+    for (var k in newGroupInsMap) {
+      _loop(k);
     }
-  };
-  for (var k in newGroupInsMap) {
-    _loop(k);
   }
   return prodData;
 }
@@ -10658,7 +10628,7 @@ function convertProductData(prodData) {
     if (insuranceData.title && !insuranceData.groupKey) {
       if (insuranceData.isGroup) {
         //组合险，则遍历其所选中的险种，并转换数据
-        var insuranceId = insuranceData.insuranceId.constructor == Array ? insuranceData.insuranceId : [insuranceData.insuranceId];
+        var insuranceId = Array.isArray(insuranceData.insuranceId) ? insuranceData.insuranceId : [insuranceData.insuranceId];
         insuranceId.forEach(function (insId) {
           var checkedIns = prodData.mulInsOrderList.find(function (p) {
             return p.key === insId;
@@ -10877,7 +10847,7 @@ function createdProductDataToCalc(inputData) {
       productForm.mulInsOrderList = productForm.mulInsOrderList.map(function (ins) {
         var tempIns = {};
         for (var _k2 in ins) {
-          if (!['isFollowing', 'pPeriodDesc', 'baoeDesc', 'baofDesc', 'iDurationDesc', 'accountData', 'reduceBaofData', 'duplicateReduceBaofData', 'isCheckbox', 'groupKey', 'groupName'].includes(_k2)) {
+          if (!['isFollowing', 'pPeriodDesc', 'baoeDesc', 'baofDesc', 'iDurationDesc', 'accountData', 'reduceBaofData', 'duplicateReduceBaofData', 'isCheckbox', 'groupKey', 'groupName', 'customVariableExp', 'calcResultExp', 'revalidateFlag'].includes(_k2)) {
             tempIns[_k2] = ins[_k2];
           }
         }
@@ -11991,7 +11961,7 @@ var BxtProductInfo = (_dec = Component({
     value: function () {
       var _changeProduct = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee3(productData, options) {
         var _this5 = this;
-        var $listeners, inputData, verifyData, personData, groupKey, productKey, params, type, insData, eleData, planbookId, publicPbUuid, productVerifyData, errorMsg, hasRevalidateFlag;
+        var $listeners, inputData, verifyData, personData, groupKey, productKey, params, type, insData, eleData, planbookId, publicPbUuid, productVerifyData, eventTarget, errorMsg, hasRevalidateFlag;
         return _regeneratorRuntime.wrap(function (_context3) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
@@ -12000,12 +11970,18 @@ var BxtProductInfo = (_dec = Component({
               planbookId = get(params, 'planbookId');
               publicPbUuid = get(params, 'publicPbUuid');
               productVerifyData = get(verifyData, "[".concat(productKey, "]"));
+              eventTarget = {
+                insuranceKey: get(insData, 'key') || null,
+                insuranceCode: get(insData, 'code') || null,
+                elementKey: get(eleData, 'key') || null
+              };
               if (type === 'change') {
                 clearAddAndTakeAndAdjustBaoeData(productData);
               }
               _context3.next = 1;
               return productDataHandler(productData, productVerifyData, personData, {
-                planbookId: planbookId
+                planbookId: planbookId,
+                eventTarget: eventTarget
               });
             case 1:
               if (type === 'change') {
@@ -12037,7 +12013,8 @@ var BxtProductInfo = (_dec = Component({
                   publicPbUuid: publicPbUuid,
                   groupKey: groupKey,
                   productKey: productKey,
-                  isIgnoreError: true
+                  isIgnoreError: true,
+                  eventTarget: eventTarget
                 }, resolve, reject);
               }).catch(function (err) {
                 errorMsg = get(err, '[0].message') || get(err, 'message');
@@ -12045,7 +12022,8 @@ var BxtProductInfo = (_dec = Component({
             case 2:
               _context3.next = 3;
               return productDataHandler(productData, productVerifyData, personData, {
-                planbookId: planbookId
+                planbookId: planbookId,
+                eventTarget: eventTarget
               });
             case 3:
               return _context3.abrupt("return", errorMsg);
@@ -12614,6 +12592,12 @@ var __vue_render__ = function __vue_render__() {
               insData: ins,
               eleData: ele
             });
+          },
+          "clear": function clear($event) {
+            return _vm.onChange({
+              insData: ins,
+              eleData: ele
+            });
           }
         },
         scopedSlots: _vm._u([!ele.isDisabled ? {

package/es/share-sheet/index.js

@@ -47,10 +47,21 @@ function _defineProperty(e, r, t) {
 document && document.cookie && document.cookie.match('ENABLE_LIZHAO_DEBUG=1');
 
 /**
- * 截取指定字数字符串
- * @param str 
- * @param n 
- * @returns 
+ * **截取字符串到指定字数**
+ * - 中文字符（及非 `[0-9a-z.()]` 的字符）计为 1 个字符
+ * - 数字、小写字母及 `.()` 计为 0.5 个字符
+ * - 超出长度时，截取前 n-2 个字符并追加 `...`
+ * @author Lizhao <lz@winbaoxian.com>
+ * @date 2024-09-10
+ * @param {string} str 必传。需要截取的字符串
+ * @param {number} n 必传。最大字符数（需大于 2）
+ * @returns {string} 截取后的字符串
+ * @example
+ * textOverflowEllipsis('你好world', 4)
+ * // returns 你好...
+ *
+ * textOverflowEllipsis('hello world', 4)
+ * // returns hello world
  */
 function textOverflowEllipsis(str, n) {
   var text = String(str);
@@ -8499,6 +8510,7 @@ function getUrlParams(url) {
 
 /**
  * **多被保人，获取并缓存多个险种信息的费率信息**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2023-12-28
  * @param { any } params 必传。接口请求信息