@elliemae/ds-app-picker 3.70.0-next.6 → 3.70.0-next.60

package/dist/esm/parts/AppPanel.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/parts/AppPanel.tsx"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { Grid } from '@elliemae/ds-grid';\nimport { useFocusTrap } from '@elliemae/ds-hooks-focus-trap';\nimport { styled } from '@elliemae/ds-system';\nimport React, { memo, useCallback, useContext, useEffect } from 'react';\nimport {\n  APP_PICKER_REGION_FOCUSES,\n  DSAppPickerDataTestIds,\n  DSAppPickerName,\n  DSAppPickerSlots,\n} from '../constants/index.js';\nimport { DSAppPickerContext } from '../DSAppPickerCTX.js';\nimport { AppSection } from './AppSection.js';\nimport { StyledListItemFullRow } from './shared-styles.js';\n\nconst StyledWrapper = styled(Grid, { name: DSAppPickerName, slot: DSAppPickerSlots.ROOT })`\n  background-color: ${({ theme }) => theme.colors.neutral['000']};\n  min-width: 308px;\n  min-height: 110px;\n  max-height: 449px;\n  width: 308px;\n  overflow-y: auto;\n  overflow-x: hidden;\n  /* Baseline 2024: reserve scrollbar gutter so the layout doesn't shift between overflow/no-overflow.\n     Replaces a JS isOverflow detection effect that toggled right padding. */\n  scrollbar-gutter: stable;\n  margin: 0;\n  padding: 0 0 8px 16px;\n  &:focus {\n    outline: none;\n  }\n`;\n\nconst StyledSeparator = styled('hr', { name: DSAppPickerName, slot: DSAppPickerSlots.SEPARATOR })`\n  border-top: 1px solid ${({ theme }) => theme.colors.neutral[300]};\n  border-bottom: none;\n  width: 100%;\n  margin: 8px 0 0 0;\n`;\n\nconst wrapperGridLayout = {\n  cols: ['repeat(3, 92px)'],\n  // Row tracks are intentionally auto-sized:\n  // - title row picks up its own typography height\n  // - chip rows expand when `wrapText` causes a chip to wrap onto a second line (Reflow story)\n  // - separator row picks up its own 1px height + margin\n  rows: ['auto'],\n};\n\nconst useExecOnceAfterFirstRender = (callback: () => void) => {\n  const hasExecutedRef = React.useRef(false);\n  const executeInitialFocusRef = React.useRef(callback);\n  executeInitialFocusRef.current = callback;\n  useEffect(() => {\n    if (!hasExecutedRef.current) {\n      executeInitialFocusRef.current();\n      hasExecutedRef.current = true;\n    }\n  }, []);\n};\n\ntype MountedOpenAutofocusNuanceConfig = {\n  pendingRef: React.MutableRefObject<boolean>;\n  triggerIsInternal: boolean;\n  trackFocusPanel: () => void;\n  trackFocusFirstItem: () => void;\n};\n\n/**\n * NUANCE \u2014 the single case that initial-focus-on-open (useAppPickerFloatingContext's onOpen) cannot\n * cover: DSAppPicker rendered ALREADY open (declarative `isOpen` at mount, no user interaction).\n * That open is not a transition, so `onOpen` never fires for it. This mount-time hook seeds the same\n * initial focus a user-driven open would (panel wrapper for the internal trigger, first item for an\n * external renderTrigger). `pendingRef` is true only when the component started open and is flipped\n * false on first consume, so a later controlled reopen \u2014 a real transition handled by `onOpen` \u2014\n * does not double-seed. Every user-driven open (click/keyboard) is a transition handled by `onOpen`,\n * NOT here.\n *\n * REMOVABILITY: if the team decides declarative-open should not autofocus, delete this hook and its\n * call, and flip the \"rendered already-open \u2026 focuses the panel wrapper\" assertion in\n * DSAppPicker.keyboard.test.js. Nothing else depends on it.\n */\nconst useMountedOpenAutofocusNuance = ({\n  pendingRef,\n  triggerIsInternal,\n  trackFocusPanel,\n  trackFocusFirstItem,\n}: MountedOpenAutofocusNuanceConfig) => {\n  useExecOnceAfterFirstRender(() => {\n    if (!pendingRef.current) return;\n    pendingRef.current = false;\n    if (triggerIsInternal) trackFocusPanel();\n    else trackFocusFirstItem();\n  });\n};\n\nconst AppPanelBase = () => {\n  const {\n    propsWithDefault: { customApps, renderTrigger, onKeyDown },\n    ownerPropsConfig,\n    globalAttributes,\n    xstyledProps,\n    mountedOpenAutofocusPendingRef,\n    focusTrackers: { focusRegion, firstFocusableRef, lastFocusableRef, trackFocusPanel, trackFocusFirstItem },\n  } = useContext(DSAppPickerContext);\n  const triggerIsInternal = !renderTrigger;\n\n  // Global attributes are spread onto the panel root because there is no shared wrapper that\n  // contains both the floating panel and the trigger. `wrap`, `onClick`, and `onKeyDown` are\n  // filtered out because they collide with the public component API (which uses these for\n  // different semantics).\n  const { wrap, onClick, onKeyDown: onKeyDownGlobal, ...safeGlobalAttributes } = globalAttributes;\n\n  // ---------------------------------------------------------------------------\n  // Initial focus on panel open.\n  // ---------------------------------------------------------------------------\n  // User-driven opens (click/keyboard) are open transitions, seeded by\n  // useAppPickerFloatingContext's onOpen. The one case that isn't a transition \u2014 being rendered\n  // already-open (declarative `isOpen` at mount) \u2014 is covered here, scoped to exactly that.\n  useMountedOpenAutofocusNuance({\n    pendingRef: mountedOpenAutofocusPendingRef,\n    triggerIsInternal,\n    trackFocusPanel,\n    trackFocusFirstItem,\n  });\n\n  // ---------------------------------------------------------------------------\n  // Panel wrapper \u2014 tracker-driven focus for the mouse-open announcement path.\n  // handleWrapperRef gets a new reference when isWrapperFocused changes \u2192 React\n  // re-invokes the callback with the DOM node \u2192 node.focus() fires.\n  // ---------------------------------------------------------------------------\n  const isWrapperFocused = focusRegion === APP_PICKER_REGION_FOCUSES.PANEL;\n\n  const handleWrapperRef = useCallback(\n    (node: HTMLElement | null) => {\n      if (node && isWrapperFocused) node.focus();\n    },\n    [isWrapperFocused],\n  );\n\n  // Default Escape-close/refocus is handled declaratively by useFloatingContext\n  // (see useAppPickerFloatingContext's closeOnEscape/onEscape wiring) whenever there is no consumer\n  // onKeyDown \u2014 a consumer-provided onKeyDown takes over keydown handling entirely.\n  const handleOnKeyDown = useFocusTrap({\n    firstElementRef: firstFocusableRef,\n    lastElementRef: lastFocusableRef,\n    onKeyDown,\n  });\n\n  // The panel root carries NO aria-label: it is a roleless element (generic role does not support\n  // an accessible name, so any label here is dropped by assistive tech). The component's accessible\n  // name lives on the dialog \u2014 see AppPickerContent's role=\"dialog\" + aria-labelledby.\n  return (\n    <StyledWrapper\n      innerRef={handleWrapperRef}\n      data-testid={DSAppPickerDataTestIds.ROOT}\n      cols={wrapperGridLayout.cols}\n      rows={wrapperGridLayout.rows}\n      // when opening the dialog via mouse, the focus is programmatically assigned here via handleWrapperRef, -1 allows .focus() to work\n      tabIndex={-1}\n      {...ownerPropsConfig}\n      {...safeGlobalAttributes}\n      {...xstyledProps}\n      onKeyDown={handleOnKeyDown}\n    >\n      <AppSection />\n      {customApps.length > 0 && (\n        <>\n          <StyledListItemFullRow data-testid={DSAppPickerDataTestIds.ROW} {...ownerPropsConfig}>\n            <StyledSeparator data-testid={DSAppPickerDataTestIds.SEPARATOR} {...ownerPropsConfig} />\n          </StyledListItemFullRow>\n          <AppSection isCustomApps />\n        </>\n      )}\n    </StyledWrapper>\n  );\n};\n\nexport const AppPanel = memo(AppPanelBase);\nAppPanel.displayName = 'DSAppPicker.AppPanel';\n"],
+  "mappings": "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",
+  "names": ["React"]
+}

package/dist/esm/parts/AppPickerFloatingContext/AppPickerContent.js

