chore(core): expose routePathToMdPath utility in runtime (#2967)

SoonIter · web-flow · commit ecb668005cac · 2026-01-06T19:27:17.000+08:00
diff --git a/packages/core/src/runtime/index.ts b/packages/core/src/runtime/index.ts
@@ -37,5 +37,6 @@ export {
   normalizeImagePath,
   removeBase,
   removeTrailingSlash,
+  routePathToMdPath,
   withBase,
 } from './utils';
diff --git a/packages/core/src/runtime/utils.test.ts b/packages/core/src/runtime/utils.test.ts
@@ -0,0 +1,39 @@
+import { describe, expect, it, rs } from '@rstest/core';
+import { routePathToMdPath } from './utils';
+
+rs.mock('virtual-site-data', () => {
+  return {
+    default: {
+      base: '/',
+    },
+  };
+});
+
+describe('routePathToMdPath', () => {
+  it('should match snapshot for various paths', () => {
+    const cases = [
+      '/foo/bar.html',
+      '/foo/bar.html#hash',
+      '/foo/bar.html?q=1',
+      '/foo/bar.html?q=1#hash',
+      '/foo.html',
+      '/simple.html#my-heading',
+      '/query.html?foo=bar&baz=qux',
+      '/complex.html?id=123#section-2',
+    ];
+
+    const results = cases.map(path => routePathToMdPath(path));
+    expect(results).toMatchInlineSnapshot(`
+      [
+        "/foo/bar.md",
+        "/foo/bar.md#hash",
+        "/foo/bar.md?q=1",
+        "/foo/bar.md?q=1#hash",
+        "/foo.md",
+        "/simple.md#my-heading",
+        "/query.md?foo=bar&baz=qux",
+        "/complex.md?id=123#section-2",
+      ]
+    `);
+  });
+});
diff --git a/packages/core/src/runtime/utils.ts b/packages/core/src/runtime/utils.ts
@@ -53,6 +53,13 @@ function normalizeImagePath(imagePath: string) {
   return withBase(imagePath);
 }
 
+function routePathToMdPath(routePath: string): string {
+  let url: string = routePath;
+  url = normalizeHref(url, false);
+  url = url.replace(/\.html(?=#|\?|$)/, '.md');
+  return withBase(url);
+}
+
 function isAbsoluteUrl(path: string) {
   return isExternalUrl(path) || isDataUrl(path) || path.startsWith('//');
 }
@@ -67,4 +74,5 @@ export {
   withBase,
   isEqualPath,
   normalizeHrefInRuntime,
+  routePathToMdPath,
 };
diff --git a/packages/core/src/theme/components/Overview/index.tsx b/packages/core/src/theme/components/Overview/index.tsx
@@ -6,11 +6,10 @@ import type {
 } from '@rspress/core';
 import {
   isEqualPath,
-  normalizeHref,
+  routePathToMdPath,
   useI18n,
   usePageData,
   useSidebar,
-  withBase,
 } from '@rspress/core/runtime';
 import {
   FallbackHeading,
@@ -27,13 +26,6 @@ import {
 import './index.scss';
 import { findItemByRoutePath } from './utils';
 
-function routePathToMdPath(routePath: string): string {
-  let url: string = routePath;
-  url = normalizeHref(url, false);
-  url = url.replace(/\.html$/, '.md');
-  return withBase(url);
-}
-
 function OverviewMarkdown({
   title,
   groups,
