@elliemae/ds-global-header 3.70.0-next.61 → 3.70.0-next.63

package/dist/cjs/{utils/useCallbackAfterRender.js → parts/Toolbar/outOfTheBox/AppPicker/AppPickerCTX.js}

@@ -26,22 +26,13 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var useCallbackAfterRender_exports = {};
-__export(useCallbackAfterRender_exports, {
-  useCallbackAfterRender: () => useCallbackAfterRender
+var AppPickerCTX_exports = {};
+__export(AppPickerCTX_exports, {
+  AppPickerCtx: () => AppPickerCtx
 });
-module.exports = __toCommonJS(useCallbackAfterRender_exports);
+module.exports = __toCommonJS(AppPickerCTX_exports);
 var React = __toESM(require("react"));
 var import_react = require("react");
-const useCallbackAfterRender = (isLayout = false) => {
-  const lastRun = (0, import_react.useRef)(null);
-  const effect = (0, import_react.useMemo)(() => isLayout ? import_react.useLayoutEffect : import_react.useEffect, [isLayout]);
-  effect(() => {
-    lastRun.current?.();
-    lastRun.current = null;
-  });
-  return (callback) => {
-    lastRun.current = callback;
-  };
-};
-//# sourceMappingURL=useCallbackAfterRender.js.map
+const defaultContext = {};
+const AppPickerCtx = (0, import_react.createContext)(defaultContext);
+//# sourceMappingURL=AppPickerCTX.js.map

package/dist/cjs/parts/Toolbar/outOfTheBox/AppPicker/AppPickerCTX.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/parts/Toolbar/outOfTheBox/AppPicker/AppPickerCTX.tsx", "../../../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import { createContext } from 'react';\nimport type { useAppPickerCTX } from './useAppPickerCTX.js';\n\nexport interface AppPickerCTX extends ReturnType<typeof useAppPickerCTX> {}\n\n// `{} as AppPickerCTX` rather than `null`, matching DSAppPickerContext and DSGlobalHeaderContext: the\n// provider always wraps the consumers, so a nullable context would only buy every reader a null check\n// that can never be true.\nconst defaultContext = {} as AppPickerCTX;\n\nexport const AppPickerCtx = createContext<AppPickerCTX>(defaultContext);\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,mBAA8B;AAQ9B,MAAM,iBAAiB,CAAC;AAEjB,MAAM,mBAAe,4BAA4B,cAAc;",
+  "names": []
+}

package/dist/cjs/parts/Toolbar/outOfTheBox/AppPicker/AppPickerCTXRenderer.js

@@ -0,0 +1,43 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var AppPickerCTXRenderer_exports = {};
+__export(AppPickerCTXRenderer_exports, {
+  AppPickerCTXRenderer: () => AppPickerCTXRenderer
+});
+module.exports = __toCommonJS(AppPickerCTXRenderer_exports);
+var React = __toESM(require("react"));
+var import_jsx_runtime = require("react/jsx-runtime");
+var import_AppPickerRenderer = require("./AppPickerRenderer.js");
+var import_useAppPickerCTX = require("./useAppPickerCTX.js");
+var import_AppPickerCTX = require("./AppPickerCTX.js");
+const AppPickerCTXRenderer = (appPickerProps) => {
+  const appPickerCTX = (0, import_useAppPickerCTX.useAppPickerCTX)(appPickerProps);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_AppPickerCTX.AppPickerCtx.Provider, { value: appPickerCTX, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_AppPickerRenderer.AppPickerRenderer, {}) });
+};
+//# sourceMappingURL=AppPickerCTXRenderer.js.map

package/dist/cjs/parts/Toolbar/outOfTheBox/AppPicker/AppPickerCTXRenderer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/parts/Toolbar/outOfTheBox/AppPicker/AppPickerCTXRenderer.tsx", "../../../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import { AppPickerRenderer } from './AppPickerRenderer.js';\nimport type { AppPickerT } from './react-desc-prop-types.js';\nimport { useAppPickerCTX } from './useAppPickerCTX.js';\nimport { AppPickerCtx } from './AppPickerCTX.js';\n\nexport const AppPickerCTXRenderer = (appPickerProps: AppPickerT.Props): JSX.Element => {\n  const appPickerCTX = useAppPickerCTX(appPickerProps);\n\n  return (\n    <AppPickerCtx.Provider value={appPickerCTX}>\n      <AppPickerRenderer />\n    </AppPickerCtx.Provider>\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADUjB;AAVN,+BAAkC;AAElC,6BAAgC;AAChC,0BAA6B;AAEtB,MAAM,uBAAuB,CAAC,mBAAkD;AACrF,QAAM,mBAAe,wCAAgB,cAAc;AAEnD,SACE,4CAAC,iCAAa,UAAb,EAAsB,OAAO,cAC5B,sDAAC,8CAAkB,GACrB;AAEJ;",
+  "names": []
+}

package/dist/cjs/parts/Toolbar/outOfTheBox/AppPicker/AppPickerRenderer.js

@@ -0,0 +1,52 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var AppPickerRenderer_exports = {};
+__export(AppPickerRenderer_exports, {
+  AppPickerRenderer: () => AppPickerRenderer
+});
+module.exports = __toCommonJS(AppPickerRenderer_exports);
+var React = __toESM(require("react"));
+var import_jsx_runtime = require("react/jsx-runtime");
+var import_ds_app_picker = require("@elliemae/ds-app-picker");
+var import_react = __toESM(require("react"));
+var import_AppPickerCTX = require("./AppPickerCTX.js");
+var import_TriggerDefaultComponent = require("./TriggerDefaultComponent.js");
+const AppPickerRenderer = () => {
+  const { contractProps } = import_react.default.useContext(import_AppPickerCTX.AppPickerCtx);
+  const consumerOwnsTheTrigger = Boolean(contractProps.renderTrigger || contractProps.TriggerComponent);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    import_ds_app_picker.DSAppPicker,
+    {
+      openAndFocusOnArrowKeys: true,
+      ...consumerOwnsTheTrigger ? {} : { TriggerComponent: import_TriggerDefaultComponent.TriggerDefaultComponent },
+      ...contractProps
+    }
+  );
+};
+//# sourceMappingURL=AppPickerRenderer.js.map

