@elastic/eui 62.0.3 → 63.0.0

package/es/components/page/page_header/page_header_content.js

@@ -1,4 +1,4 @@
-var _excluded = ["className", "pageTitle", "pageTitleProps", "iconType", "iconProps", "tabs", "tabsProps", "description", "breadcrumbs", "breadcrumbProps", "alignItems", "responsive", "rightSideItems", "rightSideGroupProps", "children"],
+var _excluded = ["className", "pageTitle", "pageTitleProps", "iconType", "iconProps", "tabs", "tabsProps", "description", "breadcrumbs", "breadcrumbProps", "alignItems", "responsive", "rightSideItems", "rightSideGroupProps", "children", "restrictWidth", "paddingSize", "bottomBorder", "style"],
     _excluded2 = ["label"];
 
 function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
@@ -23,9 +23,13 @@ import { EuiFlexGroup, EuiFlexItem } from '../../flex';
 import { EuiSpacer } from '../../spacer';
 import { EuiTitle } from '../../title';
 import { EuiText } from '../../text';
-import { useIsWithinBreakpoints } from '../../../services/hooks';
+import { useIsWithinBreakpoints, useEuiTheme } from '../../../services';
 import { EuiScreenReaderOnly } from '../../accessibility';
 import { EuiBreadcrumbs } from '../../breadcrumbs';
+import { useEuiPaddingCSS } from '../../../global_styling';
+import { setStyleForRestrictedPageWidth } from '../_restrict_width';
+import { euiPageHeaderStyles } from './page_header.styles';
+import { euiPageHeaderContentStyles } from './page_header_content.styles';
 import { jsx as ___EmotionJSX } from "@emotion/react";
 export var ALIGN_ITEMS = ['top', 'bottom', 'center', 'stretch']; // Gets all the tab props including the button or link props
 
