@react-hive/honey-utils 3.30.0 → 3.31.0

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)`;
 };
@@ -2033,6 +2036,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 +2060,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 +2110,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");
+
 
 
 
@@ -3562,6 +3588,7 @@ __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),