@esmalley/ts-utils 1.0.0

package/dist/Arithmetic.d.ts

@@ -0,0 +1,4 @@
+export declare class Arithmetic {
+    static clamp(number: number, min: number, max: number): number;
+}
+//# sourceMappingURL=Arithmetic.d.ts.map

package/dist/Arithmetic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Arithmetic.d.ts","sourceRoot":"","sources":["../src/Arithmetic.ts"],"names":[],"mappings":"AACA,qBAAa,UAAU;WACP,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;CAGtE"}

package/dist/Arithmetic.js

@@ -0,0 +1,5 @@
+export class Arithmetic {
+    static clamp(number, min, max) {
+        return Math.max(min, Math.min(number, max));
+    }
+}

package/dist/Arrayifier.d.ts

@@ -0,0 +1,29 @@
+export declare class Arrayifier {
+    /**
+      * Shuffle / ranomize elements in an array
+      * @param {array} array The array to shuffle
+      * @return array
+      */
+    shuffle(array: Array<unknown>): Array<unknown>;
+    /**
+      *
+      * @param {Array} arr
+      * @param {number} n
+      * @param {number} r
+      * @param {number} index
+      * @param {Array} data
+      * @param {number} i
+      * @param {Array} results
+      * @returns Array
+      */
+    combination(arr: Array<number>, n: number, r: number, index: number, data: number[], i: number, results: number[][]): number[][];
+    /**
+      * Get all combinations of every value in the provided array for a specified number
+      * @param {Array} arr
+      * @param {number} n
+      * @param {number} r
+      * @returns Array
+      */
+    getCombinations(arr: Array<number>, n: number, r: number): number[][];
+}
+//# sourceMappingURL=Arrayifier.d.ts.map

package/dist/Arrayifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Arrayifier.d.ts","sourceRoot":"","sources":["../src/Arrayifier.ts"],"names":[],"mappings":"AACA,qBAAa,UAAU;IAKrB;;;;QAII;IACJ,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;IAkB9C;;;;;;;;;;QAUI;IACJ,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;IAqBnH;;;;;;QAMI;IACJ,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;CAOzD"}

package/dist/Arrayifier.js

@@ -0,0 +1,65 @@
+export class Arrayifier {
+    // constructor() {
+    // }
+    /**
+      * Shuffle / ranomize elements in an array
+      * @param {array} array The array to shuffle
+      * @return array
+      */
+    shuffle(array) {
+        let currentIndex = array.length;
+        let randomIndex;
+        // While there remain elements to shuffle.
+        while (currentIndex !== 0) {
+            // Pick a remaining element.
+            randomIndex = Math.floor(Math.random() * currentIndex);
+            currentIndex--;
+            // And swap it with the current element.
+            [array[currentIndex], array[randomIndex]] = [
+                array[randomIndex], array[currentIndex]
+            ];
+        }
+        return array;
+    }
+    /**
+      *
+      * @param {Array} arr
+      * @param {number} n
+      * @param {number} r
+      * @param {number} index
+      * @param {Array} data
+      * @param {number} i
+      * @param {Array} results
+      * @returns Array
+      */
+    combination(arr, n, r, index, data, i, results) {
+        if (index === r) {
+            const result = [];
+            for (let j = 0; j < r; j++) {
+                result.push(data[j]);
+            }
+            results.push(result);
+            return results;
+        }
+        if (i >= n) {
+            return results;
+        }
+        data[index] = arr[i];
+        this.combination(arr, n, r, index + 1, data, i + 1, results);
+        this.combination(arr, n, r, index, data, i + 1, results);
+        return results;
+    }
+    /**
+      * Get all combinations of every value in the provided array for a specified number
+      * @param {Array} arr
+      * @param {number} n
+      * @param {number} r
+      * @returns Array
+      */
+    getCombinations(arr, n, r) {
+        const data = new Array(r);
+        let results = [];
+        results = this.combination(arr, n, r, 0, data, 0, results);
+        return results;
+    }
+}

