@atlaskit/navigation-system 2.7.0 → 2.9.0

package/dist/esm/ui/page-layout/side-nav/toggle-button-provider.js

@@ -1,6 +1,6 @@
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import React, { useState } from 'react';
-import { SideNavToggleButtonAttachRef, SideNavToggleButtonElement } from './toggle-button-context';
+import { SideNavToggleButtonAttachRef, SideNavToggleButtonElement, SideNavToggleButtonSlotContext } from './toggle-button-context';
 
 /**
  * Provider for the side nav toggle button contexts.
@@ -26,4 +26,16 @@ export var SideNavToggleButtonProvider = function SideNavToggleButtonProvider(_r
   }, /*#__PURE__*/React.createElement(SideNavToggleButtonAttachRef.Provider, {
     value: setElement
   }, children));
+};
+
+/**
+ * Provider for the side nav toggle button slot.
+ *
+ * This allows us to determine if the toggle button is rendered inside or outside of its slot.
+ */
+export var SideNavToggleButtonSlotProvider = function SideNavToggleButtonSlotProvider(_ref2) {
+  var children = _ref2.children;
+  return /*#__PURE__*/React.createElement(SideNavToggleButtonSlotContext.Provider, {
+    value: true
+  }, children);
 };

package/dist/esm/ui/page-layout/side-nav/toggle-button.compiled.css

@@ -1,2 +1,3 @@
 ._1e0c1bgi{display:contents}
-._lcxvglyw{pointer-events:none}
+._lcxvglyw{pointer-events:none}
+@media (min-width:64rem){._3l1a1wug{margin-inline-start:auto}}

package/dist/esm/ui/page-layout/side-nav/toggle-button.js

@@ -1,4 +1,4 @@
-/* toggle-button.tsx generated by @compiled/babel-plugin v0.38.1 */
+/* toggle-button.tsx generated by @compiled/babel-plugin v0.36.1 */
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import "./toggle-button.compiled.css";
 import { ax, ix } from "@compiled/react/runtime";
@@ -8,7 +8,7 @@ import SidebarCollapseIcon from '@atlaskit/icon/core/sidebar-collapse';
 import SidebarExpandIcon from '@atlaskit/icon/core/sidebar-expand';
 import { fg } from '@atlaskit/platform-feature-flags';
 import { IconButton } from '../../top-nav-items/themed/migration';
-import { SideNavToggleButtonAttachRef } from './toggle-button-context';
+import { SideNavToggleButtonAttachRef, SideNavToggleButtonSlotContext } from './toggle-button-context';
 import { useSideNavVisibility } from './use-side-nav-visibility';
 import { useToggleSideNav } from './use-toggle-side-nav';
 var toggleButtonTooltipOptions = {
@@ -20,6 +20,12 @@ var toggleButtonTooltipOptions = {
 // For duplicate "mouseenter" issue when changing icons (see below)
 var silentIconStyles = null;
 
+/**
+ * Wrapper styles to align the toggle button to the end of `TopNavStart`
+ * when FHS is expanded.
+ */
+var fullHeightSidebarExpandedWrapperStyles = null;
+
 /**
  * __SideNavToggleButton__
  *
@@ -93,7 +99,7 @@ export var SideNavToggleButton = function SideNavToggleButton(_ref) {
       className: ax(["_1e0c1bgi _lcxvglyw"])
     }, isSideNavExpanded ? /*#__PURE__*/React.createElement(SidebarCollapseIcon, props) : /*#__PURE__*/React.createElement(SidebarExpandIcon, props));
   };