package/dist/cjs/parts/Toolbar/outOfTheBox/AppPicker/AppPickerRenderer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/parts/Toolbar/outOfTheBox/AppPicker/AppPickerRenderer.tsx", "../../../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import { DSAppPicker } from '@elliemae/ds-app-picker';\nimport React from 'react';\nimport { AppPickerCtx } from './AppPickerCTX.js';\nimport { TriggerDefaultComponent } from './TriggerDefaultComponent.js';\n\nexport const AppPickerRenderer = (): JSX.Element => {\n  const { contractProps } = React.useContext(AppPickerCtx);\n\n  /*\n   * Our default trigger applies only when the consumer supplied neither trigger API.\n   *\n   * This one cannot be expressed by spread order, unlike every other default below. DSAppPicker's\n   * Trigger gives `TriggerComponent` precedence over `renderTrigger` (Trigger.tsx: \"TriggerComponent\n   * wins when both custom APIs are supplied\"), so passing ours unconditionally would silently discard a\n   * consumer's `renderTrigger` no matter where `contractProps` is spread \u2014 the spread would forward\n   * their prop faithfully and DSAppPicker would then ignore it. Deciding here instead keeps both custom\n   * trigger APIs working through the toolbar config.\n   */\n  const consumerOwnsTheTrigger = Boolean(contractProps.renderTrigger || contractProps.TriggerComponent);\n\n  return (\n    <DSAppPicker\n      // Dimsum IoC direction: our default renders first and the consumer's contract props are spread over\n      // it, so anything they put in `componentProps` wins and becomes theirs to own.\n      // `getDSAppPickerContractProps` drops keys explicitly set to undefined, so an unset key in the config\n      // never erases a default here.\n      //\n      // Note what is NOT passed: no `isOpen`, no `onKeyDown`, no `onClickOutside`. Passing `isOpen` makes\n      // the picker controlled and passing `onKeyDown` switches off its Escape routing and focus return \u2014\n      // either way this part would owe a reimplementation of behaviour DSAppPicker already has. See\n      // useAppPickerCTX for the full statement.\n      //\n      // The toolbar is a menubar, so ArrowDown/ArrowUp on a toolbar item open it \u2014 that is this widget's\n      // keyboard contract, not an application-level choice, which is why it is opted in here rather than\n      // left to each consumer. The picker owns the whole flow: it records the arrow-key activation and\n      // seeds focus on the selected app (first for ArrowDown, last for ArrowUp). Spread order still lets a\n      // consumer turn it off through `componentProps`.\n      openAndFocusOnArrowKeys\n      // `TriggerComponent`, not the deprecated `renderTrigger`: DSAppPicker renders this one as JSX so it\n      // gets its own fiber and may use hooks, and it is the only trigger API that receives the id the\n      // panel's aria-labelledby points at. See TriggerDefaultComponent for the full reasoning.\n      {...(consumerOwnsTheTrigger ? {} : { TriggerComponent: TriggerDefaultComponent })}\n      {...contractProps}\n    />\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADqBnB;AArBJ,2BAA4B;AAC5B,mBAAkB;AAClB,0BAA6B;AAC7B,qCAAwC;AAEjC,MAAM,oBAAoB,MAAmB;AAClD,QAAM,EAAE,cAAc,IAAI,aAAAA,QAAM,WAAW,gCAAY;AAYvD,QAAM,yBAAyB,QAAQ,cAAc,iBAAiB,cAAc,gBAAgB;AAEpG,SACE;AAAA,IAAC;AAAA;AAAA,MAgBC,yBAAuB;AAAA,MAItB,GAAI,yBAAyB,CAAC,IAAI,EAAE,kBAAkB,uDAAwB;AAAA,MAC9E,GAAG;AAAA;AAAA,EACN;AAEJ;",
+  "names": ["React"]
+}

package/dist/cjs/parts/Toolbar/outOfTheBox/AppPicker/TriggerDefaultComponent.js

@@ -0,0 +1,84 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var TriggerDefaultComponent_exports = {};
+__export(TriggerDefaultComponent_exports, {
+  TriggerDefaultComponent: () => TriggerDefaultComponent
+});
+module.exports = __toCommonJS(TriggerDefaultComponent_exports);
+var React = __toESM(require("react"));
+var import_jsx_runtime = require("react/jsx-runtime");
+var import_ds_icons = require("@elliemae/ds-icons");
+var import_ds_props_helpers = require("@elliemae/ds-props-helpers");
+var import_ds_system = require("@elliemae/ds-system");
+var import_react = __toESM(require("react"));
+var import_constants = require("../../../../constants/index.js");
+var import_styles = require("../../../styles.js");
+var import_AppPickerCTX = require("./AppPickerCTX.js");
+const TriggerDefaultComponent = ({
+  innerRef,
+  id,
+  onClick: appPickerOnClick,
+  onKeyDown: appPickerOnKeyDown,
+  "aria-haspopup": ariaHasPopup
+}) => {
+  const { triggerOnClick, setRef, triggerRef, label, otherProps, getOwnerPropsAwareOfPropsPassedToGlobalHeader } = import_react.default.useContext(import_AppPickerCTX.AppPickerCtx);
+  const handleTriggerRefs = import_react.default.useCallback(
+    (buttonRef) => {
+      setRef(buttonRef);
+      (0, import_ds_system.mergeRefs)(triggerRef, innerRef)(buttonRef);
+    },
+    [setRef, triggerRef, innerRef]
+  );
+  const handleOnClickComposed = import_react.default.useCallback(
+    (e) => {
+      appPickerOnClick(e);
+      triggerOnClick?.(e);
+    },
+    [appPickerOnClick, triggerOnClick]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    import_styles.StyledButton,
+    {
+      id,
+      onClick: handleOnClickComposed,
+      onKeyDown: appPickerOnKeyDown,
+      innerRef: handleTriggerRefs,
+      "aria-label": label,
+      "data-testid": import_constants.GLOBAL_HEADER_DATA_TESTID.MENUBAR_ITEM_BUTTON,
+      "aria-haspopup": ariaHasPopup,
+      ...(0, import_ds_props_helpers.getGlobalAttributes)(otherProps),
+      ...(0, import_ds_props_helpers.getXstyledProps)(otherProps),
+      type: "button",
+      getOwnerProps: getOwnerPropsAwareOfPropsPassedToGlobalHeader,
+      getOwnerPropsArguments: () => ({}),
+      children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_ds_icons.MenuPicker, { width: 20.73, height: 20.73 })
+    }
+  );
+};
+//# sourceMappingURL=TriggerDefaultComponent.js.map

