@qwreey-js/ts-util 1.0.3 → 1.0.5

package/dist/base32.d.ts

@@ -0,0 +1,16 @@
+export declare namespace Base32 {
+    /**
+     * Encodes a Uint8Array into a Base32 string according to RFC 4648.
+     * * @param {Uint8Array} uint8Array - The byte array to encode.
+     * @returns {string} The resulting Base32 encoded string.
+     */
+    function fromUint8Array(uint8Array: Uint8Array): string;
+    /**
+     * Decodes a Base32 string into a Uint8Array.
+     * Ignores padding characters ('=') and is case-insensitive.
+     * @param {string} base32 - The Base32 encoded string to decode.
+     * @returns {Uint8Array} The decoded byte array.
+     */
+    function toUint8Array(base32: string): Uint8Array;
+}
+//# sourceMappingURL=base32.d.ts.map

package/dist/base32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base32.d.ts","sourceRoot":"","sources":["../src/base32.ts"],"names":[],"mappings":"AAAA,yBAAiB,MAAM,CAAC;IAGtB;;;;OAIG;IACH,SAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAwB7D;IAWD;;;;;OAKG;IACH,SAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAwBvD;CACF"}

package/dist/base32.js

@@ -0,0 +1,67 @@
+export var Base32;
+(function (Base32) {
+    const Base32Alpabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
+    /**
+     * Encodes a Uint8Array into a Base32 string according to RFC 4648.
+     * * @param {Uint8Array} uint8Array - The byte array to encode.
+     * @returns {string} The resulting Base32 encoded string.
+     */
+    function fromUint8Array(uint8Array) {
+        let bits = 0;
+        let value = 0;
+        const output = [];
+        for (const byte of uint8Array) {
+            value = (value << 8) | byte;
+            bits += 8;
+            while (bits >= 5) {
+                output.push(Base32Alpabet[(value >>> (bits - 5)) & 31]);
+                bits -= 5;
+            }
+        }
+        if (bits > 0) {
+            output.push(Base32Alpabet[(value << (5 - bits)) & 31]);
+        }
+        while (output.length % 8 !== 0) {
+            output.push("=");
+        }
+        return output.join("");
+    }
+    Base32.fromUint8Array = fromUint8Array;
+    const Base32Lookup = (() => {
+        const arr = new Int8Array(256);
+        const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
+        for (let i = 0; i < chars.length; i++) {
+            arr[chars.charCodeAt(i)] = i;
+        }
+        return arr;
+    })();
+    /**
+     * Decodes a Base32 string into a Uint8Array.
+     * Ignores padding characters ('=') and is case-insensitive.
+     * @param {string} base32 - The Base32 encoded string to decode.
+     * @returns {Uint8Array} The decoded byte array.
+     */
+    function toUint8Array(base32) {
+        // 소문자가 들어와도 대문자로 처리. 패딩(=) 제거
+        const str = base32.toUpperCase().replace(/=/g, "");
+        const outLen = Math.floor((str.length * 5) / 8);
+        const result = new Uint8Array(outLen);
+        let bits = 0;
+        let value = 0;
+        let index = 0;
+        for (let i = 0; i < str.length; i++) {
+            const charCode = str.charCodeAt(i);
+            // 5비트씩 가져오기
+            value = (value << 5) | Base32Lookup[charCode];
+            bits += 5;
+            // 8비트가 모이면 하나의 바이트로 결과 배열에 넣기
+            if (bits >= 8) {
+                result[index++] = (value >>> (bits - 8)) & 255;
+                bits -= 8;
+            }
+        }
+        return result;
+    }
+    Base32.toUint8Array = toUint8Array;
+})(Base32 || (Base32 = {}));
+//# sourceMappingURL=base32.js.map

package/dist/base32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base32.js","sourceRoot":"","sources":["../src/base32.ts"],"names":[],"mappings":"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"}

package/dist/base64.d.ts

