@react-hive/honey-utils 3.24.0 → 3.25.0

package/dist/index.dev.cjs

@@ -815,6 +815,79 @@ const timeout = async (promise, timeoutMs, errorMessage = 'Operation timed out')
 };
 
 
+/***/ }),
+
+/***/ "./src/color/hex-with-alpha.ts":
+/*!*************************************!*\
+  !*** ./src/color/hex-with-alpha.ts ***!
+  \*************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   hexWithAlpha: () => (/* binding */ hexWithAlpha)
+/* harmony export */ });
+/* harmony import */ var _guards__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ~/guards */ "./src/guards.ts");
+
+/**
+ * Adds an alpha channel to a 3- or 6-digit HEX color.
+ *
+ * Accepts `#RGB`, `#RRGGBB`, `RGB`, or `RRGGBB` formats
+ * and returns a normalized 8-digit HEX color in `#RRGGBBAA` format.
+ *
+ * The alpha value is converted to a two-digit hexadecimal
+ * representation using `Math.round(alpha * 255)`.
+ *
+ * @param input - Base HEX color (3 or 6 hex digits, with or without `#`).
+ * @param alpha - Opacity value between `0` (transparent) and `1` (opaque).
+ *
+ * @throws {Error}
+ * - If `alpha` is outside the `[0, 1]` range.
+ * - If `hex` is not a valid 3- or 6-digit hexadecimal color.
+ *
+ * @returns A normalized 8-digit HEX color in `#RRGGBBAA` format.
+ *
+ * @example
+ * ```ts
+ * hexWithAlpha('#ff0000', 0.5) // '#FF000080'
+ * hexWithAlpha('0f0', 1)       // '#00FF00FF'
+ * ```
+ */
+const hexWithAlpha = (input, alpha) => {
+    (0,_guards__WEBPACK_IMPORTED_MODULE_0__.assert)(alpha >= 0 && alpha <= 1, `[@react-hive/honey-utils]: Alpha "${alpha}" must be a number between 0 and 1.`);
+    const hexRegex = /^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/;
+    const match = input.match(hexRegex);
+    (0,_guards__WEBPACK_IMPORTED_MODULE_0__.assert)(match, `[@react-hive/honey-utils]: Invalid hex format: ${input}`);
+    const cleanHex = match[1];
+    // Expand 3-character hex to 6-character hex if necessary
+    const fullHex = cleanHex.length === 3
+        ? cleanHex[0] + cleanHex[0] + cleanHex[1] + cleanHex[1] + cleanHex[2] + cleanHex[2]
+        : cleanHex;
+    // Convert to 8-character hex with alpha
+    const alphaHex = Math.round(alpha * 255)
+        .toString(16)
+        .toUpperCase()
+        .padStart(2, '0');
+    return `#${fullHex + alphaHex}`;
+};
+
+
+/***/ }),
+
+/***/ "./src/color/index.ts":
+/*!****************************!*\
+  !*** ./src/color/index.ts ***!
+  \****************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   hexWithAlpha: () => (/* reexport safe */ _hex_with_alpha__WEBPACK_IMPORTED_MODULE_0__.hexWithAlpha)
+/* harmony export */ });
+/* harmony import */ var _hex_with_alpha__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./hex-with-alpha */ "./src/color/hex-with-alpha.ts");
+
+
+
 /***/ }),
 
 /***/ "./src/dom/dom.ts":
@@ -3261,6 +3334,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   hasXOverflow: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_3__.hasXOverflow),
 /* harmony export */   hasYOverflow: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_3__.hasYOverflow),
 /* harmony export */   hashString: () => (/* reexport safe */ _math__WEBPACK_IMPORTED_MODULE_11__.hashString),
+/* harmony export */   hexWithAlpha: () => (/* reexport safe */ _color__WEBPACK_IMPORTED_MODULE_16__.hexWithAlpha),
 /* harmony export */   intersection: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.intersection),
 /* harmony export */   invokeIfFunction: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_6__.invokeIfFunction),
 /* harmony export */   isAnchorHtmlElement: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_3__.isAnchorHtmlElement),
@@ -3332,6 +3406,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _string__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(/*! ./string */ "./src/string/index.ts");
 /* harmony import */ var _tree__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(/*! ./tree */ "./src/tree/index.ts");
 /* harmony import */ var _types__WEBPACK_IMPORTED_MODULE_15__ = __webpack_require__(/*! ./types */ "./src/types.ts");
+/* harmony import */ var _color__WEBPACK_IMPORTED_MODULE_16__ = __webpack_require__(/*! ./color */ "./src/color/index.ts");
+