@viasat/beam-react 2.10.2 → 2.11.0

package/lib/wip/Panel/Panel.Header.Row.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("react/jsx-runtime"),d=require("clsx"),m=require("../../../chunks/classNames.DAeKwerT.js");require("../../../chunks/constants.hwjHOsvT.js");const _=require("../../CloseButton/CloseButton.cjs.js"),b=require("./Panel.context.cjs.js"),l=require("../../../chunks/panel.module.BX1x4FlX.js"),{subElementClassPrefix:x}=m.getBEMClassNames("panel"),t=`${x}header`,o=({children:a,className:n,...r})=>{const{dismissible:i,closeButtonAriaLabel:c,onOpenChange:e}=b.usePanelContext(),u=d(l.styles[`${t}__row`],n);return s.jsxs("div",{className:u,...r,children:[a,i&&s.jsx("div",{className:l.styles[`${t}__close-button`],children:s.jsx(_.CloseButton,{"aria-label":c,onClick:()=>e==null?void 0:e(!1),size:"lg"})})]})};o.displayName="Panel.Header.Row";exports.Row=o;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),d=require("clsx"),m=require("../../../chunks/classNames.DAeKwerT.js");require("../../../chunks/constants.hwjHOsvT.js");const _=require("../../CloseButton/CloseButton.cjs.js"),b=require("./Panel.context.cjs.js"),s=require("../../../chunks/panel.module.BX1x4FlX.js"),{subElementClassPrefix:C}=m.getBEMClassNames("panel"),t=`${C}header`,l=({children:o,className:n,...a})=>{const{dismissible:r,closeButtonAriaLabel:i,requestClose:c}=b.usePanelContext(),u=d(s.styles[`${t}__row`],n);return e.jsxs("div",{className:u,...a,children:[o,r&&e.jsx("div",{className:s.styles[`${t}__close-button`],children:e.jsx(_.CloseButton,{"aria-label":i,onClick:()=>c("closeButton"),size:"lg"})})]})};l.displayName="Panel.Header.Row";exports.Row=l;

package/lib/wip/Panel/Panel.Header.Row.es.js

@@ -1,29 +1,29 @@
-import { jsxs as n, jsx as e } from "react/jsx-runtime";
+import { jsxs as c, jsx as s } from "react/jsx-runtime";
 import p from "clsx";
 import { g as d } from "../../../chunks/classNames.BTJmrO_L.js";
 import "../../../chunks/constants.CKKGf1-i.js";
