fix(overlays): honor string focusTrap config

Issue number: internal

---------

<!-- Please do not submit updates to dependencies unless it fixes an
issue. -->

<!-- Please try to limit your pull request to one type (bugfix, feature,
etc). Submit multiple pull requests if needed. -->

## What is the current behavior?
<!-- Please describe the current behavior that you are modifying. -->

Currently, when an error text is shown, it may not announce itself to
voice assistants. This is because the way error text currently works is
by always existing in the DOM, but being hidden when there is no error.
When the error state changes, the error text is shown, but as far as the
voice assistant can tell it's always been there and nothing has changed.

## What is the new behavior?
<!-- Please describe the behavior or changes that are being added by
this PR. -->

- Updated aria attributes
- Added observer with an observer

## Does this introduce a breaking change?

- [ ] Yes
- [x] No

<!--
  If this introduces a breaking change:
1. Describe the impact and migration path for existing applications
below.
  2. Update the BREAKING.md file with the breaking change.
3. Add "BREAKING CHANGE: [...]" to the commit description when merging.
See
https://github.com/ionic-team/ionic-framework/blob/main/docs/CONTRIBUTING.md#footer
for more information.
-->


## Other information

<!-- Any other information that is important to this PR such as
screenshots of how the component looks before and after the change. -->