@@ -0,0 +1,64 @@
+import * as React from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { FloatingWrapper, PopoverArrow } from "@elliemae/ds-floating-context";
+import { styled } from "@elliemae/ds-system";
+import { useContext } from "react";
+import { DSAppPickerName, DSAppPickerSlots } from "../../constants/index.js";
+import { DSAppPickerContext } from "../../DSAppPickerCTX.js";
+import { AppPanel } from "../AppPanel.js";
+import { Trigger } from "../Trigger.js";
+import { useAppPickerFloatingContext } from "./useAppPickerFloatingContext.js";
+const StyledAppPickerFloating = styled(FloatingWrapper, {
+  name: DSAppPickerName,
+  slot: DSAppPickerSlots.FLOATING_WRAPPER
+})``;
+const AppPickerContent = () => {
+  const {
+    ownerPropsConfig,
+    propsWithDefault,
+    focusTrackers,
+    wasOpenedByKeyboardRef,
+    resolvedIsOpen,
+    setInternalIsOpen,
+    instanceUid
+  } = useContext(DSAppPickerContext);
+  const { floatingStyles, arrowStyles, floatingContext, floatingInnerRef, handleTriggerRef, handleTriggerClick } = useAppPickerFloatingContext({
+    propsWithDefault,
+    focusTrackers,
+    wasOpenedByKeyboardRef,
+    resolvedIsOpen,
+    setInternalIsOpen
+  });
+  const dialogLabelId = `${instanceUid}-dialog-trigger-btn`;
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(
+      Trigger,
+      {
+        handleTriggerRef,
+        handleTriggerClick,
+        dialogLabelId
+      }
+    ),
+    /* @__PURE__ */ jsxs(
+      StyledAppPickerFloating,
+      {
+        innerRef: floatingInnerRef,
+        isOpen: resolvedIsOpen,
+        floatingStyles,
+        context: floatingContext,
+        getOwnerProps: ownerPropsConfig.getOwnerProps,
+        getOwnerPropsArguments: ownerPropsConfig.getOwnerPropsArguments,
+        role: "dialog",
+        "aria-labelledby": dialogLabelId,
+        children: [
+          /* @__PURE__ */ jsx(AppPanel, {}),
+          /* @__PURE__ */ jsx(PopoverArrow, { ...arrowStyles })
+        ]
+      }
+    )
+  ] });
+};
+export {
+  AppPickerContent
+};
+//# sourceMappingURL=AppPickerContent.js.map

package/dist/esm/parts/AppPickerFloatingContext/AppPickerContent.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../scripts/build/transpile/react-shim.js", "../../../../src/parts/AppPickerFloatingContext/AppPickerContent.tsx"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { FloatingWrapper, PopoverArrow } from '@elliemae/ds-floating-context';\nimport { styled } from '@elliemae/ds-system';\nimport React, { useContext } from 'react';\nimport { DSAppPickerName, DSAppPickerSlots } from '../../constants/index.js';\nimport { DSAppPickerContext } from '../../DSAppPickerCTX.js';\nimport type { DSAppPickerT } from '../../react-desc-prop-types.js';\nimport { AppPanel } from '../AppPanel.js';\nimport { Trigger } from '../Trigger.js';\nimport { useAppPickerFloatingContext } from './useAppPickerFloatingContext.js';\n\nconst StyledAppPickerFloating = styled(FloatingWrapper, {\n  name: DSAppPickerName,\n  slot: DSAppPickerSlots.FLOATING_WRAPPER,\n})``;\n\nexport const AppPickerContent: React.ComponentType<DSAppPickerT.Props> = () => {\n  const {\n    ownerPropsConfig,\n    propsWithDefault,\n    focusTrackers,\n    wasOpenedByKeyboardRef,\n    resolvedIsOpen,\n    setInternalIsOpen,\n    instanceUid,\n  } = useContext(DSAppPickerContext);\n  const { floatingStyles, arrowStyles, floatingContext, floatingInnerRef, handleTriggerRef, handleTriggerClick } =\n    useAppPickerFloatingContext({\n      propsWithDefault,\n      focusTrackers,\n      wasOpenedByKeyboardRef,\n      resolvedIsOpen,\n      setInternalIsOpen,\n    });\n\n  const dialogLabelId = `${instanceUid}-dialog-trigger-btn`;\n\n  return (\n    <>\n      <Trigger\n        handleTriggerRef={handleTriggerRef}\n        handleTriggerClick={handleTriggerClick}\n        dialogLabelId={dialogLabelId}\n      />\n      <StyledAppPickerFloating\n        innerRef={floatingInnerRef}\n        isOpen={resolvedIsOpen}\n        floatingStyles={floatingStyles}\n        context={floatingContext}\n        getOwnerProps={ownerPropsConfig.getOwnerProps}\n        getOwnerPropsArguments={ownerPropsConfig.getOwnerPropsArguments}\n        role=\"dialog\"\n        aria-labelledby={dialogLabelId}\n      >\n        <AppPanel />\n        <PopoverArrow {...arrowStyles} />\n      </StyledAppPickerFloating>\n    </>\n  );\n};\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACqCnB,mBACE,KAKA,YANF;AArCJ,SAAS,iBAAiB,oBAAoB;AAC9C,SAAS,cAAc;AACvB,SAAgB,kBAAkB;AAClC,SAAS,iBAAiB,wBAAwB;AAClD,SAAS,0BAA0B;AAEnC,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,mCAAmC;AAE5C,MAAM,0BAA0B,OAAO,iBAAiB;AAAA,EACtD,MAAM;AAAA,EACN,MAAM,iBAAiB;AACzB,CAAC;AAEM,MAAM,mBAA4D,MAAM;AAC7E,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI,WAAW,kBAAkB;AACjC,QAAM,EAAE,gBAAgB,aAAa,iBAAiB,kBAAkB,kBAAkB,mBAAmB,IAC3G,4BAA4B;AAAA,IAC1B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAEH,QAAM,gBAAgB,GAAG,WAAW;AAEpC,SACE,iCACE;AAAA;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA;AAAA,QACA;AAAA;AAAA,IACF;AAAA,IACA;AAAA,MAAC;AAAA;AAAA,QACC,UAAU;AAAA,QACV,QAAQ;AAAA,QACR;AAAA,QACA,SAAS;AAAA,QACT,eAAe,iBAAiB;AAAA,QAChC,wBAAwB,iBAAiB;AAAA,QACzC,MAAK;AAAA,QACL,mBAAiB;AAAA,QAEjB;AAAA,8BAAC,YAAS;AAAA,UACV,oBAAC,gBAAc,GAAG,aAAa;AAAA;AAAA;AAAA,IACjC;AAAA,KACF;AAEJ;",
+  "names": []
+}

package/dist/esm/parts/AppPickerFloatingContext/useAppPickerFloatingContext.js

