voyager-ionic-core 8.8.12 → 8.8.17

package/dist/collection/utils/overlays.js

@@ -497,7 +497,30 @@ export const present = async (overlay, name, iosEnterAnimation, mdEnterAnimation
      * to the overlay container.
      */
     if (overlay.keyboardClose && (document.activeElement === null || !overlay.el.contains(document.activeElement))) {
-        overlay.el.focus();
+        /**
+         * Some overlays (e.g. modal) put the dialog role and accessible label
+         * on the `.ion-overlay-wrapper` instead of the host. Screen readers
+         * need focus on the element with `role="dialog"` to properly announce
+         * and navigate the dialog.
+         *
+         * We only target wrappers with `tabindex`, since `role="dialog"` alone
+         * does not make an element focusable. If no focusable dialog wrapper
+         * exists (e.g. picker-legacy), we fall back to the host.
+         */
+        const overlayWrapper = getElementRoot(overlay.el).querySelector('[role="dialog"][tabindex]');
+        const focusTarget = overlayWrapper !== null && overlayWrapper !== void 0 ? overlayWrapper : overlay.el;
+        /**
+         * `preventScroll` keeps this a pure focus move so the viewport does not
+         * jump when the wrapper is partially off-screen (e.g. a sheet modal).
+         * Guard the options call so an older engine that mishandles it can never
+         * reject present(); we fall back to a plain focus() in that case.
+         */
+        try {
+            focusTarget.focus({ preventScroll: true });
+        }
+        catch (_c) {
+            focusTarget.focus();
+        }
     }
     /**
      * If this overlay was previously dismissed without being

package/dist/collection/utils/test/playwright/apply-keyboard-focus.js

@@ -0,0 +1,25 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+import { expect } from "@playwright/test";
+/**
+ * Puts an element into the keyboard focus state that draws the focus indicator.
+ * Requires an `ion-app` so `startFocusVisible` is running. Its listeners attach
+ * asynchronously, so focus is retried until `ion-focused` sticks.
+ *
+ * `Shift` re-enables keyboard mode without moving focus, in case a pointer event
+ * earlier in the test turned it off. Focus moves programmatically because Firefox
+ * cannot move it back into the page once blurred, so an early Tab is unretryable.
+ *
+ * Pass `indicatorLocator` when something other than the focused element gets
+ * `ion-focused`. A checkbox or radio alone in an item has no `ion-focusable` class of
+ * its own because the item draws the indicator for it, so wait on the item.
+ */
+export const applyKeyboardFocus = async (page, locator, indicatorLocator = locator) => {
+    await expect(async () => {
+        await page.evaluate(() => { var _a; return (_a = document.activeElement) === null || _a === void 0 ? void 0 : _a.blur(); });
+        await page.keyboard.press('Shift');
+        await locator.focus();
+        await expect(indicatorLocator).toHaveClass(/ion-focused/, { timeout: 250 });
+    }).toPass({ timeout: 5000 });
+};

package/dist/collection/utils/test/playwright/drag-element.js

@@ -9,6 +9,7 @@
  * See https://playwright.dev/docs/api/class-mouse#mouse-move for more information.
  */
 export const dragElementBy = async (el, page, dragByX = 0, dragByY = 0, startXCoord, startYCoord, releaseDrag = true) => {
+    var _a;
     const boundingBox = await el.boundingBox();
     if (!boundingBox) {
         throw new Error('Cannot get a bounding box for an element that is not visible. See https://playwright.dev/docs/api/class-locator#locator-bounding-box for more information');
@@ -18,6 +19,20 @@ export const dragElementBy = async (el, page, dragByX = 0, dragByY = 0, startXCo
     // Navigate to the start position.
     await page.mouse.move(startX, startY);
     await page.mouse.down();
+    // Firefox treats focusable elements (tabindex="-1") as draggable text and
+    // initiates text selection on mouse.down(). In Playwright, this selection
+    // locks in before the gesture detector fires, blocking pointer events.
+    // Clearing it here allows the drag gesture to proceed normally.
+    //
+    // This is scoped to Firefox because the extra page.evaluate() is an awaited
+    // round-trip that adds variable latency between mouse.down() and the first
+    // mouse.move(). Chromium and WebKit don't need the selection clear, and on
+    // WebKit that latency perturbs the timing-derived gesture velocity, causing
+    // the item to settle a few pixels off and flaking screenshot comparisons
+    // (e.g. item-sliding safe-area tests).
+    if (((_a = page.context().browser()) === null || _a === void 0 ? void 0 : _a.browserType().name()) === 'firefox') {
+        await page.evaluate(() => { var _a; return (_a = window.getSelection()) === null || _a === void 0 ? void 0 : _a.removeAllRanges(); });
+    }
     // Drag the element.
     await moveElement(page, startX, startY, dragByX, dragByY);
     if (releaseDrag) {

package/dist/collection/utils/test/playwright/index.js

@@ -6,6 +6,7 @@ export * from './playwright-declarations';
 export * from './page/event-spy';
 export * from './page/utils';
 export * from './drag-element';
+export * from './apply-keyboard-focus';
 export * from './matchers';
 export * from './viewports';
 export * from './generator';

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-06-28T16:23:29",
+  "timestamp": "2026-08-08T17:09:51",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -10562,6 +10562,40 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "form",
+          "type": "HTMLFormElement | string | undefined",
+          "complexType": {
+            "original": "string | HTMLFormElement",
+            "resolved": "HTMLFormElement | string | undefined",
+            "references": {
+              "HTMLFormElement": {
+                "location": "global",
+                "id": "global::HTMLFormElement"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": false,
+          "docs": "The HTML form element or form element id. Used to submit a form when the button is not a child of the form.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "HTMLFormElement"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "href",
           "type": "string | undefined",
@@ -38144,6 +38178,11 @@
       "docstring": "",
       "path": "src/interface.d.ts"
     },
+    "src/components/datetime/datetime-interface.ts::DatetimeParts": {
+      "declaration": "export interface DatetimeParts {\n  month: number;\n  day: number | null;\n  year: number;\n  dayOfWeek?: number | null;\n  hour?: number;\n  minute?: number;\n  ampm?: 'am' | 'pm';\n  isAdjacentDay?: boolean;\n}",
+      "docstring": "",
+      "path": "src/components/datetime/datetime-interface.ts"
+    },
     "src/components/picker-column/picker-column-interfaces.ts::PickerColumnChangeEventDetail": {
       "declaration": "export interface PickerColumnChangeEventDetail {\n  value: PickerColumnValue;\n}",
       "docstring": "",