bxs-tools-ui 3.2.0-1 → 3.2.0-2

package/es/add-and-take/index.js

@@ -8624,11 +8624,20 @@ var PURPOSE_OPTIONS = [{
 document && document.cookie && document.cookie.match('ENABLE_LIZHAO_DEBUG=1');
 
 /**
- * 将数值转换为千分位
+ * **将数值转换为千分位格式的字符串**
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2024-09-10
- * @param {*} n 数值
- * @returns 千分位字符串
+ * @param {number|string} n 必传。需要转换的数值
+ * @returns {string} 千分位字符串；空值返回空字符串；非数值返回原值
+ * @example
+ * formatNumberToThousand(1234567)
+ * // returns '1,234,567'
+ *
+ * formatNumberToThousand(0)
+ * // returns '0'
+ *
+ * formatNumberToThousand(null)
+ * // returns ''
  */
 function formatNumberToThousand(n) {
   if (n !== 0 && !n) {
@@ -8643,6 +8652,7 @@ function formatNumberToThousand(n) {
 
 /**
  * **多被保人，获取并缓存多个险种信息的费率信息**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2023-12-28
  * @param { any } params 必传。接口请求信息

package/es/adjust-baoe/index.js

@@ -565,7 +565,7 @@ function deepCopy(obj) {
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2022-04-26
  * @param {IPbPersons} allPersonsData 必传。所有人员数据
- * @param {null|string} type 可不传。
+ * @param {null|string|string[]} type 可不传。
  * 不传，人员数据按原结构返回；
  * 字符串，返回指定的人员数据；
  * 数组，以数组形式，返回多个人员数据。
@@ -9047,6 +9047,7 @@ function _objectSpread$1(e) { for (var r = 1; r < arguments.length; r++) { var t
 
 /**
  * **多被保人，获取并缓存多个险种信息的费率信息**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2023-12-28
  * @param { any } params 必传。接口请求信息

package/es/index.js

@@ -8754,7 +8754,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
@@ -8786,7 +8786,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
@@ -8844,7 +8844,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
@@ -8868,11 +8868,20 @@ function getAgeFromBirth(birth, cDate) {
 }
 
 /**
- * 将数值转换为千分位
+ * **将数值转换为千分位格式的字符串**
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2024-09-10
- * @param {*} n 数值
- * @returns 千分位字符串
+ * @param {number|string} n 必传。需要转换的数值
+ * @returns {string} 千分位字符串；空值返回空字符串；非数值返回原值
+ * @example
+ * formatNumberToThousand(1234567)
+ * // returns '1,234,567'
+ *
+ * formatNumberToThousand(0)
+ * // returns '0'
+ *
+ * formatNumberToThousand(null)
+ * // returns ''
  */
 function formatNumberToThousand(n) {
   if (n !== 0 && !n) {
@@ -8886,10 +8895,21 @@ function formatNumberToThousand(n) {
 }
 
 /**
- * 截取指定字数字符串
- * @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);
@@ -9014,11 +9034,12 @@ function executeElementRule(personData, product, ins, ele) {
     }
     if (['cmCommonSelect', 'cmCommonRadioBtn', 'cmCommonRadio', 'cmCommonCheckbox'].includes(ele.componentName)) {
       if (ele.defaultValueExp) {
-        if (ele.value !== 0 && !ele.value && paramMap.t.elementKey !== ele.key) {
-          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');
@@ -9046,11 +9067,12 @@ function executeElementRule(personData, product, ins, ele) {
     }
     if (['cmCommonInput'].includes(ele.componentName)) {
       if (ele.defaultValueExp) {
-        if (ele.value !== 0 && !ele.value && paramMap.t.elementKey !== ele.key) {
-          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');
@@ -9447,7 +9469,7 @@ function setPersonAgeOptions(personData) {
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2022-04-26
  * @param {IPbPersons} allPersonsData 必传。所有人员数据
- * @param {null|string} type 可不传。
+ * @param {null|string|string[]} type 可不传。
  * 不传，人员数据按原结构返回；
  * 字符串，返回指定的人员数据；
  * 数组，以数组形式，返回多个人员数据。
@@ -9968,10 +9990,10 @@ function initProductData(prodData) {
  * @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);
@@ -9979,6 +10001,7 @@ function productDataHandler(_x, _x2, _x3, _x4) {
 
 /**
  * **处理多被保人**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2024-02-28
  * @param {IPbPersons} personData 必传。人员信息，包括被保人、投保人、投保人配偶
@@ -10320,6 +10343,7 @@ function multipleInsuredHandler(personData) {
 
 /**
  * 请求返回当前产品、当前条件的费率数据
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2024-02-28
  * @param {IPbProduct} prodData 必传。产品数据（单个）
@@ -10387,6 +10411,7 @@ function getSingleInsurancesVerifyData(prodData, personData) {
 
 /**
  * **多被保人，获取并缓存多个险种信息的费率信息**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2023-12-28
  * @param { any } params 必传。接口请求信息
@@ -48310,7 +48335,7 @@ if (typeof window !== 'undefined' && window.Vue) {
   install(window.Vue);
 }
 const index = {
-  version: '3.2.0-1',
+  version: '3.2.0-2',
   install: install
 };
 

package/es/insure-calculate/index.js

@@ -37353,6 +37353,7 @@ document && document.cookie && document.cookie.match('ENABLE_LIZHAO_DEBUG=1');
 
 /**
  * **多被保人，获取并缓存多个险种信息的费率信息**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2023-12-28
  * @param { any } params 必传。接口请求信息

package/es/person-info/index.js

@@ -1041,7 +1041,7 @@ function getHuomianPeriodValue() {
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2022-04-25
  * @param {number} value 必传
- * @returns {string} 单位为万的字符串
+ * @returns {number|string} 满足条件时返回单位为万的字符串，否则返回原数值
  * @example
  * converUnit10000(1000)
  * // returns 1000
@@ -1099,7 +1099,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
@@ -1232,11 +1232,12 @@ function executeElementRule(personData, product, ins, ele) {
     }
     if (['cmCommonSelect', 'cmCommonRadioBtn', 'cmCommonRadio', 'cmCommonCheckbox'].includes(ele.componentName)) {
       if (ele.defaultValueExp) {
-        if (ele.value !== 0 && !ele.value && paramMap.t.elementKey !== ele.key) {
-          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');
@@ -1264,11 +1265,12 @@ function executeElementRule(personData, product, ins, ele) {
     }
     if (['cmCommonInput'].includes(ele.componentName)) {
       if (ele.defaultValueExp) {
-        if (ele.value !== 0 && !ele.value && paramMap.t.elementKey !== ele.key) {
-          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');
@@ -1438,7 +1440,7 @@ function setPersonAgeOptions(personData) {
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2022-04-26
  * @param {IPbPersons} allPersonsData 必传。所有人员数据
- * @param {null|string} type 可不传。
+ * @param {null|string|string[]} type 可不传。
  * 不传，人员数据按原结构返回；
  * 字符串，返回指定的人员数据；
  * 数组，以数组形式，返回多个人员数据。
@@ -9726,10 +9728,10 @@ function _objectSpread(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);
@@ -9737,6 +9739,7 @@ function productDataHandler(_x, _x2, _x3, _x4) {
 
 /**
  * **处理多被保人**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2024-02-28
  * @param {IPbPersons} personData 必传。人员信息，包括被保人、投保人、投保人配偶
@@ -10078,6 +10081,7 @@ function multipleInsuredHandler(personData) {
 
 /**
  * 请求返回当前产品、当前条件的费率数据
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2024-02-28
  * @param {IPbProduct} prodData 必传。产品数据（单个）
@@ -10145,6 +10149,7 @@ function getSingleInsurancesVerifyData(prodData, personData) {
 
 /**
  * **多被保人，获取并缓存多个险种信息的费率信息**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2023-12-28
  * @param { any } params 必传。接口请求信息

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
@@ -9268,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 && paramMap.t.elementKey !== ele.key) {
-          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');
@@ -9300,11 +9301,12 @@ function executeElementRule(personData, product, ins, ele) {
     }
     if (['cmCommonInput'].includes(ele.componentName)) {
       if (ele.defaultValueExp) {
-        if (ele.value !== 0 && !ele.value && paramMap.t.elementKey !== ele.key) {
-          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');
@@ -9331,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 可不传。
  * 不传，人员数据按原结构返回；
  * 字符串，返回指定的人员数据；
  * 数组，以数组形式，返回多个人员数据。
@@ -9700,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);
@@ -9711,6 +9713,7 @@ function productDataHandler(_x, _x2, _x3, _x4) {
 
 /**
  * **处理多被保人**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2024-02-28
  * @param {IPbPersons} personData 必传。人员信息，包括被保人、投保人、投保人配偶
@@ -10052,6 +10055,7 @@ function multipleInsuredHandler(personData) {
 
 /**
  * 请求返回当前产品、当前条件的费率数据
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2024-02-28
  * @param {IPbProduct} prodData 必传。产品数据（单个）
@@ -10119,6 +10123,7 @@ function getSingleInsurancesVerifyData(prodData, personData) {
 
 /**
  * **多被保人，获取并缓存多个险种信息的费率信息**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2023-12-28
  * @param { any } params 必传。接口请求信息

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 必传。接口请求信息

package/es/utils/index.js

@@ -135,7 +135,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
@@ -167,7 +167,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
@@ -225,7 +225,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
@@ -249,11 +249,20 @@ function getAgeFromBirth(birth, cDate) {
 }
 
 /**
- * 将数值转换为千分位
+ * **将数值转换为千分位格式的字符串**
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2024-09-10
- * @param {*} n 数值
- * @returns 千分位字符串
+ * @param {number|string} n 必传。需要转换的数值
+ * @returns {string} 千分位字符串；空值返回空字符串；非数值返回原值
+ * @example
+ * formatNumberToThousand(1234567)
+ * // returns '1,234,567'
+ *
+ * formatNumberToThousand(0)
+ * // returns '0'
+ *
+ * formatNumberToThousand(null)
+ * // returns ''
  */
 function formatNumberToThousand(n) {
   if (n !== 0 && !n) {
@@ -267,10 +276,21 @@ function formatNumberToThousand(n) {
 }
 
 /**
- * 截取指定字数字符串
- * @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);
@@ -395,11 +415,12 @@ function executeElementRule(personData, product, ins, ele) {
     }
     if (['cmCommonSelect', 'cmCommonRadioBtn', 'cmCommonRadio', 'cmCommonCheckbox'].includes(ele.componentName)) {
       if (ele.defaultValueExp) {
-        if (ele.value !== 0 && !ele.value && paramMap.t.elementKey !== ele.key) {
-          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');
@@ -427,11 +448,12 @@ function executeElementRule(personData, product, ins, ele) {
     }
     if (['cmCommonInput'].includes(ele.componentName)) {
       if (ele.defaultValueExp) {
-        if (ele.value !== 0 && !ele.value && paramMap.t.elementKey !== ele.key) {
-          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');
@@ -828,7 +850,7 @@ function setPersonAgeOptions(personData) {
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2022-04-26
  * @param {IPbPersons} allPersonsData 必传。所有人员数据
- * @param {null|string} type 可不传。
+ * @param {null|string|string[]} type 可不传。
  * 不传，人员数据按原结构返回；
  * 字符串，返回指定的人员数据；
  * 数组，以数组形式，返回多个人员数据。
@@ -9833,10 +9855,10 @@ function initProductData(prodData) {
  * @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);
@@ -9844,6 +9866,7 @@ function productDataHandler(_x, _x2, _x3, _x4) {
 
 /**
  * **处理多被保人**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2024-02-28
  * @param {IPbPersons} personData 必传。人员信息，包括被保人、投保人、投保人配偶
@@ -10185,6 +10208,7 @@ function multipleInsuredHandler(personData) {
 
 /**
  * 请求返回当前产品、当前条件的费率数据
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2024-02-28
  * @param {IPbProduct} prodData 必传。产品数据（单个）
@@ -10252,6 +10276,7 @@ function getSingleInsurancesVerifyData(prodData, personData) {
 
 /**
  * **多被保人，获取并缓存多个险种信息的费率信息**
+ * @ignore
  * @author Lizhao <lz@winbaoxian.com>
  * @date 2023-12-28
  * @param { any } params 必传。接口请求信息

package/lib/add-and-take/index.js

@@ -8618,11 +8618,20 @@
   document && document.cookie && document.cookie.match('ENABLE_LIZHAO_DEBUG=1');
 
   /**
-   * 将数值转换为千分位
+   * **将数值转换为千分位格式的字符串**
    * @author Lizhao <lz@winbaoxian.com>
    * @date 2024-09-10
-   * @param {*} n 数值
-   * @returns 千分位字符串
+   * @param {number|string} n 必传。需要转换的数值
+   * @returns {string} 千分位字符串；空值返回空字符串；非数值返回原值
+   * @example
+   * formatNumberToThousand(1234567)
+   * // returns '1,234,567'
+   *
+   * formatNumberToThousand(0)
+   * // returns '0'
+   *
+   * formatNumberToThousand(null)
+   * // returns ''
    */
   function formatNumberToThousand(n) {
     if (n !== 0 && !n) {
@@ -8637,6 +8646,7 @@
 
   /**
    * **多被保人，获取并缓存多个险种信息的费率信息**
+   * @ignore
    * @author Lizhao <lz@winbaoxian.com>
    * @date 2023-12-28
    * @param { any } params 必传。接口请求信息