@@ -0,0 +1,141 @@
+import * as React from "react";
+import { useFloatingContext } from "@elliemae/ds-floating-context";
+import { useCallback, useMemo, useRef } from "react";
+const useAppPickerFloatingContext = (appPickerConfig) => {
+  const { propsWithDefault, focusTrackers, wasOpenedByKeyboardRef, resolvedIsOpen, setInternalIsOpen } = appPickerConfig;
+  const { onOpen, onClose, actionRef, onClick, onClickOutside, onKeyDown, triggerRef, renderTrigger, isOpen } = propsWithDefault;
+  const triggerIsInternal = !renderTrigger;
+  const isControlled = typeof isOpen === "boolean";
+  const { trackFocusSelectedItem, trackFocusItemAtIndex, trackFocusPanel, trackFocusFirstItem } = focusTrackers;
+  const defaultTriggerRef = useRef(null);
+  const handleClickOutside = useCallback(
+    (e) => {
+      if (!isControlled) onClose?.({ reason: "click-outside", event: e });
+      setInternalIsOpen(false);
+      onClickOutside?.(e);
+    },
+    [isControlled, onClose, setInternalIsOpen, onClickOutside]
+  );
+  const handleScopedEscape = useCallback(
+    (event) => {
+      if (!isControlled) onClose?.({ reason: "escape", event });
+      setInternalIsOpen(false);
+    },
+    [isControlled, onClose, setInternalIsOpen]
+  );
+  const handleFloatingClose = useCallback(
+    (info) => {
+      if (info.reason === "controlled-flip" && isControlled) onClose?.({ reason: "controlled" });
+    },
+    [isControlled, onClose]
+  );
+  const handleFloatingOpen = useCallback(
+    (info) => {
+      if (wasOpenedByKeyboardRef.current && triggerIsInternal) trackFocusSelectedItem();
+      else if (triggerIsInternal) trackFocusPanel();
+      else trackFocusFirstItem();
+      if (info.reason === "controlled-flip" && isControlled) onOpen?.({ reason: "controlled" });
+    },
+    [
+      wasOpenedByKeyboardRef,
+      triggerIsInternal,
+      trackFocusSelectedItem,
+      trackFocusPanel,
+      trackFocusFirstItem,
+      isControlled,
+      onOpen
+    ]
+  );
+  const floatingContextConfig = useMemo(
+    () => ({
+      placement: "bottom",
+      // Arrow tip is ~6.1px above the panel top (arrowPlacementBase16 ≈ 17.5px, tip at 11.4px from box top).
+      // 4px spec gap → 4 + 6.1 ≈ 10px offset.
+      customOffset: [0, 10],
+      externallyControlledIsOpen: resolvedIsOpen,
+      withoutAnimation: true,
+      onClickOutside: handleClickOutside,
+      // closeOnEscape = !onKeyDown: with a consumer onKeyDown, useFloatingContext neither routes
+      // the Escape to onEscape (see handleScopedEscape) nor returns focus to the trigger — the
+      // consumer's onKeyDown owns the key entirely.
+      closeOnEscape: !onKeyDown,
+      onClose: handleFloatingClose,
+      onEscape: handleScopedEscape,
+      onOpen: handleFloatingOpen,
+      returnFocusToReference: true,
+      externalReferenceElement: triggerRef?.current || defaultTriggerRef.current
+    }),
+    [
+      handleClickOutside,
+      handleScopedEscape,
+      handleFloatingClose,
+      handleFloatingOpen,
+      onKeyDown,
+      resolvedIsOpen,
+      triggerRef
+    ]
+  );
+  const {
+    refs: floatingRefs,
+    floatingStyles,
+    arrowStyles,
+    context: floatingContext
+  } = useFloatingContext(floatingContextConfig);
+  const handleTriggerRef = useCallback(
+    (node) => {
+      defaultTriggerRef.current = node;
+      floatingRefs.setReference(node);
+      if (triggerRef) {
+        triggerRef.current = node;
+      }
+    },
+    [floatingRefs, triggerRef]
+  );
+  const handleActionRef = useCallback(
+    (node) => {
+      if (node && actionRef?.current) {
+        actionRef.current.focusToIndex = (index) => {
+          trackFocusItemAtIndex(index);
+        };
+        actionRef.current.focusWrapper = () => {
+          trackFocusPanel();
+        };
+        actionRef.current.focusSelectedOrFirstAvailable = () => {
+          trackFocusSelectedItem();
+        };
+      }
+    },
+    [actionRef, trackFocusItemAtIndex, trackFocusPanel, trackFocusSelectedItem]
+  );
+  const floatingInnerRef = useCallback(
+    (node) => {
+      floatingRefs.setFloating(node);
+      handleActionRef(node);
+    },
+    [floatingRefs.setFloating, handleActionRef]
+  );
+  const handleTriggerClick = useCallback(
+    (e) => {
+      wasOpenedByKeyboardRef.current = e.detail === 0;
+      onClick?.(e);
+      if (!isControlled) {
+        if (resolvedIsOpen) onClose?.({ reason: "trigger-toggle", event: e });
+        else onOpen?.({ reason: "trigger", event: e });
+      }
+      setInternalIsOpen((prev) => !prev);
+    },
+    [onClick, wasOpenedByKeyboardRef, setInternalIsOpen, isControlled, resolvedIsOpen, onClose, onOpen]
+  );
+  return {
+    floatingStyles,
+    arrowStyles,
+    floatingContext,
+    handleTriggerRef,
+    handleTriggerClick,
+    floatingInnerRef
+  };
+};
+export {
+  useAppPickerFloatingContext
+};
+//# sourceMappingURL=useAppPickerFloatingContext.js.map

