@react-hive/honey-utils 3.30.0 → 3.32.0

package/dist/index.d.ts

@@ -15,3 +15,5 @@ export * from './string';
 export * from './tree';
 export * from './types';
 export * from './color';
+export * from './json';
+export * from './encoding';

package/dist/index.dev.cjs

@@ -1335,35 +1335,38 @@ __webpack_require__.r(__webpack_exports__);
  *
  * ### Behavior
  * - Centering is calculated independently for each enabled axis.
- * - Translation is applied only when the container content overflows on that axis.
- * - When no overflow exists, the container remains untransformed for that axis.
+ * - Raw centering offset is always calculated first.
+ * - Offset clamping is optional and controlled by `shouldClamp`.
  *
  * ### Notes
  * - This function performs immediate DOM reads and writes.
- * - The resulting transform is clamped to valid scrollable bounds.
  *
  * @param containerElement - The container whose content is translated.
  * @param elementToCenter - The descendant element to align to the container’s center.
- * @param options - Optional configuration controlling which axis or axes are centered.
+ * @param options - Optional configuration controlling centering behavior.
  */
-const centerElementInContainer = (containerElement, elementToCenter, { axis = 'both' } = {}) => {
+const centerElementInContainer = (containerElement, elementToCenter, { axis = 'both', shouldClamp = true } = {}) => {
     let translateX = 0;
     let translateY = 0;
     if (axis === 'x' || axis === 'both') {
-        translateX = (0,_geometry__WEBPACK_IMPORTED_MODULE_1__.calculateCenterOffset)({
-            overflowSize: (0,_dom__WEBPACK_IMPORTED_MODULE_0__.getXOverflowWidth)(containerElement),
+        const offsetX = (0,_geometry__WEBPACK_IMPORTED_MODULE_1__.calculateCenterOffset)({
             containerSize: containerElement.clientWidth,
             elementOffset: elementToCenter.offsetLeft,
             elementSize: elementToCenter.clientWidth,
         });
+        translateX = shouldClamp
+            ? (0,_geometry__WEBPACK_IMPORTED_MODULE_1__.clampOffsetToOverflow)(offsetX, (0,_dom__WEBPACK_IMPORTED_MODULE_0__.getXOverflowWidth)(containerElement))
+            : offsetX;
     }
     if (axis === 'y' || axis === 'both') {
-        translateY = (0,_geometry__WEBPACK_IMPORTED_MODULE_1__.calculateCenterOffset)({
-            overflowSize: (0,_dom__WEBPACK_IMPORTED_MODULE_0__.getYOverflowHeight)(containerElement),
+        const offsetY = (0,_geometry__WEBPACK_IMPORTED_MODULE_1__.calculateCenterOffset)({
             containerSize: containerElement.clientHeight,
             elementOffset: elementToCenter.offsetTop,
             elementSize: elementToCenter.clientHeight,
         });
+        translateY = shouldClamp
+            ? (0,_geometry__WEBPACK_IMPORTED_MODULE_1__.clampOffsetToOverflow)(offsetY, (0,_dom__WEBPACK_IMPORTED_MODULE_0__.getYOverflowHeight)(containerElement))
+            : offsetY;
     }
     containerElement.style.transform = `translate(${translateX}px, ${translateY}px)`;
 };
@@ -1517,6 +1520,82 @@ const parse2DMatrix = (element) => {
 };
 
 
+/***/ },
+
+/***/ "./src/encoding/decode-base64-json.ts"
+/*!********************************************!*\
+  !*** ./src/encoding/decode-base64-json.ts ***!
+  \********************************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   decodeBase64Json: () => (/* binding */ decodeBase64Json)
+/* harmony export */ });
+/* harmony import */ var _json__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ~/json */ "./src/json/index.ts");
+/* harmony import */ var _decode_base64__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./decode-base64 */ "./src/encoding/decode-base64.ts");
+
+
+const decodeBase64Json = (value) => {
+    const decodedValue = (0,_decode_base64__WEBPACK_IMPORTED_MODULE_1__.decodeBase64)(value);
+    if (decodedValue === null) {
+        return null;
+    }
+    return (0,_json__WEBPACK_IMPORTED_MODULE_0__.parseJson)(decodedValue);
+};
+
+
+/***/ },
+
+/***/ "./src/encoding/decode-base64.ts"
+/*!***************************************!*\
+  !*** ./src/encoding/decode-base64.ts ***!
+  \***************************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   decodeBase64: () => (/* binding */ decodeBase64)
+/* harmony export */ });
+const BASE64_PATTERN = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/;
+const decodeBase64 = (value) => {
+    try {
+        if (!BASE64_PATTERN.test(value)) {
+            return null;
+        }
+        if (typeof Buffer !== 'undefined') {
+            return Buffer.from(value, 'base64').toString('utf-8');
+        }
+        return decodeURIComponent(atob(value)
+            .split('')
+            .map(char => `%${char.charCodeAt(0).toString(16).padStart(2, '0')}`)
+            .join(''));
+    }
+    catch {
+        return null;
+    }
+};
+
+
+/***/ },
+
+/***/ "./src/encoding/index.ts"
+/*!*******************************!*\
+  !*** ./src/encoding/index.ts ***!
+  \*******************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   decodeBase64: () => (/* reexport safe */ _decode_base64__WEBPACK_IMPORTED_MODULE_0__.decodeBase64),
+/* harmony export */   decodeBase64Json: () => (/* reexport safe */ _decode_base64_json__WEBPACK_IMPORTED_MODULE_1__.decodeBase64Json)
+/* harmony export */ });
+/* harmony import */ var _decode_base64__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./decode-base64 */ "./src/encoding/decode-base64.ts");
+/* harmony import */ var _decode_base64_json__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./decode-base64-json */ "./src/encoding/decode-base64-json.ts");
+
+
+
+
 /***/ },
 
 /***/ "./src/env/index.ts"