[Checkbox
preview](https://ionic-framework-git-fw-6757-ionic1.vercel.app/src/components/checkbox/test/validation/)
[Toggle
preview](https://ionic-framework-git-fw-6757-ionic1.vercel.app/src/components/toggle/test/validation/)
[Radio Group
preview](https://ionic-framework-git-fw-6757-ionic1.vercel.app/src/components/radio-group/test/validation/)

⚠️ Flakiness ⚠️ 

The flakiness on checkbox and toggle is because when a native input is
present on the page, the browser will have the screen reader to be
really fast when it comes to checking information. This speed ends up
being too fast for `ion-checkbox` to be able to add the error text. This
leads to the error text not being announce consistently. There's no
issue when it comes to ion-input or ion-textarea because Ionic uses the
native inputs so their arias are read. There's also no issue
with ion-select because we don't have a native input. It's only an issue
with checkbox and the others is because it has a [native input that is
being
hidden](8e884bd2cb/core/src/components/checkbox/checkbox.tsx (L368-L369)).
So the browser sees that and speeds up the screen reader.

The flakiness on radio group is because when you tab out of the last
radio button, the ionBlur event is emitted by the child <ion-radio>.
This event bubbles up, but the timing is still too early for the group.

.github/workflows/actions/build-angular-server/action.yml

@@ -3,23 +3,23 @@ description: 'Build Ionic Angular Server'
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
+        node-version: 24.x
     - uses: ./.github/workflows/actions/download-archive
       with:
         name: ionic-core
         path: ./core
         filename: CoreBuild.zip
-    - name: Install Angular Server Dependencies
+    - name: 🕸️ Install Angular Server Dependencies
       run: npm ci
       shell: bash
       working-directory: ./packages/angular-server
-    - name: Sync
+    - name: 🔄 Sync
       run: npm run sync
       shell: bash
       working-directory: ./packages/angular-server
-    - name: Build
+    - name: 🏗️ Build
       run: npm run build.prod
       shell: bash
       working-directory: ./packages/angular-server

.github/workflows/actions/build-angular/action.yml

@@ -3,31 +3,31 @@ description: 'Build Ionic Angular'
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@v6
       with:
-        node-version: 22.x
+        node-version: 24.x
     - uses: ./.github/workflows/actions/download-archive
       with:
         name: ionic-core
         path: ./core
         filename: CoreBuild.zip
-    - name: Install Angular Dependencies
+    - name: 🕸️ Install Angular Dependencies
       run: npm ci
       shell: bash
       working-directory: ./packages/angular
-    - name: Sync
+    - name: 🔄 Sync
       run: npm run sync
       shell: bash
       working-directory: ./packages/angular
-    - name: Lint
+    - name: 🖌️ Lint
       run: npm run lint
       shell: bash
       working-directory: ./packages/angular
-    - name: Build
+    - name: 🏗️ Build
       run: npm run build
       shell: bash
       working-directory: ./packages/angular
-    - name: Check Diff
+    - name: 🔍 Check Diff
       run: git diff --exit-code
       shell: bash
       working-directory: ./packages/angular

.github/workflows/actions/build-core-stencil-prerelease/action.yml

@@ -8,20 +8,20 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - uses: actions/checkout@v5
-    - uses: actions/setup-node@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
+        node-version: 24.x
 
-    - name: Install Dependencies
+    - name: 🕸️ Install Dependencies
       run: npm ci
       working-directory: ./core
       shell: bash
-    - name: Install Stencil ${{ inputs.stencil-version }}
+    - name: 📦 Install Stencil ${{ inputs.stencil-version }}
       working-directory: ./core
       run: npm i @stencil/core@${{ inputs.stencil-version }}
       shell: bash
-    - name: Build Core
+    - name: 🏗️ Build Core
       run: npm run build -- --ci --debug --verbose
       working-directory: ./core
       shell: bash
@@ -29,4 +29,4 @@ runs:
       with:
         name: ionic-core
         output: core/CoreBuild.zip
-        paths: core/dist core/components core/src/foundations core/css core/hydrate core/loader core/src/components.d.ts
+        paths: core/dist core/components core/css core/hydrate core/loader core/src/components.d.ts

.github/workflows/actions/build-core/action.yml

@@ -8,22 +8,22 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - uses: actions/checkout@v5
-    - uses: actions/setup-node@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
-    - name: Install Dependencies
+        node-version: 24.x
+    - name: 🕸️ Install Dependencies
       run: npm install
       working-directory: ./core
       shell: bash
     # If an Ionicons version was specified install that.
     # Otherwise just use the version defined in the package.json.
-    - name: Install Ionicons Version
+    - name: 📦 Install Ionicons Version
       if: inputs.ionicons-version != ''
       run: npm install ionicons@${{ inputs.ionicons-version }}
       working-directory: ./core
       shell: bash
-    - name: Build Core
+    - name: 🏗️ Build Core
       run: npm run build -- --ci
       working-directory: ./core
       shell: bash
@@ -33,4 +33,4 @@ runs:
         output: core/CoreBuild.zip
         # Include generated proxy files from Stencil output targets so
         # framework builds can detect when they need to be updated
-        paths: core/dist core/components core/src/foundations core/css core/hydrate core/loader core/src/components.d.ts core/api.txt packages/angular/src/directives/proxies.ts packages/angular/src/directives/proxies-list.ts packages/angular/standalone/src/directives/proxies.ts packages/vue/src/proxies.ts packages/react/src/components/proxies.ts packages/react/src/components/inner-proxies.ts packages/react/src/components/routing-proxies.ts
+        paths: core/dist core/components core/css core/hydrate core/loader core/src/components.d.ts core/api.txt packages/angular/src/directives/proxies.ts packages/angular/src/directives/proxies-list.ts packages/angular/standalone/src/directives/proxies.ts packages/vue/src/proxies.ts packages/react/src/components/proxies.ts packages/react/src/components/inner-proxies.ts packages/react/src/components/routing-proxies.ts

.github/workflows/actions/build-react-router/action.yml

@@ -3,9 +3,9 @@ description: 'Build Ionic React Router'
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
+        node-version: 24.x
     - uses: ./.github/workflows/actions/download-archive
       with:
         name: ionic-core
@@ -16,19 +16,19 @@ runs:
         name: ionic-react
         path: ./packages/react
         filename: ReactBuild.zip
-    - name: Install Dependencies
+    - name: 🕸️ Install Dependencies
       run: npm ci
       shell: bash
       working-directory: ./packages/react-router
-    - name: Sync
+    - name: 🔄 Sync
       run: npm run sync
       shell: bash
       working-directory: ./packages/react-router
-    - name: Lint
+    - name: 🖌️ Lint
       run: npm run lint
       shell: bash
       working-directory: ./packages/react-router
-    - name: Build
+    - name: 🏗️ Build
       run: npm run build
       shell: bash
       working-directory: ./packages/react-router

.github/workflows/actions/build-react/action.yml

@@ -3,35 +3,35 @@ description: 'Build Ionic React'
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
+        node-version: 24.x
     - uses: ./.github/workflows/actions/download-archive
       with:
         name: ionic-core
         path: ./core
         filename: CoreBuild.zip
-    - name: Install React Dependencies
+    - name: 🕸️ Install React Dependencies
       run: npm ci
       shell: bash
       working-directory: ./packages/react
-    - name: Sync
+    - name: 🔄 Sync
       run: npm run sync
       shell: bash
       working-directory: ./packages/react
-    - name: Lint
+    - name: 🖌️ Lint
       run: npm run lint
       shell: bash
       working-directory: ./packages/react
-    - name: Build
+    - name: 🏗️ Build
       run: npm run build
       shell: bash
       working-directory: ./packages/react
-    - name: Test Spec
+    - name: 🧪 Test Spec
       run: npm run test.spec
       shell: bash
       working-directory: ./packages/react
-    - name: Check Diff
+    - name: 🔍 Check Diff
       run: git diff --exit-code
       shell: bash
       working-directory: ./packages/react

.github/workflows/actions/build-vue-router/action.yml

@@ -3,9 +3,9 @@ description: 'Builds Ionic Vue Router'
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
+        node-version: 24.x
     - uses: ./.github/workflows/actions/download-archive
       with:
         name: ionic-core
@@ -16,23 +16,23 @@ runs:
         name: ionic-vue
         path: ./packages/vue
         filename: VueBuild.zip
-    - name: Install Vue Router Dependencies
+    - name: 🕸️ Install Vue Router Dependencies
       run: npm ci
       shell: bash
       working-directory: ./packages/vue-router
-    - name: Sync
+    - name: 🔄 Sync
       run: npm run sync
       shell: bash
       working-directory: ./packages/vue-router
-    - name: Lint
+    - name: 🖌️ Lint
       run: npm run lint
       shell: bash
       working-directory: ./packages/vue-router
-    - name: Build
+    - name: 🏗️ Build
       run: npm run build
       shell: bash
       working-directory: ./packages/vue-router
-    - name: Test Spec
+    - name: 🧪 Test Spec
       run: npm run test.spec
       shell: bash
       working-directory: ./packages/vue-router

.github/workflows/actions/build-vue/action.yml

@@ -3,31 +3,31 @@ description: 'Build Ionic Vue'
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
+        node-version: 24.x
     - uses: ./.github/workflows/actions/download-archive
       with:
         name: ionic-core
         path: ./core
         filename: CoreBuild.zip
-    - name: Install Vue Dependencies
+    - name: 🕸️ Install Vue Dependencies
       run: npm ci
       shell: bash
       working-directory: ./packages/vue
-    - name: Sync
+    - name: 🔄 Sync
       run: npm run sync
       shell: bash
       working-directory: ./packages/vue
-    - name: Lint
+    - name: 🖌️ Lint
       run: npm run lint
       shell: bash
       working-directory: ./packages/vue
-    - name: Build
+    - name: 🏗️ Build
       run: npm run build
       shell: bash
       working-directory: ./packages/vue
-    - name: Check Diff
+    - name: 🔍 Check Diff
       run: git diff --exit-code
       shell: bash
       working-directory: ./packages/vue

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

@@ -10,10 +10,10 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - uses: actions/download-artifact@v5
+    - uses: actions/download-artifact@v6
       with:
         name: ${{ inputs.name }}
         path: ${{ inputs.path }}
-    - name: Extract Archive
+    - name: 🔎 Extract Archive
       run: unzip -q -o ${{ inputs.path }}/${{ inputs.filename }}
       shell: bash

.github/workflows/actions/publish-npm/action.yml

@@ -8,48 +8,51 @@ inputs:
   tag:
     description: 'The tag to publish to on NPM.'
   preid:
-    description: 'The prerelease identifier used when doing a prerelease.'
+    description: "Prerelease identifier such as 'alpha', 'beta', 'rc', or 'next'. Leave blank to skip prerelease tagging."
   working-directory:
     description: 'The directory of the package.'
   folder:
     default: './'
     description: 'A folder containing a package.json file.'
-  token:
-    description: 'The NPM authentication token required to publish.'
+  node-version:
+    description: 'Node.js version to use when publishing.'
+    required: false
+    default: '24.x'
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - name: 🟢 Configure Node for Publish
+      uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
+        node-version: ${{ inputs.node-version }}
+        registry-url: 'https://registry.npmjs.org'
     # Provenance requires npm 9.5.0+
-    - name: Install latest npm
+    - name: 📦 Install latest npm
       run: npm install -g npm@latest
       shell: bash
     # This ensures the local version of Lerna is installed
     # and that we do not use the global Lerna version
-    - name: Install root dependencies
+    - name: 🕸️ Install root dependencies
       run: npm ci
       shell: bash
-    - name: Install Dependencies
+    - name: 📦 Install Dependencies
       run: npx lerna@5 bootstrap --include-dependencies --scope ${{ inputs.scope }} --ignore-scripts -- --legacy-peer-deps
       shell: bash
       working-directory: ${{ inputs.working-directory }}
-    - name: Update Version
-      run: npx lerna@5 version ${{ inputs.version }} --yes --exact --no-changelog --no-push --no-git-tag-version --preid=${{ inputs.preid }}
+    - name: 🏷️ Set Version
+      run: |
+        if [ -z "${{ inputs.preid }}" ]; then
+          npx lerna@5 version ${{ inputs.version }} --yes --exact --no-changelog --no-push --no-git-tag-version
+        else
+          npx lerna@5 version ${{ inputs.version }} --yes --exact --no-changelog --no-push --no-git-tag-version --preid=${{ inputs.preid }}
+        fi
       shell: bash
       working-directory: ${{ inputs.working-directory }}
-    - name: Run Build
+    - name: 🏗️ Run Build
       run: npm run build
       shell: bash
       working-directory: ${{ inputs.working-directory }}
-    - name: Prepare NPM Token
-      run: echo //registry.npmjs.org/:_authToken=${NPM_TOKEN} > .npmrc
-      working-directory: ${{ inputs.working-directory }}
-      shell: bash
-      env:
-        NPM_TOKEN: ${{ inputs.token }}
-    - name: Publish to NPM
+    - name: 🚀 Publish to NPM
       run: npm publish ${{ inputs.folder }} --tag ${{ inputs.tag }} --provenance
       shell: bash
       working-directory: ${{ inputs.working-directory }}

.github/workflows/actions/test-angular-e2e/action.yml

@@ -6,9 +6,9 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
+        node-version: 24.x
     - uses: ./.github/workflows/actions/download-archive
       with:
         name: ionic-core
@@ -24,23 +24,23 @@ runs:
         name: ionic-angular-server
         path: ./packages/angular-server
         filename: AngularServerBuild.zip
-    - name: Create Test App
+    - name: 🧪 Create Test App
       run: ./build.sh ${{ inputs.app }}
       shell: bash
       working-directory: ./packages/angular/test
-    - name: Install Dependencies
+    - name: 🕸️ Install Dependencies
       run: npm install
       shell: bash
       working-directory: ./packages/angular/test/build/${{ inputs.app }}
-    - name: Install Playwright Browsers
+    - name: 📦 Install Playwright Browsers
       run: npx playwright install
       shell: bash
       working-directory: ./packages/angular/test/build/${{ inputs.app }}
-    - name: Sync Built Changes
+    - name: 🔄 Sync Built Changes
       run: npm run sync
       shell: bash
       working-directory: ./packages/angular/test/build/${{ inputs.app }}
-    - name: Run Tests
+    - name: 🧪 Run Tests
       run: npm run test
       shell: bash
       working-directory: ./packages/angular/test/build/${{ inputs.app }}

.github/workflows/actions/test-core-clean-build/action.yml

@@ -3,16 +3,16 @@ description: 'Test Core Clean Build'
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
+        node-version: 24.x
 
     - uses: ./.github/workflows/actions/download-archive
       with:
         name: ionic-core
         path: ./core
         filename: CoreBuild.zip
-    - name: Check Diff
+    - name: 🔍 Check Diff
       run: |
         git diff --exit-code || {
           echo -e "\033[1;31m⚠️ Error: Differences Detected ⚠️\033[0m"

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

@@ -3,21 +3,21 @@ description: 'Test Core Lint'
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
-    - name: Install Dependencies
+        node-version: 24.x
+    - name: 🕸️ Install Dependencies
       run: npm ci
       working-directory: ./core
       shell: bash
-    - name: Lint
+    - name: 🖌️ Lint
       run: npm run lint
       shell: bash
       working-directory: ./core
     # Lint changes should be pushed
     # to the branch before the branch
     # is merge eligible.
-    - name: Check Lint Results
+    - name: 🔎 Check Lint Results
       run: git diff --exit-code
       shell: bash
       working-directory: ./core

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

@@ -13,19 +13,19 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
+        node-version: 24.x
     - uses: ./.github/workflows/actions/download-archive
       with:
         name: ionic-core
         path: ./core
         filename: CoreBuild.zip
-    - name: Install Dependencies
+    - name: 🕸️ Install Dependencies
       run: npm install
       shell: bash
       working-directory: ./core
-    - name: Test
+    - name: 🧪 Test
       if: inputs.update != 'true'
       run: npm run test.e2e.docker.ci ${{ inputs.component }} -- --shard=${{ inputs.shard }}/${{ inputs.totalShards }}
       shell: bash
@@ -60,13 +60,13 @@ runs:
         fi
       shell: bash
       working-directory: ./core
-    - name: Archive Updated Screenshots
+    - name: 📦 Archive Updated Screenshots
       if: inputs.update == 'true' && steps.test-and-update.outputs.hasUpdatedScreenshots == 'true'
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v5
       with:
         name: updated-screenshots-${{ inputs.shard }}-${{ inputs.totalShards }}
         path: UpdatedScreenshots-${{ inputs.shard }}-${{ inputs.totalShards }}.zip
-    - name: Archive Test Results
+    - name: 📦 Archive Test Results
       # The always() ensures that this step
       # runs even if the previous step fails.
       # We want the test results to be archived

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

@@ -6,14 +6,14 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
-    - name: Install Dependencies
+        node-version: 24.x
+    - name: 🕸️ Install Dependencies
       run: npm ci
       working-directory: ./core
       shell: bash
-    - name: Install Stencil ${{ inputs.stencil-version }}
+    - name: 📦 Install Stencil ${{ inputs.stencil-version }}
       run: npm install @stencil/core@${{ inputs.stencil-version }}
       shell: bash
       working-directory: ./core
@@ -23,7 +23,7 @@ runs:
         name: ionic-core
         path: ./core
         filename: CoreBuild.zip
-    - name: Test
+    - name: 🧪 Test
       run: npm run test.spec -- --ci
       shell: bash
       working-directory: ./core

.github/workflows/actions/test-react-e2e/action.yml

@@ -6,9 +6,9 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
+        node-version: 24.x
     - uses: ./.github/workflows/actions/download-archive
       with:
         name: ionic-core
@@ -24,23 +24,23 @@ runs:
         name: ionic-react-router
         path: ./packages/react-router
         filename: ReactRouterBuild.zip
-    - name: Create Test App
+    - name: 🧪 Create Test App
       run: ./build.sh ${{ inputs.app }}
       shell: bash
       working-directory: ./packages/react/test
-    - name: Install Dependencies
+    - name: 🕸️ Install Dependencies
       run: npm install
       shell: bash
       working-directory: ./packages/react/test/build/${{ inputs.app }}
-    - name: Sync Built Changes
+    - name: 🔄 Sync Built Changes
       run: npm run sync
       shell: bash
       working-directory: ./packages/react/test/build/${{ inputs.app }}
-    - name: Build
+    - name: 🏗️ Build
       run: npm run build
       shell: bash
       working-directory: ./packages/react/test/build/${{ inputs.app }}
-    - name: Run Tests
+    - name: 🧪 Run Tests
       run: npm run e2e
       shell: bash
       working-directory: ./packages/react/test/build/${{ inputs.app }}

.github/workflows/actions/test-react-router-e2e/action.yml

@@ -6,9 +6,9 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
+        node-version: 24.x
     - uses: ./.github/workflows/actions/download-archive
       with:
         name: ionic-core
@@ -24,23 +24,23 @@ runs:
         name: ionic-react-router
         path: ./packages/react-router
         filename: ReactRouterBuild.zip
-    - name: Create Test App
+    - name: 🧪 Create Test App
       run: ./build.sh ${{ inputs.app }}
       shell: bash
       working-directory: ./packages/react-router/test
-    - name: Install Dependencies
+    - name: 🕸️ Install Dependencies
       run: npm install
       shell: bash
       working-directory: ./packages/react-router/test/build/${{ inputs.app }}
-    - name: Sync Built Changes
+    - name: 🔄 Sync Built Changes
       run: npm run sync
       shell: bash
       working-directory: ./packages/react-router/test/build/${{ inputs.app }}
-    - name: Build
+    - name: 🏗️ Build
       run: npm run build
       shell: bash
       working-directory: ./packages/react-router/test/build/${{ inputs.app }}
-    - name: Run Tests
+    - name: 🧪 Run Tests
       run: npm run e2e
       shell: bash
       working-directory: ./packages/react-router/test/build/${{ inputs.app }}

.github/workflows/actions/test-vue-e2e/action.yml

@@ -6,9 +6,9 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
+        node-version: 24.x
     - uses: ./.github/workflows/actions/download-archive
       with:
         name: ionic-core
@@ -24,23 +24,23 @@ runs:
         name: ionic-vue-router
         path: ./packages/vue-router
         filename: VueRouterBuild.zip
-    - name: Create Test App
+    - name: 🧪 Create Test App
       run: ./build.sh ${{ inputs.app }}
       shell: bash
       working-directory: ./packages/vue/test
-    - name: Install Dependencies
+    - name: 📦 Install Dependencies
       run: npm install
       shell: bash
       working-directory: ./packages/vue/test/build/${{ inputs.app }}
-    - name: Sync
+    - name: 🔄 Sync
       run: npm run sync
       shell: bash
       working-directory: ./packages/vue/test/build/${{ inputs.app }}
-    - name: Run Spec Tests
+    - name: 🧪 Run Spec Tests
       run: npm run test:unit
       shell: bash
       working-directory: ./packages/vue/test/build/${{ inputs.app }}
-    - name: Run E2E Tests
+    - name: 🧪 Run E2E Tests
       run: npm run test:e2e
       shell: bash
       working-directory: ./packages/vue/test/build/${{ inputs.app }}

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

@@ -7,13 +7,13 @@ on:
 runs:
   using: 'composite'
   steps:
-    - uses: actions/setup-node@v5
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
-        node-version: 22.x
-    - uses: actions/download-artifact@v5
+        node-version: 24.x
+    - uses: actions/download-artifact@v6
       with:
         path: ./artifacts
-    - name: Extract Archives
+    - name: 🔎 Extract Archives
       # This finds all .zip files in the ./artifacts
       # directory, including nested directories.
       # It then unzips every .zip to the root directory
@@ -21,7 +21,7 @@ runs:
         find . -type f -name 'UpdatedScreenshots-*.zip' -exec unzip -q -o -d ../ {} \;
       shell: bash
       working-directory: ./artifacts
-    - name: Push Screenshots
+    - name: 📸 Push Screenshots
       # Configure user as Ionitron
       # and push only the changed .png snapshots
       # to the remote branch.

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

@@ -10,10 +10,10 @@ inputs:
 runs:
   using: 'composite'
   steps:
-    - name: Create Archive
+    - name: 🗄️ Create Archive
       run: zip -q -r ${{ inputs.output }} ${{ inputs.paths }}
       shell: bash
-    - uses: actions/upload-artifact@v4
+    - uses: actions/upload-artifact@v5
       with:
         name: ${{ inputs.name }}
         path: ${{ inputs.output }}

.github/workflows/build.yml

@@ -22,7 +22,7 @@ jobs:
   build-core:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       - uses: ./.github/workflows/actions/build-core
         with:
           ionicons-version: ${{ inputs.ionicons_npm_release_tag }}
@@ -31,21 +31,21 @@ jobs:
     needs: [build-core]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       - uses: ./.github/workflows/actions/test-core-clean-build
 
   test-core-lint:
     needs: [build-core]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       - uses: ./.github/workflows/actions/test-core-lint
 
   test-core-spec:
     needs: [build-core]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       - uses: ./.github/workflows/actions/test-core-spec
 
   test-core-screenshot:
@@ -62,7 +62,7 @@ jobs:
     needs: [build-core]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       - uses: ./.github/workflows/actions/test-core-screenshot
         with:
           shard: ${{ matrix.shard }}
@@ -90,14 +90,14 @@ jobs:
     needs: [build-core]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/build-vue
 
   build-vue-router:
     needs: [build-vue]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/build-vue-router
 
   test-vue-e2e:
@@ -108,7 +108,7 @@ jobs:
     needs: [build-vue, build-vue-router]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/test-vue-e2e
       with:
         app: ${{ matrix.apps }}
@@ -126,14 +126,14 @@ jobs:
     needs: [build-core]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/build-angular
 
   build-angular-server:
     needs: [build-core]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/build-angular-server
 
   test-angular-e2e:
@@ -144,7 +144,7 @@ jobs:
     needs: [build-angular, build-angular-server]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/test-angular-e2e
       with:
         app: ${{ matrix.apps }}
@@ -162,14 +162,14 @@ jobs:
     needs: [build-core]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/build-react
 
   build-react-router:
     needs: [build-react]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/build-react-router
 
   test-react-router-e2e:
@@ -180,7 +180,7 @@ jobs:
     needs: [build-react, build-react-router]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/test-react-router-e2e
       with:
         app: ${{ matrix.apps }}
@@ -202,7 +202,7 @@ jobs:
     needs: [build-react, build-react-router]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/test-react-e2e
       with:
         app: ${{ matrix.apps }}

.github/workflows/codeql-analysis.yml

@@ -14,8 +14,8 @@ jobs:
     permissions:
       security-events: write
     steps:
-      - uses: actions/checkout@v5
-      - uses: github/codeql-action/init@v3
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - uses: github/codeql-action/init@v4
         with:
           languages: javascript
-      - uses: github/codeql-action/analyze@v3
+      - uses: github/codeql-action/analyze@v4

.github/workflows/dev-build.yml

@@ -9,7 +9,7 @@ jobs:
     outputs:
       dev-hash: ${{ steps.create-dev-hash.outputs.DEV_HASH }}
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       # A 1 is required before the timestamp
       # as lerna will fail when there is a leading 0
       # See https://github.com/lerna/lerna/issues/2840
@@ -30,8 +30,6 @@ jobs:
     with:
       tag: dev
       version: ${{ needs.create-dev-hash.outputs.dev-hash }}
-    secrets:
-      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
 
   get-build:
     name: Get your dev build!

.github/workflows/nightly.yml

@@ -12,7 +12,7 @@ jobs:
     outputs:
       nightly-hash: ${{ steps.create-nightly-hash.outputs.NIGHTLY_HASH }}
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       # A 1 is required before the timestamp
       # as lerna will fail when there is a leading 0
       # See https://github.com/lerna/lerna/issues/2840
@@ -35,5 +35,3 @@ jobs:
     with:
       tag: nightly
       version: ${{ needs.create-nightly-hash.outputs.nightly-hash }}
-    secrets:
-      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/release-ionic.yml

@@ -14,15 +14,16 @@ on:
       preid:
         description: 'The prerelease identifier used when doing a prerelease.'
         type: string
-    secrets:
-      NPM_TOKEN:
-        required: true
+
+permissions:
+  contents: read
+  id-token: write
 
 jobs:
   release-core:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/publish-npm
       with:
         scope: '@ionic/core'
@@ -30,7 +31,6 @@ jobs:
         version: ${{ inputs.version }}
         preid: ${{ inputs.preid }}
         working-directory: 'core'
-        token: ${{ secrets.NPM_TOKEN }}
     - name: Cache Built @ionic/core
       uses: ./.github/workflows/actions/upload-archive
       with:
@@ -48,7 +48,7 @@ jobs:
     needs: [release-core]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - name: Restore @ionic/docs built cache
       uses: ./.github/workflows/actions/download-archive
       with:
@@ -62,13 +62,12 @@ jobs:
         version: ${{ inputs.version }}
         preid: ${{ inputs.preid }}
         working-directory: 'packages/docs'
-        token: ${{ secrets.NPM_TOKEN }}
 
   release-angular:
     needs: [release-core]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - name: Restore @ionic/core built cache
       uses: ./.github/workflows/actions/download-archive
       with:
@@ -83,7 +82,6 @@ jobs:
         preid: ${{ inputs.preid }}
         working-directory: 'packages/angular'
         folder: './dist'
-        token: ${{ secrets.NPM_TOKEN }}
     - name: Cache Built @ionic/angular
       uses: ./.github/workflows/actions/upload-archive
       with:
@@ -95,7 +93,7 @@ jobs:
     needs: [release-core]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - name: Restore @ionic/core built cache
       uses: ./.github/workflows/actions/download-archive
       with:
@@ -109,7 +107,6 @@ jobs:
         version: ${{ inputs.version }}
         preid: ${{ inputs.preid }}
         working-directory: 'packages/react'
-        token: ${{ secrets.NPM_TOKEN }}
     - name: Cache Built @ionic/react
       uses: ./.github/workflows/actions/upload-archive
       with:
@@ -121,7 +118,7 @@ jobs:
     needs: [release-core]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - name: Restore @ionic/core built cache
       uses: ./.github/workflows/actions/download-archive
       with:
@@ -135,7 +132,6 @@ jobs:
         version: ${{ inputs.version }}
         preid: ${{ inputs.preid }}
         working-directory: 'packages/vue'
-        token: ${{ secrets.NPM_TOKEN }}
     - name: Cache Built @ionic/vue
       uses: ./.github/workflows/actions/upload-archive
       with:
@@ -147,7 +143,7 @@ jobs:
     needs: [release-core]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - name: Restore @ionic/core built cache
       uses: ./.github/workflows/actions/download-archive
       with:
@@ -162,13 +158,12 @@ jobs:
         preid: ${{ inputs.preid }}
         working-directory: 'packages/angular-server'
         folder: './dist'
-        token: ${{ secrets.NPM_TOKEN }}
 
   release-react-router:
     needs: [release-react]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - name: Restore @ionic/core built cache
       uses: ./.github/workflows/actions/download-archive
       with:
@@ -188,13 +183,12 @@ jobs:
         version: ${{ inputs.version }}
         preid: ${{ inputs.preid }}
         working-directory: 'packages/react-router'
-        token: ${{ secrets.NPM_TOKEN }}
 
   release-vue-router:
     needs: [release-vue]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - name: Restore @ionic/core built cache
       uses: ./.github/workflows/actions/download-archive
       with:
@@ -214,4 +208,3 @@ jobs:
         version: ${{ inputs.version }}
         preid: ${{ inputs.preid }}
         working-directory: 'packages/vue-router'
-        token: ${{ secrets.NPM_TOKEN }}

.github/workflows/release.yml

@@ -25,6 +25,7 @@ on:
       preid:
         type: choice
         description: Which prerelease identifier should be used? This is only needed when version is "prepatch", "preminor", "premajor", or "prerelease".
+        default: ''
         options:
           - ''
           - alpha
@@ -35,20 +36,19 @@ on:
 jobs:
   release-ionic:
     permissions:
+      contents: read
       id-token: write
     uses: ./.github/workflows/release-ionic.yml
     with:
       tag: ${{ inputs.tag }}
       version: ${{ inputs.version }}
       preid: ${{ inputs.preid }}
-    secrets:
-      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
 
   finalize-release:
     needs: [release-ionic]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       with:
         token: ${{ secrets.IONITRON_TOKEN }}
         fetch-depth: 0
@@ -76,7 +76,7 @@ jobs:
     needs: [finalize-release]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
         # Pull the latest version of the reference
         # branch instead of the revision that triggered
         # the workflow otherwise we won't get the commit

.github/workflows/stencil-nightly.yml

@@ -26,7 +26,7 @@ jobs:
   build-core-with-stencil-nightly:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       - uses: ./.github/workflows/actions/build-core-stencil-prerelease
         with:
           stencil-version: ${{ inputs.npm_release_tag || 'nightly' }}
@@ -35,21 +35,21 @@ jobs:
     needs: [build-core-with-stencil-nightly]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       - uses: ./.github/workflows/actions/test-core-clean-build
 
   test-core-lint:
     needs: [build-core-with-stencil-nightly]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       - uses: ./.github/workflows/actions/test-core-lint
 
   test-core-spec:
     needs: [build-core-with-stencil-nightly]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       - uses: ./.github/workflows/actions/test-core-spec
         with:
           stencil-version: ${{ inputs.npm_release_tag || 'nightly' }}
@@ -72,7 +72,7 @@ jobs:
     needs: [build-core-with-stencil-nightly]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       - uses: ./.github/workflows/actions/test-core-screenshot
         with:
           shard: ${{ matrix.shard }}
@@ -100,14 +100,14 @@ jobs:
     needs: [build-core-with-stencil-nightly]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/build-vue
 
   build-vue-router:
     needs: [build-vue]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/build-vue-router
 
   test-vue-e2e:
@@ -118,7 +118,7 @@ jobs:
     needs: [build-vue, build-vue-router]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/test-vue-e2e
       with:
         app: ${{ matrix.apps }}
@@ -136,14 +136,14 @@ jobs:
     needs: [build-core-with-stencil-nightly]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/build-angular
 
   build-angular-server:
     needs: [build-core-with-stencil-nightly]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/build-angular-server
 
   test-angular-e2e:
@@ -154,7 +154,7 @@ jobs:
     needs: [build-angular, build-angular-server]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/test-angular-e2e
       with:
         app: ${{ matrix.apps }}
@@ -172,14 +172,14 @@ jobs:
     needs: [build-core-with-stencil-nightly]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/build-react
 
   build-react-router:
     needs: [build-react]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/build-react-router
 
   test-react-router-e2e:
@@ -190,7 +190,7 @@ jobs:
     needs: [build-react, build-react-router]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/test-react-router-e2e
       with:
         app: ${{ matrix.apps }}
@@ -212,7 +212,7 @@ jobs:
     needs: [build-react, build-react-router]
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
     - uses: ./.github/workflows/actions/test-react-e2e
       with:
         app: ${{ matrix.apps }}
@@ -225,3 +225,35 @@ jobs:
       - name: Check build matrix status
         if: ${{ needs.test-react-e2e.result != 'success' }}
         run: exit 1
+
+  send-success-messages:
+    needs: [test-core-clean-build, test-core-lint, test-core-spec, verify-screenshots, verify-test-vue-e2e, verify-test-angular-e2e, verify-test-react-router-e2e, verify-test-react-e2e]
+    runs-on: ubuntu-latest
+    if: ${{ !cancelled() && contains(needs.*.result, 'success') }}
+    steps:
+      - name: Notify success on Discord
+        run: |
+          curl -H "Content-Type:application/json" \
+          -d '{"embeds": [{"title": "✅ Workflow ${{github.workflow}} #${{github.run_number}} finished successfully", "color": 65280, "url": "${{github.server_url}}/${{github.repository}}/actions/runs/${{github.run_id}}"}]}' \
+          ${{secrets.DISCORD_NOTIFY_WEBHOOK}}
+      - name: Notify success on Slack
+        run: |
+          curl -H "Content-Type:application/json" \
+          -d '{"title": "✅ Workflow ${{github.workflow}} #${{github.run_number}} finished successfully", "url": "${{github.server_url}}/${{github.repository}}/actions/runs/${{github.run_id}}"}' \
+          ${{secrets.SLACK_NOTIFY_SUCCESS_WEBHOOK}}
+
+  send-failure-messages:
+    needs: [test-core-clean-build, test-core-lint, test-core-spec, verify-screenshots, verify-test-vue-e2e, verify-test-angular-e2e, verify-test-react-router-e2e, verify-test-react-e2e]
+    runs-on: ubuntu-latest
+    if: ${{ !cancelled() && contains(needs.*.result, 'failure') }}
+    steps:
+      - name: Notify failure on Discord
+        run: |
+          curl -H "Content-Type:application/json" \
+          -d '{"content": "Alerting <@&1347593178580254761>!", "embeds": [{"title": "❌ Workflow ${{github.workflow}} #${{github.run_number}} failed", "color": 16711680, "url": "${{github.server_url}}/${{github.repository}}/actions/runs/${{github.run_id}}"}]}' \
+          ${{secrets.DISCORD_NOTIFY_WEBHOOK}}
+      - name: Notify failure on Slack
+        run: |
+          curl -H "Content-Type:application/json" \
+          -d '{"title": "❌ Workflow ${{github.workflow}} #${{github.run_number}} failed", "url": "${{github.server_url}}/${{github.repository}}/actions/runs/${{github.run_id}}"}' \
+          ${{secrets.SLACK_NOTIFY_FAILURE_WEBHOOK}}

.github/workflows/update-screenshots.yml

@@ -26,7 +26,7 @@ jobs:
   build-core:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       - uses: ./.github/workflows/actions/build-core
 
   test-core-screenshot:
@@ -47,7 +47,7 @@ jobs:
     needs: [build-core]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
       - uses: ./.github/workflows/actions/test-core-screenshot
         with:
           shard: ${{ matrix.shard }}
@@ -59,7 +59,7 @@ jobs:
     runs-on: ubuntu-latest
     needs: [test-core-screenshot]
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
         # Normally, we could just push with the
         # default GITHUB_TOKEN, but that will
         # not cause the build workflow

BREAKING.md

@@ -4,134 +4,290 @@ This is a comprehensive list of the breaking changes introduced in the major ver
 
 ## Versions
 
-- [Version 9.x](#version-9x)
-- [Version 8.x](./BREAKING_ARCHIVE/v8.md)
+- [Version 8.x](#version-8x)
 - [Version 7.x](./BREAKING_ARCHIVE/v7.md)
 - [Version 6.x](./BREAKING_ARCHIVE/v6.md)
 - [Version 5.x](./BREAKING_ARCHIVE/v5.md)
 - [Version 4.x](./BREAKING_ARCHIVE/v4.md)
 - [Legacy](https://github.com/ionic-team/ionic-v3/blob/master/CHANGELOG.md)
 
-## Version 9.x
+## Version 8.x
 
-- [Components](#version-9x-components)
-  - [Button](#version-9x-button)
-  - [Card](#version-9x-card)
-  - [Chip](#version-9x-chip)
-  - [Grid](#version-9x-grid)
+- [Browser and Platform Support](#version-8x-browser-platform-support)
+- [Dark Mode](#version-8x-dark-mode)
+- [Global Styles](#version-8x-global-styles)
+- [Haptics](#version-8x-haptics)
+- [Components](#version-8x-components)
+  - [Button](#version-8x-button)
+  - [Checkbox](#version-8x-checkbox)
+  - [Content](#version-8x-content)
+  - [Datetime](#version-8x-datetime)
+  - [Input](#version-8x-input)
+  - [Item](#version-8x-item)
+  - [Modal](#version-8x-modal)
+  - [Nav](#version-8x-nav)
+  - [Picker](#version-8x-picker)
+  - [Progress bar](#version-8x-progress-bar)
+  - [Radio](#version-8x-radio)
+  - [Range](#version-8x-range)
+  - [Searchbar](#version-8x-searchbar)
+  - [Select](#version-8x-select)
+  - [Textarea](#version-8x-textarea)
+  - [Toggle](#version-8x-toggle)
+- [Framework Specific](#version-8x-framework-specific)
+  - [Angular](#version-8x-angular)
 
-<h2 id="version-9x-components">Components</h2>
+<h2 id="version-8x-browser-platform-support">Browser and Platform Support</h2>
 
-<h4 id="version-9x-button">Button</h4>
+This section details the desktop browser, JavaScript framework, and mobile platform versions that are supported by Ionic 8.
 
-- The `border-radius` of the `ios` and `md` button now defaults to `6px` and `999px` instead of `14px` and `4px`, respectively, in accordance with the iOS and Material Design 3 guidelines. To revert to the previous appearance, set the `shape` to `"soft"` for `md` and override the `--border-radius` CSS variable for `ios` to `14px`, or set it to a different value entirely.
+**Minimum Browser Versions**
+| Desktop Browser | Supported Versions |
+| --------------- | ----------------- |
+| Chrome          | 89+               |
+| Safari          | 15+               |
+| Firefox         | 75+               |
+| Edge            | 89+               |
 
-<h4 id="version-9x-card">Card</h4>
+**Minimum JavaScript Framework Versions**
+| Framework | Supported Version     |
+| --------- | --------------------- |
+| Angular   | 16+                   |
+| React     | 17+                   |
+| Vue       | 3.0.6+                |
 
-- The `border-radius` of the `ios` and `md` card now defaults to `14px` and `12px` instead of `8px` and `4px`, respectively, in accordance with the iOS and Material Design 3 guidelines. To revert to the previous appearance, set the `shape` to `"soft"`, or override the `--border-radius` CSS variable to specify a different value.
+**Minimum Mobile Platform Versions**
+| Platform | Supported Version      |
+| -------- | ---------------------- |
+| iOS      | 15+                    |
+| Android  | 5.1+ with Chromium 89+ |
 
-<h4 id="version-9x-chip">Chip</h4>
+Ionic Framework v8 removes backwards support for CSS Animations in favor of the [Web Animations API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API). All minimum browser versions listed above support the Web Animations API.
 
-- The `border-radius` of the `ios` and `md` chip now defaults to `10px` and `8px`, respectively, instead of `16px` in accordance with the iOS and Material Design 3 guidelines. To revert to the previous appearance, set the `shape` to `"round"`, or override the `--border-radius` CSS variable to specify a different value.
+<h2 id="version-8x-dark-mode">Dark Mode</h2>
 
-<h4 id="version-9x-grid">Grid</h4>
 
-- The properties `pull` and `push` have been deprecated and no longer work. A similar look can be achieved with the newly added property `order`.
+In previous versions, it was recommended to define the dark palette in the following way:
 
-<h5>Example 1: Swap two columns</h5>
+```css
+@media (prefers-color-scheme: dark) {
+  body {
+    /* global app variables */
+  }
 
-**Version up to 8.x**
-```html
-<ion-grid>
-  <ion-row>
-    <ion-col push="4">1</ion-col>
-    <ion-col pull="4">2</ion-col>
-    <ion-col>3</ion-col>
-  </ion-row>
-</ion-grid>
-```
-**Version 9.x+**
-```html
-<ion-grid>
-  <ion-row>
-    <ion-col order="2">1</ion-col>
-    <ion-col order="1">2</ion-col>
-    <ion-col order="3">3</ion-col>
-  </ion-row>
-</ion-grid>
+  .ios body {
+    /* global ios app variables */
+  }
+
+  .md body {
+    /* global md app variables */
+  }
+}
 ```
 
-<h5>Example 2: Reorder columns with specific sizes</h5>
-To reorder two columns where column 1 has `size="9" push="3"` and column 2 has `size="3" pull="9"`:
+In Ionic Framework version 8, the dark palette is being distributed via css files that can be imported. Below is an example of importing a dark palette file in Angular:
 
-**Version up to 8.x**
-```html
-<ion-grid>
-  <ion-row>
-    <ion-col push="3">1</ion-col>
-    <ion-col pull="9">2</ion-col>
-  </ion-row>
-</ion-grid>
-```
-**Version 9.x+**
-```html
-<ion-grid>
-  <ion-row>
-    <ion-col order="2">1</ion-col>
-    <ion-col size="3" order="1">2</ion-col>
-  </ion-row>
-</ion-grid>
-```
-<h5>Example 3: Push</h5>
-```html
-<ion-grid>
-  <ion-row>
-    <ion-col size="auto" push="1">
-      <div>ion-col push 1</div>
-    </ion-col>
-    <ion-col size="auto" push="1">
-      <div>ion-col push 1</div>
-    </ion-col>
-  </ion-row>
-</ion-grid>
-```
-**Version 9.x+**
-```html
-<ion-grid>
-  <ion-row>
-    <ion-col size="auto" offset="1">
-      <div>ion-col size="auto" offset="1"</div>
-    </ion-col>
-    <ion-col size="auto">
-      <div>ion-col size="auto"</div>
-    </ion-col>
-  </ion-row>
-</ion-grid>
+```css
+/* @import '@ionic/angular/css/palettes/dark.always.css'; */
+/* @import "@ionic/angular/css/palettes/dark.class.css"; */
+@import "@ionic/angular/css/palettes/dark.system.css";
 ```
 
-<h5>Example 4: Push and Pull</h5>
-```html
-<ion-grid>
-  <ion-row>
-    <ion-col size="3" size-md="6" push="9" push-md="6">
-      <div>ion-col size="3" size-md="6" push="9" push-md="6"</div>
-    </ion-col>
-    <ion-col size="9" size-md="6" pull="3" pull-md="6">
-      <div>ion-col size="9" size-md="6" pull="3" pull-md="6"</div>
-    </ion-col>
-  </ion-row>
-</ion-grid>
+By importing the `dark.system.css` file, the dark palette variables will be defined like the following:
+
+```css
+@media (prefers-color-scheme: dark) {
+  :root {
+    /* global app variables */
+  }
+
+  :root.ios {
+    /* global ios app variables */
+  }
+
+  :root.md {
+    /* global md app variables */
+  }
+}
 ```
-**Version 9.x+**
-```html
-<ion-grid>
-  <ion-row>
-    <ion-col size="auto" order="2" order-md="2">
-      <div>ion-col size="auto" order="2" order-md="2"</div>
-    </ion-col>
-    <ion-col size="auto" order="1" order-md="1">
-      <div>ion-col size="auto" order="1" order-md="1"</div>
-    </ion-col>
-  </ion-row>
-</ion-grid>
-```
+
+Notice that the dark palette is now applied to the `:root` selector instead of the `body` selector. The [`:root`](https://developer.mozilla.org/en-US/docs/Web/CSS/:root) selector represents the `<html>` element and is identical to the selector `html`, except that its specificity is higher.
+
+While migrating to include the new dark palette files is unlikely to cause breaking changes, these new selectors can lead to unexpected overrides if custom CSS variables are being set on the `body` element. We recommend updating any instances where global application variables are set to target the `:root` selector instead.
+
+For more information on the new dark palette files, refer to the [Dark Mode documentation](https://ionicframework.com/docs/theming/dark-mode).
+
+<h2 id="version-8x-global-styles">Global Styles</h2>
+
+<h4 id="version-8x-text-color">Text Color</h4>
+
+The `core.css` file has been updated to set the text color on the `body` element:
+
+```diff
+body {
++  color: var(--ion-text-color);
+}
+```
+
+This allows components to inherit the color properly when used outside of Ionic Framework and is required for custom themes to work properly. However, it may have unintentional side effects in apps if the color was not expected to inherit.
+
+<h4 id="version-8x-dynamic-font">Dynamic Font</h4>
+
+The `core.css` file has been updated to enable dynamic font scaling by default.
+
+The `--ion-default-dynamic-font` variable has been removed and replaced with `--ion-dynamic-font`.
+
+Developers who had previously chosen dynamic font scaling by activating it in their global stylesheets can revert to the default setting by removing their custom CSS. In doing so, their application will seamlessly continue utilizing dynamic font scaling as it did before. It's essential to note that altering the font-size of the html element should be avoided, as it may disrupt the proper functioning of dynamic font scaling.
+
+Developers who want to disable dynamic font scaling can set `--ion-dynamic-font: initial;` in their global stylesheets. However, this is not recommended because it may introduce accessibility challenges for users who depend on enlarged font sizes.
+
+For more information on the dynamic font, refer to the [Dynamic Font Scaling documentation](https://ionicframework.com/docs/layout/dynamic-font-scaling).
+
+<h2 id="version-8x-haptics">Haptics</h2>
+
+- Support for the Cordova Haptics plugin has been removed. Components that integrate with haptics, such as `ion-picker` and `ion-toggle`, will continue to function but will no longer play haptics in Cordova environments. Developers should migrate to Capacitor to continue to have haptics in these components.
+
+<h2 id="version-8x-components">Components</h2>
+
+<h4 id="version-8x-button">Button</h4>
+
+- Button text now wraps by default. If this behavior is not desired, add the `ion-text-nowrap` class from the [CSS Utilities](https://ionicframework.com/docs/layout/css-utilities).
+
+<h4 id="version-8x-checkbox">Checkbox</h4>
+
+ The `legacy` property and support for the legacy syntax, which involved placing an `ion-checkbox` inside of an `ion-item` with an `ion-label`, have been removed. For more information on migrating from the legacy checkbox syntax, refer to the [Checkbox documentation](https://ionicframework.com/docs/api/checkbox#migrating-from-legacy-checkbox-syntax).
+
+<h4 id="version-8x-content">Content</h4>
+
+- Content no longer sets the `--background` custom property when the `.outer-content` class is set on the host.
+
+<h4 id="version-8x-datetime">Datetime</h4>
+
+- The CSS shadow part for `month-year-button` has been changed to target a `button` element instead of `ion-item`. Developers should verify their UI renders as expected for the month/year toggle button inside of `ion-datetime`.
+   - Developers using the CSS variables available on `ion-item` will need to migrate their CSS to use CSS properties. For example:
+      ```diff
+      ion-datetime::part(month-year-button) {
+      -  --background: red;
+
+      +  background: red;
+      }
+      ```
+
+<h4 id="version-8x-input">Input</h4>
+
+- `size` has been removed from the `ion-input` component. Developers should use CSS to specify the visible width of the input.
+- `accept` has been removed from the `ion-input` component. This was previously used in conjunction with the `type="file"`. However, the `file` value for `type` is not a valid value in Ionic Framework.
+- The `legacy` property and support for the legacy syntax, which involved placing an `ion-input` inside of an `ion-item` with an `ion-label`, have been removed. For more information on migrating from the legacy input syntax, refer to the [Input documentation](https://ionicframework.com/docs/api/input#migrating-from-legacy-input-syntax).
+
+<h4 id="version-8x-item">Item</h4>
+
+- The `helper` slot has been removed. Developers should use the `helperText` property on `ion-input` and `ion-textarea`.
+- The `error` slot has been removed. Developers should use the `errorText` property on `ion-input` and `ion-textarea`.
+- Counter functionality has been removed including the `counter` and `counterFormatter` properties. Developers should use the properties of the same name on `ion-input` and `ion-textarea`.
+- The `fill` property has been removed. Developers should use the property of the same name on `ion-input`, `ion-select`, and `ion-textarea`.
+- The `shape` property has been removed. Developers should use the property of the same name on `ion-input`, `ion-select`, and `ion-textarea`.
+- Item no longer automatically delegates focus to the first focusable element. While most developers should not need to make any changes to account for this update, usages of `ion-item` with interactive elements such as form controls (inputs, textareas, etc) should be evaluated to verify that interactions still work as expected.
+
+<h5>CSS variables</h4>
+
+The following deprecated CSS variables have been removed: `--highlight-height`, `--highlight-color-focused`, `--highlight-color-valid`, and `--highlight-color-invalid`. These variables were used on the bottom border highlight of an item when the form control inside of that item was focused. The form control syntax was [simplified in v7](https://ionic.io/blog/ionic-7-is-here#simplified-form-control-syntax) so that inputs, selects, and textareas would no longer be required to be used inside of an item.
+
+If you have not yet migrated to the modern form control syntax, migration guides for each of the form controls that added a highlight to item can be found below:
+- [Input migration documentation](https://ionicframework.com/docs/api/input#migrating-from-legacy-input-syntax)
+- [Select migration documentation](https://ionicframework.com/docs/api/select#migrating-from-legacy-select-syntax)
+- [Textarea migration documentation](https://ionicframework.com/docs/api/textarea#migrating-from-legacy-textarea-syntax)
+
+Once all form controls are using the modern syntax, the same variables can be used to customize them from the form control itself:
+
+| Name                        | Description                             |
+| ----------------------------| ----------------------------------------|
+| `--highlight-color-focused` | The color of the highlight when focused |
+| `--highlight-color-invalid` | The color of the highlight when invalid |
+| `--highlight-color-valid`   | The color of the highlight when valid   |
+| `--highlight-height`        | The height of the highlight indicator   |
+
+The following styles for item:
+
+```css
+ion-item {
+  --highlight-color-focused: purple;
+  --highlight-color-valid: blue;
+  --highlight-color-invalid: orange;
+  --highlight-height: 6px;
+}
+```
+
+will instead be applied on the form controls:
+
+```css
+ion-input,
+ion-textarea,
+ion-select {
+  --highlight-color-focused: purple;
+  --highlight-color-valid: blue;
+  --highlight-color-invalid: orange;
+  --highlight-height: 6px;
+}
+```
+
+> [!NOTE]
+> The input and textarea components are scoped, which means they will automatically scope their CSS by appending each of the styles with an additional class at runtime. Overriding scoped selectors in CSS requires a [higher specificity](https://developer.mozilla.org/en-US/docs/Web/CSS/Specificity) selector. Targeting the `ion-input` or `ion-textarea` for customization will not work; therefore we recommend adding a class and customizing it that way.
+
+<h4 id="version-8x-modal">Modal</h4>
+
+- Detection for Capacitor <= 2 with applying status bar styles has been removed. Developers should ensure they are using Capacitor 3 or later when using the card modal presentation.
+
+<h4 id="version-8x-nav">Nav</h4>
+
+- `getLength` returns `Promise<number>` instead of `<number>`. This method was not previously available in Nav's TypeScript interface, but developers could still access it by casting Nav as `any`. Developers should ensure they `await` their `getLength` call before accessing the returned value.
+
+<h4 id="version-8x-picker">Picker</h4>
+
+- `ion-picker` and `ion-picker-column` have been renamed to `ion-picker-legacy` and `ion-picker-legacy-column`, respectively. This change was made to accommodate the new inline picker component while allowing developers to continue to use the legacy picker during this migration period.
+  - Only the component names have been changed. Usages such as `ion-picker` or `IonPicker` should be changed to `ion-picker-legacy` and `IonPickerLegacy`, respectively.
+  - Non-component usages such as `pickerController` or `useIonPicker` remain unchanged. The new picker displays inline with your page content and does not have equivalents for these non-component usages.
+
+<h4 id="version-8x-progress-bar">Progress bar</h4>
+
+- The `--buffer-background` CSS variable has been removed. Use `--background` instead.
+
+<h4 id="version-8x-toast">Toast</h4>
+
+- `cssClass` has been removed from the `ToastButton` interface. This was previously used to apply a custom class to the toast buttons. Developers can use the "button" shadow part to style the buttons.
+
+For more information on styling toast buttons, refer to the [Toast Theming documentation](https://ionicframework.com/docs/api/toast#theming).
+
+<h4 id="version-8x-radio">Radio</h4>
+
+- The `legacy` property and support for the legacy syntax, which involved placing an `ion-radio` inside of an `ion-item` with an `ion-label`, have been removed. For more information on migrating from the legacy radio syntax, refer to the [Radio documentation](https://ionicframework.com/docs/api/radio#migrating-from-legacy-radio-syntax).
+
+<h4 id="version-8x-range">Range</h4>
+
+- The `legacy` property and support for the legacy syntax, which involved placing an `ion-range` inside of an `ion-item` with an `ion-label`, have been removed. Ionic will also no longer attempt to automatically associate form controls with sibling `<label>` elements as these label elements are now used inside the form control. Developers should provide a label (either visible text or `aria-label`) directly to the form control. For more information on migrating from the legacy range syntax, refer to the [Range documentation](https://ionicframework.com/docs/api/range#migrating-from-legacy-range-syntax).
+
+<h4 id="version-8x-searchbar">Searchbar</h4>
+
+- The `autocapitalize` property now defaults to `'off'`.
+
+<h4 id="version-8x-select">Select</h4>
+
+- The `legacy` property and support for the legacy syntax, which involved placing an `ion-select` inside of an `ion-item` with an `ion-label`, have been removed. Ionic will also no longer attempt to automatically associate form controls with sibling `<label>` elements as these label elements are now used inside the form control. Developers should provide a label (either visible text or `aria-label`) directly to the form control. For more information on migrating from the legacy select syntax, refer to the [Select documentation](https://ionicframework.com/docs/api/select#migrating-from-legacy-select-syntax).
+
+<h4 id="version-8x-textarea">Textarea</h4>
+
+- The `legacy` property and support for the legacy syntax, which involved placing an `ion-textarea` inside of an `ion-item` with an `ion-label`, have been removed. For more information on migrating from the legacy textarea syntax, refer to the [Textarea documentation](https://ionicframework.com/docs/api/textarea#migrating-from-legacy-textarea-syntax).
+
+<h4 id="version-8x-toggle">Toggle</h4>
+
+- The `legacy` property and support for the legacy syntax, which involved placing an `ion-toggle` inside of an `ion-item` with an `ion-label`, have been removed. For more information on migrating from the legacy toggle syntax, refer to the [Toggle documentation](https://ionicframework.com/docs/api/toggle#migrating-from-legacy-toggle-syntax).
+
+<h2 id="version-8x-framework-specific">Framework Specific</h2>
+
+<h4 id="version-8x-angular">Angular</h4>
+
+- The `IonBackButtonDelegate` class has been removed in favor of `IonBackButton`.
+
+  ```diff
+  - import { IonBackButtonDelegate } from '@ionic/angular';
+  + import { IonBackButton } from '@ionic/angular';
+  ```

BREAKING_ARCHIVE/v8.md

@@ -1,282 +0,0 @@
-# Breaking Changes
-
-## Version 8.x
-
-- [Browser and Platform Support](#version-8x-browser-platform-support)
-- [Dark Mode](#version-8x-dark-mode)
-- [Global Styles](#version-8x-global-styles)
-- [Haptics](#version-8x-haptics)
-- [Components](#version-8x-components)
-  - [Button](#version-8x-button)
-  - [Checkbox](#version-8x-checkbox)
-  - [Content](#version-8x-content)
-  - [Datetime](#version-8x-datetime)
-  - [Input](#version-8x-input)
-  - [Item](#version-8x-item)
-  - [Modal](#version-8x-modal)
-  - [Nav](#version-8x-nav)
-  - [Picker](#version-8x-picker)
-  - [Progress bar](#version-8x-progress-bar)
-  - [Radio](#version-8x-radio)
-  - [Range](#version-8x-range)
-  - [Searchbar](#version-8x-searchbar)
-  - [Select](#version-8x-select)
-  - [Textarea](#version-8x-textarea)
-  - [Toggle](#version-8x-toggle)
-- [Framework Specific](#version-8x-framework-specific)
-  - [Angular](#version-8x-angular)
-
-<h2 id="version-8x-browser-platform-support">Browser and Platform Support</h2>
-
-This section details the desktop browser, JavaScript framework, and mobile platform versions that are supported by Ionic 8.
-
-**Minimum Browser Versions**
-| Desktop Browser | Supported Versions |
-| --------------- | ----------------- |
-| Chrome          | 89+               |
-| Safari          | 15+               |
-| Firefox         | 75+               |
-| Edge            | 89+               |
-
-**Minimum JavaScript Framework Versions**
-| Framework | Supported Version     |
-| --------- | --------------------- |
-| Angular   | 16+                   |
-| React     | 17+                   |
-| Vue       | 3.0.6+                |
-
-**Minimum Mobile Platform Versions**
-| Platform | Supported Version      |
-| -------- | ---------------------- |
-| iOS      | 15+                    |
-| Android  | 5.1+ with Chromium 89+ |
-
-Ionic Framework v8 removes backwards support for CSS Animations in favor of the [Web Animations API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API). All minimum browser versions listed above support the Web Animations API.
-
-<h2 id="version-8x-dark-mode">Dark Mode</h2>
-
-
-In previous versions, it was recommended to define the dark palette in the following way:
-
-```css
-@media (prefers-color-scheme: dark) {
-  body {
-    /* global app variables */
-  }
-
-  .ios body {
-    /* global ios app variables */
-  }
-
-  .md body {
-    /* global md app variables */
-  }
-}
-```
-
-In Ionic Framework version 8, the dark palette is being distributed via css files that can be imported. Below is an example of importing a dark palette file in Angular:
-
-```css
-/* @import '@ionic/angular/css/palettes/dark.always.css'; */
-/* @import "@ionic/angular/css/palettes/dark.class.css"; */
-@import "@ionic/angular/css/palettes/dark.system.css";
-```
-
-By importing the `dark.system.css` file, the dark palette variables will be defined like the following:
-
-```css
-@media (prefers-color-scheme: dark) {
-  :root {
-    /* global app variables */
-  }
-
-  :root.ios {
-    /* global ios app variables */
-  }
-
-  :root.md {
-    /* global md app variables */
-  }
-}
-```
-
-Notice that the dark palette is now applied to the `:root` selector instead of the `body` selector. The [`:root`](https://developer.mozilla.org/en-US/docs/Web/CSS/:root) selector represents the `<html>` element and is identical to the selector `html`, except that its specificity is higher.
-
-While migrating to include the new dark palette files is unlikely to cause breaking changes, these new selectors can lead to unexpected overrides if custom CSS variables are being set on the `body` element. We recommend updating any instances where global application variables are set to target the `:root` selector instead.
-
-For more information on the new dark palette files, refer to the [Dark Mode documentation](https://ionicframework.com/docs/theming/dark-mode).
-
-<h2 id="version-8x-global-styles">Global Styles</h2>
-
-<h4 id="version-8x-text-color">Text Color</h4>
-
-The `core.css` file has been updated to set the text color on the `body` element:
-
-```diff
-body {
-+  color: var(--ion-text-color);
-}
-```
-
-This allows components to inherit the color properly when used outside of Ionic Framework and is required for custom themes to work properly. However, it may have unintentional side effects in apps if the color was not expected to inherit.
-
-<h4 id="version-8x-dynamic-font">Dynamic Font</h4>
-
-The `core.css` file has been updated to enable dynamic font scaling by default.
-
-The `--ion-default-dynamic-font` variable has been removed and replaced with `--ion-dynamic-font`.
-
-Developers who had previously chosen dynamic font scaling by activating it in their global stylesheets can revert to the default setting by removing their custom CSS. In doing so, their application will seamlessly continue utilizing dynamic font scaling as it did before. It's essential to note that altering the font-size of the html element should be avoided, as it may disrupt the proper functioning of dynamic font scaling.
-
-Developers who want to disable dynamic font scaling can set `--ion-dynamic-font: initial;` in their global stylesheets. However, this is not recommended because it may introduce accessibility challenges for users who depend on enlarged font sizes.
-
-For more information on the dynamic font, refer to the [Dynamic Font Scaling documentation](https://ionicframework.com/docs/layout/dynamic-font-scaling).
-
-<h2 id="version-8x-haptics">Haptics</h2>
-
-- Support for the Cordova Haptics plugin has been removed. Components that integrate with haptics, such as `ion-picker` and `ion-toggle`, will continue to function but will no longer play haptics in Cordova environments. Developers should migrate to Capacitor to continue to have haptics in these components.
-
-<h2 id="version-8x-components">Components</h2>
-
-<h4 id="version-8x-button">Button</h4>
-
-- Button text now wraps by default. If this behavior is not desired, add the `ion-text-nowrap` class from the [CSS Utilities](https://ionicframework.com/docs/layout/css-utilities).
-
-<h4 id="version-8x-checkbox">Checkbox</h4>
-
- The `legacy` property and support for the legacy syntax, which involved placing an `ion-checkbox` inside of an `ion-item` with an `ion-label`, have been removed. For more information on migrating from the legacy checkbox syntax, refer to the [Checkbox documentation](https://ionicframework.com/docs/api/checkbox#migrating-from-legacy-checkbox-syntax).
-
-<h4 id="version-8x-content">Content</h4>
-
-- Content no longer sets the `--background` custom property when the `.outer-content` class is set on the host.
-
-<h4 id="version-8x-datetime">Datetime</h4>
-
-- The CSS shadow part for `month-year-button` has been changed to target a `button` element instead of `ion-item`. Developers should verify their UI renders as expected for the month/year toggle button inside of `ion-datetime`.
-   - Developers using the CSS variables available on `ion-item` will need to migrate their CSS to use CSS properties. For example:
-      ```diff
-      ion-datetime::part(month-year-button) {
-      -  --background: red;
-
-      +  background: red;
-      }
-      ```
-
-<h4 id="version-8x-input">Input</h4>
-
-- `size` has been removed from the `ion-input` component. Developers should use CSS to specify the visible width of the input.
-- `accept` has been removed from the `ion-input` component. This was previously used in conjunction with the `type="file"`. However, the `file` value for `type` is not a valid value in Ionic Framework.
-- The `legacy` property and support for the legacy syntax, which involved placing an `ion-input` inside of an `ion-item` with an `ion-label`, have been removed. For more information on migrating from the legacy input syntax, refer to the [Input documentation](https://ionicframework.com/docs/api/input#migrating-from-legacy-input-syntax).
-
-<h4 id="version-8x-item">Item</h4>
-
-- The `helper` slot has been removed. Developers should use the `helperText` property on `ion-input` and `ion-textarea`.
-- The `error` slot has been removed. Developers should use the `errorText` property on `ion-input` and `ion-textarea`.
-- Counter functionality has been removed including the `counter` and `counterFormatter` properties. Developers should use the properties of the same name on `ion-input` and `ion-textarea`.
-- The `fill` property has been removed. Developers should use the property of the same name on `ion-input`, `ion-select`, and `ion-textarea`.
-- The `shape` property has been removed. Developers should use the property of the same name on `ion-input`, `ion-select`, and `ion-textarea`.
-- Item no longer automatically delegates focus to the first focusable element. While most developers should not need to make any changes to account for this update, usages of `ion-item` with interactive elements such as form controls (inputs, textareas, etc) should be evaluated to verify that interactions still work as expected.
-
-<h5>CSS variables</h4>
-
-The following deprecated CSS variables have been removed: `--highlight-height`, `--highlight-color-focused`, `--highlight-color-valid`, and `--highlight-color-invalid`. These variables were used on the bottom border highlight of an item when the form control inside of that item was focused. The form control syntax was [simplified in v7](https://ionic.io/blog/ionic-7-is-here#simplified-form-control-syntax) so that inputs, selects, and textareas would no longer be required to be used inside of an item.
-
-If you have not yet migrated to the modern form control syntax, migration guides for each of the form controls that added a highlight to item can be found below:
-- [Input migration documentation](https://ionicframework.com/docs/api/input#migrating-from-legacy-input-syntax)
-- [Select migration documentation](https://ionicframework.com/docs/api/select#migrating-from-legacy-select-syntax)
-- [Textarea migration documentation](https://ionicframework.com/docs/api/textarea#migrating-from-legacy-textarea-syntax)
-
-Once all form controls are using the modern syntax, the same variables can be used to customize them from the form control itself:
-
-| Name                        | Description                             |
-| ----------------------------| ----------------------------------------|
-| `--highlight-color-focused` | The color of the highlight when focused |
-| `--highlight-color-invalid` | The color of the highlight when invalid |
-| `--highlight-color-valid`   | The color of the highlight when valid   |
-| `--highlight-height`        | The height of the highlight indicator   |
-
-The following styles for item:
-
-```css
-ion-item {
-  --highlight-color-focused: purple;
-  --highlight-color-valid: blue;
-  --highlight-color-invalid: orange;
-  --highlight-height: 6px;
-}
-```
-
-will instead be applied on the form controls:
-
-```css
-ion-input,
-ion-textarea,
-ion-select {
-  --highlight-color-focused: purple;
-  --highlight-color-valid: blue;
-  --highlight-color-invalid: orange;
-  --highlight-height: 6px;
-}
-```
-
-> [!NOTE]
-> The input and textarea components are scoped, which means they will automatically scope their CSS by appending each of the styles with an additional class at runtime. Overriding scoped selectors in CSS requires a [higher specificity](https://developer.mozilla.org/en-US/docs/Web/CSS/Specificity) selector. Targeting the `ion-input` or `ion-textarea` for customization will not work; therefore we recommend adding a class and customizing it that way.
-
-<h4 id="version-8x-modal">Modal</h4>
-
-- Detection for Capacitor <= 2 with applying status bar styles has been removed. Developers should ensure they are using Capacitor 3 or later when using the card modal presentation.
-
-<h4 id="version-8x-nav">Nav</h4>
-
-- `getLength` returns `Promise<number>` instead of `<number>`. This method was not previously available in Nav's TypeScript interface, but developers could still access it by casting Nav as `any`. Developers should ensure they `await` their `getLength` call before accessing the returned value.
-
-<h4 id="version-8x-picker">Picker</h4>
-
-- `ion-picker` and `ion-picker-column` have been renamed to `ion-picker-legacy` and `ion-picker-legacy-column`, respectively. This change was made to accommodate the new inline picker component while allowing developers to continue to use the legacy picker during this migration period.
-  - Only the component names have been changed. Usages such as `ion-picker` or `IonPicker` should be changed to `ion-picker-legacy` and `IonPickerLegacy`, respectively.
-  - Non-component usages such as `pickerController` or `useIonPicker` remain unchanged. The new picker displays inline with your page content and does not have equivalents for these non-component usages.
-
-<h4 id="version-8x-progress-bar">Progress bar</h4>
-
-- The `--buffer-background` CSS variable has been removed. Use `--background` instead.
-
-<h4 id="version-8x-toast">Toast</h4>
-
-- `cssClass` has been removed from the `ToastButton` interface. This was previously used to apply a custom class to the toast buttons. Developers can use the "button" shadow part to style the buttons.
-
-For more information on styling toast buttons, refer to the [Toast Theming documentation](https://ionicframework.com/docs/api/toast#theming).
-
-<h4 id="version-8x-radio">Radio</h4>
-
-- The `legacy` property and support for the legacy syntax, which involved placing an `ion-radio` inside of an `ion-item` with an `ion-label`, have been removed. For more information on migrating from the legacy radio syntax, refer to the [Radio documentation](https://ionicframework.com/docs/api/radio#migrating-from-legacy-radio-syntax).
-
-<h4 id="version-8x-range">Range</h4>
-
-- The `legacy` property and support for the legacy syntax, which involved placing an `ion-range` inside of an `ion-item` with an `ion-label`, have been removed. Ionic will also no longer attempt to automatically associate form controls with sibling `<label>` elements as these label elements are now used inside the form control. Developers should provide a label (either visible text or `aria-label`) directly to the form control. For more information on migrating from the legacy range syntax, refer to the [Range documentation](https://ionicframework.com/docs/api/range#migrating-from-legacy-range-syntax).
-
-<h4 id="version-8x-searchbar">Searchbar</h4>
-
-- The `autocapitalize` property now defaults to `'off'`.
-
-<h4 id="version-8x-select">Select</h4>
-
-- The `legacy` property and support for the legacy syntax, which involved placing an `ion-select` inside of an `ion-item` with an `ion-label`, have been removed. Ionic will also no longer attempt to automatically associate form controls with sibling `<label>` elements as these label elements are now used inside the form control. Developers should provide a label (either visible text or `aria-label`) directly to the form control. For more information on migrating from the legacy select syntax, refer to the [Select documentation](https://ionicframework.com/docs/api/select#migrating-from-legacy-select-syntax).
-
-<h4 id="version-8x-textarea">Textarea</h4>
-
-- The `legacy` property and support for the legacy syntax, which involved placing an `ion-textarea` inside of an `ion-item` with an `ion-label`, have been removed. For more information on migrating from the legacy textarea syntax, refer to the [Textarea documentation](https://ionicframework.com/docs/api/textarea#migrating-from-legacy-textarea-syntax).
-
-<h4 id="version-8x-toggle">Toggle</h4>
-
-- The `legacy` property and support for the legacy syntax, which involved placing an `ion-toggle` inside of an `ion-item` with an `ion-label`, have been removed. For more information on migrating from the legacy toggle syntax, refer to the [Toggle documentation](https://ionicframework.com/docs/api/toggle#migrating-from-legacy-toggle-syntax).
-
-<h2 id="version-8x-framework-specific">Framework Specific</h2>
-
-<h4 id="version-8x-angular">Angular</h4>
-
-- The `IonBackButtonDelegate` class has been removed in favor of `IonBackButton`.
-
-  ```diff
-  - import { IonBackButtonDelegate } from '@ionic/angular';
-  + import { IonBackButton } from '@ionic/angular';
-  ```

CHANGELOG.md

@@ -3,6 +3,52 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.7.9](https://github.com/ionic-team/ionic-framework/compare/v8.7.8...v8.7.9) (2025-11-05)
+
+
+### Bug Fixes
+
+* **accordion-group:** skip initial animation ([#30729](https://github.com/ionic-team/ionic-framework/issues/30729)) ([58d5638](https://github.com/ionic-team/ionic-framework/commit/58d563805fca1db88caeeb40a8f710ac30416d93)), closes [#30613](https://github.com/ionic-team/ionic-framework/issues/30613)
+
+
+
+
+
+## [8.7.8](https://github.com/ionic-team/ionic-framework/compare/v8.7.7...v8.7.8) (2025-10-29)
+
+
+### Bug Fixes
+
+* **checkbox, toggle:** fire ionFocus and ionBlur ([#30733](https://github.com/ionic-team/ionic-framework/issues/30733)) ([54a1c86](https://github.com/ionic-team/ionic-framework/commit/54a1c86d6a5d533b0c8c2d18edc62454a7c17bab))
+
+
+
+
+
+## [8.7.7](https://github.com/ionic-team/ionic-framework/compare/v8.7.6...v8.7.7) (2025-10-15)
+
+
+### Bug Fixes
+
+* **header:** ensure one banner role in condensed header ([#30718](https://github.com/ionic-team/ionic-framework/issues/30718)) ([12084af](https://github.com/ionic-team/ionic-framework/commit/12084af163ed811b9c6bda3c7850fc0c53c60c7b))
+* **header:** prevent flickering during iOS page transitions ([#30705](https://github.com/ionic-team/ionic-framework/issues/30705)) ([820fa28](https://github.com/ionic-team/ionic-framework/commit/820fa2854331722d22efd0e38a1936117477967a)), closes [#25326](https://github.com/ionic-team/ionic-framework/issues/25326)
+* **select:** improve screen reader announcement timing for validation errors ([#30723](https://github.com/ionic-team/ionic-framework/issues/30723)) ([03303d7](https://github.com/ionic-team/ionic-framework/commit/03303d73f0bfe2380ced7931525fc52fd8576367))
+
+
+
+
+
+## [8.7.6](https://github.com/ionic-team/ionic-framework/compare/v8.7.5...v8.7.6) (2025-10-08)
+
+
+### Bug Fixes
+
+* **tabs:** respect stencil lifecycle order for tab selection ([#30702](https://github.com/ionic-team/ionic-framework/issues/30702)) ([7bb9535](https://github.com/ionic-team/ionic-framework/commit/7bb9535f601d2469ce60687a9c03f8b1cfe4aba4)), closes [#30611](https://github.com/ionic-team/ionic-framework/issues/30611)
+
+
+
+
+
 ## [8.7.5](https://github.com/ionic-team/ionic-framework/compare/v8.7.4...v8.7.5) (2025-09-24)
 
 

core/.stylelintrc.yml

@@ -3,19 +3,16 @@
 # See documentation at https://stylelint.io/
 
 ignoreFiles:
-  - src/foundations/*.scss
-  - src/css/ionic/*.scss
   - src/css/core.scss
   - src/css/flex-utils.scss
   - src/css/normalize.scss
   - src/css/text-alignment.scss
   - src/css/display.scss
-  - src/themes/mixins.scss
-  - src/themes/functions.color.scss
-  - src/themes/functions.string.scss
-  - src/themes/native.theme.default.scss
+  - src/themes/ionic.mixins.scss
+  - src/themes/ionic.functions.color.scss
+  - src/themes/ionic.functions.string.scss
+  - src/themes/ionic.theme.default.scss
   - src/css/themes/*.scss
-  - scripts/tokens/*.css
 
 indentation: 2
 
@@ -26,10 +23,10 @@ rules:
   at-rule-empty-line-before:
     - always
     - except:
-        - blockless-after-blockless
-        - first-nested
+      - blockless-after-blockless
+      - first-nested
       ignore:
-        - after-comment
+      - after-comment
 
   block-closing-brace-newline-before:
     - always
@@ -43,13 +40,14 @@ rules:
   custom-property-empty-line-before:
     - always
     - except:
-        - after-comment
-        - after-custom-property
-        - first-nested
+      - after-comment
+      - after-custom-property
+      - first-nested
 
   declaration-no-important:
     - true
 
+
   order/order:
     - custom-properties
     - dollar-variables
@@ -59,202 +57,203 @@ rules:
 
   # https://github.com/sasstools/sass-lint/blob/develop/lib/config/property-sort-orders/smacss.yml
   order/properties-order:
+
     # Box
 
     - emptyLineBefore: always
       properties:
-        - display
-        - position
-        - top
-        - right
-        - bottom
-        - left
+      - display
+      - position
+      - top
+      - right
+      - bottom
+      - left
 
     - emptyLineBefore: always
       properties:
-        - flex
-        - flex-basis
-        - flex-direction
-        - flex-flow
-        - flex-grow
-        - flex-shrink
-        - flex-wrap
-        - align-content
-        - align-items
-        - align-self
-        - justify-content
-        - order
+      - flex
+      - flex-basis
+      - flex-direction
+      - flex-flow
+      - flex-grow
+      - flex-shrink
+      - flex-wrap
+      - align-content
+      - align-items
+      - align-self
+      - justify-content
+      - order
 
     - emptyLineBefore: always
       properties:
-        - width
-        - min-width
-        - max-width
+      - width
+      - min-width
+      - max-width
 
-        - height
-        - min-height
-        - max-height
+      - height
+      - min-height
+      - max-height
 
     - emptyLineBefore: always
       properties:
-        - margin
-        - margin-top
-        - margin-right
-        - margin-bottom
-        - margin-left
+      - margin
+      - margin-top
+      - margin-right
+      - margin-bottom
+      - margin-left
 
     - emptyLineBefore: always
       properties:
-        - padding
-        - padding-top
-        - padding-right
-        - padding-bottom
-        - padding-left
+      - padding
+      - padding-top
+      - padding-right
+      - padding-bottom
+      - padding-left
 
     - emptyLineBefore: always
       properties:
-        - float
-        - clear
+      - float
+      - clear
 
     - emptyLineBefore: always
       properties:
-        - columns
-        - column-gap
-        - column-fill
-        - column-rule
-        - column-span
-        - column-count
-        - column-width
+      - columns
+      - column-gap
+      - column-fill
+      - column-rule
+      - column-span
+      - column-count
+      - column-width
 
     - emptyLineBefore: always
       properties:
-        - transform
-        - transform-box
-        - transform-origin
-        - transform-style
+      - transform
+      - transform-box
+      - transform-origin
+      - transform-style
 
     - emptyLineBefore: always
       properties:
-        - transition
-        - transition-delay
-        - transition-duration
-        - transition-property
-        - transition-timing-function
+      - transition
+      - transition-delay
+      - transition-duration
+      - transition-property
+      - transition-timing-function
 
     # Border
 
     - emptyLineBefore: always
       properties:
-        - border
-        - border-top
-        - border-right
-        - border-bottom
-        - border-left
-        - border-width
-        - border-top-width
-        - border-right-width
-        - border-bottom-width
-        - border-left-width
+      - border
+      - border-top
+      - border-right
+      - border-bottom
+      - border-left
+      - border-width
+      - border-top-width
+      - border-right-width
+      - border-bottom-width
+      - border-left-width
 
-        - border-style
-        - border-top-style
-        - border-right-style
-        - border-bottom-style
-        - border-left-style
+      - border-style
+      - border-top-style
+      - border-right-style
+      - border-bottom-style
+      - border-left-style
 
-        - border-radius
-        - border-top-left-radius
-        - border-top-right-radius
-        - border-bottom-left-radius
-        - border-bottom-right-radius
+      - border-radius
+      - border-top-left-radius
+      - border-top-right-radius
+      - border-bottom-left-radius
+      - border-bottom-right-radius
 
-        - border-color
-        - border-top-color
-        - border-right-color
-        - border-bottom-color
-        - border-left-color
+      - border-color
+      - border-top-color
+      - border-right-color
+      - border-bottom-color
+      - border-left-color
 
     - emptyLineBefore: always
       properties:
-        - outline
-        - outline-color
-        - outline-offset
-        - outline-style
-        - outline-width
+      - outline
+      - outline-color
+      - outline-offset
+      - outline-style
+      - outline-width
 
     # Background
 
     - emptyLineBefore: always
       properties:
-        - background
-        - background-attachment
-        - background-clip
-        - background-color
-        - background-image
-        - background-repeat
-        - background-position
-        - background-size
+      - background
+      - background-attachment
+      - background-clip
+      - background-color
+      - background-image
+      - background-repeat
+      - background-position
+      - background-size
 
-        # Text
+    # Text
 
-        - color
+      - color
 
     - emptyLineBefore: always
       properties:
-        - font
-        - font-family
-        - font-size
-        - font-smoothing
-        - font-style
-        - font-variant
-        - font-weight
+      - font
+      - font-family
+      - font-size
+      - font-smoothing
+      - font-style
+      - font-variant
+      - font-weight
 
     - emptyLineBefore: always
       properties:
-        - letter-spacing
-        - line-height
-        - list-style
+      - letter-spacing
+      - line-height
+      - list-style
 
     - emptyLineBefore: always
       properties:
-        - text-align
-        - text-decoration
-        - text-indent
-        - text-overflow
-        - text-rendering
-        - text-shadow
-        - text-transform
-        - text-wrap
+      - text-align
+      - text-decoration
+      - text-indent
+      - text-overflow
+      - text-rendering
+      - text-shadow
+      - text-transform
+      - text-wrap
 
     - emptyLineBefore: always
       properties:
-        - white-space
-        - word-spacing
+      - white-space
+      - word-spacing
 
     # Other
 
     - emptyLineBefore: always
       properties:
-        - border-collapse
-        - border-spacing
-        - box-shadow
-        - caption-side
-        - contain
-        - content
-        - cursor
-        - direction
-        - empty-cells
-        - object-fit
-        - opacity
-        - overflow
-        - quotes
-        - speak
-        - table-layout
-        - touch-action
-        - user-select
-        - vertical-align
-        - visibility
-        - z-index
+      - border-collapse
+      - border-spacing
+      - box-shadow
+      - caption-side
+      - contain
+      - content
+      - cursor
+      - direction
+      - empty-cells
+      - object-fit
+      - opacity
+      - overflow
+      - quotes
+      - speak
+      - table-layout
+      - touch-action
+      - user-select
+      - vertical-align
+      - visibility
+      - z-index
 
   property-disallowed-list:
     - background-position

core/CHANGELOG.md

@@ -3,6 +3,52 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.7.9](https://github.com/ionic-team/ionic-framework/compare/v8.7.8...v8.7.9) (2025-11-05)
+
+
+### Bug Fixes
+
+* **accordion-group:** skip initial animation ([#30729](https://github.com/ionic-team/ionic-framework/issues/30729)) ([58d5638](https://github.com/ionic-team/ionic-framework/commit/58d563805fca1db88caeeb40a8f710ac30416d93)), closes [#30613](https://github.com/ionic-team/ionic-framework/issues/30613)
+
+
+
+
+
+## [8.7.8](https://github.com/ionic-team/ionic-framework/compare/v8.7.7...v8.7.8) (2025-10-29)
+
+
+### Bug Fixes
+
+* **checkbox, toggle:** fire ionFocus and ionBlur ([#30733](https://github.com/ionic-team/ionic-framework/issues/30733)) ([54a1c86](https://github.com/ionic-team/ionic-framework/commit/54a1c86d6a5d533b0c8c2d18edc62454a7c17bab))
+
+
+
+
+
+## [8.7.7](https://github.com/ionic-team/ionic-framework/compare/v8.7.6...v8.7.7) (2025-10-15)
+
+
+### Bug Fixes
+
+* **header:** ensure one banner role in condensed header ([#30718](https://github.com/ionic-team/ionic-framework/issues/30718)) ([12084af](https://github.com/ionic-team/ionic-framework/commit/12084af163ed811b9c6bda3c7850fc0c53c60c7b))
+* **header:** prevent flickering during iOS page transitions ([#30705](https://github.com/ionic-team/ionic-framework/issues/30705)) ([820fa28](https://github.com/ionic-team/ionic-framework/commit/820fa2854331722d22efd0e38a1936117477967a)), closes [#25326](https://github.com/ionic-team/ionic-framework/issues/25326)
+* **select:** improve screen reader announcement timing for validation errors ([#30723](https://github.com/ionic-team/ionic-framework/issues/30723)) ([03303d7](https://github.com/ionic-team/ionic-framework/commit/03303d73f0bfe2380ced7931525fc52fd8576367))
+
+
+
+
+
+## [8.7.6](https://github.com/ionic-team/ionic-framework/compare/v8.7.5...v8.7.6) (2025-10-08)
+
+
+### Bug Fixes
+
+* **tabs:** respect stencil lifecycle order for tab selection ([#30702](https://github.com/ionic-team/ionic-framework/issues/30702)) ([7bb9535](https://github.com/ionic-team/ionic-framework/commit/7bb9535f601d2469ce60687a9c03f8b1cfe4aba4)), closes [#30611](https://github.com/ionic-team/ionic-framework/issues/30611)
+
+
+
+
+
 ## [8.7.5](https://github.com/ionic-team/ionic-framework/compare/v8.7.4...v8.7.5) (2025-09-24)
 
 

core/Dockerfile

@@ -1,5 +1,5 @@
 # Get Playwright
-FROM mcr.microsoft.com/playwright:v1.55.1
+FROM mcr.microsoft.com/playwright:v1.56.1
 
 # Set the working directory
 WORKDIR /ionic

core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ionic/core",
-  "version": "8.7.5",
+  "version": "8.7.9",
   "description": "Base components for Ionic",
   "keywords": [
     "ionic",
@@ -31,13 +31,12 @@
     "loader/"
   ],
   "dependencies": {
-    "@phosphor-icons/core": "^2.1.1",
     "@stencil/core": "4.38.0",
     "ionicons": "^8.0.13",
     "tslib": "^2.1.0"
   },
   "devDependencies": {
-    "@axe-core/playwright": "^4.10.2",
+    "@axe-core/playwright": "^4.11.0",
     "@capacitor/core": "^7.0.0",
     "@capacitor/haptics": "^7.0.0",
     "@capacitor/keyboard": "^7.0.0",
@@ -45,7 +44,7 @@
     "@clack/prompts": "^0.11.0",
     "@ionic/eslint-config": "^0.3.0",
     "@ionic/prettier-config": "^2.0.0",
-    "@playwright/test": "^1.55.1",
+    "@playwright/test": "^1.56.1",
     "@rollup/plugin-node-resolve": "^8.4.0",
     "@rollup/plugin-virtual": "^2.0.3",
     "@stencil/angular-output-target": "^0.10.0",
@@ -53,7 +52,7 @@
     "@stencil/sass": "^3.0.9",
     "@stencil/vue-output-target": "0.10.8",
     "@types/jest": "^29.5.6",
-    "@types/node": "^18.19.47",
+    "@types/node": "^14.6.0",
     "@typescript-eslint/eslint-plugin": "^6.7.2",
     "@typescript-eslint/parser": "^6.7.2",
     "chalk": "^5.3.0",
@@ -66,12 +65,10 @@
     "fs-extra": "^9.0.1",
     "jest": "^29.7.0",
     "jest-cli": "^29.7.0",
-    "outsystems-design-tokens": "^1.3.2",
-    "prettier": "^2.8.8",
+    "prettier": "^2.6.1",
     "rollup": "^2.26.4",
     "sass": "^1.33.0",
     "serve": "^14.0.1",
-    "style-dictionary": "^5.0.0",
     "stylelint": "^13.13.1",
     "stylelint-order": "^4.1.0"
   },
@@ -80,7 +77,6 @@
     "build.css": "npm run css.sass && npm run css.minify",
     "build.debug": "npm run clean && stencil build --debug",
     "build.docs.json": "stencil build --docs-json dist/docs.json",
-    "build.tokens": "node ./node_modules/outsystems-design-tokens/scripts/index.js --config ./scripts/tokens/index.mjs && npm run prettier.tokens",
     "clean": "node scripts/clean.js",
     "css.minify": "cleancss -O2 -o ./css/ionic.bundle.css ./css/ionic.bundle.css",
     "css.sass": "sass --embed-sources --style compressed src/css:./css",
@@ -92,8 +88,7 @@
     "lint.ts": "npm run eslint",
     "lint.ts.fix": "npm run eslint -- --fix",
     "prerender.e2e": "node scripts/testing/prerender.js",
-    "prettier": "prettier \"./src/**/*.{html,ts,tsx,js,jsx,scss}\"",
-    "prettier.tokens": "prettier \"./src/foundations/*.{scss, html}\" --write --cache",
+    "prettier": "prettier \"./src/**/*.{html,ts,tsx,js,jsx}\"",
     "start": "npm run build.css && stencil build --dev --watch --serve",
     "test": "npm run test.spec && npm run test.e2e",
     "test.spec": "stencil test --spec --max-workers=2",

core/scripts/testing/scripts.js

@@ -28,32 +28,6 @@
     document.head.appendChild(linkTag);
   }
 
-  /**
-  * The `ionic` theme uses a different stylesheet than the `iOS` and `md` themes.
-  * This is to ensure that the `ionic` theme is loaded when the `ionic:theme=ionic`
-  * or when the HTML tag has the `theme="ionic"` attribute. This is useful for
-  * the snapshot tests, where the `ionic` theme is not loaded by default.
-  */
-  const themeQuery = window.location.search.match(/ionic:theme=([a-z]+)/);
-  const themeAttr = document.documentElement.getAttribute('theme');
-
-  if ((themeQuery && themeQuery[1] === 'ionic') || themeAttr === 'ionic') {
-    const ionicThemeLinkTag = document.querySelector('link[href*="css/ionic/bundle.ionic.css"]');
-
-    if (!ionicThemeLinkTag) {
-      const linkTag = document.createElement('link');
-      linkTag.setAttribute('rel', 'stylesheet');
-      linkTag.setAttribute('type', 'text/css');
-      linkTag.setAttribute('href', '/css/ionic/bundle.ionic.css');
-      document.head.appendChild(linkTag);
-    }
-
-    const defaultThemeLinkTag = document.querySelector('link[href*="css/ionic.bundle.css"]');
-    if (defaultThemeLinkTag) {
-      defaultThemeLinkTag.remove();
-    }
-  }
-
   window.Ionic = window.Ionic || {};
   window.Ionic.config = window.Ionic.config || {};
 

core/scripts/testing/styles.css

@@ -49,17 +49,6 @@ html.ios.ios {
   font-family: -apple-system, BlinkMacSystemFont, "iosTestingFont", sans-serif;
 }
 
-/* Override above styles for testing scopes */
-:root.ionic,
-:root.ionic.ios,
-:root.ionic.md,
-html.ionic,
-html.ionic.ios,
-html.ionic.md {
-  --ion-background-color: var(--background);
-  --ion-font-family: initial;
-}
-
 /**
  * Button styles should only be applied
  * to native buttons that are not part of the

core/scripts/tokens/index.mjs

@@ -1,188 +0,0 @@
-/* eslint-disable @typescript-eslint/no-var-requires */
-// For generating Design Tokens, we use Style Dictionary for several reasons:
-// - It's prepared to easily generate tokens for multiple types of outputs (CSS, SCSS, iOS, Android, documentation, etc.).
-// - It also works very well out of the box with any kind of Design Tokens formats, like Figma Tokens, as well as APIs to adjust to more custom ones.
-// - It is probably the most well-known and widely used Design Tokens tool. It has also been regularly maintained for a long time.
-// - It can easily scale to different necessities we might have in the future.
-import StyleDictionary from 'style-dictionary';
-
-import * as utils from './utils.mjs';
-
-const {
-  generateShadowValue,
-  generateFontSizeValue,
-  generateFontFamilyValue,
-  generateTypographyOutput,
-  generateValue,
-  generateColorUtilityClasses,
-  generateDefaultSpaceUtilityClasses,
-  generateSpaceUtilityClasses,
-  removeConsecutiveRepeatedWords,
-  setVariablePrefixValue,
-  setClassesAndScssPrefixValue: setClassesPrefixValue,
-  generateRadiusUtilityClasses,
-  generateBorderUtilityClasses,
-  generateFontUtilityClasses,
-  generateShadowUtilityClasses,
-  generateUtilityClasses
-} = utils;
-
-const customHeader = `// Do not edit directly, this file was auto-generated.`;
-// Set the prefix for classes
-setClassesPrefixValue('ion');
-// Set the prefix for variables
-setVariablePrefixValue('token');
-
-// SCSS variables format
-StyleDictionary.registerFormat({
-  name: 'scssVariablesFormat',
-  format: function ({ dictionary }) { // Use 'format' for Style Dictionary v3
-    console.log('Generating SCSS variables...');
-
-    const primitiveProperties = dictionary.allTokens.filter((prop) => prop.path[0] === 'primitives');
-    const scaleProperties = dictionary.allTokens.filter((prop) => prop.path[0] === 'scale');
-    const borderProperties = dictionary.allTokens.filter((prop) => prop.path[0] === 'border');
-    const semanticsProperties = dictionary.allTokens.filter((prop) => prop.path[0] === 'semantics');
-    const nonPrimitiveScaleBorderSemanticsProperties = dictionary.allTokens.filter(
-      (prop) => !['primitives', 'scale', 'border', 'semantics'].includes(prop.path[0])
-    );
-    const typographyProperties = nonPrimitiveScaleBorderSemanticsProperties.filter((prop) => prop.$type === 'typography');
-    const otherProperties = nonPrimitiveScaleBorderSemanticsProperties.filter((prop) => prop.$type !== 'typography');
-    
-    // Order: primitives → semantics → scale → border → other → typography
-    const sortedProperties = [
-      ...primitiveProperties,
-      ...semanticsProperties,
-      ...scaleProperties,
-      ...borderProperties,
-      ...otherProperties,
-      ...typographyProperties
-    ];
-
-    const prefixedVariables = sortedProperties.map((prop) => {
-      // Remove consecutive repeated words from the token name, like border-border-color
-      const propName = removeConsecutiveRepeatedWords(prop.name);
-
-      switch (prop.$type) {
-        case 'boxShadow':
-          return generateShadowValue(prop, propName);
-        case 'fontFamilies':
-          return generateFontFamilyValue(prop, propName, 'scss');
-        case 'fontSizes':
-          return generateFontSizeValue(prop, propName, 'scss');
-        case 'typography':
-          return generateTypographyOutput(prop, propName, true);
-        default:
-          return generateValue(prop, propName);
-      }
-    });
-
-    // In v3, the header is added automatically by Style Dictionary.
-    // The format function should only return the file content.
-    return [
-      customHeader + '\n\n',
-      '@use "../themes/functions.sizes" as font;\n',
-      prefixedVariables.join('\n') + '\n',
-    ].join('');
-  },
-});
-
-// Create utility-classes
-StyleDictionary.registerFormat({
-  name: 'cssUtilityClassesFormat',
-  format: function ({ dictionary }) { // Use 'format' for Style Dictionary v3
-    console.log('Generating Utility-Classes...');
-
-    // Arrays to store specific utility classes
-    const typographyUtilityClasses = [];
-    const otherUtilityClasses = [];
-
-    // Generate utility classes for each token
-    dictionary.allTokens.map((prop) => {
-      const tokenCategory = prop.attributes.category;
-
-      if (prop.$type === 'fontFamilies' || tokenCategory === 'scale' || tokenCategory === 'backdrop') {
-        // Not creating for the tokens below, as they make no sense to exist as utility-classes.
-        return;
-      }
-
-      // Remove consecutive repeated words from the token name, like border-border-color
-      const propName = removeConsecutiveRepeatedWords(prop.name);
-
-      if (prop.$type === 'typography') {
-        // Typography tokens are handled differently, as each might have a different tokenType
-        return typographyUtilityClasses.push(generateTypographyOutput(prop, propName, false));
-      } else if (tokenCategory.startsWith('round') || tokenCategory.startsWith('rectangular') || tokenCategory.startsWith('soft')) {
-        // Generate utility classes for border-radius shape tokens, as they have their own token json file, based on primitive tokens
-        return otherUtilityClasses.push(generateRadiusUtilityClasses(propName));
-      }
-
-      let utilityClass = '';
-      switch (tokenCategory) {
-        case 'color':
-        case 'primitives':
-        case 'semantics':
-        case 'text':
-        case 'bg':
-        case 'icon':
-        case 'state':
-          utilityClass = generateColorUtilityClasses(prop, propName);
-          break;
-        case 'border':
-          utilityClass = generateBorderUtilityClasses(prop, propName);
-          break;
-        case 'font':
-          utilityClass = generateFontUtilityClasses(prop, propName);
-          break;
-        case 'space':
-          utilityClass = generateSpaceUtilityClasses(prop, propName);
-          break;
-        case 'shadow':
-        case 'elevation':
-          utilityClass = generateShadowUtilityClasses(propName);
-          break;
-        default:
-          utilityClass = generateUtilityClasses(tokenCategory, propName);
-      }
-
-      return otherUtilityClasses.push(utilityClass);
-    });
-
-    const defaultSpaceUtilityClasses = generateDefaultSpaceUtilityClasses();
-    otherUtilityClasses.push(defaultSpaceUtilityClasses);
-
-    // Concatenate typography utility classes at the beginning
-    const finalOutput = typographyUtilityClasses.concat(otherUtilityClasses).join('\n');
-
-    // In v3, the header is added automatically by Style Dictionary.
-    // The format function should only return the file content.
-    return [
-      customHeader + '\n\n',
-      '@import "./ionic.vars";\n@import "../themes/mixins";\n',
-      finalOutput,
-    ].join('');
-  },
-});
-
-// APPLY THE CONFIGURATION
-const config = {
-  source: ["node_modules/outsystems-design-tokens/tokens/**/*.json"],
-  platforms: {
-    scss: {
-      transformGroup: "scss",
-      buildPath: './src/foundations/',
-      files: [
-        {
-          destination: "ionic.vars.scss",
-          format: "scssVariablesFormat",
-        },
-        {
-          destination: "ionic.utility.scss",
-          format: "cssUtilityClassesFormat",
-        }
-      ]
-    }
-  }
-};
-
-export default config;

core/scripts/tokens/utils.mjs

@@ -1,320 +0,0 @@
-let variablesPrefix; // Variable that holds the prefix used on all css variables generated
-let classAndScssPrefix; // Variable that holds the prefix used on all css utility-classes and scss variables generated  
-
-// Set the variable prefix value
-export function setVariablePrefixValue(prefix) {
-  variablesPrefix = prefix;
-  return variablesPrefix;
-}
-
-export function setClassesAndScssPrefixValue(prefix) {
-  classAndScssPrefix = prefix;
-  return classAndScssPrefix;
-}
-
-// Generates a valid rgba() color
-export function getRgbaValue(propValue) {
-  // Check if its rgba color
-  const isRgba = hexToRgba(propValue);
-  // If it is, then compose rgba() color, otherwise use the normal color
-  if (isRgba !== null) {
-    return (propValue = `rgba(${isRgba.r}, ${isRgba.g}, ${isRgba.b},${isRgba.a})`);
-  } else {
-    return propValue;
-  }
-}
-
-// Translates an hex color value to rgb
-export function hexToRgb(hex) {
-  const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
-  return result
-    ? {
-        r: parseInt(result[1], 16),
-        g: parseInt(result[2], 16),
-        b: parseInt(result[3], 16),
-      }
-    : null;
-}
-
-// Translates an hex color value to rgba
-function hexToRgba(hex) {
-  const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
-  return result
-    ? {
-        r: parseInt(result[1], 16),
-        g: parseInt(result[2], 16),
-        b: parseInt(result[3], 16),
-        a: Math.round((parseInt(result[4], 16) * 100) / 255) / 100,
-      }
-    : null;
-}
-
-// Utility function to remove consecutive repeated words
-export function removeConsecutiveRepeatedWords(str) {
-    return str.replace(/(\b\w+\b)(-\1)+/g, '$1');
-}
-
-// Generates a reference variable for an alias token type
-// (e.g., $ion-border-default: var(--ion-border-default, #d5d5d5) → $ion-border-default: var(--ion-border-default, $ion-primitives-neutral-400))
-export function getAliasReferenceVariable(prop) {
-  if (typeof prop.$value === 'string' && prop.$value.startsWith('{') && prop.$value.endsWith('}')) {
-    // Remove curly braces and replace dots with dashes
-    let ref = prop.$value.slice(1, -1).replace(/\./g, '-');
-    // Remove consecutive repeated words (e.g., border-border-radius-0 → border-radius-0)
-    ref = removeConsecutiveRepeatedWords(ref);
-    return `$${classAndScssPrefix}-${ref}`;
-  }
-  return null;
-}
-
-// Generates a valid box-shadow value from a shadow Design Token structure
-export function generateShadowValue(prop, propName) {
-  const cssShadow = prop.$value.map(shadow => {
-    // Assuming shadow is an object with properties like offsetX, offsetY, blurRadius, spreadRadius, color
-    const color = getRgbaValue(shadow.color);
-    return `${shadow.x}px ${shadow.y}px ${shadow.blur}px ${shadow.spread}px ${color}`;
-}).join(', ');
-
-  return `$${classAndScssPrefix}-${propName}: var(--${variablesPrefix}-${propName}, ${cssShadow});`;
-}
-
-// Generates a valid font-size value from a font-size Design Token structure, while transforming the pixels to rem
-export function generateFontSizeValue(prop, propName, variableType = 'css') {
-  return variableType === 'scss'
-    ? `$${classAndScssPrefix}-${propName}: var(--${variablesPrefix}-${propName}, font.px-to-rem(${parseInt(
-        prop.$value
-      )}));`
-    : `--${propName}: #{font.px-to-rem(${parseInt(prop.$value)})};`;
-}
-
-// Generates a valid font-family value from a font-family Design Token structure
-export function generateFontFamilyValue(prop, propName, variableType = 'css') {
-  // Remove the last word from the token, as it contains the name of the font, which we don't want to be included on the generated variables
-  const _propName = propName.split('-').slice(0, -1).join('-');
-
-  return variableType === 'scss'
-    ? `$${classAndScssPrefix}-${_propName}: var(--${variablesPrefix}-${_propName}, ${prop.$value});`
-    : `--${variablesPrefix}-${_propName}: ${prop.$value};`;
-}
-
-// Generates a final value, based if the Design Token is of type color or not
-export function generateValue(prop, propName) {
-  // Use the original value to detect aliases
-  const aliasVar = getAliasReferenceVariable({ $value: prop.original.$value });
-
-  // Always generate the main variable
-  let mainValue;
-  if (aliasVar) {
-    mainValue = `$${classAndScssPrefix}-${propName}: var(--${variablesPrefix}-${propName}, ${aliasVar});`;
-  } else {
-    mainValue = `$${classAndScssPrefix}-${propName}: var(--${variablesPrefix}-${propName}, ${prop.$value});`;
-  }
-
-  // Always generate the -rgb variable if it's a color
-  const rgb = hexToRgb(prop.$value);
-  let rgbDeclaration = '';
-  if (rgb) {
-    rgbDeclaration = `\n$${classAndScssPrefix}-${propName}-rgb: var(--${variablesPrefix}-${propName}-rgb, ${rgb.r}, ${rgb.g}, ${rgb.b});`;
-  }
-
-  return `${mainValue}${rgbDeclaration}`;
-}
-
-// Generates a typography based css utility-class or scss variable from a typography token structure
-export function generateTypographyOutput(prop, propName, isVariable) {
-  const typography = prop.original.$value;
-
-  // Extract the part after the last dot and trim any extraneous characters
-  const extractLastPart = (str) => str.split('.').pop().replace(/[^\w-]/g, '');
-
-  const _initialWrapper = isVariable ? ': (' : ` {`;
-  const _endWrapper = isVariable ? ')' : `}`;
-  const _prefix = isVariable ? '$' : `.`;
-  const _endChar = isVariable ? ',' : ';';
-
-  // This exact format is needed so that it compiles the tokens with the expected lint rules
-  return `
-  ${_prefix}${classAndScssPrefix}-${propName}${_initialWrapper}
-    font-size: $${classAndScssPrefix}-font-size-${extractLastPart(typography.fontSize)}${_endChar}
-    font-style: ${prop.attributes.item?.toLowerCase() === 'italic' ? 'italic' : 'normal'}${_endChar}
-    font-weight: $${classAndScssPrefix}-font-weight-${extractLastPart(typography.fontWeight)}${_endChar}
-    letter-spacing: $${classAndScssPrefix}-font-letter-spacing-${extractLastPart(typography.letterSpacing) || 0}${_endChar}
-    line-height: $${classAndScssPrefix}-font-line-height-${extractLastPart(typography.lineHeight)}${_endChar}
-    text-transform: ${typography.textCase}${_endChar}
-    text-decoration: ${typography.textDecoration}${_endChar}
-  ${_endWrapper};
-  `;
-}
-
-// Generates a color based css utility-class from a color Design Token structure
-export function generateColorUtilityClasses(prop, className) {
-  const isBg = className.includes('bg');
-  const cssProp = isBg ? 'background-color' : 'color';
-  return `.${classAndScssPrefix}-${className} {
-  --${cssProp}: #{$${classAndScssPrefix}-${prop.name}};
-  ${cssProp}: $${classAndScssPrefix}-${prop.name};
-}`;
-}
-
-// Generates margin and padding utility classes to match the token-agnostic
-// utilities provided by the Ionic Framework
-export function generateDefaultSpaceUtilityClasses() {
-  const zeroMarginPaddingToken = 'space-0';
-  const defaultMarginPaddingToken = 'space-400';
-
-  const marginPaddingTemplate = (type) => `
-.${classAndScssPrefix}-no-${type} {
-  --${type}-top: #{$${classAndScssPrefix}-${zeroMarginPaddingToken}};
-  --${type}-end: #{$${classAndScssPrefix}-${zeroMarginPaddingToken}};
-  --${type}-bottom: #{$${classAndScssPrefix}-${zeroMarginPaddingToken}};
-  --${type}-start: #{$${classAndScssPrefix}-${zeroMarginPaddingToken}};
-
-  @include ${type}($${classAndScssPrefix}-${zeroMarginPaddingToken});
-};
-
-.${classAndScssPrefix}-${type} {
-  --${type}-top: #{$${classAndScssPrefix}-${defaultMarginPaddingToken}};
-  --${type}-end: #{$${classAndScssPrefix}-${defaultMarginPaddingToken}};
-  --${type}-bottom: #{$${classAndScssPrefix}-${defaultMarginPaddingToken}};
-  --${type}-start: #{$${classAndScssPrefix}-${defaultMarginPaddingToken}};
-
-  @include ${type}($${classAndScssPrefix}-${defaultMarginPaddingToken});
-};
-
-.${classAndScssPrefix}-${type}-top {
-  --${type}-top: #{$${classAndScssPrefix}-${defaultMarginPaddingToken}};
-
-  @include ${type}($${classAndScssPrefix}-${defaultMarginPaddingToken}, null, null, null);
-};
-
-.${classAndScssPrefix}-${type}-end {
-  --${type}-end: #{$${classAndScssPrefix}-${defaultMarginPaddingToken}};
-
-  @include ${type}(null, $${classAndScssPrefix}-${defaultMarginPaddingToken}, null, null);
-};
-
-.${classAndScssPrefix}-${type}-bottom {
-  --${type}-bottom: #{$${classAndScssPrefix}-${defaultMarginPaddingToken}};
-
-  @include ${type}(null, null, $${classAndScssPrefix}-${defaultMarginPaddingToken}, null);
-};
-
-.${classAndScssPrefix}-${type}-start {
-  --${type}-start: #{$${classAndScssPrefix}-${defaultMarginPaddingToken}};
-
-  @include ${type}(null, null, null, $${classAndScssPrefix}-${defaultMarginPaddingToken});
-};
-
-.${classAndScssPrefix}-${type}-vertical {
-  --${type}-top: #{$${classAndScssPrefix}-${defaultMarginPaddingToken}};
-  --${type}-bottom: #{$${classAndScssPrefix}-${defaultMarginPaddingToken}};
-
-  @include ${type}($${classAndScssPrefix}-${defaultMarginPaddingToken}, null, $${classAndScssPrefix}-${defaultMarginPaddingToken}, null);
-};
-
-.${classAndScssPrefix}-${type}-horizontal {
-  --${type}-start: #{$${classAndScssPrefix}-${defaultMarginPaddingToken}};
-  --${type}-end: #{$${classAndScssPrefix}-${defaultMarginPaddingToken}};
-
-  @include ${type}(null, $${classAndScssPrefix}-${defaultMarginPaddingToken}, null, $${classAndScssPrefix}-${defaultMarginPaddingToken});
-};
-`;
-
-  return `${marginPaddingTemplate('margin')}\n${marginPaddingTemplate('padding')}`;
-}
-
-// Generates a margin or padding based css utility-class from a space Design Token structure
-export function generateSpaceUtilityClasses(prop, className) {
-  // This exact format is needed so that it compiles the tokens with the expected lint rules
-  // It will generate classes for margin and padding, for equal sizing on all side and each direction
-  const marginPaddingTemplate = (type) => `
-.${classAndScssPrefix}-${type}-${className} {
-  --${type}-top: #{$${classAndScssPrefix}-${prop.name}};
-  --${type}-end: #{$${classAndScssPrefix}-${prop.name}};
-  --${type}-bottom: #{$${classAndScssPrefix}-${prop.name}};
-  --${type}-start: #{$${classAndScssPrefix}-${prop.name}};
-
-  @include ${type}($${classAndScssPrefix}-${prop.name});
-};
-
-.${classAndScssPrefix}-${type}-top-${className} {
-  --${type}-top: #{$${classAndScssPrefix}-${prop.name}};
-
-  @include ${type}($${classAndScssPrefix}-${prop.name}, null, null, null);
-};
-
-.${classAndScssPrefix}-${type}-end-${className} {
-  --${type}-end: #{$${classAndScssPrefix}-${prop.name}};
-
-  @include ${type}(null, $${classAndScssPrefix}-${prop.name}, null, null);
-};
-
-.${classAndScssPrefix}-${type}-bottom-${className} {
-  --${type}-bottom: #{$${classAndScssPrefix}-${prop.name}};
-
-  @include ${type}(null, null, $${classAndScssPrefix}-${prop.name}, null);
-};
-
-.${classAndScssPrefix}-${type}-start-${className} {
-  --${type}-start: #{$${classAndScssPrefix}-${prop.name}};
-
-  @include ${type}(null, null, null, $${classAndScssPrefix}-${prop.name});
-};
-`;
-
-  // Add gap utility classes for gap tokens
-  const generateGapUtilityClasses = () =>`
-.${classAndScssPrefix}-gap-${prop.name} { 
-  gap: #{$${classAndScssPrefix}-${prop.name}}; 
-};
-`;
-
-  return `${generateGapUtilityClasses()}\n${marginPaddingTemplate('margin')}\n${marginPaddingTemplate('padding')}`;
-}
-
-// Generates a valid box-shadow value from a shadow Design Token structure
-export function generateRadiusUtilityClasses(propName) {
-  return `.${classAndScssPrefix}-${propName} {
-  --border-radius: #{$${classAndScssPrefix}-${propName}};
-  border-radius: $${classAndScssPrefix}-${propName};
-}`;
-}
-
-// Generates a border based css utility-class from a font Design Token structure
-export function generateBorderUtilityClasses(prop, propName) {
-  let attribute;
-
-  switch (prop.attributes.type) {
-    case 'border-radius':
-    case 'border-style':
-      attribute = prop.attributes.type;
-      break;
-    case 'border-size':
-      attribute = 'border-width';
-      break;
-    default:
-      attribute = 'border-color';
-  }
-  return `.${classAndScssPrefix}-${propName} {
-  --${attribute}: #{$${classAndScssPrefix}-${propName}};
-  ${attribute}: $${classAndScssPrefix}-${propName};
-}`;
-}
-
-// Generates a font based css utility-class from a font Design Token structure
-export function generateFontUtilityClasses(prop, propName) {
-  return `.${classAndScssPrefix}-${propName} {\n  ${prop.attributes.type}: $${classAndScssPrefix}-${propName};\n}`;
-}
-
-// Generates a valid box-shadow value from a shadow Design Token structure
-export function generateShadowUtilityClasses(propName) {
-  return `.${classAndScssPrefix}-${propName} {
-  --box-shadow: #{$${classAndScssPrefix}-${propName}};
-  box-shadow: $${classAndScssPrefix}-${propName};
-}`;
-}
-
-// Generates a utility class for a given token category and name
-export function generateUtilityClasses(tokenCategory, propName){
-  return `.${classAndScssPrefix}-${propName} {\n  ${tokenCategory}: $${classAndScssPrefix}-${propName};\n}`;
-}

core/src/components/accordion-group/accordion-group.common.scss

@@ -1,6 +0,0 @@
-// Accordion Group: Common
-// --------------------------------------------------
-
-:host {
-  display: block;
-}

core/src/components/accordion-group/accordion-group.ionic.scss

@@ -1,37 +0,0 @@
-@use "../../themes/ionic/ionic.globals.scss" as globals;
-@use "./accordion-group.common";
-
-// Ionic Accordion Group
-// --------------------------------------------------
-
-:host {
-  min-width: calc(#{globals.$ion-scale-6200} + #{globals.$ion-space-600});
-
-  background-color: globals.$ion-bg-neutral-subtlest-default;
-}
-
-// Inset Accordion Group
-// --------------------------------------------------
-// Shape and padding only apply if the group is inset
-
-:host(.accordion-group-expand-inset) {
-  @include globals.padding(globals.$ion-space-100);
-}
-
-:host(.accordion-group-expand-inset.accordion-group-shape-round) {
-  --border-radius: #{globals.$ion-round-xl};
-
-  @include globals.border-radius(globals.$ion-round-xl);
-}
-
-:host(.accordion-group-expand-inset.accordion-group-shape-soft) {
-  --border-radius: #{globals.$ion-soft-xl};
-
-  @include globals.border-radius(globals.$ion-soft-xl);
-}
-
-:host(.accordion-group-expand-inset.accordion-group-shape-rectangular) {
-  --border-radius: #{globals.$ion-rectangular-xl};
-
-  @include globals.border-radius(globals.$ion-rectangular-xl);
-}

core/src/components/accordion-group/accordion-group.ios.scss

@@ -1,4 +1,4 @@
-@import "./accordion-group.native";
+@import "./accordion-group";
 
 // iOS Accordion Group
 // --------------------------------------------------

core/src/components/accordion-group/accordion-group.md.scss

@@ -1,4 +1,4 @@
-@import "./accordion-group.native";
+@import "./accordion-group";
 @import "../accordion/accordion.md.vars";
 
 // Material Design Accordion Group
@@ -11,12 +11,7 @@
 :host(.accordion-group-expand-inset) ::slotted(ion-accordion.accordion-expanding),
 :host(.accordion-group-expand-inset) ::slotted(ion-accordion.accordion-expanded) {
   @include margin($accordion-md-expanded-margin, 0, $accordion-md-expanded-margin, 0);
-  @include border-radius(
-    $accordion-md-border-radius,
-    $accordion-md-border-radius,
-    $accordion-md-border-radius,
-    $accordion-md-border-radius
-  );
+  @include border-radius($accordion-md-border-radius, $accordion-md-border-radius, $accordion-md-border-radius, $accordion-md-border-radius);
 }
 
 :host(.accordion-group-expand-inset) ::slotted(ion-accordion.accordion-previous) {

core/src/components/accordion-group/accordion-group.scss

@@ -1,10 +1,13 @@
-@import "./accordion-group.common";
-@import "../../themes/native/native.globals";
+@import "../../themes/ionic.globals";
 @import "../accordion/accordion.vars";
 
-// Accordion Group: Native
+// Accordion Group
 // --------------------------------------------------
 
+:host {
+  display: block;
+}
+
 :host(.accordion-group-expand-inset) {
   @include margin($accordion-inset-margin, $accordion-inset-margin, $accordion-inset-margin, $accordion-inset-margin);
 }

core/src/components/accordion-group/accordion-group.tsx

@@ -2,20 +2,18 @@ import type { ComponentInterface, EventEmitter } from '@stencil/core';
 import { Component, Element, Event, Host, Listen, Method, Prop, Watch, h } from '@stencil/core';
 import { printIonWarning } from '@utils/logging';
 
-import { getIonTheme } from '../../global/ionic-global';
+import { getIonMode } from '../../global/ionic-global';
 
 import type { AccordionGroupChangeEventDetail } from './accordion-group-interface';
 
 /**
- * @virtualProp {"ios" | "md"} mode - The mode determines the platform behaviors of the component.
- * @virtualProp {"ios" | "md" | "ionic"} theme - The theme determines the visual appearance of the component.
+ * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
  */
 @Component({
   tag: 'ion-accordion-group',
   styleUrls: {
     ios: 'accordion-group.ios.scss',
     md: 'accordion-group.md.scss',
-    ionic: 'accordion-group.ionic.scss',
   },
   shadow: true,
 })
@@ -60,16 +58,6 @@ export class AccordionGroup implements ComponentInterface {
    */
   @Prop() expand: 'compact' | 'inset' = 'compact';
 
-  /**
-   * Set to `"soft"` for an accordion group with slightly rounded corners,
-   * `"round"` for an accordion group with fully rounded corners, or
-   * `"rectangular"` for an accordion group without rounded corners.
-   *
-   * Defaults to `"round"` for the `ionic` theme, undefined for all other themes.
-   * Only applies when `expand` is set to `"inset"`.
-   */
-  @Prop() shape?: 'soft' | 'round' | 'rectangular';
-
   /**
    * Emitted when the value property has changed as a result of a user action such as a click.
    *
@@ -288,35 +276,17 @@ export class AccordionGroup implements ComponentInterface {
     return Array.from(this.el.querySelectorAll(':scope > ion-accordion')) as HTMLIonAccordionElement[];
   }
 
-  private getShape(): string | undefined {
-    const theme = getIonTheme(this);
-    const { shape } = this;
-
-    // TODO(ROU-11328): Remove theme check when shapes are defined for all themes.
-    if (theme !== 'ionic') {
-      return undefined;
-    }
-
-    if (shape === undefined) {
-      return 'round';
-    }
-
-    return shape;
-  }
-
   render() {
     const { disabled, readonly, expand } = this;
-    const theme = getIonTheme(this);
-    const shape = this.getShape();
+    const mode = getIonMode(this);
 
     return (
       <Host
         class={{
-          [theme]: true,
+          [mode]: true,
           'accordion-group-disabled': disabled,
           'accordion-group-readonly': readonly,
           [`accordion-group-expand-${expand}`]: true,
-          [`accordion-group-shape-${shape}`]: shape !== undefined,
         }}
         role="presentation"
       >

core/src/components/accordion-group/test/expand/accordion-group.e2e.ts

@@ -1,162 +0,0 @@
-import { expect } from '@playwright/test';
-import { configs, test } from '@utils/test/playwright';
-
-configs({ directions: ['ltr'], modes: ['ionic-md'] }).forEach(({ config, screenshot, title }) => {
-  test.describe(title('accordion-group: expand'), () => {
-    test.describe(title('compact'), () => {
-      test('should not have visual regressions', async ({ page }) => {
-        await page.setContent(
-          `
-          <style>
-            /* Background styles to show the border radius */
-            :root {
-              --background: #ccc7c7;
-            }
-          </style>
-          <ion-accordion-group>
-            <ion-accordion value="first">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-            <ion-accordion value="second">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-            <ion-accordion value="third">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-          </ion-accordion-group>
-        `,
-          config
-        );
-
-        const accordionGroup = page.locator('ion-accordion-group');
-
-        await expect(accordionGroup).toHaveScreenshot(screenshot('accordion-group-expand-compact'));
-      });
-
-      test('should not have visual regressions when expanded', async ({ page }) => {
-        await page.setContent(
-          `
-          <style>
-            /* Background styles to show the border radius */
-            :root {
-              --background: #ccc7c7;
-            }
-          </style>
-          <ion-accordion-group value="first">
-            <ion-accordion value="first">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-            <ion-accordion value="second">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-            <ion-accordion value="third">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-          </ion-accordion-group>
-        `,
-          config
-        );
-
-        const accordionGroup = page.locator('ion-accordion-group');
-
-        await expect(accordionGroup).toHaveScreenshot(screenshot('accordion-group-expand-compact-expanded'));
-      });
-    });
-
-    test.describe(title('inset'), () => {
-      test('should not have visual regressions', async ({ page }) => {
-        await page.setContent(
-          `
-          <style>
-            /* Background styles to show the border radius */
-            :root {
-              --background: #ccc7c7;
-            }
-          </style>
-          <ion-accordion-group expand="inset">
-            <ion-accordion value="first">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-            <ion-accordion value="second">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-            <ion-accordion value="third">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-          </ion-accordion-group>
-        `,
-          config
-        );
-
-        const accordionGroup = page.locator('ion-accordion-group');
-
-        await expect(accordionGroup).toHaveScreenshot(screenshot('accordion-group-expand-inset'));
-      });
-
-      test('should not have visual regressions when expanded', async ({ page }) => {
-        await page.setContent(
-          `
-          <style>
-            /* Background styles to show the border radius */
-            :root {
-              --background: #ccc7c7;
-            }
-          </style>
-          <ion-accordion-group value="first" expand="inset">
-            <ion-accordion value="first">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-            <ion-accordion value="second">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-            <ion-accordion value="third">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-          </ion-accordion-group>
-        `,
-          config
-        );
-
-        const accordionGroup = page.locator('ion-accordion-group');
-
-        await expect(accordionGroup).toHaveScreenshot(screenshot('accordion-group-expand-inset-expanded'));
-      });
-    });
-  });
-});

core/src/components/accordion-group/test/expand/index.html

@@ -1,135 +0,0 @@
-<!DOCTYPE html>
-<html lang="en" dir="ltr">
-  <head>
-    <meta charset="UTF-8" />
-    <title>Accordion Group - Expand</title>
-    <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0" />
-    <link href="../../../../../css/ionic.bundle.css" rel="stylesheet" />
-    <link href="../../../../../scripts/testing/styles.css" rel="stylesheet" />
-    <script src="../../../../../scripts/testing/scripts.js"></script>
-    <script type="module" src="../../../../../dist/ionic/ionic.esm.js"></script>
-    <style>
-      .grid {
-        display: grid;
-        grid-template-columns: repeat(2, 1fr);
-        grid-row-gap: 20px;
-        grid-column-gap: 20px;
-      }
-      h2 {
-        font-size: 12px;
-        font-weight: normal;
-
-        color: #6f7378;
-
-        margin-top: 10px;
-        margin-left: 5px;
-      }
-    </style>
-  </head>
-
-  <body>
-    <ion-app>
-      <ion-header translucent="true">
-        <ion-toolbar>
-          <ion-title>Accordion Group - Expand</ion-title>
-        </ion-toolbar>
-      </ion-header>
-      <ion-content fullscreen="true" color="light">
-        <div class="grid ion-padding">
-          <div class="grid-item">
-            <h2>Default</h2>
-            <ion-accordion-group>
-              <ion-accordion value="first">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="second">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="third">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-            </ion-accordion-group>
-          </div>
-          <div class="grid-item">
-            <h2>Default: Expanded</h2>
-            <ion-accordion-group value="first">
-              <ion-accordion value="first">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="second">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="third">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-            </ion-accordion-group>
-          </div>
-          <div class="grid-item">
-            <h2>Inset</h2>
-            <ion-accordion-group expand="inset">
-              <ion-accordion value="first">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="second">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="third">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-            </ion-accordion-group>
-          </div>
-          <div class="grid-item">
-            <h2>Inset: Expanded</h2>
-            <ion-accordion-group value="first" expand="inset">
-              <ion-accordion value="first">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="second">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="third">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-            </ion-accordion-group>
-          </div>
-        </div>
-      </ion-content>
-    </ion-app>
-  </body>
-</html>

core/src/components/accordion-group/test/shape/accordion-group.e2e.ts

@@ -1,47 +0,0 @@
-import { expect } from '@playwright/test';
-import { configs, test } from '@utils/test/playwright';
-
-configs({ directions: ['ltr'], modes: ['ionic-md'] }).forEach(({ config, screenshot, title }) => {
-  test.describe(title('accordion-group: shape'), () => {
-    ['round', 'soft', 'rectangular'].forEach((shape) => {
-      test(`${shape} - should not have visual regressions`, async ({ page }) => {
-        await page.setContent(
-          `
-          <style>
-            /* Background styles to show the border radius */
-            :root {
-              --background: #222;
-            }
-          </style>
-
-          <ion-accordion-group value="first" expand="inset" shape="${shape}">
-            <ion-accordion value="first">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-            <ion-accordion value="second">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-            <ion-accordion value="third">
-              <ion-item slot="header">
-                <ion-label>Accordion title</ion-label>
-              </ion-item>
-              <div slot="content">This is the body of the accordion.</div>
-            </ion-accordion>
-          </ion-accordion-group>
-      `,
-          config
-        );
-
-        const accordionGroup = page.locator('ion-accordion-group');
-
-        await expect(accordionGroup).toHaveScreenshot(screenshot(`accordion-group-shape-${shape}`));
-      });
-    });
-  });
-});

core/src/components/accordion-group/test/shape/index.html

@@ -1,135 +0,0 @@
-<!DOCTYPE html>
-<html lang="en" dir="ltr">
-  <head>
-    <meta charset="UTF-8" />
-    <title>Accordion Group - Shape</title>
-    <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0" />
-    <link href="../../../../../css/ionic.bundle.css" rel="stylesheet" />
-    <link href="../../../../../scripts/testing/styles.css" rel="stylesheet" />
-    <script src="../../../../../scripts/testing/scripts.js"></script>
-    <script type="module" src="../../../../../dist/ionic/ionic.esm.js"></script>
-    <style>
-      .grid {
-        display: grid;
-        grid-template-columns: repeat(4, 1fr);
-        grid-row-gap: 20px;
-        grid-column-gap: 20px;
-      }
-      h2 {
-        font-size: 12px;
-        font-weight: normal;
-
-        color: #6f7378;
-
-        margin-top: 10px;
-        margin-left: 5px;
-      }
-    </style>
-  </head>
-
-  <body>
-    <ion-app>
-      <ion-header translucent="true">
-        <ion-toolbar>
-          <ion-title>Accordion Group - Shape</ion-title>
-        </ion-toolbar>
-      </ion-header>
-      <ion-content fullscreen="true" color="light">
-        <div class="grid ion-padding">
-          <div class="grid-item">
-            <h2>Default</h2>
-            <ion-accordion-group expand="inset" value="first">
-              <ion-accordion value="first">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="second">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="third">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-            </ion-accordion-group>
-          </div>
-          <div class="grid-item">
-            <h2>Round</h2>
-            <ion-accordion-group expand="inset" value="first" shape="round">
-              <ion-accordion value="first">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="second">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="third">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-            </ion-accordion-group>
-          </div>
-          <div class="grid-item">
-            <h2>Soft</h2>
-            <ion-accordion-group expand="inset" value="first" shape="soft">
-              <ion-accordion value="first">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="second">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="third">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-            </ion-accordion-group>
-          </div>
-          <div class="grid-item">
-            <h2>Rectangular</h2>
-            <ion-accordion-group expand="inset" value="first" shape="rectangular">
-              <ion-accordion value="first">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="second">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="third">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-            </ion-accordion-group>
-          </div>
-        </div>
-      </ion-content>
-    </ion-app>
-  </body>
-</html>

core/src/components/accordion-group/test/states/accordion-group.e2e.ts

@@ -1,38 +0,0 @@
-import { expect } from '@playwright/test';
-import { configs, test } from '@utils/test/playwright';
-
-configs({ directions: ['ltr'], modes: ['ionic-md'] }).forEach(({ config, screenshot, title }) => {
-  test.describe(title('accordion-group: states'), () => {
-    test('should render disabled state', async ({ page }) => {
-      await page.setContent(
-        `
-        <ion-accordion-group value="first" disabled="true">
-          <ion-accordion value="first">
-            <ion-item slot="header">
-              <ion-label>Accordion title</ion-label>
-            </ion-item>
-            <div slot="content">This is the body of the accordion.</div>
-          </ion-accordion>
-          <ion-accordion value="second">
-            <ion-item slot="header">
-              <ion-label>Accordion title</ion-label>
-            </ion-item>
-            <div slot="content">This is the body of the accordion.</div>
-          </ion-accordion>
-          <ion-accordion value="third">
-            <ion-item slot="header">
-              <ion-label>Accordion title</ion-label>
-            </ion-item>
-            <div slot="content">This is the body of the accordion.</div>
-          </ion-accordion>
-        </ion-accordion-group>
-    `,
-        config
-      );
-
-      const accordionGroup = page.locator('ion-accordion-group');
-
-      await expect(accordionGroup).toHaveScreenshot(screenshot('accordion-group-disabled'));
-    });
-  });
-});

core/src/components/accordion-group/test/states/index.html

@@ -1,89 +0,0 @@
-<!DOCTYPE html>
-<html lang="en" dir="ltr">
-  <head>
-    <meta charset="UTF-8" />
-    <title>Accordion Group - States</title>
-    <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0" />
-    <link href="../../../../../css/ionic.bundle.css" rel="stylesheet" />
-    <link href="../../../../../scripts/testing/styles.css" rel="stylesheet" />
-    <script src="../../../../../scripts/testing/scripts.js"></script>
-    <script type="module" src="../../../../../dist/ionic/ionic.esm.js"></script>
-    <style>
-      .grid {
-        display: grid;
-        grid-template-columns: repeat(3, 1fr);
-        grid-row-gap: 20px;
-        grid-column-gap: 20px;
-      }
-      h2 {
-        font-size: 12px;
-        font-weight: normal;
-
-        color: #6f7378;
-
-        margin-top: 10px;
-        margin-left: 5px;
-      }
-    </style>
-  </head>
-
-  <body>
-    <ion-app>
-      <ion-header translucent="true">
-        <ion-toolbar>
-          <ion-title>Accordion Group - States</ion-title>
-        </ion-toolbar>
-      </ion-header>
-      <ion-content fullscreen="true" color="light">
-        <div class="grid ion-padding">
-          <div class="grid-item">
-            <h2>Default</h2>
-            <ion-accordion-group value="first">
-              <ion-accordion value="first">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="second">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="third">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-            </ion-accordion-group>
-          </div>
-          <div class="grid-item">
-            <h2>Disabled</h2>
-            <ion-accordion-group value="first" disabled="true">
-              <ion-accordion value="first">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="second">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-              <ion-accordion value="third">
-                <ion-item slot="header">
-                  <ion-label>Accordion title</ion-label>
-                </ion-item>
-                <div slot="content">This is the body of the accordion.</div>
-              </ion-accordion>
-            </ion-accordion-group>
-          </div>
-        </div>
-      </ion-content>
-    </ion-app>
-  </body>
-</html>

core/src/components/accordion/accordion.ionic.scss

@@ -1,76 +0,0 @@
-@use "../../themes/ionic/ionic.globals.scss" as globals;
-@use "./accordion.common";
-
-// Ionic Accordion
-// --------------------------------------------------
-
-:host {
-  position: relative;
-}
-
-// The border is added to the ::after element
-// to properly inset the border relative to the entire
-// accordion, rather than just the header.
-:host::after {
-  @include globals.margin(null, globals.$ion-space-400, null, globals.$ion-space-400);
-  @include globals.position(null, 0, 0, 0);
-
-  display: block;
-
-  position: absolute;
-
-  height: globals.$ion-border-size-025;
-
-  background-color: globals.$ion-border-default;
-
-  content: "";
-
-  z-index: 3;
-}
-
-:host(.accordion-animated) {
-  transition: all 300ms cubic-bezier(0.25, 0.8, 0.5, 1);
-}
-
-:host(.accordion-animated) #content {
-  transition: max-height 300ms cubic-bezier(0.25, 0.8, 0.5, 1);
-}
-
-// Accordion Header
-// --------------------------------------------------
-
-// The border is removed from the item in the header because
-// we are adding a border to the ::after element of the accordion.
-::slotted(ion-item[slot="header"]) {
-  --border-radius: inherit;
-  --color: #{globals.$ion-text-default};
-  --border-width: #{globals.$ion-border-size-0};
-  --inner-border-width: #{globals.$ion-scale-0};
-  --min-height: #{globals.$ion-scale-700};
-  --padding-top: #{globals.$ion-space-300};
-  --padding-end: #{globals.$ion-space-400};
-  --padding-bottom: #{globals.$ion-space-300};
-  --padding-start: #{globals.$ion-space-400};
-
-  @include globals.typography(globals.$ion-heading-h6-medium);
-}
-
-// Accordion Content
-// --------------------------------------------------
-
-#content-wrapper {
-  @include globals.padding(globals.$ion-space-300, globals.$ion-space-400);
-  @include globals.typography(globals.$ion-body-md-regular);
-
-  color: globals.$ion-text-default;
-}
-
-// Disabled Accordion
-// --------------------------------------------------
-
-:host(.accordion-disabled)::before {
-  @include globals.border-radius(inherit);
-  @include globals.disabled-state();
-
-  z-index: 2;
-}

core/src/components/accordion/accordion.ios.scss

@@ -1,4 +1,4 @@
-@import "./accordion.native";
+@import "./accordion.scss";
 @import "../item/item.ios.vars";
 
 // iOS Accordion

core/src/components/accordion/accordion.md.scss

@@ -1,4 +1,4 @@
-@import "./accordion.native";
+@import "./accordion.scss";
 
 // Material Design Accordion
 // --------------------------------------------------

core/src/components/accordion/accordion.md.vars.scss

@@ -1,14 +1,13 @@
-@import "../../themes/native/native.globals.md";
+@import "../../themes/ionic.globals.md";
 
 // Accordion
 // --------------------------------------------------
 
 /// @prop - Border radius applied to the accordion
-$accordion-md-border-radius: 6px;
+$accordion-md-border-radius:         6px;
 
 /// @prop - Box shadow of the accordion
-$accordion-md-box-shadow: 0px 3px 1px -2px rgba(0, 0, 0, 0.2), 0px 2px 2px 0px rgba(0, 0, 0, 0.14),
-  0px 1px 5px 0px rgba(0, 0, 0, 0.12);
+$accordion-md-box-shadow:            0px 3px 1px -2px rgba(0, 0, 0, 0.2), 0px 2px 2px 0px rgba(0, 0, 0, 0.14), 0px 1px 5px 0px rgba(0, 0, 0, 0.12);
 
 /// @prop - Margin of the expanded accordion
-$accordion-md-expanded-margin: 16px;
+$accordion-md-expanded-margin:       16px;

core/src/components/accordion/accordion.native.scss

@@ -1,27 +0,0 @@
-@import "./accordion.common";
-@import "./accordion.vars.scss";
-
-// Accordion: Native
-// --------------------------------------------------
-
-:host {
-  background-color: $accordion-background-color;
-}
-
-:host(.accordion-animated) {
-  transition: all $accordion-transition-duration $accordion-transition-easing;
-}
-
-:host(.accordion-animated) #content {
-  transition: max-height $accordion-transition-duration $accordion-transition-easing;
-}
-
-/**
- * We do not set the opacity on the
- * host otherwise you would see the
- * box-shadow behind it.
- */
-:host(.accordion-disabled) #header,
-:host(.accordion-disabled) #content {
-  opacity: $accordion-disabled-opacity;
-}

core/src/components/accordion/accordion.scss

@@ -1,4 +1,6 @@
-// Accordion: Common
+@import "./accordion.vars.scss";
+
+// Accordion
 // --------------------------------------------------
 
 :host {
@@ -8,6 +10,8 @@
 
   width: 100%;
 
+  background-color: $accordion-background-color;
+
   overflow: hidden;
 
   /**
@@ -26,6 +30,14 @@
   --border-width: 0px;
 }
 
+:host(.accordion-animated) {
+  transition: all $accordion-transition-duration $accordion-transition-easing;
+}
+
+:host(.accordion-animated) #content {
+  transition: max-height $accordion-transition-duration $accordion-transition-easing;
+}
+
 #content {
   overflow: hidden;
 
@@ -60,6 +72,16 @@
   pointer-events: none;
 }
 
+/**
+ * We do not set the opacity on the
+ * host otherwise you would see the
+ * box-shadow behind it.
+ */
+:host(.accordion-disabled) #header,
+:host(.accordion-disabled) #content {
+  opacity: $accordion-disabled-opacity;
+}
+
 @media (prefers-reduced-motion: reduce) {
   :host,
   #content {

core/src/components/accordion/accordion.tsx

@@ -1,12 +1,10 @@
-import caretDownRegular from '@phosphor-icons/core/assets/regular/caret-down.svg';
 import type { ComponentInterface } from '@stencil/core';
 import { Component, Element, Host, Prop, State, Watch, h } from '@stencil/core';
 import { addEventListener, getElementRoot, raf, removeEventListener, transitionEndAsync } from '@utils/helpers';
-import { hostContext } from '@utils/theme';
 import { chevronDown } from 'ionicons/icons';
 
 import { config } from '../../global/config';
-import { getIonTheme } from '../../global/ionic-global';
+import { getIonMode } from '../../global/ionic-global';
 
 const enum AccordionState {
   Collapsed = 1 << 0,
@@ -16,8 +14,7 @@ const enum AccordionState {
 }
 
 /**
- * @virtualProp {"ios" | "md"} mode - The mode determines the platform behaviors of the component.
- * @virtualProp {"ios" | "md" | "ionic"} theme - The theme determines the visual appearance of the component.
+ * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
  *
  * @slot header - Content is placed at the top and is used to
  * expand or collapse the accordion item.
@@ -34,7 +31,6 @@ const enum AccordionState {
   styleUrls: {
     ios: 'accordion.ios.scss',
     md: 'accordion.md.scss',
-    ionic: 'accordion.ionic.scss',
   },
   shadow: {
     delegatesFocus: true,
@@ -42,18 +38,70 @@ const enum AccordionState {
 })
 export class Accordion implements ComponentInterface {
   private accordionGroupEl?: HTMLIonAccordionGroupElement | null;
-  private updateListener = () => this.updateState(false);
+  private accordionGroupUpdateHandler = () => {
+    /**
+     * Determine if this update will cause an actual state change.
+     * We only want to mark as "interacted" if the state is changing.
+     */
+    const accordionGroup = this.accordionGroupEl;
+    if (accordionGroup) {
+      const value = accordionGroup.value;
+      const accordionValue = this.value;
+      const shouldExpand = Array.isArray(value) ? value.includes(accordionValue) : value === accordionValue;
+      const isExpanded = this.state === AccordionState.Expanded || this.state === AccordionState.Expanding;
+      const stateWillChange = shouldExpand !== isExpanded;
+
+      /**
+       * Only mark as interacted if:
+       * 1. This is not the first update we've received with a defined value
+       * 2. The state is actually changing (prevents redundant updates from enabling animations)
+       */
+      if (this.hasReceivedFirstUpdate && stateWillChange) {
+        this.hasInteracted = true;
+      }
+
+      /**
+       * Only count this as the first update if the group value is defined.
+       * This prevents the initial undefined value from the group's componentDidLoad
+       * from being treated as the first real update.
+       */
+      if (value !== undefined) {
+        this.hasReceivedFirstUpdate = true;
+      }
+    }
+
+    this.updateState();
+  };
   private contentEl: HTMLDivElement | undefined;
   private contentElWrapper: HTMLDivElement | undefined;
   private headerEl: HTMLDivElement | undefined;
 
   private currentRaf: number | undefined;
 
-  @Element() el!: HTMLElement;
+  @Element() el?: HTMLElement;
 
   @State() state: AccordionState = AccordionState.Collapsed;
   @State() isNext = false;
   @State() isPrevious = false;
+  /**
+   * Tracks whether a user-initiated interaction has occurred.
+   * Animations are disabled until the first interaction happens.
+   * This prevents the accordion from animating when it's programmatically
+   * set to an expanded or collapsed state on initial load.
+   */
+  @State() hasInteracted = false;
+
+  /**
+   * Tracks if this accordion has ever been expanded.
+   * Used to prevent the first expansion from animating.
+   */
+  private hasEverBeenExpanded = false;
+
+  /**
+   * Tracks if this accordion has received its first update from the group.
+   * Used to distinguish initial programmatic sets from user interactions.
+   */
+  private hasReceivedFirstUpdate = false;
 
   /**
    * The value of the accordion. Defaults to an autogenerated
@@ -81,7 +129,7 @@ export class Accordion implements ComponentInterface {
    * rotated when the accordion is expanded
    * or collapsed.
    */
-  @Prop() toggleIcon?: string;
+  @Prop() toggleIcon = chevronDown;
 
   /**
    * The slot inside of `ion-item` to
@@ -92,15 +140,15 @@ export class Accordion implements ComponentInterface {
   connectedCallback() {
     const accordionGroupEl = (this.accordionGroupEl = this.el?.closest('ion-accordion-group'));
     if (accordionGroupEl) {
-      this.updateState(true);
-      addEventListener(accordionGroupEl, 'ionValueChange', this.updateListener);
+      this.updateState();
+      addEventListener(accordionGroupEl, 'ionValueChange', this.accordionGroupUpdateHandler);
     }
   }
 
   disconnectedCallback() {
     const accordionGroupEl = this.accordionGroupEl;
     if (accordionGroupEl) {
-      removeEventListener(accordionGroupEl, 'ionValueChange', this.updateListener);
+      removeEventListener(accordionGroupEl, 'ionValueChange', this.accordionGroupUpdateHandler);
     }
   }
 
@@ -189,34 +237,13 @@ export class Accordion implements ComponentInterface {
     button.setAttribute('aria-expanded', `${expanded}`);
   };
 
-  get accordionToggleIcon() {
-    // Return the icon if it is explicitly set
-    if (this.toggleIcon != null) {
-      return this.toggleIcon;
-    }
-
-    // Determine the theme and map to default icons
-    const theme = getIonTheme(this);
-    const defaultIcons = {
-      ios: chevronDown,
-      ionic: caretDownRegular,
-      md: chevronDown,
-    };
-
-    // Get the default icon based on the theme, falling back to 'md' icon if necessary
-    const defaultIcon = defaultIcons[theme] || defaultIcons.md;
-
-    // Return the configured accordion toggle icon or the default icon
-    return config.get('accordionToggleIcon', defaultIcon);
-  }
-
   private slotToggleIcon = () => {
     const ionItem = this.getSlottedHeaderIonItem();
     if (!ionItem) {
       return;
     }
 
-    const { accordionToggleIcon, toggleIconSlot } = this;
+    const { toggleIconSlot, toggleIcon } = this;
 
     /**
      * Check if there already is a toggle icon.
@@ -231,16 +258,22 @@ export class Accordion implements ComponentInterface {
     iconEl.slot = toggleIconSlot;
     iconEl.lazy = false;
     iconEl.classList.add('ion-accordion-toggle-icon');
-    iconEl.icon = accordionToggleIcon;
+    iconEl.icon = toggleIcon;
     iconEl.setAttribute('aria-hidden', 'true');
 
     ionItem.appendChild(iconEl);
   };
 
-  private expandAccordion = (initialUpdate = false) => {
+  private expandAccordion = () => {
     const { contentEl, contentElWrapper } = this;
-    if (initialUpdate || contentEl === undefined || contentElWrapper === undefined) {
+
+    /**
+     * If the content elements aren't available yet, just set the state.
+     * This happens on initial render before the DOM is ready.
+     */
+    if (contentEl === undefined || contentElWrapper === undefined) {
       this.state = AccordionState.Expanded;
+      this.hasEverBeenExpanded = true;
       return;
     }
 
@@ -252,6 +285,12 @@ export class Accordion implements ComponentInterface {
       cancelAnimationFrame(this.currentRaf);
     }
 
+    /**
+     * Mark that this accordion has been expanded at least once.
+     * This allows subsequent expansions to animate.
+     */
+    this.hasEverBeenExpanded = true;
+
     if (this.shouldAnimate()) {
       raf(() => {
         this.state = AccordionState.Expanding;
@@ -272,9 +311,14 @@ export class Accordion implements ComponentInterface {
     }
   };
 
-  private collapseAccordion = (initialUpdate = false) => {
+  private collapseAccordion = () => {
     const { contentEl } = this;
-    if (initialUpdate || contentEl === undefined) {
+
+    /**
+     * If the content element isn't available yet, just set the state.
+     * This happens on initial render before the DOM is ready.
+     */
+    if (contentEl === undefined) {
       this.state = AccordionState.Collapsed;
       return;
     }
@@ -316,6 +360,19 @@ export class Accordion implements ComponentInterface {
    * of what is set in the config.
    */
   private shouldAnimate = () => {
+    /**
+     * Don't animate until after the first user interaction.
+     * This prevents animations on initial load when accordions
+     * start in an expanded or collapsed state programmatically.
+     *
+     * Additionally, don't animate the very first expansion even if
+     * hasInteracted is true. This handles edge cases like React StrictMode
+     * where effects run twice and might incorrectly mark as interacted.
+     */
+    if (!this.hasInteracted || !this.hasEverBeenExpanded) {
+      return false;
+    }
+
     if (typeof (window as any) === 'undefined') {
       return false;
     }
@@ -337,7 +394,7 @@ export class Accordion implements ComponentInterface {
     return true;
   };
 
-  private updateState = async (initialUpdate = false) => {
+  private updateState = async () => {
     const accordionGroup = this.accordionGroupEl;
     const accordionValue = this.value;
 
@@ -350,10 +407,10 @@ export class Accordion implements ComponentInterface {
     const shouldExpand = Array.isArray(value) ? value.includes(accordionValue) : value === accordionValue;
 
     if (shouldExpand) {
-      this.expandAccordion(initialUpdate);
+      this.expandAccordion();
       this.isNext = this.isPrevious = false;
     } else {
-      this.collapseAccordion(initialUpdate);
+      this.collapseAccordion();
 
       /**
        * When using popout or inset,
@@ -379,6 +436,10 @@ export class Accordion implements ComponentInterface {
   };
 
   private getNextSibling = () => {
+    if (!this.el) {
+      return;
+    }
+
     const nextSibling = this.el.nextElementSibling;
 
     if (nextSibling?.tagName !== 'ION-ACCORDION') {
@@ -389,6 +450,10 @@ export class Accordion implements ComponentInterface {
   };
 
   private getPreviousSibling = () => {
+    if (!this.el) {
+      return;
+    }
+
     const previousSibling = this.el.previousElementSibling;
 
     if (previousSibling?.tagName !== 'ION-ACCORDION') {
@@ -403,6 +468,12 @@ export class Accordion implements ComponentInterface {
 
     if (disabled || readonly) return;
 
+    /**
+     * Mark that the user has interacted with the accordion.
+     * This enables animations for all future state changes.
+     */
+    this.hasInteracted = true;
+
     if (accordionGroupEl) {
       /**
        * Because the accordion group may or may
@@ -419,7 +490,7 @@ export class Accordion implements ComponentInterface {
 
   render() {
     const { disabled, readonly } = this;
-    const theme = getIonTheme(this);
+    const mode = getIonMode(this);
     const expanded = this.state === AccordionState.Expanded || this.state === AccordionState.Expanding;
     const headerPart = expanded ? 'header expanded' : 'header';
     const contentPart = expanded ? 'content expanded' : 'content';
@@ -429,7 +500,7 @@ export class Accordion implements ComponentInterface {
     return (
       <Host
         class={{
-          [theme]: true,
+          [mode]: true,
           'accordion-expanding': this.state === AccordionState.Expanding,
           'accordion-expanded': this.state === AccordionState.Expanded,
           'accordion-collapsing': this.state === AccordionState.Collapsing,
@@ -442,8 +513,6 @@ export class Accordion implements ComponentInterface {
           'accordion-readonly': readonly,
 
           'accordion-animated': this.shouldAnimate(),
-
-          'in-accordion-group-expand-inset': hostContext('.accordion-group-expand-inset', this.el),
         }}
       >
         <div

core/src/components/accordion/accordion.vars.scss

@@ -1,19 +1,19 @@
-@import "../../themes/native/native.globals";
+@import "../../themes/ionic.globals";
 
 // Accordion
 // --------------------------------------------------
 
 /// @prop - Background color of the accordion
-$accordion-background-color: var(--ion-background-color, #ffffff);
+$accordion-background-color:      var(--ion-background-color, #ffffff);
 
 /// @prop - Duration of the accordion transition
-$accordion-transition-duration: 300ms;
+$accordion-transition-duration:   300ms;
 
 /// @prop - Timing function of the accordion transition
-$accordion-transition-easing: cubic-bezier(0.25, 0.8, 0.5, 1);
+$accordion-transition-easing:     cubic-bezier(0.25, 0.8, 0.5, 1);
 
 /// @prop - Opacity of the disabled accordion
-$accordion-disabled-opacity: 0.4;
+$accordion-disabled-opacity:      0.4;
 
 /// @prop - Margin of the inset accordion
-$accordion-inset-margin: 16px;
+$accordion-inset-margin:          16px;

core/src/components/accordion/test/accordion.spec.ts

@@ -200,6 +200,87 @@ it('should set default values if not provided', async () => {
   expect(accordion.classList.contains('accordion-collapsed')).toEqual(false);
 });
 
+it('should not animate when initial value is set before load', async () => {
+  const page = await newSpecPage({
+    components: [Item, Accordion, AccordionGroup],
+  });
+
+  const accordionGroup = page.doc.createElement('ion-accordion-group');
+  accordionGroup.innerHTML = `
+    <ion-accordion value="first">
+      <ion-item slot="header">Label</ion-item>
+      <div slot="content">Content</div>
+    </ion-accordion>
+    <ion-accordion value="second">
+      <ion-item slot="header">Label</ion-item>
+      <div slot="content">Content</div>
+    </ion-accordion>
+  `;
+
+  accordionGroup.value = 'first';
+  page.body.appendChild(accordionGroup);
+
+  await page.waitForChanges();
+
+  const firstAccordion = accordionGroup.querySelector('ion-accordion[value="first"]')!;
+
+  expect(firstAccordion.classList.contains('accordion-expanded')).toEqual(true);
+  expect(firstAccordion.classList.contains('accordion-expanding')).toEqual(false);
+});
+
+it('should not animate when initial value is set after load', async () => {
+  const page = await newSpecPage({
+    components: [Item, Accordion, AccordionGroup],
+  });
+
+  const accordionGroup = page.doc.createElement('ion-accordion-group');
+  accordionGroup.innerHTML = `
+    <ion-accordion value="first">
+      <ion-item slot="header">Label</ion-item>
+      <div slot="content">Content</div>
+    </ion-accordion>
+    <ion-accordion value="second">
+      <ion-item slot="header">Label</ion-item>
+      <div slot="content">Content</div>
+    </ion-accordion>
+  `;
+
+  page.body.appendChild(accordionGroup);
+  await page.waitForChanges();
+
+  accordionGroup.value = 'first';
+  await page.waitForChanges();
+
+  const firstAccordion = accordionGroup.querySelector('ion-accordion[value="first"]')!;
+
+  expect(firstAccordion.classList.contains('accordion-expanded')).toEqual(true);
+  expect(firstAccordion.classList.contains('accordion-expanding')).toEqual(false);
+});
+
+it('should not have animated class on first expansion', async () => {
+  const page = await newSpecPage({
+    components: [Item, Accordion, AccordionGroup],
+    html: `
+      <ion-accordion-group>
+        <ion-accordion value="first">
+          <ion-item slot="header">Label</ion-item>
+          <div slot="content">Content</div>
+        </ion-accordion>
+      </ion-accordion-group>
+    `,
+  });
+
+  const accordionGroup = page.body.querySelector('ion-accordion-group')!;
+  const firstAccordion = page.body.querySelector('ion-accordion[value="first"]')!;
+
+  // First expansion should not have the animated class
+  accordionGroup.value = 'first';
+  await page.waitForChanges();
+
+  expect(firstAccordion.classList.contains('accordion-animated')).toEqual(false);
+  expect(firstAccordion.classList.contains('accordion-expanded')).toEqual(true);
+});
+
 // Verifies fix for https://github.com/ionic-team/ionic-framework/issues/27047
 it('should not have animated class when animated="false"', async () => {
   const page = await newSpecPage({

core/src/components/accordion/test/basic/accordion.e2e.ts

@@ -12,7 +12,6 @@ configs().forEach(({ config, screenshot, title }) => {
     });
   });
 });
-
 configs({ directions: ['ltr'] }).forEach(({ config, title }) => {
   test.describe(title('accordion: ionChange'), () => {
     test.beforeEach(async ({ page }) => {
@@ -59,39 +58,3 @@ configs({ directions: ['ltr'] }).forEach(({ config, title }) => {
     });
   });
 });
-
-configs({ modes: ['ionic-md'] }).forEach(({ config, screenshot, title }) => {
-  test.describe(title('accordion: basic'), () => {
-    test('should not have visual regressions with text content', async ({ page }) => {
-      await page.setContent(
-        `
-        <ion-accordion-group value="first">
-          <ion-accordion value="first">
-            <ion-item slot="header">
-              <ion-label>Accordion title</ion-label>
-            </ion-item>
-            <div slot="content">This is the body of the accordion.</div>
-          </ion-accordion>
-          <ion-accordion value="second">
-            <ion-item slot="header">
-              <ion-label>Accordion title</ion-label>
-            </ion-item>
-            <div slot="content">This is the body of the accordion.</div>
-          </ion-accordion>
-          <ion-accordion value="third">
-            <ion-item slot="header">
-              <ion-label>Accordion title</ion-label>
-            </ion-item>
-            <div slot="content">This is the body of the accordion.</div>
-          </ion-accordion>
-        </ion-accordion-group>
-      `,
-        config
-      );
-
-      const accordion = page.locator('ion-accordion-group');
-
-      await expect(accordion).toHaveScreenshot(screenshot('accordion-basic-text'));
-    });
-  });
-});

core/src/components/accordion/test/multiple/accordion.e2e.ts

@@ -1,7 +1,7 @@
 import { expect } from '@playwright/test';
 import { configs, test } from '@utils/test/playwright';
 
-configs({ directions: ['ltr'], modes: ['ionic-md', 'md', 'ios'] }).forEach(({ config, screenshot, title }) => {
+configs({ directions: ['ltr'] }).forEach(({ config, screenshot, title }) => {
   test.describe(title('accordion: multiple'), () => {
     test('should update value and visually expand items', async ({ page }) => {
       await page.goto(`/src/components/accordion/test/multiple`, config);