nhb-toolbox 4.0.50 → 4.0.52

package/dist/cjs/colors/Color.js

@@ -200,30 +200,28 @@ class Color {
     /**
      * @instance Blends the current color with another color based on the given weight.
      *
-     * - **NOTE:** *If any of the input colors has opacity (alpha channel), it might be lost from the generated alpha variants of the respective color formats.*
-     * @param other - The color in any 6 `(Hex, Hex8 RGB, RGBA, HSL or HSLA)` to blend with.
+     * - **NOTE:** *If any of the input colors has opacity (alpha channel), it might be lost or distorted from the generated alpha variants of the respective color formats.*
+     *
+     * @param other - The color in any 6 `(Hex, Hex8 RGB, RGBA, HSL or HSLA)` format to blend with.
      * @param weight - A number from 0 to 1 indicating the weight of the other color. Defaults to `0.5`.
-     * 				 - `weight = 0` → only the original color (this)
-     *				 - `weight = 1` → only the other color
-     *				 - `weight = 0.5` → equal blend between the two
-     * @returns A new `Color` instance representing the blended result.
+     *                  - `weight = 0` → only the original color.
+     *                  - `weight = 1` → only the other color.
+     *                  - `weight = 0.5` → equal blend between the two.
+     * @returns A new `Color` instance representing the blended result, with proper alpha blending.
      */
     blendWith(other, weight = 0.5) {
         const w = Math.max(0, Math.min(1, weight));
         const converted = new Color(other);
         const [r1, b1, g1, a1] = (0, helpers_1._extractAlphaColorValues)(this.rgba);
         const [r2, b2, g2, a2] = (0, helpers_1._extractAlphaColorValues)(converted.rgba);
-        const alpha = a1 * (1 - w) + a2 * w;
-        // ! Original code for solid color
-        // const blended = rgb1.map((c, i) =>
-        // 	Math.round(c * (1 - w) + rgb2[i] * w),
-        // ) as ColorNumbers;
-        // const blendedRGB = `rgb(${blended[0]}, ${blended[1]}, ${blended[2]})`;
-        const blendChannel = (c1, c2) => Math.round((c1 * a1 * (1 - w) + c2 * a2 * w) / alpha);
+        const alpha = Math.round((a1 * (1 - w) + a2 * w) * 100) / 100;
+        const blendChannel = (c1, c2) => {
+            return Math.round((c1 * a1 * (1 - w) + c2 * a2 * w) / alpha);
+        };
         const r = blendChannel(r1, r2);
         const g = blendChannel(g1, g2);
         const b = blendChannel(b1, b2);
-        const blended = `rgba(${r}, ${g}, ${b}, ${+alpha.toFixed(2)})`;
+        const blended = `rgba(${r}, ${g}, ${b}, ${alpha})`;
         return new Color(blended);
     }
     /**

package/dist/dts/colors/Color.d.ts

@@ -130,13 +130,14 @@ export declare class Color {
     /**
      * @instance Blends the current color with another color based on the given weight.
      *
-     * - **NOTE:** *If any of the input colors has opacity (alpha channel), it might be lost from the generated alpha variants of the respective color formats.*
-     * @param other - The color in any 6 `(Hex, Hex8 RGB, RGBA, HSL or HSLA)` to blend with.
+     * - **NOTE:** *If any of the input colors has opacity (alpha channel), it might be lost or distorted from the generated alpha variants of the respective color formats.*
+     *
+     * @param other - The color in any 6 `(Hex, Hex8 RGB, RGBA, HSL or HSLA)` format to blend with.
      * @param weight - A number from 0 to 1 indicating the weight of the other color. Defaults to `0.5`.
-     * 				 - `weight = 0` → only the original color (this)
-     *				 - `weight = 1` → only the other color
-     *				 - `weight = 0.5` → equal blend between the two
-     * @returns A new `Color` instance representing the blended result.
+     *                  - `weight = 0` → only the original color.
+     *                  - `weight = 1` → only the other color.
+     *                  - `weight = 0.5` → equal blend between the two.
+     * @returns A new `Color` instance representing the blended result, with proper alpha blending.
      */
     blendWith(other: ColorType, weight?: number): Color;
     /**

package/dist/dts/colors/Color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../../src/colors/Color.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEX,SAAS,EAET,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,OAAO,EACP,GAAG,EACH,IAAI,EAEJ,MAAM,EACN,KAAK,EACL,MAAM,SAAS,CAAC;AAKjB;;;;;;;;;;;GAWG;AACH,qBAAa,KAAK;;IACV,GAAG,EAAE,IAAI,CAAC;IACV,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,IAAI,CAAC;IAElB;;;;;;;;;;;;;;;;;;;;;;OAsBG;;IAGH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;gBACS,SAAS,EAAE,SAAS;IAwFhC,iEAAiE;IAChE,CAAC,MAAM,CAAC,QAAQ,CAAC;IASlB;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK;IAkBrC;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK;IAUtC;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK;IAUxC;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK;IAUtC;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK;IAYxC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,SAAM,GAAG,KAAK;IA4BhD;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAyBvC;;;OAGG;IACH,qBAAqB,IAAI,KAAK;IAU9B;;;;OAIG;IACH,kBAAkB,IAAI,SAAS;IAa/B;;;;OAIG;IACH,cAAc,IAAI,KAAK;IAWvB;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAczB;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK;IAQtD;;;OAGG;IACH,YAAY,IAAI,OAAO;IAQvB;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAI3C;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAI3C;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG;IAIzC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAI3C;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG;IAIzC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;CAkD3C"}
+{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../../src/colors/Color.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEX,SAAS,EAET,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,OAAO,EACP,GAAG,EACH,IAAI,EAEJ,MAAM,EACN,KAAK,EACL,MAAM,SAAS,CAAC;AAKjB;;;;;;;;;;;GAWG;AACH,qBAAa,KAAK;;IACV,GAAG,EAAE,IAAI,CAAC;IACV,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,IAAI,CAAC;IAElB;;;;;;;;;;;;;;;;;;;;;;OAsBG;;IAGH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;gBACS,SAAS,EAAE,SAAS;IAwFhC,iEAAiE;IAChE,CAAC,MAAM,CAAC,QAAQ,CAAC;IASlB;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK;IAkBrC;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK;IAUtC;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK;IAUxC;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK;IAUtC;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK;IAYxC;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,SAAM,GAAG,KAAK;IAsBhD;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAyBvC;;;OAGG;IACH,qBAAqB,IAAI,KAAK;IAU9B;;;;OAIG;IACH,kBAAkB,IAAI,SAAS;IAa/B;;;;OAIG;IACH,cAAc,IAAI,KAAK;IAWvB;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAczB;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK;IAQtD;;;OAGG;IACH,YAAY,IAAI,OAAO;IAQvB;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAI3C;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAI3C;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG;IAIzC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAI3C;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG;IAIzC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;CAkD3C"}

package/dist/esm/colors/Color.js

@@ -197,30 +197,28 @@ export class Color {
     /**
      * @instance Blends the current color with another color based on the given weight.
      *
-     * - **NOTE:** *If any of the input colors has opacity (alpha channel), it might be lost from the generated alpha variants of the respective color formats.*
-     * @param other - The color in any 6 `(Hex, Hex8 RGB, RGBA, HSL or HSLA)` to blend with.
+     * - **NOTE:** *If any of the input colors has opacity (alpha channel), it might be lost or distorted from the generated alpha variants of the respective color formats.*
+     *
+     * @param other - The color in any 6 `(Hex, Hex8 RGB, RGBA, HSL or HSLA)` format to blend with.
      * @param weight - A number from 0 to 1 indicating the weight of the other color. Defaults to `0.5`.
-     * 				 - `weight = 0` → only the original color (this)
-     *				 - `weight = 1` → only the other color
-     *				 - `weight = 0.5` → equal blend between the two
-     * @returns A new `Color` instance representing the blended result.
+     *                  - `weight = 0` → only the original color.
+     *                  - `weight = 1` → only the other color.
+     *                  - `weight = 0.5` → equal blend between the two.
+     * @returns A new `Color` instance representing the blended result, with proper alpha blending.
      */
     blendWith(other, weight = 0.5) {
         const w = Math.max(0, Math.min(1, weight));
         const converted = new Color(other);
         const [r1, b1, g1, a1] = _extractAlphaColorValues(this.rgba);
         const [r2, b2, g2, a2] = _extractAlphaColorValues(converted.rgba);
-        const alpha = a1 * (1 - w) + a2 * w;
-        // ! Original code for solid color
-        // const blended = rgb1.map((c, i) =>
-        // 	Math.round(c * (1 - w) + rgb2[i] * w),
-        // ) as ColorNumbers;
-        // const blendedRGB = `rgb(${blended[0]}, ${blended[1]}, ${blended[2]})`;
-        const blendChannel = (c1, c2) => Math.round((c1 * a1 * (1 - w) + c2 * a2 * w) / alpha);
+        const alpha = Math.round((a1 * (1 - w) + a2 * w) * 100) / 100;
+        const blendChannel = (c1, c2) => {
+            return Math.round((c1 * a1 * (1 - w) + c2 * a2 * w) / alpha);
+        };
         const r = blendChannel(r1, r2);
         const g = blendChannel(g1, g2);
         const b = blendChannel(b1, b2);
-        const blended = `rgba(${r}, ${g}, ${b}, ${+alpha.toFixed(2)})`;
+        const blended = `rgba(${r}, ${g}, ${b}, ${alpha})`;
         return new Color(blended);
     }
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.0.50",
-  "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
+  "version": "4.0.52",
+  "description": "A versatile collection of smart, efficient, and reusable utility functions and classes for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/dts/index.d.ts",
@@ -23,6 +23,13 @@
     "functions",
     "class",
     "form",
+    "random-id",
+    "id",
+    "parse",
+    "format",
+    "generate",
+    "generator",
+    "data",
     "form-data",
     "development",
     "tools",
@@ -32,6 +39,9 @@
     "color",
     "chronos",
     "time",
+    "date-fns",
+    "javascript",
+    "typescript",
     "moment",
     "dayjs",
     "date",