@@ -2033,6 +2112,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   applyInertiaStep: () => (/* reexport safe */ _apply_inertia_step__WEBPACK_IMPORTED_MODULE_2__.applyInertiaStep),
 /* harmony export */   calculateCenterOffset: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_0__.calculateCenterOffset),
+/* harmony export */   clampOffsetToOverflow: () => (/* reexport safe */ _layout__WEBPACK_IMPORTED_MODULE_0__.clampOffsetToOverflow),
 /* harmony export */   resolveBoundedDelta: () => (/* reexport safe */ _resolve_bounded_delta__WEBPACK_IMPORTED_MODULE_1__.resolveBoundedDelta)
 /* harmony export */ });
 /* harmony import */ var _layout__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./layout */ "./src/geometry/layout/index.ts");
@@ -2056,24 +2136,43 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   calculateCenterOffset: () => (/* binding */ calculateCenterOffset)
 /* harmony export */ });
 /**
- * Calculates the offset required to center an element within a container along a single axis.
+ * Calculates the raw offset required to center an element within a container along a single axis.
  *
- * The returned value is clamped so that the resulting translation does not
- * exceed the container's scrollable bounds.
+ * @returns A negative offset value suitable for use in a CSS `translate` transform.
+ */
+const calculateCenterOffset = ({ containerSize, elementOffset, elementSize, }) => {
+    const containerCenter = containerSize / 2;
+    const elementCenter = elementOffset + elementSize / 2;
+    const targetOffset = elementCenter - containerCenter;
+    return -targetOffset;
+};
+
+
+/***/ },
+
+/***/ "./src/geometry/layout/clamp-offset-to-overflow.ts"
+/*!*********************************************************!*\
+  !*** ./src/geometry/layout/clamp-offset-to-overflow.ts ***!
+  \*********************************************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   clampOffsetToOverflow: () => (/* binding */ clampOffsetToOverflow)
+/* harmony export */ });
+/**
+ * Clamps a negative translation offset to the available overflow bounds.
  *
- * This function performs pure math only and does not access the DOM.
+ * @param offset - Negative translate offset.
+ * @param overflowSize - Maximum overflow size along the axis.
  *
- * @returns A negative offset value suitable for use in a CSS `translate`
- * transform, or `0` when no overflow exists on the axis.
+ * @returns Clamped negative offset, or `0` when no overflow exists.
  */
-const calculateCenterOffset = ({ overflowSize, containerSize, elementOffset, elementSize, }) => {
+const clampOffsetToOverflow = (offset, overflowSize) => {
     if (overflowSize <= 0) {
         return 0;
     }
-    const containerCenter = containerSize / 2;
-    const elementCenter = elementOffset + elementSize / 2;
-    const targetOffset = elementCenter - containerCenter;
-    return -Math.max(0, Math.min(targetOffset, overflowSize));
+    return Math.max(-overflowSize, Math.min(offset, 0));
 };
 
 
@@ -2087,9 +2186,12 @@ const calculateCenterOffset = ({ overflowSize, containerSize, elementOffset, ele
 
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   calculateCenterOffset: () => (/* reexport safe */ _calculate_center_offset__WEBPACK_IMPORTED_MODULE_0__.calculateCenterOffset)
+/* harmony export */   calculateCenterOffset: () => (/* reexport safe */ _calculate_center_offset__WEBPACK_IMPORTED_MODULE_0__.calculateCenterOffset),
+/* harmony export */   clampOffsetToOverflow: () => (/* reexport safe */ _clamp_offset_to_overflow__WEBPACK_IMPORTED_MODULE_1__.clampOffsetToOverflow)
 /* harmony export */ });
 /* harmony import */ var _calculate_center_offset__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./calculate-center-offset */ "./src/geometry/layout/calculate-center-offset.ts");