package/dist/cjs/parts/Toolbar/outOfTheBox/AppPicker/TriggerDefaultComponent.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/parts/Toolbar/outOfTheBox/AppPicker/TriggerDefaultComponent.tsx", "../../../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import type { DSAppPickerT } from '@elliemae/ds-app-picker';\nimport { MenuPicker } from '@elliemae/ds-icons';\nimport { getGlobalAttributes, getXstyledProps } from '@elliemae/ds-props-helpers';\nimport { mergeRefs } from '@elliemae/ds-system';\nimport React from 'react';\nimport { GLOBAL_HEADER_DATA_TESTID } from '../../../../constants/index.js';\nimport { StyledButton } from '../../../styles.js';\nimport { AppPickerCtx } from './AppPickerCTX.js';\n\n/*\n * The toolbar's default App Picker trigger, as a real component with its own module.\n *\n * MUST be handed to DSAppPicker as `TriggerComponent`, never `renderTrigger`. Two reasons, both hard:\n *\n *   1. This component uses `useContext`. DSAppPicker renders `TriggerComponent` as JSX so React creates a\n *      fiber for it, which is what makes hooks here legal. `renderTrigger` is invoked as a plain function\n *      (`renderTrigger({ ref })`) to honour the legacy DSPopover render-prop contract, so any hook inside\n *      it registers against DSAppPicker's Trigger fiber instead \u2014 a rules-of-hooks violation React cannot\n *      detect at runtime.\n *   2. Only `TriggerComponent` receives `dialogLabelId`, the id the panel's `aria-labelledby` points at.\n *      It arrives as `id` and is applied below; drop it and the dialog has no accessible name.\n */\nexport const TriggerDefaultComponent = ({\n  innerRef,\n  id,\n  onClick: appPickerOnClick,\n  onKeyDown: appPickerOnKeyDown,\n  'aria-haspopup': ariaHasPopup,\n}: DSAppPickerT.TriggerComponentProps): JSX.Element => {\n  const { triggerOnClick, setRef, triggerRef, label, otherProps, getOwnerPropsAwareOfPropsPassedToGlobalHeader } =\n    React.useContext(AppPickerCtx);\n\n  /*\n   * Three refs on one node: the toolbar's arrow-key roving registration, a consumer-supplied `triggerRef`,\n   * and DSAppPicker's own \u2014 the last is what its focus return targets after a scoped Escape, so dropping\n   * `innerRef` here silently strands focus when the panel closes.\n   *\n   * No focus logic beyond that. Returning focus to this trigger is DSAppPicker's job and it does it, which\n   * is only true while this part supplies no `onKeyDown` to it \u2014 see useAppPickerCTX.\n   */\n  const handleTriggerRefs = React.useCallback(\n    (buttonRef: HTMLButtonElement) => {\n      setRef(buttonRef);\n      mergeRefs(triggerRef, innerRef)(buttonRef);\n    },\n    [setRef, triggerRef, innerRef],\n  );\n\n  /*\n   * DSAppPicker's `onClick` does the opening AND records whether the activation came from the keyboard\n   * (`e.detail === 0`), which is what lets it land focus on the selected app rather than the panel. It must\n   * always run.\n   *\n   * `triggerOnClick` is the consumer's own click callback and runs alongside it. It does not suppress the\n   * open: a consumer who needs to own the transition supplies `componentProps.isOpen`, which makes the\n   * picker controlled and renders its internal flip inert.\n   */\n  const handleOnClickComposed = React.useCallback(\n    (e: React.MouseEvent | React.KeyboardEvent) => {\n      appPickerOnClick(e);\n      triggerOnClick?.(e as React.MouseEvent<HTMLButtonElement>);\n    },\n    [appPickerOnClick, triggerOnClick],\n  );\n\n  return (\n    <StyledButton\n      id={id}\n      onClick={handleOnClickComposed}\n      onKeyDown={appPickerOnKeyDown}\n      innerRef={handleTriggerRefs}\n      aria-label={label}\n      data-testid={GLOBAL_HEADER_DATA_TESTID.MENUBAR_ITEM_BUTTON}\n      aria-haspopup={ariaHasPopup}\n      // No `aria-expanded`, matching DSAppPicker's own trigger. This one opens a `role=\"dialog\"`, and in\n      // the dialog pattern the open state is conveyed by the dialog's presence, not by an attribute on the\n      // control. The sibling toolbar items DO carry it correctly \u2014 `ds-popup-menu` opens a `role=\"menu\"`\n      // and `ds-search-toggle` expands an inline region, which are the patterns the attribute belongs to.\n      // Item-level global attributes land here, AFTER the handlers above, so an `onKeyDown` or `onClick`\n      // set directly on the toolbar entry replaces the one this trigger wired. That is the documented\n      // item-level override and `WithControlledAppPicker` relies on it \u2014 but note what an `onKeyDown`\n      // override costs now: it takes over `openAndFocusOnArrowKeys`, so the arrow keys stop opening the\n      // picker unless the consumer opens it themselves.\n      {...getGlobalAttributes(otherProps)}\n      // The part-level xstyled layer, which the contract advertises \u2014 this is the element that serves it.\n      {...getXstyledProps(otherProps)}\n      type=\"button\"\n      // Exposes the dsGlobalheaderMenubarItemButton slot on this trigger. Drop either prop and the slot\n      // goes silently inert \u2014 getPartProps returns {} without the lookup table and generates no\n      // data-dimsum-slot.\n      getOwnerProps={getOwnerPropsAwareOfPropsPassedToGlobalHeader}\n      // Explicit and empty: no render-time values worth handing to a function-form slot prop. Stated so\n      // \"what arguments does this slot get?\" always has a visible answer at the call site.\n      getOwnerPropsArguments={() => ({})}\n    >\n      <MenuPicker width={20.73} height={20.73} />\n    </StyledButton>\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;AD+FjB;AA9FN,sBAA2B;AAC3B,8BAAqD;AACrD,uBAA0B;AAC1B,mBAAkB;AAClB,uBAA0C;AAC1C,oBAA6B;AAC7B,0BAA6B;AAetB,MAAM,0BAA0B,CAAC;AAAA,EACtC;AAAA,EACA;AAAA,EACA,SAAS;AAAA,EACT,WAAW;AAAA,EACX,iBAAiB;AACnB,MAAuD;AACrD,QAAM,EAAE,gBAAgB,QAAQ,YAAY,OAAO,YAAY,8CAA8C,IAC3G,aAAAA,QAAM,WAAW,gCAAY;AAU/B,QAAM,oBAAoB,aAAAA,QAAM;AAAA,IAC9B,CAAC,cAAiC;AAChC,aAAO,SAAS;AAChB,sCAAU,YAAY,QAAQ,EAAE,SAAS;AAAA,IAC3C;AAAA,IACA,CAAC,QAAQ,YAAY,QAAQ;AAAA,EAC/B;AAWA,QAAM,wBAAwB,aAAAA,QAAM;AAAA,IAClC,CAAC,MAA8C;AAC7C,uBAAiB,CAAC;AAClB,uBAAiB,CAAwC;AAAA,IAC3D;AAAA,IACA,CAAC,kBAAkB,cAAc;AAAA,EACnC;AAEA,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,SAAS;AAAA,MACT,WAAW;AAAA,MACX,UAAU;AAAA,MACV,cAAY;AAAA,MACZ,eAAa,2CAA0B;AAAA,MACvC,iBAAe;AAAA,MAUd,OAAG,6CAAoB,UAAU;AAAA,MAEjC,OAAG,yCAAgB,UAAU;AAAA,MAC9B,MAAK;AAAA,MAIL,eAAe;AAAA,MAGf,wBAAwB,OAAO,CAAC;AAAA,MAEhC,sDAAC,8BAAW,OAAO,OAAO,QAAQ,OAAO;AAAA;AAAA,EAC3C;AAEJ;",
+  "names": ["React"]
+}

package/dist/cjs/parts/Toolbar/outOfTheBox/AppPicker/react-desc-prop-types.js

@@ -0,0 +1,50 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var react_desc_prop_types_exports = {};
+__export(react_desc_prop_types_exports, {
+  AppPickerPropTypes: () => AppPickerPropTypes,
+  AppPickerPropTypesSchema: () => AppPickerPropTypesSchema
+});
+module.exports = __toCommonJS(react_desc_prop_types_exports);
+var React = __toESM(require("react"));
+var import_ds_props_helpers = require("@elliemae/ds-props-helpers");
+const AppPickerPropTypes = {
+  ...import_ds_props_helpers.globalAttributesPropTypes,
+  ...import_ds_props_helpers.xstyledPropTypes,
+  label: import_ds_props_helpers.PropTypes.string.description("Accessible name for the trigger button, and the toolbar label").isRequired,
+  componentProps: import_ds_props_helpers.PropTypes.object.description(
+    "The consumer-authored DSAppPicker configuration; forwarded per DSAppPicker own contract via getDSAppPickerContractProps"
+  ).isRequired,
+  getOwnerPropsAwareOfPropsPassedToGlobalHeader: import_ds_props_helpers.PropTypes.func.description(
+    "Returns the props passed to DSGlobalHeader, so getPartProps can look up this slot consumer-supplied props. Must come from DSGlobalHeader; the function-form hydrator is supplied per slot render site instead"
+  ).signature("(() => Partial<DSGlobalHeaderT.DefaultProps> )").isRequired,
+  setRef: import_ds_props_helpers.PropTypes.func.description("Registers the trigger node with the toolbar focus management for arrow-key navigation").signature("(( ref: HTMLElement ) => void )").isRequired
+};
+const AppPickerPropTypesSchema = AppPickerPropTypes;
+//# sourceMappingURL=react-desc-prop-types.js.map

package/dist/cjs/parts/Toolbar/outOfTheBox/AppPicker/react-desc-prop-types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/parts/Toolbar/outOfTheBox/AppPicker/react-desc-prop-types.ts", "../../../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-empty-interface */\nimport type { DSPropTypesSchema, GlobalAttributesT, ValidationMap, XstyledProps } from '@elliemae/ds-props-helpers';\nimport { PropTypes, globalAttributesPropTypes, xstyledPropTypes } from '@elliemae/ds-props-helpers';\nimport type { DSGlobalHeaderT } from '../../../../react-desc-prop-types.js';\n\n/*\n * Relocated here from DSGlobalHeaderT.AppPickerProps, per the convention every other part in the repo\n * follows. Consumed by useAppPickerCTX / AppPickerCTXRenderer.\n *\n * This namespace describes what DSGlobalHeader passes DOWN to its own out-of-the-box App Picker\n * wrapper. It is NOT the shape an application developer authors \u2014 that is\n * DSGlobalHeaderT.ToolbarAppPickerItem (the toolbar config entry) and, inside it,\n * DSGlobalHeaderT.AppPickerComponentProps. The wrapper is an opinionated pre-configuration that\n * offloads work from the app developer onto Dimsum, so it generates props the developer never sees\n * (`setRef`, `getOwnerPropsAwareOfPropsPassedToGlobalHeader`) and is not meant to know about unless they\n * drop to atomic composition and render DSAppPicker themselves.\n *\n * The three IoC layers an out-of-the-box item is meant to expose are all present here:\n *   1. item-level global attributes, forwarded onto the rendered trigger\n *   2. the slot layer, via `getOwnerPropsAwareOfPropsPassedToGlobalHeader` (parent-owned slots \u2014 see the\n *      no-slots note below)\n *   3. `componentProps`, the wrapped component's own contract\n *\n * No slots of its own: every styled element this part renders is declared under the PARENT's name and\n * GLOBAL_HEADER_SLOTS, and those slot values are a published data-dimsum-slot / data-testid surface \u2014\n * re-declaring them here would change them, which the QA stability rule forbids. So, as with\n * ds-data-table-filters' FilterPopover, this file carries no PropsForGlobalOnSlots and no\n * getPropsPerSlotPropTypes. Consumers reach these slots through DSGlobalHeader, where they already do.\n *\n * KNOWN GAP (shared by all four out-of-the-box parts, no decision pending on this file) \u2014 `XstyledProps`\n * is declared below and `xstyledPropTypes` is spread into the schema, but no part forwards xstyled props\n * to any element. Global attributes ARE forwarded, via getGlobalAttributes in TriggerDefaultComponent.\n * The declaration comes from the part-generator template and the FilterPopover precedent; making it true\n * needs a styled target per part, which PopupMenu's bare-<div> root does not currently have.\n */\nexport declare namespace AppPickerT {\n  export interface RequiredProps {\n    /** Accessible name for the trigger, and the toolbar item's label. */\n    label: string;\n    /** The consumer-authored configuration object. Forwarded to DSAppPicker by its own contract. */\n    componentProps: DSGlobalHeaderT.AppPickerComponentProps;\n    /*\n     * The slot IoC layer, and the ONLY half of it that may be drilled down.\n     *\n     * `getPartProps` uses this as the lookup table: it indexes the returned object by the styled\n     * element's `data-dimsum-slot` (falling back to `data-testid`) to find the consumer's slot prop.\n     * That table can therefore only come from DSGlobalHeader, because only DSGlobalHeader holds the\n     * props the consumer passed \u2014 hence the deliberately verbose name. It is also what gates slot\n     * generation at all: `styledFunction` sets `didDefinedGetOwnerProps: !!getOwnerProps`, and\n     * `getPartProps` short-circuits to `{}` without it.\n     *\n     * Its former companion `getOwnerPropsArguments` is deliberately NOT here. That one is the hydrator\n     * for function-form slot props \u2014 `getPartProps` calls `elementProps(getOwnerPropsArguments())` and\n     * uses it for nothing else \u2014 so it must be defined by whichever element is rendering the slot,\n     * which is the only place that knows the render-time values worth passing. Bundling the two forced\n     * every slot in the package to share one hydrator; see ds-chat-bubble's ChatBubbleArrow and\n     * ds-fast-list's List for what per-site hydration is actually for.\n     */\n    getOwnerPropsAwareOfPropsPassedToGlobalHeader: () => Partial<DSGlobalHeaderT.DefaultProps>;\n    /** Focus-management registration, supplied by useGlobalHeaderToolbar for arrow-key navigation. */\n    setRef: (ref: HTMLElement) => void;\n  }\n\n  /*\n   * Intentionally empty, and intentionally still declared: `never` is a statement, not an oversight \u2014\n   * \"this part has no default props, do not expect them\". Keeping the member present preserves\n   * at-a-glance parity with every other part's namespace and makes adding a default a one-line change.\n   */\n  export interface DefaultProps {}\n\n  export interface OptionalProps {}\n\n  export interface Props\n    extends\n      Partial<DefaultProps>,\n      OptionalProps,\n      Omit<\n        GlobalAttributesT<HTMLButtonElement>,\n        // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents\n        keyof RequiredProps | keyof DefaultProps | keyof XstyledProps\n      >,\n      XstyledProps,\n      RequiredProps {}\n\n  export interface InternalProps\n    extends\n      DefaultProps,\n      OptionalProps,\n      Omit<\n        GlobalAttributesT<HTMLButtonElement>,\n        // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents\n        keyof RequiredProps | keyof DefaultProps | keyof XstyledProps\n      >,\n      XstyledProps,\n      RequiredProps {}\n}\n\nexport const AppPickerPropTypes: DSPropTypesSchema<AppPickerT.Props> = {\n  ...globalAttributesPropTypes,\n  ...xstyledPropTypes,\n  label: PropTypes.string.description('Accessible name for the trigger button, and the toolbar label').isRequired,\n  componentProps: PropTypes.object.description(\n    'The consumer-authored DSAppPicker configuration; forwarded per DSAppPicker own contract via getDSAppPickerContractProps',\n  ).isRequired,\n  getOwnerPropsAwareOfPropsPassedToGlobalHeader: PropTypes.func\n    .description(\n      'Returns the props passed to DSGlobalHeader, so getPartProps can look up this slot consumer-supplied props. Must come from DSGlobalHeader; the function-form hydrator is supplied per slot render site instead',\n    )\n    .signature('(() => Partial<DSGlobalHeaderT.DefaultProps> )').isRequired,\n  setRef: PropTypes.func\n    .description('Registers the trigger node with the toolbar focus management for arrow-key navigation')\n    .signature('(( ref: HTMLElement ) => void )').isRequired,\n};\n\nexport const AppPickerPropTypesSchema = AppPickerPropTypes as unknown as ValidationMap<AppPickerT.Props>;\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADEvB,8BAAuE;AA+FhE,MAAM,qBAA0D;AAAA,EACrE,GAAG;AAAA,EACH,GAAG;AAAA,EACH,OAAO,kCAAU,OAAO,YAAY,+DAA+D,EAAE;AAAA,EACrG,gBAAgB,kCAAU,OAAO;AAAA,IAC/B;AAAA,EACF,EAAE;AAAA,EACF,+CAA+C,kCAAU,KACtD;AAAA,IACC;AAAA,EACF,EACC,UAAU,gDAAgD,EAAE;AAAA,EAC/D,QAAQ,kCAAU,KACf,YAAY,uFAAuF,EACnG,UAAU,iCAAiC,EAAE;AAClD;AAEO,MAAM,2BAA2B;",
+  "names": []
+}

package/dist/cjs/parts/Toolbar/outOfTheBox/AppPicker/useAppPickerCTX.js

@@ -0,0 +1,64 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var useAppPickerCTX_exports = {};
+__export(useAppPickerCTX_exports, {
+  useAppPickerCTX: () => useAppPickerCTX
+});
+module.exports = __toCommonJS(useAppPickerCTX_exports);
+var React = __toESM(require("react"));
+var import_ds_app_picker = require("@elliemae/ds-app-picker");
+var import_react = __toESM(require("react"));
+const useAppPickerCTX = (config) => {
+  const { label, componentProps, getOwnerPropsAwareOfPropsPassedToGlobalHeader, setRef, ...otherProps } = config;
+  const { triggerRef, triggerOnClick } = componentProps;
+  const contractProps = import_react.default.useMemo(() => (0, import_ds_app_picker.getDSAppPickerContractProps)(componentProps), [componentProps]);
+  return import_react.default.useMemo(
+    () => ({
+      label,
+      componentProps,
+      otherProps,
+      getOwnerPropsAwareOfPropsPassedToGlobalHeader,
+      setRef,
+      contractProps,
+      triggerRef,
+      triggerOnClick
+    }),
+    [
+      label,
+      componentProps,
+      otherProps,
+      getOwnerPropsAwareOfPropsPassedToGlobalHeader,
+      setRef,
+      contractProps,
+      triggerRef,
+      triggerOnClick
+    ]
+  );
+};
+//# sourceMappingURL=useAppPickerCTX.js.map

package/dist/cjs/parts/Toolbar/outOfTheBox/AppPicker/useAppPickerCTX.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/parts/Toolbar/outOfTheBox/AppPicker/useAppPickerCTX.tsx", "../../../../../../../../../scripts/build/transpile/react-shim.js"],
+  "sourcesContent": ["import { getDSAppPickerContractProps } from '@elliemae/ds-app-picker';\nimport React from 'react';\nimport type { AppPickerT } from './react-desc-prop-types.js';\n\n/*\n * This part owns NO open/close state, and that is deliberate.\n *\n * DSAppPicker owns the whole flow: its trigger click toggles the panel, `openAndFocusOnArrowKeys` gives\n * it ArrowDown/ArrowUp, a scoped Escape closes it and returns focus to the trigger, and a click outside\n * closes it. Lifting `isOpen` into this part would make the picker CONTROLLED, which switches every one\n * of those off \u2014 they would then have to be reimplemented here, against a component that already has\n * them and is tested for them.\n *\n * Two knock-on effects, worth knowing before adding state back:\n *   - there is no `aria-expanded` on this item's trigger, so no open state is needed to feed one. The\n *     picker opens a `role=\"dialog\"`, and that pattern conveys open state by the dialog's presence. The\n *     sibling items keep the attribute because a menu and a disclosure region are what it is for.\n *   - supplying `onKeyDown` to DSAppPicker sets `closeOnEscape: !onKeyDown`, i.e. it switches OFF the\n *     picker's Escape routing AND its focus return. That is why this part supplies none, and why it needs\n *     no focus tracker of its own.\n *\n * A consumer can still drive it: `componentProps.isOpen` reaches DSAppPicker through the contract\n * passthrough and makes it controlled for them, which is the supported way to own the transition.\n */\nexport const useAppPickerCTX = (config: AppPickerT.Props) => {\n  // Read by name: only what this part needs for its own behaviour. `otherProps` is the item-level global\n  // attributes, which reach the trigger via getGlobalAttributes. Everything a consumer put in\n  // `componentProps` reaches DSAppPicker through `contractProps` instead \u2014 do not cherry-pick from\n  // componentProps here, that is what the contract filter is for.\n  const { label, componentProps, getOwnerPropsAwareOfPropsPassedToGlobalHeader, setRef, ...otherProps } = config;\n  const { triggerRef, triggerOnClick } = componentProps;\n\n  // `componentProps` is declared as DSAppPicker's own props plus this part's `triggerOnClick`, so every\n  // DSAppPicker prop a consumer puts there is part of the contract \u2014 including all nine slot props.\n  // Deriving the forwardable set from DSAppPicker's own contract is what keeps the two from drifting, and\n  // it strips the one key in that object that belongs to this part rather than to DSAppPicker:\n  // `triggerOnClick`. (`setRef` is a sibling field of `componentProps`, not inside it, so it never\n  // reaches the filter.)\n  const contractProps = React.useMemo(() => getDSAppPickerContractProps(componentProps), [componentProps]);\n\n  return React.useMemo(\n    () => ({\n      label,\n      componentProps,\n      otherProps,\n      getOwnerPropsAwareOfPropsPassedToGlobalHeader,\n      setRef,\n      contractProps,\n      triggerRef,\n      triggerOnClick,\n    }),\n    [\n      label,\n      componentProps,\n      otherProps,\n      getOwnerPropsAwareOfPropsPassedToGlobalHeader,\n      setRef,\n      contractProps,\n      triggerRef,\n      triggerOnClick,\n    ],\n  );\n};\n", "import * as React from 'react';\nexport { React };\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;ACAA,YAAuB;ADAvB,2BAA4C;AAC5C,mBAAkB;AAuBX,MAAM,kBAAkB,CAAC,WAA6B;AAK3D,QAAM,EAAE,OAAO,gBAAgB,+CAA+C,QAAQ,GAAG,WAAW,IAAI;AACxG,QAAM,EAAE,YAAY,eAAe,IAAI;AAQvC,QAAM,gBAAgB,aAAAA,QAAM,QAAQ,UAAM,kDAA4B,cAAc,GAAG,CAAC,cAAc,CAAC;AAEvG,SAAO,aAAAA,QAAM;AAAA,IACX,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": ["React"]
+}

package/dist/cjs/parts/Toolbar/outOfTheBox/PopupMenu/PopupMenu.js

@@ -38,13 +38,14 @@ var import_ds_props_helpers = require("@elliemae/ds-props-helpers");
 var import_react = require("react");
 var import_constants = require("../../../../constants/index.js");
 var import_styles = require("../../../styles.js");
+var import_styles2 = require("../../styles.js");
 var import_PopupMenuContent = require("./menuContent/PopupMenuContent.js");
 const PopupMenu = ({
   Icon,
   onClick,
   setRef,
   componentProps,
-  ownerProps,
+  getOwnerPropsAwareOfPropsPassedToGlobalHeader,
   ...otherProps
 }) => {
   const {
@@ -53,7 +54,9 @@ const PopupMenu = ({
     popupOnKeyPress,
     isOpen: userIsOpen,
     options,
-    closeOnClick
+    closeOnClick,
+    onOpen,
+    onClose
   } = componentProps;
   const { arrowStyles, floatingStyles, isOpen, refs, context, showTooltip, hideTooltip } = (0, import_ds_floating_context.useFloatingContext)({
     externallyControlledIsOpen: componentProps.isOpen,
@@ -65,29 +68,66 @@ const PopupMenu = ({
     // Gated internally on `isOpen`, so it only fires while open.
     onClickOutside: (event) => {
       onClickOutside(event);
-      if (userIsOpen === void 0) {
-        hideTooltip();
-        refs.reference?.focus();
-      }
-    }
+      if (userIsOpen === void 0) hideTooltip();
+    },
+    /*
+     * Passive notification, straight through from the floating context. Handed over rather than
+     * reimplemented because the hook is the only place that sees every transition: the trigger click and
+     * ArrowDown both go through `showTooltip`, and click-outside, Escape inside the menu and a
+     * closeOnClick item all go through `hideTooltip` — plus a controlled flip of `isOpen`, which no
+     * handler in this file observes at all.
+     *
+     * Notifying does NOT make the consumer responsible for the transition: this stays uncontrolled unless
+     * they also supply `isOpen`.
+     *
+     * The scoped-Escape caveat in the hook's docs does not apply here. A scoped Escape would route to
+     * `onEscape` instead of `onClose`, but that path needs `closeOnEscape`, which defaults to false and is
+     * not passed — Escape is handled inside PopupMenuContent and closes via `hideTooltip`, so it surfaces
+     * as a normal 'interaction' close. Passing `closeOnEscape` here later would silently punch a hole in
+     * `onClose` unless `onEscape` is wired at the same time.
+     */
+    /*
+     * Escape is the floating context's, not this part's. `closeOnEscape` closes the menu and
+     * `returnFocusToReference` puts focus back on the trigger — both were hand-rolled here before, in
+     * PopupMenuContent's per-item keydown and in a manual `.focus()`.
+     *
+     * Gated on being UNCONTROLLED, and that gate is load-bearing rather than tidy: the hook applies
+     * `returnFocusToReference` on a scoped Escape whichever side owns the open state. For a controlled
+     * consumer the close below is inert, so leaving it on would move focus to the trigger while their
+     * menu is still open — focus outside an open menu. A controlled consumer owns the close, so they own
+     * the Escape and the refocus with it.
+     */
+    closeOnEscape: userIsOpen === void 0,
+    returnFocusToReference: true,
+    /*
+     * A scoped Escape routes HERE and not to `onClose`, so the consumer's close notification has to be
+     * re-emitted or it silently stops reporting the most common keyboard close.
+     */
+    onEscape: (event) => {
+      hideTooltip();
+      onClose?.({ reason: "interaction", event, isControlled: userIsOpen !== void 0 });
+    },
+    onOpen,
+    onClose
   });
+  const openIntentRef = (0, import_react.useRef)("first");
   const handleOnKeyDown = (0, import_react.useCallback)(
     (e) => {
-      if (e.code === "ArrowDown") {
-        showTooltip();
+      if (e.code === "ArrowDown" || e.code === "ArrowUp") {
+        e.preventDefault();
+        openIntentRef.current = e.code === "ArrowUp" ? "last" : "first";
+        if (userIsOpen === void 0) showTooltip();
       }
       if (onKeyPress) onKeyPress(e);
     },
-    [onKeyPress, showTooltip]
+    [onKeyPress, showTooltip, userIsOpen]
   );
   const handleOnClose = (0, import_react.useCallback)(() => {
-    if (userIsOpen === void 0) {
-      hideTooltip();
-    }
-    refs.reference?.focus();
-  }, [hideTooltip, refs.reference, userIsOpen]);
+    if (userIsOpen === void 0) hideTooltip();
+  }, [hideTooltip, userIsOpen]);
   const handleTriggerOnClick = (0, import_react.useCallback)(
     (e) => {
+      openIntentRef.current = "first";
       if (userIsOpen === void 0) showTooltip(e);
       if (onClick) onClick(e);
     },
@@ -103,45 +143,56 @@ const PopupMenu = ({
     },
     [refs, setRef]
   );
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-      import_styles.StyledButton,
-      {
-        onClick: handleTriggerOnClick,
-        onKeyDown: handleOnKeyDown,
-        innerRef: handleRefs,
-        "data-testid": import_constants.GLOBAL_HEADER_DATA_TESTID.MENUBAR_ITEM_BUTTON,
-        "aria-haspopup": true,
-        "aria-expanded": userIsOpen ?? isOpen,
-        ...(0, import_ds_props_helpers.useGetGlobalAttributes)(otherProps),
-        type: "button",
-        ...ownerProps,
-        children: Icon && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Icon, { size: "m" })
-      }
-    ),
-    refs.reference ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
-      import_ds_floating_context.FloatingWrapper,
-      {
-        innerRef: refs.setFloating,
-        isOpen: userIsOpen ?? isOpen,
-        floatingStyles,
-        context,
-        children: [
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-            import_PopupMenuContent.PopupMenuContent,
-            {
-              options,
-              onItemClick: handleItemClick,
-              onClose: handleOnClose,
-              setIsOpen: hideTooltip,
-              popupOnKeyPress,
-              ownerProps
-            }
-          ),
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_ds_floating_context.PopoverArrow, { ...arrowStyles })
-        ]
-      }
-    ) : null
-  ] });
+  const noSlotArguments = (0, import_react.useCallback)(() => ({}), []);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+    import_styles2.StyledPopupMenuContainer,
+    {
+      "data-testid": import_constants.GLOBAL_HEADER_DATA_TESTID.MENUBAR_ITEM_POPUPMENU_CONTAINER,
+      getOwnerProps: getOwnerPropsAwareOfPropsPassedToGlobalHeader,
+      getOwnerPropsArguments: noSlotArguments,
+      ...(0, import_ds_props_helpers.useGetXstyledProps)(otherProps),
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          import_styles.StyledButton,
+          {
+            onClick: handleTriggerOnClick,
+            onKeyDown: handleOnKeyDown,
+            innerRef: handleRefs,
+            "data-testid": import_constants.GLOBAL_HEADER_DATA_TESTID.MENUBAR_ITEM_BUTTON,
+            "aria-haspopup": true,
+            "aria-expanded": userIsOpen ?? isOpen,
+            ...(0, import_ds_props_helpers.useGetGlobalAttributes)(otherProps),
+            type: "button",
+            getOwnerProps: getOwnerPropsAwareOfPropsPassedToGlobalHeader,
+            getOwnerPropsArguments: noSlotArguments,
+            children: Icon && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Icon, { size: "m" })
+          }
+        ),
+        refs.reference ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+          import_ds_floating_context.FloatingWrapper,
+          {
+            innerRef: refs.setFloating,
+            isOpen: userIsOpen ?? isOpen,
+            floatingStyles,
+            context,
+            children: [
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                import_PopupMenuContent.PopupMenuContent,
+                {
+                  options,
+                  onItemClick: handleItemClick,
+                  openIntent: openIntentRef.current,
+                  setIsOpen: hideTooltip,
+                  popupOnKeyPress,
+                  getOwnerPropsAwareOfPropsPassedToGlobalHeader
+                }
+              ),
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_ds_floating_context.PopoverArrow, { ...arrowStyles })
+            ]
+          }
+        ) : null
+      ]
+    }
+  );
 };
 //# sourceMappingURL=PopupMenu.js.map