fix(*): many minor issues, type issues

nekomeowww · nekomeowww · commit beb6c9406b28 · 2026-04-16T14:22:01.000+08:00
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
@@ -224,7 +224,7 @@ export default defineConfig({
   async transformHead(context) {
     let head = [...context.head]
 
-    const returnedHead = await transformHeadMeta()(head, context)
+    const returnedHead = await transformHeadMeta()(head, context as never)
     if (typeof returnedHead !== 'undefined')
       head = returnedHead
 
@@ -262,6 +262,6 @@ export default defineConfig({
       },
     })
 
-    await newBuilder(siteConfig)
+    await newBuilder(siteConfig as never)
   },
 })
diff --git a/docs/.vitepress/theme/index.ts b/docs/.vitepress/theme/index.ts
@@ -1,5 +1,3 @@
-import type { Plugin } from 'vue'
-
 import TwoslashFloatingVue from '@shikijs/vitepress-twoslash/client'
 
 import { NuLazyTeleportRiveCanvas } from '@nolebase/ui-rive-canvas'
@@ -41,12 +39,14 @@ export default defineThemeUnconfig({
     },
   },
   enhanceApp: ({ app }) => {
+    const usePlugin = app.use as unknown as (plugin: unknown, ...options: unknown[]) => void
+
     app.component('IntegrationCard', IntegrationCard)
     app.component('HomeContent', HomeContent)
     app.component('ThumbhashPreview', ThumbhashPreview)
 
-    app.use(TwoslashFloatingVue as Plugin)
-    app.use(MotionPlugin as Plugin)
+    usePlugin(TwoslashFloatingVue)
+    usePlugin(MotionPlugin)
   },
   pluginPresets: [
     NolebasePluginPreset({
diff --git a/docs/.vitepress/twoslashConfig.ts b/docs/.vitepress/twoslashConfig.ts
@@ -7,6 +7,7 @@ export const compilerOptions = {
     target: 99,
     module: 99,
     moduleResolution: 100,
+    ignoreDeprecations: '6.0',
     paths: {
       '@nolebase/ui': [
         '../packages/ui/src/index.ts',
diff --git a/docs/tsconfig.json b/docs/tsconfig.json
@@ -1,12 +1,17 @@
 {
   "extends": "../tsconfig.json",
   "compilerOptions": {
+    "types": [
+      "vite/client",
+      "node"
+    ],
     "noImplicitAny": false,
     "declaration": true,
     "noEmit": false
   },
   "include": [
-    "./.vitepress/**/*",
+    ".vitepress/**/*.ts",
+    ".vitepress/**/*.vue",
     "**/*.d.ts"
   ]
 }
diff --git a/eslint.config.ts b/eslint.config.ts
@@ -36,7 +36,7 @@ export default antfu({
           'side-effect',
           'style',
         ],
-        newlinesBetween: 'always',
+        newlinesBetween: 1,
       },
     ],
   },
diff --git a/packages/markdown-it-bi-directional-links/src/index.ts b/packages/markdown-it-bi-directional-links/src/index.ts
@@ -318,7 +318,7 @@ export const BiDirectionalLinks: (options?: BiDirectionalLinksOptions) => Plugin
       // If user would like to see the warning, they can enable debug mode
       // by setting `DEBUG=@nolebase/markdown-it-bi-directional-links` in the environment variable
       // or by setting `import.meta.env.DEBUG = '@nolebase/markdown-it-bi-directional-links'` in the script.
-      if (!biDirectionalLinkPatternWithStart.exec(link.input)) {
+      if (!biDirectionalLinkPatternWithStart.test(link.input)) {
         logIncorrectMatchedMarkupWarning(link.input, src, state.env.path, debugOn)
         return false
       }
diff --git a/packages/ui-asciinema/package.json b/packages/ui-asciinema/package.json
@@ -73,7 +73,7 @@
   "peerDependencies": {
     "asciinema-player": "^3.15.0",
     "vitepress": "catalog:vitepress-all",
-    "vue": "catalog:vue-3"
+    "vue": ">=3"
   },
   "dependencies": {
     "less": "catalog:"
diff --git a/packages/ui-rive-canvas/package.json b/packages/ui-rive-canvas/package.json
@@ -73,7 +73,7 @@
   "peerDependencies": {
     "@rive-app/canvas": "^2.35.0",
     "vitepress": "catalog:vitepress-all",
-    "vue": "catalog:vue-3"
+    "vue": ">=3"
   },
   "dependencies": {
     "less": "catalog:"
diff --git a/packages/ui/package.json b/packages/ui/package.json
@@ -70,7 +70,7 @@
   },
   "peerDependencies": {
     "vitepress": "catalog:vitepress-all",
-    "vue": "catalog:vue-3"
+    "vue": ">=3"
   },
   "dependencies": {
     "@iconify-json/octicon": "catalog:",
diff --git a/packages/unconfig-vitepress/tsconfig.json b/packages/unconfig-vitepress/tsconfig.json
@@ -5,8 +5,8 @@
       "./yaml.d.ts",
       "node",
       "vite/client",
-      "@nolebase/vitepress-plugin-git-changelog/types/virtual.d.ts",
-      "@nolebase/vitepress-plugin-page-properties/client/virtual.d.ts"
+      "../vitepress-plugin-git-changelog/src/types/virtual.d.ts",
+      "../vitepress-plugin-page-properties/src/client/virtual.d.ts"
     ],
     "noImplicitAny": false,
     "declaration": true,
diff --git a/packages/vitepress-plugin-enhanced-readabilities/build.config.ts b/packages/vitepress-plugin-enhanced-readabilities/build.config.ts
@@ -49,7 +49,7 @@ export default defineBuildConfig({
       //
       // The use of CLI was suggested by how to use unocss with rollup? · unocss/unocss · Discussion #542
       // https:// github.com/unocss/unocss/discussions/542
-      await execAsync('unocss -c "../uno.config.ts" -o "./dist/client/unocss.css" "./src/client/**/*.vue"')
+      await execAsync('unocss -c "../../uno.config.ts" -o "./dist/client/unocss.css" "./src/client/**/*.vue"')
     },
   },
 })
diff --git a/packages/vitepress-plugin-enhanced-readabilities/src/client/index.ts b/packages/vitepress-plugin-enhanced-readabilities/src/client/index.ts
@@ -55,7 +55,7 @@ const components = {
   NolebaseEnhancedReadabilitiesScreenSpotlight: ScreenSpotlight,
 }
 
-export const NolebaseEnhancedReadabilitiesPlugin: Plugin<Options[]> = {
+export const NolebaseEnhancedReadabilitiesPlugin: Plugin<Options[], Options[]> = {
   install(app, options?) {
     if (typeof options !== 'undefined' && typeof options === 'object')
       app.provide(InjectionKey, options)
diff --git a/packages/vitepress-plugin-git-changelog/src/client/components/Changelog.vue b/packages/vitepress-plugin-git-changelog/src/client/components/Changelog.vue
@@ -21,6 +21,7 @@ const options = defu(inject(InjectionKey, {}), defaultOptions)
 const { t } = useI18n()
 const { lang } = useData()
 const { commits, useHmr } = useChangelog()
+const currentLang = computed(() => lang.value)
 
 // The order of commits, defaults to true (descending order)
 const isDescending = ref(true)
@@ -90,12 +91,12 @@ onMounted(() => {
           <span v-if="commits[0]">
             {{ t('lastEdited', {
               props: {
-                daysAgo: formatDistanceToNowFromValue(lastChangeDate, locale.changelog?.lastEditedDateFnsLocaleName || lang || 'enUS'),
+                daysAgo: formatDistanceToNowFromValue(lastChangeDate, locale.changelog?.lastEditedDateFnsLocaleName || currentLang || 'enUS'),
               },
               omitEmpty: true,
             }) || t('changelog.lastEdited', {
               props: {
-                daysAgo: formatDistanceToNowFromValue(lastChangeDate, locale.changelog?.lastEditedDateFnsLocaleName || lang || 'enUS'),
+                daysAgo: formatDistanceToNowFromValue(lastChangeDate, locale.changelog?.lastEditedDateFnsLocaleName || currentLang || 'enUS'),
               },
             }) }}
           </span>
diff --git a/packages/vitepress-plugin-git-changelog/src/client/components/Contributors.vue b/packages/vitepress-plugin-git-changelog/src/client/components/Contributors.vue
@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { defu } from 'defu'
 import { useData } from 'vitepress'
-import { inject, onMounted } from 'vue'
+import { computed, inject, onMounted } from 'vue'
 
 import { useChangelog } from '../composables/changelog'
 import { useI18n } from '../composables/i18n'
@@ -13,6 +13,7 @@ const { t } = useI18n()
 const { authors, useHmr } = useChangelog()
 
 const { lang } = useData()
+const currentLang = computed(() => lang.value)
 
 onMounted(() => {
   useHmr()
@@ -49,14 +50,14 @@ onMounted(() => {
           class="no-icon flex items-center gap-2"
         >
           <img :src="c.avatarUrl" :alt="`The avatar of contributor named as ${c.name}`" class="h-8 w-8 rounded-full">
-          {{ c.i18n ? c.i18n[lang] ?? c.name : c.name }}
+          {{ c.i18n ? c.i18n[currentLang] ?? c.name : c.name }}
         </a>
         <div
           v-else
           class="flex items-center gap-2"
         >
           <img :src="c.avatarUrl" :alt="`The avatar of contributor named as ${c.name}`" class="h-8 w-8 rounded-full">
-          {{ c.i18n ? c.i18n[lang] ?? c.name : c.name }}
+          {{ c.i18n ? c.i18n[currentLang] ?? c.name : c.name }}
         </div>
       </template>
     </template>
diff --git a/packages/vitepress-plugin-git-changelog/src/client/index.ts b/packages/vitepress-plugin-git-changelog/src/client/index.ts
@@ -18,7 +18,7 @@ const components = {
 
 export * from './composables'
 
-export const NolebaseGitChangelogPlugin: Plugin<Options[]> = {
+export const NolebaseGitChangelogPlugin: Plugin<Options[], Options[]> = {
   install(app, options?) {
     if (typeof options !== 'undefined' && typeof options === 'object')
       app.provide(InjectionKey, options)
diff --git a/packages/vitepress-plugin-highlight-targeted-heading/build.config.ts b/packages/vitepress-plugin-highlight-targeted-heading/build.config.ts
@@ -31,7 +31,7 @@ export default defineBuildConfig({
       //
       // The use of CLI was suggested by how to use unocss with rollup? · unocss/unocss · Discussion #542
       // https:// github.com/unocss/unocss/discussions/542
-      await execAsync('unocss -c "../uno.config.ts" -o "./dist/client/unocss.css" "./src/client/**/*.vue"')
+      await execAsync('unocss -c "../../uno.config.ts" -o "./dist/client/unocss.css" "./src/client/**/*.vue"')
     },
   },
 })
diff --git a/packages/vitepress-plugin-highlight-targeted-heading/src/client/index.ts b/packages/vitepress-plugin-highlight-targeted-heading/src/client/index.ts
@@ -10,7 +10,7 @@ const components = {
   NolebaseHighlightTargetedHeading,
 }
 
-export const NolebaseNolebaseHighlightTargetedHeadingPlugin: Plugin = {
+export const NolebaseNolebaseHighlightTargetedHeadingPlugin: Plugin<any[], any[]> = {
   install(app) {
     for (const key of Object.keys(components))
       app.component(key, components[key as keyof typeof components])
diff --git a/packages/vitepress-plugin-index/build.config.ts b/packages/vitepress-plugin-index/build.config.ts
@@ -50,7 +50,7 @@ export default defineBuildConfig({
       //
       // The use of CLI was suggested by how to use unocss with rollup? · unocss/unocss · Discussion #542
       // https:// github.com/unocss/unocss/discussions/542
-      await execAsync('unocss -c "../uno.config.ts" -o "./dist/client/unocss.css" "./src/client/**/*.vue"')
+      await execAsync('unocss -c "../../uno.config.ts" -o "./dist/client/unocss.css" "./src/client/**/*.vue"')
     },
   },
 })
diff --git a/packages/vitepress-plugin-index/src/client/index.ts b/packages/vitepress-plugin-index/src/client/index.ts
@@ -14,7 +14,7 @@ const components = {
   NolebaseRecentUpdates,
 }
 
-export const NolebaseIndexPlugin: Plugin<Options[]> = {
+export const NolebaseIndexPlugin: Plugin<Options[], Options[]> = {
   install(app, options?) {
     if (typeof options !== 'undefined' && typeof options === 'object')
       app.provide(InjectionKey, options)
diff --git a/packages/vitepress-plugin-index/src/vitepress/recentUpdates.ts b/packages/vitepress-plugin-index/src/vitepress/recentUpdates.ts
@@ -153,8 +153,7 @@ export async function applyCategoryTextWithFallback(entryItem: FileEntry, frontm
   if (fallbackWithFrontmatter
     && 'category' in frontmatter
     && frontmatter.category
-    && typeof frontmatter.category === 'string'
-  ) {
+    && typeof frontmatter.category === 'string') {
     return (frontmatter as { category?: string }).category ?? ''
   }
 
diff --git a/packages/vitepress-plugin-inline-link-preview/build.config.ts b/packages/vitepress-plugin-inline-link-preview/build.config.ts
@@ -54,7 +54,7 @@ export default defineBuildConfig({
       //
       // The use of CLI was suggested by how to use unocss with rollup? · unocss/unocss · Discussion #542
       // https:// github.com/unocss/unocss/discussions/542
-      await execAsync('unocss -c "../uno.config.ts" -o "./dist/client/unocss.css" "./src/client/**/*.vue"')
+      await execAsync('unocss -c "../../uno.config.ts" -o "./dist/client/unocss.css" "./src/client/**/*.vue"')
     },
   },
 })
diff --git a/packages/vitepress-plugin-inline-link-preview/src/client/index.ts b/packages/vitepress-plugin-inline-link-preview/src/client/index.ts
@@ -21,7 +21,7 @@ const components = {
   VPNolebaseInlineLinkPreview: InlineLinkPreview,
 }
 
-export const NolebaseInlineLinkPreviewPlugin: Plugin<Options[]> = {
+export const NolebaseInlineLinkPreviewPlugin: Plugin<Options[], Options[]> = {
   install(app, options?) {
     if (typeof options !== 'undefined' && typeof options === 'object')
       app.provide(InjectionKey, options)
diff --git a/packages/vitepress-plugin-og-image/src/vitepress/options.ts b/packages/vitepress-plugin-og-image/src/vitepress/options.ts
@@ -111,8 +111,7 @@ export async function applyCategoryTextWithFallback(pageItem: PageItem, category
   if (fallbackWithFrontmatter
     && 'category' in pageItem.frontmatter
     && pageItem.frontmatter.category
-    && typeof pageItem.frontmatter.category === 'string'
-  ) {
+    && typeof pageItem.frontmatter.category === 'string') {
     return (pageItem.frontmatter as { category?: string }).category ?? ''
   }
 
diff --git a/packages/vitepress-plugin-page-properties/src/client/composables/data.ts b/packages/vitepress-plugin-page-properties/src/client/composables/data.ts
@@ -1,5 +1,4 @@
 import type { PageData } from 'vitepress'
-import type { ComputedRef, Ref } from 'vue'
 
 import VirtualPagePropertiesData from 'virtual:nolebase-page-properties'
 
@@ -14,6 +13,14 @@ type AggregatedPageProperties = Array<{
   omitEmpty: boolean
 }>
 
+interface PageDataRef {
+  value: PageData
+}
+
+interface PagePropertiesRef {
+  value: Property<any>[]
+}
+
 function normalizeProperties(
   frontmatter: Record<string, any>,
   propertyConfig: Property<any>,
@@ -56,7 +63,7 @@ function normalizeProperties(
   return baseResolvedProperties
 }
 
-export function usePageProperties(pageData: Ref<PageData>, userConfiguredPageProperties: ComputedRef<Property<any>[]>) {
+export function usePageProperties(pageData: PageDataRef, userConfiguredPageProperties: PagePropertiesRef) {
   const pagePropertiesData = ref<Data>({ ...VirtualPagePropertiesData })
   if (!pagePropertiesData.value)
     pagePropertiesData.value = { }
diff --git a/packages/vitepress-plugin-page-properties/src/client/index.ts b/packages/vitepress-plugin-page-properties/src/client/index.ts
@@ -27,7 +27,7 @@ const components = {
   NolebasePagePropertiesEditor,
 }
 
-export function NolebasePagePropertiesPlugin<P extends object>(): Plugin<Options<P>[]> {
+export function NolebasePagePropertiesPlugin<P extends object>(): Plugin<Options<P>[], Options<P>[]> {
   return {
     install(app, options?) {
       if (typeof options !== 'undefined' && typeof options === 'object')
diff --git a/packages/vitepress-plugin-sidebar/src/sidebar.ts b/packages/vitepress-plugin-sidebar/src/sidebar.ts
@@ -411,8 +411,8 @@ export function mergeSidebar(
 
   if (skipLevelsConfig) {
     for (const key in sidebarMultiple) {
-      if (Object.prototype.hasOwnProperty.call(sidebarMultiple, key)
-        && Object.prototype.hasOwnProperty.call(skipLevelsConfig, key)) {
+      if (Object.hasOwn(sidebarMultiple, key)
+        && Object.hasOwn(skipLevelsConfig, key)) {
         const levelsToSkip = skipLevelsConfig[key]
         if (levelsToSkip > 0) {
           sidebarMultiple[key] = skipSidebarLevels(sidebarMultiple[key], levelsToSkip)
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
diff --git a/tsconfig.json b/tsconfig.json
diff --git a/vitest.config.ts b/vitest.config.ts

Original file line number	Diff line number	Diff line change
`@@ -1,12 +1,17 @@`
`1`	`1`	`{`
`2`	`2`	`"extends": "../tsconfig.json",`
`3`	`3`	`"compilerOptions": {`
	`4`	`+ "types": [`
	`5`	`+ "vite/client",`
	`6`	`+ "node"`
	`7`	`+ ],`
`4`	`8`	`"noImplicitAny": false,`
`5`	`9`	`"declaration": true,`
`6`	`10`	`"noEmit": false`
`7`	`11`	`},`
`8`	`12`	`"include": [`
`9`		`- "./.vitepress/*/",`
	`13`	`+ ".vitepress/*/.ts",`
	`14`	`+ ".vitepress/*/.vue",`
`10`	`15`	`"*/.d.ts"`
`11`	`16`	`]`
`12`	`17`	`}`
Original file line number	Diff line number	Diff line change
`@@ -318,7 +318,7 @@ export const BiDirectionalLinks: (options?: BiDirectionalLinksOptions) => Plugin`
`318`	`318`	`// If user would like to see the warning, they can enable debug mode`
`319`	`319`	// by setting `DEBUG=@nolebase/markdown-it-bi-directional-links` in the environment variable
`320`	`320`	// or by setting `import.meta.env.DEBUG = '@nolebase/markdown-it-bi-directional-links'` in the script.
`321`		`- if (!biDirectionalLinkPatternWithStart.exec(link.input)) {`
	`321`	`+ if (!biDirectionalLinkPatternWithStart.test(link.input)) {`
`322`	`322`	`logIncorrectMatchedMarkupWarning(link.input, src, state.env.path, debugOn)`
`323`	`323`	`return false`
`324`	`324`	`}`