package/dist/esm/parts/AppPickerFloatingContext/useAppPickerFloatingContext.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../scripts/build/transpile/react-shim.js", "../../../../src/parts/AppPickerFloatingContext/useAppPickerFloatingContext.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { useFloatingContext, type DSHookFloatingContextT } from '@elliemae/ds-floating-context';\nimport type React from 'react';\nimport { useCallback, useMemo, useRef } from 'react';\nimport type { useAppPicker } from '../../config/useAppPicker.js';\nimport type { DSAppPickerT } from '../../react-desc-prop-types.js';\n\n/**\n * useAppPickerFloatingContext \u2014 the single point that wires DSAppPicker to\n * `@elliemae/ds-floating-context`'s `useFloatingContext`.\n *\n * WHAT IT DOES (as a black box):\n * AppPicker can be used in two very different ways:\n *  - Controlled: the consumer supplies `isOpen` and drives the open/close transition.\n *          \u2514\u2192 AppPicker can't be event-based as the flip might originate from any cause and we don't own the business logic\n *                  \u2514\u2192 we need to ensure WCAG embedded behaviours (focus, Escape, click-outside) are wired to the consumer's `isOpen` flip.\n *  - Uncontrolled: the consumer does not supply `isOpen` and AppPicker owns the full flows, we only notify the consumer of the transition and its cause.\n *\n * The AppPicker and this file in particular serves as the one place that coordinates the two different ways to use the component and wires with the useFloatingContext hook.\n * This files owns:\n *  - Focus management relative to open/close transitions (initial focus on open, return focus to trigger on close)\n *  - Escape key handling (scoped to the panel and trigger)\n *  - Click-outside handling (panel and trigger)\n *  - Imperative focus API via actionRef\n *  - Controlled/Uncontrolled forks and differences in event notification (eager vs controlled-flip)\n *  - OnOpen and OnClose notification to the consumer with the correct reason and event (if any)\n *\n * IMPORTANT:\n *  Parts of the flow/logic required in this file is offloaded to useFloatingContext internal assumptions and logics.\n *  Changes to useFloatingContext may break the flows in this file, or alter them in ways that are not obvious, the two are closely coupled.\n *\n * DATA / EVENT FLOW\n *\n * Two concerns run in parallel and must not be conflated: (A) what makes the panel show/hide and take\n * focus, and (B) how the consumer is told it opened/closed. They have different origins.\n *\n * (A) PANEL VISIBILITY + FOCUS \u2014  useFloatingContext internal co-ownership of the flow.\n *\n *                a user action                          \u2502 \u2502                      isOpen prop flip\n *    (trigger click / scoped Escape / click outside)    \u2502 \u2502   (not a traceable user action, but the consumer's own flip)\n *      uncontrolled - flips the internal flag           \u2502 \u2502 controlled - AppPicker's own flip is inert, consumer drives it\n *                                                        \u2502\n *                                                        \u25BC\n *                                              resolvedIsOpen changes\n *                                                        \u2502\n *                                                        \u25BC\n *                        useFloatingContext (externallyControlledIsOpen) detects the transition\n *                                                        \u2502\n *                                                        \u25BC\n *                     on open                           \u2502 \u2502              on close\n *                handleFloatingOpen                     \u2502 \u2502   focus is only restored after a SCOPED ESCAPE:\n *  AppPicker business logic seeds initial focus         \u2502 \u2502   useFloatingContext returns focus to the trigger\n *                                                        \u2502 \u2502   (returnFocusToReference). Click-outside / toggle\n *                                                        \u2502 \u2502   / controlled closes do NOT move focus, and\n *                                                        \u2502 \u2502   handleFloatingClose only NOTIFIES (see (B)).\n *                                                        \u2502\n *                                                        \u25BC\n *                          \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n *                          \u2502  visibility + focus are delivered to final user as expected \u2502\n *                          \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n *\n * (B) CONSUMER NOTIFICATION\n *   Each flow below is the UNCONTROLLED path, where AppPicker owns the transition and can name the true cause.\n *   The controlled equivalent for every trigger is stated once at the end.\n *                            \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n *                            \u2502 OPENING TRIGGERS FLOWS \u2502\n *                            \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n * TRIGGER CLICK (uncontrolled)\n *                                    trigger click\n *                       user clicks the internal trigger, panel closed\n *                                          \u2502\n *                                          \u25BC\n *                                 handleTriggerClick\n *               ( flips the flag and wires the visual and focus Flow (A) above )\n *                                          \u2502\n *                                          \u25BC\n *                 \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n *                 \u2502  onOpen { reason: 'trigger', event }         \u2502   fired EAGERLY, when the event is triggered\n *                 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n * ------------------------------------------------------------------------------------------------------------------------\n *                            \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n *                            \u2502 CLOSING TRIGGERS FLOWS \u2502\n *                            \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n * KEYBOARD ESCAPE (uncontrolled)\n *                       Escape within the panel DOM tree or the trigger\n *            scoped Escape (routed only while closeOnEscape, i.e. no consumer onKeyDown)\n *                                          \u2502\n *                                          \u25BC\n *                                onEscape \u2192 handleScopedEscape\n *               ( flips the flag and wires the visual and focus Flow (A) above )\n *                                          \u2502\n *                                          \u25BC\n *                 \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n *                 \u2502  onClose { reason: 'escape', event }         \u2502   fired EAGERLY, when the event is triggered\n *                 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n *\n *  CLICK OUTSIDE (uncontrolled)\n *                           Click outside the panel DOM tree and the trigger\n *                useFloatingContext detects a pointer press outside the panel + trigger\n *                                          \u2502\n *                                          \u25BC\n *                                   handleClickOutside\n *               ( flips the flag and wires the visual and focus Flow (A) above )\n *                                          \u2502\n *                                          \u25BC\n *                 \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n *                 \u2502  onClose { reason: 'click-outside', event }  \u2502   fired EAGERLY, when the event is triggered\n *                 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n *\n *  CLICK ON TRIGGER (uncontrolled, while internal state is open)\n *                              trigger click while open\n *                       user clicks the internal trigger, panel open\n *                                          \u2502\n *                                          \u25BC\n *                                    handleTriggerClick\n *               ( flips the flag and wires the visual and focus Flow (A) above )\n *                                          \u2502\n *                                          \u25BC\n *                 \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n *                 \u2502 onClose { reason: 'trigger-toggle', event }  \u2502   fired EAGERLY, when the event is triggered\n *                 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n * ------------------------------------------------------------------------------------------------------------------------\n *                            \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n *                            \u2502 CONTROLLED OPEN & CLOSE FLOWS    \u2502\n *                            \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n *   AppPicker's own flip is inert;\n *   We can't fire EAGERLY and we can't track an originating event, there may be NONE\n *   The consumer's `isOpen` flip is reacted to by useFloatingContext, which fires onOpen / onClose with reason 'controlled-flip'\n *   We wire the visual and focus Flow (A) above, and then notify the consumer with reason 'controlled' (no event)\n *                                          \u2502\n *                                          \u25BC\n *                 \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n *                 \u2502  onOpen  { reason: 'controlled' }            \u2502                    no event\n *                 \u2502  onClose { reason: 'controlled' }            \u2502   a prop flip is not a traceable user action\n *                 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n * ------------------------------------------------------------------------------------------------------------------------\n *\n *     Eager (uncontrolled) and controlled-flip paths are mutually exclusive on `isControlled`.\n *     the consumer is notified exactly once per transition \u2014 never twice.\n * On Escape specifically\n *   a controlled consumer supplies onKeyDown, so closeOnEscape is false in useFloatingContext\n *                   \u2514\u2192 AppPicker's onEscape never runs \u2014\n *                                   \u2514\u2192 the close arrives purely by listening to the flag transition\n * ------------------------------------------------------------------------------------------------------------------------\n * A nuance for an edge case:\n *\n * Declarative mount-open (rendered already-open).\n * useFloatingContext fires no onOpen for it (it did not transition to open, it started open),\n *    \u2514\u2192 neither the focus-seed (A) nor the notification (B) runs\n * AppPanel compensates this locally via useMountedOpenAutofocusNuance, it needs to be seen if this is even desired or should be removed\n * ------------------------------------------------------------------------------------------------------------------------\n */\n\ntype ConfiguredAppPickerCtx = ReturnType<typeof useAppPicker>;\n\ntype AppPickerFloatingContextConfig = {\n  propsWithDefault: DSAppPickerT.InternalProps;\n  focusTrackers: ConfiguredAppPickerCtx['focusTrackers'];\n  wasOpenedByKeyboardRef: ConfiguredAppPickerCtx['wasOpenedByKeyboardRef'];\n  // Open state is owned by useAppPicker (lifted so useFocusTracker can seed focus in the same fiber).\n  // This hook reads the resolved value for positioning and flips it through the setter to close/toggle.\n  resolvedIsOpen: ConfiguredAppPickerCtx['resolvedIsOpen'];\n  setInternalIsOpen: ConfiguredAppPickerCtx['setInternalIsOpen'];\n};\n\nexport const useAppPickerFloatingContext = (appPickerConfig: AppPickerFloatingContextConfig) => {\n  const { propsWithDefault, focusTrackers, wasOpenedByKeyboardRef, resolvedIsOpen, setInternalIsOpen } =\n    appPickerConfig;\n  const { onOpen, onClose, actionRef, onClick, onClickOutside, onKeyDown, triggerRef, renderTrigger, isOpen } =\n    propsWithDefault;\n  const triggerIsInternal = !renderTrigger;\n  // Controlled when the consumer supplies `isOpen`. This decides who owns a transition: uncontrolled,\n  // AppPicker's own handlers own it and report the specific event-carrying reason eagerly; controlled,\n  // AppPicker's own flips are inert and the consumer drives open/close via the prop (reason 'controlled').\n  const isControlled = typeof isOpen === 'boolean';\n\n  const { trackFocusSelectedItem, trackFocusItemAtIndex, trackFocusPanel, trackFocusFirstItem } = focusTrackers;\n\n  const defaultTriggerRef = useRef<HTMLButtonElement>(null);\n\n  // Uncontrolled close \u2014 see file header (B) \"CLICK OUTSIDE\". Also forwards the raw event to onClickOutside.\n  const handleClickOutside = useCallback(\n    (e: MouseEvent | TouchEvent) => {\n      if (!isControlled) onClose?.({ reason: 'click-outside', event: e });\n      setInternalIsOpen(false);\n      onClickOutside?.(e as MouseEvent);\n    },\n    [isControlled, onClose, setInternalIsOpen, onClickOutside],\n  );\n\n  // onEscape target \u2014 see file header (B) \"KEYBOARD ESCAPE\". Scoped Escape only; gated by closeOnEscape\n  // (`!onKeyDown`, see the config below).\n  const handleScopedEscape = useCallback(\n    (event: KeyboardEvent) => {\n      if (!isControlled) onClose?.({ reason: 'escape', event });\n      setInternalIsOpen(false);\n    },\n    [isControlled, onClose, setInternalIsOpen],\n  );\n\n  // Controlled close notify \u2014 see file header \"CONTROLLED OPEN & CLOSE FLOWS\". The guard also filters\n  // out a non-scoped Escape, which reaches here as reason 'interaction' (not 'controlled-flip').\n  const handleFloatingClose = useCallback(\n    (info: DSHookFloatingContextT.OpenChange) => {\n      if (info.reason === 'controlled-flip' && isControlled) onClose?.({ reason: 'controlled' });\n    },\n    [isControlled, onClose],\n  );\n\n  // Open transition \u2014 see file header (A) (focus) + \"CONTROLLED OPEN & CLOSE FLOWS\" (notify). Seeds\n  // initial focus (targets per the CONSUMER CONFIGURATION table) and, when controlled, notifies the\n  // consumer. Mount-open is not a transition, so this never fires for it (AppPanel's\n  // useMountedOpenAutofocusNuance handles that one case).\n  const handleFloatingOpen = useCallback(\n    (info: DSHookFloatingContextT.OpenChange) => {\n      if (wasOpenedByKeyboardRef.current && triggerIsInternal) trackFocusSelectedItem();\n      else if (triggerIsInternal) trackFocusPanel();\n      else trackFocusFirstItem();\n      if (info.reason === 'controlled-flip' && isControlled) onOpen?.({ reason: 'controlled' });\n    },\n    [\n      wasOpenedByKeyboardRef,\n      triggerIsInternal,\n      trackFocusSelectedItem,\n      trackFocusPanel,\n      trackFocusFirstItem,\n      isControlled,\n      onOpen,\n    ],\n  );\n\n  const floatingContextConfig = useMemo(\n    () =>\n      ({\n        placement: 'bottom',\n        // Arrow tip is ~6.1px above the panel top (arrowPlacementBase16 \u2248 17.5px, tip at 11.4px from box top).\n        // 4px spec gap \u2192 4 + 6.1 \u2248 10px offset.\n        customOffset: [0, 10],\n        externallyControlledIsOpen: resolvedIsOpen,\n        withoutAnimation: true,\n        onClickOutside: handleClickOutside,\n        // closeOnEscape = !onKeyDown: with a consumer onKeyDown, useFloatingContext neither routes\n        // the Escape to onEscape (see handleScopedEscape) nor returns focus to the trigger \u2014 the\n        // consumer's onKeyDown owns the key entirely.\n        closeOnEscape: !onKeyDown,\n        onClose: handleFloatingClose,\n        onEscape: handleScopedEscape,\n        onOpen: handleFloatingOpen,\n        returnFocusToReference: true,\n        externalReferenceElement: triggerRef?.current || defaultTriggerRef.current,\n      }) as DSHookFloatingContextT.Props,\n    [\n      handleClickOutside,\n      handleScopedEscape,\n      handleFloatingClose,\n      handleFloatingOpen,\n      onKeyDown,\n      resolvedIsOpen,\n      triggerRef,\n    ],\n  );\n\n  const {\n    refs: floatingRefs,\n    floatingStyles,\n    arrowStyles,\n    context: floatingContext,\n  } = useFloatingContext(floatingContextConfig);\n\n  const handleTriggerRef = useCallback<React.RefCallback<HTMLButtonElement>>(\n    (node) => {\n      (defaultTriggerRef as React.MutableRefObject<HTMLButtonElement | null>).current = node;\n      floatingRefs.setReference(node);\n      if (triggerRef) {\n        (triggerRef as React.MutableRefObject<HTMLButtonElement | null>).current = node;\n      }\n    },\n    [floatingRefs, triggerRef],\n  );\n\n  // Populates the consumer's actionRef with imperative focus methods. Fires on mount with the panel\n  // node. Every method routes through the focus tracker \u2014 no DOM queries.\n  const handleActionRef = useCallback<React.RefCallback<HTMLDivElement>>(\n    (node) => {\n      if (node && actionRef?.current) {\n        actionRef.current.focusToIndex = (index: number) => {\n          trackFocusItemAtIndex(index);\n        };\n        actionRef.current.focusWrapper = () => {\n          trackFocusPanel();\n        };\n        actionRef.current.focusSelectedOrFirstAvailable = () => {\n          trackFocusSelectedItem();\n        };\n      }\n    },\n    [actionRef, trackFocusItemAtIndex, trackFocusPanel, trackFocusSelectedItem],\n  );\n\n  const floatingInnerRef = useCallback<React.RefCallback<HTMLDivElement>>(\n    (node) => {\n      (floatingRefs.setFloating as React.RefCallback<HTMLDivElement>)(node);\n      handleActionRef(node);\n    },\n    [floatingRefs.setFloating, handleActionRef],\n  );\n\n  const handleTriggerClick = useCallback(\n    (e: React.MouseEvent | React.KeyboardEvent) => {\n      // detail === 0 \u21D2 keyboard activation (Enter/Space), not a pointer. handleFloatingOpen reads\n      // this on the next open transition to pick keyboard-vs-pointer initial focus.\n      wasOpenedByKeyboardRef.current = (e as React.MouseEvent).detail === 0;\n      onClick?.(e);\n      // Uncontrolled eager notify \u2014 see file header (B) \"TRIGGER CLICK\" / \"CLICK ON TRIGGER\".\n      // `resolvedIsOpen` is the pre-flip value: open \u21D2 this click closes (trigger-toggle), else opens.\n      if (!isControlled) {\n        if (resolvedIsOpen) onClose?.({ reason: 'trigger-toggle', event: e });\n        else onOpen?.({ reason: 'trigger', event: e });\n      }\n      setInternalIsOpen((prev) => !prev);\n    },\n    [onClick, wasOpenedByKeyboardRef, setInternalIsOpen, isControlled, resolvedIsOpen, onClose, onOpen],\n  );\n\n  return {\n    floatingStyles,\n    arrowStyles,\n    floatingContext,\n    handleTriggerRef,\n    handleTriggerClick,\n    floatingInnerRef,\n  };\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/parts/AppPickerItem.js

@@ -0,0 +1,74 @@
+import * as React from "react";
+import { jsx } from "react/jsx-runtime";
+import { DSChip } from "@elliemae/ds-chip";
+import { styled } from "@elliemae/ds-system";
+import React2, { useContext } from "react";
+import { DSAppPickerDataTestIds, DSAppPickerName, DSAppPickerSlots } from "../constants/index.js";
+import { DSAppPickerContext } from "../DSAppPickerCTX.js";
+import { getChipRegionId } from "../util/getChipRegionId.js";
+const StyledListItem = styled("div", { name: DSAppPickerName, slot: DSAppPickerSlots.ITEM })`
+  display: flex;
+`;
+const StyledChip = styled(DSChip, { name: DSAppPickerName, slot: DSAppPickerSlots.CHIP })``;
+const AppIcon = ({ icon: Icon }) => /* @__PURE__ */ jsx(Icon, { className: "app-picker__icon", size: "m" });
+const AppPickerItem = React2.memo(
+  ({ app, positionAnnouncement, chipId, isFirstFocusable, isLastFocusable }) => {
+    const { label, disabled, applyAriaDisabled, selected, icon, id, wrapText } = app;
+    const {
+      focusTrackers: { focusRegion, firstFocusableRef, lastFocusableRef, trackFocusChip, trackFocusRegionReset },
+      ownerPropsConfig: { getOwnerProps }
+    } = useContext(DSAppPickerContext);
+    const isFocused = focusRegion === getChipRegionId(chipId);
+    const getOwnerPropsArguments = React2.useCallback(() => app, [app]);
+    const renderIcon = React2.useCallback(() => /* @__PURE__ */ jsx(AppIcon, { icon }), [icon]);
+    const handleClick = React2.useCallback(
+      (e) => {
+        if (app.onClick) app.onClick(e, app);
+      },
+      [app]
+    );
+    const handleFocus = React2.useCallback(() => trackFocusChip(chipId), [chipId, trackFocusChip]);
+    const handleChipRef = React2.useCallback(
+      (node) => {
+        if (isFirstFocusable) firstFocusableRef.current = node;
+        if (isLastFocusable) lastFocusableRef.current = node;
+        if (node && isFocused) node.focus();
+      },
+      [isFirstFocusable, isLastFocusable, isFocused, firstFocusableRef, lastFocusableRef]
+    );
+    return /* @__PURE__ */ jsx(
+      StyledListItem,
+      {
+        "data-testid": DSAppPickerDataTestIds.ITEM,
+        getOwnerProps,
+        getOwnerPropsArguments,
+        children: /* @__PURE__ */ jsx(
+          StyledChip,
+          {
+            onClick: handleClick,
+            "data-testid": DSAppPickerDataTestIds.CHIP,
+            disabled,
+            applyAriaDisabled,
+            selected,
+            "aria-current": selected ? "true" : void 0,
+            "aria-label": `${label} ${positionAnnouncement}`,
+            id,
+            icon: renderIcon,
+            label,
+            getOwnerProps,
+            getOwnerPropsArguments,
+            wrapText,
+            innerRef: handleChipRef,
+            onBlur: trackFocusRegionReset,
+            onFocus: handleFocus
+          }
+        )
+      }
+    );
+  }
+);
+AppPickerItem.displayName = "DSAppPicker.AppPickerItem";
+export {
+  AppPickerItem
+};
+//# sourceMappingURL=AppPickerItem.js.map

package/dist/esm/parts/AppPickerItem.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/parts/AppPickerItem.tsx"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { DSChip } from '@elliemae/ds-chip';\nimport { styled } from '@elliemae/ds-system';\nimport React, { useContext } from 'react';\nimport { DSAppPickerDataTestIds, DSAppPickerName, DSAppPickerSlots } from '../constants/index.js';\nimport { DSAppPickerContext } from '../DSAppPickerCTX.js';\nimport type { DSAppPickerT } from '../react-desc-prop-types.js';\nimport { getChipRegionId } from '../util/getChipRegionId.js';\n\n// Grid items stretch to their row height, but the chip inside would not follow: DSChip's root is a\n// block-level box with `height: auto` under `wrapText`, so a single-line chip stayed short next to a\n// chip whose label wrapped onto two lines (uneven tiles \u2014 PUI ticket \"Chips don't keep a consistent\n// height\"). Making this a flex container hands the stretched row height down to the chip root; the\n// chip's own button already carries `min-height: 100%`, so it fills from there.\nconst StyledListItem = styled('div', { name: DSAppPickerName, slot: DSAppPickerSlots.ITEM })`\n  display: flex;\n`;\nconst StyledChip = styled(DSChip, { name: DSAppPickerName, slot: DSAppPickerSlots.CHIP })``;\n\ninterface AppIconProps {\n  icon: DSAppPickerT.AppItem['icon'];\n}\n\nconst AppIcon: React.FC<AppIconProps> = ({ icon: Icon }) => <Icon className=\"app-picker__icon\" size=\"m\" />;\n\ninterface AppPickerItemProps {\n  app: DSAppPickerT.AppItem;\n  // Chip identity assigned by the parent (AppSection, via getChipId) and read here \u2014 never\n  // generated locally, so the focus tracker can address this chip without it reporting back up.\n  chipId: string;\n  isFirstFocusable: boolean;\n  isLastFocusable: boolean;\n  positionAnnouncement: string;\n}\n\nexport const AppPickerItem: React.FC<AppPickerItemProps> = React.memo(\n  ({ app, positionAnnouncement, chipId, isFirstFocusable, isLastFocusable }) => {\n    const { label, disabled, applyAriaDisabled, selected, icon, id, wrapText } = app;\n    const {\n      focusTrackers: { focusRegion, firstFocusableRef, lastFocusableRef, trackFocusChip, trackFocusRegionReset },\n      ownerPropsConfig: { getOwnerProps },\n    } = useContext(DSAppPickerContext);\n\n    const isFocused = focusRegion === getChipRegionId(chipId);\n\n    const getOwnerPropsArguments = React.useCallback(() => app, [app]);\n    const renderIcon = React.useCallback(() => <AppIcon icon={icon} />, [icon]);\n    const handleClick = React.useCallback(\n      (e: React.MouseEvent) => {\n        if (app.onClick) app.onClick(e, app);\n      },\n      [app],\n    );\n    const handleFocus = React.useCallback(() => trackFocusChip(chipId), [chipId, trackFocusChip]);\n\n    // Single ref callback: registers focus-trap edges and drives tracker-seeded focus.\n    // New reference when isFocused or edge membership changes \u2014 React re-invokes with the DOM node.\n    const handleChipRef = React.useCallback(\n      (node: HTMLElement | null) => {\n        if (isFirstFocusable) firstFocusableRef.current = node;\n        if (isLastFocusable) lastFocusableRef.current = node;\n        if (node && isFocused) node.focus();\n      },\n      [isFirstFocusable, isLastFocusable, isFocused, firstFocusableRef, lastFocusableRef],\n    );\n\n    return (\n      <StyledListItem\n        data-testid={DSAppPickerDataTestIds.ITEM}\n        getOwnerProps={getOwnerProps}\n        getOwnerPropsArguments={getOwnerPropsArguments}\n      >\n        <StyledChip\n          onClick={handleClick}\n          data-testid={DSAppPickerDataTestIds.CHIP}\n          disabled={disabled}\n          applyAriaDisabled={applyAriaDisabled}\n          selected={selected}\n          // Only the consumer knows what \"selected\" means in context (current item, toggled, or option in a listbox).\n          // AppPicker is both a consumer and consumed, it owes the programmatic state.\n          // `true` rather than `page`:\n          // `page` claims a set of pages,\n          //    AppPicker cannot know whether a tile is an anchor, a route push, or an in-place context switch.\n          //    A consumer who does know can upgrade the token through the CHIP slot (`dsApppickerChip`), which overrides anything set here.\n          // Omitted when unselected \u2014 `false` is the default and is not exposed either way.\n          aria-current={selected ? 'true' : undefined}\n          // discussed with Juan (A11y SME), the position announcement is best kept to give \"aria-current\" the meaing of \"current within a set\"\n          //   it's not strictly required, but given both apps and customApps are part of the same \"set\" and there is no other semantic tie between the individual chips\n          //   announcing X of Y gives a reasonable context to the user that they are navigating a set of items, and not just a single item even with the button role.\n          // with this X of Y announcement we can also keep the two `role=\"group\"` sections for apps and customApps separate,\n          //   improving the announcement experience as they don't get bombarded with the section title every focus on a button, but only when they first enter the section.\n          aria-label={`${label} ${positionAnnouncement}`}\n          id={id}\n          icon={renderIcon}\n          label={label}\n          getOwnerProps={getOwnerProps}\n          getOwnerPropsArguments={getOwnerPropsArguments}\n          wrapText={wrapText}\n          innerRef={handleChipRef}\n          onBlur={trackFocusRegionReset}\n          onFocus={handleFocus}\n        />\n      </StyledListItem>\n    );\n  },\n);\n\nAppPickerItem.displayName = 'DSAppPicker.AppPickerItem';\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACsBqC;AAtB5D,SAAS,cAAc;AACvB,SAAS,cAAc;AACvB,OAAOA,UAAS,kBAAkB;AAClC,SAAS,wBAAwB,iBAAiB,wBAAwB;AAC1E,SAAS,0BAA0B;AAEnC,SAAS,uBAAuB;AAOhC,MAAM,iBAAiB,OAAO,OAAO,EAAE,MAAM,iBAAiB,MAAM,iBAAiB,KAAK,CAAC;AAAA;AAAA;AAG3F,MAAM,aAAa,OAAO,QAAQ,EAAE,MAAM,iBAAiB,MAAM,iBAAiB,KAAK,CAAC;AAMxF,MAAM,UAAkC,CAAC,EAAE,MAAM,KAAK,MAAM,oBAAC,QAAK,WAAU,oBAAmB,MAAK,KAAI;AAYjG,MAAM,gBAA8CA,OAAM;AAAA,EAC/D,CAAC,EAAE,KAAK,sBAAsB,QAAQ,kBAAkB,gBAAgB,MAAM;AAC5E,UAAM,EAAE,OAAO,UAAU,mBAAmB,UAAU,MAAM,IAAI,SAAS,IAAI;AAC7E,UAAM;AAAA,MACJ,eAAe,EAAE,aAAa,mBAAmB,kBAAkB,gBAAgB,sBAAsB;AAAA,MACzG,kBAAkB,EAAE,cAAc;AAAA,IACpC,IAAI,WAAW,kBAAkB;AAEjC,UAAM,YAAY,gBAAgB,gBAAgB,MAAM;AAExD,UAAM,yBAAyBA,OAAM,YAAY,MAAM,KAAK,CAAC,GAAG,CAAC;AACjE,UAAM,aAAaA,OAAM,YAAY,MAAM,oBAAC,WAAQ,MAAY,GAAI,CAAC,IAAI,CAAC;AAC1E,UAAM,cAAcA,OAAM;AAAA,MACxB,CAAC,MAAwB;AACvB,YAAI,IAAI,QAAS,KAAI,QAAQ,GAAG,GAAG;AAAA,MACrC;AAAA,MACA,CAAC,GAAG;AAAA,IACN;AACA,UAAM,cAAcA,OAAM,YAAY,MAAM,eAAe,MAAM,GAAG,CAAC,QAAQ,cAAc,CAAC;AAI5F,UAAM,gBAAgBA,OAAM;AAAA,MAC1B,CAAC,SAA6B;AAC5B,YAAI,iBAAkB,mBAAkB,UAAU;AAClD,YAAI,gBAAiB,kBAAiB,UAAU;AAChD,YAAI,QAAQ,UAAW,MAAK,MAAM;AAAA,MACpC;AAAA,MACA,CAAC,kBAAkB,iBAAiB,WAAW,mBAAmB,gBAAgB;AAAA,IACpF;AAEA,WACE;AAAA,MAAC;AAAA;AAAA,QACC,eAAa,uBAAuB;AAAA,QACpC;AAAA,QACA;AAAA,QAEA;AAAA,UAAC;AAAA;AAAA,YACC,SAAS;AAAA,YACT,eAAa,uBAAuB;AAAA,YACpC;AAAA,YACA;AAAA,YACA;AAAA,YAQA,gBAAc,WAAW,SAAS;AAAA,YAMlC,cAAY,GAAG,KAAK,IAAI,oBAAoB;AAAA,YAC5C;AAAA,YACA,MAAM;AAAA,YACN;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA,UAAU;AAAA,YACV,QAAQ;AAAA,YACR,SAAS;AAAA;AAAA,QACX;AAAA;AAAA,IACF;AAAA,EAEJ;AACF;AAEA,cAAc,cAAc;",
+  "names": ["React"]
+}

