@etsoo/shared 1.1.16 → 1.1.19

package/README.md

@@ -190,5 +190,6 @@ String and other related utilities
 |objectUpdated|Get the new object's updated fields contrast to the previous object|
 |parseString|Parse string (JSON) to specific type|
 |removeNonLetters|Remove non letters (0-9, a-z, A-Z)|
+|replaceNullOrEmpty|Replace null or empty with default value|
 |setLabels|Set source with new labels|
 |snakeNameToWord|Snake name to works, 'snake_name' to 'Snake Name'|

package/__tests__/{EColor.ts → ColorUtils.ts}

@@ -1,4 +1,5 @@
 import { EColor } from '../src/types/EColor';
+import { ColorUtils } from '../src/ColorUtils';
 
 test('Tests for parse', () => {
     // Arrange & act
@@ -13,6 +14,13 @@ test('Tests for parse', () => {
 });
 
 test('Tests for getColors', () => {
-    const colors = EColor.getColors(undefined, 128);
+    const colors = ColorUtils.getColors(undefined, 128);
     expect(colors.length).toBe(8);
 });
+
+test('Tests for toRGBColor', () => {
+    const color = new EColor(0, 0, 0);
+    expect(color.toRGBColor()).toBe('RGB(0, 0, 0)');
+    expect(color.toRGBColor(0.1)).toBe('RGBA(0, 0, 0, 0.1)');
+    expect(color.alpha).toBeUndefined();
+});

package/__tests__/Utils.ts

@@ -126,6 +126,12 @@ test('Tests for removeNonLetters', () => {
     expect(input.removeNonLetters()).toBe(result);
 });
 
+test('Tests for replaceNullOrEmpty', () => {
+    expect(Utils.replaceNullOrEmpty('a', 's')).toBe('a');
+    expect(Utils.replaceNullOrEmpty(null, 's')).toBe('s');
+    expect(Utils.replaceNullOrEmpty(' ', 's')).toBe('s');
+});
+
 test('Tests for objectEqual', () => {
     const obj1 = { a: 1, b: 'abc', c: true, d: null, f: [1, 2] };
     const obj2 = { a: '1', b: 'abc', c: true, f: [1, 2] };

package/lib/cjs/ColorUtils.d.ts

@@ -0,0 +1,23 @@
+import { EColor } from './types/EColor';
+/**
+ * Color utils
+ */
+export declare namespace ColorUtils {
+    /**
+     * Get HEX or RGB colors
+     * @param init Initial color
+     * @param factor Increase factor
+     * @param adjustOrder Adjust order to increase difference
+     * @param hex to HEX or not
+     * @returns Result
+     */
+    function getColors(init?: string, factor?: number, adjustOrder?: boolean, hex?: boolean): string[];
+    /**
+     * Get EColors
+     * @param init Initial color
+     * @param factor Increase factor
+     * @param adjustOrder Adjust order to increase difference
+     * @returns Result
+     */
+    function getEColors(init?: string, factor?: number, adjustOrder?: boolean): EColor[];
+}

package/lib/cjs/ColorUtils.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ColorUtils = void 0;
+const EColor_1 = require("./types/EColor");
+/**
+ * Color utils
+ */
+var ColorUtils;
+(function (ColorUtils) {
+    /**
+     * Get HEX or RGB colors
+     * @param init Initial color
+     * @param factor Increase factor
+     * @param adjustOrder Adjust order to increase difference
+     * @param hex to HEX or not
+     * @returns Result
+     */
+    function getColors(init = '#000', factor = 51, adjustOrder = true, hex = true) {
+        return getEColors(init, factor, adjustOrder).map((c) => hex ? c.toHEXColor() : c.toRGBColor());
+    }
+    ColorUtils.getColors = getColors;
+    /**
+     * Get EColors
+     * @param init Initial color
+     * @param factor Increase factor
+     * @param adjustOrder Adjust order to increase difference
+     * @returns Result
+     */
+    function getEColors(init = '#000', factor = 51, adjustOrder = true) {
+        var _a;
+        // Init color
+        const initColor = (_a = EColor_1.EColor.parse(init)) !== null && _a !== void 0 ? _a : new EColor_1.EColor(0, 0, 0);
+        // Factors elements
+        // 51 = '00', '33', '66', '99', 'cc', 'ff'
+        const factors = [];
+        let f = 0;
+        while (f <= 255) {
+            factors.push(f);
+            f += factor;
+        }
+        // RGB loop
+        const colors = [initColor];
+        for (const r of factors) {
+            for (const g of factors) {
+                for (const b of factors) {
+                    colors.push(initColor.clone(r, g, b));
+                }
+            }
+        }
+        // Non-nullable colors
+        const nColors = colors.filter((color) => color != null);
+        // Adjust order
+        if (adjustOrder) {
+            const firstColor = nColors.shift();
+            if (firstColor) {
+                let color = firstColor;
+                const newColors = [color];
+                while (nColors.length > 0) {
+                    const result = nColors.reduce((p, c, index) => {
+                        const delta = color.getDeltaValue(c);
+                        if (delta != null && delta > p.delta) {
+                            p.delta = delta;
+                            p.color = c;
+                            p.index = index;
+                        }
+                        return p;
+                    }, { delta: 0, color, index: -1 });
+                    if (result.delta > 0) {
+                        color = result.color;
+                        newColors.push(color);
+                        nColors.splice(result.index, 1);
+                    }
+                }
+                return newColors;
+            }
+        }
+        return nColors;
+    }
+    ColorUtils.getEColors = getEColors;
+})(ColorUtils = exports.ColorUtils || (exports.ColorUtils = {}));

package/lib/cjs/Utils.d.ts

@@ -189,6 +189,13 @@ export declare namespace Utils {
      * @returns Result
      */
     const removeNonLetters: (input?: string | undefined) => string | undefined;
+    /**
+     * Replace null or empty with default value
+     * @param input Input string
+     * @param defaultValue Default value
+     * @returns Result
+     */
+    const replaceNullOrEmpty: (input: string | null | undefined, defaultValue: string) => string;
     /**
      * Set source with new labels
      * @param source Source

package/lib/cjs/Utils.js

@@ -371,6 +371,17 @@ var Utils;
     Utils.removeNonLetters = (input) => {
         return input === null || input === void 0 ? void 0 : input.removeNonLetters();
     };
+    /**
+     * Replace null or empty with default value
+     * @param input Input string
+     * @param defaultValue Default value
+     * @returns Result
+     */
+    Utils.replaceNullOrEmpty = (input, defaultValue) => {
+        if (input == null || input.trim() === '')
+            return defaultValue;
+        return input;
+    };
     /**
      * Set source with new labels
      * @param source Source

package/lib/cjs/index.d.ts

@@ -4,6 +4,7 @@ export * from './types/FormData';
 export * from './storage/IStorage';
 export * from './storage/WindowStorage';
 export * from './DataTypes';
+export * from './ColorUtils';
 export * from './DateUtils';
 export * from './DomUtils';
 export * from './ExtendUtils';

package/lib/cjs/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./types/FormData"), exports);
 __exportStar(require("./storage/IStorage"), exports);
 __exportStar(require("./storage/WindowStorage"), exports);
 __exportStar(require("./DataTypes"), exports);
+__exportStar(require("./ColorUtils"), exports);
 __exportStar(require("./DateUtils"), exports);
 __exportStar(require("./DomUtils"), exports);
 __exportStar(require("./ExtendUtils"), exports);

package/lib/cjs/types/EColor.d.ts

@@ -13,23 +13,6 @@ export declare class EColor {
      * @returns Adjusted value
      */
     static adjust(value: number, adjust?: number): number;
-    /**
-     * Get HEX or RGB colors
-     * @param init Initial color
-     * @param factor Increase factor
-     * @param adjustOrder Adjust order to increase difference
-     * @param hex to HEX or not
-     * @returns Result
-     */
-    static getColors(init?: string, factor?: number, adjustOrder?: boolean, hex?: boolean): string[];
-    /**
-     * Get EColors
-     * @param init Initial color
-     * @param factor Increase factor
-     * @param adjustOrder Adjust order to increase difference
-     * @returns Result
-     */
-    static getEColors(init?: string, factor?: number, adjustOrder?: boolean): EColor[];
     /**
      * HEX string to integer value
      * @param hex HEX string
@@ -98,8 +81,8 @@ export declare class EColor {
     toLabValue(): [number, number, number];
     /**
      * To RGB color string
-     * @param includeAlpha Include alpha or not
+     * @param alpha Alpha value, false means ignore it
      * @returns RGB color string
      */
-    toRGBColor(includeAlpha?: boolean): string;
+    toRGBColor(alpha?: boolean | number): string;
 }

package/lib/cjs/types/EColor.js

@@ -32,74 +32,6 @@ class EColor {
             return value % 255;
         return value;
     }
-    /**
-     * Get HEX or RGB colors
-     * @param init Initial color
-     * @param factor Increase factor
-     * @param adjustOrder Adjust order to increase difference
-     * @param hex to HEX or not
-     * @returns Result
-     */
-    static getColors(init = '#000', factor = 51, adjustOrder = true, hex = true) {
-        return EColor.getEColors(init, factor, adjustOrder).map((c) => hex ? c.toHEXColor() : c.toRGBColor());
-    }
-    /**
-     * Get EColors
-     * @param init Initial color
-     * @param factor Increase factor
-     * @param adjustOrder Adjust order to increase difference
-     * @returns Result
-     */
-    static getEColors(init = '#000', factor = 51, adjustOrder = true) {
-        var _a;
-        // Init color
-        const initColor = (_a = EColor.parse(init)) !== null && _a !== void 0 ? _a : new EColor(0, 0, 0);
-        // Factors elements
-        // 51 = '00', '33', '66', '99', 'cc', 'ff'
-        const factors = [];
-        let f = 0;
-        while (f <= 255) {
-            factors.push(f);
-            f += factor;
-        }
-        // RGB loop
-        const colors = [initColor];
-        for (const r of factors) {
-            for (const g of factors) {
-                for (const b of factors) {
-                    colors.push(initColor.clone(r, g, b));
-                }
-            }
-        }
-        // Non-nullable colors
-        const nColors = colors.filter((color) => color != null);
-        // Adjust order
-        if (adjustOrder) {
-            const firstColor = nColors.shift();
-            if (firstColor) {
-                let color = firstColor;
-                const newColors = [color];
-                while (nColors.length > 0) {
-                    const result = nColors.reduce((p, c, index) => {
-                        const delta = color.getDeltaValue(c);
-                        if (delta != null && delta > p.delta) {
-                            p.delta = delta;
-                            p.color = c;
-                            p.index = index;
-                        }
-                        return p;
-                    }, { delta: 0, color, index: -1 });
-                    if (result.delta > 0) {
-                        color = result.color;
-                        newColors.push(color);
-                        nColors.splice(result.index, 1);
-                    }
-                }
-                return newColors;
-            }
-        }
-        return nColors;
-    }
     /**
      * HEX string to integer value
      * @param hex HEX string
@@ -125,7 +57,7 @@ class EColor {
         // Null
         if (htmlColor == null)
             return undefined;
-        htmlColor = htmlColor.toUpperCase();
+        htmlColor = htmlColor.trim().toUpperCase();
         // HEX color
         if (htmlColor.startsWith('#')) {
             htmlColor = htmlColor.substring(1);
@@ -250,15 +182,24 @@ class EColor {
     }
     /**
      * To RGB color string
-     * @param includeAlpha Include alpha or not
+     * @param alpha Alpha value, false means ignore it
      * @returns RGB color string
      */
-    toRGBColor(includeAlpha) {
-        var _a;
-        // Default case
-        includeAlpha !== null && includeAlpha !== void 0 ? includeAlpha : (includeAlpha = this.alpha != null);
+    toRGBColor(alpha) {
+        // Decide
+        let includeAlpha, alphaValue = this.alpha;
+        if (typeof alpha === 'number') {
+            alphaValue = alpha;
+            includeAlpha = true;
+        }
+        else if (alpha == null) {
+            includeAlpha = this.alpha != null;
+        }
+        else {
+            includeAlpha = alpha;
+        }
         if (includeAlpha)
-            return `RGBA(${this.r}, ${this.g}, ${this.b}, ${(_a = this.alpha) !== null && _a !== void 0 ? _a : 1})`;
+            return `RGBA(${this.r}, ${this.g}, ${this.b}, ${alphaValue !== null && alphaValue !== void 0 ? alphaValue : 1})`;
         return `RGB(${this.r}, ${this.g}, ${this.b})`;
     }
 }

package/lib/mjs/ColorUtils.d.ts

@@ -0,0 +1,23 @@
+import { EColor } from './types/EColor';
+/**
+ * Color utils
+ */
+export declare namespace ColorUtils {
+    /**
+     * Get HEX or RGB colors
+     * @param init Initial color
+     * @param factor Increase factor
+     * @param adjustOrder Adjust order to increase difference
+     * @param hex to HEX or not
+     * @returns Result
+     */
+    function getColors(init?: string, factor?: number, adjustOrder?: boolean, hex?: boolean): string[];
+    /**
+     * Get EColors
+     * @param init Initial color
+     * @param factor Increase factor
+     * @param adjustOrder Adjust order to increase difference
+     * @returns Result
+     */
+    function getEColors(init?: string, factor?: number, adjustOrder?: boolean): EColor[];
+}

package/lib/mjs/ColorUtils.js

@@ -0,0 +1,77 @@
+import { EColor } from './types/EColor';
+/**
+ * Color utils
+ */
+export var ColorUtils;
+(function (ColorUtils) {
+    /**
+     * Get HEX or RGB colors
+     * @param init Initial color
+     * @param factor Increase factor
+     * @param adjustOrder Adjust order to increase difference
+     * @param hex to HEX or not
+     * @returns Result
+     */
+    function getColors(init = '#000', factor = 51, adjustOrder = true, hex = true) {
+        return getEColors(init, factor, adjustOrder).map((c) => hex ? c.toHEXColor() : c.toRGBColor());
+    }
+    ColorUtils.getColors = getColors;
+    /**
+     * Get EColors
+     * @param init Initial color
+     * @param factor Increase factor
+     * @param adjustOrder Adjust order to increase difference
+     * @returns Result
+     */
+    function getEColors(init = '#000', factor = 51, adjustOrder = true) {
+        var _a;
+        // Init color
+        const initColor = (_a = EColor.parse(init)) !== null && _a !== void 0 ? _a : new EColor(0, 0, 0);
+        // Factors elements
+        // 51 = '00', '33', '66', '99', 'cc', 'ff'
+        const factors = [];
+        let f = 0;
+        while (f <= 255) {
+            factors.push(f);
+            f += factor;
+        }
+        // RGB loop
+        const colors = [initColor];
+        for (const r of factors) {
+            for (const g of factors) {
+                for (const b of factors) {
+                    colors.push(initColor.clone(r, g, b));
+                }
+            }
+        }
+        // Non-nullable colors
+        const nColors = colors.filter((color) => color != null);
+        // Adjust order
+        if (adjustOrder) {
+            const firstColor = nColors.shift();
+            if (firstColor) {
+                let color = firstColor;
+                const newColors = [color];
+                while (nColors.length > 0) {
+                    const result = nColors.reduce((p, c, index) => {
+                        const delta = color.getDeltaValue(c);
+                        if (delta != null && delta > p.delta) {
+                            p.delta = delta;
+                            p.color = c;
+                            p.index = index;
+                        }
+                        return p;
+                    }, { delta: 0, color, index: -1 });
+                    if (result.delta > 0) {
+                        color = result.color;
+                        newColors.push(color);
+                        nColors.splice(result.index, 1);
+                    }
+                }
+                return newColors;
+            }
+        }
+        return nColors;
+    }
+    ColorUtils.getEColors = getEColors;
+})(ColorUtils || (ColorUtils = {}));

package/lib/mjs/Utils.d.ts

@@ -189,6 +189,13 @@ export declare namespace Utils {
      * @returns Result
      */
     const removeNonLetters: (input?: string | undefined) => string | undefined;
+    /**
+     * Replace null or empty with default value
+     * @param input Input string
+     * @param defaultValue Default value
+     * @returns Result
+     */
+    const replaceNullOrEmpty: (input: string | null | undefined, defaultValue: string) => string;
     /**
      * Set source with new labels
      * @param source Source

package/lib/mjs/Utils.js

@@ -368,6 +368,17 @@ export var Utils;
     Utils.removeNonLetters = (input) => {
         return input === null || input === void 0 ? void 0 : input.removeNonLetters();
     };
+    /**
+     * Replace null or empty with default value
+     * @param input Input string
+     * @param defaultValue Default value
+     * @returns Result
+     */
+    Utils.replaceNullOrEmpty = (input, defaultValue) => {
+        if (input == null || input.trim() === '')
+            return defaultValue;
+        return input;
+    };
     /**
      * Set source with new labels
      * @param source Source

package/lib/mjs/index.d.ts

@@ -4,6 +4,7 @@ export * from './types/FormData';
 export * from './storage/IStorage';
 export * from './storage/WindowStorage';
 export * from './DataTypes';
+export * from './ColorUtils';
 export * from './DateUtils';
 export * from './DomUtils';
 export * from './ExtendUtils';

package/lib/mjs/index.js

@@ -4,6 +4,7 @@ export * from './types/FormData';
 export * from './storage/IStorage';
 export * from './storage/WindowStorage';
 export * from './DataTypes';
+export * from './ColorUtils';
 export * from './DateUtils';
 export * from './DomUtils';
 export * from './ExtendUtils';

package/lib/mjs/types/EColor.d.ts

@@ -13,23 +13,6 @@ export declare class EColor {
      * @returns Adjusted value
      */
     static adjust(value: number, adjust?: number): number;
-    /**
-     * Get HEX or RGB colors
-     * @param init Initial color
-     * @param factor Increase factor
-     * @param adjustOrder Adjust order to increase difference
-     * @param hex to HEX or not
-     * @returns Result
-     */
-    static getColors(init?: string, factor?: number, adjustOrder?: boolean, hex?: boolean): string[];
-    /**
-     * Get EColors
-     * @param init Initial color
-     * @param factor Increase factor
-     * @param adjustOrder Adjust order to increase difference
-     * @returns Result
-     */
-    static getEColors(init?: string, factor?: number, adjustOrder?: boolean): EColor[];
     /**
      * HEX string to integer value
      * @param hex HEX string
@@ -98,8 +81,8 @@ export declare class EColor {
     toLabValue(): [number, number, number];
     /**
      * To RGB color string
-     * @param includeAlpha Include alpha or not
+     * @param alpha Alpha value, false means ignore it
      * @returns RGB color string
      */
-    toRGBColor(includeAlpha?: boolean): string;
+    toRGBColor(alpha?: boolean | number): string;
 }

package/lib/mjs/types/EColor.js

@@ -29,74 +29,6 @@ export class EColor {
             return value % 255;
         return value;
     }
-    /**
-     * Get HEX or RGB colors
-     * @param init Initial color
-     * @param factor Increase factor
-     * @param adjustOrder Adjust order to increase difference
-     * @param hex to HEX or not
-     * @returns Result
-     */
-    static getColors(init = '#000', factor = 51, adjustOrder = true, hex = true) {
-        return EColor.getEColors(init, factor, adjustOrder).map((c) => hex ? c.toHEXColor() : c.toRGBColor());
-    }
-    /**
-     * Get EColors
-     * @param init Initial color
-     * @param factor Increase factor
-     * @param adjustOrder Adjust order to increase difference
-     * @returns Result
-     */
-    static getEColors(init = '#000', factor = 51, adjustOrder = true) {
-        var _a;
-        // Init color
-        const initColor = (_a = EColor.parse(init)) !== null && _a !== void 0 ? _a : new EColor(0, 0, 0);
-        // Factors elements
-        // 51 = '00', '33', '66', '99', 'cc', 'ff'
-        const factors = [];
-        let f = 0;
-        while (f <= 255) {
-            factors.push(f);
-            f += factor;
-        }
-        // RGB loop
-        const colors = [initColor];
-        for (const r of factors) {
-            for (const g of factors) {
-                for (const b of factors) {
-                    colors.push(initColor.clone(r, g, b));
-                }
-            }
-        }
-        // Non-nullable colors
-        const nColors = colors.filter((color) => color != null);
-        // Adjust order
-        if (adjustOrder) {
-            const firstColor = nColors.shift();
-            if (firstColor) {
-                let color = firstColor;
-                const newColors = [color];
-                while (nColors.length > 0) {
-                    const result = nColors.reduce((p, c, index) => {
-                        const delta = color.getDeltaValue(c);
-                        if (delta != null && delta > p.delta) {
-                            p.delta = delta;
-                            p.color = c;
-                            p.index = index;
-                        }
-                        return p;
-                    }, { delta: 0, color, index: -1 });
-                    if (result.delta > 0) {
-                        color = result.color;
-                        newColors.push(color);
-                        nColors.splice(result.index, 1);
-                    }
-                }
-                return newColors;
-            }
-        }
-        return nColors;
-    }
     /**
      * HEX string to integer value
      * @param hex HEX string
@@ -122,7 +54,7 @@ export class EColor {
         // Null
         if (htmlColor == null)
             return undefined;
-        htmlColor = htmlColor.toUpperCase();
+        htmlColor = htmlColor.trim().toUpperCase();
         // HEX color
         if (htmlColor.startsWith('#')) {
             htmlColor = htmlColor.substring(1);
@@ -247,15 +179,24 @@ export class EColor {
     }
     /**
      * To RGB color string
-     * @param includeAlpha Include alpha or not
+     * @param alpha Alpha value, false means ignore it
      * @returns RGB color string
      */
-    toRGBColor(includeAlpha) {
-        var _a;
-        // Default case
-        includeAlpha !== null && includeAlpha !== void 0 ? includeAlpha : (includeAlpha = this.alpha != null);
+    toRGBColor(alpha) {
+        // Decide
+        let includeAlpha, alphaValue = this.alpha;
+        if (typeof alpha === 'number') {
+            alphaValue = alpha;
+            includeAlpha = true;
+        }
+        else if (alpha == null) {
+            includeAlpha = this.alpha != null;
+        }
+        else {
+            includeAlpha = alpha;
+        }
         if (includeAlpha)
-            return `RGBA(${this.r}, ${this.g}, ${this.b}, ${(_a = this.alpha) !== null && _a !== void 0 ? _a : 1})`;
+            return `RGBA(${this.r}, ${this.g}, ${this.b}, ${alphaValue !== null && alphaValue !== void 0 ? alphaValue : 1})`;
         return `RGB(${this.r}, ${this.g}, ${this.b})`;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@etsoo/shared",
-    "version": "1.1.16",
+    "version": "1.1.19",
     "description": "TypeScript shared utilities and functions",
     "main": "lib/cjs/index.js",
     "module": "lib/mjs/index.js",
@@ -55,13 +55,13 @@
     "dependencies": {},
     "devDependencies": {
         "@types/jest": "^27.4.1",
-        "@typescript-eslint/eslint-plugin": "^5.13.0",
-        "@typescript-eslint/parser": "^5.13.0",
-        "eslint": "^8.10.0",
+        "@typescript-eslint/eslint-plugin": "^5.17.0",
+        "@typescript-eslint/parser": "^5.17.0",
+        "eslint": "^8.12.0",
         "eslint-config-airbnb-base": "^15.0.0",
         "eslint-plugin-import": "^2.25.4",
         "jest": "^27.5.1",
-        "ts-jest": "^27.1.3",
-        "typescript": "^4.6.2"
+        "ts-jest": "^27.1.4",
+        "typescript": "^4.6.3"
     }
 }

package/src/ColorUtils.ts

@@ -0,0 +1,99 @@
+import { EColor } from './types/EColor';
+
+/**
+ * Color utils
+ */
+export namespace ColorUtils {
+    /**
+     * Get HEX or RGB colors
+     * @param init Initial color
+     * @param factor Increase factor
+     * @param adjustOrder Adjust order to increase difference
+     * @param hex to HEX or not
+     * @returns Result
+     */
+    export function getColors(
+        init: string = '#000',
+        factor: number = 51,
+        adjustOrder: boolean = true,
+        hex: boolean = true
+    ) {
+        return getEColors(init, factor, adjustOrder).map((c) =>
+            hex ? c.toHEXColor() : c.toRGBColor()
+        );
+    }
+
+    /**
+     * Get EColors
+     * @param init Initial color
+     * @param factor Increase factor
+     * @param adjustOrder Adjust order to increase difference
+     * @returns Result
+     */
+    export function getEColors(
+        init: string = '#000',
+        factor: number = 51,
+        adjustOrder: boolean = true
+    ): EColor[] {
+        // Init color
+        const initColor = EColor.parse(init) ?? new EColor(0, 0, 0);
+
+        // Factors elements
+        // 51 = '00', '33', '66', '99', 'cc', 'ff'
+        const factors: number[] = [];
+        let f = 0;
+        while (f <= 255) {
+            factors.push(f);
+            f += factor;
+        }
+
+        // RGB loop
+        const colors: (EColor | undefined)[] = [initColor];
+        for (const r of factors) {
+            for (const g of factors) {
+                for (const b of factors) {
+                    colors.push(initColor.clone(r, g, b));
+                }
+            }
+        }
+
+        // Non-nullable colors
+        const nColors = colors.filter(
+            (color): color is EColor => color != null
+        );
+
+        // Adjust order
+        if (adjustOrder) {
+            const firstColor = nColors.shift();
+            if (firstColor) {
+                let color = firstColor;
+                const newColors: EColor[] = [color];
+
+                while (nColors.length > 0) {
+                    const result = nColors.reduce(
+                        (p, c, index) => {
+                            const delta = color.getDeltaValue(c);
+                            if (delta != null && delta > p.delta) {
+                                p.delta = delta;
+                                p.color = c;
+                                p.index = index;
+                            }
+                            return p;
+                        },
+                        { delta: 0, color, index: -1 }
+                    );
+
+                    if (result.delta > 0) {
+                        color = result.color;
+                        newColors.push(color);
+                        nColors.splice(result.index, 1);
+                    }
+                }
+
+                return newColors;
+            }
+        }
+
+        return nColors;
+    }
+}

package/src/Utils.ts

@@ -516,6 +516,20 @@ export namespace Utils {
         return input?.removeNonLetters();
     };
 
+    /**
+     * Replace null or empty with default value
+     * @param input Input string
+     * @param defaultValue Default value
+     * @returns Result
+     */
+    export const replaceNullOrEmpty = (
+        input: string | null | undefined,
+        defaultValue: string
+    ) => {
+        if (input == null || input.trim() === '') return defaultValue;
+        return input;
+    };
+
     /**
      * Set source with new labels
      * @param source Source

package/src/index.ts

@@ -6,6 +6,7 @@ export * from './storage/IStorage';
 export * from './storage/WindowStorage';
 
 export * from './DataTypes';
+export * from './ColorUtils';
 export * from './DateUtils';
 export * from './DomUtils';
 export * from './ExtendUtils';

package/src/types/EColor.ts

@@ -15,99 +15,6 @@ export class EColor {
         return value;
     }
 
-    /**
-     * Get HEX or RGB colors
-     * @param init Initial color
-     * @param factor Increase factor
-     * @param adjustOrder Adjust order to increase difference
-     * @param hex to HEX or not
-     * @returns Result
-     */
-    static getColors(
-        init: string = '#000',
-        factor: number = 51,
-        adjustOrder: boolean = true,
-        hex: boolean = true
-    ) {
-        return EColor.getEColors(init, factor, adjustOrder).map((c) =>
-            hex ? c.toHEXColor() : c.toRGBColor()
-        );
-    }
-
-    /**
-     * Get EColors
-     * @param init Initial color
-     * @param factor Increase factor
-     * @param adjustOrder Adjust order to increase difference
-     * @returns Result
-     */
-    static getEColors(
-        init: string = '#000',
-        factor: number = 51,
-        adjustOrder: boolean = true
-    ): EColor[] {
-        // Init color
-        const initColor = EColor.parse(init) ?? new EColor(0, 0, 0);
-
-        // Factors elements
-        // 51 = '00', '33', '66', '99', 'cc', 'ff'
-        const factors: number[] = [];
-        let f = 0;
-        while (f <= 255) {
-            factors.push(f);
-            f += factor;
-        }
-
-        // RGB loop
-        const colors: (EColor | undefined)[] = [initColor];
-        for (const r of factors) {
-            for (const g of factors) {
-                for (const b of factors) {
-                    colors.push(initColor.clone(r, g, b));
-                }
-            }
-        }
-
-        // Non-nullable colors
-        const nColors = colors.filter(
-            (color): color is EColor => color != null
-        );
-
-        // Adjust order
-        if (adjustOrder) {
-            const firstColor = nColors.shift();
-            if (firstColor) {
-                let color = firstColor;
-                const newColors: EColor[] = [color];
-
-                while (nColors.length > 0) {
-                    const result = nColors.reduce(
-                        (p, c, index) => {
-                            const delta = color.getDeltaValue(c);
-                            if (delta != null && delta > p.delta) {
-                                p.delta = delta;
-                                p.color = c;
-                                p.index = index;
-                            }
-                            return p;
-                        },
-                        { delta: 0, color, index: -1 }
-                    );
-
-                    if (result.delta > 0) {
-                        color = result.color;
-                        newColors.push(color);
-                        nColors.splice(result.index, 1);
-                    }
-                }
-
-                return newColors;
-            }
-        }
-
-        return nColors;
-    }
-
     /**
      * HEX string to integer value
      * @param hex HEX string
@@ -134,7 +41,7 @@ export class EColor {
     static parse(htmlColor?: string | null): EColor | undefined {
         // Null
         if (htmlColor == null) return undefined;
-        htmlColor = htmlColor.toUpperCase();
+        htmlColor = htmlColor.trim().toUpperCase();
 
         // HEX color
         if (htmlColor.startsWith('#')) {
@@ -309,15 +216,25 @@ export class EColor {
 
     /**
      * To RGB color string
-     * @param includeAlpha Include alpha or not
+     * @param alpha Alpha value, false means ignore it
      * @returns RGB color string
      */
-    toRGBColor(includeAlpha?: boolean) {
-        // Default case
-        includeAlpha ??= this.alpha != null;
+    toRGBColor(alpha?: boolean | number) {
+        // Decide
+        let includeAlpha: boolean,
+            alphaValue: number | undefined = this.alpha;
+
+        if (typeof alpha === 'number') {
+            alphaValue = alpha;
+            includeAlpha = true;
+        } else if (alpha == null) {
+            includeAlpha = this.alpha != null;
+        } else {
+            includeAlpha = alpha;
+        }
 
         if (includeAlpha)
-            return `RGBA(${this.r}, ${this.g}, ${this.b}, ${this.alpha ?? 1})`;
+            return `RGBA(${this.r}, ${this.g}, ${this.b}, ${alphaValue ?? 1})`;
 
         return `RGB(${this.r}, ${this.g}, ${this.b})`;
     }