xjs-common 13.0.2 → 13.1.0

package/build/cjs/func/decorator/d-type.js

@@ -41,7 +41,7 @@ var DType;
     DType.required = required;
     /**
      * express array.
-     * @param elmDesc {@link TypeDesc} or class constructor type.
+     * @param elmDesc {@link TypeDesc} or {@link Ctor|class constructor type}.
      */
     function array(elmDesc = {}) {
         return (target, propKey) => setDesc(target, propKey, (td) => u_type_1.UType.isFunction(elmDesc) ? td.ary = { cls: elmDesc } : td.ary = elmDesc);
@@ -49,7 +49,7 @@ var DType;
     DType.array = array;
     /**
      * express record object. note that this may allow array type because array is essentialy object type has properties.
-     * @param elmDesc {@link TypeDesc} or class constructor type.
+     * @param elmDesc {@link TypeDesc} or {@link Ctor|class constructor type}.
      */
     function record(elmDesc = {}) {
         return (target, propKey) => setDesc(target, propKey, (td) => u_type_1.UType.isFunction(elmDesc) ? td.rcd = { cls: elmDesc } : td.rcd = elmDesc);
@@ -57,7 +57,7 @@ var DType;
     DType.record = record;
     /**
      * express an object which has properties that specified class express with {@link DType}.
-     * @param ctor class constructor type.
+     * @param ctor {@link Ctor|class constructor type}.
      */
     function object(ctor) {
         return (target, propKey) => setDesc(target, propKey, (td) => td.cls = ctor);

package/build/cjs/func/decorator/transaction.js

@@ -5,7 +5,7 @@ const xjs_err_1 = require("../../obj/xjs-err");
 const u_1 = require("../u");
 const s_errCode = 100;
 /**
- * applies transation to the method. note that the method must return a Promise.
+ * applies transation to the method. **note that the method must return a `Promise`**.
  * @param op.timeoutSec default is `30`.
  */
 function transaction(op) {

package/build/cjs/func/u-array.js

@@ -39,6 +39,27 @@ var UArray;
         return result;
     }
     UArray.distinct = distinct;
+    function duplicate(array, op) {
+        if (!array || array.length === 0)
+            return [];
+        if (op?.k)
+            return Array.from((0, u_1.array2map)(array, e => e[op.k]).values()).filter(a => a.length > 1).flatMap(a => a);
+        const a = [...array], result = [];
+        const p = op?.predicate ?? ((v1, v2) => v1 == v2);
+        while (a.length > 0) {
+            const e = a.pop();
+            let dup = [];
+            for (let i = a.length - 1, e2 = a[i]; i >= 0; i--, e2 = a[i])
+                if (p(e, e2)) {
+                    a.splice(i, 1);
+                    dup.push(e2);
+                }
+            if (dup.length > 0)
+                result.push(...dup, e);
+        }
+        return result;
+    }
+    UArray.duplicate = duplicate;
     function chop(array, len) {
         return [...Array(Math.ceil(array.length / len)).keys()]
             .map(i => {

package/build/cjs/func/u-obj.js

@@ -71,4 +71,13 @@ var UObj;
         return o;
     }
     UObj.manipulateProperties = manipulateProperties;
+    /**
+     * generate a record object which contains specified keys with values generated from value generator.
+     * @param keys keys contained in the object.
+     * @param vgen value generator.
+     */
+    function generateRecord(keys, vgen) {
+        return keys.reduce((o, k) => { o[k] = vgen(k); return o; }, {});
+    }
+    UObj.generateRecord = generateRecord;
 })(UObj || (exports.UObj = UObj = {}));

package/build/cjs/func/u.js

@@ -46,9 +46,11 @@ function retry(cb, op) {
         l.warn(e);
         return true;
     };
-    const prcs = (c) => {
-        if (c < 0)
-            throw new xjs_err_1.XjsErr(s_errCode, "failure exceeds retryable count.");
+    const prcs = (c, e) => {
+        if (c < 0) {
+            l.error("failure exceeds retryable count.");
+            throw e ?? new xjs_err_1.XjsErr(s_errCode, "failure exceeds retryable count.");
+        }
         let ret = null;
         const innerPrcs = () => {
             try {
@@ -56,7 +58,7 @@ function retry(cb, op) {
             }
             catch (e) {
                 if (handleError(e))
-                    ret = prcs(c - 1);
+                    ret = prcs(c - 1, e);
                 else
                     throw e;
             }
@@ -64,7 +66,7 @@ function retry(cb, op) {
                 return new Promise((resolve, reject) => ret.then(resolve).catch((e) => {
                     if (handleError(e))
                         try {
-                            ret = resolve(prcs(c - 1));
+                            ret = resolve(prcs(c - 1, e));
                         }
                         catch (e2) {
                             reject(e2);

package/build/esm/func/decorator/d-type.d.ts

@@ -55,17 +55,17 @@ export declare namespace DType {
     function required(target: Object, propKey: string): void;
     /**
      * express array.
-     * @param elmDesc {@link TypeDesc} or class constructor type.
+     * @param elmDesc {@link TypeDesc} or {@link Ctor|class constructor type}.
      */
     function array(elmDesc?: AnyTypeDesc | Ctor): (target: Object, propKey: string) => void;
     /**
      * express record object. note that this may allow array type because array is essentialy object type has properties.
-     * @param elmDesc {@link TypeDesc} or class constructor type.
+     * @param elmDesc {@link TypeDesc} or {@link Ctor|class constructor type}.
      */
     function record(elmDesc?: AnyTypeDesc | Ctor): (target: Object, propKey: string) => void;
     /**
      * express an object which has properties that specified class express with {@link DType}.
-     * @param ctor class constructor type.
+     * @param ctor {@link Ctor|class constructor type}.
      */
     function object(ctor: Ctor): (target: Object, propKey: string) => void;
     function keep(target: Object, propKey: string): void;

package/build/esm/func/decorator/d-type.js

@@ -38,7 +38,7 @@ export var DType;
     DType.required = required;
     /**
      * express array.
-     * @param elmDesc {@link TypeDesc} or class constructor type.
+     * @param elmDesc {@link TypeDesc} or {@link Ctor|class constructor type}.
      */
     function array(elmDesc = {}) {
         return (target, propKey) => setDesc(target, propKey, (td) => UType.isFunction(elmDesc) ? td.ary = { cls: elmDesc } : td.ary = elmDesc);
@@ -46,7 +46,7 @@ export var DType;
     DType.array = array;
     /**
      * express record object. note that this may allow array type because array is essentialy object type has properties.
-     * @param elmDesc {@link TypeDesc} or class constructor type.
+     * @param elmDesc {@link TypeDesc} or {@link Ctor|class constructor type}.
      */
     function record(elmDesc = {}) {
         return (target, propKey) => setDesc(target, propKey, (td) => UType.isFunction(elmDesc) ? td.rcd = { cls: elmDesc } : td.rcd = elmDesc);
@@ -54,7 +54,7 @@ export var DType;
     DType.record = record;
     /**
      * express an object which has properties that specified class express with {@link DType}.
-     * @param ctor class constructor type.
+     * @param ctor {@link Ctor|class constructor type}.
      */
     function object(ctor) {
         return (target, propKey) => setDesc(target, propKey, (td) => td.cls = ctor);

package/build/esm/func/decorator/transaction.d.ts

@@ -1,5 +1,5 @@
 /**
- * applies transation to the method. note that the method must return a Promise.
+ * applies transation to the method. **note that the method must return a `Promise`**.
  * @param op.timeoutSec default is `30`.
  */
 export declare function transaction(op?: {

package/build/esm/func/decorator/transaction.js

@@ -2,7 +2,7 @@ import { XjsErr } from "../../obj/xjs-err";
 import { delay } from "../u";
 const s_errCode = 100;
 /**
- * applies transation to the method. note that the method must return a Promise.
+ * applies transation to the method. **note that the method must return a `Promise`**.
  * @param op.timeoutSec default is `30`.
  */
 export function transaction(op) {

package/build/esm/func/u-array.d.ts

@@ -14,7 +14,7 @@ export declare namespace UArray {
         useStrictEqual?: boolean;
     }): boolean;
     /**
-     * returns array which is removed duplicate of elements.
+     * returns an array which is removed duplicate of elements.
      * this doesn't mutate the param.
      */
     function distinct<T>(array: T[]): T[];
@@ -27,7 +27,18 @@ export declare namespace UArray {
         takeLast?: boolean;
     }): T[];
     /**
-     * chop array to partial arrays which have specified length. the remainder is added to end of a result.
+     * returns an array which contains duplicate values of the original array.
+     * this doesn't mutate the param.
+     */
+    function duplicate<T>(array: T[]): T[];
+    function duplicate<T>(array: T[], op?: {
+        k?: keyof T;
+    }): T[];
+    function duplicate<T>(array: T[], op?: {
+        predicate?: (v1: T, v2: T) => boolean;
+    }): T[];
+    /**
+     * chop an array to partial arrays which have specified length. the remainder is added to end of a result.
      * this function has compatibility to {@link AlmostArray} like {@link Uint8Array} etc.
      */
     function chop<E>(array: E[], len: number): E[][];

package/build/esm/func/u-array.js

@@ -36,6 +36,27 @@ export var UArray;
         return result;
     }
     UArray.distinct = distinct;
+    function duplicate(array, op) {
+        if (!array || array.length === 0)
+            return [];
+        if (op?.k)
+            return Array.from(array2map(array, e => e[op.k]).values()).filter(a => a.length > 1).flatMap(a => a);
+        const a = [...array], result = [];
+        const p = op?.predicate ?? ((v1, v2) => v1 == v2);
+        while (a.length > 0) {
+            const e = a.pop();
+            let dup = [];
+            for (let i = a.length - 1, e2 = a[i]; i >= 0; i--, e2 = a[i])
+                if (p(e, e2)) {
+                    a.splice(i, 1);
+                    dup.push(e2);
+                }
+            if (dup.length > 0)
+                result.push(...dup, e);
+        }
+        return result;
+    }
+    UArray.duplicate = duplicate;
     function chop(array, len) {
         return [...Array(Math.ceil(array.length / len)).keys()]
             .map(i => {

package/build/esm/func/u-obj.d.ts

@@ -1,4 +1,4 @@
-import { Ctor, MaybeArray, NonObject, NormalRecord, Type } from "../const/types";
+import { Ctor, IndexSignature, MaybeArray, NonObject, NormalRecord, Type } from "../const/types";
 export declare namespace UObj {
     /**
      * assign properties to the object with specified property keys.
@@ -36,4 +36,10 @@ export declare namespace UObj {
         recursive?: boolean;
         targetType?: MaybeArray<Exclude<Type, "object" | "null" | "undefined">>;
     }): T;
+    /**
+     * generate a record object which contains specified keys with values generated from value generator.
+     * @param keys keys contained in the object.
+     * @param vgen value generator.
+     */
+    function generateRecord<K extends IndexSignature, V>(keys: K[], vgen: (k: K) => V): Record<K, V>;
 }

package/build/esm/func/u-obj.js

@@ -68,4 +68,13 @@ export var UObj;
         return o;
     }
     UObj.manipulateProperties = manipulateProperties;
+    /**
+     * generate a record object which contains specified keys with values generated from value generator.
+     * @param keys keys contained in the object.
+     * @param vgen value generator.
+     */
+    function generateRecord(keys, vgen) {
+        return keys.reduce((o, k) => { o[k] = vgen(k); return o; }, {});
+    }
+    UObj.generateRecord = generateRecord;
 })(UObj || (UObj = {}));

package/build/esm/func/u.js

@@ -38,9 +38,11 @@ export function retry(cb, op) {
         l.warn(e);
         return true;
     };
-    const prcs = (c) => {
-        if (c < 0)
-            throw new XjsErr(s_errCode, "failure exceeds retryable count.");
+    const prcs = (c, e) => {
+        if (c < 0) {
+            l.error("failure exceeds retryable count.");
+            throw e ?? new XjsErr(s_errCode, "failure exceeds retryable count.");
+        }
         let ret = null;
         const innerPrcs = () => {
             try {
@@ -48,7 +50,7 @@ export function retry(cb, op) {
             }
             catch (e) {
                 if (handleError(e))
-                    ret = prcs(c - 1);
+                    ret = prcs(c - 1, e);
                 else
                     throw e;
             }
@@ -56,7 +58,7 @@ export function retry(cb, op) {
                 return new Promise((resolve, reject) => ret.then(resolve).catch((e) => {
                     if (handleError(e))
                         try {
-                            ret = resolve(prcs(c - 1));
+                            ret = resolve(prcs(c - 1, e));
                         }
                         catch (e2) {
                             reject(e2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xjs-common",
-  "version": "13.0.2",
+  "version": "13.1.0",
   "description": "library modules for typescript that bundled general-purpose implementations.",
   "repository": {
     "type": "git",