fix(core): ensure all file paths use forward slashes in windows

Author: tgreyuk

Diff for: .changeset/evil-goats-begin.md

@@ -0,0 +1,5 @@
+---
+'typedoc-plugin-markdown': patch
+---
+
+- Ensure all file paths use forward slashes in windows (#782).

Diff for: packages/typedoc-plugin-markdown/src/libs/utils/get-file-path.ts

@@ -7,8 +7,9 @@ export function getFilePath(filePathWithExtension: string) {
   if (!filePathWithExtension) {
     return '';
   }
-  return path.join(
+  const filePath = path.join(
     path.dirname(filePathWithExtension),
     path.basename(filePathWithExtension, path.extname(filePathWithExtension)),
   );
+  return filePath.replace(/\\/g, '/');
 }

Diff for: packages/typedoc-plugin-markdown/src/libs/utils/replace-file-name.ts

@@ -1,10 +1,5 @@
-import * as path from 'path';
-
 export function replaceFilename(originalPath: string, newFileName: string) {
-  const normalizedPath = originalPath.replace(/\\/g, '/');
-  const updatedPath = normalizedPath.replace(
-    /\/[^/]+(\.[^/.]+)$/,
-    `${path.sep}${newFileName}$1`,
-  );
-  return path.sep === '\\' ? updatedPath.replace(/\//g, '\\') : updatedPath;
+  return originalPath
+    .replace(/\\/g, '/')
+    .replace(/\/[^/]+(\.[^/.]+)$/, `/${newFileName}$1`);
 }

Diff for: packages/typedoc-plugin-markdown/src/router/routers/member-router.ts

@@ -1,4 +1,7 @@
-import { removeFirstScopedDirectory } from '@plugin/libs/utils/index.js';
+import {
+  removeFirstScopedDirectory,
+  replaceFilename,
+} from '@plugin/libs/utils/index.js';
 import { MarkdownRenderer } from '@plugin/types/markdown-renderer.js';
 import * as path from 'path';
 import {
@@ -28,12 +31,6 @@ export class KindStructureRouter extends MarkdownRouter {
       if (this.isPackages) {
         const meta = (this.application.renderer as MarkdownRenderer)
           ?.packagesMeta[reflection.name];
-        const replaceFilename = (originalPath: string, newFileName: string) => {
-          return originalPath.replace(
-            /\/[^/]+(\.[^/.]+)$/,
-            `/${newFileName}$1`,
-          );
-        };
         if (
           meta &&
           (reflection as DeclarationReflection).readme &&
@@ -132,6 +129,7 @@ export class KindStructureRouter extends MarkdownRouter {
     }
     let fullName = path
       .join([dir, fileName].filter((part) => !!part).join('/'))
+      .replace(/\\/g, '/')
       .replace(/ /g, '-');
 
     if (this.ignoreScopes) {

Diff for: packages/typedoc-plugin-markdown/src/router/routers/module-router.ts

@@ -1,5 +1,6 @@
 import {
   removeFirstScopedDirectory,
+  replaceFilename,
   toPascalCase,
 } from '@plugin/libs/utils/index.js';
 import { MarkdownRenderer } from '@plugin/types/markdown-renderer.js';
@@ -31,12 +32,6 @@ export class ModuleRouter extends MarkdownRouter {
       if (this.isPackages) {
         const meta = (this.application.renderer as MarkdownRenderer)
           ?.packagesMeta[reflection.name];
-        const replaceFilename = (originalPath: string, newFileName: string) => {
-          return originalPath.replace(
-            /\/[^/]+(\.[^/.]+)$/,
-            `/${newFileName}$1`,
-          );
-        };
         if (
           meta &&
           (reflection as DeclarationReflection).readme &&
@@ -132,6 +127,7 @@ export class ModuleRouter extends MarkdownRouter {
     }
     let fullName = path
       .join([dir, fileName].filter((part) => !!part).join('/'))
+      .replace(/\\/g, '/')
       .replace(/ /g, '-');
     if (this.ignoreScopes) {
       fullName = removeFirstScopedDirectory(fullName);