@atlaskit/navigation-system 11.3.3 → 11.4.0

package/dist/es2019/ui/page-layout/local-panel-surface.js

@@ -0,0 +1,193 @@
+/* local-panel-surface.tsx generated by @compiled/babel-plugin v3.0.2 */
+import "./local-panel-surface.compiled.css";
+import * as React from 'react';
+import { ax, ix } from "@compiled/react/runtime";
+import { useCallback, useContext, useMemo, useRef } from 'react';
+import mergeRefs from '@atlaskit/ds-lib/merge-refs';
+import { useLayoutEffect } from '@atlaskit/ds-lib/use-layout-effect';
+import useStableRef from '@atlaskit/ds-lib/use-stable-ref';
+import { useMotion } from '@atlaskit/motion/entering/use-motion';
+import ExitingPersistence from '@atlaskit/motion/exiting-persistence';
+import { fg } from '@atlaskit/platform-feature-flags/fg';
+import { localPanelWidthVar } from './constants';
+import { DangerouslyHoistSlotSizes } from './hoist-slot-sizes-context';
+import { PanelSplitter } from './panel-splitter/panel-splitter';
+import { PanelSplitterProvider } from './panel-splitter/provider';
+const localPanelVar = '--p_lclPnlW';
+const panelSplitterResizingVar = '--p_lclPnlRsz';
+const localPanelSplitterId = Symbol('LocalPanel PanelSplitter');
+
+// Compiled preserves the existing container-relative widths and discrete motion styles.
+/* eslint-disable @compiled/shorthand-property-sorting -- Content motion overrides only the animation delay. */
+const styles = {
+  panelWrapper: "_nd5l1gzg _kqsw1if8 _bfhk1bhr _vchhusvi _4t3ieqxy _152tidpf _10fph9n0 _1bsb13q4",
+  managedInline: "_nd5l1c6w _bfhkvuon _152tidpf _1bsb1c5w",
+  unmeasured: "_nd5l32aw _191wbqna _1bsb1cku _bfhk1g1j _16qs1dhr",
+  managedOverlay: "_nd5l1gzg _bfhk1bhr _1bsb1c5w",
+  panelScrollContainer: "_1reo1wug _18m91wug _4t3i1osq",
+  border: "_191wglyw _16qs130s",
+  managedInlineBorder: "_191wia51 _16qsglyw",
+  entering: "_k1af1nn1 _10t81ia4 _xrrp147i _1wsa1ign _1vrh1a5r _1kmh1n9t _105abamb",
+  exiting: "_k1af14vv _bq641n9t _105aeydr",
+  contentEntering: "_y44v1mph",
+  contentExiting: "_y44vf1qi",
+  contentChangeContainer: "_4t3i1osq"
+};
+const contentEnteringDelayStyles = {
+  root: "_ju25dn4k"
+};
+/* eslint-enable @compiled/shorthand-property-sorting */
+
+const PanelContentMotion = ({
+  children
+}) => {
+  const {
+    state,
+    ref
+  } = useMotion();
+  return /*#__PURE__*/React.createElement("div", {
+    ref: ref,
+    className: ax([styles.contentChangeContainer, state === 'entering' && styles.contentEntering, state === 'exiting' && styles.contentExiting])
+  }, children);
+};
+/**
+ * Internal surface for PanelLayout. The host supplies content; navigation owns its geometry.
+ */
+export function LocalPanelSurface({
+  children,
+  contentKey,
+  label,
+  resizeLabel,
+  defaultWidth,
+  minWidth,
+  maxWidth,
+  testId,
+  layoutRef,
+  managedSizing,
+  getManagedResizeBounds,
+  prepareResize,
+  onManagedResizeStart,
+  onManagedResize,
+  onManagedResizeEnd,
+  onWidthChange,
+  onResizeEnd
+}) {
+  var _managedSizing$mode, _managedSizing$width;
+  const ref = useRef(null);
+  const dangerouslyHoistSlotSizes = useContext(DangerouslyHoistSlotSizes);
+  useLayoutEffect(() => {
+    const panel = ref.current;
+    if (!dangerouslyHoistSlotSizes || !panel) {
+      return;
+    }
+    // Container-relative CSS owns the initial width, before the sizing runtime loads.
+    // Publish geometry directly for external controls; never feed it into saved preferences.
+    let previousWidth;
+    const publishWidth = width => {
+      if (width !== previousWidth) {
+        previousWidth = width;
+        panel.ownerDocument.documentElement.style.setProperty(localPanelWidthVar, `${width}px`);
+      }
+    };
+    publishWidth(panel.getBoundingClientRect().width);
+    const observer = new ResizeObserver(([entry]) => {
+      var _entry$borderBoxSize$, _entry$borderBoxSize, _entry$borderBoxSize$2;
+      publishWidth((_entry$borderBoxSize$ = (_entry$borderBoxSize = entry.borderBoxSize) === null || _entry$borderBoxSize === void 0 ? void 0 : (_entry$borderBoxSize$2 = _entry$borderBoxSize[0]) === null || _entry$borderBoxSize$2 === void 0 ? void 0 : _entry$borderBoxSize$2.inlineSize) !== null && _entry$borderBoxSize$ !== void 0 ? _entry$borderBoxSize$ : panel.getBoundingClientRect().width);
+    });
+    observer.observe(panel, {
+      box: 'border-box'
+    });
+    return () => {
+      observer.disconnect();
+      panel.ownerDocument.documentElement.style.removeProperty(localPanelWidthVar);
+    };
+  }, [dangerouslyHoistSlotSizes]);
+  const scrollRef = useRef(null);
+  useLayoutEffect(() => {
+    if (scrollRef.current) {
+      scrollRef.current.scrollTop = 0;
+    }
+  }, [contentKey]);
+  const {
+    state,
+    ref: motionRef
+  } = useMotion();
+  const isMotionUpliftEnabled = fg('platform-dst-motion-uplift-panel');
+  const isContentMotionEnabled = fg('platform-dst-motion-uplift-panel-content');
+  const mergedRef = useMemo(() => isMotionUpliftEnabled ? mergeRefs([ref, motionRef]) : ref, [isMotionUpliftEnabled, motionRef]);
+  const mode = (_managedSizing$mode = managedSizing === null || managedSizing === void 0 ? void 0 : managedSizing.mode) !== null && _managedSizing$mode !== void 0 ? _managedSizing$mode : 'overlay';
+  const managedMode = useStableRef(managedSizing === null || managedSizing === void 0 ? void 0 : managedSizing.mode);
+  // Resize preparation can load the coordinator after the interaction starts.
+  // Read its latest mode instead of the pre-load callback's captured fallback.
+  const getMode = useCallback(() => {
+    if (managedMode.current) {
+      return managedMode.current;
+    }
+    return ref.current && getComputedStyle(ref.current).gridArea.split('/')[0].trim() === 'panel' ? 'inline' : 'overlay';
+  }, [managedMode]);
+  const dragMode = useRef('overlay');
+  const completedResizeModeRef = useRef(mode);
+  const renderedWidth = (_managedSizing$width = managedSizing === null || managedSizing === void 0 ? void 0 : managedSizing.width) !== null && _managedSizing$width !== void 0 ? _managedSizing$width : Math.max(minWidth, Math.min(defaultWidth, maxWidth !== null && maxWidth !== void 0 ? maxWidth : Infinity));
+  // Before the first measurement, CSS caps the surface to its containing region.
+  // Resize preparation waits for the coordinator to resolve the same bounds for both inputs.
+  const getResizeBounds = useCallback(() => {
+    var _getManagedResizeBoun;
+    return (_getManagedResizeBoun = getManagedResizeBounds()) !== null && _getManagedResizeBoun !== void 0 ? _getManagedResizeBoun : {
+      min: '0px',
+      max: '0px'
+    };
+  }, [getManagedResizeBounds]);
+  const onCompleteResize = useCallback(width => {
+    // Keyboard analytics are debounced; retain the mode that produced this width,
+    // rather than the layout mode when the delayed callback eventually runs.
+    const mode = getMode();
+    completedResizeModeRef.current = mode;
+    onManagedResizeEnd(mode, width);
+    onWidthChange(width);
+  }, [getMode, onManagedResizeEnd, onWidthChange]);
+  const onResizeStartInternal = useCallback(() => {
+    dragMode.current = getMode();
+    onManagedResizeStart(dragMode.current);
+  }, [getMode, onManagedResizeStart]);
+  const onResizeInternal = useCallback(width => onManagedResize(dragMode.current, width), [onManagedResize]);
+  const handleResizeEnd = useCallback(event => onResizeEnd({
+    ...event,
+    mode: completedResizeModeRef.current
+  }), [onResizeEnd]);
+  return /*#__PURE__*/React.createElement("section", {
+    "aria-label": label,
+    "data-testid": testId,
+    "data-layout-with-panel-slot": "",
+    style: {
+      // eslint-disable-next-line @atlaskit/ui-styling-standard/enforce-style-prop, @atlaskit/ui-styling-standard/no-imported-style-values
+      [localPanelVar]: `${renderedWidth}px`
+    },
+    ref: mergedRef,
+    className: ax([isMotionUpliftEnabled && state === 'entering' && styles.entering, isMotionUpliftEnabled && state === 'exiting' && styles.exiting, styles.panelWrapper, styles.border, !managedSizing && styles.unmeasured, (managedSizing === null || managedSizing === void 0 ? void 0 : managedSizing.mode) === 'inline' && styles.managedInline, (managedSizing === null || managedSizing === void 0 ? void 0 : managedSizing.mode) === 'overlay' && styles.managedOverlay, (managedSizing === null || managedSizing === void 0 ? void 0 : managedSizing.mode) === 'inline' && styles.managedInlineBorder])
+  }, /*#__PURE__*/React.createElement(PanelSplitterProvider, {
+    panelId: localPanelSplitterId,
+    panelRef: ref,
+    resizingElementRef: layoutRef,
+    panelWidth: renderedWidth,
+    onCompleteResize: onCompleteResize,
+    prepareResize: prepareResize,
+    onResizeStartInternal: onResizeStartInternal,
+    onResizeInternal: onResizeInternal,
+    getResizeBounds: getResizeBounds,
+    isEnabled: managedSizing !== undefined || prepareResize !== undefined,
+    resizingCssVar: panelSplitterResizingVar,
+    position: "start"
+  }, /*#__PURE__*/React.createElement("div", {
+    ref: scrollRef,
+    "data-testid": testId && `${testId}--scroll-container`,
+    className: ax([styles.panelScrollContainer, state === 'entering' && styles.contentEntering, isMotionUpliftEnabled && state === 'entering' && contentEnteringDelayStyles.root, state === 'exiting' && styles.contentExiting])
+  }, isContentMotionEnabled && contentKey !== undefined ? /*#__PURE__*/React.createElement(ExitingPersistence, {
+    exitThenEnter: true
+  }, /*#__PURE__*/React.createElement(PanelContentMotion, {
+    key: contentKey
+  }, children)) : children, /*#__PURE__*/React.createElement(PanelSplitter, {
+    label: resizeLabel,
+    testId: testId && `${testId}--splitter`,
+    onResizeEnd: handleResizeEnd
+  }))));
+}

