xjs-common 13.3.1 → 13.5.0

package/build/cjs/func/array2.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Array2 = void 0;
+const u_type_1 = require("./u-type");
+var Array2;
+(function (Array2) {
+    function map(array, keyGen, op) {
+        const _acm = op?.accumulate ?? true;
+        const map = new Map();
+        for (const e of array) {
+            const k = keyGen(e);
+            if (map.has(k))
+                _acm && map.get(k).push(e);
+            else
+                map.set(k, _acm ? [e] : e);
+        }
+        return map;
+    }
+    Array2.map = map;
+    function record(keyOrValues, op) {
+        return keyOrValues.reduce(!!op.kgen
+            ? (o, korv) => { o[op.kgen(korv)] = korv; return o; }
+            : (o, korv) => { o[korv] = op.vgen(korv); return o; }, {});
+    }
+    Array2.record = record;
+    function sum(array) {
+        return array.map(e => u_type_1.UType.isNumber(e) ? e : Number(e)).reduce((a, b) => a + b, 0);
+    }
+    Array2.sum = sum;
+})(Array2 || (exports.Array2 = Array2 = {}));

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UArray = void 0;
+const array2_1 = require("./array2");
 const u_1 = require("./u");
 var UArray;
 (function (UArray) {
@@ -31,7 +32,7 @@ var UArray;
         if (!array || array.length === 0)
             return [];
         if (op?.k)
-            return Array.from((0, u_1.array2map)(array, e => e[op.k]).values()).map(a => op?.takeLast ? a.pop() : a.shift());
+            return Array.from(array2_1.Array2.map(array, e => e[op.k]).values()).map(a => op?.takeLast ? a.pop() : a.shift());
         const a = op?.takeLast ? [...array].reverse() : [...array];
         const p = op?.predicate ?? ((v1, v2) => v1 == v2);
         const result = [a.shift()];
@@ -43,7 +44,7 @@ var UArray;
         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);
+            return Array.from(array2_1.Array2.map(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) {

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

@@ -75,13 +75,4 @@ 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-string.js

@@ -19,8 +19,8 @@ var UString;
     /**
      * generate date time number as fixed length (depends on `unit`) string without separator charactor.
      * For example, `2025-06-08T10:15:06.366Z` is to be `20250608101506366`.
-     * @param op.date Date object refered by this. default is `new Date()`.
-     * @param op.unit time unit. default is secound.
+     * @param op.date Date object referred by this. default is `new Date()`.
+     * @param op.unit time unit. default is second.
      */
     function simpleTime(op) {
         const t = (op?.date ?? new Date()).toISOString().split(".")[0].replace(/[-T:]/g, "");

package/build/cjs/func/u.js

@@ -3,12 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getJSTDate = getJSTDate;
 exports.delay = delay;
 exports.int2array = int2array;
-exports.array2map = array2map;
 exports.retry = retry;
 const xjs_err_1 = require("../obj/xjs-err");
+const u_type_1 = require("./u-type");
 const s_errCode = 10;
 function getJSTDate(d) {
-    return new Date((d ? d.getTime() : Date.now()) + 9 * 60 * 60 * 1000);
+    const adjuster = 9 * 60 * 60 * 1000;
+    return u_type_1.UType.isNumber(d) ? new Date(d + adjuster) : new Date((d ? d.getTime() : Date.now()) + adjuster);
 }
 function delay(sec) {
     return new Promise(resolve => setTimeout(resolve, 1000 * sec));
@@ -19,18 +20,6 @@ function int2array(size) {
         throw new xjs_err_1.XjsErr(s_errCode, "size of the argument is not number.");
     return Array.from(Array(s).keys());
 }
-function array2map(array, keyGen, op) {
-    const _acm = op?.accumulate ?? true;
-    const map = new Map();
-    for (const e of array) {
-        const k = keyGen(e);
-        if (map.has(k))
-            _acm && map.get(k).push(e);
-        else
-            map.set(k, _acm ? [e] : e);
-    }
-    return map;
-}
 ;
 ;
 ;

package/build/esm/func/array2.d.ts

@@ -0,0 +1,29 @@
+import { IndexSignature } from "../const/types";
+export declare namespace Array2 {
+    /**
+     * generate `Map` object from an array.
+     * @param array source array.
+     * @param keyGen predicate which generates map keys from a value of the array.
+     * @param op.accumulate flag whether values of the map are accumulated or not if key/value from the array conflict. default is true.
+     */
+    function map<K, T>(array: T[], keyGen: (e: T) => K): Map<K, T[]>;
+    function map<K, T>(array: T[], keyGen: (e: T) => K, op: {
+        accumulate: false;
+    }): Map<K, T>;
+    function map<K, T>(array: T[], keyGen: (e: T) => K, op?: {
+        accumulate?: boolean;
+    }): Map<K, T[]>;
+    /**
+     * generate a record object which is mapped by specified keys or values with pair of the entry generated from generator.
+     * @param keyOrValues keys or values to be contained in the object.
+     * @param op.kgen key generator. if pass this, `keyOrValues` is treated as values.
+     * @param op.vgen value generator. if pass this, `keyOrValues` is treated as keys.
+     */
+    function record<K extends IndexSignature, V>(keyOrValues: K[], op: {
+        vgen: (k: K) => V;
+    }): Record<K, V>;
+    function record<K extends IndexSignature, V>(keyOrValues: V[], op: {
+        kgen: (v: V) => K;
+    }): Record<K, V>;
+    function sum(array: (number | `${number}`)[]): number;
+}

package/build/esm/func/array2.js

@@ -0,0 +1,27 @@
+import { UType } from "./u-type";
+export var Array2;
+(function (Array2) {
+    function map(array, keyGen, op) {
+        const _acm = op?.accumulate ?? true;
+        const map = new Map();
+        for (const e of array) {
+            const k = keyGen(e);
+            if (map.has(k))
+                _acm && map.get(k).push(e);
+            else
+                map.set(k, _acm ? [e] : e);
+        }
+        return map;
+    }
+    Array2.map = map;
+    function record(keyOrValues, op) {
+        return keyOrValues.reduce(!!op.kgen
+            ? (o, korv) => { o[op.kgen(korv)] = korv; return o; }
+            : (o, korv) => { o[korv] = op.vgen(korv); return o; }, {});
+    }
+    Array2.record = record;
+    function sum(array) {
+        return array.map(e => UType.isNumber(e) ? e : Number(e)).reduce((a, b) => a + b, 0);
+    }
+    Array2.sum = sum;
+})(Array2 || (Array2 = {}));

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

@@ -1,4 +1,5 @@
-import { array2map, int2array } from "./u";
+import { Array2 } from "./array2";
+import { int2array } from "./u";
 export var UArray;
 (function (UArray) {
     /**
@@ -28,7 +29,7 @@ export var UArray;
         if (!array || array.length === 0)
             return [];
         if (op?.k)
-            return Array.from(array2map(array, e => e[op.k]).values()).map(a => op?.takeLast ? a.pop() : a.shift());
+            return Array.from(Array2.map(array, e => e[op.k]).values()).map(a => op?.takeLast ? a.pop() : a.shift());
         const a = op?.takeLast ? [...array].reverse() : [...array];
         const p = op?.predicate ?? ((v1, v2) => v1 == v2);
         const result = [a.shift()];
@@ -40,7 +41,7 @@ export var UArray;
         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);
+            return Array.from(Array2.map(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) {

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

@@ -44,10 +44,4 @@ 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

@@ -72,13 +72,4 @@ 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-string.d.ts

@@ -5,8 +5,8 @@ export declare namespace UString {
     /**
      * generate date time number as fixed length (depends on `unit`) string without separator charactor.
      * For example, `2025-06-08T10:15:06.366Z` is to be `20250608101506366`.
-     * @param op.date Date object refered by this. default is `new Date()`.
-     * @param op.unit time unit. default is secound.
+     * @param op.date Date object referred by this. default is `new Date()`.
+     * @param op.unit time unit. default is second.
      */
     function simpleTime(op?: {
         date?: Date;

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

@@ -16,8 +16,8 @@ export var UString;
     /**
      * generate date time number as fixed length (depends on `unit`) string without separator charactor.
      * For example, `2025-06-08T10:15:06.366Z` is to be `20250608101506366`.
-     * @param op.date Date object refered by this. default is `new Date()`.
-     * @param op.unit time unit. default is secound.
+     * @param op.date Date object referred by this. default is `new Date()`.
+     * @param op.unit time unit. default is second.
      */
     function simpleTime(op) {
         const t = (op?.date ?? new Date()).toISOString().split(".")[0].replace(/[-T:]/g, "");

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

@@ -1,20 +1,7 @@
 import { Loggable, MaybePromise } from "../const/types";
-export declare function getJSTDate(d?: Date): Date;
+export declare function getJSTDate(d?: Date | number): Date;
 export declare function delay(sec: number): Promise<void>;
 export declare function int2array(size: number): number[];
-/**
- * generate `Map` object from an array.
- * @param array source array.
- * @param keyGen predicate which generates map keys from a value of the array.
- * @param op.accumulate flag whether values of the map are accumulated or not if key/value from the array conflict. default is true.
- */
-export declare function array2map<K, T>(array: T[], keyGen: (e: T) => K): Map<K, T[]>;
-export declare function array2map<K, T>(array: T[], keyGen: (e: T) => K, op: {
-    accumulate: false;
-}): Map<K, T>;
-export declare function array2map<K, T>(array: T[], keyGen: (e: T) => K, op?: {
-    accumulate?: boolean;
-}): Map<K, T[]>;
 export interface RetryOption<T = MaybePromise> {
     /**
      * number of retries. default is 1.
@@ -37,7 +24,7 @@ export interface SyncRetryOption extends RetryOption<void> {
 }
 export interface AsyncRetryOption extends RetryOption {
     /**
-     * secounds to wait between callbacks. this wait occurs after `intervalPredicate`.
+     * seconds to wait between callbacks. this wait occurs after `intervalPredicate`.
      */
     intervalSec?: number;
 }

package/build/esm/func/u.js

@@ -1,7 +1,9 @@
 import { XjsErr } from "../obj/xjs-err";
+import { UType } from "./u-type";
 const s_errCode = 10;
 export function getJSTDate(d) {
-    return new Date((d ? d.getTime() : Date.now()) + 9 * 60 * 60 * 1000);
+    const adjuster = 9 * 60 * 60 * 1000;
+    return UType.isNumber(d) ? new Date(d + adjuster) : new Date((d ? d.getTime() : Date.now()) + adjuster);
 }
 export function delay(sec) {
     return new Promise(resolve => setTimeout(resolve, 1000 * sec));
@@ -12,18 +14,6 @@ export function int2array(size) {
         throw new XjsErr(s_errCode, "size of the argument is not number.");
     return Array.from(Array(s).keys());
 }
-export function array2map(array, keyGen, op) {
-    const _acm = op?.accumulate ?? true;
-    const map = new Map();
-    for (const e of array) {
-        const k = keyGen(e);
-        if (map.has(k))
-            _acm && map.get(k).push(e);
-        else
-            map.set(k, _acm ? [e] : e);
-    }
-    return map;
-}
 ;
 ;
 ;

package/package.json

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