@zwa73/utils 1.0.93 → 1.0.96

package/dist/QuickFunction.d.ts

@@ -1,2 +1,2 @@
 import { UtilFunc } from "./UtilFunctions";
-export declare const outcome: typeof UtilFunc.outcome, matchProc: typeof UtilFunc.matchProc, sucesProc: typeof UtilFunc.sucesProc, isFailed: typeof UtilFunc.isFailed, isSafeNumber: typeof UtilFunc.isSafeNumber, isSuccess: typeof UtilFunc.isSuccess, likeNone: typeof UtilFunc.likeNone, expect: typeof UtilFunc.expect, assertType: typeof UtilFunc.assertType, assertLiteral: typeof UtilFunc.assertLiteral, deepClone: typeof UtilFunc.deepClone, sleep: typeof UtilFunc.sleep, stringifyJToken: typeof UtilFunc.stringifyJToken, getTime: typeof UtilFunc.getTime, mapEntries: typeof UtilFunc.mapEntries, composeMixinable: typeof UtilFunc.composeMixinable;
+export declare const outcome: typeof UtilFunc.outcome, matchProc: typeof UtilFunc.matchProc, sucesProc: typeof UtilFunc.sucesProc, isFailed: typeof UtilFunc.isFailed, isSafeNumber: typeof UtilFunc.isSafeNumber, isSuccess: typeof UtilFunc.isSuccess, likeNone: typeof UtilFunc.likeNone, expect: typeof UtilFunc.expect, assertType: typeof UtilFunc.assertType, assertLiteral: typeof UtilFunc.assertLiteral, deepClone: typeof UtilFunc.deepClone, sleep: typeof UtilFunc.sleep, stringifyJToken: typeof UtilFunc.stringifyJToken, getTime: typeof UtilFunc.getTime, mapEntries: typeof UtilFunc.mapEntries, composeMixinable: typeof UtilFunc.composeMixinable, dedent: typeof UtilFunc.dedent;

package/dist/QuickFunction.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.composeMixinable = exports.mapEntries = exports.getTime = exports.stringifyJToken = exports.sleep = exports.deepClone = exports.assertLiteral = exports.assertType = exports.expect = exports.likeNone = exports.isSuccess = exports.isSafeNumber = exports.isFailed = exports.sucesProc = exports.matchProc = exports.outcome = void 0;
+exports.dedent = exports.composeMixinable = exports.mapEntries = exports.getTime = exports.stringifyJToken = exports.sleep = exports.deepClone = exports.assertLiteral = exports.assertType = exports.expect = exports.likeNone = exports.isSuccess = exports.isSafeNumber = exports.isFailed = exports.sucesProc = exports.matchProc = exports.outcome = void 0;
 const UtilFunctions_1 = require("./UtilFunctions");
 const UtilSymbol_1 = require("./UtilSymbol");