package/dist/esm/parts/AppSection.js

@@ -0,0 +1,64 @@
+import * as React from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { styled } from "@elliemae/ds-system";
+import { DSTypography } from "@elliemae/ds-typography";
+import { useContext } from "react";
+import { DSAppPickerDataTestIds, DSAppPickerName, DSAppPickerSlots } from "../constants/index.js";
+import { DSAppPickerContext } from "../DSAppPickerCTX.js";
+import { getChipId } from "../util/getChipId.js";
+import { AppPickerItem } from "./AppPickerItem.js";
+import { StyledListItemFullRow, StyledSection } from "./shared-styles.js";
+const StyledTitle = styled(DSTypography, { name: DSAppPickerName, slot: DSAppPickerSlots.TITLE })`
+  color: ${({ theme }) => theme.colors.neutral[700]};
+  font-size: ${({ theme }) => theme.fontSizes.value[400]};
+  font-weight: ${({ theme }) => theme.fontWeights.semibold};
+  margin: 12px 0 8px 0;
+  line-height: 1.385;
+  text-transform: uppercase;
+  text-align: center;
+`;
+const AppSection = ({ isCustomApps = false }) => {
+  const {
+    propsWithDefault: { apps, customApps, sectionTitle, customSectionTitle },
+    instanceUid,
+    focusTrackers: { firstFocusableIdx, lastFocusableIdx },
+    ownerPropsConfig
+  } = useContext(DSAppPickerContext);
+  const items = isCustomApps ? customApps : apps;
+  const titleId = isCustomApps ? `${instanceUid}-custom-section-title` : `${instanceUid}-section-title`;
+  const title = isCustomApps ? customSectionTitle : sectionTitle;
+  const totalCount = (apps?.length ?? 0) + (customApps?.length ?? 0);
+  const initialPositionOffset = isCustomApps ? apps.length : 0;
+  return /* @__PURE__ */ jsxs(
+    StyledSection,
+    {
+      "data-testid": DSAppPickerDataTestIds.GROUP,
+      role: "group",
+      "aria-labelledby": titleId,
+      ...ownerPropsConfig,
+      children: [
+        /* @__PURE__ */ jsx(StyledListItemFullRow, { "data-testid": DSAppPickerDataTestIds.ROW, ...ownerPropsConfig, children: /* @__PURE__ */ jsx(StyledTitle, { "data-testid": DSAppPickerDataTestIds.TITLE, id: titleId, variant: "h3-strong", ...ownerPropsConfig, children: title }) }),
+        items.map((app, index) => {
+          const flatIndex = initialPositionOffset + index;
+          const positionAnnouncement = `${flatIndex + 1} of ${totalCount}`;
+          return /* @__PURE__ */ jsx(
+            AppPickerItem,
+            {
+              positionAnnouncement,
+              app,
+              chipId: getChipId(app, flatIndex),
+              isFirstFocusable: flatIndex === firstFocusableIdx,
+              isLastFocusable: flatIndex === lastFocusableIdx
+            },
+            app.id ?? `${app.label}-${isCustomApps ? "custom" : "main"}-${index}`
+          );
+        })
+      ]
+    }
+  );
+};
+AppSection.displayName = "DSAppPicker.AppSection";
+export {
+  AppSection
+};
+//# sourceMappingURL=AppSection.js.map

