@atlaskit/navigation-system 11.3.3 → 11.4.0

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

@@ -0,0 +1,197 @@
+/* local-panel-surface.tsx generated by @compiled/babel-plugin v3.0.2 */
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import "./local-panel-surface.compiled.css";
+import * as React from 'react';
+import { ax, ix } from "@compiled/react/runtime";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+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';
+var localPanelVar = '--p_lclPnlW';
+var panelSplitterResizingVar = '--p_lclPnlRsz';
+var 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. */
+var 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"
+};
+var contentEnteringDelayStyles = {
+  root: "_ju25dn4k"
+};
+/* eslint-enable @compiled/shorthand-property-sorting */
+
+var PanelContentMotion = function PanelContentMotion(_ref) {
+  var children = _ref.children;
+  var _useMotion = useMotion(),
+    state = _useMotion.state,
+    ref = _useMotion.ref;
+  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(_ref2) {
+  var _managedSizing$mode, _managedSizing$width;
+  var children = _ref2.children,
+    contentKey = _ref2.contentKey,
+    label = _ref2.label,
+    resizeLabel = _ref2.resizeLabel,
+    defaultWidth = _ref2.defaultWidth,
+    minWidth = _ref2.minWidth,
+    maxWidth = _ref2.maxWidth,
+    testId = _ref2.testId,
+    layoutRef = _ref2.layoutRef,
+    managedSizing = _ref2.managedSizing,
+    getManagedResizeBounds = _ref2.getManagedResizeBounds,
+    prepareResize = _ref2.prepareResize,
+    onManagedResizeStart = _ref2.onManagedResizeStart,
+    onManagedResize = _ref2.onManagedResize,
+    onManagedResizeEnd = _ref2.onManagedResizeEnd,
+    onWidthChange = _ref2.onWidthChange,
+    onResizeEnd = _ref2.onResizeEnd;
+  var ref = useRef(null);
+  var dangerouslyHoistSlotSizes = useContext(DangerouslyHoistSlotSizes);
+  useLayoutEffect(function () {
+    var 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.
+    var previousWidth;
+    var publishWidth = function publishWidth(width) {
+      if (width !== previousWidth) {
+        previousWidth = width;
+        panel.ownerDocument.documentElement.style.setProperty(localPanelWidthVar, "".concat(width, "px"));
+      }
+    };
+    publishWidth(panel.getBoundingClientRect().width);
+    var observer = new ResizeObserver(function (_ref3) {
+      var _entry$borderBoxSize$, _entry$borderBoxSize;
+      var _ref4 = _slicedToArray(_ref3, 1),
+        entry = _ref4[0];
+      publishWidth((_entry$borderBoxSize$ = (_entry$borderBoxSize = entry.borderBoxSize) === null || _entry$borderBoxSize === void 0 || (_entry$borderBoxSize = _entry$borderBoxSize[0]) === null || _entry$borderBoxSize === void 0 ? void 0 : _entry$borderBoxSize.inlineSize) !== null && _entry$borderBoxSize$ !== void 0 ? _entry$borderBoxSize$ : panel.getBoundingClientRect().width);
+    });
+    observer.observe(panel, {
+      box: 'border-box'
+    });
+    return function () {
+      observer.disconnect();
+      panel.ownerDocument.documentElement.style.removeProperty(localPanelWidthVar);
+    };
+  }, [dangerouslyHoistSlotSizes]);
+  var scrollRef = useRef(null);
+  useLayoutEffect(function () {
+    if (scrollRef.current) {
+      scrollRef.current.scrollTop = 0;
+    }
+  }, [contentKey]);
+  var _useMotion2 = useMotion(),
+    state = _useMotion2.state,
+    motionRef = _useMotion2.ref;
+  var isMotionUpliftEnabled = fg('platform-dst-motion-uplift-panel');
+  var isContentMotionEnabled = fg('platform-dst-motion-uplift-panel-content');
+  var mergedRef = useMemo(function () {
+    return isMotionUpliftEnabled ? mergeRefs([ref, motionRef]) : ref;
+  }, [isMotionUpliftEnabled, motionRef]);
+  var mode = (_managedSizing$mode = managedSizing === null || managedSizing === void 0 ? void 0 : managedSizing.mode) !== null && _managedSizing$mode !== void 0 ? _managedSizing$mode : 'overlay';
+  var 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.
+  var getMode = useCallback(function () {
+    if (managedMode.current) {
+      return managedMode.current;
+    }
+    return ref.current && getComputedStyle(ref.current).gridArea.split('/')[0].trim() === 'panel' ? 'inline' : 'overlay';
+  }, [managedMode]);
+  var dragMode = useRef('overlay');
+  var completedResizeModeRef = useRef(mode);
+  var 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.
+  var getResizeBounds = useCallback(function () {
+    var _getManagedResizeBoun;
+    return (_getManagedResizeBoun = getManagedResizeBounds()) !== null && _getManagedResizeBoun !== void 0 ? _getManagedResizeBoun : {
+      min: '0px',
+      max: '0px'
+    };
+  }, [getManagedResizeBounds]);
+  var onCompleteResize = useCallback(function (width) {
+    // Keyboard analytics are debounced; retain the mode that produced this width,
+    // rather than the layout mode when the delayed callback eventually runs.
+    var mode = getMode();
+    completedResizeModeRef.current = mode;
+    onManagedResizeEnd(mode, width);
+    onWidthChange(width);
+  }, [getMode, onManagedResizeEnd, onWidthChange]);
+  var onResizeStartInternal = useCallback(function () {
+    dragMode.current = getMode();
+    onManagedResizeStart(dragMode.current);
+  }, [getMode, onManagedResizeStart]);
+  var onResizeInternal = useCallback(function (width) {
+    return onManagedResize(dragMode.current, width);
+  }, [onManagedResize]);
+  var handleResizeEnd = useCallback(function (event) {
+    return onResizeEnd(_objectSpread(_objectSpread({}, event), {}, {
+      mode: completedResizeModeRef.current
+    }));
+  }, [onResizeEnd]);
+  return /*#__PURE__*/React.createElement("section", {
+    "aria-label": label,
+    "data-testid": testId,
+    "data-layout-with-panel-slot": "",
+    style: _defineProperty({}, localPanelVar, "".concat(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 && "".concat(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 && "".concat(testId, "--splitter"),
+    onResizeEnd: handleResizeEnd
+  }))));
+}

package/dist/esm/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';
@@ -26,7 +27,7 @@ export function Main(_ref) {
     testId = _ref.testId,
     providedId = _ref.id,
     _ref$minWidth = _ref.minWidth,
-    minWidth = _ref$minWidth === void 0 ? 320 : _ref$minWidth;
+    minWidth = _ref$minWidth === void 0 ? defaultMainMinWidth : _ref$minWidth;
   var id = useLayoutId({
     providedId: providedId
   });
@@ -41,5 +42,7 @@ export function Main(_ref) {
     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/esm/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 var MainMinWidthContext = /*#__PURE__*/createContext(defaultMainMinWidth);

package/dist/esm/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/esm/ui/page-layout/panel-layout-shell.js

@@ -0,0 +1,59 @@
+/* panel-layout-shell.tsx generated by @compiled/babel-plugin v3.0.2 */
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+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.
+var localPanelTrackWidthVar = '--p_lclPnlTrackW';
+var localPanelResizingVar = '--p_lclPnlRsz';
+var localPanelMinWidthVar = '--p_lclPnlMinW';
+var 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(_ref) {
+  var children = _ref.children,
+    panel = _ref.panel,
+    isPanelOpen = _ref.isPanelOpen,
+    panelWidth = _ref.panelWidth,
+    compactPanelWidth = _ref.compactPanelWidth,
+    _ref$panelMinWidth = _ref.panelMinWidth,
+    panelMinWidth = _ref$panelMinWidth === void 0 ? 320 : _ref$panelMinWidth,
+    mode = _ref.mode,
+    layoutRef = _ref.layoutRef,
+    _ref$shouldClipOverfl = _ref.shouldClipOverflow,
+    shouldClipOverflow = _ref$shouldClipOverfl === void 0 ? false : _ref$shouldClipOverfl,
+    testId = _ref.testId;
+  var mainMinWidth = useContext(MainMinWidthContext);
+  var id = "local-panel-".concat(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.
+  var inlineQuery = "@container local-panel-layout (min-width: ".concat(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, "".concat(inlineQuery, " {\n\t\t\t\t\t#").concat(id, " {\n\t\t\t\t\t\t--p_lclPnlSsrAreas: var(--p_lclPnlSsrInlineAreas);\n\t\t\t\t\t\t--p_lclPnlSsrColumns: minmax(0, 1fr) min(var(--p_lclPnlSsrPreferredW), calc(100% - ").concat(mainMinWidth, "px));\n\t\t\t\t\t\t--p_lclPnlSsrArea: panel;\n\t\t\t\t\t\t--p_lclPnlSsrWidth: 100%;\n\t\t\t\t\t\t--p_lclPnlSsrBackground: ", "var(--ds-surface, #FFFFFF)", ";\n\t\t\t\t\t\t--p_lclPnlSsrShadow: none;\n\t\t\t\t\t\t--p_lclPnlSsrBorder: ", "var(--ds-border-width, 1px)", " solid ", "var(--ds-border, #0B120E24)", ";\n\t\t\t\t\t}\n\t\t\t\t}")), /*#__PURE__*/React.createElement("div", {
+    id: id,
+    "data-testid": testId,
+    ref: layoutRef,
+    style: _defineProperty(_defineProperty(_defineProperty({}, localPanelTrackWidthVar, "".concat(panelWidth, "px")), localPanelMinWidthVar, "".concat(panelMinWidth, "px")), '--p_lclPnlCompactW', "".concat(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/esm/ui/page-layout/panel-layout.js

@@ -0,0 +1,154 @@
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+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.
+var mountedPanelLayouts = new WeakSet();
+function CoordinatedPanelLayout(_ref) {
+  var _ref2, _ref3, _ref4, _state$width;
+  var children = _ref.children,
+    panel = _ref.panel,
+    isPanelOpen = _ref.isPanelOpen,
+    panelKey = _ref.panelKey,
+    panelWidth = _ref.panelWidth,
+    defaultPanelWidth = _ref.defaultPanelWidth,
+    compactDefaultPanelWidth = _ref.compactDefaultPanelWidth,
+    suppliedMinWidth = _ref.panelMinWidth,
+    panelMaxWidth = _ref.panelMaxWidth,
+    onPanelWidthChange = _ref.onPanelWidthChange,
+    onResizeEnd = _ref.onResizeEnd,
+    _ref$panelLabel = _ref.panelLabel,
+    panelLabel = _ref$panelLabel === void 0 ? 'Panel' : _ref$panelLabel,
+    _ref$resizeLabel = _ref.resizeLabel,
+    resizeLabel = _ref$resizeLabel === void 0 ? 'Resize panel' : _ref$resizeLabel,
+    testId = _ref.testId,
+    layoutRef = _ref.layoutRef;
+  var _useState = useState(getPanelLayoutDefaults),
+    _useState2 = _slicedToArray(_useState, 1),
+    defaults = _useState2[0];
+  var panelMinWidth = suppliedMinWidth !== null && suppliedMinWidth !== void 0 ? suppliedMinWidth : defaults.panelMinWidth;
+  var coordinator = useContext(LayoutAreaSizingContext);
+  useEffect(function () {
+    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 function () {
+        mountedPanelLayouts.delete(coordinator);
+      };
+    }
+  }, [coordinator]);
+  var _useState3 = useState((_ref2 = defaultPanelWidth !== null && defaultPanelWidth !== void 0 ? defaultPanelWidth : panelWidth) !== null && _ref2 !== void 0 ? _ref2 : defaults.panelWidth),
+    _useState4 = _slicedToArray(_useState3, 1),
+    defaultWidth = _useState4[0];
+  var _useState5 = useState((_ref3 = (_ref4 = compactDefaultPanelWidth !== null && compactDefaultPanelWidth !== void 0 ? compactDefaultPanelWidth : defaultPanelWidth) !== null && _ref4 !== void 0 ? _ref4 : panelWidth) !== null && _ref3 !== void 0 ? _ref3 : defaults.compactPanelWidth),
+    _useState6 = _slicedToArray(_useState5, 1),
+    compactWidth = _useState6[0];
+  // Use the controlled request before measurement too, without changing the mount-time default.
+  var fallbackWidth = Math.max(panelMinWidth, Math.min(panelWidth !== null && panelWidth !== void 0 ? panelWidth : defaultWidth, panelMaxWidth !== null && panelMaxWidth !== void 0 ? panelMaxWidth : Infinity));
+  var _useLayoutAreaSizing = useLayoutAreaSizing({
+      area: 'panel',
+      config: {
+        isOpen: isPanelOpen,
+        requestedWidth: panelWidth,
+        defaultWidth: defaultWidth,
+        compactDefaultWidth: compactWidth,
+        minWidth: panelMinWidth,
+        maxWidth: panelMaxWidth
+      }
+    }),
+    state = _useLayoutAreaSizing.state,
+    prepareResize = _useLayoutAreaSizing.prepareResize,
+    getResizeBounds = _useLayoutAreaSizing.getResizeBounds,
+    startResize = _useLayoutAreaSizing.startResize,
+    resize = _useLayoutAreaSizing.resize,
+    completeResize = _useLayoutAreaSizing.completeResize;
+  // Host callback identity is unrelated to sizing. Keep drag bindings stable while
+  // still delivering completions to the latest product-owned state and analytics.
+  var onWidthChangeRef = useStableRef(onPanelWidthChange);
+  var onResizeEndRef = useStableRef(onResizeEnd);
+  var handleWidthChange = useCallback(function (width) {
+    var _onWidthChangeRef$cur;
+    return (_onWidthChangeRef$cur = onWidthChangeRef.current) === null || _onWidthChangeRef$cur === void 0 ? void 0 : _onWidthChangeRef$cur.call(onWidthChangeRef, width);
+  }, [onWidthChangeRef]);
+  var handleResizeEnd = useCallback(function (event) {
+    var _onResizeEndRef$curre;
+    return (_onResizeEndRef$curre = onResizeEndRef.current) === null || _onResizeEndRef$curre === void 0 ? void 0 : _onResizeEndRef$curre.call(onResizeEndRef, event);
+  }, [onResizeEndRef]);
+  var isMotionEnabled = fg('platform-dst-motion-uplift-panel');
+  var 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 && "".concat(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) {
+  var parentSizing = useContext(LayoutAreaSizingContext);
+  var layoutRef = useRef(null);
+  var 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/esm/ui/page-layout/panel-splitter/panel-splitter.js

@@ -26,6 +26,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';
@@ -168,7 +169,9 @@ var PortaledPanelSplitter = function PortaledPanelSplitter(_ref3) {
     _useState4 = _slicedToArray(_useState3, 2),
     rangeInputBounds = _useState4[0],
     setRangeInputBounds = _useState4[1];
-  var openLayerObserver = useOpenLayerObserver();
+  var openLayerObserver = useOpenLayerObserver({
+    isEnabled: !fg('platform-dst-top-layer')
+  });
 
   /**
    * This is a temporary workaround to enable the `SideNavPanelSplitter` component
@@ -182,7 +185,7 @@ var PortaledPanelSplitter = function PortaledPanelSplitter(_ref3) {
   var initialClientXRef = useRef(null);
   // Live allocation changes panelWidth on every frame. Only the legacy path should
   // rebind the drag listeners when this value changes.
-  var legacyPanelWidth = fg('platform-dst-chat-panel-layout') ? undefined : panelWidth;
+  var legacyPanelWidth = fg('platform-dst-chat-panel-layout') || onResizeInternal ? undefined : panelWidth;
   useEffect(function () {
     var splitter = splitterRef.current;
     invariant(splitter, 'Splitter ref must be set');
@@ -259,6 +262,8 @@ var PortaledPanelSplitter = function PortaledPanelSplitter(_ref3) {
         onResizeStart === null || onResizeStart === 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 || openLayerObserver.closeLayers();
       },
       onDrag: function onDrag(_ref6) {
@@ -289,7 +294,7 @@ var PortaledPanelSplitter = function PortaledPanelSplitter(_ref3) {
           position: position
         });
         var resizingWidth = "clamp(".concat(resizeBounds.min, ", ").concat(targetWidth, "px, ").concat(resizeBounds.max, ")");
-        if (fg('platform-dst-chat-panel-layout') && onResizeInternal) {
+        if (onResizeInternal) {
           // The allocator needs below-minimum requests for the local-to-chat cascade.
           var currentBounds = getResizeBounds();
           var width = Math.max(0, Math.min(targetWidth, prepareResize ? window.innerWidth : convertResizeBoundToPixels(currentBounds.max)));
@@ -345,7 +350,7 @@ var PortaledPanelSplitter = function PortaledPanelSplitter(_ref3) {
                 }
                 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(function () {
                     return onCompleteResize(finalWidth);
                   });
@@ -374,6 +379,8 @@ var PortaledPanelSplitter = function PortaledPanelSplitter(_ref3) {
         onResizeStart: function onResizeStart() {
           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 || openLayerObserver.closeLayers();
           for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
             args[_key] = arguments[_key];
@@ -400,7 +407,7 @@ var PortaledPanelSplitter = function PortaledPanelSplitter(_ref3) {
       return _regeneratorRuntime.wrap(function (_context2) {
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
-            isManagedResize = fg('platform-dst-chat-panel-layout') && onResizeInternal;
+            isManagedResize = onResizeInternal;
             sequence = focusSequence.current;
             value = isManagedResize ? parseFloat(event.currentTarget.value) : parseInt(event.currentTarget.value);
             if (!prepareResize) {

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

@@ -69,6 +69,8 @@ export function Root(_ref2) {
   var isChatPanelLayoutEnabled = fg('platform-dst-chat-panel-layout');
   var LayoutProvider = isChatPanelLayoutEnabled ? LayoutAreaSizingProvider : React.Fragment;
   var WidthContainer = isChatPanelLayoutEnabled ? LayoutFitContainers : React.Fragment;
+  // Top-layer surfaces are found through the DOM, so the observer is only needed when the gate is off.
+  var LayerObserverProvider = fg('platform-dst-top-layer') ? React.Fragment : OpenLayerObserver;
   useEffect(function () {
     if (process.env.NODE_ENV !== 'production') {
       var IGNORED_ELEMENTS = ['SCRIPT', 'STYLE'];
@@ -91,7 +93,7 @@ export function Root(_ref2) {
     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/esm/ui/page-layout/side-nav/bind-open-layer-change.js

@@ -0,0 +1,50 @@
+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(_ref) {
+  var within = _ref.within,
+    onChange = _ref.onChange;
+  var isBound = true;
+  function listener() {
+    onChange();
+  }
+  function deferredListener() {
+    queueMicrotask(function () {
+      if (isBound) {
+        onChange();
+      }
+    });
+  }
+  var unbind = bindAll(within, [{
+    type: 'beforetoggle',
+    listener: deferredListener,
+    options: {
+      capture: true
+    }
+  }, {
+    type: 'toggle',
+    listener: listener,
+    options: {
+      capture: true
+    }
+  }, {
+    type: 'close',
+    listener: listener,
+    options: {
+      capture: true
+    }
+  }]);
+  return function cleanup() {
+    isBound = false;
+    unbind();
+  };
+}