From d93f57bd533c31db64ccdd077eb6c0a752868280 Mon Sep 17 00:00:00 2001
From: Maria Hutt <thetaPC@users.noreply.github.com>
Date: Mon, 31 Aug 2026 14:23:18 -0700
Subject: [PATCH] chore(i18n, api): generate component API partials as .mdx

---
 .../index.js                                  | 28 ++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/plugins/docusaurus-plugin-ionic-component-api/index.js b/plugins/docusaurus-plugin-ionic-component-api/index.js
index 38636dd98a..3fa04e6fd5 100644
--- a/plugins/docusaurus-plugin-ionic-component-api/index.js
+++ b/plugins/docusaurus-plugin-ionic-component-api/index.js
@@ -89,12 +89,27 @@ module.exports = function (context, options) {
          * createData will create a file within the generated ./docusaurus
          * directory within the plugin directory.
          */
+        promises.push(
+          createData(`${basePath}/props.mdx`, data.props),
+          createData(`${basePath}/events.mdx`, data.events),
+          createData(`${basePath}/methods.mdx`, data.methods),
+          createData(`${basePath}/parts.mdx`, data.parts),
+          createData(`${basePath}/custom-props.mdx`, data.customProps),
+          createData(`${basePath}/slots.mdx`, data.slots)
+        );
+
+        /**
+         * TODO(FW-6456): Remove once every page on this branch imports the `.mdx` names.
+         *
+         * Transitional: this branch's `docs/` pages and its `versioned_docs` copies still
+         * import the `.md` names. Those are rewritten separately, so the old names have to
+         * keep being emitted until they are.
+         */
         promises.push(
           createData(`${basePath}/props.md`, data.props),
           createData(`${basePath}/events.md`, data.events),
           createData(`${basePath}/methods.md`, data.methods),
           createData(`${basePath}/parts.md`, data.parts),
-          createData(`${basePath}/custom-props.mdx`, data.customProps),
           createData(`${basePath}/slots.md`, data.slots)
         );
       }
@@ -112,6 +127,17 @@ module.exports = function (context, options) {
           alias: {
             '@ionic-internal/component-api': `${context.siteDir}/.docusaurus/docusaurus-plugin-ionic-component-api/default`,
           },
+          /**
+           * TODO(FW-6456): Remove once every page on this branch imports the `.mdx` names.
+           *
+           * Lets a `.md` import resolve to a `.mdx` file, so pages can be moved over in
+           * batches rather than all at once. Matches the entry on `main`.
+           *
+           * Applies to every `.md` import, so a stale `.mdx` next to a `.md` will shadow it.
+           */
+          extensionAlias: {
+            '.md': ['.mdx', '.md'],
+          },
         },
       };
     },