package/dist/esm/parts/AppSection.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/parts/AppSection.tsx"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { styled } from '@elliemae/ds-system';\nimport { DSTypography } from '@elliemae/ds-typography';\nimport React, { useContext } from 'react';\nimport { DSAppPickerDataTestIds, DSAppPickerName, DSAppPickerSlots } from '../constants/index.js';\nimport { DSAppPickerContext } from '../DSAppPickerCTX.js';\nimport { getChipId } from '../util/getChipId.js';\nimport { AppPickerItem } from './AppPickerItem.js';\nimport { StyledListItemFullRow, StyledSection } from './shared-styles.js';\n\nconst StyledTitle = styled(DSTypography, { name: DSAppPickerName, slot: DSAppPickerSlots.TITLE })`\n  color: ${({ theme }) => theme.colors.neutral[700]};\n  font-size: ${({ theme }) => theme.fontSizes.value[400]};\n  font-weight: ${({ theme }) => theme.fontWeights.semibold};\n  margin: 12px 0 8px 0;\n  line-height: 1.385;\n  text-transform: uppercase;\n  text-align: center;\n`;\n\ninterface AppSectionProps {\n  isCustomApps?: boolean;\n}\n\nexport const AppSection: React.FC<AppSectionProps> = ({ isCustomApps = false }) => {\n  const {\n    propsWithDefault: { apps, customApps, sectionTitle, customSectionTitle },\n    instanceUid,\n    focusTrackers: { firstFocusableIdx, lastFocusableIdx },\n    ownerPropsConfig,\n  } = useContext(DSAppPickerContext);\n\n  const items = isCustomApps ? customApps : apps;\n  const titleId = isCustomApps ? `${instanceUid}-custom-section-title` : `${instanceUid}-section-title`;\n  const title = isCustomApps ? customSectionTitle : sectionTitle;\n\n  const totalCount = (apps?.length ?? 0) + (customApps?.length ?? 0);\n  const initialPositionOffset = isCustomApps ? apps.length : 0;\n  return (\n    <StyledSection\n      data-testid={DSAppPickerDataTestIds.GROUP}\n      role=\"group\"\n      aria-labelledby={titleId}\n      {...ownerPropsConfig}\n    >\n      <StyledListItemFullRow data-testid={DSAppPickerDataTestIds.ROW} {...ownerPropsConfig}>\n        <StyledTitle data-testid={DSAppPickerDataTestIds.TITLE} id={titleId} variant=\"h3-strong\" {...ownerPropsConfig}>\n          {title}\n        </StyledTitle>\n      </StyledListItemFullRow>\n      {items.map((app, index) => {\n        const flatIndex = initialPositionOffset + index;\n        const positionAnnouncement = `${flatIndex + 1} of ${totalCount}`;\n        return (\n          <AppPickerItem\n            key={app.id ?? `${app.label}-${isCustomApps ? 'custom' : 'main'}-${index}`}\n            positionAnnouncement={positionAnnouncement}\n            app={app}\n            chipId={getChipId(app, flatIndex)}\n            isFirstFocusable={flatIndex === firstFocusableIdx}\n            isLastFocusable={flatIndex === lastFocusableIdx}\n          />\n        );\n      })}\n    </StyledSection>\n  );\n};\n\nAppSection.displayName = 'DSAppPicker.AppSection';\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACsCnB,SAOI,KAPJ;AAtCJ,SAAS,cAAc;AACvB,SAAS,oBAAoB;AAC7B,SAAgB,kBAAkB;AAClC,SAAS,wBAAwB,iBAAiB,wBAAwB;AAC1E,SAAS,0BAA0B;AACnC,SAAS,iBAAiB;AAC1B,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB,qBAAqB;AAErD,MAAM,cAAc,OAAO,cAAc,EAAE,MAAM,iBAAiB,MAAM,iBAAiB,MAAM,CAAC;AAAA,WACrF,CAAC,EAAE,MAAM,MAAM,MAAM,OAAO,QAAQ,GAAG,CAAC;AAAA,eACpC,CAAC,EAAE,MAAM,MAAM,MAAM,UAAU,MAAM,GAAG,CAAC;AAAA,iBACvC,CAAC,EAAE,MAAM,MAAM,MAAM,YAAY,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAWnD,MAAM,aAAwC,CAAC,EAAE,eAAe,MAAM,MAAM;AACjF,QAAM;AAAA,IACJ,kBAAkB,EAAE,MAAM,YAAY,cAAc,mBAAmB;AAAA,IACvE;AAAA,IACA,eAAe,EAAE,mBAAmB,iBAAiB;AAAA,IACrD;AAAA,EACF,IAAI,WAAW,kBAAkB;AAEjC,QAAM,QAAQ,eAAe,aAAa;AAC1C,QAAM,UAAU,eAAe,GAAG,WAAW,0BAA0B,GAAG,WAAW;AACrF,QAAM,QAAQ,eAAe,qBAAqB;AAElD,QAAM,cAAc,MAAM,UAAU,MAAM,YAAY,UAAU;AAChE,QAAM,wBAAwB,eAAe,KAAK,SAAS;AAC3D,SACE;AAAA,IAAC;AAAA;AAAA,MACC,eAAa,uBAAuB;AAAA,MACpC,MAAK;AAAA,MACL,mBAAiB;AAAA,MAChB,GAAG;AAAA,MAEJ;AAAA,4BAAC,yBAAsB,eAAa,uBAAuB,KAAM,GAAG,kBAClE,8BAAC,eAAY,eAAa,uBAAuB,OAAO,IAAI,SAAS,SAAQ,aAAa,GAAG,kBAC1F,iBACH,GACF;AAAA,QACC,MAAM,IAAI,CAAC,KAAK,UAAU;AACzB,gBAAM,YAAY,wBAAwB;AAC1C,gBAAM,uBAAuB,GAAG,YAAY,CAAC,OAAO,UAAU;AAC9D,iBACE;AAAA,YAAC;AAAA;AAAA,cAEC;AAAA,cACA;AAAA,cACA,QAAQ,UAAU,KAAK,SAAS;AAAA,cAChC,kBAAkB,cAAc;AAAA,cAChC,iBAAiB,cAAc;AAAA;AAAA,YAL1B,IAAI,MAAM,GAAG,IAAI,KAAK,IAAI,eAAe,WAAW,MAAM,IAAI,KAAK;AAAA,UAM1E;AAAA,QAEJ,CAAC;AAAA;AAAA;AAAA,EACH;AAEJ;AAEA,WAAW,cAAc;",
+  "names": []
+}