@@ -0,0 +1,34 @@
+export declare namespace Base64 {
+    /**
+     * Configuration options for Base64 encoding.
+     */
+    interface ToBase64Options {
+        /**
+         * The alphabet to use for encoding.
+         * 'base64' uses the standard Base64 alphabet (RFC 4648).
+         * 'base64url' uses the URL-safe Base64 alphabet.
+         * @default 'base64'
+         */
+        alphabet?: "base64" | "base64url";
+        /**
+         * Whether to omit the padding character ('=') at the end of the output.
+         * @default false
+         */
+        omitPadding?: boolean;
+    }
+    /**
+     * Encodes a Uint8Array into a Base64 or Base64URL string.
+     * @param {Uint8Array} uint8Array - The byte array to encode.
+     * @param {ToBase64Options} [options] - Optional encoding configuration.
+     * @returns {string} The resulting Base64 or Base64URL encoded string.
+     */
+    function fromUint8Array(uint8Array: Uint8Array, options?: ToBase64Options): string;
+    /**
+     * Decodes a Base64 or Base64URL string into a Uint8Array.
+     * Automatically handles both standard and URL-safe alphabets and ignores padding characters ('=').
+     * @param {string} base64 - The Base64 or Base64URL encoded string to decode.
+     * @returns {Uint8Array} The decoded byte array.
+     */
+    function toUint8Array(base64: string): Uint8Array;
+}
+//# sourceMappingURL=base64.d.ts.map

package/dist/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../src/base64.ts"],"names":[],"mappings":"AAAA,yBAAiB,MAAM,CAAC;IACtB;;OAEG;IACH,UAAiB,eAAe;QAC9B;;;;;WAKG;QACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;QAClC;;;WAGG;QACH,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB;IAOD;;;;;OAKG;IACH,SAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CAuCR;IAYD;;;;;OAKG;IACH,SAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAwBvD;CACF"}

package/dist/base64.js

@@ -0,0 +1,81 @@
+export var Base64;
+(function (Base64) {
+    const Base64Alpabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+    const Base64AlpabetUrl = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
+    /**
+     * Encodes a Uint8Array into a Base64 or Base64URL string.
+     * @param {Uint8Array} uint8Array - The byte array to encode.
+     * @param {ToBase64Options} [options] - Optional encoding configuration.
+     * @returns {string} The resulting Base64 or Base64URL encoded string.
+     */
+    function fromUint8Array(uint8Array, options) {
+        if (uint8Array.toBase64) {
+            return uint8Array.toBase64(options);
+        }
+        const alphabetName = options?.alphabet ?? "base64";
+        const omitPadding = options?.omitPadding ?? false;
+        const chars = alphabetName === "base64url" ? Base64AlpabetUrl : Base64Alpabet;
+        let result = "";
+        const len = uint8Array.length;
+        // 3바이트(24비트)씩 끊어서 4개의 6비트 문자로 변환
+        for (let i = 0; i < len; i += 3) {
+            const b1 = uint8Array[i];
+            const b2 = i + 1 < len ? uint8Array[i + 1] : 0;
+            const b3 = i + 2 < len ? uint8Array[i + 2] : 0;
+            const bits = (b1 << 16) | (b2 << 8) | b3;
+            result += chars[(bits >> 18) & 63];
+            result += chars[(bits >> 12) & 63];
+            if (i + 1 < len) {
+                result += chars[(bits >> 6) & 63];
+            }
+            else if (!omitPadding) {
+                result += "=";
+            }
+            if (i + 2 < len) {
+                result += chars[bits & 63];
+            }
+            else if (!omitPadding) {
+                result += "=";
+            }
+        }
+        return result;
+    }
+    Base64.fromUint8Array = fromUint8Array;
+    const Base64Lookup = (() => {
+        const arr = new Int8Array(256);
+        const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+        for (let i = 0; i < chars.length; i++) {
+            arr[chars.charCodeAt(i)] = i;
+        }
+        return arr;
+    })();
+    /**
+     * Decodes a Base64 or Base64URL string into a Uint8Array.
+     * Automatically handles both standard and URL-safe alphabets and ignores padding characters ('=').
+     * @param {string} base64 - The Base64 or Base64URL encoded string to decode.
+     * @returns {Uint8Array} The decoded byte array.
+     */
+    function toUint8Array(base64) {
+        // Base64URL의 -, _ 문자를 표준 +, / 로 바꾸고 패딩 제거
+        const str = base64.replace(/-/g, "+").replace(/_/g, "/").replace(/=/g, "");
+        const outLen = Math.floor((str.length * 3) / 4);
+        const result = new Uint8Array(outLen);
+        let bits = 0;
+        let value = 0;
+        let index = 0;
+        for (let i = 0; i < str.length; i++) {
+            const charCode = str.charCodeAt(i);
+            // 6비트씩 가져오기
+            value = (value << 6) | Base64Lookup[charCode];
+            bits += 6;
+            // 8비트가 모일 때마다 바이트로 저장
+            if (bits >= 8) {
+                result[index++] = (value >>> (bits - 8)) & 255;
+                bits -= 8;
+            }
+        }
+        return result;
+    }
+    Base64.toUint8Array = toUint8Array;
+})(Base64 || (Base64 = {}));
+//# sourceMappingURL=base64.js.map

