fix(input-date-picker): bump focus-trap to pick up shadow DOM focus-handling fix (#14381)

**Related Issue:** #14174 

## Summary

Picks up the fix for
focus-trap/focus-trap#1885 from
[`focus-trap`](https://github.com/focus-trap/focus-trap/releases/tag/v8.2.1).

Author: jcfranco

package-lock.json

@@ -81,7 +81,7 @@
     "color": "^5.0.3",
     "composed-offset-position": "^0.0.6",
     "es-toolkit": "^1.39.8",
-    "focus-trap": "^8.0.1",
+    "focus-trap": "^8.2.1",
     "interactjs": "^1.10.27",
     "lit": "^3.3.0",
     "sortablejs": "^1.15.6",

packages/components/package.json

@@ -1643,8 +1643,8 @@ export class Combobox extends LitElement implements LabelableComponent, Floating
         key={item.guid || item.value || label}
         label={label}
         messageOverrides={!disabled ? { dismissLabel: messages.removeTag } : null}
-        onFocusIn={!disabled ? () => (this.activeChipIndex = index) : null}
         oncalciteChipClose={!disabled ? () => this.calciteChipCloseHandler(item) : null}
+        onFocusIn={!disabled ? () => (this.activeChipIndex = index) : null}
         scale={scale}
         selected={item.selected}
         tabIndex={!disabled && activeChipIndex === index ? 0 : -1}

packages/components/src/components/combobox/combobox.tsx

@@ -838,9 +838,9 @@ export class Dialog extends LitElement implements OpenCloseComponentWithEl {
               loading={this.loading}
               menuOpen={this.menuOpen}
               messageOverrides={this.messageOverrides}
-              onKeyDown={this.handlePanelKeyDown}
               oncalcitePanelClose={this.handleInternalPanelCloseClick}
               oncalcitePanelScroll={this.handleInternalPanelScroll}
+              onKeyDown={this.handlePanelKeyDown}
               overlayPositioning={this.overlayPositioning}
               ref={this.panelRef}
               scale={this.scale}

packages/components/src/components/dialog/dialog.tsx

@@ -1,6 +1,7 @@
-import { h } from "@arcgis/lumina";
+import { h, JsxNode, LitElement } from "@arcgis/lumina";
 import { describe, it, expect } from "vitest";
 import { mount } from "@arcgis/lumina-compiler/testing";
+import { page, userEvent } from "vitest/browser";
 import {
   defaults,
   focusable,
@@ -15,7 +16,8 @@ import {
 } from "../../tests/commonTests/browser";
 import { mockConsole } from "../../tests/utils/logging";
 import { defaultValidity } from "../../tests/commonTests/browser/defaults";
-import { InputDatePicker } from "./input-date-picker";
+import { afterNextTask } from "../../tests/utils/timing";
+import type { InputDatePicker } from "./input-date-picker";
 
 describe("defaults", () => {
   defaults(
@@ -119,6 +121,39 @@ describe("is form-associated", () => {
   });
 });
 
+describe("focus-trap behavior", () => {
+  mockConsole();
+
+  it("restores focus to input-date-picker after closing when inside a focus-trapping parent in shadow DOM", async () => {
+    const dialogTestId = "test-dialog";
+    const pickerTestId = "test-picker";
+
+    class Test extends LitElement {
+      render(): JsxNode {
+        return (
+          <calcite-dialog data-testid={dialogTestId} open>
+            <calcite-input-date-picker data-testid={pickerTestId} value="2024-05-05" />
+          </calcite-dialog>
+        );
+      }
+    }
+
+    await mount(Test);
+    const picker = page.getByTestId(pickerTestId);
+
+    await userEvent.click(picker);
+    await userEvent.keyboard("{Tab}{Enter}");
+
+    // focus-trap delays focus handling by default -- https://github.com/focus-trap/focus-trap/#delayinitialfocus
+    await afterNextTask();
+
+    expect(document).toHaveProperty(
+      "activeElement.shadowRoot.activeElement.dataset.testid",
+      pickerTestId,
+    );
+  });
+});
+
 describe("minAsDate and maxAsDate properties", () => {
   it("honors minAsDate and maxAsDate properties by updating out-of-range value to the closest valid value", async () => {
     const { el, component } = await mount<InputDatePicker>(