package/dist/esm/parts/Trigger.js

@@ -0,0 +1,51 @@
+import * as React from "react";
+import { jsx } from "react/jsx-runtime";
+import { DSButtonV3 } from "@elliemae/ds-button-v2";
+import { styled } from "@elliemae/ds-system";
+import { useContext } from "react";
+import { DSAppPickerDataTestIds, DSAppPickerName, DSAppPickerSlots } from "../constants/index.js";
+import { DSAppPickerContext } from "../DSAppPickerCTX.js";
+const StyledButton = styled(DSButtonV3, { name: DSAppPickerName, slot: DSAppPickerSlots.BUTTON })`
+  height: fit-content;
+`;
+const Trigger = (PropsFromFloatingContext) => {
+  const { handleTriggerRef, handleTriggerClick, dialogLabelId } = PropsFromFloatingContext;
+  const {
+    propsWithDefault: { icon: Icon, renderTrigger, TriggerComponent },
+    ownerPropsConfig
+  } = useContext(DSAppPickerContext);
+  if (TriggerComponent) {
+    return /* @__PURE__ */ jsx(
+      TriggerComponent,
+      {
+        innerRef: handleTriggerRef,
+        id: dialogLabelId,
+        onClick: handleTriggerClick,
+        "aria-haspopup": "dialog"
+      }
+    );
+  }
+  if (renderTrigger) {
+    return renderTrigger({ ref: handleTriggerRef });
+  }
+  return /* @__PURE__ */ jsx(
+    StyledButton,
+    {
+      "data-testid": DSAppPickerDataTestIds.BUTTON,
+      id: dialogLabelId,
+      buttonType: "icon",
+      "aria-haspopup": "dialog",
+      "aria-label": "Application picker",
+      innerRef: handleTriggerRef,
+      onClick: handleTriggerClick,
+      getOwnerProps: ownerPropsConfig.getOwnerProps,
+      getOwnerPropsArguments: ownerPropsConfig.getOwnerPropsArguments,
+      children: /* @__PURE__ */ jsx(Icon, {})
+    }
+  );
+};
+Trigger.displayName = "DSAppPicker.Trigger";
+export {
+  Trigger
+};
+//# sourceMappingURL=Trigger.js.map