+/* harmony import */ var _clamp_offset_to_overflow__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./clamp-offset-to-overflow */ "./src/geometry/layout/clamp-offset-to-overflow.ts");
+
 
 
 
@@ -2578,6 +2680,44 @@ const resolveAxisDelta = (delta, axis, { allowFallback = true, invert = true } =
 };
 
 
+/***/ },
+
+/***/ "./src/json/index.ts"
+/*!***************************!*\
+  !*** ./src/json/index.ts ***!
+  \***************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   parseJson: () => (/* reexport safe */ _parse_json__WEBPACK_IMPORTED_MODULE_0__.parseJson)
+/* harmony export */ });
+/* harmony import */ var _parse_json__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./parse-json */ "./src/json/parse-json.ts");
+
+
+
+/***/ },
+
+/***/ "./src/json/parse-json.ts"
+/*!********************************!*\
+  !*** ./src/json/parse-json.ts ***!
+  \********************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   parseJson: () => (/* binding */ parseJson)
+/* harmony export */ });
+const parseJson = (value) => {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+};
+
+
 /***/ },
 
 /***/ "./src/math/hash-string.ts"
@@ -3562,9 +3702,12 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   camelToWords: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_13__.camelToWords),
 /* harmony export */   centerElementInContainer: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_3__.centerElementInContainer),
 /* harmony export */   chunk: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.chunk),
+/* harmony export */   clampOffsetToOverflow: () => (/* reexport safe */ _geometry__WEBPACK_IMPORTED_MODULE_7__.clampOffsetToOverflow),
 /* harmony export */   cloneBlob: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_3__.cloneBlob),
 /* harmony export */   compact: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.compact),
 /* harmony export */   compose: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.compose),
+/* harmony export */   decodeBase64: () => (/* reexport safe */ _encoding__WEBPACK_IMPORTED_MODULE_18__.decodeBase64),
+/* harmony export */   decodeBase64Json: () => (/* reexport safe */ _encoding__WEBPACK_IMPORTED_MODULE_18__.decodeBase64Json),
 /* harmony export */   definedProps: () => (/* reexport safe */ _object__WEBPACK_IMPORTED_MODULE_12__.definedProps),
 /* harmony export */   delay: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_2__.delay),
 /* harmony export */   difference: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.difference),
@@ -3630,6 +3773,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   once: () => (/* reexport safe */ _function__WEBPACK_IMPORTED_MODULE_6__.once),
 /* harmony export */   parse2DMatrix: () => (/* reexport safe */ _dom__WEBPACK_IMPORTED_MODULE_3__.parse2DMatrix),
 /* harmony export */   parseFileName: () => (/* reexport safe */ _string__WEBPACK_IMPORTED_MODULE_13__.parseFileName),
+/* harmony export */   parseJson: () => (/* reexport safe */ _json__WEBPACK_IMPORTED_MODULE_17__.parseJson),
 /* harmony export */   pipe: () => (/* reexport safe */ _array__WEBPACK_IMPORTED_MODULE_1__.pipe),
 /* harmony export */   readFilesFromDataTransfer: () => (/* reexport safe */ _file__WEBPACK_IMPORTED_MODULE_5__.readFilesFromDataTransfer),
 /* harmony export */   reduceAsync: () => (/* reexport safe */ _async__WEBPACK_IMPORTED_MODULE_2__.reduceAsync),
@@ -3665,6 +3809,10 @@ __webpack_require__.r(__webpack_exports__);
 /* 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");
+/* harmony import */ var _json__WEBPACK_IMPORTED_MODULE_17__ = __webpack_require__(/*! ./json */ "./src/json/index.ts");
+/* harmony import */ var _encoding__WEBPACK_IMPORTED_MODULE_18__ = __webpack_require__(/*! ./encoding */ "./src/encoding/index.ts");
+
+