@qwreey-js/ts-util 1.0.3 → 1.0.4

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

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,9 +1,9 @@
 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";
 import { setLogErr as _setLogErr } from "./libLog.js";

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;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"}

package/dist/index.js

@@ -1,9 +1,9 @@
 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";
 import { setLogErr as _setLogErr, logErr as _logErr } from "./libLog.js";

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;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"}