@qwreey-js/ts-util 1.0.3 → 1.0.5

package/dist/date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"AAKA,yBAAiB,QAAQ,CAAC;IACxB,SAAgB,UAAU,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAM/C;IAED,SAAgB,SAAS,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAE9C;IAED,SAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEjD;IACD,SAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEpD;IACD,SAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIhD;IACD,SAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAElD;CACF"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,yBAAiB,QAAQ,CAAC;IACxB,mCAAmC;IACnC,SAAgB,UAAU,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAM/C;IAED,4CAA4C;IAC5C,SAAgB,SAAS,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAE9C;IAED,mCAAmC;IACnC,SAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,MAAY,GAAG,MAAM,CAExE;IAED,gCAAgC;IAChC,SAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,MAAY,GAAG,MAAM,CAEtE;IAED,iCAAiC;IACjC,SAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,MAAY,GAAG,MAAM,CAEtE;IAED,8BAA8B;IAC9B,SAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,MAAY,GAAG,MAAM,CAEpE;IAED,uCAAuC;IACvC,SAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,MAAY,GAAG,MAAM,CAE3E;IAED,oCAAoC;IACpC,SAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,MAAY,GAAG,MAAM,CAEzE;IAED,qCAAqC;IACrC,SAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,MAAY,GAAG,MAAM,CAEzE;IAED,kCAAkC;IAClC,SAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,MAAY,GAAG,MAAM,CAEvE;IAED,0DAA0D;IAC1D,SAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAAY,GAAG,IAAI,CAYrE;IAED,8DAA8D;IAC9D,SAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAAY,GAAG,IAAI,CAYxE;IAED,gDAAgD;IACzC,MAAM,eAAe,UAQ3B,CAAC;IAEF,iDAAiD;IAC1C,MAAM,oBAAoB,UAQhC,CAAC;IAEF,iDAAiD;IAC1C,MAAM,gBAAgB,UAQ5B,CAAC;IAEF,kDAAkD;IAC3C,MAAM,qBAAqB,UAQjC,CAAC;CACH"}

package/dist/date.js