package/dist/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../src/base64.ts"],"names":[],"mappings":"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"}

package/dist/cached-getter.d.ts

@@ -1,16 +1,38 @@
+/**
+ * A utility for caching the result of an asynchronous function for a specified Time-To-Live (TTL, interval).
+ * If `getValue` is called multiple times within the TTL, it returns the cached result instead of executing the function again.
+ */
 export declare class CachedGetter<Res> {
     private func;
     private interval;
     private value?;
     private last?;
+    /**
+     * @param func The asynchronous function to execute and cache.
+     * @param interval The Time-To-Live interval in milliseconds.
+     */
     constructor(func: () => Promise<Res>, interval: number);
+    /**
+     * Retrieves the cached value or executes the function if the cache has expired or is missing.
+     */
     getValue(): Promise<Res>;
 }
+/**
+ * A mapped variant of `CachedGetter`. It caches multiple asynchronous function results based on unique keys.
+ */
 export declare class CachedGetterMap<Res, Key> {
     private func;
     private interval;
     private values;
+    /**
+     * @param func The asynchronous function to execute and cache per key.
+     * @param interval The Time-To-Live interval in milliseconds.
+     */
     constructor(func: (key: Key) => Promise<Res>, interval: number);
+    /**
+     * Retrieves the cached value for the specific key, or executes the function if the cache has expired or is missing.
+     * @param key The unique key identifying the cached result.
+     */
     getValue(key: Key): Promise<Res>;
 }
 export declare namespace CachedGetterMap {

package/dist/cached-getter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cached-getter.d.ts","sourceRoot":"","sources":["../src/cached-getter.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY,CAAC,GAAG;IAC3B,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAC,CAAe;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAS;gBAEH,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM;IAKhD,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC;CAStC;AAED,qBAAa,eAAe,CAAC,GAAG,EAAE,GAAG;IACnC,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAwC;gBAEnC,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM;IAMxD,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;CAc9C;AACD,yBAAiB,eAAe,CAAC;IAC/B,KAAY,MAAM,CAAC,GAAG,IAAI;QACxB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH"}
+{"version":3,"file":"cached-getter.d.ts","sourceRoot":"","sources":["../src/cached-getter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,YAAY,CAAC,GAAG;IAC3B,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAC,CAAe;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAS;IAEtB;;;OAGG;gBACgB,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM;IAK7D;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC;CAStC;AAED;;GAEG;AACH,qBAAa,eAAe,CAAC,GAAG,EAAE,GAAG;IACnC,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAwC;IAEtD;;;OAGG;gBACgB,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM;IAMrE;;;OAGG;IACU,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;CAc9C;AACD,yBAAiB,eAAe,CAAC;IAC/B,KAAY,MAAM,CAAC,GAAG,IAAI;QACxB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH"}

package/dist/cached-getter.js

@@ -1,12 +1,23 @@
+/**
+ * A utility for caching the result of an asynchronous function for a specified Time-To-Live (TTL, interval).
+ * If `getValue` is called multiple times within the TTL, it returns the cached result instead of executing the function again.
+ */
 export class CachedGetter {
     func;
     interval;
     value;
     last;
+    /**
+     * @param func The asynchronous function to execute and cache.
+     * @param interval The Time-To-Live interval in milliseconds.
+     */
     constructor(func, interval) {
         this.func = func;
         this.interval = interval;
     }
+    /**
+     * Retrieves the cached value or executes the function if the cache has expired or is missing.
+     */
     async getValue() {
         const curr = +new Date();
         if (!this.value || !this.last || this.last + this.interval < curr) {
@@ -17,15 +28,26 @@ export class CachedGetter {
         return await this.value;
     }
 }
+/**
+ * A mapped variant of `CachedGetter`. It caches multiple asynchronous function results based on unique keys.
+ */
 export class CachedGetterMap {
     func;
     interval;
     values;
+    /**
+     * @param func The asynchronous function to execute and cache per key.
+     * @param interval The Time-To-Live interval in milliseconds.
+     */
     constructor(func, interval) {
         this.func = func;
         this.values = new Map();
         this.interval = interval;
     }
+    /**
+     * Retrieves the cached value for the specific key, or executes the function if the cache has expired or is missing.
+     * @param key The unique key identifying the cached result.
+     */
     async getValue(key) {
         const curr = +new Date();
         const record = this.values.get(key);

package/dist/cached-getter.js.map

@@ -1 +1 @@
-{"version":3,"file":"cached-getter.js","sourceRoot":"","sources":["../src/cached-getter.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAY;IACf,IAAI,CAAqB;IACzB,QAAQ,CAAS;IACjB,KAAK,CAAgB;IACrB,IAAI,CAAU;IAEtB,YAAmB,IAAwB,EAAE,QAAgB;QAC3D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,QAAQ;QACnB,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC;YAClE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACzB,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC;QAC1B,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,eAAe;IAClB,IAAI,CAA6B;IACjC,QAAQ,CAAS;IACjB,MAAM,CAAwC;IAEtD,YAAmB,IAAgC,EAAE,QAAgB;QACnE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,GAAQ;QAC5B,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEpC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;gBACnB,IAAI,EAAE,IAAI;gBACV,KAAK;aACN,CAAC,CAAC;YACH,OAAO,MAAM,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,MAAM,MAAM,CAAC,KAAK,CAAC;IAC5B,CAAC;CACF"}
+{"version":3,"file":"cached-getter.js","sourceRoot":"","sources":["../src/cached-getter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,IAAI,CAAqB;IACzB,QAAQ,CAAS;IACjB,KAAK,CAAgB;IACrB,IAAI,CAAU;IAEtB;;;OAGG;IACH,YAAmB,IAAwB,EAAE,QAAgB;QAC3D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,QAAQ;QACnB,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC;YAClE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACzB,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC;QAC1B,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,IAAI,CAA6B;IACjC,QAAQ,CAAS;IACjB,MAAM,CAAwC;IAEtD;;;OAGG;IACH,YAAmB,IAAgC,EAAE,QAAgB;QACnE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,QAAQ,CAAC,GAAQ;QAC5B,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEpC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;gBACnB,IAAI,EAAE,IAAI;gBACV,KAAK;aACN,CAAC,CAAC;YACH,OAAO,MAAM,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,MAAM,MAAM,CAAC,KAAK,CAAC;IAC5B,CAAC;CACF"}

package/dist/color.d.ts

@@ -0,0 +1,72 @@
+export declare class RGBColor {
+    /** 0-255 sRGB red value */
+    readonly r: number;
+    /** 0-255 sRGB green value */
+    readonly g: number;
+    /** 0-255 sRGB blue value */
+    readonly b: number;
+    constructor(r: number, g: number, b: number);
+    /**
+     * Converts a hex color string to an RGB object.
+     * @param hex 3-digit (#FFF) or 6-digit (#FFFFFF) hex string
+     */
+    static fromHex(hex: string): RGBColor;
+    /**
+     * Converts an Oklab color back to an RGB color.
+     */
+    static fromOKLab(okLab: OKLabColor): RGBColor;
+    /**
+     * Linearly interpolates (Lerps) between two sRGB colors based on an amount (0~1).
+     */
+    static lerp(from: RGBColor, to: RGBColor, amount: number): RGBColor;
+    /**
+     * Convert to a hex color string.
+     */
+    toHex(): string;
+    /**
+     * Convert to a OKLab color.
+     */
+    toOKLab(): OKLabColor;
+}
+export declare class OKLabColor {
+    /** Lightness */
+    readonly l: number;
+    /**  Green-Red component */
+    readonly a: number;
+    /** Blue-Yellow component */
+    readonly b: number;
+    constructor(l: number, a: number, b: number);
+    /**
+     * Converts an RGB color to an Oklab color.
+     * Note: Uses Björn Ottosson's standard Oklab transformation matrices.
+     */
+    static fromRGB(rgb: RGBColor): OKLabColor;
+    /**
+     * Converts an Hex color to an Oklab color.
+     * Note: Uses Björn Ottosson's standard Oklab transformation matrices.
+     */
+    static fromHex(hex: string): OKLabColor;
+    /**
+     * Linearly interpolates (Lerps) between two Oklab colors based on an amount (0~1).
+     */
+    static lerp(from: OKLabColor, to: OKLabColor, amount: number): OKLabColor;
+    toHex(): string;
+    toRGB(): RGBColor;
+}
+/**
+ * Naturally interpolates between two hex colors in the Oklab color space, then returns the resulting hex color.
+ * @param fromHex Start color (e.g., "#FF0000")
+ * @param toHex Target color (e.g., "#0000FF")
+ * @param amount Transition value (0.0 ~ 1.0)
+ * @returns Interpolated hex color string
+ */
+export declare function lerpHexColorInOKLab(fromHex: string, toHex: string, amount: number): string;
+/**
+ * sRGB interpolates between two hex color, then returns the resulting hex color.
+ * @param fromHex Start color (e.g., "#FF0000")
+ * @param toHex Target color (e.g., "#0000FF")
+ * @param amount Transition value (0.0 ~ 1.0)
+ * @returns Interpolated hex color string
+ */
+export declare function lerpHexColorInSRGB(fromHex: string, toHex: string, amount: number): string;
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAcA,qBAAa,QAAQ;IACnB,2BAA2B;IAC3B,SAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6BAA6B;IAC7B,SAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,SAAgB,CAAC,EAAE,MAAM,CAAC;gBAEP,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAMlD;;;OAGG;WACW,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAkB5C;;OAEG;WACW,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ;IAoBpD;;OAEG;WACW,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ;IAY1E;;OAEG;IACI,KAAK,IAAI,MAAM;IAQtB;;OAEG;IACI,OAAO,IAAI,UAAU;CAG7B;AAED,qBAAa,UAAU;IACrB,gBAAgB;IAChB,SAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2BAA2B;IAC3B,SAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,SAAgB,CAAC,EAAE,MAAM,CAAC;gBAEP,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAMlD;;;OAGG;WACW,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,UAAU;IAwBhD;;;OAGG;WACW,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAI9C;;OAEG;WACW,IAAI,CAChB,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,UAAU,EACd,MAAM,EAAE,MAAM,GACb,UAAU;IAaN,KAAK,IAAI,MAAM;IAIf,KAAK,IAAI,QAAQ;CAGzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,MAAM,CAeR;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,MAAM,CAWR"}

package/dist/color.js

@@ -0,0 +1,187 @@
+// Convert sRGB value to Linear sRGB space (Remove Gamma)
+const toLinear = (c) => c > 0.04045 ? Math.pow((c + 0.055) / 1.055, 2.4) : c / 12.92;
+// Convert Linear sRGB space to sRGB value (Apply Gamma)
+const toSrgb = (c) => c <= 0.0031308 ? 12.92 * c : 1.055 * Math.pow(c, 1 / 2.4) - 0.055;
+// Clamp to prevent out-of-bounds values after Oklab conversion
+const clampSrgb = (val) => Math.max(0, Math.min(255, Math.round(val)));
+// Clamp amount between 0 and 1
+const clampAmount = (amount) => Math.max(0, Math.min(1, amount));
+export class RGBColor {
+    /** 0-255 sRGB red value */
+    r;
+    /** 0-255 sRGB green value */
+    g;
+    /** 0-255 sRGB blue value */
+    b;
+    constructor(r, g, b) {
+        this.r = r;
+        this.g = g;
+        this.b = b;
+    }
+    /**
+     * Converts a hex color string to an RGB object.
+     * @param hex 3-digit (#FFF) or 6-digit (#FFFFFF) hex string
+     */
+    static fromHex(hex) {
+        let cleaned = hex.replace("#", "");
+        if (cleaned.length === 3) {
+            cleaned = cleaned
+                .split("")
+                .map((char) => char + char)
+                .join("");
+        }
+        const num = parseInt(cleaned, 16);
+        if (isNaN(num)) {
+            throw new Error(`Invalid hex color: ${hex}`);
+        }
+        return new RGBColor((num >> 16) & 255, (num >> 8) & 255, num & 255);
+    }
+    /**
+     * Converts an Oklab color back to an RGB color.
+     */
+    static fromOKLab(okLab) {
+        // 1. Oklab to Non-linear LMS (Inverse Matrix M2)
+        const l_ = okLab.l + 0.3963377774 * okLab.a + 0.2158037573 * okLab.b;
+        const m_ = okLab.l - 0.1055613458 * okLab.a - 0.0638541728 * okLab.b;
+        const s_ = okLab.l - 0.0894841775 * okLab.a - 1.291485548 * okLab.b;
+        // 2. Linear LMS (cube)
+        const lmsL = l_ * l_ * l_;
+        const lmsM = m_ * m_ * m_;
+        const lmsS = s_ * s_ * s_;
+        // 3. LMS to Linear RGB (Inverse Matrix M1)
+        const lr = 4.0767416621 * lmsL - 3.3077115913 * lmsM + 0.2309699292 * lmsS;
+        const lg = -1.2684380046 * lmsL + 2.6097574011 * lmsM - 0.3413193965 * lmsS;
+        const lb = -0.0041960863 * lmsL - 0.7034186147 * lmsM + 1.707614701 * lmsS;
+        // 4. Linear RGB to sRGB (apply Gamma) & Scale back to [0, 255]
+        return new RGBColor(toSrgb(lr) * 255, toSrgb(lg) * 255, toSrgb(lb) * 255);
+    }
+    /**
+     * Linearly interpolates (Lerps) between two sRGB colors based on an amount (0~1).
+     */
+    static lerp(from, to, amount) {
+        const t = clampAmount(amount);
+        if (t === 0)
+            return from;
+        if (t === 1)
+            return to;
+        // Linear interpolation for each color component
+        const r = Math.round(from.r + (to.r - from.r) * t);
+        const g = Math.round(from.g + (to.g - from.g) * t);
+        const b = Math.round(from.b + (to.b - from.b) * t);
+        return new RGBColor(r, g, b);
+    }
+    /**
+     * Convert to a hex color string.
+     */
+    toHex() {
+        const r = clampSrgb(this.r).toString(16).padStart(2, "0");
+        const g = clampSrgb(this.g).toString(16).padStart(2, "0");
+        const b = clampSrgb(this.b).toString(16).padStart(2, "0");
+        return `#${r}${g}${b}`;
+    }
+    /**
+     * Convert to a OKLab color.
+     */
+    toOKLab() {
+        return OKLabColor.fromRGB(this);
+    }
+}
+export class OKLabColor {
+    /** Lightness */
+    l;
+    /**  Green-Red component */
+    a;
+    /** Blue-Yellow component */
+    b;
+    constructor(l, a, b) {
+        this.l = l;
+        this.a = a;
+        this.b = b;
+    }
+    /**
+     * Converts an RGB color to an Oklab color.
+     * Note: Uses Björn Ottosson's standard Oklab transformation matrices.
+     */
+    static fromRGB(rgb) {
+        // 1. Normalize sRGB to [0, 1] & Convert to Linear RGB
+        const lr = toLinear(rgb.r / 255);
+        const lg = toLinear(rgb.g / 255);
+        const lb = toLinear(rgb.b / 255);
+        // 2. Linear RGB to LMS space (Matrix M1)
+        const lmsL = 0.4122214708 * lr + 0.5363325363 * lg + 0.0514459929 * lb;
+        const lmsM = 0.2119034982 * lr + 0.6806995451 * lg + 0.1073969566 * lb;
+        const lmsS = 0.0883024619 * lr + 0.2817188376 * lg + 0.6299787005 * lb;
+        // 3. Non-linear LMS (cube root)
+        const l_ = Math.cbrt(lmsL);
+        const m_ = Math.cbrt(lmsM);
+        const s_ = Math.cbrt(lmsS);
+        // 4. LMS to Oklab (Matrix M2)
+        return new OKLabColor(0.2104542553 * l_ + 0.793617785 * m_ - 0.0040720468 * s_, 1.9779984951 * l_ - 2.428592205 * m_ + 0.4505937099 * s_, 0.0259040371 * l_ + 0.7827717662 * m_ - 0.808675766 * s_);
+    }
+    /**
+     * Converts an Hex color to an Oklab color.
+     * Note: Uses Björn Ottosson's standard Oklab transformation matrices.
+     */
+    static fromHex(hex) {
+        return OKLabColor.fromRGB(RGBColor.fromHex(hex));
+    }
+    /**
+     * Linearly interpolates (Lerps) between two Oklab colors based on an amount (0~1).
+     */
+    static lerp(from, to, amount) {
+        // Clamp amount between 0 and 1
+        const t = clampAmount(amount);
+        if (t === 0)
+            return from;
+        if (t === 1)
+            return to;
+        return new OKLabColor(from.l + (to.l - from.l) * t, from.a + (to.a - from.a) * t, from.b + (to.b - from.b) * t);
+    }
+    toHex() {
+        return RGBColor.fromOKLab(this).toHex();
+    }
+    toRGB() {
+        return RGBColor.fromOKLab(this);
+    }
+}
+/**
+ * Naturally interpolates between two hex colors in the Oklab color space, then returns the resulting hex color.
+ * @param fromHex Start color (e.g., "#FF0000")
+ * @param toHex Target color (e.g., "#0000FF")
+ * @param amount Transition value (0.0 ~ 1.0)
+ * @returns Interpolated hex color string
+ */
+export function lerpHexColorInOKLab(fromHex, toHex, amount) {
+    // 1. Clamp amount
+    const t = clampAmount(amount);
+    if (t === 0)
+        return fromHex;
+    if (t === 1)
+        return toHex;
+    // 2. Convert RGB to Oklab color space
+    const oklab1 = OKLabColor.fromHex(fromHex);
+    const oklab2 = OKLabColor.fromHex(toHex);
+    // 3. Safely interpolate (Lerp) in the Oklab space
+    const lerpedOklab = OKLabColor.lerp(oklab1, oklab2, t);
+    // 5. Assemble final RGB values back to a hex string (includes clamping)
+    return lerpedOklab.toHex();
+}
+/**
+ * sRGB interpolates between two hex color, then returns the resulting hex color.
+ * @param fromHex Start color (e.g., "#FF0000")
+ * @param toHex Target color (e.g., "#0000FF")
+ * @param amount Transition value (0.0 ~ 1.0)
+ * @returns Interpolated hex color string
+ */
+export function lerpHexColorInSRGB(fromHex, toHex, amount) {
+    const t = clampAmount(amount);
+    if (t === 0)
+        return fromHex;
+    if (t === 1)
+        return toHex;
+    const rgb1 = RGBColor.fromHex(fromHex);
+    const rgb2 = RGBColor.fromHex(toHex);
+    const lerpedRgb = RGBColor.lerp(rgb1, rgb2, t);
+    return lerpedRgb.toHex();
+}
+//# sourceMappingURL=color.js.map

package/dist/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"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"}

package/dist/date.d.ts

@@ -1,9 +1,42 @@
+/**
+ * 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 declare namespace DateUtil {
+    /** Create new date without time */
     function removeTime(dateTime: Date): Date;
+    /** Create new date without time and days */
     function removeDay(dateTime: Date): Date;
-    function formatYYYYMMDD(date: Date): string;
-    function formatUTCYYYYMMDD(date: Date): string;
-    function fromUTCYYYMMDD(str: string): Date;
-    function formatUTCHHMMSS(date: Date): string;
+    /** Formats a date to YYYY-MM-DD */
+    function formatYYYYMMDD(date: Date, delimit?: string): string;
+    /** Formats a date to YYYY-MM */
+    function formatYYYYMM(date: Date, delimit?: string): string;
+    /** Formats a date to HH:MM:SS */
+    function formatHHMMSS(date: Date, delimit?: string): string;
+    /** Formats a date to HH:MM */
+    function formatHHMM(date: Date, delimit?: string): string;
+    /** Formats a date to UTC YYYY-MM-DD */
+    function formatUTCYYYYMMDD(date: Date, delimit?: string): string;
+    /** Formats a date to UTC YYYY-MM */
+    function formatUTCYYYYMM(date: Date, delimit?: string): string;
+    /** Formats a date to UTC HH:MM:SS */
+    function formatUTCHHMMSS(date: Date, delimit?: string): string;
+    /** Formats a date to UTC HH:MM */
+    function formatUTCHHMM(date: Date, delimit?: string): string;
+    /** Parses a string formatted as YYYY-MM-DD into a Date */
+    function fromYYYYMMDD(str: string, delimit?: string): Date;
+    /** Parses a string formatted as YYYY-MM-DD into a UTC Date */
+    function fromUTCYYYYMMDD(str: string, delimit?: string): Date;
+    /** Korean full names of the days of the week */
+    const KoreanWeekNames: string[];
+    /** Korean short names of the days of the week */
+    const KoreanWeekNamesShort: string[];
+    /** English full names of the days of the week */
+    const EnglishWeekNames: string[];
+    /** English short names of the days of the week */
+    const EnglishWeekNamesShort: string[];
 }
 //# sourceMappingURL=date.d.ts.map