package/dist/es2019/ui/page-layout/main/main.js

@@ -5,7 +5,8 @@ import { ax, ix } from "@compiled/react/runtime";
 import { Fragment } from 'react';
 import { fg } from '@atlaskit/platform-feature-flags/fg';
 import { useSkipLink } from '../../../context/skip-links/use-skip-link';
-import { mainMinimumWidthVar } from '../constants';
+import { defaultMainMinWidth, mainMinimumWidthVar } from '../constants';
+import { MainMinWidthContext } from '../main-min-width-context';
 import { gridRootFitId, gridRootId } from '../root';
 import { useLayoutId } from '../use-layout-id';
 import { useLayoutMainSizing } from '../use-layout-main-sizing';
@@ -24,7 +25,7 @@ export function Main({
   skipLinkLabel = fg('platform_dst_nav4_skip_link_a11y_1') ? 'Main content' : 'Main Content',
   testId,
   id: providedId,
-  minWidth = 320
+  minWidth = defaultMainMinWidth
 }) {
   const id = useLayoutId({
     providedId
@@ -40,5 +41,7 @@ export function Main({
     className: ax([mainElementStyles.root, xcss]),
     role: "main",
     "data-testid": testId
-  }, children));
+  }, /*#__PURE__*/React.createElement(MainMinWidthContext.Provider, {
+    value: fg('platform-dst-chat-panel-layout') ? minWidth : defaultMainMinWidth
+  }, children)));
 }

