@elastic/eui 62.2.0 → 63.0.0

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;")
+  };
+};

package/es/components/page/page_template.js

@@ -22,17 +22,25 @@ function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) r
 import React from 'react';
 import PropTypes from "prop-types";
 import classNames from 'classnames';
+import { css } from '@emotion/react';
 import { EuiPage } from './page';
-import { EuiPageSideBar } from './page_side_bar';
+import { EuiPageSideBar_Deprecated as EuiPageSideBar } from './page_side_bar';
 import { EuiPageBody } from './page_body';
 import { EuiPageHeader } from './page_header';
-import { EuiPageContent, EuiPageContentBody } from './page_content';
+import { EuiPageContent_Deprecated as EuiPageContent, EuiPageContentBody_Deprecated as EuiPageContentBody } from './page_content';
 import { EuiBottomBar } from '../bottom_bar';
 import { useIsWithinBreakpoints } from '../../services';
 import { EuiFlexGroup, EuiFlexItem } from '../flex';
+import { useEuiPaddingSize } from '../../global_styling';
 import { jsx as ___EmotionJSX } from "@emotion/react";
 export var TEMPLATES = ['default', 'centeredBody', 'centeredContent', 'empty'];
-export var EuiPageTemplate = function EuiPageTemplate(_ref) {
+
+/**
+ * This component has been deprecated in favor of the new
+ * namespaced version. You can still import this component
+ * for a period of time by importing `as EuiPageTemplate`.
+ */
+export var EuiPageTemplate_Deprecated = function EuiPageTemplate_Deprecated(_ref) {
   var _pageBodyProps2;
 
   var _ref$template = _ref.template,
@@ -58,9 +66,12 @@ export var EuiPageTemplate = function EuiPageTemplate(_ref) {
       minHeight = _ref$minHeight === void 0 ? 460 : _ref$minHeight,
       rest = _objectWithoutProperties(_ref, _excluded);
 
+  // BWC page header margin to match padding
+  var headerMargin = /*#__PURE__*/css("margin-bottom: ".concat(useEuiPaddingSize(paddingSize)), ";label:headerMargin;");
   /**
    * Full height ~madness~ logic
    */
+
   var canFullHeight = useIsWithinBreakpoints(['m', 'l', 'xl']) && (template === 'default' || template === 'empty');
   var fullHeightClass = {
     'eui-fullHeight': fullHeight && canFullHeight
@@ -124,7 +135,8 @@ export var EuiPageTemplate = function EuiPageTemplate(_ref) {
       }, pageSideBarProps), pageSideBar), ___EmotionJSX(EuiPageBody, _extends({
         paddingSize: paddingSize
       }, pageBodyProps), pageHeader && ___EmotionJSX(EuiPageHeader, _extends({
-        restrictWidth: restrictWidth
+        restrictWidth: restrictWidth,
+        css: headerMargin
       }, pageHeader)), ___EmotionJSX(EuiPageContent, _extends({
         verticalPosition: "center",
         horizontalPosition: "center",
@@ -142,6 +154,7 @@ export var EuiPageTemplate = function EuiPageTemplate(_ref) {
       }, pageBodyProps), pageHeader && ___EmotionJSX(EuiPageHeader, _extends({
         paddingSize: "none",
         restrictWidth: false,
+        css: headerMargin,
         bottomBorder: true
       }, pageHeader)), ___EmotionJSX(EuiPageBody, null, ___EmotionJSX(EuiPageContent, _extends({
         verticalPosition: "center",
@@ -171,7 +184,8 @@ export var EuiPageTemplate = function EuiPageTemplate(_ref) {
         panelled: true,
         paddingSize: paddingSize
       }, pageBodyProps), pageHeader && ___EmotionJSX(EuiPageHeader, _extends({
-        restrictWidth: restrictWidth
+        restrictWidth: restrictWidth,
+        css: headerMargin
       }, pageHeader)), ___EmotionJSX(EuiPageContent, _extends({
         verticalPosition: "center",
         horizontalPosition: "center",
@@ -188,7 +202,8 @@ export var EuiPageTemplate = function EuiPageTemplate(_ref) {
         style: pageStyle
       }), ___EmotionJSX(EuiPageBody, pageBodyProps, pageHeader && ___EmotionJSX(EuiPageHeader, _extends({
         paddingSize: paddingSize,
-        restrictWidth: restrictWidth
+        restrictWidth: restrictWidth,
+        bottomBorder: "extended"
       }, pageHeader)), ___EmotionJSX(EuiPageContent, {
         role: null,
         borderRadius: "none",
@@ -225,7 +240,9 @@ export var EuiPageTemplate = function EuiPageTemplate(_ref) {
       }, pageSideBarProps), pageSideBar), ___EmotionJSX(EuiPageBody, _extends({
         paddingSize: paddingSize
       }, pageBodyProps), pageHeader && ___EmotionJSX(EuiPageHeader, _extends({
-        restrictWidth: restrictWidth
+        restrictWidth: restrictWidth,
+        bottomBorder: true,
+        css: headerMargin
       }, pageHeader)), ___EmotionJSX(EuiPageContent, _extends({
         hasBorder: false,
         hasShadow: false,
@@ -245,6 +262,7 @@ export var EuiPageTemplate = function EuiPageTemplate(_ref) {
       }, pageBodyProps), pageHeader && ___EmotionJSX(EuiPageHeader, _extends({
         paddingSize: "none",
         restrictWidth: false,
+        css: headerMargin,
         bottomBorder: true
       }, pageHeader)), ___EmotionJSX(EuiPageContent, _extends({
         hasBorder: false,
@@ -289,7 +307,8 @@ export var EuiPageTemplate = function EuiPageTemplate(_ref) {
         className: (_pageBodyProps2 = pageBodyProps) === null || _pageBodyProps2 === void 0 ? void 0 : _pageBodyProps2.className
       }, pageHeader && ___EmotionJSX(EuiPageHeader, _extends({
         bottomBorder: true,
-        restrictWidth: restrictWidth
+        restrictWidth: restrictWidth,
+        css: headerMargin
       }, pageHeader)), ___EmotionJSX(EuiPageContent, _extends({
         hasShadow: false,
         hasBorder: false,
@@ -306,7 +325,8 @@ export var EuiPageTemplate = function EuiPageTemplate(_ref) {
         style: pageStyle
       }), ___EmotionJSX(EuiPageBody, pageBodyProps, pageHeader && ___EmotionJSX(EuiPageHeader, _extends({
         restrictWidth: restrictWidth,
-        paddingSize: paddingSize
+        paddingSize: paddingSize,
+        bottomBorder: "extended"
       }, pageHeader)), ___EmotionJSX(EuiPageContent, _extends({
         hasBorder: pageHeader === undefined ? false : undefined,
         hasShadow: false,
@@ -319,7 +339,7 @@ export var EuiPageTemplate = function EuiPageTemplate(_ref) {
       }, pageContentBodyProps), children)), bottomBarNode));
   }
 };
-EuiPageTemplate.propTypes = {
+EuiPageTemplate_Deprecated.propTypes = {
   /**
      * Choose between 3 types of templates.
      * `default`: Typical layout with nothing centered
@@ -333,7 +353,7 @@ EuiPageTemplate.propTypes = {
      * Padding size will not get applied to the over-arching #EuiPage,
      * but will propogate through all the components to keep them in sync
      */
-  paddingSize: PropTypes.any,
+  paddingSize: PropTypes.oneOf(["none", "s", "m", "l"]),
 
   /**
      * Optionally include #EuiPageSideBar content.
@@ -346,7 +366,7 @@ EuiPageTemplate.propTypes = {
      */
   pageSideBarProps: PropTypes.shape({
     /**
-       * Adds `position: sticky` and affords for any fixed position headers
+       * Adds `position: sticky`
        */
     sticky: PropTypes.bool,
 
@@ -364,157 +384,27 @@ EuiPageTemplate.propTypes = {
      */
   pageHeader: PropTypes.shape({
     /**
-       * Adjust the padding.
-       * When using this setting it's best to be consistent throughout all similar usages
+       * Adjust the overall padding.
        */
     paddingSize: PropTypes.any,
-
-    /**
-       * Adds a bottom border to separate it from the content after
-       */
-    bottomBorder: PropTypes.bool,
     className: PropTypes.string,
     "aria-label": PropTypes.string,
     "data-test-subj": PropTypes.string,
 
-    /**
-       * 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)
-       */
-    responsive: PropTypes.oneOfType([PropTypes.bool.isRequired, PropTypes.oneOf(["reverse"])]),
-
-    /**
-       * Vertical alignment of the left and right side content;
-       * Default is `middle` for custom content, but `top` for when `pageTitle` or `tabs` are included
-       */
-    alignItems: PropTypes.any,
-
-    /**
-       * Pass custom an array of content to this side usually up to 3 buttons.
-       * The first button should be primary, usually with `fill` and will be visually displayed as the last item,
-       * but first in the tab order
-       */
-    rightSideItems: PropTypes.arrayOf(PropTypes.node.isRequired),
-
-    /**
-       * Additional EuiFlexGroup props to pass to the container of the `rightSideItems`
-       */
-    rightSideGroupProps: PropTypes.any,
-
-    /**
-       * Custom children will be rendered before the `tabs` unless no `pageTitle` is present, then it will be the last item
-       */
-    children: PropTypes.node,
-
-    /**
-       * Position is dependent on existing with a `pageTitle` or `tabs`
-       * Automatically get wrapped in a single paragraph tag inside an EuiText block
-       */
-    description: PropTypes.oneOfType([PropTypes.string.isRequired, PropTypes.node.isRequired]),
-
-    /**
-       * Wrapped in an `H1` so choose appropriately.
-       * A simple string is best
-       */
-    pageTitle: PropTypes.node,
-
-    /**
-       * Additional props to pass to the EuiTitle
-       */
-    pageTitleProps: PropTypes.shape({
-      className: PropTypes.string,
-      "aria-label": PropTypes.string,
-      "data-test-subj": PropTypes.string,
-      textTransform: PropTypes.any,
-      id: PropTypes.string
-    }),
-
-    /**
-       * Optional icon to place to the left of the title
-       */
-    iconType: PropTypes.oneOfType([PropTypes.oneOf(["accessibility", "addDataApp", "advancedSettingsApp", "agentApp", "aggregate", "alert", "analyzeEvent", "annotation", "apmApp", "apmTrace", "appSearchApp", "apps", "arrowDown", "arrowLeft", "arrowRight", "arrowUp", "arrowStart", "arrowEnd", "asterisk", "auditbeatApp", "beaker", "bell", "bellSlash", "bolt", "boxesHorizontal", "boxesVertical", "branch", "branchUser", "broom", "brush", "bug", "bullseye", "calendar", "canvasApp", "casesApp", "check", "checkInCircleFilled", "cheer", "classificationJob", "clock", "cloudDrizzle", "cloudStormy", "cloudSunny", "cluster", "codeApp", "color", "compute", "console", "consoleApp", "container", "continuityAbove", "continuityAboveBelow", "continuityBelow", "continuityWithin", "controlsHorizontal", "controlsVertical", "copy", "copyClipboard", "createAdvancedJob", "createMultiMetricJob", "createPopulationJob", "createSingleMetricJob", "cross", "crossClusterReplicationApp", "crossInACircleFilled", "crosshairs", "currency", "cut", "dashboardApp", "dataVisualizer", "database", "desktop", "devToolsApp", "discoverApp", "document", "documentEdit", "documentation", "documents", "dot", "doubleArrowLeft", "doubleArrowRight", "download", "editorAlignCenter", "editorAlignLeft", "editorAlignRight", "editorBold", "editorChecklist", "editorCodeBlock", "editorComment", "editorDistributeHorizontal", "editorDistributeVertical", "editorHeading", "editorItalic", "editorItemAlignBottom", "editorItemAlignCenter", "editorItemAlignLeft", "editorItemAlignMiddle", "editorItemAlignRight", "editorItemAlignTop", "editorLink", "editorOrderedList", "editorPositionBottomLeft", "editorPositionBottomRight", "editorPositionTopLeft", "editorPositionTopRight", "editorRedo", "editorStrike", "editorTable", "editorUnderline", "editorUndo", "editorUnorderedList", "email", "empty", "emsApp", "eql", "eraser", "exit", "expand", "expandMini", "exportAction", "eye", "eyeClosed", "faceHappy", "faceNeutral", "faceSad", "filebeatApp", "filter", "flag", "fleetApp", "fold", "folderCheck", "folderClosed", "folderExclamation", "folderOpen", "frameNext", "framePrevious", "fullScreen", "fullScreenExit", "function", "gear", "gisApp", "glasses", "globe", "grab", "grabHorizontal", "graphApp", "grid", "grokApp", "heart", "heartbeatApp", "heatmap", "help", "home", "iInCircle", "image", "importAction", "indexClose", "indexEdit", "indexFlush", "indexManagementApp", "indexMapping", "indexOpen", "indexPatternApp", "indexRollupApp", "indexRuntime", "indexSettings", "inputOutput", "inspect", "invert", "ip", "keyboard", "kqlField", "kqlFunction", "kqlOperand", "kqlSelector", "kqlValue", "kubernetesNode", "kubernetesPod", "layers", "lensApp", "lettering", "lineDashed", "lineDotted", "lineSolid", "link", "list", "listAdd", "lock", "lockOpen", "logoAWS", "logoAWSMono", "logoAerospike", "logoApache", "logoAppSearch", "logoAzure", "logoAzureMono", "logoBeats", "logoBusinessAnalytics", "logoCeph", "logoCloud", "logoCloudEnterprise", "logoCode", "logoCodesandbox", "logoCouchbase", "logoDocker", "logoDropwizard", "logoElastic", "logoElasticStack", "logoElasticsearch", "logoEnterpriseSearch", "logoEtcd", "logoGCP", "logoGCPMono", "logoGithub", "logoGmail", "logoGolang", "logoGoogleG", "logoHAproxy", "logoIBM", "logoIBMMono", "logoKafka", "logoKibana", "logoKubernetes", "logoLogging", "logoLogstash", "logoMaps", "logoMemcached", "logoMetrics", "logoMongodb", "logoMySQL", "logoNginx", "logoObservability", "logoOsquery", "logoPhp", "logoPostgres", "logoPrometheus", "logoRabbitmq", "logoRedis", "logoSecurity", "logoSiteSearch", "logoSketch", "logoSlack", "logoUptime", "logoWebhook", "logoWindows", "logoWorkplaceSearch", "logsApp", "logstashFilter", "logstashIf", "logstashInput", "logstashOutput", "logstashQueue", "machineLearningApp", "magnet", "magnifyWithExclamation", "magnifyWithMinus", "magnifyWithPlus", "managementApp", "mapMarker", "memory", "menu", "menuDown", "menuLeft", "menuRight", "menuUp", "merge", "metricbeatApp", "metricsApp", "minimize", "minus", "minusInCircle", "minusInCircleFilled", "mobile", "monitoringApp", "moon", "namespace", "nested", "node", "notebookApp", "number", "offline", "online", "outlierDetectionJob", "package", "packetbeatApp", "pageSelect", "pagesSelect", "paperClip", "partial", "pause", "payment", "pencil", "percent", "pin", "pinFilled", "pipelineApp", "play", "playFilled", "plus", "plusInCircle", "plusInCircleFilled", "popout", "push", "questionInCircle", "quote", "recentlyViewedApp", "refresh", "regressionJob", "reporter", "reportingApp", "returnKey", "save", "savedObjectsApp", "scale", "search", "searchProfilerApp", "securityAnalyticsApp", "securityApp", "securitySignal", "securitySignalDetected", "securitySignalResolved", "sessionViewer", "shard", "share", "snowflake", "sortDown", "sortLeft", "sortRight", "sortUp", "sortable", "spacesApp", "sqlApp", "starEmpty", "starEmptySpace", "starFilled", "starFilledSpace", "starMinusEmpty", "starMinusFilled", "starPlusEmpty", "starPlusFilled", "stats", "stop", "stopFilled", "stopSlash", "storage", "string", "submodule", "sun", "swatchInput", "symlink", "tableDensityCompact", "tableDensityExpanded", "tableDensityNormal", "tableOfContents", "tag", "tear", "temperature", "timeline", "timelionApp", "timeRefresh", "timeslider", "training", "trash", "unfold", "unlink", "upgradeAssistantApp", "uptimeApp", "user", "userAvatar", "users", "usersRolesApp", "vector", "videoPlayer", "visArea", "visAreaStacked", "visBarHorizontal", "visBarHorizontalStacked", "visBarVertical", "visBarVerticalStacked", "visGauge", "visGoal", "visLine", "visMapCoordinate", "visMapRegion", "visMetric", "visPie", "visTable", "visTagCloud", "visText", "visTimelion", "visVega", "visVisualBuilder", "visualizeApp", "watchesApp", "wordWrap", "wordWrapDisabled", "workplaceSearchApp", "wrench", "tokenAlias", "tokenAnnotation", "tokenArray", "tokenBinary", "tokenBoolean", "tokenClass", "tokenCompletionSuggester", "tokenConstant", "tokenDate", "tokenDenseVector", "tokenElement", "tokenEnum", "tokenEnumMember", "tokenEvent", "tokenException", "tokenField", "tokenFile", "tokenFlattened", "tokenFunction", "tokenGeo", "tokenHistogram", "tokenInterface", "tokenIP", "tokenJoin", "tokenKey", "tokenKeyword", "tokenMethod", "tokenMetricCounter", "tokenMetricGauge", "tokenModule", "tokenNamespace", "tokenNested", "tokenNull", "tokenNumber", "tokenObject", "tokenOperator", "tokenPackage", "tokenParameter", "tokenPercolator", "tokenProperty", "tokenRange", "tokenRankFeature", "tokenRankFeatures", "tokenRepo", "tokenSearchType", "tokenShape", "tokenString", "tokenStruct", "tokenSymbol", "tokenTag", "tokenText", "tokenTokenCount", "tokenVariable"]).isRequired, PropTypes.string.isRequired, PropTypes.elementType.isRequired]),
-
-    /**
-       * Additional EuiIcon props to apply to the optional icon
-       */
-    iconProps: PropTypes.any,
-
-    /**
-       * Optional array breadcrumbs that render before the `pageTitle`
-       */
-    breadcrumbs: PropTypes.arrayOf(PropTypes.shape({
-      className: PropTypes.string,
-      "aria-label": PropTypes.string,
-      "data-test-subj": PropTypes.string,
-      href: PropTypes.string,
-      rel: PropTypes.string,
-      onClick: PropTypes.func,
-
-      /**
-           * Visible label of the breadcrumb
-           */
-      text: PropTypes.node.isRequired,
-
-      /**
-           * Force a max-width on the breadcrumb text
-           */
-      truncate: PropTypes.bool,
-
-      /**
-           * Accepts any EuiLink `color` when rendered as one (has `href` or `onClick`)
-           */
-      color: PropTypes.any,
-
-      /**
-           * Override the existing `aria-current` which defaults to `page` for the last breadcrumb
-           */
-      "aria-current": PropTypes.any
-    }).isRequired),
-
-    /**
-       * Adjust the props of [EuiBreadcrumbs](#/navigation/breadcrumbs)
-       */
-    breadcrumbProps: PropTypes.any,
-
-    /**
-       * In-app navigation presented as large borderless tabs.
-       * Accepts an array of `EuiTab` objects;
-       */
-    tabs: PropTypes.arrayOf(PropTypes.shape({
-      /**
-         * Visible text of the tab
-         */
-      label: PropTypes.node.isRequired
-    }).isRequired),
-
-    /**
-       * Any extras to apply to the outer tabs container.
-       * Extends `EuiTabs`
-       */
-    tabsProps: PropTypes.shape({
-      className: PropTypes.string,
-      "aria-label": PropTypes.string,
-      "data-test-subj": PropTypes.string,
-
-      /**
-           * ReactNode to render as this component's content
-           */
-      children: PropTypes.node,
-
-      /**
-           * 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 `1000px (1200 for Amsterdam)`,
+       * 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])
+    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"])])
   }),
 
   /**
@@ -527,7 +417,7 @@ EuiPageTemplate.propTypes = {
 
     /**
        * Sets the max-width of the page,
-       * set to `true` to use the default size of `1000px (1200 for Amsterdam)`,
+       * 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.
@@ -649,7 +539,7 @@ EuiPageTemplate.propTypes = {
 
     /**
        * Sets the max-width of the page,
-       * set to `true` to use the default size of `1000px (1200 for Amsterdam)`,
+       * 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.
@@ -680,7 +570,17 @@ EuiPageTemplate.propTypes = {
          * Whether to wrap in an EuiPortal which appends the component to the body element.
          * Only works if `position` is `fixed`.
          */
-    usePortal: PropTypes.bool,
+    usePortal: PropTypes.oneOfType([PropTypes.bool.isRequired, PropTypes.shape({
+      /**
+         * ReactNode to render as this component's content
+         */
+      children: PropTypes.node.isRequired,
+      insert: PropTypes.shape({
+        sibling: PropTypes.any.isRequired,
+        position: PropTypes.oneOf(["before", "after"]).isRequired
+      }),
+      portalRef: PropTypes.func
+    }).isRequired]),
 
     /**
          * Whether the component should apply padding on the document body element to afford for its own displacement height.