@atlaskit/navigation-system 11.3.4 → 11.4.0

package/dist/esm/ui/page-layout/layout-area-sizing-runtime.js

@@ -8,11 +8,11 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 import React, { useCallback, useEffect, useMemo, useState } from 'react';
 import { bind } from 'bind-event-listener';
 import { calculateLayoutAreaStates } from './calculate-layout-area-states';
+import { defaultMainMinWidth } from './constants';
 import { LayoutAreaSizingContext } from './layout-area-sizing-context';
 import { layoutAreaStateContexts } from './layout-area-state-contexts';
 import { resolveLayoutWidth } from './resolve-layout-width';
 import { useOccupiedLayoutWidth } from './use-occupied-layout-width';
-var defaultMainMinWidth = 320;
 function useStableAreaState(state) {
   var _ref = state !== null && state !== void 0 ? state : {},
     mode = _ref.mode,
@@ -304,7 +304,7 @@ export function LayoutAreaSizingRuntime(_ref2) {
       if (!existing) {
         return current;
       }
-      if (mode === 'overlay') {
+      if (mode === 'overlay' && area !== 'panel') {
         return _objectSpread(_objectSpread({}, current), {}, _defineProperty({}, area, _objectSpread(_objectSpread({}, existing), {}, {
           liveResize: undefined,
           preferredOverlayWidth: width
@@ -312,7 +312,8 @@ export function LayoutAreaSizingRuntime(_ref2) {
       }
       return _objectSpread(_objectSpread({}, current), {}, _defineProperty({}, area, _objectSpread(_objectSpread({}, existing), {}, {
         liveResize: undefined,
-        preferredInlineWidth: width
+        // Local panels have one preference, regardless of the resized mode.
+        preferredWidth: width
       })));
     });
   }, [captureSiblingWidths]);

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

@@ -0,0 +1,26 @@
+._nd5l1c6w{grid-area:panel}
+._nd5l1gzg{grid-area:main}
+._nd5l32aw{grid-area:var(--p_lclPnlSsrArea,main)}
+._y44v1mph{animation:var(--ds-panel-content-enter,.15s cubic-bezier(.4,1,.6,1) FadeIn0to100)}
+._y44vf1qi{animation:var(--ds-panel-content-exit,50ms cubic-bezier(.6,0,.8,.6) FadeOut100to0)}
+._191wbqna{border-inline-start:var(--p_lclPnlSsrBorder,none)}
+._191wglyw{border-inline-start:none}
+._191wia51{border-inline-start:var(--ds-border-width,1px) solid var(--ds-border,#0b120e24)}._10fph9n0{justify-self:end}
+._152tidpf{inset-block-start:0}
+._16qs130s{box-shadow:var(--ds-shadow-overlay,0 8px 9pt #1e1f2126,0 0 1px #1e1f214f)}
+._16qs1dhr{box-shadow:var(--p_lclPnlSsrShadow,var(--ds-shadow-overlay,0 8px 9pt #1e1f2126,0 0 1px #1e1f214f))}
+._16qsglyw{box-shadow:none}
+._18m91wug{overflow-y:auto}
+._1bsb13q4{width:min(90%,var(--p_lclPnlRsz,var(--p_lclPnlW)))}
+._1bsb1c5w{width:var(--p_lclPnlRsz,var(--p_lclPnlW))}
+._1bsb1cku{width:var(--p_lclPnlSsrWidth,min(90%,var(--p_lclPnlSsrPreferredW)))}
+._1reo1wug{overflow-x:auto}
+._4t3i1osq{height:100%}
+._4t3ieqxy{height:calc(100vh - var(--n_bnrM, 0px) - var(--n_tNvM, 0px))}
+._bfhk1bhr{background-color:var(--ds-surface-overlay,#fff)}
+._bfhk1g1j{background-color:var(--p_lclPnlSsrBackground,var(--ds-surface-overlay,#fff))}
+._bfhkvuon{background-color:var(--ds-surface,#fff)}
+._ju25dn4k{animation-delay:var(--ds-duration-xshort,.1s)}
+._kqsw1if8{position:sticky}
+._vchhusvi{box-sizing:border-box}
+@media (prefers-reduced-motion:no-preference){._k1af14vv{animation:var(--ds-panel-exit-right,.2s cubic-bezier(0,.4,0,1) SlideOut100PercentRight)}[dir=rtl] ._105aeydr{animation:var(--ds-panel-exit-left,.2s cubic-bezier(0,.4,0,1) SlideOut100PercentLeft)}._bq641n9t{position:fixed}@starting-style{._1kmh1n9t{position:fixed}}._k1af1nn1{animation:var(--ds-panel-enter-right,.25s cubic-bezier(0,.4,0,1) SlideIn100PercentRight)}._10t81ia4{transition-property:position}._xrrp147i{transition-duration:var(--ds-duration-instant,0ms)}._1wsa1ign{transition-delay:var(--ds-duration-short,.15s)}._1vrh1a5r{transition-behavior:allow-discrete}[dir=rtl] ._105abamb{animation:var(--ds-panel-enter-left,.25s cubic-bezier(0,.4,0,1) SlideIn100PercentLeft)}}

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

@@ -185,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');
@@ -294,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)));
@@ -350,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);
                   });
@@ -407,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/side-nav/side-nav.js

@@ -21,7 +21,7 @@ import { monitorForElements } from '@atlaskit/pragmatic-drag-and-drop/adapter/el
 import { hasOpenDialogOrPopover } from '@atlaskit/top-layer/page-surface/has-open-dialog-or-popover';
 import { useSkipLinkInternal } from '../../../context/skip-links/use-skip-link-internal';
 import { TopNavStartElement } from '../../../context/top-nav-start/top-nav-start-element';
-import { UNSAFE_sideNavLayoutVar, mainMinimumWidthVar, openLayerObserverSideNavNamespace, sideNavLiveWidthVar, sideNavPanelSplitterId, sideNavVar } from '../constants';
+import { UNSAFE_sideNavLayoutVar, defaultMainMinWidth, mainMinimumWidthVar, openLayerObserverSideNavNamespace, sideNavLiveWidthVar, sideNavPanelSplitterId, sideNavVar } from '../constants';
 import { DangerouslyHoistCssVarToDocumentRoot } from '../dangerously-hoist-css-var-to-document-root';
 import { DangerouslyHoistSlotSizes } from '../hoist-slot-sizes-context';
 import { convertResizeBoundToPixels } from '../panel-splitter/convert-resize-bound-to-pixels';
@@ -354,7 +354,7 @@ function SideNavInternal(_ref4) {
     var isLocalPanelInline = localPanel && getComputedStyle(localPanel).gridArea === 'panel';
     var localPanelWidth = isLocalPanelInline ? localPanel.getBoundingClientRect().width : 0;
     var mainContentWidth = mainWidth - localPanelWidth;
-    var mainMinimumWidth = getPixelCustomProperty(main, mainMinimumWidthVar, 320);
+    var mainMinimumWidth = getPixelCustomProperty(main, mainMinimumWidthVar, defaultMainMinWidth);
     var availableWidth = Math.max(0, mainContentWidth - mainMinimumWidth);
     var availableInlineWidth = Math.floor(sideNavWidth + availableWidth);
     var constrainedMaxWidth = maxWidth ? Math.min(convertResizeBoundToPixels(maxWidth), availableInlineWidth) : availableInlineWidth;

package/dist/types/entry-points/layout/panel-layout.d.ts

@@ -0,0 +1,3 @@
+export { PanelLayout } from '../../ui/page-layout/panel-layout';
+export type { PanelLayoutProps, PanelResizeEnd } from '../../ui/page-layout/panel-layout';
+export { localPanelWidthVar } from '../../ui/page-layout/constants';

package/dist/types/ui/page-layout/constants.d.ts

@@ -3,6 +3,10 @@
  * This violates the [UI styling standard](https://atlassian.design/components/eslint-plugin-ui-styling-standard/no-imported-style-values/usage).
  * We have chosen to ignore this rule to prevent duplicating them across the different slots, and to provide a high level view of them and how they relate.
  */
+/**
+ * Default minimum width of Main, in pixels, before a custom minimum is registered.
+ */
+export declare const defaultMainMinWidth = 320;
 export declare const sideNavVar = "--n_sNvw";
 export declare const asideVar = "--n_asDw";
 export declare const panelVar = "--n_pnlW";
@@ -12,6 +16,14 @@ export declare const mainMinimumWidthVar = "--n_mainMinW";
 export declare const bannerMountedVar = "--n_bnrM";
 export declare const topNavMountedVar = "--n_tNvM";
 export declare const ribbonVar = "--n_rbnW";
+/**
+ * Rendered border-box width of the local PanelLayout surface, in both inline and overlay modes.
+ * Published on document.documentElement after mounting when Root opts into
+ * UNSAFE_dangerouslyHoistSlotSizes. Only the primary Root should opt in.
+ * Use `var(${localPanelWidthVar}, 0px)` for external controls, not for width persistence
+ * or sizing the panel itself. The property is removed when the surface unmounts.
+ */
+export declare const localPanelWidthVar = "--n_localPanelWidth";
 /**
  * Captures the current width of the side navigation, at all times, including during resizing.
  *

package/dist/types/ui/page-layout/get-panel-layout-defaults.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Local-panel defaults in pixels, used only when no explicit preference exists.
+ * Keep the existing desktop width until chat layout rolls out. Compact sizing is independent.
+ * These are requested defaults, not measurements of an open panel.
+ */
+export declare function getPanelLayoutDefaults(): {
+    panelWidth: number;
+    compactPanelWidth: number;
+    panelMinWidth: number;
+};

package/dist/types/ui/page-layout/layout-area-sizing-context.d.ts

@@ -16,7 +16,11 @@ export type LayoutAreaConfig = {
     onRequestClose?: () => void;
 };
 export type StoredLayoutArea = LayoutAreaConfig & {
-    preferredInlineWidth?: number;
+    /**
+     * Local panels share this preference across inline and overlay modes.
+     * SideNav and ChatPanel retain separate overlay preferences.
+     */
+    preferredWidth?: number;
     preferredOverlayWidth?: number;
     liveResize?: {
         mode: LayoutAreaMode;