package/dist/es2019/ui/page-layout/main-min-width-context.js

@@ -0,0 +1,5 @@
+import { createContext } from 'react';
+import { defaultMainMinWidth } from './constants';
+
+// Available during SSR, before Main registers with the measured sizing coordinator.
+export const MainMinWidthContext = /*#__PURE__*/createContext(defaultMainMinWidth);

package/dist/es2019/ui/page-layout/panel-layout-shell.compiled.css

@@ -0,0 +1,27 @@
+._nd5l1gzg{grid-area:main}._129o1uuk{--p_lclPnlSsrPreferredW:var(--p_lclPnlCompactW)}
+._18m915vq{overflow-y:hidden}
+._18m91wug{overflow-y:auto}
+._19121cl4{isolation:isolate}
+._1bsb1osq{width:100%}
+._1e0c11p5{display:grid}
+._1e0c1txw{display:flex}
+._1f38177r{container-name:local-panel-layout}
+._1l7c1wug._1l7c1wug{grid-template-rows:auto}
+._1l7chkll._1l7chkll{grid-template-rows:1fr}
+._1lmc1m6a{grid-template-areas:"main"}
+._1lmcc53r{grid-template-areas:var(--p_lclPnlSsrAreas,"main")}
+._1reo15vq{overflow-x:hidden}
+._1reo1wug{overflow-x:auto}
+._1uwq15vq._1uwq15vq{overflow-x:hidden}
+._2z05hkll{grid-template-rows:1fr}
+._4t3i1osq{height:100%}
+._7cca15wb{container-type:inline-size}
+._82e815vq._82e815vq{overflow-y:hidden}
+._evra4a59{--p_lclPnlSsrInlineAreas:"main panel"}
+._f8371m6a._f8371m6a{grid-template-areas:"main"}
+._f8374a59._f8374a59{grid-template-areas:"main panel"}
+._vleg1orf._vleg1orf{grid-template-columns:minmax(var(--n_mainMinW,20pc),1fr) clamp(var(--p_lclPnlMinW),var(--p_lclPnlRsz,var(--p_lclPnlTrackW)),calc(100% - var(--n_mainMinW, 20pc)))}
+._vlegi47z._vlegi47z{grid-template-columns:minmax(0,1fr)}
+._yv0eggl6{grid-template-columns:var(--p_lclPnlSsrColumns,minmax(0,1fr))}
+._yv0ei47z{grid-template-columns:minmax(0,1fr)}
+@media (min-width:64rem){._peezi77x{--p_lclPnlSsrPreferredW:var(--p_lclPnlTrackW)}}