@@ -40,17 +44,58 @@ export var EuiPageHeaderContent = function EuiPageHeaderContent(_ref) {
       description = _ref.description,
       breadcrumbs = _ref.breadcrumbs,
       breadcrumbProps = _ref.breadcrumbProps,
-      _ref$alignItems = _ref.alignItems,
-      alignItems = _ref$alignItems === void 0 ? 'top' : _ref$alignItems,
+      alignItems = _ref.alignItems,
       _ref$responsive = _ref.responsive,
       responsive = _ref$responsive === void 0 ? true : _ref$responsive,
       rightSideItems = _ref.rightSideItems,
       rightSideGroupProps = _ref.rightSideGroupProps,
       children = _ref.children,
+      restrictWidth = _ref.restrictWidth,
+      _ref$paddingSize = _ref.paddingSize,
+      _paddingSize = _ref$paddingSize === void 0 ? 'none' : _ref$paddingSize,
+      _bottom_border = _ref.bottomBorder,
+      style = _ref.style,
       rest = _objectWithoutProperties(_ref, _excluded);
 
   var isResponsiveBreakpoint = useIsWithinBreakpoints(['xs', 's'], !!responsive);
+  var useTheme = useEuiTheme();
   var classes = classNames('euiPageHeaderContent');
+  var pageHeaderStyles = euiPageHeaderStyles(useTheme);
+  var contentStyles = euiPageHeaderContentStyles(useTheme);
+  var styles = setStyleForRestrictedPageWidth(restrictWidth, style);
+  var paddingSides = 'vertical';
+  var paddingSize = _paddingSize;
+  var bottomBorder = _bottom_border;
+  var onlyChildren = !tabs && !pageTitle && !rightSideItems && !description && children;
+  var onlyTabs = tabs && !pageTitle && !rightSideItems && !description && !children;
+  var tabsAsTitle = tabs && !pageTitle;
+  var tabsAtTheBottom = pageTitle && tabs;
+  var borderWithoutPadding = (!paddingSize || paddingSize === 'none') && bottomBorder;
+
+  if (onlyTabs) {
+    paddingSize = 'none';
+  } else if (tabsAsTitle) {
+    paddingSides = 'bottom';
+  } else if (tabsAtTheBottom) {
+    paddingSides = 'top';
+    bottomBorder = bottomBorder === false ? false : true;
+  } else if (borderWithoutPadding) {
+    paddingSides = 'bottom';
+    paddingSize = 'l';
+  }
+
+  var blockPadding = useEuiPaddingCSS(paddingSides);
+  var cssStyles = [contentStyles.euiPageHeaderContent, bottomBorder && pageHeaderStyles.border, blockPadding[paddingSize]];
+  var childrenOnlyStyles = [contentStyles.flex, contentStyles[alignItems || 'center'], responsive === true && isResponsiveBreakpoint && contentStyles.responsive, responsive === 'reverse' && isResponsiveBreakpoint && contentStyles.responsiveReverse]; // Don't go any further if there's no other content than children
+
+  if (onlyChildren) {
+    return ___EmotionJSX("div", _extends({
+      css: cssStyles
+    }, rest), ___EmotionJSX("div", {
+      css: childrenOnlyStyles
+    }, children));
+  }
+
   var descriptionNode;
 
   if (description) {
@@ -68,10 +113,10 @@ export var EuiPageHeaderContent = function EuiPageHeaderContent(_ref) {
 
   if (pageTitle) {
     var icon = iconType ? ___EmotionJSX(EuiIcon, _extends({
-      size: "xl"
+      size: "xl",
+      css: contentStyles.euiPageHeaderContent__titleIcon
     }, iconProps, {
-      type: iconType,
-      className: classNames('euiPageHeaderContent__titleIcon', iconProps === null || iconProps === void 0 ? void 0 : iconProps.className)
+      type: iconType
     })) : undefined;
     pageTitleNode = ___EmotionJSX(EuiTitle, _extends({}, pageTitleProps, {
       size: "l"
@@ -146,22 +191,25 @@ export var EuiPageHeaderContent = function EuiPageHeaderContent(_ref) {
       grow: false
     }, ___EmotionJSX(EuiFlexGroup, _extends({
       wrap: true,
-      responsive: false
-    }, rightSideGroupProps, {
-      className: classNames('euiPageHeaderContent__rightSideItems', rightSideGroupProps === null || rightSideGroupProps === void 0 ? void 0 : rightSideGroupProps.className)
-    }), wrapWithFlex()));
+      responsive: false,
+      direction: isResponsiveBreakpoint ? undefined : 'rowReverse'
+    }, rightSideGroupProps), wrapWithFlex()));
   }
 
   return alignItems === 'top' || isResponsiveBreakpoint ? ___EmotionJSX("div", _extends({
-    className: classes
+    className: classes,
+    css: cssStyles,
+    style: styles
   }, rest), optionalBreadcrumbs, ___EmotionJSX(EuiFlexGroup, {
     responsive: !!responsive,
     className: "euiPageHeaderContent__top",
     alignItems: pageTitle ? 'flexStart' : 'baseline',
     gutterSize: "l"
   }, isResponsiveBreakpoint && responsive === 'reverse' ? ___EmotionJSX(React.Fragment, null, rightSideFlexItem, ___EmotionJSX(EuiFlexItem, null, leftSideOrder)) : ___EmotionJSX(React.Fragment, null, ___EmotionJSX(EuiFlexItem, null, leftSideOrder), rightSideFlexItem)), bottomContentNode) : ___EmotionJSX("div", _extends({
-    className: classes
-  }, rest), ___EmotionJSX(EuiFlexGroup, {
+    className: classes,
+    css: cssStyles,
+    style: styles
+  }, rest), optionalBreadcrumbs, ___EmotionJSX(EuiFlexGroup, {
     responsive: !!responsive,
     className: "euiPageHeaderContent__top",
     alignItems: alignItems === 'bottom' ? 'flexEnd' : alignItems,
@@ -173,6 +221,17 @@ EuiPageHeaderContent.propTypes = {
   "aria-label": PropTypes.string,
   "data-test-subj": PropTypes.string,
 
+  /**
+     * The only option is on/off
+     */
+  bottomBorder: PropTypes.bool,
+
+  /**
+     * Adjust the padding.
+     * When using this setting it's best to be consistent throughout all similar usages
+     */
+  paddingSize: PropTypes.any,
+
   /**
      * Set to false if you don't want the children to stack at small screen sizes.
      * Set to `reverse` to display the right side content first for the sake of hierarchy (like global time)
@@ -181,7 +240,7 @@ EuiPageHeaderContent.propTypes = {
 
   /**
      * Vertical alignment of the left and right side content;
-     * Default is `middle` for custom content, but `top` for when `pageTitle` or `tabs` are included
+     * Default is `center` for custom content, but `top` for when `pageTitle` or `tabs` are included
      */
   alignItems: PropTypes.any,
 
@@ -243,6 +302,7 @@ EuiPageHeaderContent.propTypes = {
     "aria-label": PropTypes.string,
     "data-test-subj": PropTypes.string,
     href: PropTypes.string,
+    rel: PropTypes.string,
     onClick: PropTypes.func,
 
     /**
@@ -300,5 +360,14 @@ EuiPageHeaderContent.propTypes = {
          * Adds a bottom border to separate it from the content after
          */
     bottomBorder: PropTypes.bool
-  })
+  }),
+
+  /**
+     * Sets the max-width of the page,
+     * set to `true` to use the default size of `1200px`,
+     * set to `false` to not restrict the width,
+     * set to a number for a custom width in px,
+     * set to a string for a custom width in custom measurement.
+     */
+  restrictWidth: PropTypes.oneOfType([PropTypes.bool.isRequired, PropTypes.number.isRequired, PropTypes.string.isRequired])
 };

package/es/components/page/page_header/page_header_content.styles.js

@@ -0,0 +1,84 @@
+function _EMOTION_STRINGIFIED_CSS_ERROR__() { return "You have tried to stringify object returned from `css` function. It isn't supposed to be used directly (e.g. as value of the `className` prop), but rather handed to emotion so it can handle it (e.g. as value of `css` prop)."; }
+
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+import { css } from '@emotion/react';
+import { logicalCSS } from '../../../global_styling';
+
+var _ref = process.env.NODE_ENV === "production" ? {
+  name: "1ajq27l-responsiveReverse",
+  styles: "flex-direction:column-reverse;align-items:flex-start;label:responsiveReverse;"
+} : {
+  name: "1ajq27l-responsiveReverse",
+  styles: "flex-direction:column-reverse;align-items:flex-start;label:responsiveReverse;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+
+var _ref2 = process.env.NODE_ENV === "production" ? {
+  name: "177mkz8-responsive",
+  styles: "flex-direction:column;align-items:flex-start;label:responsive;"
+} : {
+  name: "177mkz8-responsive",
+  styles: "flex-direction:column;align-items:flex-start;label:responsive;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+
+var _ref3 = process.env.NODE_ENV === "production" ? {
+  name: "1uwc4oj-stretch",
+  styles: "align-items:stretch;label:stretch;"
+} : {
+  name: "1uwc4oj-stretch",
+  styles: "align-items:stretch;label:stretch;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+
+var _ref4 = process.env.NODE_ENV === "production" ? {
+  name: "8391db-center",
+  styles: "align-items:center;label:center;"
+} : {
+  name: "8391db-center",
+  styles: "align-items:center;label:center;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+
+var _ref5 = process.env.NODE_ENV === "production" ? {
+  name: "1msaet2-bottom",
+  styles: "align-items:flex-end;label:bottom;"
+} : {
+  name: "1msaet2-bottom",
+  styles: "align-items:flex-end;label:bottom;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+
+var _ref6 = process.env.NODE_ENV === "production" ? {
+  name: "1gnwbvd-top",
+  styles: "align-items:flex-start;label:top;"
+} : {
+  name: "1gnwbvd-top",
+  styles: "align-items:flex-start;label:top;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+
+export var euiPageHeaderContentStyles = function euiPageHeaderContentStyles(_ref7) {
+  var euiTheme = _ref7.euiTheme;
+  return {
+    euiPageHeaderContent: /*#__PURE__*/css(logicalCSS('width', '100%'), ";", logicalCSS('margin-horizontal', 'auto'), ";;label:euiPageHeaderContent;"),
+    // alignItems
+    top: _ref6,
+    bottom: _ref5,
+    center: _ref4,
+    stretch: _ref3,
+    // Children only (legacy) expects EuiPageHeaderSections as children
+    flex: /*#__PURE__*/css("flex-direction:row;display:flex;gap:", euiTheme.size.base, ";justify-content:space-between;;label:flex;"),
+    // Responsive (what to do at the smaller breakpoint)
+    responsive: _ref2,
+    responsiveReverse: _ref,
+    // Content
+    euiPageHeaderContent__titleIcon: /*#__PURE__*/css("position:relative;", logicalCSS('top', "-".concat(euiTheme.size.xs)), ";", logicalCSS('margin-right', euiTheme.size.base), ";;label:euiPageHeaderContent__titleIcon;")
+  };
+};

package/es/components/page/page_section/index.js

@@ -0,0 +1,8 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+export { EuiPageSection } from './page_section';

package/es/components/page/page_section/page_section.js

@@ -0,0 +1,102 @@
+var _excluded = ["children", "alignment", "restrictWidth", "bottomBorder", "paddingSize", "color", "grow", "contentProps"];
+
+function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+import React from 'react';
+import PropTypes from "prop-types";
+import { setStyleForRestrictedPageWidth } from '../_restrict_width';
+import { useEuiTheme } from '../../../services';
+import { euiPageSectionContentStyles, euiPageSectionStyles } from './page_section.styles';
+import { useEuiPaddingCSS, useEuiBackgroundColorCSS } from '../../../global_styling';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+export var EuiPageSection = function EuiPageSection(_ref) {
+  var children = _ref.children,
+      _ref$alignment = _ref.alignment,
+      alignment = _ref$alignment === void 0 ? 'top' : _ref$alignment,
+      _ref$restrictWidth = _ref.restrictWidth,
+      restrictWidth = _ref$restrictWidth === void 0 ? false : _ref$restrictWidth,
+      bottomBorder = _ref.bottomBorder,
+      _ref$paddingSize = _ref.paddingSize,
+      paddingSize = _ref$paddingSize === void 0 ? 'l' : _ref$paddingSize,
+      _ref$color = _ref.color,
+      color = _ref$color === void 0 ? 'transparent' : _ref$color,
+      _ref$grow = _ref.grow,
+      grow = _ref$grow === void 0 ? false : _ref$grow,
+      contentProps = _ref.contentProps,
+      rest = _objectWithoutProperties(_ref, _excluded);
+
+  // Set max-width as a style prop
+  var widthStyles = setStyleForRestrictedPageWidth(restrictWidth, contentProps === null || contentProps === void 0 ? void 0 : contentProps.style);
+  var useTheme = useEuiTheme();
+  var styles = euiPageSectionStyles(useTheme);
+  var inlinePadding = useEuiPaddingCSS('horizontal');
+  var blockPadding = useEuiPaddingCSS('vertical');
+  var colors = useEuiBackgroundColorCSS();
+  var cssStyles = [styles.euiPageSection, grow && styles.grow, inlinePadding[paddingSize], bottomBorder === 'extended' && styles.border, alignment && styles[alignment], colors[color]];
+  var contentStyles = euiPageSectionContentStyles();
+  var cssContentStyles = [contentStyles.euiPageSection__content, blockPadding[paddingSize], bottomBorder === true && styles.border, alignment.toLowerCase().includes('center') && contentStyles.center, restrictWidth && contentStyles.restrictWidth];
+  return ___EmotionJSX("div", _extends({
+    css: cssStyles
+  }, rest), ___EmotionJSX("div", _extends({
+    css: cssContentStyles
+  }, contentProps, {
+    style: widthStyles
+  }), children));
+};
+EuiPageSection.propTypes = {
+  className: PropTypes.string,
+  "aria-label": PropTypes.string,
+  "data-test-subj": PropTypes.string,
+
+  /**
+     * Sets the max-width of the page,
+     * set to `true` to use the default size of `1200px`,
+     * set to `false` to not restrict the width,
+     * set to a number for a custom width in px,
+     * set to a string for a custom width in custom measurement.
+     */
+  restrictWidth: PropTypes.oneOfType([PropTypes.bool.isRequired, PropTypes.number.isRequired, PropTypes.string.isRequired]),
+
+  /**
+     * Adds a bottom border to separate it from the content after;
+     * Passing `extended` will ensure the border touches the sides of the parent container.
+     */
+  bottomBorder: PropTypes.oneOfType([PropTypes.bool.isRequired, PropTypes.oneOf(["extended"])]),
+
+  /**
+       * Background color of the section;
+       * Usually a lightened form of the brand colors
+       */
+  color: PropTypes.any,
+
+  /**
+       * Padding for all four sides
+       */
+  paddingSize: PropTypes.any,
+
+  /**
+       * Horizontal and/or vertical alignment of the section contents
+       */
+  alignment: PropTypes.any,
+
+  /**
+       * When true the panel will grow in height to fill container if parent is a flex group
+       */
+  grow: PropTypes.bool,
+
+  /**
+       * Passed down to the div wrapper of the section contents
+       */
+  contentProps: PropTypes.any
+};

package/es/components/page/page_section/page_section.styles.js

@@ -0,0 +1,43 @@
+function _EMOTION_STRINGIFIED_CSS_ERROR__() { return "You have tried to stringify object returned from `css` function. It isn't supposed to be used directly (e.g. as value of the `className` prop), but rather handed to emotion so it can handle it (e.g. as value of `css` prop)."; }
+
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+import { css } from '@emotion/react';
+import { logicalCSS } from '../../../global_styling';
+export var ALIGNMENTS = ['top', 'center', 'horizontalCenter'];
+
+var _ref = process.env.NODE_ENV === "production" ? {
+  name: "122lw0e-grow",
+  styles: "flex-grow:1;label:grow;"
+} : {
+  name: "122lw0e-grow",
+  styles: "flex-grow:1;label:grow;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+
+export var euiPageSectionStyles = function euiPageSectionStyles(_ref2) {
+  var euiTheme = _ref2.euiTheme;
+  return {
+    euiPageSection: /*#__PURE__*/css(logicalCSS('width', '100%'), ";", logicalCSS('min-width', '0'), ";display:flex;flex-direction:column;;label:euiPageSection;"),
+    grow: _ref,
+    border: /*#__PURE__*/css(logicalCSS('border-bottom', euiTheme.border.thin), ";;label:border;"),
+    // Alignments
+    top: /*#__PURE__*/css(";label:top;"),
+    center: /*#__PURE__*/css(logicalCSS('width', 'auto'), ";align-items:center;justify-content:center;;label:center;"),
+    horizontalCenter: /*#__PURE__*/css(logicalCSS('width', 'auto'), ";align-items:center;;label:horizontalCenter;")
+  };
+};
+export var euiPageSectionContentStyles = function euiPageSectionContentStyles() {
+  return {
+    euiPageSection__content: /*#__PURE__*/css(logicalCSS('width', '100%'), ";;label:euiPageSection__content;"),
+    // Alignments
+    center: /*#__PURE__*/css(logicalCSS('width', 'auto'), ";", logicalCSS('margin-horizontal', 'auto'), ";;label:center;"),
+    // Max widths
+    restrictWidth: /*#__PURE__*/css(logicalCSS('margin-horizontal', 'auto'), ";;label:restrictWidth;")
+  };
+};

package/es/components/page/page_side_bar/index.js

@@ -5,4 +5,4 @@
  * in compliance with, at your election, the Elastic License 2.0 or the Server
  * Side Public License, v 1.
  */
-export { EuiPageSideBar } from './page_side_bar';
+export { EuiPageSideBar_Deprecated } from './page_side_bar';

package/es/components/page/page_side_bar/page_side_bar.js

@@ -25,7 +25,12 @@ var paddingSizeToClassNameMap = {
   l: 'euiPageSideBar--paddingLarge'
 };
 export var PADDING_SIZES = keysOf(paddingSizeToClassNameMap);
-export var EuiPageSideBar = function EuiPageSideBar(_ref) {
+
+/**
+ * **DEPRECATED**
+ * Use the new EuiPageSidebar instead
+ */
+export var EuiPageSideBar_Deprecated = function EuiPageSideBar_Deprecated(_ref) {
   var children = _ref.children,
       className = _ref.className,
       sticky = _ref.sticky,
@@ -40,9 +45,9 @@ export var EuiPageSideBar = function EuiPageSideBar(_ref) {
     className: classes
   }, rest), children);
 };
-EuiPageSideBar.propTypes = {
+EuiPageSideBar_Deprecated.propTypes = {
   /**
-     * Adds `position: sticky` and affords for any fixed position headers
+     * Adds `position: sticky`
      */
   sticky: PropTypes.bool,
 

package/es/components/page/page_sidebar/index.js

@@ -0,0 +1,8 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+export { EuiPageSidebar } from './page_sidebar';

package/es/components/page/page_sidebar/page_sidebar.js

@@ -0,0 +1,110 @@
+var _excluded = ["children", "className", "sticky", "paddingSize", "minWidth", "responsive", "style"];
+
+function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+
+function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) { symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); } keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
+function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+import React, { useEffect, useState } from 'react';
+import PropTypes from "prop-types";
+import { logicalStyle, useEuiPaddingCSS } from '../../../global_styling';
+import { useEuiTheme, useIsWithinBreakpoints } from '../../../services';
+import { euiPageSidebarStyles } from './page_sidebar.styles';
+import { jsx as ___EmotionJSX } from "@emotion/react";
+export var EuiPageSidebar = function EuiPageSidebar(_ref) {
+  var children = _ref.children,
+      className = _ref.className,
+      _ref$sticky = _ref.sticky,
+      sticky = _ref$sticky === void 0 ? false : _ref$sticky,
+      _ref$paddingSize = _ref.paddingSize,
+      paddingSize = _ref$paddingSize === void 0 ? 'none' : _ref$paddingSize,
+      _ref$minWidth = _ref.minWidth,
+      minWidth = _ref$minWidth === void 0 ? 248 : _ref$minWidth,
+      _ref$responsive = _ref.responsive,
+      responsive = _ref$responsive === void 0 ? ['xs', 's'] : _ref$responsive,
+      style = _ref.style,
+      rest = _objectWithoutProperties(_ref, _excluded);
+
+  var themeContext = useEuiTheme();
+  var styles = euiPageSidebarStyles(themeContext);
+  var isResponding = useIsWithinBreakpoints(responsive);
+  var cssStyles = [styles.euiPageSidebar, !isResponding && sticky && styles.sticky, useEuiPaddingCSS()[paddingSize]]; // Inline styles for setting up width and sticky offsets
+
+  var _useState = useState(_objectSpread(_objectSpread({}, style), logicalStyle('min-width', isResponding ? '100%' : minWidth))),
+      _useState2 = _slicedToArray(_useState, 2),
+      inlineStyles = _useState2[0],
+      setInlineStyles = _useState2[1];
+
+  useEffect(function () {
+    if (sticky) {
+      var euiHeaderFixedCounter = Number(document.body.dataset.fixedHeaders);
+      var offset = _typeof(sticky) === 'object' ? sticky === null || sticky === void 0 ? void 0 : sticky.offset : themeContext.euiTheme.base * 3 * euiHeaderFixedCounter;
+      setInlineStyles(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, style), logicalStyle('min-width', isResponding ? '100%' : minWidth)), logicalStyle('top', offset)), logicalStyle('max-height', "calc(100vh - ".concat(offset, "px)"))));
+    }
+  }, [style, sticky, themeContext.euiTheme.base, isResponding, minWidth]);
+  return ___EmotionJSX("div", _extends({
+    className: className,
+    css: cssStyles,
+    style: inlineStyles
+  }, rest), children);
+};
+EuiPageSidebar.propTypes = {
+  /**
+     * Adjust the padding.
+     * When using this setting it's best to be consistent throughout all similar usages.
+     */
+  paddingSize: PropTypes.any,
+
+  /**
+     * Adds `position: sticky` and affords for any fixed position headers.
+     */
+  sticky: PropTypes.oneOfType([PropTypes.bool.isRequired, PropTypes.shape({
+    /**
+             * To account for any fixed elements like headers,
+             * pass in the value of the total height of those fixed elements.
+             */
+    offset: PropTypes.number
+  }).isRequired]),
+
+  /**
+     * A minimum width is necessary to maintain size.
+     * Be sure to take `paddingSize` into account.
+     */
+  minWidth: PropTypes.any,
+
+  /**
+     * Sets the `minWidth` to 100% when within these breakpoints.
+     */
+  responsive: PropTypes.arrayOf(PropTypes.any.isRequired),
+  className: PropTypes.string,
+  "aria-label": PropTypes.string,
+  "data-test-subj": PropTypes.string
+};

package/es/components/page/page_sidebar/page_sidebar.styles.js

@@ -0,0 +1,29 @@
+function _EMOTION_STRINGIFIED_CSS_ERROR__() { return "You have tried to stringify object returned from `css` function. It isn't supposed to be used directly (e.g. as value of the `className` prop), but rather handed to emotion so it can handle it (e.g. as value of `css` prop)."; }
+
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0 and the Server Side Public License, v 1; you may not use this file except
+ * in compliance with, at your election, the Elastic License 2.0 or the Server
+ * Side Public License, v 1.
+ */
+import { css } from '@emotion/react';
+import { euiYScroll } from '../../../global_styling';
+
+var _ref = process.env.NODE_ENV === "production" ? {
+  name: "wtyx0k-euiPageSidebar",
+  styles: "flex:0 1 0%;label:euiPageSidebar;"
+} : {
+  name: "wtyx0k-euiPageSidebar",
+  styles: "flex:0 1 0%;label:euiPageSidebar;",
+  toString: _EMOTION_STRINGIFIED_CSS_ERROR__
+};
+
+export var euiPageSidebarStyles = function euiPageSidebarStyles(euiThemeContext) {
+  return {
+    euiPageSidebar: _ref,
+    sticky: /*#__PURE__*/css(euiYScroll(euiThemeContext, {
+      height: 'auto'
+    }), ";flex-grow:1;position:sticky;;label:sticky;")
+  };
+};