-exports.outcome = UtilFunctions_1.UtilFunc.outcome, exports.matchProc = UtilFunctions_1.UtilFunc.matchProc, exports.sucesProc = UtilFunctions_1.UtilFunc.sucesProc, exports.isFailed = UtilFunctions_1.UtilFunc.isFailed, exports.isSafeNumber = UtilFunctions_1.UtilFunc.isSafeNumber, exports.isSuccess = UtilFunctions_1.UtilFunc.isSuccess, exports.likeNone = UtilFunctions_1.UtilFunc.likeNone, exports.expect = UtilFunctions_1.UtilFunc.expect, exports.assertType = UtilFunctions_1.UtilFunc.assertType, exports.assertLiteral = UtilFunctions_1.UtilFunc.assertLiteral, exports.deepClone = UtilFunctions_1.UtilFunc.deepClone, exports.sleep = UtilFunctions_1.UtilFunc.sleep, exports.stringifyJToken = UtilFunctions_1.UtilFunc.stringifyJToken, exports.getTime = UtilFunctions_1.UtilFunc.getTime, exports.mapEntries = UtilFunctions_1.UtilFunc.mapEntries, exports.composeMixinable = UtilFunctions_1.UtilFunc.composeMixinable;
+exports.outcome = UtilFunctions_1.UtilFunc.outcome, exports.matchProc = UtilFunctions_1.UtilFunc.matchProc, exports.sucesProc = UtilFunctions_1.UtilFunc.sucesProc, exports.isFailed = UtilFunctions_1.UtilFunc.isFailed, exports.isSafeNumber = UtilFunctions_1.UtilFunc.isSafeNumber, exports.isSuccess = UtilFunctions_1.UtilFunc.isSuccess, exports.likeNone = UtilFunctions_1.UtilFunc.likeNone, exports.expect = UtilFunctions_1.UtilFunc.expect, exports.assertType = UtilFunctions_1.UtilFunc.assertType, exports.assertLiteral = UtilFunctions_1.UtilFunc.assertLiteral, exports.deepClone = UtilFunctions_1.UtilFunc.deepClone, exports.sleep = UtilFunctions_1.UtilFunc.sleep, exports.stringifyJToken = UtilFunctions_1.UtilFunc.stringifyJToken, exports.getTime = UtilFunctions_1.UtilFunc.getTime, exports.mapEntries = UtilFunctions_1.UtilFunc.mapEntries, exports.composeMixinable = UtilFunctions_1.UtilFunc.composeMixinable, exports.dedent = UtilFunctions_1.UtilFunc.dedent;
 if (false) {
     let aaser = (0, exports.assertLiteral)({ a: 1 });
     let a = null;

package/dist/UtilFunctions.d.ts

@@ -172,5 +172,22 @@ export declare class UtilFunc {
     static bindTo<K extends Keyable, V, B extends {} = {}>(key: LiteralCheck<K>, value: V, base?: B): keyof B extends K ? "Base中已有对应键" & Error : {
         [P in K | keyof B]: P extends K ? V : P extends keyof B ? B[P] : never;
     };
+    /**移除多行字符串中每行开始的最小空格数。
+     *
+     * @param strings - 需要处理的多行字符串模板。
+     * @param trim    - 是否移除字符串开始和结束的空格。
+     * @returns - 返回处理后的字符串，每行开始的空格数已被最小化。
+     *
+     * @example
+     * const str = dedent`
+     *     Hello,
+     *         World!
+     * `;
+     * console.log(str);
+     * // 输出：
+     * // Hello,
+     * //     World!
+     */
+    static dedent(strings: TemplateStringsArray, trim?: boolean): string;
 }
 export {};

package/dist/UtilFunctions.js

@@ -494,6 +494,29 @@ class UtilFunc {
         out[key] = value;
         return out;
     }
+    /**移除多行字符串中每行开始的最小空格数。
+     *
+     * @param strings - 需要处理的多行字符串模板。
+     * @param trim    - 是否移除字符串开始和结束的空格。
+     * @returns - 返回处理后的字符串，每行开始的空格数已被最小化。
+     *
+     * @example
+     * const str = dedent`
+     *     Hello,
+     *         World!
+     * `;
+     * console.log(str);
+     * // 输出：
+     * // Hello,
+     * //     World!
+     */
+    static dedent(strings, trim = true) {
+        const str = strings.join('');
+        const lines = str.split('\n');
+        const minIndent = Math.min(...lines.filter(line => line.trim() !== '').map(line => line.search(/\S/)));
+        const result = lines.map(line => line.slice(minIndent)).join('\n');
+        return trim ? result.trim() : result;
+    }
 }
 exports.UtilFunc = UtilFunc;
 __decorate([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zwa73/utils",
-  "version": "1.0.93",
+  "version": "1.0.96",
   "description": "my utils",
   "main": "index.js",
   "scripts": {

package/src/QuickFunction.ts

@@ -18,7 +18,8 @@ export const {
     stringifyJToken,
     getTime,
     mapEntries,
-    composeMixinable
+    composeMixinable,
+    dedent,
 } = UtilFunc;
 
 if(false){

package/src/UtilFunctions.ts

@@ -559,5 +559,30 @@ static bindTo<K extends Keyable, V, B extends {} = {}>
     out[key]=value;
     return out;
 }
+/**移除多行字符串中每行开始的最小空格数。
+ *
+ * @param strings - 需要处理的多行字符串模板。
+ * @param trim    - 是否移除字符串开始和结束的空格。
+ * @returns - 返回处理后的字符串，每行开始的空格数已被最小化。
+ *
+ * @example
+ * const str = dedent`
+ *     Hello,
+ *         World!
+ * `;
+ * console.log(str);
+ * // 输出：
+ * // Hello,
+ * //     World!
+ */
+static dedent(strings: TemplateStringsArray, trim = true): string {
+    const str = strings.join('');
+    const lines = str.split('\n');
+    const minIndent = Math.min(
+        ...lines.filter(line => line.trim() !== '').map(line => line.search(/\S/))
+    );
+    const result = lines.map(line => line.slice(minIndent)).join('\n');
+    return trim ? result.trim() : result;
+}
 
 }