package/dist/es2019/ui/page-layout/panel-layout-shell.js

@@ -0,0 +1,74 @@
+/* panel-layout-shell.tsx generated by @compiled/babel-plugin v3.0.2 */
+import "./panel-layout-shell.compiled.css";
+import * as React from 'react';
+import { ax, ix } from "@compiled/react/runtime";
+import { useContext, useId } from 'react';
+import { MainMinWidthContext } from './main-min-width-context';
+
+// The grid uses runtime CSS variables and container sizing outside @atlaskit/css's bounded values.
+const localPanelTrackWidthVar = '--p_lclPnlTrackW';
+const localPanelResizingVar = '--p_lclPnlRsz';
+const localPanelMinWidthVar = '--p_lclPnlMinW';
+const styles = {
+  container: "_1f38177r _7cca15wb _4t3i1osq _1bsb1osq",
+  layout: "_1reo1wug _18m91wug _1e0c11p5 _7cca15wb _1lmc1m6a _yv0ei47z _2z05hkll _4t3i1osq _1bsb1osq",
+  mainContent: "_nd5l1gzg _1reo1wug _18m91wug _1e0c1txw _4t3i1osq _19121cl4",
+  panelUplift: "_1reo15vq _18m915vq",
+  unmeasured: "_evra4a59 _1lmcc53r _yv0eggl6 _129o1uuk _peezi77x",
+  managedInline: "_1uwq15vq _82e815vq _f8374a59 _1l7c1wug _vleg1orf",
+  managedOverlay: "_1uwq15vq _82e815vq _f8371m6a _vlegi47z _1l7chkll",
+  panelClosed: "_f8371m6a _vlegi47z _1l7chkll"
+};
+/**
+ * Grid and scrolling for Main and its local panel. Use inside navigation's Root and Main.
+ */
+export function PanelLayoutShell({
+  children,
+  panel,
+  isPanelOpen,
+  panelWidth,
+  compactPanelWidth,
+  panelMinWidth = 320,
+  mode,
+  layoutRef,
+  shouldClipOverflow = false,
+  testId
+}) {
+  const mainMinWidth = useContext(MainMinWidthContext);
+  const id = `local-panel-${useId().replace(/[^a-zA-Z0-9_-]/g, '_')}`;
+  // CSS query conditions cannot read custom properties. Only the numeric minimums and
+  // instance selector are generated here; this rule is removed after the first measurement,
+  // so live resizing never rewrites stylesheet text. The named container is local to this shell.
+  const inlineQuery = `@container local-panel-layout (min-width: ${mainMinWidth + panelMinWidth}px)`;
+  return /*#__PURE__*/React.createElement("div", {
+    className: ax([styles.container])
+  }, mode === undefined && isPanelOpen &&
+  /*#__PURE__*/
+  // eslint-disable-next-line @atlaskit/ui-styling-standard/no-global-styles -- Instance-scoped SSR query supports caller-defined minimums; CSS variables are not allowed in query conditions.
+  React.createElement("style", null, `${inlineQuery} {
+					#${id} {
+						--p_lclPnlSsrAreas: var(--p_lclPnlSsrInlineAreas);
+						--p_lclPnlSsrColumns: minmax(0, 1fr) min(var(--p_lclPnlSsrPreferredW), calc(100% - ${mainMinWidth}px));
+						--p_lclPnlSsrArea: panel;
+						--p_lclPnlSsrWidth: 100%;
+						--p_lclPnlSsrBackground: ${"var(--ds-surface, #FFFFFF)"};
+						--p_lclPnlSsrShadow: none;
+						--p_lclPnlSsrBorder: ${"var(--ds-border-width, 1px)"} solid ${"var(--ds-border, #0B120E24)"};
+					}
+				}`), /*#__PURE__*/React.createElement("div", {
+    id: id,
+    "data-testid": testId,
+    ref: layoutRef,
+    style: {
+      // These runtime track widths are shared with the panel splitter.
+      // eslint-disable-next-line @atlaskit/ui-styling-standard/enforce-style-prop, @atlaskit/ui-styling-standard/no-unsafe-values
+      [localPanelTrackWidthVar]: `${panelWidth}px`,
+      // eslint-disable-next-line @atlaskit/ui-styling-standard/enforce-style-prop, @atlaskit/ui-styling-standard/no-unsafe-values
+      [localPanelMinWidthVar]: `${panelMinWidth}px`,
+      '--p_lclPnlCompactW': `${compactPanelWidth}px`
+    },
+    className: ax([styles.layout, mode === undefined && isPanelOpen && styles.unmeasured, shouldClipOverflow && styles.panelUplift, mode === 'inline' && styles.managedInline, mode === 'overlay' && styles.managedOverlay, !isPanelOpen && styles.panelClosed])
+  }, /*#__PURE__*/React.createElement("div", {
+    className: ax([styles.mainContent])
+  }, children), panel));
+}

