chore: merge main into major-10.0

CONTRIBUTING.md

@@ -99,17 +99,17 @@ npm run spellcheck
 - A **directory** or anything matching a **regular expression**, update the following file: `cspell.json`
   - For example, we don't want to flag anything inside of code ticks (<code>`</code>) or code blocks (<code>```</code>), so there are regular expressions added to ignore anything inside of these.
 - An **entire line**, add the following comment above it:
-  ```markdown
-  <!-- cspell:disable-next-line -->
+  ```mdx
+  {/* cspell:disable-next-line */}
   ```
 - **Multiple lines**, add comments above and below the lines to be ignored:
 
-  ```markdown
-  <!-- cspell:disable -->
+  ```mdx
+  {/* cspell:disable */}
 
   <p>Everything inside of these comments will be ignored by the spell checkr. Proofread your own words carefully.</p>
 
-  <!-- cspell:enable -->
+  {/* cspell:enable */}
   ```
 
 > [!IMPORTANT]

_templates/README.md

@@ -21,7 +21,7 @@ If you need a component for multiple versions of Ionic Framework, you (currently
 
 ## Usage
 
-Once you've generated your playground, you need to add it to the main markdown file in the docs (e.g. [docs/api/button.md](../docs/api/button.md)) by doing something similar to the following example:
+Once you've generated your playground, you need to add it to the main markdown file in the docs (e.g. [docs/api/button.mdx](../docs/api/button.mdx)) by doing something similar to the following example:
 
 ```
 ## Feature

docs/updating/9-0.mdx

@@ -558,18 +558,18 @@ The native `<img>` element does not emit Ionic's custom events. Use the standard
 
 ### Input
 
-#### `autocorrect` Property Type Changed to Boolean {#input-autocorrect-property-type-changed-to-boolean}
+#### `autocorrect` Property Type Changed to Boolean {/* #input-autocorrect-property-type-changed-to-boolean */}
 
 The `autocorrect` property on `ion-input` is now a `boolean` (default `false`) instead of `'on' | 'off'`. Because the attribute coerces to `true` for any value other than the string `"false"`, `autocorrect="off"` now enables autocorrect.
 
 - Remove the attribute to keep autocorrect disabled (the default).
 - Use a property binding to enable it: `[autocorrect]="true"` (Angular), `autocorrect={true}` (React), or `:autocorrect="true"` (Vue).
 
-#### Floating Label Behavior {#input-floating-label-behavior}
+#### Floating Label Behavior {/* #input-floating-label-behavior */}
 
 Floating labels no longer automatically float when the input contains slotted content. Labels float only when the input is focused or has a value.
 
-#### Internal DOM Structure Changes {#input-internal-dom-structure-changes}
+#### Internal DOM Structure Changes {/* #input-internal-dom-structure-changes */}
 
 The internal DOM structure has been reorganized to support floating labels with slotted content.
 
@@ -686,7 +686,7 @@ The `swipeBackEnabled` config option is still respected as the initial default a
 
 ### Searchbar
 
-#### `autocorrect` Property Type Changed to Boolean {#searchbar-autocorrect-property-type-changed-to-boolean}
+#### `autocorrect` Property Type Changed to Boolean {/* #searchbar-autocorrect-property-type-changed-to-boolean */}
 
 The `autocorrect` property on `ion-searchbar` is now a `boolean` (default `false`) instead of `'on' | 'off'`. Because the attribute coerces to `true` for any value other than the string `"false"`, `autocorrect="off"` now enables autocorrect.
 
@@ -707,11 +707,11 @@ When using `interface="action-sheet"`, `ion-select` no longer assigns the `selec
 
 Previously, the `selected` role was assigned only to the option matching the select's current value. Because the dismiss role mirrors the tapped button, this surfaced in just one case: re-selecting the already-selected option dismissed the action sheet with `role: "selected"` in `ionActionSheetDidDismiss`. Tapping any other option changed the value and dismissed with `role: ""`. Now that the role is no longer assigned, both cases dismiss with `role: undefined`. Apps that inspected this role to detect that a value was chosen, such as reading `role` from the underlying action sheet's `onDidDismiss` result, should listen for `ion-select`'s `ionChange` event instead, which emits the selected value when the selection changes.
 
-#### Floating Label Behavior {#select-floating-label-behavior}
+#### Floating Label Behavior {/* #select-floating-label-behavior */}
 
 Floating labels no longer automatically float when the select contains slotted content. Labels float only when the select is focused or has a value. Additionally, when using a floating label, the placeholder is only visible when the select is focused.
 
-#### Internal DOM Structure Changes {#select-internal-dom-structure-changes}
+#### Internal DOM Structure Changes {/* #select-internal-dom-structure-changes */}
 
 The internal DOM structure has been reorganized to support floating labels with slotted content. This changes the structure and location of several exposed shadow parts.
 
@@ -745,11 +745,11 @@ Use the new `part="start"`, `part="control"`, and `part="end"` parts to target t
 
 ### Textarea
 
-#### Floating Label Behavior {#textarea-floating-label-behavior}
+#### Floating Label Behavior {/* #textarea-floating-label-behavior */}
 
 Floating labels no longer automatically float when the textarea contains slotted content. Labels float only when the textarea is focused or has a value.
 
-#### Internal DOM Structure Changes {#textarea-internal-dom-structure-changes}
+#### Internal DOM Structure Changes {/* #textarea-internal-dom-structure-changes */}
 
 The internal DOM structure has been reorganized to support floating labels with slotted content.