fix(mdx-loader): skip asset transformation for directory links with dots

packages/docusaurus-mdx-loader/src/remark/transformLinks/__tests__/index.test.ts

@@ -267,4 +267,22 @@ describe('transformLinks plugin', () => {
       });
     });
   });
+
+  it('does not transform link to a directory with a dot in its name', async () => {
+    const result = await processContent(
+      `[link](../directory-with.dot/)`,
+    );
+    expect(result).toMatchInlineSnapshot(
+      `"[link](../directory-with.dot/)"`,
+    );
+  });
+
+  it('does not transform link to a directory with a dot (no trailing slash)', async () => {
+    const result = await processContent(
+      `[link](../directory-with.dot)`,
+    );
+    expect(result).toMatchInlineSnapshot(
+      `"[link](../directory-with.dot)"`,
+    );
+  });
 });

packages/docusaurus-mdx-loader/src/remark/transformLinks/index.ts

@@ -229,6 +229,13 @@ async function processLinkNode(target: Target, context: Context) {
   );
 
   if (localFilePath) {
+    // Skip asset transformation for directories (e.g., "directory-with.dot/")
+    // A directory path with a dot can match hasAssetLikeExtension, but it
+    // should not be treated as a file asset — it's a valid link target.
+    const stats = await fs.stat(localFilePath);
+    if (stats.isDirectory()) {
+      return;
+    }
     await toAssetRequireNode(target, localFilePath, context);
   } else {
     // The @site alias is the only way to believe that the user wants an asset.