package/dist/es2019/ui/page-layout/panel-layout.js

@@ -0,0 +1,147 @@
+import React, { useCallback, useContext, useEffect, useRef, useState } from 'react';
+import invariant from 'tiny-invariant';
+import useStableRef from '@atlaskit/ds-lib/use-stable-ref';
+import ExitingPersistence from '@atlaskit/motion/exiting-persistence';
+import { fg } from '@atlaskit/platform-feature-flags/fg';
+import { getPanelLayoutDefaults } from './get-panel-layout-defaults';
+import { LayoutAreaSizingContext } from './layout-area-sizing-context';
+import { LayoutAreaSizingProvider } from './layout-area-sizing-provider';
+import { LocalPanelSurface } from './local-panel-surface';
+import { PanelLayoutShell } from './panel-layout-shell';
+import { useLayoutAreaSizing } from './use-layout-area-sizing';
+
+// Development-only ownership checks are scoped to each coordinator, not the whole page.
+const mountedPanelLayouts = new WeakSet();
+function CoordinatedPanelLayout({
+  children,
+  panel,
+  isPanelOpen,
+  panelKey,
+  panelWidth,
+  defaultPanelWidth,
+  compactDefaultPanelWidth,
+  panelMinWidth: suppliedMinWidth,
+  panelMaxWidth,
+  onPanelWidthChange,
+  onResizeEnd,
+  panelLabel = 'Panel',
+  resizeLabel = 'Resize panel',
+  testId,
+  layoutRef
+}) {
+  var _ref, _ref2, _ref3, _state$width;
+  const [defaults] = useState(getPanelLayoutDefaults);
+  const panelMinWidth = suppliedMinWidth !== null && suppliedMinWidth !== void 0 ? suppliedMinWidth : defaults.panelMinWidth;
+  const coordinator = useContext(LayoutAreaSizingContext);
+  useEffect(() => {
+    if (process.env.NODE_ENV !== 'production' && coordinator) {
+      invariant(!mountedPanelLayouts.has(coordinator), 'Only one PanelLayout may be mounted per navigation Root/sizing coordinator, including closed hosts and LayoutWithPanel. Reuse the host to switch panel content.');
+      mountedPanelLayouts.add(coordinator);
+      return () => {
+        mountedPanelLayouts.delete(coordinator);
+      };
+    }
+  }, [coordinator]);
+  const [defaultWidth] = useState((_ref = defaultPanelWidth !== null && defaultPanelWidth !== void 0 ? defaultPanelWidth : panelWidth) !== null && _ref !== void 0 ? _ref : defaults.panelWidth);
+  const [compactWidth] = useState((_ref2 = (_ref3 = compactDefaultPanelWidth !== null && compactDefaultPanelWidth !== void 0 ? compactDefaultPanelWidth : defaultPanelWidth) !== null && _ref3 !== void 0 ? _ref3 : panelWidth) !== null && _ref2 !== void 0 ? _ref2 : defaults.compactPanelWidth);
+  // Use the controlled request before measurement too, without changing the mount-time default.
+  const fallbackWidth = Math.max(panelMinWidth, Math.min(panelWidth !== null && panelWidth !== void 0 ? panelWidth : defaultWidth, panelMaxWidth !== null && panelMaxWidth !== void 0 ? panelMaxWidth : Infinity));
+  const {
+    state,
+    prepareResize,
+    getResizeBounds,
+    startResize,
+    resize,
+    completeResize
+  } = useLayoutAreaSizing({
+    area: 'panel',
+    config: {
+      isOpen: isPanelOpen,
+      requestedWidth: panelWidth,
+      defaultWidth,
+      compactDefaultWidth: compactWidth,
+      minWidth: panelMinWidth,
+      maxWidth: panelMaxWidth
+    }
+  });
+  // Host callback identity is unrelated to sizing. Keep drag bindings stable while
+  // still delivering completions to the latest product-owned state and analytics.
+  const onWidthChangeRef = useStableRef(onPanelWidthChange);
+  const onResizeEndRef = useStableRef(onResizeEnd);
+  const handleWidthChange = useCallback(width => {
+    var _onWidthChangeRef$cur;
+    return (_onWidthChangeRef$cur = onWidthChangeRef.current) === null || _onWidthChangeRef$cur === void 0 ? void 0 : _onWidthChangeRef$cur.call(onWidthChangeRef, width);
+  }, [onWidthChangeRef]);
+  const handleResizeEnd = useCallback(event => {
+    var _onResizeEndRef$curre;
+    return (_onResizeEndRef$curre = onResizeEndRef.current) === null || _onResizeEndRef$curre === void 0 ? void 0 : _onResizeEndRef$curre.call(onResizeEndRef, event);
+  }, [onResizeEndRef]);
+  const isMotionEnabled = fg('platform-dst-motion-uplift-panel');
+  const surface = isPanelOpen && /*#__PURE__*/React.createElement(LocalPanelSurface, {
+    key: "local-panel",
+    contentKey: panelKey,
+    defaultWidth: fallbackWidth,
+    minWidth: panelMinWidth,
+    maxWidth: panelMaxWidth,
+    layoutRef: layoutRef,
+    managedSizing: state,
+    getManagedResizeBounds: getResizeBounds,
+    prepareResize: prepareResize,
+    onManagedResizeStart: startResize,
+    onManagedResize: resize,
+    onManagedResizeEnd: completeResize,
+    onWidthChange: handleWidthChange,
+    onResizeEnd: handleResizeEnd,
+    label: panelLabel,
+    resizeLabel: resizeLabel,
+    testId: testId && `${testId}--panel-slot`
+  }, panel);
+  return /*#__PURE__*/React.createElement(PanelLayoutShell, {
+    isPanelOpen: isPanelOpen,
+    panelWidth: (_state$width = state === null || state === void 0 ? void 0 : state.width) !== null && _state$width !== void 0 ? _state$width : fallbackWidth,
+    compactPanelWidth: Math.max(panelMinWidth, Math.min(panelWidth !== null && panelWidth !== void 0 ? panelWidth : compactWidth, panelMaxWidth !== null && panelMaxWidth !== void 0 ? panelMaxWidth : Infinity)),
+    panelMinWidth: panelMinWidth,
+    mode: state === null || state === void 0 ? void 0 : state.mode,
+    layoutRef: layoutRef,
+    shouldClipOverflow: isMotionEnabled,
+    testId: testId,
+    panel: isMotionEnabled ? /*#__PURE__*/React.createElement(ExitingPersistence, null, surface) : surface
+  }, children);
+}
+
+/**
+ * A coordinated local panel with caller-owned content and state. Keep this host mounted
+ * while closed to retain resized widths. Unmount it to reset its width preferences.
+ *
+ * Mount only one local-panel host per navigation Root/sizing coordinator, including
+ * closed hosts and panel-system's LayoutWithPanel. Switch content through the same host;
+ * separate Roots may each own a local panel.
+ *
+ * With chat layout enabled it shares Root's sizing coordinator. Otherwise it measures
+ * its own Main region, leaving existing navigation/chat behavior unchanged.
+ * Local-panel placement and resize constraints use this layout in both cases; disabling
+ * the chat-layout gate does not restore the previous panel-system layout engine.
+ */
+export function PanelLayout(props) {
+  const parentSizing = useContext(LayoutAreaSizingContext);
+  const layoutRef = useRef(null);
+  const content = /*#__PURE__*/React.createElement(CoordinatedPanelLayout, {
+    layoutRef: layoutRef,
+    panel: props.panel,
+    isPanelOpen: props.isPanelOpen,
+    panelKey: props.panelKey,
+    panelWidth: props.panelWidth,
+    defaultPanelWidth: props.defaultPanelWidth,
+    compactDefaultPanelWidth: props.compactDefaultPanelWidth,
+    panelMinWidth: props.panelMinWidth,
+    panelMaxWidth: props.panelMaxWidth,
+    onPanelWidthChange: props.onPanelWidthChange,
+    onResizeEnd: props.onResizeEnd,
+    panelLabel: props.panelLabel,
+    resizeLabel: props.resizeLabel,
+    testId: props.testId
+  }, props.children);
+  return parentSizing ? content : /*#__PURE__*/React.createElement(LayoutAreaSizingProvider, {
+    layoutRef: layoutRef
+  }, content);
+}