package/dist/esm/parts/Trigger.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/parts/Trigger.tsx"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "import { DSButtonV3 } from '@elliemae/ds-button-v2';\nimport { styled } from '@elliemae/ds-system';\nimport React, { useContext } from 'react';\nimport { DSAppPickerDataTestIds, DSAppPickerName, DSAppPickerSlots } from '../constants/index.js';\nimport { DSAppPickerContext } from '../DSAppPickerCTX.js';\nimport type { useAppPickerFloatingContext } from './AppPickerFloatingContext/useAppPickerFloatingContext.js';\n\n// DSButtonV3 sizes itself with `min-height` (height stays `auto`) so multi-line labels can grow.\n// As a side effect, when the trigger is a direct grid/flex child of a consumer layout with the\n// default `align-items: stretch`, it stretches to fill the container height (PUI-18354 regression:\n// the legacy DSButtonV2 trigger used a fixed `height` and did not stretch). `height: fit-content`\n// pins the trigger to its intrinsic size \u2014 mirroring the button's own `width: fit-content` \u2014 so it\n// stays ~28px regardless of layout context.\nconst StyledButton = styled(DSButtonV3, { name: DSAppPickerName, slot: DSAppPickerSlots.BUTTON })`\n  height: fit-content;\n`;\n\ntype UseAppPickerFloatingContextT = ReturnType<typeof useAppPickerFloatingContext>;\ntype FloatingContextDictatedProps = {\n  handleTriggerRef: UseAppPickerFloatingContextT['handleTriggerRef'];\n  handleTriggerClick: UseAppPickerFloatingContextT['handleTriggerClick'];\n  dialogLabelId: string;\n};\n\nexport const Trigger = (PropsFromFloatingContext: FloatingContextDictatedProps) => {\n  const { handleTriggerRef, handleTriggerClick, dialogLabelId } = PropsFromFloatingContext;\n  const {\n    propsWithDefault: { icon: Icon, renderTrigger, TriggerComponent },\n    ownerPropsConfig,\n  } = useContext(DSAppPickerContext);\n\n  // Precedence: TriggerComponent > renderTrigger > the built-in button. TriggerComponent wins when\n  // both custom APIs are supplied \u2014 it is the one that receives `dialogLabelId`, so preferring\n  // renderTrigger here would drop the dialog's accessible name.\n  if (TriggerComponent) {\n    return (\n      <TriggerComponent\n        innerRef={handleTriggerRef}\n        id={dialogLabelId}\n        onClick={handleTriggerClick}\n        aria-haspopup=\"dialog\"\n      />\n    );\n  }\n\n  if (renderTrigger) {\n    // DEPRECATED (v4.x) \u2014 see DEV-002. Plain function call (not a React element) preserves the\n    // legacy DSPopover render-prop contract: consumers receive `ref` as a regular prop, no\n    // forwardRef required. The contract has no channel for `dialogLabelId`, so on this path naming\n    // the dialog is the consumer's: put an id on the trigger element and inject the matching\n    // aria-labelledby through the FLOATING_WRAPPER slot (or pass `id` to DSAppPicker, which makes\n    // the generated id predictable). Covered by DSAppPicker.renderTrigger-ioc-aria-labelledby.test.js.\n    return renderTrigger({ ref: handleTriggerRef });\n  }\n  return (\n    <StyledButton\n      data-testid={DSAppPickerDataTestIds.BUTTON}\n      id={dialogLabelId}\n      buttonType=\"icon\"\n      aria-haspopup=\"dialog\"\n      aria-label=\"Application picker\"\n      innerRef={handleTriggerRef}\n      onClick={handleTriggerClick}\n      getOwnerProps={ownerPropsConfig.getOwnerProps}\n      getOwnerPropsArguments={ownerPropsConfig.getOwnerPropsArguments}\n    >\n      <Icon />\n    </StyledButton>\n  );\n};\n\nTrigger.displayName = 'DSAppPicker.Trigger';\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACoCjB;AApCN,SAAS,kBAAkB;AAC3B,SAAS,cAAc;AACvB,SAAgB,kBAAkB;AAClC,SAAS,wBAAwB,iBAAiB,wBAAwB;AAC1E,SAAS,0BAA0B;AASnC,MAAM,eAAe,OAAO,YAAY,EAAE,MAAM,iBAAiB,MAAM,iBAAiB,OAAO,CAAC;AAAA;AAAA;AAWzF,MAAM,UAAU,CAAC,6BAA2D;AACjF,QAAM,EAAE,kBAAkB,oBAAoB,cAAc,IAAI;AAChE,QAAM;AAAA,IACJ,kBAAkB,EAAE,MAAM,MAAM,eAAe,iBAAiB;AAAA,IAChE;AAAA,EACF,IAAI,WAAW,kBAAkB;AAKjC,MAAI,kBAAkB;AACpB,WACE;AAAA,MAAC;AAAA;AAAA,QACC,UAAU;AAAA,QACV,IAAI;AAAA,QACJ,SAAS;AAAA,QACT,iBAAc;AAAA;AAAA,IAChB;AAAA,EAEJ;AAEA,MAAI,eAAe;AAOjB,WAAO,cAAc,EAAE,KAAK,iBAAiB,CAAC;AAAA,EAChD;AACA,SACE;AAAA,IAAC;AAAA;AAAA,MACC,eAAa,uBAAuB;AAAA,MACpC,IAAI;AAAA,MACJ,YAAW;AAAA,MACX,iBAAc;AAAA,MACd,cAAW;AAAA,MACX,UAAU;AAAA,MACV,SAAS;AAAA,MACT,eAAe,iBAAiB;AAAA,MAChC,wBAAwB,iBAAiB;AAAA,MAEzC,8BAAC,QAAK;AAAA;AAAA,EACR;AAEJ;AAEA,QAAQ,cAAc;",
+  "names": []
+}

package/dist/esm/parts/shared-styles.js

@@ -0,0 +1,14 @@
+import * as React from "react";
+import { styled } from "@elliemae/ds-system";
+import { DSAppPickerName, DSAppPickerSlots } from "../constants/index.js";
+const StyledListItemFullRow = styled("div", { name: DSAppPickerName, slot: DSAppPickerSlots.ROW })`
+  grid-column: 1/4;
+`;
+const StyledSection = styled("div", { name: DSAppPickerName, slot: DSAppPickerSlots.GROUP })`
+  display: contents;
+`;
+export {
+  StyledListItemFullRow,
+  StyledSection
+};
+//# sourceMappingURL=shared-styles.js.map

package/dist/esm/parts/shared-styles.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../scripts/build/transpile/react-shim.js", "../../../src/parts/shared-styles.ts"],
+  "sourcesContent": ["import * as React from 'react';\nexport { React };\n", "/* eslint-disable @typescript-eslint/no-unsafe-assignment */\nimport { styled } from '@elliemae/ds-system';\nimport { DSAppPickerName, DSAppPickerSlots } from '../constants/index.js';\n\nexport const StyledListItemFullRow = styled('div', { name: DSAppPickerName, slot: DSAppPickerSlots.ROW })`\n  grid-column: 1/4;\n`;\n\n// The ARIA group that associates a section title with the chips belonging to it (role=\"group\" +\n// aria-labelledby \u2192 the title's id). It must NOT become a grid item: the panel root owns the\n// 3-column track and the title row / chips are its children. `display: contents` keeps this\n// element out of the layout while leaving it in the accessibility tree, so the grid is unchanged.\nexport const StyledSection = styled('div', { name: DSAppPickerName, slot: DSAppPickerSlots.GROUP })`\n  display: contents;\n`;\n"],
+  "mappings": "AAAA,YAAY,WAAW;ACCvB,SAAS,cAAc;AACvB,SAAS,iBAAiB,wBAAwB;AAE3C,MAAM,wBAAwB,OAAO,OAAO,EAAE,MAAM,iBAAiB,MAAM,iBAAiB,IAAI,CAAC;AAAA;AAAA;AAQjG,MAAM,gBAAgB,OAAO,OAAO,EAAE,MAAM,iBAAiB,MAAM,iBAAiB,MAAM,CAAC;AAAA;AAAA;",
+  "names": []
+}