package/dist/CSV.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Everything to help with CSV generation
+ */
+export declare class CSV {
+    /**
+     * Convert an object to a CSV file and then download it
+     */
+    static download(data: Record<string, Record<string, unknown>>): void;
+}
+//# sourceMappingURL=CSV.d.ts.map

package/dist/CSV.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CSV.d.ts","sourceRoot":"","sources":["../src/CSV.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,qBAAa,GAAG;IACd;;OAEG;WACW,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;CAiC5E"}

package/dist/CSV.js

@@ -0,0 +1,35 @@
+/**
+ * Everything to help with CSV generation
+ */
+export class CSV {
+    /**
+     * Convert an object to a CSV file and then download it
+     */
+    static download(data) {
+        const rows = [];
+        let setHeaders = false;
+        let headers = [];
+        for (const id in data) {
+            const row = data[id];
+            if (!setHeaders) {
+                headers = Object.keys(row);
+                rows.push(headers.join(','));
+                setHeaders = true;
+            }
+            const values = headers.map((header) => JSON.stringify(row[header] || ''));
+            rows.push(values.join(','));
+        }
+        const content = rows.join('\n');
+        // Create a Blob and trigger download
+        const blob = new Blob([content], { type: 'text/csv' });
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement('a');
+        a.href = url;
+        a.download = 'srating-data.csv';
+        // Trigger download and clean up
+        document.body.appendChild(a);
+        a.click();
+        URL.revokeObjectURL(url);
+        a.remove();
+    }
+}

package/dist/Color.d.ts

@@ -0,0 +1,93 @@
+export declare class Color {
+    /**
+     * A linear interpolator for hexadecimal colors
+     * @param {string} a
+     * @param {string} b
+     * @param {number} amount
+     * @example
+     * // returns #7F7F7F
+     * lerpColor('#000000', '#ffffff', 0.5)
+     * @return {string}
+     */
+    static lerpColor(a: string, b: string, amount: number): string;
+    /**
+     * Get a color that will look readable based on a background color
+     */
+    static getTextColor(color: string, backgroundColor: string, debug?: boolean): string;
+    static getContrastRatio(rgb1: [number, number, number], rgb2: [number, number, number]): number;
+    /**
+     * Take a hex (#fff) and an amount and darken the color, return a hex
+     * @param {string} hex
+     * @param {number} amount
+     * @return {string} hex
+     */
+    /**
+     * Take a hex (#fff) and an amount and lighten the color, return a hex
+     * @param {string} hex
+     * @param {number} amount
+     * @return {string} hex
+     */
+    /**
+     * Mixes the color with black to create a Shade.
+     * Prevents the "muddy/brown" look of HSL darkening.
+     * @param {string} hex - The color to darken
+     * @param {number} amount - 0 to 1 (e.g. 0.1 is 10% darker)
+     * @return {string} hex
+     */
+    static darken(hex: string, amount?: number): string;
+    /**
+     * Mixes the color with white to create a Tint.
+     * cleaner and less "washed out" than HSL lightness adjustment.
+     * @param {string} hex - The color to lighten
+     * @param {number} amount - 0 to 1 (e.g. 0.1 is 10% lighter)
+     * @return {string} hex
+     */
+    static lighten(hex: string, amount?: number): string;
+    static shadeColor(hex: string, percent: number): string;
+    /**
+     * Are 2 colors similar to each other?
+     * @param {string} color1
+     * @param {string} color2
+     * @param {number} threshold
+     * @return {boolean}
+     */
+    static areColorsSimilar(color1: string, color2: string, threshold?: number): boolean;
+    /**
+     * Inverts a hex color
+     * @param {string} hex
+     * @return {string} hex
+     */
+    static invertColor(hex: string): string;
+    /**
+     * Takes a hex (#fff) and returns an rgba with the provided alpha
+     * @param {string} hex
+     * @param {number} alpha
+     * @return {string} rgba()
+     */
+    static alphaColor(hex: string, alpha: number): string;
+    /**
+     * Gets analogous colors
+     * @param {string} hex
+     * @return {Array<string>}
+     */
+    static getAnalogousColors(hex: string): string[];
+    /**
+     * Convert hex to rgb
+     * @param {string} hex
+     * @return {Array} rgb
+     */
+    static hexToRgb(hex: string): Array<number>;
+    /**
+     * Convert rgb to hex
+     * @param {number} r
+     * @param {number} g
+     * @param {number} b
+     * @return {string}
+     */
+    private static rgbToHex;
+    private static rgbToHsl;
+    private static hslToRgb;
+    private static calculateBrightness;
+    private static colorDistance;
+}
+//# 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":"AAIA,qBAAa,KAAK;IAKhB;;;;;;;;;OASG;WACW,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAkBrE;;OAEG;WACW,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,UAAQ;WAoFlE,gBAAgB,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAiBtG;;;;;OAKG;IAWH;;;;;OAKG;IAWH;;;;;;OAMG;WACW,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY,GAAG,MAAM;IAa/D;;;;;;OAMG;WACW,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY,GAAG,MAAM;WAalD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAWrD;;;;;;OAMG;WACW,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,SAAK;IAM7E;;;;OAIG;WACW,WAAW,CAAC,GAAG,EAAE,MAAM;IAYrC;;;;;OAKG;WACW,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO5D;;;;OAIG;WACW,kBAAkB,CAAC,GAAG,EAAE,MAAM;IAmB5C;;;;OAIG;WACW,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAwBlD;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;IAIvB,OAAO,CAAC,MAAM,CAAC,QAAQ;IAyBvB,OAAO,CAAC,MAAM,CAAC,QAAQ;IA8BvB,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAKlC,OAAO,CAAC,MAAM,CAAC,aAAa;CAU7B"}

