@react-hive/honey-utils 3.24.0 → 3.26.0

package/dist/index.dev.cjs

@@ -815,6 +815,126 @@ 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/data-transfer.ts":
+/*!**********************************!*\
+  !*** ./src/dom/data-transfer.ts ***!
+  \**********************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   DATA_TRANSFER_JSON_MIME: () => (/* binding */ DATA_TRANSFER_JSON_MIME),
+/* harmony export */   getDataTransferJson: () => (/* binding */ getDataTransferJson),
+/* harmony export */   setDataTransferJson: () => (/* binding */ setDataTransferJson)
+/* harmony export */ });
+const DATA_TRANSFER_JSON_MIME = 'application/json';
+/**
+ * Serializes and stores JSON data in a DataTransfer object.
+ *
+ * Useful for drag-and-drop communication between elements.
+ *
+ * @param dataTransfer DataTransfer instance from a drag event.
+ * @param data Data to serialize.
+ */
+const setDataTransferJson = (dataTransfer, data) => {
+    dataTransfer.setData(DATA_TRANSFER_JSON_MIME, JSON.stringify(data));
+};
+/**
+ * Retrieves and parses JSON data from a DataTransfer object.
+ *
+ * @param dataTransfer DataTransfer instance from a drop event.
+ *
+ * @returns Parsed JSON value or undefined if not present or invalid.
+ */
+const getDataTransferJson = (dataTransfer) => {
+    const rawData = dataTransfer.getData(DATA_TRANSFER_JSON_MIME);
+    if (!rawData) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(rawData);
+    }
+    catch {
+        return undefined;
+    }
+};
+
+
 /***/ }),
 
 /***/ "./src/dom/dom.ts":
@@ -968,22 +1088,27 @@ __webpack_require__.r(__webpack_exports__);
 
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   centerElementInContainer: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_2__.centerElementInContainer),
-/* harmony export */   cloneBlob: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_0__.cloneBlob),
-/* harmony export */   downloadFile: () => (/* reexport safe */ _file__WEBPACK_IMPORTED_MODULE_1__.downloadFile),
-/* harmony export */   getElementOffsetRect: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_0__.getElementOffsetRect),
-/* harmony export */   getXOverflowWidth: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_2__.getXOverflowWidth),
-/* harmony export */   getYOverflowHeight: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_2__.getYOverflowHeight),
-/* harmony export */   hasXOverflow: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_2__.hasXOverflow),
-/* harmony export */   hasYOverflow: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_2__.hasYOverflow),
-/* harmony export */   isAnchorHtmlElement: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_0__.isAnchorHtmlElement),
-/* harmony export */   isContentEditableHtmlElement: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_0__.isContentEditableHtmlElement),
-/* harmony export */   parse2DMatrix: () => (/* reexport safe */ _transform__WEBPACK_IMPORTED_MODULE_3__.parse2DMatrix)
+/* harmony export */   DATA_TRANSFER_JSON_MIME: () => (/* reexport safe */ _data_transfer__WEBPACK_IMPORTED_MODULE_0__.DATA_TRANSFER_JSON_MIME),
+/* harmony export */   centerElementInContainer: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_3__.centerElementInContainer),
+/* harmony export */   cloneBlob: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_1__.cloneBlob),
+/* harmony export */   downloadFile: () => (/* reexport safe */ _file__WEBPACK_IMPORTED_MODULE_2__.downloadFile),
+/* harmony export */   getDataTransferJson: () => (/* reexport safe */ _data_transfer__WEBPACK_IMPORTED_MODULE_0__.getDataTransferJson),
+/* harmony export */   getElementOffsetRect: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_1__.getElementOffsetRect),
+/* harmony export */   getXOverflowWidth: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_3__.getXOverflowWidth),
+/* harmony export */   getYOverflowHeight: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_3__.getYOverflowHeight),
+/* harmony export */   hasXOverflow: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_3__.hasXOverflow),
+/* harmony export */   hasYOverflow: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_3__.hasYOverflow),
+/* harmony export */   isAnchorHtmlElement: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_1__.isAnchorHtmlElement),
+/* harmony export */   isContentEditableHtmlElement: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_1__.isContentEditableHtmlElement),
+/* harmony export */   parse2DMatrix: () => (/* reexport safe */ _transform__WEBPACK_IMPORTED_MODULE_4__.parse2DMatrix),
+/* harmony export */   setDataTransferJson: () => (/* reexport safe */ _data_transfer__WEBPACK_IMPORTED_MODULE_0__.setDataTransferJson)
 /* harmony export */ });
-/* harmony import */ var _dom__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./dom */ "./src/dom/dom.ts");
-/* harmony import */ var _file__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./file */ "./src/dom/file/index.ts");
-/* harmony import */ var _layout__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./layout */ "./src/dom/layout/index.ts");
-/* harmony import */ var _transform__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./transform */ "./src/dom/transform/index.ts");
+/* harmony import */ var _data_transfer__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./data-transfer */ "./src/dom/data-transfer.ts");
+/* harmony import */ var _dom__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./dom */ "./src/dom/dom.ts");
+/* harmony import */ var _file__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./file */ "./src/dom/file/index.ts");
+/* harmony import */ var _layout__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./layout */ "./src/dom/layout/index.ts");
+/* harmony import */ var _transform__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ./transform */ "./src/dom/transform/index.ts");
+
 
 
 
@@ -3222,6 +3347,7 @@ var __webpack_exports__ = {};
   \**********************/
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   DATA_TRANSFER_JSON_MIME: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_3__.DATA_TRANSFER_JSON_MIME),
 /* harmony export */   FOCUSABLE_HTML_TAGS: () => (/* reexport safe */ _a11y__WEBPACK_IMPORTED_MODULE_0__.FOCUSABLE_HTML_TAGS),
 /* harmony export */   applyInertiaStep: () => (/* reexport safe */ _geometry__WEBPACK_IMPORTED_MODULE_7__.applyInertiaStep),
 /* harmony export */   assert: () => (/* reexport safe */ _guards__WEBPACK_IMPORTED_MODULE_8__.assert),
@@ -3251,6 +3377,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   forEachChar: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_13__.forEachChar),
 /* harmony export */   generateEphemeralId: () => (/* reexport safe */ _id__WEBPACK_IMPORTED_MODULE_9__.generateEphemeralId),
 /* harmony export */   getDOMRectIntersectionRatio: () => (/* reexport safe */ _intersection__WEBPACK_IMPORTED_MODULE_10__.getDOMRectIntersectionRatio),
+/* harmony export */   getDataTransferJson: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_3__.getDataTransferJson),
 /* harmony export */   getElementOffsetRect: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_3__.getElementOffsetRect),
 /* harmony export */   getFocusableHtmlElements: () => (/* reexport safe */ _a11y__WEBPACK_IMPORTED_MODULE_0__.getFocusableHtmlElements),
 /* harmony export */   getLocalStorageCapabilities: () => (/* reexport safe */ _env__WEBPACK_IMPORTED_MODULE_4__.getLocalStorageCapabilities),
@@ -3261,6 +3388,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),
@@ -3308,6 +3436,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   runParallel: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_2__.runParallel),
 /* harmony export */   runSequential: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_2__.runSequential),
 /* harmony export */   searchTree: () => (/* reexport safe */ _tree__WEBPACK_IMPORTED_MODULE_14__.searchTree),
+/* harmony export */   setDataTransferJson: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_3__.setDataTransferJson),
 /* 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),
@@ -3332,6 +3461,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");
+