-  return /*#__PURE__*/React.createElement(IconButton, {
+  var iconButton = /*#__PURE__*/React.createElement(IconButton, {
     appearance: "subtle",
     label: isSideNavExpanded ? collapseLabel : expandLabel,
     icon: icon,
@@ -104,4 +110,15 @@ export var SideNavToggleButton = function SideNavToggleButton(_ref) {
     ref: fg('platform_fix_component_state_update_for_suspense') ? elementRef : ref,
     tooltip: toggleButtonTooltipOptions
   });
+  var isInsideSlot = useContext(SideNavToggleButtonSlotContext);
+
+  // Checking `isInsideSlot` in case an app isn't using the slot
+  // We don't want to break existing non-slot usage with the left margin
+  // This check can be removed in the future, after slot is required for a while.
+  if (isInsideSlot && fg('navx-full-height-sidebar')) {
+    return /*#__PURE__*/React.createElement("div", {
+      className: ax([isSideNavExpandedOnDesktop && "_3l1a1wug"])
+    }, iconButton);
+  }
+  return iconButton;
 };

package/dist/esm/ui/page-layout/top-nav/top-nav-end.js

@@ -1,4 +1,4 @@
-/* top-nav-end.tsx generated by @compiled/babel-plugin v0.38.1 */
+/* top-nav-end.tsx generated by @compiled/babel-plugin v0.36.1 */
 import _extends from "@babel/runtime/helpers/extends";
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import "./top-nav-end.compiled.css";

package/dist/esm/ui/page-layout/top-nav/top-nav-middle.js

@@ -1,4 +1,4 @@
-/* top-nav-middle.tsx generated by @compiled/babel-plugin v0.38.1 */
+/* top-nav-middle.tsx generated by @compiled/babel-plugin v0.36.1 */
 import "./top-nav-middle.compiled.css";
 import { ax, ix } from "@compiled/react/runtime";
 import React from 'react';

package/dist/esm/ui/page-layout/top-nav/top-nav-start.compiled.css

@@ -5,5 +5,4 @@
 ._4t3i1osq{height:100%}
 ._bozgutpp{padding-inline-start:var(--ds-space-150,9pt)}
 ._lcxv1wug{pointer-events:auto}
-._p12fnau3{max-width:calc(100% - var(--ds-space-200, 1pc))}
-@media (min-width:64rem){._15rin7od{min-width:unset}._glte1ris{width:max-content}._15ri1mjv{min-width:300px}._1gs5usvi{box-sizing:border-box}}
+@media (min-width:64rem){._15rin7od{min-width:unset}._glte1osq{width:100%}._10jxnau3{max-width:calc(100% - var(--ds-space-200, 1pc))}._glte1ris{width:max-content}._15ri1mjv{min-width:300px}._1gs5usvi{box-sizing:border-box}}

package/dist/esm/ui/page-layout/top-nav/top-nav-start.js

@@ -1,16 +1,27 @@
-/* top-nav-start.tsx generated by @compiled/babel-plugin v0.38.1 */
+/* top-nav-start.tsx generated by @compiled/babel-plugin v0.36.1 */
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import "./top-nav-start.compiled.css";
 import { ax, ix } from "@compiled/react/runtime";
-import React, { useContext, useEffect, useRef } from 'react';
+import React, { useContext, useEffect, useLayoutEffect, useRef, useState } from 'react';
 import { fg } from '@atlaskit/platform-feature-flags';
+import { UNSAFE_useMediaQuery } from '@atlaskit/primitives/compiled';
 import { TopNavStartAttachRef } from '../../../context/top-nav-start/top-nav-start-context';
+import { SideNavToggleButtonSlotProvider } from '../side-nav/toggle-button-provider';
 import { useSideNavVisibility } from '../side-nav/use-side-nav-visibility';
 var styles = {
   root: "_zulp1b66 _yyhykb7n _4t3i1osq _4cvr1h6o _1e0c1txw _glte1ris _15ri1mjv _1gs5usvi",
-  fullHeightSidebar: "_p12fnau3 _bozgutpp _lcxv1wug",
-  fullHeightSidebarExpanded: "_15rin7od"
+  fullHeightSidebar: "_bozgutpp _lcxv1wug",
+  fullHeightSidebarExpanded: "_15rin7od _glte1osq _10jxnau3"
 };
 
+/**
+ * The consistent key used for the side nav toggle button to ensure it does not get remounted
+ * when it is reordered.
+ *
+ * This ensures we get focus restoration for free.
+ */
+var sideNavToggleButtonKey = 'side-nav-toggle-button';
+
 /**
  * __TopNavStart__
  *
@@ -18,7 +29,8 @@ var styles = {
  */
 export function TopNavStart(_ref) {
   var children = _ref.children,
-    testId = _ref.testId;
+    testId = _ref.testId,
+    sideNavToggleButton = _ref.sideNavToggleButton;
   var ref = useContext(TopNavStartAttachRef);
   var elementRef = useRef(null);
   useEffect(function () {
@@ -27,14 +39,41 @@ export function TopNavStart(_ref) {
     }
   }, [elementRef, ref]);
 
-  // Need to use `{ defaultCollapsed: true }` otherwise when there is no side nav mounted this never becomes false
+  // This needs the real `defaultCollapsed` state or will not SSR properly
+  // TODO: lift `defaultCollapsed` state to `Root` (DSP-23683)
+  // then context value will be correct in SSR / from initial render
   var _useSideNavVisibility = useSideNavVisibility({
       defaultCollapsed: true
     }),
     isExpandedOnDesktop = _useSideNavVisibility.isExpandedOnDesktop;
+
+  // For SSR assume desktop
+  var _useState = useState(true),
+    _useState2 = _slicedToArray(_useState, 2),
+    isDesktop = _useState2[0],
+    setIsDesktop = _useState2[1];
+  // Set state to real value on client
+  // This could result in some visible shift on mobile when hydrating SSR
+  // TODO: review and improve SSR behavior as necessary (DSP-23817)
+  useLayoutEffect(function () {
+    // Checking this to avoid breaking tests when `matchMedia` is not mocked
+    // Ideally we wouldn't cater to test environments, but this avoids introducing unnecessary friction
+    if (typeof window !== 'undefined' && typeof window.matchMedia === 'function') {
+      setIsDesktop(window.matchMedia('(min-width: 64rem)').matches);
+    }
+  }, []);
+  UNSAFE_useMediaQuery('above.md', function (event) {
+    setIsDesktop(event.matches);
+  });
   return /*#__PURE__*/React.createElement("div", {
     ref: fg('platform_fix_component_state_update_for_suspense') ? elementRef : ref,
     "data-testid": testId,
     className: ax([styles.root, fg('navx-full-height-sidebar') && styles.fullHeightSidebar, isExpandedOnDesktop && fg('navx-full-height-sidebar') && styles.fullHeightSidebarExpanded])
-  }, children);
+  }, !fg('navx-full-height-sidebar') && /*#__PURE__*/React.createElement(SideNavToggleButtonSlotProvider, {
+    key: sideNavToggleButtonKey
+  }, sideNavToggleButton), sideNavToggleButton && (!isDesktop || !isExpandedOnDesktop) && fg('navx-full-height-sidebar') && /*#__PURE__*/React.createElement(SideNavToggleButtonSlotProvider, {
+    key: sideNavToggleButtonKey
+  }, sideNavToggleButton), children, sideNavToggleButton && isDesktop && isExpandedOnDesktop && fg('navx-full-height-sidebar') && /*#__PURE__*/React.createElement(SideNavToggleButtonSlotProvider, {
+    key: sideNavToggleButtonKey
+  }, sideNavToggleButton));
 }