package/dist/Color.js

@@ -0,0 +1,344 @@
+/* eslint-disable no-mixed-operators */
+/* eslint-disable no-bitwise */
+export class Color {
+    // constructor() {
+    // }
+    /**
+     * A linear interpolator for hexadecimal colors
+     * @param {string} a
+     * @param {string} b
+     * @param {number} amount
+     * @example
+     * // returns #7F7F7F
+     * lerpColor('#000000', '#ffffff', 0.5)
+     * @return {string}
+     */
+    static lerpColor(a, b, amount) {
+        const ah = +a.replace('#', '0x');
+        const ar = ah >> 16;
+        const ag = ah >> 8 & 0xff;
+        const ab = ah & 0xff;
+        const bh = +b.replace('#', '0x');
+        const br = bh >> 16;
+        const bg = bh >> 8 & 0xff;
+        const bb = bh & 0xff;
+        const rr = ar + amount * (br - ar);
+        const rg = ag + amount * (bg - ag);
+        const rb = ab + amount * (bb - ab);
+        return `#${((1 << 24) + (rr << 16) + (rg << 8) + rb | 0).toString(16).slice(1)}`;
+    }
+    /**
+     * Get a color that will look readable based on a background color
+     */
+    static getTextColor(color, backgroundColor, debug = false) {
+        // Convert hex colors to RGB
+        /*
+        let [r1, g1, b1] = Color.hexToRgb(color);
+        const [r2, g2, b2] = Color.hexToRgb(backgroundColor);
+    
+        const brightnessBg = Color.calculateBrightness(r2, g2, b2);
+    
+        const targetBrightness = brightnessBg > 128 ? 50 : 150; // target brightness threshold for contrast
+    
+        while (true) {
+          const brightnessColor = Color.calculateBrightness(r1, g1, b1);
+    
+          if (
+            (brightnessBg > 128 && brightnessColor < targetBrightness) ||
+            (brightnessBg <= 128 && brightnessColor > targetBrightness)
+          ) {
+            break;
+          }
+    
+          if (brightnessBg > 128) {
+            r1 = Math.max(0, r1 - 25);
+            g1 = Math.max(0, g1 - 25);
+            b1 = Math.max(0, b1 - 25);
+          } else {
+            r1 = Math.min(255, r1 + 25);
+            g1 = Math.min(255, g1 + 25);
+            b1 = Math.min(255, b1 + 25);
+          }
+    
+          if ((r1 === 0 && g1 === 0 && b1 === 0) || (r1 === 255 && g1 === 255 && b1 === 255)) {
+            break; // avoid infinite loop
+          }
+        }
+    
+        // Convert back to hex
+        return Color.rgbToHex(r1, g1, b1);
+        */
+        let [r, g, b] = Color.hexToRgb(color);
+        const [br, bg, bb] = Color.hexToRgb(backgroundColor);
+        const contrastTarget = 4.5;
+        if (debug) {
+            console.log('Color.getContrastRatio([r, g, b], [br, bg, bb])', Color.getContrastRatio([r, g, b], [br, bg, bb]));
+        }
+        if (Color.getContrastRatio([r, g, b], [br, bg, bb]) >= contrastTarget) {
+            return Color.rgbToHex(r, g, b);
+        }
+        const contrastToBlack = Color.getContrastRatio([0, 0, 0], [br, bg, bb]);
+        const contrastToWhite = Color.getContrastRatio([255, 255, 255], [br, bg, bb]);
+        const direction = contrastToWhite > contrastToBlack ? 'lighter' : 'darker';
+        if (debug) {
+            console.log('contrastToBlack', contrastToBlack);
+            console.log('contrastToWhite', contrastToWhite);
+            console.log('direction', direction);
+        }
+        const adjust = (c, lighter) => {
+            return lighter ? Math.min(255, c + 10) : Math.max(0, c - 10);
+        };
+        for (let i = 0; i < 25; i++) {
+            r = adjust(r, direction === 'lighter');
+            g = adjust(g, direction === 'lighter');
+            b = adjust(b, direction === 'lighter');
+            if (debug) {
+                console.log('Color.getContrastRatio([r, g, b], [br, bg, bb]) 2', Color.getContrastRatio([r, g, b], [br, bg, bb]));
+            }
+            if (Color.getContrastRatio([r, g, b], [br, bg, bb]) >= contrastTarget) {
+                break;
+            }
+        }
+        return Color.rgbToHex(r, g, b);
+    }
+    static getContrastRatio(rgb1, rgb2) {
+        const luminance = (r, g, b) => {
+            const a = [r, g, b].map((v) => {
+                v /= 255;
+                return v <= 0.03928
+                    ? v / 12.92
+                    : Math.pow((v + 0.055) / 1.055, 2.4);
+            });
+            return a[0] * 0.2126 + a[1] * 0.7152 + a[2] * 0.0722;
+        };
+        const lum1 = luminance(...rgb1) + 0.05;
+        const lum2 = luminance(...rgb2) + 0.05;
+        return lum1 > lum2 ? lum1 / lum2 : lum2 / lum1;
+    }
+    /**
+     * Take a hex (#fff) and an amount and darken the color, return a hex
+     * @param {string} hex
+     * @param {number} amount
+     * @return {string} hex
+     */
+    // public static darken(hex: string, amount: number = 0.02): string {
+    //   const [r, g, b] = this.hexToRgb(hex);
+    //   const [h, s, l] = this.rgbToHsl(r, g, b);
+    //   const newL = Math.max(0, (l / 100) - amount) * 100;
+    //   const [r2, g2, b2] = this.hslToRgb(h, s, newL);
+    //   return this.rgbToHex(r2, g2, b2);
+    // }
+    /**
+     * Take a hex (#fff) and an amount and lighten the color, return a hex
+     * @param {string} hex
+     * @param {number} amount
+     * @return {string} hex
+     */
+    // public static lighten(hex: string, amount: number = 0.02): string {
+    //   const [r, g, b] = this.hexToRgb(hex);
+    //   const [h, s, l] = this.rgbToHsl(r, g, b);
+    //   const newL = Math.min(1, (l / 100) + amount) * 100;
+    //   const [r2, g2, b2] = this.hslToRgb(h, s, newL);
+    //   return this.rgbToHex(r2, g2, b2);
+    // }
+    /**
+     * Mixes the color with black to create a Shade.
+     * Prevents the "muddy/brown" look of HSL darkening.
+     * @param {string} hex - The color to darken
+     * @param {number} amount - 0 to 1 (e.g. 0.1 is 10% darker)
+     * @return {string} hex
+     */
+    static darken(hex, amount = 0.1) {
+        const [r, g, b] = this.hexToRgb(hex);
+        // Calculate new color by mixing with black (0)
+        // Formula: Current * (1 - amount)
+        const remaining = 1 - amount;
+        const r2 = Math.round(r * remaining);
+        const g2 = Math.round(g * remaining);
+        const b2 = Math.round(b * remaining);
+        return this.rgbToHex(r2, g2, b2);
+    }
+    /**
+     * Mixes the color with white to create a Tint.
+     * cleaner and less "washed out" than HSL lightness adjustment.
+     * @param {string} hex - The color to lighten
+     * @param {number} amount - 0 to 1 (e.g. 0.1 is 10% lighter)
+     * @return {string} hex
+     */
+    static lighten(hex, amount = 0.1) {
+        const [r, g, b] = this.hexToRgb(hex);
+        // Calculate new color by mixing with white (255)
+        // Formula: Current + ((Target - Current) * amount)
+        const r2 = Math.round(r + (255 - r) * amount);
+        const g2 = Math.round(g + (255 - g) * amount);
+        const b2 = Math.round(b + (255 - b) * amount);
+        return this.rgbToHex(r2, g2, b2);
+    }
+    static shadeColor(hex, percent) {
+        let [r, g, b] = Color.hexToRgb(hex);
+        r = Math.min(255, Math.max(0, Math.round(r + (r * (percent / 100)))));
+        g = Math.min(255, Math.max(0, Math.round(g + (g * (percent / 100)))));
+        b = Math.min(255, Math.max(0, Math.round(b + (b * (percent / 100)))));
+        return Color.rgbToHex(r, g, b);
+    }
+    /**
+     * Are 2 colors similar to each other?
+     * @param {string} color1
+     * @param {string} color2
+     * @param {number} threshold
+     * @return {boolean}
+     */
+    static areColorsSimilar(color1, color2, threshold = 50) {
+        const distance = Color.colorDistance(color1, color2);
+        return distance < threshold;
+    }
+    /**
+     * Inverts a hex color
+     * @param {string} hex
+     * @return {string} hex
+     */
+    static invertColor(hex) {
+        const [r, g, b] = Color.hexToRgb(hex);
+        // Invert each color component
+        const invertedR = 255 - r;
+        const invertedG = 255 - g;
+        const invertedB = 255 - b;
+        return Color.rgbToHex(invertedR, invertedG, invertedB);
+    }
+    /**
+     * Takes a hex (#fff) and returns an rgba with the provided alpha
+     * @param {string} hex
+     * @param {number} alpha
+     * @return {string} rgba()
+     */
+    static alphaColor(hex, alpha) {
+        const [r, g, b] = this.hexToRgb(hex);
+        return `rgba(${r}, ${g}, ${b}, ${alpha})`;
+    }
+    /**
+     * Gets analogous colors
+     * @param {string} hex
+     * @return {Array<string>}
+     */
+    static getAnalogousColors(hex) {
+        const [r, g, b] = Color.hexToRgb(hex);
+        const [h, s, l] = Color.rgbToHsl(r, g, b);
+        const analogousColors = [];
+        const offset = 30; // Offset for analogous colors, usually 30 degrees
+        for (let i = -1; i <= 1; i++) {
+            if (i !== 0) {
+                const newHue = (h + i * offset + 360) % 360;
+                const [newR, newG, newB] = Color.hslToRgb(newHue, s, l);
+                analogousColors.push(Color.rgbToHex(newR, newG, newB));
+            }
+        }
+        return analogousColors;
+    }
+    /**
+     * Convert hex to rgb
+     * @param {string} hex
+     * @return {Array} rgb
+     */
+    static hexToRgb(hex) {
+        // Remove the hash at the start if it's there
+        let h = hex.replace(/^#/, '');
+        // Handle 3-character hex codes by expanding them to 6-character
+        if (h.length === 3) {
+            h = h.split('').map((char) => { return char + char; }).join('');
+        }
+        // Ensure it's a valid 6-character hex code
+        if (h.length !== 6) {
+            throw new Error(`Invalid hex color format: ${hex}`);
+        }
+        // Parse r, g, b values
+        const bigint = parseInt(h, 16);
+        const r = (bigint >> 16) & 255;
+        const g = (bigint >> 8) & 255;
+        const b = bigint & 255;
+        return [r, g, b];
+    }
+    /**
+     * Convert rgb to hex
+     * @param {number} r
+     * @param {number} g
+     * @param {number} b
+     * @return {string}
+     */
+    static rgbToHex(r, g, b) {
+        return `#${((1 << 24) + (r << 16) + (g << 8) + b).toString(16).slice(1).toUpperCase()}`;
+    }
+    static rgbToHsl(r, g, b) {
+        r /= 255;
+        g /= 255;
+        b /= 255;
+        const max = Math.max(r, g, b);
+        const min = Math.min(r, g, b);
+        let h = 0;
+        let s = 0;
+        const l = (max + min) / 2;
+        if (max === min) {
+            h = s = 0; // achromatic
+        }
+        else {
+            const d = max - min;
+            s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+            switch (max) {
+                case r:
+                    h = (g - b) / d + (g < b ? 6 : 0);
+                    break;
+                case g:
+                    h = (b - r) / d + 2;
+                    break;
+                case b:
+                    h = (r - g) / d + 4;
+                    break;
+            }
+            h /= 6;
+        }
+        return [h * 360, s * 100, l * 100];
+    }
+    static hslToRgb(h, s, l) {
+        let r;
+        let g;
+        let b;
+        h /= 360;
+        s /= 100;
+        l /= 100;
+        if (s === 0) {
+            r = g = b = l; // achromatic
+        }
+        else {
+            const hue2rgb = (p, q, t) => {
+                if (t < 0)
+                    t += 1;
+                if (t > 1)
+                    t -= 1;
+                if (t < 1 / 6)
+                    return p + (q - p) * 6 * t;
+                if (t < 1 / 3)
+                    return q;
+                if (t < 1 / 2)
+                    return p + (q - p) * (2 / 3 - t) * 6;
+                return p;
+            };
+            const q = l < 0.5 ? l * (1 + s) : l + s - l * s;
+            const p = 2 * l - q;
+            r = hue2rgb(p, q, h + 1 / 3);
+            g = hue2rgb(p, q, h);
+            b = hue2rgb(p, q, h - 1 / 3);
+        }
+        return [Math.round(r * 255), Math.round(g * 255), Math.round(b * 255)];
+    }
+    static calculateBrightness(r, g, b) {
+        // Calculate the brightness of the color
+        return (r * 299 + g * 587 + b * 114) / 1000;
+    }
+    static colorDistance(color1, color2) {
+        const [r1, g1, b1] = Color.hexToRgb(color1);
+        const [r2, g2, b2] = Color.hexToRgb(color2);
+        const dr = r1 - r2;
+        const dg = g1 - g2;
+        const db = b1 - b2;
+        return Math.sqrt(dr * dr + dg * dg + db * db);
+    }
+}

package/dist/Dates.d.ts

@@ -0,0 +1,51 @@
+export declare class Dates {
+    static parse(str?: Date | string | number | undefined | null, utc?: boolean): Date;
+    static utc(date: Date | string | number): Date;
+    static getMonthsShort(): string[];
+    static getMonths(): string[];
+    static getDaysShort(): string[];
+    static getDays(): string[];
+    /**
+     * Format a date using php syntax
+     *
+      | Token | Meaning                   | Example |
+      | ----- | ------------------------- | ------- |
+      | `Y`   | 4-digit year              | 2025    |
+      | `y`   | 2-digit year              | 25      |
+      | `m`   | 2-digit month             | 03      |
+      | `n`   | month (no leading zero)   | 3       |
+      | `d`   | day (2-digit)             | 09      |
+      | `j`   | day (no leading zero)     | 9       |
+      | `S`   | Ordinal suffix            | th      |
+      | `H`   | 24-hour                   | 14      |
+      | `G`   | 24-hour (no leading zero) | 14      |
+      | `h`   | 12-hour                   | 02      |
+      | `g`   | 12-hour (no leading zero) | 2       |
+      | `i`   | minutes                   | 05      |
+      | `s`   | seconds                   | 09      |
+      | `A`   | AM/PM                     | PM      |
+      | `a`   | am/pm                     | pm      |
+      | `w`   | day of week (0–6)         | 1       |
+      | `N`   | day of week (1–7)         | 2       |
+      | `M`   | short month name          | Mar     |
+      | `F`   | full month name           | March   |
+      | `D`   | short weekday             | Mon     |
+      | `l`   | full weekday              | Monday  |
+     */
+    static format(dateInput: Date | string, format: string): string;
+    static add(date: Date | string, amount: number, unit: 'years' | 'months' | 'days' | 'hours' | 'minutes'): Date;
+    static subtract(date: Date | string, amount: number, unit: 'years' | 'months' | 'days' | 'hours' | 'minutes'): Date;
+    static fromNow(date: Date | string): string;
+    /**
+     * Find the closest date in an array of dates
+     */
+    static getClosestDate(dateToMatch: string | Date, datesArray: string[]): string | null;
+    static getTodayEST(): string;
+    static getStartOfDay(date: Date | string): Date;
+    static getStartOfMonth(date: Date | string): Date;
+    static getStartOfGrid(date: Date | string): Date;
+    static isSameDay(date1: Date | string, date2: Date | string): boolean;
+    static isBeforeDay(date1: Date | string, date2: Date | string): boolean;
+    static isAfterDay(date1: Date | string, date2: Date | string): boolean;
+}
+//# sourceMappingURL=Dates.d.ts.map

package/dist/Dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dates.d.ts","sourceRoot":"","sources":["../src/Dates.ts"],"names":[],"mappings":"AAIA,qBAAa,KAAK;WAYF,KAAK,CACjB,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,EAC/C,GAAG,UAAQ,GACV,IAAI;WA8FO,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI;WAKvC,cAAc,IAAI,MAAM,EAAE;WAI1B,SAAS,IAAI,MAAM,EAAE;WAIrB,YAAY,IAAI,MAAM,EAAE;WAIxB,OAAO,IAAI,MAAM,EAAE;IAIjC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;WACW,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM;WAgG/C,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS;WAkChG,QAAQ,CACpB,IAAI,EAAE,IAAI,GAAG,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS;WAK3C,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IA6BzC;;OAEG;WACW,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI;WA+B/E,WAAW;WAIX,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;WAMjC,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;WAOnC,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;WAWlC,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM;WAepD,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM;WAQtD,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM;CAMpE"}