fix: fixes various Windows path and links related issues

packages/starlight-typedoc/libs/starlight.ts

@@ -135,7 +135,7 @@ function getSidebarGroupFromReflections(
 
         // The groups generated using the `@group` tag do not have an associated directory on disk.
         const isGroupWithDirectory = group.children.some((child) =>
-          path.posix.join(baseOutputDirectory, child.url ?? '').startsWith(directory),
+          path.posix.join(baseOutputDirectory, child.url?.replace('\\', '/') ?? '').startsWith(directory),
         )
 
         if (!isGroupWithDirectory) {
@@ -212,7 +212,7 @@ export function getRelativeURL(url: string, baseUrl: string, pageUrl?: string):
   const filePath = path.parse(relativeUrl)
   const [, anchor] = filePath.base.split('#')
   const segments = filePath.dir
-    .split('/')
+    .split(/[/\\]/)
     .map((segment) => slug(segment))
     .filter((segment) => segment !== '')
 

packages/starlight-typedoc/libs/typedoc.ts

@@ -105,7 +105,7 @@ async function bootstrapApp(
 function onRendererPageEnd(event: PageEvent<DeclarationReflection>, pagination: boolean) {
   if (!event.contents) {
     return
-  } else if (/^.+\/README\.md$/.test(event.url)) {
+  } else if (/^.+[/\\]README\.md$/.test(event.url)) {
     // Do not save `README.md` files for multiple entry points.
     event.preventDefault()
     return

packages/starlight-typedoc/package.json

@@ -16,9 +16,9 @@
     "test": "pnpm test:unit && pnpm test:e2e",
     "test:unit": "vitest",
     "test:e2e": "pnpm run test:e2e:basics && pnpm run test:e2e:packages && pnpm run test:e2e:plugins",
-    "test:e2e:basics": "TEST_TYPE=basics pnpm run playwright",
-    "test:e2e:packages": "TEST_TYPE=packages pnpm run playwright",
-    "test:e2e:plugins": "TEST_TYPE=plugins pnpm run playwright",
+    "test:e2e:basics": "cross-env TEST_TYPE=basics pnpm run playwright",
+    "test:e2e:packages": "cross-env TEST_TYPE=packages pnpm run playwright",
+    "test:e2e:plugins": "cross-env TEST_TYPE=plugins pnpm run playwright",
     "playwright": "playwright install --with-deps chromium && playwright test",
     "lint": "prettier -c --cache . && eslint . --cache --max-warnings=0"
   },
@@ -30,6 +30,7 @@
     "@playwright/test": "1.35.0",
     "@types/node": "18.16.16",
     "astro": "4.0.6",
+    "cross-env": "7.0.3",
     "typescript": "5.1.6",
     "vitest": "1.0.4"
   },

packages/starlight-typedoc/tests/e2e/basics/pagination.test.ts

@@ -10,7 +10,7 @@ test('should not include pagination links by default', async ({ docPage }) => {
   await expect(prev).not.toBeVisible()
 })
 
-test('should not include pagination links if configured to do so', async ({ docPage }) => {
+test('should include pagination links if configured to do so', async ({ docPage }) => {
   docPage.useMultipleEntryPoints()
 
   await docPage.goto('bar/classes/bar')

packages/starlight-typedoc/tests/unit/typedoc.test.ts

@@ -63,7 +63,7 @@ test('should generate the doc in `src/content/docs/api` by default', async () =>
   const mkdirSyncSpy = vi.mocked(fs.mkdirSync)
 
   expect(mkdirSyncSpy).toHaveBeenCalled()
-  expect(mkdirSyncSpy.mock.calls[0]?.[0].toString().endsWith(`src/content/docs/api`)).toBe(true)
+  expect(mkdirSyncSpy.mock.calls[0]?.[0].toString()).toMatch(/src[/\\]content[/\\]docs[/\\]api$/)
 })
 
 test('should generate the doc in a custom output directory relative to `src/content/docs/`', async () => {
@@ -78,7 +78,9 @@ test('should generate the doc in a custom output directory relative to `src/cont
   const mkdirSyncSpy = vi.mocked(fs.mkdirSync)
 
   expect(mkdirSyncSpy).toHaveBeenCalled()
-  expect(mkdirSyncSpy.mock.calls[0]?.[0].toString().endsWith(`src/content/docs/${output}`)).toBe(true)
+  expect(mkdirSyncSpy.mock.calls[0]?.[0].toString()).toMatch(
+    new RegExp(`src[/\\\\]content[/\\\\]docs[/\\\\]${output}$`),
+  )
 })
 
 test('should not add `README.md` module files for multiple entry points', async () => {