package/dist/esm/ui/page-layout/top-nav/top-nav.js

@@ -1,4 +1,4 @@
-/* top-nav.tsx generated by @compiled/babel-plugin v0.38.1 */
+/* top-nav.tsx generated by @compiled/babel-plugin v0.36.1 */
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
 var _excluded = ["backgroundColor"];
 import "./top-nav.compiled.css";

package/dist/esm/ui/top-nav-items/custom-title.js

@@ -1,4 +1,4 @@
-/* custom-title.tsx generated by @compiled/babel-plugin v0.38.1 */
+/* custom-title.tsx generated by @compiled/babel-plugin v0.36.1 */
 import "./custom-title.compiled.css";
 import * as React from 'react';
 import { ax, ix } from "@compiled/react/runtime";

package/dist/esm/ui/top-nav-items/nav-logo/app-logo.compiled.css

@@ -5,6 +5,7 @@
 ._1e0c1txw{display:flex}
 ._1e0cglyw{display:none}
 ._1o9zidpf{flex-shrink:0}
+._1o9zkb7n{flex-shrink:1}
 ._1reo15vq{overflow-x:hidden}
 ._1toh1r31._1toh1r31{text-decoration-color:currentColor}
 ._1w901kw7._1w901kw7{color:inherit}
@@ -13,6 +14,7 @@
 ._5jyqglyw._5jyqglyw{text-decoration-line:none}
 ._ahbq1b66{margin-inline-start:var(--ds-space-050,4px)}
 ._mrqmnqa1._mrqmnqa1{text-decoration-style:solid}