@@ -1,33 +1,124 @@
-function zeroPadding(value) {
-    if (value > 10)
-        return value.toString();
-    return "0" + value.toString();
-}
+import { zeroPadding } from "./utils.js";
+/**
+ * Shared utility functions for Date manipulation.
+ * * @remarks
+ * **Known Limitations:**
+ * - **Two-digit Year Behavior:** Due to native JavaScript `Date` constructor rules, year values between 0 and 99 are interpreted as 1900-1999 (e.g., year 26 becomes 1926).
+ * - **Automatic Date Rollover:** Invalid dates (such as month 13 or day 32) do not throw errors. The native `Date` object will silently roll over and recalculate to the next valid date.
+ */
 export var DateUtil;
 (function (DateUtil) {
+    /** Create new date without time */
     function removeTime(dateTime) {
         return new Date(dateTime.getFullYear(), dateTime.getMonth(), dateTime.getDate());
     }
     DateUtil.removeTime = removeTime;
+    /** Create new date without time and days */
     function removeDay(dateTime) {
         return new Date(dateTime.getFullYear(), dateTime.getMonth());
     }
     DateUtil.removeDay = removeDay;
-    function formatYYYYMMDD(date) {
-        return `${date.getFullYear()}-${zeroPadding(date.getMonth() + 1)}-${zeroPadding(date.getDate())}`;
+    /** Formats a date to YYYY-MM-DD */
+    function formatYYYYMMDD(date, delimit = "-") {
+        return `${date.getFullYear()}${delimit}${zeroPadding(date.getMonth() + 1)}${delimit}${zeroPadding(date.getDate())}`;
     }
     DateUtil.formatYYYYMMDD = formatYYYYMMDD;
-    function formatUTCYYYYMMDD(date) {
-        return `${date.getUTCFullYear()}-${zeroPadding(date.getUTCMonth() + 1)}-${zeroPadding(date.getUTCDate())}`;
+    /** Formats a date to YYYY-MM */
+    function formatYYYYMM(date, delimit = "-") {
+        return `${date.getFullYear()}${delimit}${zeroPadding(date.getMonth() + 1)}`;
+    }
+    DateUtil.formatYYYYMM = formatYYYYMM;
+    /** Formats a date to HH:MM:SS */
+    function formatHHMMSS(date, delimit = ":") {
+        return `${zeroPadding(date.getHours())}${delimit}${zeroPadding(date.getMinutes())}${delimit}${zeroPadding(date.getSeconds())}`;
+    }
+    DateUtil.formatHHMMSS = formatHHMMSS;
+    /** Formats a date to HH:MM */
+    function formatHHMM(date, delimit = ":") {
+        return `${zeroPadding(date.getHours())}${delimit}${zeroPadding(date.getMinutes())}`;
+    }
+    DateUtil.formatHHMM = formatHHMM;
+    /** Formats a date to UTC YYYY-MM-DD */
+    function formatUTCYYYYMMDD(date, delimit = "-") {
+        return `${date.getUTCFullYear()}${delimit}${zeroPadding(date.getUTCMonth() + 1)}${delimit}${zeroPadding(date.getUTCDate())}`;
     }
     DateUtil.formatUTCYYYYMMDD = formatUTCYYYYMMDD;
-    function fromUTCYYYMMDD(str) {
-        return new Date(`${str.slice(0, 4)}-${str.slice(5, 7)}-${str.slice(8, 10)}T00:00:00.000Z`);
+    /** Formats a date to UTC YYYY-MM */
+    function formatUTCYYYYMM(date, delimit = "-") {
+        return `${date.getUTCFullYear()}${delimit}${zeroPadding(date.getUTCMonth() + 1)}`;
     }
-    DateUtil.fromUTCYYYMMDD = fromUTCYYYMMDD;
-    function formatUTCHHMMSS(date) {
-        return `${zeroPadding(date.getUTCHours())}:${zeroPadding(date.getUTCMinutes())}:${zeroPadding(date.getUTCSeconds())}`;
+    DateUtil.formatUTCYYYYMM = formatUTCYYYYMM;
+    /** Formats a date to UTC HH:MM:SS */
+    function formatUTCHHMMSS(date, delimit = ":") {
+        return `${zeroPadding(date.getUTCHours())}${delimit}${zeroPadding(date.getUTCMinutes())}${delimit}${zeroPadding(date.getUTCSeconds())}`;
     }
     DateUtil.formatUTCHHMMSS = formatUTCHHMMSS;
+    /** Formats a date to UTC HH:MM */
+    function formatUTCHHMM(date, delimit = ":") {
+        return `${zeroPadding(date.getUTCHours())}${delimit}${zeroPadding(date.getUTCMinutes())}`;
+    }
+    DateUtil.formatUTCHHMM = formatUTCHHMM;
+    /** Parses a string formatted as YYYY-MM-DD into a Date */
+    function fromYYYYMMDD(str, delimit = "-") {
+        const [year, month, day] = str.split(delimit).map(Number);
+        if (!Number.isInteger(year) ||
+            !Number.isInteger(month) ||
+            !Number.isInteger(day)) {
+            throw Error("format not valid");
+        }
+        return new Date(year, month - 1, day);
+    }
+    DateUtil.fromYYYYMMDD = fromYYYYMMDD;
+    /** Parses a string formatted as YYYY-MM-DD into a UTC Date */
+    function fromUTCYYYYMMDD(str, delimit = "-") {
+        const [year, month, day] = str.split(delimit).map(Number);
+        if (!Number.isInteger(year) ||
+            !Number.isInteger(month) ||
+            !Number.isInteger(day)) {
+            throw Error("format not valid");
+        }
+        return new Date(Date.UTC(year, month - 1, day));
+    }
+    DateUtil.fromUTCYYYYMMDD = fromUTCYYYYMMDD;
+    /** Korean full names of the days of the week */
+    DateUtil.KoreanWeekNames = [
+        "일요일",
+        "월요일",
+        "화요일",
+        "수요일",
+        "목요일",
+        "금요일",
+        "토요일",
+    ];
+    /** Korean short names of the days of the week */
+    DateUtil.KoreanWeekNamesShort = [
+        "일",
+        "월",
+        "화",
+        "수",
+        "목",
+        "금",
+        "토",
+    ];
+    /** English full names of the days of the week */
+    DateUtil.EnglishWeekNames = [
+        "Sunday",
+        "Monday",
+        "Tuesday",
+        "Wednesday",
+        "Thursday",
+        "Friday",
+        "Saturday",
+    ];
+    /** English short names of the days of the week */
+    DateUtil.EnglishWeekNamesShort = [
+        "Sun",
+        "Mon",
+        "Tue",
+        "Wed",
+        "Thu",
+        "Fri",
+        "Sat",
+    ];
 })(DateUtil || (DateUtil = {}));
 //# sourceMappingURL=date.js.map

package/dist/date.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.js","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"AAAA,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACxC,OAAO,GAAG,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,KAAW,QAAQ,CA2BxB;AA3BD,WAAiB,QAAQ;IACvB,SAAgB,UAAU,CAAC,QAAc;QACvC,OAAO,IAAI,IAAI,CACb,QAAQ,CAAC,WAAW,EAAE,EACtB,QAAQ,CAAC,QAAQ,EAAE,EACnB,QAAQ,CAAC,OAAO,EAAE,CACnB,CAAC;IACJ,CAAC;IANe,mBAAU,aAMzB,CAAA;IAED,SAAgB,SAAS,CAAC,QAAc;QACtC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/D,CAAC;IAFe,kBAAS,YAExB,CAAA;IAED,SAAgB,cAAc,CAAC,IAAU;QACvC,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;IACpG,CAAC;IAFe,uBAAc,iBAE7B,CAAA;IACD,SAAgB,iBAAiB,CAAC,IAAU;QAC1C,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IAC7G,CAAC;IAFe,0BAAiB,oBAEhC,CAAA;IACD,SAAgB,cAAc,CAAC,GAAW;QACxC,OAAO,IAAI,IAAI,CACb,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAC1E,CAAC;IACJ,CAAC;IAJe,uBAAc,iBAI7B,CAAA;IACD,SAAgB,eAAe,CAAC,IAAU;QACxC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC;IACxH,CAAC;IAFe,wBAAe,kBAE9B,CAAA;AACH,CAAC,EA3BgB,QAAQ,KAAR,QAAQ,QA2BxB"}
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,11 +1,13 @@
 export * from "./cached-getter.js";
+export * from "./color.js";
 export * from "./date.js";
 export * from "./interval.js";
-export * from "./json.js";
 export * from "./mixin.js";
-export * from "./promise.js";
+export * from "./params-builder.js";
 export * from "./result.js";
 export * from "./utils.js";
+export * from "./base32.js";
+export * from "./base64.js";
 import { setLogErr as _setLogErr } from "./libLog.js";
 export declare namespace UtilLogging {
     const setLogErr: typeof _setLogErr;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,SAAS,IAAI,UAAU,EAAqB,MAAM,aAAa,CAAC;AACzE,yBAAiB,WAAW,CAAC;IACpB,MAAM,SAAS,mBAAa,CAAC;IAC7B,MAAM,MAAM,8BAAU,CAAC;CAC/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,SAAS,IAAI,UAAU,EAAqB,MAAM,aAAa,CAAC;AACzE,yBAAiB,WAAW,CAAC;IACpB,MAAM,SAAS,mBAAa,CAAC;IAC7B,MAAM,MAAM,8BAAU,CAAC;CAC/B"}

package/dist/index.js

@@ -1,11 +1,13 @@
 export * from "./cached-getter.js";
+export * from "./color.js";
 export * from "./date.js";
 export * from "./interval.js";
-export * from "./json.js";
 export * from "./mixin.js";
-export * from "./promise.js";
+export * from "./params-builder.js";
 export * from "./result.js";
 export * from "./utils.js";
+export * from "./base32.js";
+export * from "./base64.js";
 import { setLogErr as _setLogErr, logErr as _logErr } from "./libLog.js";
 export var UtilLogging;
 (function (UtilLogging) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,MAAM,KAAW,WAAW,CAG3B;AAHD,WAAiB,WAAW;IACb,qBAAS,GAAG,UAAU,CAAC;IACvB,kBAAM,GAAG,OAAO,CAAC;AAChC,CAAC,EAHgB,WAAW,KAAX,WAAW,QAG3B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,MAAM,KAAW,WAAW,CAG3B;AAHD,WAAiB,WAAW;IACb,qBAAS,GAAG,UAAU,CAAC;IACvB,kBAAM,GAAG,OAAO,CAAC;AAChC,CAAC,EAHgB,WAAW,KAAX,WAAW,QAG3B"}

package/dist/interval.d.ts

@@ -1,16 +1,75 @@
-export declare class Interval {
+/**
+ * Executes a standard, synchronous function repeatedly based on the provided millisecond interval.
+ */
+export declare class Interval<T> {
     private func;
     private interval;
     private id?;
     private running;
     private name;
-    constructor(func: () => any, interval: number, name?: string);
+    private _result?;
+    /**
+     * @param func The synchronous function to execute.
+     * @param interval The execution interval in milliseconds.
+     * @param name Optional name for logging purposes.
+     */
+    constructor(func: () => T, interval: number, name?: string);
+    /**
+     * Schedules the function execution using a timeout. Throws an error if the interval is already running.
+     */
     run(): void;
+    /**
+     * Clears the current timeout and stops the interval.
+     */
     drop(): void;
-    executeAsync(): Promise<void>;
-    execute(options?: {
-        runTimerAfterExecute?: boolean;
-        runIn?: number;
-    }): void;
+    /**
+     * Immediately executes the function. Resets the timeout if it is already running.
+     */
+    execute(): void;
+    /**
+     * Immediately executes the function and guarantees that the interval continues running afterward.
+     */
+    executeThenRun(): void;
+    /**
+     * Returns the return value of the last executed function.
+     */
+    get result(): T | undefined;
+}
+/**
+ * Executes an asynchronous function repeatedly based on the provided millisecond interval.
+ */
+export declare class IntervalAsync<T> {
+    private func;
+    private interval;
+    private id?;
+    private running;
+    private name;
+    private _result?;
+    /**
+     * @param func The asynchronous function to execute.
+     * @param interval The execution interval in milliseconds.
+     * @param name Optional name for logging purposes.
+     */
+    constructor(func: () => Promise<T>, interval: number, name?: string);
+    /**
+     * Schedules the function execution using a timeout. Throws an error if the interval is already running.
+     */
+    run(): void;
+    /**
+     * Clears the current timeout and stops the interval.
+     */
+    drop(): void;
+    /**
+     * Immediately executes the function. Resets the timeout if it is already running.
+     */
+    execute(): Promise<void>;
+    /**
+     * Immediately executes the function and guarantees that the interval continues running afterward.
+     */
+    executeThenRun(): Promise<void>;
+    /**
+     * Returns the Promise of the last executed function.
+     */
+    get result(): Promise<T> | undefined;
 }
 //# sourceMappingURL=interval.d.ts.map

package/dist/interval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interval.d.ts","sourceRoot":"","sources":["../src/interval.ts"],"names":[],"mappings":"AAMA,qBAAa,QAAQ;IACnB,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,EAAE,CAAC,CAAM;IACjB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,IAAI,CAAS;gBAGnB,IAAI,EAAE,MAAM,GAAG,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAkB;IAQnB,GAAG;IAgBH,IAAI;IAQE,YAAY;IAWlB,OAAO,CACZ,OAAO,GAAE;QACP,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;KACX;CAST"}
+{"version":3,"file":"interval.d.ts","sourceRoot":"","sources":["../src/interval.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,QAAQ,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAU;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,EAAE,CAAC,CAAM;IACjB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAC,CAAI;IAEpB;;;;OAIG;gBAED,IAAI,EAAE,MAAM,CAAC,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAkB;IAQ1B;;OAEG;IACI,GAAG;IAkBV;;OAEG;IACI,IAAI;IAQX;;OAEG;IACI,OAAO;IAWd;;OAEG;IACI,cAAc;IAOrB;;OAEG;IACH,IAAW,MAAM,IAAI,CAAC,GAAG,SAAS,CAEjC;CACF;AAED;;GAEG;AACH,qBAAa,aAAa,CAAC,CAAC;IAC1B,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,EAAE,CAAC,CAAM;IACjB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAC,CAAa;IAE7B;;;;OAIG;gBAED,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAkB;IAQ1B;;OAEG;IACI,GAAG;IAkBV;;OAEG;IACI,IAAI;IAQX;;OAEG;IACU,OAAO;IAWpB;;OAEG;IACU,cAAc;IAO3B;;OAEG;IACH,IAAW,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAE1C;CACF"}

package/dist/interval.js

@@ -1,36 +1,49 @@
 import { logErr } from "./libLog.js";
-// 입력받은 시간을 기준으로 함수를 반복 실행합니다.
-// 처음 실행되지는 않습니다. drop 하거나 execute 할 수 있습니다
-// execute 시 시간은 초기화됩니다 (0 초 부터 다시 카운팅)
-// 내부 구현은 setInterval 로 구현됩니다
+/**
+ * Executes a standard, synchronous function repeatedly based on the provided millisecond interval.
+ */
 export class Interval {
     func;
     interval;
     id;
     running;
     name;
+    _result;
+    /**
+     * @param func The synchronous function to execute.
+     * @param interval The execution interval in milliseconds.
+     * @param name Optional name for logging purposes.
+     */
     constructor(func, interval, name = "default") {
         this.func = func;
         this.interval = interval;
         this.running = false;
         this.name = name;
     }
+    /**
+     * Schedules the function execution using a timeout. Throws an error if the interval is already running.
+     */
     run() {
         if (this.running) {
             throw Error("interval already started");
         }
         this.running = true;
-        this.id = setTimeout(async () => {
+        const currId = (this.id = setTimeout(() => {
             try {
-                await (this.func() ?? null);
+                this._result = this.func();
             }
             catch (e) {
                 logErr(`interval failed(${this.name}): ${e}`);
             }
-            this.running = false;
-            this.run();
-        }, this.interval);
+            if (currId == this.id) {
+                this.running = false;
+                this.run();
+            }
+        }, this.interval));
     }
+    /**
+     * Clears the current timeout and stops the interval.
+     */
     drop() {
         this.running = false;
         if (this.id) {
@@ -38,12 +51,15 @@ export class Interval {
             delete this.id;
         }
     }
-    async executeAsync() {
+    /**
+     * Immediately executes the function. Resets the timeout if it is already running.
+     */
+    execute() {
         const running = this.running;
         if (running)
             this.drop();
         try {
-            await (this.func() ?? null);
+            this._result = this.func();
         }
         catch (e) {
             logErr(`interval failed(${this.name}): ${e}`);
@@ -51,13 +67,104 @@ export class Interval {
         if (running)
             this.run();
     }
-    execute(options = {}) {
-        setTimeout(async () => {
-            await this.executeAsync();
-            if (options.runTimerAfterExecute && !this.running) {
+    /**
+     * Immediately executes the function and guarantees that the interval continues running afterward.
+     */
+    executeThenRun() {
+        this.execute();
+        if (!this.running) {
+            this.run();
+        }
+    }
+    /**
+     * Returns the return value of the last executed function.
+     */
+    get result() {
+        return this._result;
+    }
+}
+/**
+ * Executes an asynchronous function repeatedly based on the provided millisecond interval.
+ */
+export class IntervalAsync {
+    func;
+    interval;
+    id;
+    running;
+    name;
+    _result;
+    /**
+     * @param func The asynchronous function to execute.
+     * @param interval The execution interval in milliseconds.
+     * @param name Optional name for logging purposes.
+     */
+    constructor(func, interval, name = "default") {
+        this.func = func;
+        this.interval = interval;
+        this.running = false;
+        this.name = name;
+    }
+    /**
+     * Schedules the function execution using a timeout. Throws an error if the interval is already running.
+     */
+    run() {
+        if (this.running) {
+            throw Error("interval already started");
+        }
+        this.running = true;
+        const currId = (this.id = setTimeout(async () => {
+            try {
+                await (this._result = this.func());
+            }
+            catch (e) {
+                logErr(`interval failed(${this.name}): ${e}`);
+            }
+            if (currId == this.id) {
+                this.running = false;
                 this.run();
             }
-        }, options.runIn ?? 0);
+        }, this.interval));
+    }
+    /**
+     * Clears the current timeout and stops the interval.
+     */
+    drop() {
+        this.running = false;
+        if (this.id) {
+            clearTimeout(this.id);
+            delete this.id;
+        }
+    }
+    /**
+     * Immediately executes the function. Resets the timeout if it is already running.
+     */
+    async execute() {
+        const running = this.running;
+        if (running)
+            this.drop();
+        try {
+            await (this._result = this.func());
+        }
+        catch (e) {
+            logErr(`interval failed(${this.name}): ${e}`);
+        }
+        if (running)
+            this.run();
+    }
+    /**
+     * Immediately executes the function and guarantees that the interval continues running afterward.
+     */
+    async executeThenRun() {
+        await this.execute();
+        if (!this.running) {
+            this.run();
+        }
+    }
+    /**
+     * Returns the Promise of the last executed function.
+     */
+    get result() {
+        return this._result;
     }
 }
 //# sourceMappingURL=interval.js.map

package/dist/interval.js.map

@@ -1 +1 @@
-{"version":3,"file":"interval.js","sourceRoot":"","sources":["../src/interval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,8BAA8B;AAC9B,2CAA2C;AAC3C,uCAAuC;AACvC,6BAA6B;AAC7B,MAAM,OAAO,QAAQ;IACX,IAAI,CAAY;IAChB,QAAQ,CAAS;IACjB,EAAE,CAAO;IACT,OAAO,CAAU;IACjB,IAAI,CAAS;IAErB,YACE,IAAe,EACf,QAAgB,EAChB,OAAe,SAAS;QAExB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAEM,GAAG;QACR,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,mBAAmB,IAAI,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;YAChD,CAAC;YACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACrB,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAQ,CAAC;IAC3B,CAAC;IAEM,IAAI;QACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,YAAY,CAAC,IAAI,CAAC,EAAS,CAAC,CAAC;YAC7B,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,YAAY;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,mBAAmB,IAAI,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,OAAO;YAAE,IAAI,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;IAEM,OAAO,CACZ,UAGI,EAAE;QAEN,UAAU,CAAC,KAAK,IAAI,EAAE;YACpB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1B,IAAI,OAAO,CAAC,oBAAoB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClD,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,CAAC;QACH,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"interval.js","sourceRoot":"","sources":["../src/interval.ts"],"names":[],"mappings":"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"}

package/dist/mixin.d.ts

@@ -1,18 +1,63 @@
 import type { UnionToIntersection } from "./utils.js";
+/**
+ * Represents a generic constructor function, capable of accepting both concrete and abstract classes.
+ */
 export type AbstractConstructor<T = any> = abstract new (...args: any[]) => T;
+/**
+ * A utility type that combines two constructor types `A` and `B`.
+ * Returns a new constructor type intersecting instances and static properties.
+ */
 export type MixinBoth<A extends AbstractConstructor<InstanceType<A>>, B extends AbstractConstructor<InstanceType<B>>> = (A & B) & AbstractConstructor<InstanceType<A> & InstanceType<B>>;
+/**
+ * A recursive utility type that combines an array of constructor types `T` into a single constructor type.
+ */
 export type Mixin<T extends AbstractConstructor[]> = T extends [
     infer First extends AbstractConstructor
 ] ? First : T extends [
     ...infer Others extends AbstractConstructor[],
     infer Last extends AbstractConstructor
 ] ? MixinBoth<Mixin<Others>, Last> : never;
+/**
+ * Copies prototype methods and static properties from a list of base classes directly onto a target class.
+ * @param targetClass The class to which the mixins will be applied.
+ * @param baseClassList An array of base classes to mix into the `targetClass`.
+ */
 export declare function applyRuntimeMixins(targetClass: any, baseClassList: any[]): void;
+export declare function isNonNullObject(instance: any): instance is object;
+/**
+ * Checks whether the given instance incorporates a specific mixin or base class.
+ * This utility serves as an alternative to the native `instanceof` operator for custom
+ * mixin implementations where the prototype chain does not inherently preserve the relationship.
+ *
+ * @template T - The constructor type of the target mixin or base class.
+ * @param {T} baseClass - The mixin or base class constructor to verify against.
+ * @param {*} instance - The object instance to inspect.
+ * @returns {instance is T} `true` if the instance incorporates the specified mixin; otherwise, `false`.
+ */
+export declare function hasMixin<T extends AbstractConstructor>(baseClass: T, instance: any): instance is T;
+/**
+ * Retrieves the sequence of mixins associated with the specified instance.
+ *
+ * @param {*} instance - The object instance to inspect.
+ * @returns {ReadonlyArray<AbstractConstructor> | undefined} A read-only array of mixin constructors applied to the instance, or `undefined` if no mixins are registered.
+ */
+export declare function getMixins(instance: any): ReadonlyArray<AbstractConstructor> | undefined;
+/**
+ * Creates an anonymous target class, applies the `baseClassList` to it, and returns the constructed mixin class.
+ * @param baseClassList A list of base classes you want to compose.
+ * @returns A new class constructor containing all instance and static properties of the base classes.
+ */
 export declare function mixin<T extends AbstractConstructor[]>(...baseClassList: T): Mixin<T>;
+/**
+ * Represents an array of tuples where the first element is a condition and the second is a constructor.
+ */
 export type MixinApplyList = [
     boolean | undefined | null,
     AbstractConstructor
 ][];
+/**
+ * Computes an intersection of instance types from a `MixinApplyList` where the condition is strictly true.
+ */
 export type MixinInstance<Apply extends MixinApplyList> = UnionToIntersection<{
     [K in keyof Apply]: Apply[K][0] extends true ? InstanceType<Apply[K][1]> : object;
 }[number]>;

package/dist/mixin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mixin.d.ts","sourceRoot":"","sources":["../src/mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,MAAM,mBAAmB,CAAC,CAAC,GAAG,GAAG,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAE9E,MAAM,MAAM,SAAS,CACnB,CAAC,SAAS,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,SAAS,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAC5C,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAErE,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAAE,IAAI,CAAC,SAAS;IAC7D,MAAM,KAAK,SAAS,mBAAmB;CACxC,GACG,KAAK,GACL,CAAC,SAAS;IACN,GAAG,MAAM,MAAM,SAAS,mBAAmB,EAAE;IAC7C,MAAM,IAAI,SAAS,mBAAmB;CACvC,GACD,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,GAC9B,KAAK,CAAC;AAEZ,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,QAwBxE;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAAE,EACnD,GAAG,aAAa,EAAE,CAAC,GAClB,KAAK,CAAC,CAAC,CAAC,CAIV;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,GAAG,SAAS,GAAG,IAAI;IAC1B,mBAAmB;CACpB,EAAE,CAAC;AAEJ,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,cAAc,IAAI,mBAAmB,CAC3E;KACG,CAAC,IAAI,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GACxC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACzB,MAAM;CACX,CAAC,MAAM,CAAC,CACV,CAAC"}
+{"version":3,"file":"mixin.d.ts","sourceRoot":"","sources":["../src/mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,GAAG,GAAG,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,SAAS,CACnB,CAAC,SAAS,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,SAAS,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAC5C,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAAE,IAAI,CAAC,SAAS;IAC7D,MAAM,KAAK,SAAS,mBAAmB;CACxC,GACG,KAAK,GACL,CAAC,SAAS;IACN,GAAG,MAAM,MAAM,SAAS,mBAAmB,EAAE;IAC7C,MAAM,IAAI,SAAS,mBAAmB;CACvC,GACD,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,GAC9B,KAAK,CAAC;AAEZ;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,QAsCxE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,QAAQ,IAAI,MAAM,CAIjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,mBAAmB,EACpD,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,GAAG,GACZ,QAAQ,IAAI,CAAC,CAIf;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,GAAG,GACZ,aAAa,CAAC,mBAAmB,CAAC,GAAG,SAAS,CAWhD;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAAE,EACnD,GAAG,aAAa,EAAE,CAAC,GAClB,KAAK,CAAC,CAAC,CAAC,CAMV;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,GAAG,SAAS,GAAG,IAAI;IAC1B,mBAAmB;CACpB,EAAE,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,cAAc,IAAI,mBAAmB,CAC3E;KACG,CAAC,IAAI,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GACxC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACzB,MAAM;CACX,CAAC,MAAM,CAAC,CACV,CAAC"}