package/dist/es2019/ui/page-layout/panel-splitter/panel-splitter.js

@@ -18,6 +18,7 @@ import { disableNativeDragPreview } from '@atlaskit/pragmatic-drag-and-drop/util
 import { preventUnhandled } from '@atlaskit/pragmatic-drag-and-drop/utils/prevent-unhandled';
 import Tooltip from '@atlaskit/tooltip/Tooltip';
 import TooltipContainer from '@atlaskit/tooltip/TooltipContainer';
+import { requestClosePopovers } from '@atlaskit/top-layer/page-surface/request-close-popovers';
 import VisuallyHidden from '@atlaskit/visually-hidden/visually-hidden';
 import { contentInsetBlockStart } from '../constants';
 import { convertResizeBoundToPixels } from './convert-resize-bound-to-pixels';
@@ -159,7 +160,9 @@ const PortaledPanelSplitter = ({
     min: 200,
     max: 500
   });
-  const openLayerObserver = useOpenLayerObserver();
+  const openLayerObserver = useOpenLayerObserver({
+    isEnabled: !fg('platform-dst-top-layer')
+  });
 
   /**
    * This is a temporary workaround to enable the `SideNavPanelSplitter` component
@@ -173,7 +176,7 @@ const PortaledPanelSplitter = ({
   const initialClientXRef = useRef(null);
   // Live allocation changes panelWidth on every frame. Only the legacy path should
   // rebind the drag listeners when this value changes.
-  const legacyPanelWidth = fg('platform-dst-chat-panel-layout') ? undefined : panelWidth;
+  const legacyPanelWidth = fg('platform-dst-chat-panel-layout') || onResizeInternal ? undefined : panelWidth;
   useEffect(() => {
     const splitter = splitterRef.current;
     invariant(splitter, 'Splitter ref must be set');
@@ -250,6 +253,8 @@ const PortaledPanelSplitter = ({
         onResizeStart === null || onResizeStart === void 0 ? void 0 : onResizeStart(resizeStartData);
 
         // Close any open layers when the user starts resizing
+        // Not gated. Top-layer tooltips (`platform-dst-top-layer-tooltip`) are not known to the observer.
+        requestClosePopovers();
         openLayerObserver === null || openLayerObserver === void 0 ? void 0 : openLayerObserver.closeLayers();
       },
       onDrag({
@@ -282,7 +287,7 @@ const PortaledPanelSplitter = ({
           position
         });
         const resizingWidth = `clamp(${resizeBounds.min}, ${targetWidth}px, ${resizeBounds.max})`;
-        if (fg('platform-dst-chat-panel-layout') && onResizeInternal) {
+        if (onResizeInternal) {
           // The allocator needs below-minimum requests for the local-to-chat cascade.
           const currentBounds = getResizeBounds();
           const width = Math.max(0, Math.min(targetWidth, prepareResize ? window.innerWidth : convertResizeBoundToPixels(currentBounds.max)));
@@ -319,7 +324,7 @@ const PortaledPanelSplitter = ({
         const finalWidth = getPixelWidth(panel);
         // Persist the final preferred width before removing the imperative drag
         // variable, so the rendered width is continuous across pointer release.
-        if (fg('platform-dst-chat-panel-layout')) {
+        if (fg('platform-dst-chat-panel-layout') || onResizeInternal) {
           flushSync(() => onCompleteResize(finalWidth));
         } else {
           onCompleteResize(finalWidth);
@@ -339,6 +344,8 @@ const PortaledPanelSplitter = ({
     onResizeStart: (...args) => {
       var _onResizeStartStableR;
       // Close any open layers when the user starts resizing with keyboard
+      // Not gated. Top-layer tooltips (`platform-dst-top-layer-tooltip`) are not known to the observer.
+      requestClosePopovers();
       openLayerObserver === null || openLayerObserver === void 0 ? void 0 : openLayerObserver.closeLayers();
       (_onResizeStartStableR = onResizeStartStableRef.current) === null || _onResizeStartStableR === void 0 ? void 0 : _onResizeStartStableR.call(onResizeStartStableRef, ...args);
     },
@@ -351,7 +358,7 @@ const PortaledPanelSplitter = ({
   const keyboardBoundsReady = useRef(false);
   const pendingKeyboardWidth = useRef(null);
   const handleSliderInputChange = useCallback(async (event, pendingKey) => {
-    const isManagedResize = fg('platform-dst-chat-panel-layout') && onResizeInternal;
+    const isManagedResize = onResizeInternal;
     const sequence = focusSequence.current;
     let value = isManagedResize ? parseFloat(event.currentTarget.value) : parseInt(event.currentTarget.value);
     if (prepareResize) {

package/dist/es2019/ui/page-layout/root.js

@@ -67,6 +67,8 @@ export function Root({
   const isChatPanelLayoutEnabled = fg('platform-dst-chat-panel-layout');
   const LayoutProvider = isChatPanelLayoutEnabled ? LayoutAreaSizingProvider : React.Fragment;
   const WidthContainer = isChatPanelLayoutEnabled ? LayoutFitContainers : React.Fragment;
+  // Top-layer surfaces are found through the DOM, so the observer is only needed when the gate is off.
+  const LayerObserverProvider = fg('platform-dst-top-layer') ? React.Fragment : OpenLayerObserver;
   useEffect(() => {
     if (process.env.NODE_ENV !== 'production') {
       const IGNORED_ELEMENTS = ['SCRIPT', 'STYLE'];
@@ -98,7 +100,7 @@ This message will not be displayed in production.
     isSideNavShortcutEnabled: isSideNavShortcutEnabled
   }, /*#__PURE__*/React.createElement(TopNavStartProvider, null, /*#__PURE__*/React.createElement(LayoutProvider, isChatPanelLayoutEnabled ? {
     layoutRef: ref
-  } : {}, /*#__PURE__*/React.createElement(OpenLayerObserver, null, /*#__PURE__*/React.createElement(DangerouslyHoistSlotSizes.Provider, {
+  } : {}, /*#__PURE__*/React.createElement(LayerObserverProvider, null, /*#__PURE__*/React.createElement(DangerouslyHoistSlotSizes.Provider, {
     value: UNSAFE_dangerouslyHoistSlotSizes
   }, /*#__PURE__*/React.createElement(SkipLinksProvider, {
     label: skipLinksLabel,

package/dist/es2019/ui/page-layout/side-nav/bind-open-layer-change.js

@@ -0,0 +1,51 @@
+import { bindAll } from 'bind-event-listener';
+/**
+ * Calls `onChange` after any popover or dialog inside `within` opens or closes.
+ * Read the new state with `hasOpenDialogOrPopover`.
+ *
+ * `beforetoggle`, `toggle` and `close` do not bubble, so they are observed in the capture phase.
+ *
+ * `toggle` and `close` are queued tasks. When a surface closes because it unmounts,
+ * they fire after the element has left the DOM, so they never reach `within`.
+ * `beforetoggle` fires synchronously while the element is still inside `within`,
+ * so it also schedules `onChange` in a microtask, after the state has changed.
+ */
+export function bindOpenLayerChange({
+  within,
+  onChange
+}) {
+  let isBound = true;
+  function listener() {
+    onChange();
+  }
+  function deferredListener() {
+    queueMicrotask(() => {
+      if (isBound) {
+        onChange();
+      }
+    });
+  }
+  const unbind = bindAll(within, [{
+    type: 'beforetoggle',
+    listener: deferredListener,
+    options: {
+      capture: true
+    }
+  }, {
+    type: 'toggle',
+    listener,
+    options: {
+      capture: true
+    }
+  }, {
+    type: 'close',
+    listener,
+    options: {
+      capture: true
+    }
+  }]);
+  return function cleanup() {
+    isBound = false;
+    unbind();
+  };
+}