Merge branch 'next' into FW-6987-next

Author: brandyscarney

.github/workflows/actions/download-archive/action.yml

@@ -10,7 +10,7 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - uses: actions/download-artifact@v6
+    - uses: actions/download-artifact@v7
       with:
         name: ${{ inputs.name }}
         path: ${{ inputs.path }}

.github/workflows/actions/test-core-screenshot/action.yml

@@ -62,7 +62,7 @@ runs:
       working-directory: ./core
     - name: 📦 Archive Updated Screenshots
       if: inputs.update == 'true' && steps.test-and-update.outputs.hasUpdatedScreenshots == 'true'
-      uses: actions/upload-artifact@v5
+      uses: actions/upload-artifact@v6
       with:
         name: updated-screenshots-${{ inputs.shard }}-${{ inputs.totalShards }}
         path: UpdatedScreenshots-${{ inputs.shard }}-${{ inputs.totalShards }}.zip

.github/workflows/actions/update-reference-screenshots/action.yml

@@ -10,7 +10,7 @@ runs:
     - uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
       with:
         node-version: 24.x
-    - uses: actions/download-artifact@v6
+    - uses: actions/download-artifact@v7
       with:
         path: ./artifacts
     - name: 🔎 Extract Archives

.github/workflows/actions/upload-archive/action.yml

@@ -13,7 +13,7 @@ runs:
     - name: 🗄️ Create Archive
       run: zip -q -r ${{ inputs.output }} ${{ inputs.paths }}
       shell: bash
-    - uses: actions/upload-artifact@v5
+    - uses: actions/upload-artifact@v6
       with:
         name: ${{ inputs.name }}
         path: ${{ inputs.output }}

CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.7.14](https://github.com/ionic-team/ionic-framework/compare/v8.7.13...v8.7.14) (2025-12-17)
+
+
+### Bug Fixes
+
+* **tabs:** select correct tab when routes have similar prefixes ([#30863](https://github.com/ionic-team/ionic-framework/issues/30863)) ([03fb422](https://github.com/ionic-team/ionic-framework/commit/03fb422bfa775e3e9dd695ea1857fa88d4245ecd)), closes [#30448](https://github.com/ionic-team/ionic-framework/issues/30448)
+
+
+
+
+
+## [8.7.13](https://github.com/ionic-team/ionic-framework/compare/v8.7.12...v8.7.13) (2025-12-13)
+
+**Note:** Version bump only for package ionic-framework
+
+
+
+
+
 ## [8.7.12](https://github.com/ionic-team/ionic-framework/compare/v8.7.11...v8.7.12) (2025-12-10)
 
 

core/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.7.14](https://github.com/ionic-team/ionic-framework/compare/v8.7.13...v8.7.14) (2025-12-17)
+
+**Note:** Version bump only for package @ionic/core
+
+
+
+
+
+## [8.7.13](https://github.com/ionic-team/ionic-framework/compare/v8.7.12...v8.7.13) (2025-12-13)
+
+**Note:** Version bump only for package @ionic/core
+
+
+
+
+
 ## [8.7.12](https://github.com/ionic-team/ionic-framework/compare/v8.7.11...v8.7.12) (2025-12-10)
 
 

core/package-lock.json

@@ -1,9 +1,9 @@
 {
   "name": "@ionic/core",
-  "version": "8.7.12",
+  "version": "8.7.14",
   "description": "Base components for Ionic",
   "engines": {
-    "node": "24.x"
+    "node": ">= 16"
   },
   "keywords": [
     "ionic",
@@ -41,10 +41,10 @@
   },
   "devDependencies": {
     "@axe-core/playwright": "^4.11.0",
-    "@capacitor/core": "^7.0.0",
-    "@capacitor/haptics": "^7.0.0",
-    "@capacitor/keyboard": "^7.0.0",
-    "@capacitor/status-bar": "^7.0.0",
+    "@capacitor/core": "^8.0.0",
+    "@capacitor/haptics": "^8.0.0",
+    "@capacitor/keyboard": "^8.0.0",
+    "@capacitor/status-bar": "^8.0.0",
     "@clack/prompts": "^0.11.0",
     "@ionic/eslint-config": "^0.3.0",
     "@ionic/prettier-config": "^2.0.0",

core/package.json

@@ -1,5 +1,5 @@
-import { win } from '@utils/browser';
 import type { CloseWatcher } from '@utils/browser';
+import { win } from '@utils/browser';
 import { printIonError } from '@utils/logging';
 
 import { config } from '../global/config';
@@ -69,6 +69,21 @@ export const startHardwareBackButton = () => {
     });
     doc.dispatchEvent(ev);
 
+    /**
+     * If no handlers have been registered, fall back to the default
+     * behavior of navigating back in history. This ensures the hardware
+     * back button works even when no router or custom handler is present.
+     */
+    if (handlers.length === 0) {
+      handlers.push({
+        priority: FALLBACK_BACK_BUTTON_PRIORITY,
+        handler: () => {
+          win?.history.back();
+        },
+        id: index++,
+      });
+    }
+
     const executeAction = async (handlerRegister: HandlerRegister | undefined) => {
       try {
         if (handlerRegister?.handler) {
@@ -138,3 +153,4 @@ export const startHardwareBackButton = () => {
 
 export const OVERLAY_BACK_BUTTON_PRIORITY = 100;
 export const MENU_BACK_BUTTON_PRIORITY = 99; // 1 less than overlay priority since menu is displayed behind overlays
+const FALLBACK_BACK_BUTTON_PRIORITY = -1; // Fallback when no other handlers are registered

core/src/utils/hardware-back-button.ts

@@ -54,6 +54,47 @@ describe('Hardware Back Button', () => {
     dispatchBackButtonEvent();
     expect(cbSpyTwo).toHaveBeenCalled();
   });
+
+  it('should fall back to history.back() when no handlers are registered', () => {
+    const historyBackSpy = jest.fn();
+    const originalBack = win?.history?.back;
+    if (win?.history) {
+      win.history.back = historyBackSpy;
+    }
+
+    // Don't register any ionBackButton handlers
+    dispatchBackButtonEvent();
+
+    expect(historyBackSpy).toHaveBeenCalled();
+
+    // Restore original
+    if (win?.history && originalBack) {
+      win.history.back = originalBack;
+    }
+  });
+
+  it('should not call history.back() when a handler is registered', () => {
+    const historyBackSpy = jest.fn();
+    const originalBack = win?.history?.back;
+    if (win?.history) {
+      win.history.back = historyBackSpy;
+    }
+
+    const cbSpy = jest.fn();
+    document.addEventListener('ionBackButton', (ev) => {
+      (ev as BackButtonEvent).detail.register(0, cbSpy);
+    });
+
+    dispatchBackButtonEvent();
+
+    expect(cbSpy).toHaveBeenCalled();
+    expect(historyBackSpy).not.toHaveBeenCalled();
+
+    // Restore original
+    if (win?.history && originalBack) {
+      win.history.back = originalBack;
+    }
+  });
 });
 
 describe('Experimental Close Watcher', () => {