+._p12f1osq{max-width:100%}
 ._p12f1tcg{max-width:24px}
 ._p12fnklw{max-width:20pc}
 ._uiztglyw{-webkit-user-select:none;-ms-user-select:none;user-select:none}

package/dist/esm/ui/top-nav-items/nav-logo/app-logo.js

@@ -1,8 +1,9 @@
-/* app-logo.tsx generated by @compiled/babel-plugin v0.38.1 */
+/* app-logo.tsx generated by @compiled/babel-plugin v0.36.1 */
 import "./app-logo.compiled.css";
 import { ax, ix } from "@compiled/react/runtime";
 import React, { useCallback, useRef } from 'react';
 import { cx } from '@compiled/react';
+import { fg } from '@atlaskit/platform-feature-flags';
 import { componentWithFG } from '@atlaskit/platform-feature-flags-react';
 import { Anchor as AnchorLegacy, Inline as InlineLegacy, Text as TextLegacy
 // eslint-disable-next-line @atlaskit/design-system/no-emotion-primitives -- to be migrated to @atlaskit/primitives/compiled – go/akcss
@@ -17,13 +18,16 @@ var Text = componentWithFG('jfp-magma-hydration-harmonise-applogo-classname', Te
 var anchorStyles = {
   root: "_2rko19bv _1e0c1txw _4cvr1h6o _4t3izwfg _1o9zidpf _ahbq1b66 _1toh1r31 _5jyqglyw _mrqmnqa1 _1w901kw7",
   interactionStates: "_irr3166n _1di61wwy",
-  interactionStatesCustomTheming: "_irr31rps _1di6yhlj"
+  interactionStatesCustomTheming: "_irr31rps _1di6yhlj",
+  fullHeightSidebar: "_1reo15vq _18m915vq _1o9zkb7n"
 };
 var logoWrapperStyles = {
-  root: "_18zr1b66"
+  root: "_18zr1b66",
+  fullHeightSidebar: "_p12f1osq"
 };
 var iconContainerStyles = {
-  root: "_1reo15vq _18m915vq _1e0c1txw _p12f1tcg"
+  root: "_1reo15vq _18m915vq _1e0c1txw _p12f1tcg",
+  fullHeightSidebar: "_1o9zidpf"
 };
 var logoTextStyles = {
   root: "_1bsb1ris _p12fnklw _uiztglyw _y4tiv77o _1e0cglyw _10y418uv"
@@ -65,14 +69,14 @@ export var AppLogo = function AppLogo(_ref) {
     // @ts-expect-error - non-standard values for `borderRadius` and the custom theming interaction states
     // eslint-disable-next-line @compiled/no-suppress-xcss
     ,
-    xcss: cx(anchorStyles.root, hasCustomTheme ? anchorStyles.interactionStatesCustomTheming : anchorStyles.interactionStates),
+    xcss: cx(anchorStyles.root, hasCustomTheme ? anchorStyles.interactionStatesCustomTheming : anchorStyles.interactionStates, fg('navx-full-height-sidebar') && anchorStyles.fullHeightSidebar),
     onClick: onClick
   }, /*#__PURE__*/React.createElement(Inline, {
     space: "space.075",
     alignBlock: "center",
-    xcss: logoWrapperStyles.root
+    xcss: cx(logoWrapperStyles.root, fg('navx-full-height-sidebar') && logoWrapperStyles.fullHeightSidebar)
   }, /*#__PURE__*/React.createElement("div", {
-    className: ax([iconContainerStyles.root])
+    className: ax([iconContainerStyles.root, fg('navx-full-height-sidebar') && iconContainerStyles.fullHeightSidebar])
   }, /*#__PURE__*/React.createElement(LogoRenderer
   // Top nav always uses the new logo design
   , {

package/dist/esm/ui/top-nav-items/nav-logo/custom-logo.js

@@ -1,4 +1,4 @@
-/* custom-logo.tsx generated by @compiled/babel-plugin v0.38.1 */
+/* custom-logo.tsx generated by @compiled/babel-plugin v0.36.1 */
 import "./custom-logo.compiled.css";
 import { ax, ix } from "@compiled/react/runtime";
 import React, { useEffect, useRef } from 'react';

package/dist/esm/ui/top-nav-items/nav-logo/logo-renderer.js

@@ -1,4 +1,4 @@
-/* logo-renderer.tsx generated by @compiled/babel-plugin v0.38.1 */
+/* logo-renderer.tsx generated by @compiled/babel-plugin v0.36.1 */
 import { ax, ix } from "@compiled/react/runtime";
 import React, { memo } from 'react';
 import { fg } from '@atlaskit/platform-feature-flags';

package/dist/esm/ui/top-nav-items/search.js

@@ -1,4 +1,4 @@
-/* search.tsx generated by @compiled/babel-plugin v0.38.1 */
+/* search.tsx generated by @compiled/babel-plugin v0.36.1 */
 import "./search.compiled.css";
 import { ax, ix } from "@compiled/react/runtime";
 import React, { Fragment } from 'react';

package/dist/esm/ui/top-nav-items/themed/button.compiled.css

@@ -1,4 +1,3 @@
-
 ._11c82smr{font:var(--ds-font-body,normal 400 14px/20px ui-sans-serif,-apple-system,BlinkMacSystemFont,"Segoe UI",Ubuntu,"Helvetica Neue",sans-serif)}
 ._11q71c9b{background:var(--ds-top-bar-button-disabled-background)}
 ._11q71qds{background:var(--ds-top-bar-button-selected-background)}
@@ -33,36 +32,27 @@
 ._syaz1i3i{color:var(--ds-top-bar-button-disabled-text)}
 ._syaz1r31{color:currentColor}
 ._syazw5ct{color:var(--ds-top-bar-button-selected-text)}
-._vwz4idpf{line-height:0}._105315o7:visited{color:var(--ds-top-bar-button-primary-text)}
-._10531i3i:visited{color:var(--ds-top-bar-button-disabled-text)}
-._10531r31:visited{color:currentColor}
-._1053w5ct:visited{color:var(--ds-top-bar-button-selected-text)}
-._1a3b1r31:focus{text-decoration-color:currentColor}
-._4fprglyw:focus{text-decoration-line:none}
-._5goinqa1:focus{text-decoration-style:solid}
-._f8pj15o7:focus{color:var(--ds-top-bar-button-primary-text)}
-._f8pj1i3i:focus{color:var(--ds-top-bar-button-disabled-text)}
-._f8pj1r31:focus{color:currentColor}
-._f8pjw5ct:focus{color:var(--ds-top-bar-button-selected-text)}
+._vwz4idpf{line-height:0}
+._f8pj15o7:focus, ._105315o7:visited{color:var(--ds-top-bar-button-primary-text)}
+._f8pj1i3i:focus, ._10531i3i:visited{color:var(--ds-top-bar-button-disabled-text)}
+._f8pj1r31:focus, ._10531r31:visited{color:currentColor}
+._f8pjw5ct:focus, ._1053w5ct:visited{color:var(--ds-top-bar-button-selected-text)}
 ._19lc1c9b:hover{background:var(--ds-top-bar-button-disabled-background)}
 ._19lc1rps:hover{background:var(--ds-top-bar-button-background-hovered)}
 ._19lcjrv1:hover{background:var(--ds-top-bar-button-selected-background-hovered)}
 ._19lcp6hf:hover{background:var(--ds-top-bar-button-primary-background-hovered)}
-._1bnxglyw:hover{text-decoration-line:none}
 ._30l315o7:hover{color:var(--ds-top-bar-button-primary-text)}
 ._30l31i3i:hover{color:var(--ds-top-bar-button-disabled-text)}
 ._30l31r31:hover{color:currentColor}
 ._30l3w5ct:hover{color:var(--ds-top-bar-button-selected-text)}
-._9oik1r31:hover{text-decoration-color:currentColor}
-._jf4cnqa1:hover{text-decoration-style:solid}
 ._j6xt1c9b:active{background:var(--ds-top-bar-button-disabled-background)}
 ._j6xt5sko:active{background:var(--ds-top-bar-button-primary-background-pressed)}
 ._j6xtnh62:active{background:var(--ds-top-bar-button-selected-background-pressed)}
 ._j6xtqtgh:active{background:var(--ds-top-bar-button-background-pressed)}
-._1iohnqa1:active{text-decoration-style:solid}
-._1nrm1r31:active{text-decoration-color:currentColor}
+._1iohnqa1:active, ._5goinqa1:focus, ._jf4cnqa1:hover{text-decoration-style:solid}
+._1nrm1r31:active, ._1a3b1r31:focus, ._9oik1r31:hover{text-decoration-color:currentColor}
 ._9h8h15o7:active{color:var(--ds-top-bar-button-primary-text)}
 ._9h8h1i3i:active{color:var(--ds-top-bar-button-disabled-text)}
 ._9h8h1r31:active{color:currentColor}
 ._9h8hw5ct:active{color:var(--ds-top-bar-button-selected-text)}
-._c2waglyw:active{text-decoration-line:none}
+._c2waglyw:active, ._4fprglyw:focus, ._1bnxglyw:hover{text-decoration-line:none}

package/dist/esm/ui/top-nav-items/themed/button.js

@@ -1,4 +1,4 @@
-/* button.tsx generated by @compiled/babel-plugin v0.38.1 */
+/* button.tsx generated by @compiled/babel-plugin v0.36.1 */
 import _extends from "@babel/runtime/helpers/extends";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
 var _excluded = ["style", "xcss", "backgroundColor", "padding", "paddingBlock", "paddingBlockStart", "paddingBlockEnd", "paddingInline", "paddingInlineStart", "paddingInlineEnd"],

package/dist/types/ui/page-layout/side-nav/toggle-button-context.d.ts

@@ -14,3 +14,7 @@ export declare const SideNavToggleButtonElement: import("react").Context<HTMLBut
  *  is lazy loaded, which happens in Jira and Confluence), which would prevent the event listeners from being set up.
  */
 export declare const SideNavToggleButtonAttachRef: import("react").Context<(newVal: HTMLButtonElement | null) => void>;
+/**
+ * Used to check if the SideNavToggleButton is rendered inside of its slot in `TopNavStart`.
+ */
+export declare const SideNavToggleButtonSlotContext: import("react").Context<boolean>;

package/dist/types/ui/page-layout/side-nav/toggle-button-provider.d.ts

@@ -15,3 +15,11 @@ import React from 'react';
 export declare const SideNavToggleButtonProvider: ({ children }: {
     children: React.ReactNode;
 }) => React.JSX.Element;
+/**
+ * Provider for the side nav toggle button slot.
+ *
+ * This allows us to determine if the toggle button is rendered inside or outside of its slot.
+ */
+export declare const SideNavToggleButtonSlotProvider: ({ children }: {
+    children: React.ReactNode;
+}) => React.JSX.Element;

package/dist/types/ui/page-layout/top-nav/top-nav-start.d.ts

@@ -8,7 +8,7 @@ import React from 'react';
  *
  * Wrapper for the top navigation actions on the inline-start (left) side of the top navigation.
  */
-export declare function TopNavStart({ children, testId, }: {
+export declare function TopNavStart({ children, testId, sideNavToggleButton, }: {
     /**
      * The content of the layout area.
      *
@@ -19,4 +19,15 @@ export declare function TopNavStart({ children, testId, }: {
      * A unique string that appears as data attribute `data-testid` in the rendered code, serving as a hook for automated tests.
      */
     testId?: string;
+    /**
+     * Slot for the side nav toggle button.
+     *
+     * You should only render `<SideNavToggleButton>` inside this slot, not as a child.
+     *
+     * After `platform_dst_nav4_full_height_sidebar_api_changes` rolls out,
+     * this prop will become required.
+     *
+     * Consumers that do not need a toggle button can explicitly pass `null`.
+     */
+    sideNavToggleButton?: React.ReactNode;
 }): JSX.Element;

package/dist/types-ts4.5/ui/page-layout/side-nav/toggle-button-context.d.ts

@@ -14,3 +14,7 @@ export declare const SideNavToggleButtonElement: import("react").Context<HTMLBut
  *  is lazy loaded, which happens in Jira and Confluence), which would prevent the event listeners from being set up.
  */
 export declare const SideNavToggleButtonAttachRef: import("react").Context<(newVal: HTMLButtonElement | null) => void>;
+/**
+ * Used to check if the SideNavToggleButton is rendered inside of its slot in `TopNavStart`.
+ */
+export declare const SideNavToggleButtonSlotContext: import("react").Context<boolean>;

package/dist/types-ts4.5/ui/page-layout/side-nav/toggle-button-provider.d.ts

@@ -15,3 +15,11 @@ import React from 'react';
 export declare const SideNavToggleButtonProvider: ({ children }: {
     children: React.ReactNode;
 }) => React.JSX.Element;
+/**
+ * Provider for the side nav toggle button slot.
+ *
+ * This allows us to determine if the toggle button is rendered inside or outside of its slot.
+ */
+export declare const SideNavToggleButtonSlotProvider: ({ children }: {
+    children: React.ReactNode;
+}) => React.JSX.Element;

package/dist/types-ts4.5/ui/page-layout/top-nav/top-nav-start.d.ts

@@ -8,7 +8,7 @@ import React from 'react';
  *
  * Wrapper for the top navigation actions on the inline-start (left) side of the top navigation.
  */
-export declare function TopNavStart({ children, testId, }: {
+export declare function TopNavStart({ children, testId, sideNavToggleButton, }: {
     /**
      * The content of the layout area.
      *
@@ -19,4 +19,15 @@ export declare function TopNavStart({ children, testId, }: {
      * A unique string that appears as data attribute `data-testid` in the rendered code, serving as a hook for automated tests.
      */
     testId?: string;
+    /**
+     * Slot for the side nav toggle button.
+     *
+     * You should only render `<SideNavToggleButton>` inside this slot, not as a child.
+     *
+     * After `platform_dst_nav4_full_height_sidebar_api_changes` rolls out,
+     * this prop will become required.
+     *
+     * Consumers that do not need a toggle button can explicitly pass `null`.
+     */
+    sideNavToggleButton?: React.ReactNode;
 }): JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/navigation-system",
-	"version": "2.7.0",
+	"version": "2.9.0",
 	"description": "The latest navigation system for Atlassian apps.",
 	"repository": "https://bitbucket.org/atlassian/atlassian-frontend-mirror",
 	"author": "Atlassian Pty Ltd",
@@ -76,7 +76,7 @@
 		"@atlaskit/logo": "^19.7.0",
 		"@atlaskit/platform-feature-flags": "^1.1.0",
 		"@atlaskit/platform-feature-flags-react": "^0.3.0",
-		"@atlaskit/popup": "^4.3.0",
+		"@atlaskit/popup": "^4.4.0",
 		"@atlaskit/pragmatic-drag-and-drop": "^1.7.0",
 		"@atlaskit/pragmatic-drag-and-drop-hitbox": "^1.1.0",
 		"@atlaskit/pragmatic-drag-and-drop-react-drop-indicator": "^3.2.0",
@@ -162,9 +162,6 @@
 		"platform_fix_component_state_update_for_suspense": {
 			"type": "boolean"
 		},
-		"platform_design_system_nav4_panel_mobile_width_fix": {
-			"type": "boolean"
-		},
 		"jiv-20710-fix-nav-rerender": {
 			"type": "boolean"
 		},
@@ -186,6 +183,9 @@
 		"navx-full-height-sidebar": {
 			"type": "boolean"
 		},
+		"platform_dst_nav4_full_height_sidebar_api_changes": {
+			"type": "boolean"
+		},
 		"platform_dst_nav4_menu_section_heading_a11y": {
 			"type": "boolean"
 		},