Merge branch 'main' into translation/jp-20251007

# Conflicts:
#	cspell-wordlist.txt
#	plugins/docusaurus-plugin-ionic-component-api/index.js
#	scripts/build-translate/index.ts
#	scripts/data/translated-api.json
#	scripts/data/translated-cache.json
#	src/components/page/reference/ReleaseNotes/release-notes.json
#	src/translate/.detection/api/app.json
#	src/translate/.detection/api/menu.json
#	src/translate/.detection/api/popover.json
#	src/translate/api/app.json
#	src/translate/api/menu.json
#	src/translate/api/popover.json
#	static/code/stackblitz/v7/react/package-lock.json
#	static/code/stackblitz/v7/vue/package-lock.json
#	static/code/stackblitz/v8/react/package-lock.json
#	static/code/stackblitz/v8/vue/package-lock.json
#	static/usage/v8/radio/label-wrap/index.md
#	static/usage/v8/segment/swipeable/index.md

Author: rdlabo

.github/workflows/deploy.yml

@@ -36,7 +36,7 @@ jobs:
       # デプロイ
       - name: deploy
         run: |
-          npx netlify-cli deploy \
+          npx netlify-cli@23.7.3 deploy \
             --site ${{ secrets.NETLIFY_SITE_ID }} \
             --dir www/ \
             --auth ${{ secrets.NETLIFY_TOKEN }} \

cspell-wordlist.txt

@@ -84,3 +84,6 @@ webnative
 
 browserslistrc
 ionicframework
+tappable
+Overscroll
+expressjs

docs/api/picker.md

@@ -235,6 +235,37 @@ Each [Picker Column](./picker-column) can be navigated using the keyboard when f
 | <kbd>Home</kbd>      | Scroll to the first option.          |
 | <kbd>End</kbd>       | Scroll to the last option.           |
 
+## Accessibility
+
+### Screen Readers
+
+Picker supports navigation using a screen reader by implementing the [`slider` role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/slider_role) on each [Picker Column](./picker-column). The following gestures can be used to navigate the Picker.
+
+| Gesture | Function |
+| - | - |
+| Swipe Left | Move focus to the previous Picker Column. |
+| Swipe Right | Move focus to the next Picker Column. |
+| Swipe Up | Select the next option in the Picker Column. |
+| Swipe Down | Select the previous option in the Picker Column. |
+| Double Tap and Slide Up/Down | Adjust the selected option in the Picker Column. Can be used as an alternative to swiping up and down. |
+
+:::caution
+The Swipe Up and Swipe Down gestures rely on the correct key events being synthesized as noted on the [`slider` documentation](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/slider_role). [Chromium-based browsers do not synthesize keyboard events correctly](https://issues.chromium.org/issues/40816094), but the "Double Tap and Slide Up/Down" gesture can be used as an alternative until this has been implemented in Chromium-based browsers.
+:::
+
+### Keyboard Interactions
+
+Each [Picker Column](./picker-column) can be navigated using the keyboard when focused.
+
+| Key                  | Description                          |
+| -------------------- | ------------------------------------ |
+| <kbd>ArrowUp</kbd>   | Scroll to the previous option.       |
+| <kbd>ArrowDown</kbd> | Scroll to the next option.           |
+| <kbd>PageUp</kbd>    | Scroll up by more than one option.   |
+| <kbd>PageDown</kbd>  | Scroll down by more than one option. |
+| <kbd>Home</kbd>      | Scroll to the first option.          |
+| <kbd>End</kbd>       | Scroll to the last option.           |
+
 ## プロパティ
 <Props />
 

plugins/docusaurus-plugin-ionic-component-api/index.js

@@ -19,19 +19,31 @@ module.exports = function (context, options) {
        */
       const generateMarkdownForVersion = async (version, npmTag, isCurrentVersion) => {
         let COMPONENT_LINK_REGEXP;
-        const response = isCurrentVersion
-          ? await fetch(`https://unpkg.com/@ionic/docs@${npmTag}/core.json`)
-          : await fetch(`https://unpkg.com/@ionic/docs@${npmTag}/core.json`);
-        const { components } = await response.json();
-
+        const components = await (async () => {
+          if (isCurrentVersion) {
+            const { components } = require(process.cwd() + `/scripts/data/translated-api.json`);
+            return components;
+          } else {
+            const response = isCurrentVersion
+              ? await fetch(
+                  `https://raw.githubusercontent.com/ionic-jp/ionic-docs/main/scripts/data/translated-api.json`
+                )
+              : await fetch(`https://unpkg.com/@ionic/docs@${npmTag}/core.json`);
+            const { components } = await response.json();
+            return components;
+          }
+        })();
+        // const response = isCurrentVersion
+        //   ? await fetch(`https://raw.githubusercontent.com/ionic-jp/ionic-docs/main/scripts/data/translated-api.json`)
+        //   : await fetch(`https://unpkg.com/@ionic/docs@${npmTag}/core.json`);
+        // const { components } = await response.json();
         const names = components.map((component) => component.tag.slice(4));
         // matches all relative markdown links to a component, e.g. (../button)
         COMPONENT_LINK_REGEXP = new RegExp(`\\(../(${names.join('|')})/?(#[^)]+)?\\)`, 'g');
-
         components.forEach((comp) => {
           const compTag = comp.tag.slice(4);
           const outDir = getDirectoryPath(compTag, version, isCurrentVersion);
-          comp = translateDocs(comp);
+
           data.push({
             outDir,
             componentTag: compTag,
@@ -327,45 +339,3 @@ ${slots.map((slot) => `| \`${slot.name}\` | ${formatMultiline(slot.docs)} |`).jo
 
 `;
 }
-
-function translateDocs(comp) {
-  const { props, events, methods, parts, styles, slots } = comp;
-  return {
-    ...comp,
-    props: props.map((prop) => ({
-      ...prop,
-      docs: translate(prop.docs),
-    })),
-    events: events.map((event) => ({
-      ...event,
-      docs: translate(event.docs),
-    })),
-    methods: methods.map((method) => ({
-      ...method,
-      docs: translate(method.docs),
-    })),
-    parts: parts.map((part) => ({
-      ...part,
-      docs: translate(part.docs),
-    })),
-    styles: styles.map((styles) => ({
-      ...styles,
-      docs: translate(styles.docs),
-    })),
-    slots: slots.map((slot) => ({
-      ...slot,
-      docs: translate(slot.docs),
-    })),
-  };
-}
-
-function translate(docs) {
-  const TranslatedFile = require(process.cwd() + '/scripts/data/translated-cache.json');
-  const translated = TranslatedFile.cache;
-
-  if (translated.hasOwnProperty(docs)) {
-    return translated[docs];
-  }
-
-  return docs;
-}