orcs-design-system 3.3.34 → 3.3.35

package/es/components/Avatar/index.js

@@ -484,6 +484,7 @@ const Avatar = _ref7 => {
         width: "fit-content",
         $shape: shape,
         text: shape === "circle" ? "Upload profile picture" : "Change image",
+        headerAvatarSizing: sizing,
         children: /*#__PURE__*/_jsxs(HeaderAvatarAction, {
           onClick: onClick,
           "aria-label": "Edit avatar",

package/es/components/Popover/Popover.stories.js

@@ -21,6 +21,7 @@ export default {
 };
 export const defaultPopover = () => /*#__PURE__*/_jsx(Popover, {
   text: "Description that explains child element",
+  width: "fit-content",
   children: /*#__PURE__*/_jsx(Button, {
     onClick: () => alert("Maintains original click"),
     children: "Hover Me!"
@@ -38,6 +39,7 @@ export const direction = () => /*#__PURE__*/_jsx(Box, {
     children: [/*#__PURE__*/_jsx(Popover, {
       direction: "topLeft",
       text: "Description that explains child element",
+      width: "fit-content",
       children: /*#__PURE__*/_jsx(Button, {
         width: "125px",
         children: "Top left"
@@ -45,6 +47,7 @@ export const direction = () => /*#__PURE__*/_jsx(Box, {
     }), /*#__PURE__*/_jsx(Popover, {
       direction: "top",
       text: "Description that explains child element",
+      width: "fit-content",
       children: /*#__PURE__*/_jsx(Button, {
         width: "125px",
         children: "Top"
@@ -52,6 +55,7 @@ export const direction = () => /*#__PURE__*/_jsx(Box, {
     }), /*#__PURE__*/_jsx(Popover, {
       direction: "topRight",
       text: "Description that explains child element",
+      width: "fit-content",
       children: /*#__PURE__*/_jsx(Button, {
         width: "125px",
         children: "Top right"
@@ -59,6 +63,7 @@ export const direction = () => /*#__PURE__*/_jsx(Box, {
     }), /*#__PURE__*/_jsx(Popover, {
       direction: "left",
       text: "Description that explains child element",
+      width: "fit-content",
       children: /*#__PURE__*/_jsx(Button, {
         width: "125px",
         children: "Left"
@@ -70,6 +75,7 @@ export const direction = () => /*#__PURE__*/_jsx(Box, {
     }), /*#__PURE__*/_jsx(Popover, {
       direction: "right",
       text: "Description that explains child element",
+      width: "fit-content",
       children: /*#__PURE__*/_jsx(Button, {
         width: "125px",
         children: "Right"
@@ -77,6 +83,7 @@ export const direction = () => /*#__PURE__*/_jsx(Box, {
     }), /*#__PURE__*/_jsx(Popover, {
       direction: "bottomLeft",
       text: "Description that explains child element",
+      width: "fit-content",
       children: /*#__PURE__*/_jsx(Button, {
         width: "125px",
         children: "Bottom left"
@@ -84,6 +91,7 @@ export const direction = () => /*#__PURE__*/_jsx(Box, {
     }), /*#__PURE__*/_jsx(Popover, {
       direction: "bottom",
       text: "Description that explains child element",
+      width: "fit-content",
       children: /*#__PURE__*/_jsx(Button, {
         width: "125px",
         children: "Bottom"
@@ -91,6 +99,7 @@ export const direction = () => /*#__PURE__*/_jsx(Box, {
     }), /*#__PURE__*/_jsx(Popover, {
       direction: "bottomRight",
       text: "Description that explains child element",
+      width: "fit-content",
       children: /*#__PURE__*/_jsx(Button, {
         width: "125px",
         children: "Bottom right"
@@ -100,8 +109,8 @@ export const direction = () => /*#__PURE__*/_jsx(Box, {
 });
 direction.storyName = "Direction";
 export const specifiedWidth = () => /*#__PURE__*/_jsx(Popover, {
-  text: "Description that explains child element",
-  width: "240px",
+  text: "Long description that you might not want to show on one line, and instead would like it to wrap",
+  width: "200px",
   children: /*#__PURE__*/_jsx(Button, {
     children: "Hover Me"
   })
@@ -109,6 +118,7 @@ export const specifiedWidth = () => /*#__PURE__*/_jsx(Popover, {
 export const textAlignment = () => /*#__PURE__*/_jsx(Popover, {
   textAlign: "center",
   text: "Centered description that explains child element",
+  width: "fit-content",
   children: /*#__PURE__*/_jsx(Button, {
     children: "Hover Me"
   })
@@ -120,23 +130,27 @@ export const DisplayInlineBlock = () => /*#__PURE__*/_jsx(Flex, {
     children: [/*#__PURE__*/_jsx(Popover, {
       text: "Description that explains child element",
       inlineBlock: true,
+      width: "fit-content",
       children: /*#__PURE__*/_jsx(Button, {
         children: "Inline Block Set"
       })
     }), /*#__PURE__*/_jsx(Popover, {
       text: "Description that explains child element",
       inlineBlock: true,
+      width: "fit-content",
       children: /*#__PURE__*/_jsx(Button, {
         children: "Inline Block Set"
       })
     }), /*#__PURE__*/_jsx(Popover, {
       text: "Because it is display: block, the triggering container is wider than the button",
+      width: "fit-content",
       children: /*#__PURE__*/_jsx(Button, {
         children: "Not Inline"
       })
     }), /*#__PURE__*/_jsx(Popover, {
       direction: "top",
       text: "Description that explains child element",
+      width: "fit-content",
       children: /*#__PURE__*/_jsx(Button, {
         children: "Not Inline"
       })
@@ -146,7 +160,8 @@ export const DisplayInlineBlock = () => /*#__PURE__*/_jsx(Flex, {
 export const tooltipExample = () => /*#__PURE__*/_jsx(Popover, {
   text: "This tooltip helps explain stuff",
   direction: "top",
-  variant: "tooltip"
+  variant: "tooltip",
+  width: "fit-content"
 });
 tooltipExample.storyName = "Tooltip Example";
 export const tooltipWithLinkExample = () => /*#__PURE__*/_jsx(Popover, {
@@ -160,7 +175,8 @@ export const tooltipWithLinkExample = () => /*#__PURE__*/_jsx(Popover, {
   arialLabel: "Link to TeamForm",
   direction: "right",
   variant: "tooltip",
-  enableSelectAll: false
+  enableSelectAll: false,
+  width: "fit-content"
 });
 tooltipWithLinkExample.storyName = "Tooltip with link Example";
 export const iconExample = () => /*#__PURE__*/_jsx(Popover, {
@@ -179,12 +195,90 @@ export const keepInViewExample = () => /*#__PURE__*/_jsx(Flex, {
   width: "100%",
   children: /*#__PURE__*/_jsx(Popover, {
     text: "Description that explains child element",
+    width: "fit-content",
     children: /*#__PURE__*/_jsx(Button, {
       children: "Hover Me!"
     })
   })
 });
 keepInViewExample.storyName = "Keep In View Example";
+export const customOffset = () => /*#__PURE__*/_jsx("div", {
+  children: /*#__PURE__*/_jsxs(Spacer, {
+    mb: "r",
+    children: [/*#__PURE__*/_jsx(Popover, {
+      text: "Default offset (10px mainAxis)",
+      direction: "right",
+      width: "fit-content",
+      inlineBlock: true,
+      children: /*#__PURE__*/_jsx(Button, {
+        height: "130px",
+        children: "Default Offset"
+      })
+    }), /*#__PURE__*/_jsx(Popover, {
+      text: "Custom offset: 30px mainAxis (moved further away)",
+      direction: "right",
+      offset: {
+        mainAxis: 30
+      },
+      width: "fit-content",
+      inlineBlock: true,
+      children: /*#__PURE__*/_jsx(Button, {
+        height: "130px",
+        children: "30px Main Axis (Right)"
+      })
+    }), /*#__PURE__*/_jsx(Popover, {
+      text: "Custom offset: -10px mainAxis (moved closer)",
+      direction: "right",
+      offset: {
+        mainAxis: -10
+      },
+      width: "fit-content",
+      inlineBlock: true,
+      children: /*#__PURE__*/_jsx(Button, {
+        height: "130px",
+        children: "-10px Main Axis (Left)"
+      })
+    }), /*#__PURE__*/_jsx(Popover, {
+      text: "Custom offset: 20px alignmentAxis (moved down)",
+      direction: "right",
+      offset: {
+        alignmentAxis: 20
+      },
+      width: "fit-content",
+      inlineBlock: true,
+      children: /*#__PURE__*/_jsx(Button, {
+        height: "130px",
+        children: "20px Alignment Axis (Down)"
+      })
+    }), /*#__PURE__*/_jsx(Popover, {
+      text: "Custom offset: -20px alignmentAxis (moved up)",
+      direction: "right",
+      offset: {
+        alignmentAxis: -20
+      },
+      width: "fit-content",
+      inlineBlock: true,
+      children: /*#__PURE__*/_jsx(Button, {
+        height: "130px",
+        children: "-20px Alignment Axis (Up)"
+      })
+    }), /*#__PURE__*/_jsx(Popover, {
+      text: "Custom offset: both axes combined",
+      direction: "right",
+      offset: {
+        mainAxis: 25,
+        alignmentAxis: -25
+      },
+      width: "fit-content",
+      inlineBlock: true,
+      children: /*#__PURE__*/_jsx(Button, {
+        height: "130px",
+        children: "Combined Axes (right and up)"
+      })
+    })]
+  })
+});
+customOffset.storyName = "Custom Offset";
 defaultPopover.__docgenInfo = {
   "description": "",
   "methods": [],
@@ -229,4 +323,9 @@ keepInViewExample.__docgenInfo = {
   "description": "",
   "methods": [],
   "displayName": "keepInViewExample"
+};
+customOffset.__docgenInfo = {
+  "description": "",
+  "methods": [],
+  "displayName": "customOffset"
 };

package/es/components/Popover/index.js

@@ -84,9 +84,39 @@ export default function Popover(_ref) {
     ariaLabel,
     inlineBlock,
     withFocusControl = true,
+    offset: customOffset,
+    headerAvatarSizing,
     ...props
   } = _ref;
   const [visible, setVisible] = useState(false);
+  const middleware = useMemo(() => [offset(_ref2 => {
+    let {
+      rects
+    } = _ref2;
+    const defaultOffset = {
+      mainAxis: 10,
+      alignmentAxis: -rects.floating.width
+    };
+    if (customOffset) {
+      // For simple placements (right, left, top, bottom), use crossAxis instead of alignmentAxis
+      const placement = DIRECTIONS_MAP[direction] || direction || "right";
+      const isSimplePlacement = !placement.includes("-");
+      if (isSimplePlacement && customOffset.alignmentAxis !== undefined) {
+        return {
+          ...defaultOffset,
+          mainAxis: customOffset.mainAxis !== undefined ? customOffset.mainAxis : defaultOffset.mainAxis,
+          crossAxis: customOffset.alignmentAxis
+        };
+      }
+      return {
+        ...defaultOffset,
+        ...customOffset
+      };
+    }
+    return defaultOffset;
+  }), flip({
+    fallbackAxisSideDirection: "start"
+  }), shift()], [direction, customOffset]);
   const {
     refs,
     floatingStyles,
@@ -96,17 +126,7 @@ export default function Popover(_ref) {
     onOpenChange: setVisible,
     placement: DIRECTIONS_MAP[direction] || direction || "right",
     whileElementsMounted: autoUpdate,
-    middleware: [offset(_ref2 => {
-      let {
-        rects
-      } = _ref2;
-      return {
-        mainAxis: 10,
-        alignmentAxis: -rects.floating.width
-      };
-    }), flip({
-      fallbackAxisSideDirection: "start"
-    }), shift()]
+    middleware
   });
   const hover = useHover(context, {
     move: false,
@@ -132,10 +152,19 @@ export default function Popover(_ref) {
     tabIndex: "0"
   }), [getReferenceProps, refs.setReference]);
   const directionClass = useMemo(() => context.placement === DIRECTIONS_MAP[direction] ? direction : context.placement, [context.placement, direction]);
-  const style = useMemo(() => ({
-    ...floatingStyles,
-    zIndex: getFloatingUiZIndex(context.refs.reference)
-  }), [floatingStyles, context.refs.reference]);
+  const style = useMemo(() => {
+    const baseStyle = {
+      ...floatingStyles,
+      zIndex: getFloatingUiZIndex(context.refs.reference)
+    };
+
+    // Add CSS-based positioning for Header Avatar sizing changes
+    if (headerAvatarSizing) {
+      const translateY = headerAvatarSizing === "large" ? -56 : -3;
+      baseStyle.transform = `${baseStyle.transform || ""} translateY(${translateY}px)`;
+    }
+    return baseStyle;
+  }, [floatingStyles, context.refs.reference, headerAvatarSizing]);
   const containsLinks = withFocusControl && refs.floating?.current?.querySelectorAll("a").length;
   const visiblePopoverClassName = useMemo(() => `Tooltip popover visible ${directionClass}`, [directionClass]);
   const floatingProps = useMemo(() => getFloatingProps({
@@ -230,7 +259,11 @@ Popover.propTypes = {
   tabIndex: PropTypes.number,
   className: PropTypes.string,
   /** Render tooltip with focus control when there is link inside, defaults to true */
-  withFocusControl: PropTypes.bool
+  withFocusControl: PropTypes.bool,
+  /** Custom offset configuration for the popover positioning. Can be an object with mainAxis and/or alignmentAxis properties, or a function that returns an offset object. */
+  offset: PropTypes.oneOfType([PropTypes.object, PropTypes.func]),
+  /** Special prop for Header Avatar to apply CSS-based positioning adjustments when sizing changes dynamically */
+  headerAvatarSizing: PropTypes.oneOf(["large", "default", "small"])
 };
 Popover.__docgenInfo = {
   "description": "",
@@ -356,6 +389,35 @@ Popover.__docgenInfo = {
         "name": "string"
       },
       "required": false
+    },
+    "offset": {
+      "description": "Custom offset configuration for the popover positioning. Can be an object with mainAxis and/or alignmentAxis properties, or a function that returns an offset object.",
+      "type": {
+        "name": "union",
+        "value": [{
+          "name": "object"
+        }, {
+          "name": "func"
+        }]
+      },
+      "required": false
+    },
+    "headerAvatarSizing": {
+      "description": "Special prop for Header Avatar to apply CSS-based positioning adjustments when sizing changes dynamically",
+      "type": {
+        "name": "enum",
+        "value": [{
+          "value": "\"large\"",
+          "computed": false
+        }, {
+          "value": "\"default\"",
+          "computed": false
+        }, {
+          "value": "\"small\"",
+          "computed": false
+        }]
+      },
+      "required": false
     }
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orcs-design-system",
-  "version": "3.3.34",
+  "version": "3.3.35",
   "engines": {
     "node": "20.12.2"
   },