fix(vitepress): unblock CI typecheck

Cast virtual imports past Astro ambient clash; loosen test
router setters; cast dts plugin for duplicate Vite types.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: s00d

packages/vitepress/src/define-theme.ts

@@ -51,9 +51,10 @@ export function defineI18nTheme<T extends Theme>(base: T, options: DefineI18nThe
     async enhanceApp(ctx: EnhanceAppContext) {
       let installed = byApp.get(ctx.app)
       if (!installed) {
+        // Cast via `unknown`: root typecheck also sees Astro's ambient `virtual:i18n-micro/config`.
         const [{ config }, messagesMod] = await Promise.all([
-          import('virtual:i18n-micro/config') as Promise<{ config: VirtualI18nConfig }>,
-          import('virtual:i18n-micro/messages') as Promise<VirtualMessagesModule>,
+          import('virtual:i18n-micro/config') as unknown as Promise<{ config: VirtualI18nConfig }>,
+          import('virtual:i18n-micro/messages') as unknown as Promise<VirtualMessagesModule>,
         ])
 
         const localeCodes = config.localeCodes.length

packages/vitepress/tests/define-theme.test.ts

@@ -1,4 +1,5 @@
 import { afterEach, describe, expect, it, vi } from 'vitest'
+import type { Theme } from 'vitepress'
 
 vi.mock('virtual:i18n-micro/config', () => ({
   config: {
@@ -26,35 +27,43 @@ afterEach(() => {
   vi.restoreAllMocks()
 })
 
+function makeApp() {
+  const app = {
+    use: vi.fn((plugin: { global: { getLocale: () => string } }) => {
+      app._i18n = plugin.global
+    }),
+    provide: vi.fn(),
+    config: { globalProperties: {} as Record<string, unknown> },
+    component: vi.fn(),
+    _i18n: undefined as { getLocale: () => string } | undefined,
+  }
+  return app
+}
+
+function makeRouter(path: string) {
+  let after: ((to: string) => unknown) | undefined
+  return {
+    route: { path },
+    go: vi.fn(),
+    set onAfterRouteChange(fn: ((to: string) => unknown) | undefined) {
+      after = fn
+    },
+    get onAfterRouteChange() {
+      return after
+    },
+  }
+}
+
 describe('defineI18nTheme', () => {
   it('maps VitePress locale key to i18n code on first enhanceApp', async () => {
     const { defineI18nTheme } = await import('../src/define-theme')
 
     const theme = defineI18nTheme({
       Layout: {} as never,
-    })
+    } as Theme)
 
-    const app = {
-      use: vi.fn((plugin: { global: { getLocale: () => string } }) => {
-        ;(app as { _i18n?: { getLocale: () => string } })._i18n = plugin.global
-      }),
-      provide: vi.fn(),
-      config: { globalProperties: {} as Record<string, unknown> },
-      component: vi.fn(),
-      _i18n: undefined as { getLocale: () => string } | undefined,
-    }
-
-    let after: ((to: string) => unknown) | undefined
-    const router = {
-      route: { path: '/fr/guide/' },
-      go: vi.fn(),
-      set onAfterRouteChange(fn: (to: string) => unknown) {
-        after = fn
-      },
-      get onAfterRouteChange() {
-        return after
-      },
-    }
+    const app = makeApp()
+    const router = makeRouter('/fr/guide/')
 
     await theme.enhanceApp!({
       app: app as never,
@@ -74,37 +83,18 @@ describe('defineI18nTheme', () => {
       async enhanceApp({ router }) {
         router.onAfterRouteChange = baseHook
       },
-    })
-
-    const app = {
-      use: vi.fn((plugin: { global: { getLocale: () => string } }) => {
-        ;(app as { _i18n?: { getLocale: () => string } })._i18n = plugin.global
-      }),
-      provide: vi.fn(),
-      config: { globalProperties: {} as Record<string, unknown> },
-      component: vi.fn(),
-      _i18n: undefined as { getLocale: () => string } | undefined,
-    }
+    } as Theme)
 
-    let after: ((to: string) => unknown) | undefined
-    const router = {
-      route: { path: '/' },
-      go: vi.fn(),
-      set onAfterRouteChange(fn: (to: string) => unknown) {
-        after = fn
-      },
-      get onAfterRouteChange() {
-        return after
-      },
-    }
+    const app = makeApp()
+    const router = makeRouter('/')
 
     await theme.enhanceApp!({
       app: app as never,
       router: router as never,
       siteData: {} as never,
     })
 
-    await after?.('/fr/')
+    await router.onAfterRouteChange?.('/fr/')
     expect(baseHook).toHaveBeenCalledWith('/fr/')
     expect(app._i18n?.getLocale()).toBe('fr-FR')
   })

packages/vitepress/tests/with-i18n-micro.test.ts

@@ -1,5 +1,5 @@
 import { afterEach, describe, expect, it, vi } from 'vitest'
-import { withI18nMicro, warnLocaleMismatch } from '../src/with-i18n-micro'
+import { withI18nMicro, warnLocaleMismatch, type VitePressUserConfigLike } from '../src/with-i18n-micro'
 import { messagesFromGlob } from '../src/messages-from-glob'
 import { createVitePressI18n } from '../src/create'
 
@@ -38,7 +38,7 @@ describe('withI18nMicro', () => {
 
   it('virtual plugin resolves config module', () => {
     const result = withI18nMicro(
-      {},
+      {} as VitePressUserConfigLike,
       {
         locale: 'en',
         locales: [{ code: 'en', iso: 'en-US' }],
@@ -136,7 +136,7 @@ describe('createVitePressI18n', () => {
     const router = {
       route: { path: '/fr/guide/demo' },
       go: vi.fn(),
-      set onAfterRouteChange(fn: (to: string) => unknown) {
+      set onAfterRouteChange(fn: ((to: string) => unknown) | undefined) {
         after = fn
       },
       get onAfterRouteChange() {
@@ -178,7 +178,7 @@ describe('createVitePressI18n', () => {
     const router = {
       route: { path: '/' },
       go: vi.fn(),
-      set onAfterRouteChange(fn: (to: string) => unknown) {
+      set onAfterRouteChange(fn: ((to: string) => unknown) | undefined) {
         after = fn
       },
       get onAfterRouteChange() {

packages/vitepress/vite.config.mts

@@ -53,6 +53,7 @@ export default defineConfig({
     sourcemap: true,
   },
   plugins: [
+    // Cast: root typecheck can see duplicate Vite copies (@types/node 20 vs 26).
     dts({
       afterDiagnostic(diagnostics) {
         const errors = diagnostics.filter((d) => d.category === 1)
@@ -65,6 +66,6 @@ export default defineConfig({
       outDir: 'dist',
       tsconfigPath: resolve(import.meta.dirname, 'tsconfig.json'),
       beforeWriteFile: dualPackageBeforeWriteFile,
-    }),
+    }) as never,
   ],
 })