@react-hive/honey-utils 3.23.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":
@@ -2621,6 +2694,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   isNilOrEmptyString: () => (/* reexport safe */ _is_nil_or_empty_string__WEBPACK_IMPORTED_MODULE_5__.isNilOrEmptyString),
 /* harmony export */   isString: () => (/* reexport safe */ _is_string__WEBPACK_IMPORTED_MODULE_0__.isString),
 /* harmony export */   parseFileName: () => (/* reexport safe */ _parse_file_name__WEBPACK_IMPORTED_MODULE_6__.parseFileName),
+/* harmony export */   splitMapJoin: () => (/* reexport safe */ _split_map_join__WEBPACK_IMPORTED_MODULE_10__.splitMapJoin),
 /* harmony export */   splitStringIntoWords: () => (/* reexport safe */ _split_string_into_words__WEBPACK_IMPORTED_MODULE_4__.splitStringIntoWords),
 /* harmony export */   toKebabCase: () => (/* reexport safe */ _to_kebab_case__WEBPACK_IMPORTED_MODULE_1__.toKebabCase)
 /* harmony export */ });
@@ -2634,6 +2708,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _find_char_indices__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ./find-char-indices */ "./src/string/find-char-indices.ts");
 /* harmony import */ var _for_each_char__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ./for-each-char */ "./src/string/for-each-char.ts");
 /* harmony import */ var _get_words_initials__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! ./get-words-initials */ "./src/string/get-words-initials.ts");
+/* harmony import */ var _split_map_join__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(/*! ./split-map-join */ "./src/string/split-map-join.ts");
+
 
 
 
@@ -2734,6 +2810,57 @@ const parseFileName = (fileName) => {
 };
 
 
+/***/ }),
+
+/***/ "./src/string/split-map-join.ts":
+/*!**************************************!*\
+  !*** ./src/string/split-map-join.ts ***!
+  \**************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   splitMapJoin: () => (/* binding */ splitMapJoin)
+/* harmony export */ });
+/**
+ * Splits a string into parts, transforms each part, then joins them back together.
+ *
+ * Common use cases:
+ *
+ * - Transforming selector groups:
+ *
+ * ```ts
+ * splitMapJoin(".a, .b", ",", part => `.scope ${part}`);
+ * // ".scope .a, .scope .b"
+ * ```
+ *
+ * - Normalizing spacing:
+ *
+ * ```ts
+ * splitMapJoin("a ,  b ,c", ",", part => part);
+ * // "a,b,c"
+ * ```
+ *
+ * - Custom join formatting:
+ *
+ * ```ts
+ * splitMapJoin("a,b,c", ",", part => part.toUpperCase(), ".");
+ * // "A.B.C"
+ * ```
+ *
+ * @param input - The raw input string to process.
+ * @param separator - The delimiter used to split the input (e.g. `","`, `" "`).
+ * @param mapFn - Function applied to each trimmed part.
+ * @param joinWith - Optional join separator (defaults to the same value as `separator`).
+ *
+ * @returns The transformed and re-joined string.
+ */
+const splitMapJoin = (input, separator, mapFn, joinWith = separator) => input
+    .split(separator)
+    .map((part, index) => mapFn(part.trim(), index))
+    .join(joinWith);
+
+
 /***/ }),
 
 /***/ "./src/string/split-string-into-words.ts":
@@ -3207,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),
@@ -3255,6 +3383,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   runSequential: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_2__.runSequential),
 /* harmony export */   searchTree: () => (/* reexport safe */ _tree__WEBPACK_IMPORTED_MODULE_14__.searchTree),
 /* harmony export */   someAsync: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_2__.someAsync),
+/* harmony export */   splitMapJoin: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_13__.splitMapJoin),
 /* harmony export */   splitStringIntoWords: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_13__.splitStringIntoWords),
 /* harmony export */   timeout: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_2__.timeout),
 /* harmony export */   toKebabCase: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_13__.toKebabCase),
@@ -3277,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");
+