xjs-common 13.0.2 → 13.0.3

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-obj.js

@@ -71,4 +71,13 @@ var UObj;
         return o;
     }
     UObj.manipulateProperties = manipulateProperties;
+    /**
+     * generate a record object which contains spedified 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/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-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 spedified 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 spedified 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/package.json

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