-import { CloseButton as f } from "../../CloseButton/CloseButton.es.js";
-import { usePanelContext as b } from "./Panel.context.es.js";
-import { s as o } from "../../../chunks/panel.module.BVm3KvDs.js";
-const { subElementClassPrefix: u } = d("panel"), a = `${u}header`, x = ({
-  children: l,
-  className: t,
-  ...r
+import { CloseButton as u } from "../../CloseButton/CloseButton.es.js";
+import { usePanelContext as f } from "./Panel.context.es.js";
+import { s as e } from "../../../chunks/panel.module.BVm3KvDs.js";
+const { subElementClassPrefix: C } = d("panel"), o = `${C}header`, b = ({
+  children: t,
+  className: l,
+  ...a
 }) => {
-  const { dismissible: i, closeButtonAriaLabel: m, onOpenChange: s } = b(), c = p(o[`${a}__row`], t);
-  return /* @__PURE__ */ n("div", { className: c, ...r, children: [
-    l,
-    i && /* @__PURE__ */ e("div", { className: o[`${a}__close-button`], children: /* @__PURE__ */ e(
-      f,
+  const { dismissible: r, closeButtonAriaLabel: i, requestClose: m } = f(), n = p(e[`${o}__row`], l);
+  return /* @__PURE__ */ c("div", { className: n, ...a, children: [
+    t,
+    r && /* @__PURE__ */ s("div", { className: e[`${o}__close-button`], children: /* @__PURE__ */ s(
+      u,
       {
-        "aria-label": m,
-        onClick: () => s == null ? void 0 : s(!1),
+        "aria-label": i,
+        onClick: () => m("closeButton"),
         size: "lg"
       }
     ) })
   ] });
 };
-x.displayName = "Panel.Header.Row";
+b.displayName = "Panel.Header.Row";
 export {
-  x as Row
+  b as Row
 };

package/lib/wip/Panel/Panel.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),u=require("clsx"),S=require("../../../chunks/classNames.DAeKwerT.js");require("../../../chunks/constants.hwjHOsvT.js");const $=require("./Panel.context.cjs.js"),R=require("./Panel.Header.cjs.js"),U=require("./Panel.Body.cjs.js"),B=require("./Panel.Footer.cjs.js"),r=require("./Panel.helpers.cjs.js"),T=require("../../FloatingUI/FloatingUI.root.cjs.js"),A=require("../../FloatingUI/FloatingUI.content.cjs.js"),H=require("../../Divider/Divider.cjs.js"),s=require("../../../chunks/panel.module.BX1x4FlX.js"),{baseClassNamePrefix:t}=S.getBEMClassNames("panel"),a=({position:l,className:d})=>e.jsx(H.Divider,{borderColor:"01",orientation:l==="bottom"?"horizontal":"vertical",className:d}),n=({children:l,className:d,padding:q="md",onOpenChange:v,open:p,size:c,dismissible:g=!0,closeButtonAriaLabel:I="Close panel",kind:o="inline",position:P,divider:f=!0,isAnimated:y=!0,...x})=>{const i=r.getResolvedPanelPosition(P),m=u(s.styles[t],s.styles[`${t}--${o}`],c&&s.styles[`${t}--size-${c}`],s.styles[`${t}--padding-${q}`],s.styles[`${t}--position-${i}`],d),w=u(s.styles[`${t}__inline-wrapper`],c==="full"&&s.styles[`${t}__inline-wrapper--full`]),b={dismissible:g,closeButtonAriaLabel:I,onOpenChange:v,position:P},{inlineStatus:C,isInlineVisible:N}=r.useInlineTransition(o==="inline"?p:void 0,y),{showDivider:j,dividerBefore:D,dividerAfter:F}=r.getPanelDividerState(f,i),h=o==="overlay"?u(s.styles[`${t}__overlay-divider`],s.styles[`${t}__overlay-divider--${i}`]):void 0,_=j&&N;return o==="inline"?N?e.jsxs($.PanelContext.Provider,{value:b,children:[D&&_&&e.jsx(a,{position:i}),e.jsx("div",{className:w,"data-position":i,"data-status":C,children:e.jsxs("div",{className:s.styles[`${t}__inline-wrapper-content`],children:[i==="bottom"&&_&&e.jsx(a,{position:i}),e.jsx("aside",{className:m,...x,children:l})]})}),F&&_&&e.jsx(a,{position:i})]}):null:e.jsx($.PanelContext.Provider,{value:b,children:e.jsx(T.FloatingUIRoot,{open:p,onOpenChange:v,portalled:!0,transitionConfig:{duration:y?r.PANEL_TRANSITION_DURATION_MS:0},children:e.jsxs(A.Content,{className:m,skipFloatingStyles:!0,overlay:!0,...x,"data-position":i,children:[l,j&&e.jsx(a,{position:i,className:h})]})})})};n.displayName="Panel";n.Header=R.Header;n.Body=U.Body;n.Footer=B.Footer;exports.Panel=n;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react/jsx-runtime"),u=require("clsx"),U=require("../../../chunks/classNames.DAeKwerT.js");require("../../../chunks/constants.hwjHOsvT.js");const N=require("./Panel.context.cjs.js"),B=require("./Panel.Header.cjs.js"),T=require("./Panel.Body.cjs.js"),A=require("./Panel.Footer.cjs.js"),t=require("./Panel.helpers.cjs.js"),H=require("../../FloatingUI/FloatingUI.root.cjs.js"),M=require("../../FloatingUI/FloatingUI.content.cjs.js"),E=require("../../Divider/Divider.cjs.js"),n=require("../../../chunks/panel.module.BX1x4FlX.js"),{baseClassNamePrefix:s}=U.getBEMClassNames("panel"),a=({position:o,className:d})=>e.jsx(E.Divider,{borderColor:"01",orientation:o==="bottom"?"horizontal":"vertical",className:d}),l=({children:o,className:d,padding:j="md",onOpenChange:q,open:v,size:c,dismissible:C=!0,closeButtonAriaLabel:$="Close panel",kind:r="inline",position:p,divider:h=!0,isAnimated:P=!0,onBeforeClose:I,...y})=>{const i=t.getResolvedPanelPosition(p),x=u(n.styles[s],n.styles[`${s}--${r}`],c&&n.styles[`${s}--size-${c}`],n.styles[`${s}--padding-${j}`],n.styles[`${s}--position-${i}`],d),f=u(n.styles[`${s}__inline-wrapper`],c==="full"&&n.styles[`${s}__inline-wrapper--full`]),{requestClose:w,handleOverlayOpenChange:D}=t.usePanelClose(I,q),m={dismissible:C,closeButtonAriaLabel:$,position:p,requestClose:w},{inlineStatus:F,isInlineVisible:b}=t.useInlineTransition(r==="inline"?v:void 0,P),{showDivider:g,dividerBefore:S,dividerAfter:O}=t.getPanelDividerState(h,i),R=r==="overlay"?u(n.styles[`${s}__overlay-divider`],n.styles[`${s}__overlay-divider--${i}`]):void 0,_=g&&b;return r==="inline"?b?e.jsxs(N.PanelContext.Provider,{value:m,children:[S&&_&&e.jsx(a,{position:i}),e.jsx("div",{className:f,"data-position":i,"data-status":F,children:e.jsxs("div",{className:n.styles[`${s}__inline-wrapper-content`],children:[i==="bottom"&&_&&e.jsx(a,{position:i}),e.jsx("aside",{className:x,...y,children:o})]})}),O&&_&&e.jsx(a,{position:i})]}):null:e.jsx(N.PanelContext.Provider,{value:m,children:e.jsx(H.FloatingUIRoot,{open:v,onOpenChange:D,portalled:!0,transitionConfig:{duration:P?t.PANEL_TRANSITION_DURATION_MS:0},children:e.jsxs(M.Content,{className:x,skipFloatingStyles:!0,overlay:!0,...y,"data-position":i,children:[o,g&&e.jsx(a,{position:i,className:R})]})})})};l.displayName="Panel";l.Header=B.Header;l.Body=T.Body;l.Footer=A.Footer;exports.Panel=l;

package/lib/wip/Panel/Panel.context.d.ts

@@ -1,4 +1,4 @@
-import { PanelPosition } from './Panel.types';
+import { PanelCloseReason, PanelPosition } from './Panel.types';
 export interface PanelContextValue {
     /**
      * Whether to show a dismissible button
@@ -8,14 +8,15 @@ export interface PanelContextValue {
      * Aria label for the dismissible button
      */
     closeButtonAriaLabel?: string;
-    /**
-     * Callback when panel open state changes
-     */
-    onOpenChange?: (open: boolean) => void;
     /**
      * Panel position (determines divider placement)
      */
     position?: PanelPosition;
+    /**
+     * Request the panel to close for the given reason. Runs `onBeforeClose` if
+     * provided and only calls `onOpenChange(false)` when the guard returns `true`.
+     */
+    requestClose: (reason: PanelCloseReason) => void;
 }
 export declare const PanelContext: import('react').Context<PanelContextValue | undefined>;
 export declare const usePanelContext: () => PanelContextValue;

package/lib/wip/Panel/Panel.d.ts

@@ -1,6 +1,6 @@
 import { PanelProps } from './Panel.types';
 export declare const Panel: {
-    ({ children, className: _className, padding, onOpenChange, open, size, dismissible, closeButtonAriaLabel, kind, position, divider, isAnimated, ...props }: PanelProps): JSX.Element | null;
+    ({ children, className: _className, padding, onOpenChange, open, size, dismissible, closeButtonAriaLabel, kind, position, divider, isAnimated, onBeforeClose, ...props }: PanelProps): JSX.Element | null;
     displayName: string;
     Header: {
         ({ children, className: _className, divider, ...props }: import('./Panel.Header').PanelHeaderProps): import("react/jsx-runtime").JSX.Element;

package/lib/wip/Panel/Panel.es.js

@@ -1,105 +1,106 @@
 import { jsxs as p, jsx as r } from "react/jsx-runtime";
 import v from "clsx";
-import { g as F } from "../../../chunks/classNames.BTJmrO_L.js";
+import { g as A } from "../../../chunks/classNames.BTJmrO_L.js";
 import "../../../chunks/constants.CKKGf1-i.js";
-import { PanelContext as I } from "./Panel.context.es.js";
-import { Header as T } from "./Panel.Header.es.js";
-import { Body as A } from "./Panel.Body.es.js";
-import { Footer as j } from "./Panel.Footer.es.js";
-import { useInlineTransition as E, getPanelDividerState as H, PANEL_TRANSITION_DURATION_MS as M, getResolvedPanelPosition as U } from "./Panel.helpers.es.js";
-import { FloatingUIRoot as V } from "../../FloatingUI/FloatingUI.root.es.js";
-import { Content as L } from "../../FloatingUI/FloatingUI.content.es.js";
-import { Divider as O } from "../../Divider/Divider.es.js";
-import { s as i } from "../../../chunks/panel.module.BVm3KvDs.js";
-const { baseClassNamePrefix: o } = F("panel"), l = ({
+import { PanelContext as h } from "./Panel.context.es.js";
+import { Header as j } from "./Panel.Header.es.js";
+import { Body as E } from "./Panel.Body.es.js";
+import { Footer as H } from "./Panel.Footer.es.js";
+import { usePanelClose as M, useInlineTransition as U, getPanelDividerState as V, PANEL_TRANSITION_DURATION_MS as q, getResolvedPanelPosition as L } from "./Panel.helpers.es.js";
+import { FloatingUIRoot as W } from "../../FloatingUI/FloatingUI.root.es.js";
+import { Content as z } from "../../FloatingUI/FloatingUI.content.es.js";
+import { Divider as G } from "../../Divider/Divider.es.js";
+import { s as o } from "../../../chunks/panel.module.BVm3KvDs.js";
+const { baseClassNamePrefix: i } = A("panel"), a = ({
   position: t,
-  className: a
+  className: s
 }) => /* @__PURE__ */ r(
-  O,
+  G,
   {
     borderColor: "01",
     orientation: t === "bottom" ? "horizontal" : "vertical",
-    className: a
+    className: s
   }
-), s = ({
+), l = ({
   children: t,
-  className: a,
-  padding: g = "md",
-  onOpenChange: c,
-  open: f,
+  className: s,
+  padding: y = "md",
+  onOpenChange: g,
+  open: c,
   size: d,
-  dismissible: h = !0,
+  dismissible: I = !0,
   closeButtonAriaLabel: x = "Close panel",
   kind: n = "inline",
   position: u,
   divider: D = !0,
-  isAnimated: N = !0,
-  ...$
+  isAnimated: f = !0,
+  onBeforeClose: b,
+  ...N
 }) => {
-  const e = U(u), _ = v(
-    i[o],
-    i[`${o}--${n}`],
-    d && i[`${o}--size-${d}`],
-    i[`${o}--padding-${g}`],
-    i[`${o}--position-${e}`],
-    a
-  ), b = v(
-    i[`${o}__inline-wrapper`],
-    d === "full" && i[`${o}__inline-wrapper--full`]
-  ), P = {
-    dismissible: h,
+  const e = L(u), $ = v(
+    o[i],
+    o[`${i}--${n}`],
+    d && o[`${i}--size-${d}`],
+    o[`${i}--padding-${y}`],
+    o[`${i}--position-${e}`],
+    s
+  ), O = v(
+    o[`${i}__inline-wrapper`],
+    d === "full" && o[`${i}__inline-wrapper--full`]
+  ), { requestClose: R, handleOverlayOpenChange: S } = M(b, g), C = {
+    dismissible: I,
     closeButtonAriaLabel: x,
-    onOpenChange: c,
-    position: u
-  }, { inlineStatus: R, isInlineVisible: y } = E(
-    n === "inline" ? f : void 0,
-    N
-  ), { showDivider: C, dividerBefore: S, dividerAfter: w } = H(
+    position: u,
+    requestClose: R
+  }, { inlineStatus: w, isInlineVisible: _ } = U(
+    n === "inline" ? c : void 0,
+    f
+  ), { showDivider: P, dividerBefore: B, dividerAfter: F } = V(
     D,
     e
-  ), B = n === "overlay" ? v(
-    i[`${o}__overlay-divider`],
-    i[`${o}__overlay-divider--${e}`]
-  ) : void 0, m = C && y;
-  return n === "inline" ? y ? /* @__PURE__ */ p(I.Provider, { value: P, children: [
-    S && m && /* @__PURE__ */ r(l, { position: e }),
+  ), T = n === "overlay" ? v(
+    o[`${i}__overlay-divider`],
+    o[`${i}__overlay-divider--${e}`]
+  ) : void 0, m = P && _;
+  return n === "inline" ? _ ? /* @__PURE__ */ p(h.Provider, { value: C, children: [
+    B && m && /* @__PURE__ */ r(a, { position: e }),
     /* @__PURE__ */ r(
       "div",
       {
-        className: b,
+        className: O,
         "data-position": e,
-        "data-status": R,
-        children: /* @__PURE__ */ p("div", { className: i[`${o}__inline-wrapper-content`], children: [
-          e === "bottom" && m && /* @__PURE__ */ r(l, { position: e }),
-          /* @__PURE__ */ r("aside", { className: _, ...$, children: t })
+        "data-status": w,
+        children: /* @__PURE__ */ p("div", { className: o[`${i}__inline-wrapper-content`], children: [
+          e === "bottom" && m && /* @__PURE__ */ r(a, { position: e }),
+          /* @__PURE__ */ r("aside", { className: $, ...N, children: t })
         ] })
       }
     ),
-    w && m && /* @__PURE__ */ r(l, { position: e })
-  ] }) : null : /* @__PURE__ */ r(I.Provider, { value: P, children: /* @__PURE__ */ r(
-    V,
+    F && m && /* @__PURE__ */ r(a, { position: e })
+  ] }) : null : /* @__PURE__ */ r(h.Provider, { value: C, children: /* @__PURE__ */ r(
+    W,
     {
-      open: f,
-      onOpenChange: c,
+      open: c,
+      onOpenChange: S,
       portalled: !0,
       transitionConfig: {
-        duration: N ? M : 0
+        duration: f ? q : 0
       },
       children: /* @__PURE__ */ p(
-        L,
+        z,
         {
-          className: _,
+          className: $,
           skipFloatingStyles: !0,
           overlay: !0,
-          ...$,
+          ...N,
           "data-position": e,
           children: [
             t,
-            C && /* @__PURE__ */ r(
-              l,
+            P && /* @__PURE__ */ r(
+              a,
               {
                 position: e,
-                className: B
+                className: T
               }
             )
           ]
@@ -108,10 +109,10 @@ const { baseClassNamePrefix: o } = F("panel"), l = ({
     }
   ) });
 };
-s.displayName = "Panel";
-s.Header = T;
-s.Body = A;
-s.Footer = j;
+l.displayName = "Panel";
+l.Header = j;
+l.Body = E;
+l.Footer = H;
 export {
-  s as Panel
+  l as Panel
 };

package/lib/wip/Panel/Panel.helpers.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react"),o=400,c=e=>e||"end",d=(e,t)=>{const n=e&&t!=="full";return{showDivider:n,dividerBefore:n&&t!=="start"&&t!=="bottom",dividerAfter:n&&t==="start"}},I=(e,t)=>{const[n,i]=a.useState(void 0),[l,s]=a.useState(e!==!1);return a.useEffect(()=>{if(!t){s(e!==!1),i(void 0);return}if(e!==void 0)if(e){s(!0),i("close");let r;const u=requestAnimationFrame(()=>{r=requestAnimationFrame(()=>i("open"))});return()=>{cancelAnimationFrame(u),cancelAnimationFrame(r)}}else{i("close");const r=setTimeout(()=>{s(!1),i(void 0)},o);return()=>clearTimeout(r)}},[t,e]),{inlineStatus:n,isInlineVisible:l}};exports.PANEL_TRANSITION_DURATION_MS=o;exports.getPanelDividerState=d;exports.getResolvedPanelPosition=c;exports.useInlineTransition=I;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("react"),a=400,f=e=>e||"end",o=(e,t)=>{const s=e&&t!=="full";return{showDivider:s,dividerBefore:s&&t!=="start"&&t!=="bottom",dividerAfter:s&&t==="start"}},m=e=>e==="escape-key"?"escapeKey":e==="outside-press"?"outsidePress":"programmatic",v=(e,t)=>{const s=c.useCallback(u=>{if(!e){t==null||t(!1);return}const r=e(u);r instanceof Promise?r.then(i=>{i&&(t==null||t(!1))}).catch(()=>{}):r&&(t==null||t(!1))},[e,t]),l=c.useCallback((u,r,i)=>{u?t==null||t(!0):s(m(i))},[t,s]);return{requestClose:s,handleOverlayOpenChange:l}},I=(e,t)=>{const[s,l]=c.useState(void 0),[u,r]=c.useState(e!==!1);return c.useEffect(()=>{if(!t){r(e!==!1),l(void 0);return}if(e!==void 0)if(e){r(!0),l("close");let i;const d=requestAnimationFrame(()=>{i=requestAnimationFrame(()=>l("open"))});return()=>{cancelAnimationFrame(d),cancelAnimationFrame(i)}}else{l("close");const i=setTimeout(()=>{r(!1),l(void 0)},a);return()=>clearTimeout(i)}},[t,e]),{inlineStatus:s,isInlineVisible:u}};exports.PANEL_TRANSITION_DURATION_MS=a;exports.getPanelDividerState=o;exports.getResolvedPanelPosition=f;exports.useInlineTransition=I;exports.usePanelClose=v;

package/lib/wip/Panel/Panel.helpers.d.ts

@@ -1,4 +1,5 @@
-import { PanelPosition } from './Panel.types';
+import { OpenChangeReason } from '@floating-ui/react';
+import { PanelCloseReason, PanelPosition, PanelProps } from './Panel.types';
 export declare const PANEL_TRANSITION_DURATION_MS = 400;
 export type PanelInlineStatus = 'open' | 'close' | undefined;
 export declare const getResolvedPanelPosition: (position?: PanelPosition) => PanelPosition;
@@ -7,6 +8,10 @@ export declare const getPanelDividerState: (divider: boolean, position?: PanelPo
     dividerBefore: boolean;
     dividerAfter: boolean;
 };
+export declare const usePanelClose: (onBeforeClose: PanelProps["onBeforeClose"], onOpenChange: PanelProps["onOpenChange"]) => {
+    requestClose: (reason: PanelCloseReason) => void;
+    handleOverlayOpenChange: (nextOpen: boolean, _event?: Event, floatingReason?: OpenChangeReason) => void;
+};
 export declare const useInlineTransition: (open: boolean | undefined, isAnimated: boolean) => {
     inlineStatus: PanelInlineStatus;
     isInlineVisible: boolean;

package/lib/wip/Panel/Panel.helpers.es.js

@@ -1,40 +1,62 @@
-import { useState as o, useEffect as u } from "react";
-const c = 400, m = (e) => e || "end", f = (e, t) => {
-  const n = e && t !== "full";
+import { useState as c, useEffect as m, useCallback as f } from "react";
+const a = 400, I = (s) => s || "end", A = (s, t) => {
+  const r = s && t !== "full";
   return {
-    showDivider: n,
-    dividerBefore: n && t !== "start" && t !== "bottom",
-    dividerAfter: n && t === "start"
+    showDivider: r,
+    dividerBefore: r && t !== "start" && t !== "bottom",
+    dividerAfter: r && t === "start"
   };
-}, I = (e, t) => {
-  const [n, i] = o(void 0), [a, s] = o(e !== !1);
-  return u(() => {
+}, v = (s) => s === "escape-key" ? "escapeKey" : s === "outside-press" ? "outsidePress" : "programmatic", P = (s, t) => {
+  const r = f(
+    (u) => {
+      if (!s) {
+        t == null || t(!1);
+        return;
+      }
+      const e = s(u);
+      e instanceof Promise ? e.then((i) => {
+        i && (t == null || t(!1));
+      }).catch(() => {
+      }) : e && (t == null || t(!1));
+    },
+    [s, t]
+  ), l = f(
+    (u, e, i) => {
+      u ? t == null || t(!0) : r(v(i));
+    },
+    [t, r]
+  );
+  return { requestClose: r, handleOverlayOpenChange: l };
+}, S = (s, t) => {
+  const [r, l] = c(void 0), [u, e] = c(s !== !1);
+  return m(() => {
     if (!t) {
-      s(e !== !1), i(void 0);
+      e(s !== !1), l(void 0);
       return;
     }
-    if (e !== void 0)
-      if (e) {
-        s(!0), i("close");
-        let r;
-        const l = requestAnimationFrame(() => {
-          r = requestAnimationFrame(() => i("open"));
+    if (s !== void 0)
+      if (s) {
+        e(!0), l("close");
+        let i;
+        const d = requestAnimationFrame(() => {
+          i = requestAnimationFrame(() => l("open"));
         });
         return () => {
-          cancelAnimationFrame(l), cancelAnimationFrame(r);
+          cancelAnimationFrame(d), cancelAnimationFrame(i);
         };
       } else {
-        i("close");
-        const r = setTimeout(() => {
-          s(!1), i(void 0);
-        }, c);
-        return () => clearTimeout(r);
+        l("close");
+        const i = setTimeout(() => {
+          e(!1), l(void 0);
+        }, a);
+        return () => clearTimeout(i);
       }
-  }, [t, e]), { inlineStatus: n, isInlineVisible: a };
+  }, [t, s]), { inlineStatus: r, isInlineVisible: u };
 };
 export {
-  c as PANEL_TRANSITION_DURATION_MS,
-  f as getPanelDividerState,
-  m as getResolvedPanelPosition,
-  I as useInlineTransition
+  a as PANEL_TRANSITION_DURATION_MS,
+  A as getPanelDividerState,
+  I as getResolvedPanelPosition,
+  S as useInlineTransition,
+  P as usePanelClose
 };

package/lib/wip/Panel/Panel.types.d.ts

@@ -4,6 +4,15 @@ export type PanelPosition = 'start' | 'end' | 'bottom' | 'full';
 export type PanelModalType = 'nonModal' | 'isModal' | 'alert';
 export type PanelSize = 'sm' | 'md' | 'lg' | 'full' | 'custom';
 export type PanelPadding = 'sm' | 'md';
+/**
+ * The reason a Panel close was requested via user interaction.
+ *
+ * - `'escapeKey'`    — user pressed Escape (overlay panels only)
+ * - `'outsidePress'` — user clicked outside the panel (overlay panels only)
+ * - `'closeButton'`  — user clicked the header close button
+ * - `'programmatic'` — close was triggered by another interaction not covered above
+ */
+export type PanelCloseReason = 'escapeKey' | 'outsidePress' | 'closeButton' | 'programmatic';
 interface BasePanelProps extends ComponentPropsWithoutRef<'aside'> {
     /**
      * Specify the content of the Panel
@@ -54,6 +63,31 @@ interface BasePanelProps extends ComponentPropsWithoutRef<'aside'> {
      * @default 'end'
      */
     position?: PanelPosition;
+    /**
+     * Called before the Panel closes due to a user interaction. Return `false` (or
+     * `Promise<false>`) to cancel the close — for example, when the panel contains
+     * a form with unsaved changes.
+     *
+     * This callback is **not** invoked when the `open` prop is changed programmatically
+     * by the parent; it only fires for UI-triggered close events (close button, Escape
+     * key, or outside press).
+     *
+     * @example
+     * ```tsx
+     * // Use a stateful confirmation dialog — avoid window.confirm (blocking, breaks iframes).
+     * // See the `onBeforeClose (Unsaved Changes Guard)` story for a full reference implementation.
+     * <Panel
+     *   onBeforeClose={(reason) => {
+     *     if (!isDirty) return true;
+     *     return new Promise(resolve => {
+     *       setResolveClose(() => resolve);
+     *       setShowConfirmDialog(true);
+     *     });
+     *   }}
+     * />
+     * ```
+     */
+    onBeforeClose?: (reason: PanelCloseReason) => boolean | Promise<boolean>;
 }
 export interface InlinePanelProps extends BasePanelProps {
     /**

package/lib/wip/Panel/index.d.ts

@@ -1,5 +1,5 @@
 export { Panel } from './Panel';
-export type { PanelProps, InlinePanelProps, OverlayPanelProps, PanelKind, PanelPosition, PanelModalType, PanelSize, PanelPadding, } from './Panel.types';
+export type { PanelProps, InlinePanelProps, OverlayPanelProps, PanelKind, PanelPosition, PanelModalType, PanelSize, PanelPadding, PanelCloseReason, } from './Panel.types';
 export type { PanelHeaderProps } from './Panel.Header';
 export type { PanelHeaderRowProps } from './Panel.Header.Row';
 export type { PanelHeaderContentBeforeProps } from './Panel.Header.ContentBefore';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viasat/beam-react",
-  "version": "2.10.2",
+  "version": "2.11.0",
   "description": "React component library for the Beam design system",
   "license": "MIT",
   "author": "Viasat",
@@ -59,11 +59,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@viasat/beam-fonts": "2.10.2",
-    "@viasat/beam-shared": "2.10.2",
-    "@viasat/beam-styles": "2.10.2",
-    "@viasat/beam-tokens": "2.10.2",
-    "@viasat/beam-icons": "2.10.2",
+    "@viasat/beam-fonts": "2.11.0",
+    "@viasat/beam-shared": "2.11.0",
+    "@viasat/beam-styles": "2.11.0",
+    "@viasat/beam-tokens": "2.11.0",
+    "@viasat/beam-icons": "2.11.0",
     "clsx": "^1.2.1",
     "@floating-ui/react": "^0.26.18",
     "@stepperize/react": "^5.1.5",