@react-hive/honey-layout 17.6.0 → 17.8.0

package/dist/index.dev.cjs

@@ -4118,7 +4118,11 @@ __webpack_require__.r(__webpack_exports__);
  * - `centerX`, `centerY` → axis-aware centering helpers
  *
  * Semantic helpers exist purely for convenience and readability.
- * Any explicitly provided style props **always take precedence**.
+ *
+ * Precedence rules:
+ * - `inline` takes precedence over `$display`
+ * - `$flexDirection` takes precedence over `row`
+ * - `$alignItems` and `$justifyContent` take precedence over centering helpers
  *
  * ---
  *
@@ -4139,7 +4143,7 @@ __webpack_require__.r(__webpack_exports__);
  *
  * @example Horizontal layout
  * ```tsx
- * <HoneyFlex $gap={2} row/>
+ * <HoneyFlex $gap={2} row />
  * ```
  *
  * @example Column layout
@@ -4157,9 +4161,10 @@ __webpack_require__.r(__webpack_exports__);
 const HoneyFlex = (0,_react_hive_honey_style__WEBPACK_IMPORTED_MODULE_0__.styled)((0,_HoneyBox__WEBPACK_IMPORTED_MODULE_3__.HoneyBox), ({ inline = false, row = false, center = false, centerX = false, centerY = false, $display, $flexDirection, $alignItems, $justifyContent, ...props }) => {
     const display = inline ? 'inline-flex' : ($display ?? 'flex');
     const flexDirection = $flexDirection ?? (row ? 'row' : 'column');
-    const isRow = flexDirection === 'row';
-    const shouldCenterAlignItems = center || (isRow ? centerY : centerX);
-    const shouldCenterJustifyContent = center || (isRow ? centerX : centerY);
+    const isRowDirection = flexDirection === 'row' || flexDirection === 'row-reverse';
+    const isColumnDirection = flexDirection === 'column' || flexDirection === 'column-reverse';
+    const shouldCenterAlignItems = center || (isRowDirection ? centerY : isColumnDirection ? centerX : false);
+    const shouldCenterJustifyContent = center || (isRowDirection ? centerX : isColumnDirection ? centerY : false);
     const alignItems = $alignItems ?? (shouldCenterAlignItems ? 'center' : undefined);
     const justifyContent = $justifyContent ?? (shouldCenterJustifyContent ? 'center' : undefined);
     if (_constants__WEBPACK_IMPORTED_MODULE_1__.__DEV__) {
@@ -4169,9 +4174,9 @@ const HoneyFlex = (0,_react_hive_honey_style__WEBPACK_IMPORTED_MODULE_0__.styled
             (0,_utils__WEBPACK_IMPORTED_MODULE_2__.warnOnce)(`HoneyFlex:${hasAlignConflict}:${hasJustifyConflict}`, [
                 '[@react-hive/honey-layout]: HoneyFlex.',
                 'Semantic centering props conflict with explicit flex alignment styles:',
-                hasAlignConflict && `   - align-items is controlled by both semantics and $alignItems`,
+                hasAlignConflict && '   - align-items is controlled by both semantics and $alignItems',
                 hasJustifyConflict &&
-                    `   - justify-content is controlled by both semantics and $justifyContent`,
+                    '   - justify-content is controlled by both semantics and $justifyContent',
                 'Explicit styles always win. Remove one side to silence this warning.',
             ]
                 .filter(Boolean)
@@ -5979,32 +5984,35 @@ __webpack_require__.r(__webpack_exports__);
  * It can also subscribe to overlay-level events, such as `keyup`, for the matched overlay.
  *
  * @param targetOverlayId - The ID of the active overlay to find.
- * @param options - Optional overlay event handlers.
+ * @param options - Optional configuration for resolving the overlay and attaching event handlers.
  *
- * @returns The matching active overlay instance, or `undefined` when the overlay is not registered.
+ * @returns The matching active overlay instance, or `null` when the hook is disabled
+ * or the overlay is not currently registered.
  *
  * @remarks
  * - The hook only works with overlays that are currently active.
- * - If the overlay is inactive, unregistered, or already removed from the stack, `undefined` is returned.
- * - The `onKeyUp` listener is attached only to the matched overlay.
- * - Event listeners are automatically cleaned up when the overlay, handler, or component lifecycle changes.
+ * - If `enabled` is `false`, the hook returns `null` and does not attach listeners.
+ * - If the overlay is inactive, unregistered, or already removed from the stack, `null` is returned.
+ * - The `onKeyUp` listener is attached only to the matched overlay while the hook is enabled.
+ * - Event listeners are automatically cleaned up when the overlay, handler, enabled state,
+ * or component lifecycle changes.
  *
  * @example
  * ```tsx
  * const overlay = useHoneyOverlay('my-overlay-id', {
+ *   enabled: isOpen,
  *   onKeyUp: (keyCode, overlay, e) => {
  *     if (keyCode === 'Escape') {
- *      //
+ *       // Handle Escape key.
  *     }
  *   },
  * });
  * ```
  */
-const useHoneyOverlay = (targetOverlayId, { onKeyUp } = {}) => {
+const useHoneyOverlay = (targetOverlayId, { enabled = true, onKeyUp } = {}) => {
     const { overlays } = (0,_hooks__WEBPACK_IMPORTED_MODULE_1__.useHoneyLayout)();
-    const overlay = (0,react__WEBPACK_IMPORTED_MODULE_0__.useMemo)(() => overlays.find(overlay => overlay.id === targetOverlayId), [overlays, targetOverlayId]);
+    const overlay = (0,react__WEBPACK_IMPORTED_MODULE_0__.useMemo)(() => (enabled ? (overlays.find(overlay => overlay.id === targetOverlayId) ?? null) : null), [enabled, overlays, targetOverlayId]);
     (0,react__WEBPACK_IMPORTED_MODULE_0__.useEffect)(() => {
-        // If no overlay is found or no `onKeyUp` handler is provided, skip setting up the listener
         if (!overlay || !onKeyUp) {
             return;
         }