valaxy 1.3.3 → 1.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,7 +2,7 @@
2
2
  // https://router.vuejs.org/guide/advanced/extending-router-link.html#extending-routerlink
3
3
  import { computed } from 'vue'
4
4
  import { RouterLink } from 'vue-router'
5
- import { EXTERNAL_URL_RE } from '../../shared'
5
+ import { EXTERNAL_URL_RE, sanitizeUrl } from '../../shared'
6
6
 
7
7
  defineOptions({
8
8
  inheritAttrs: false,
@@ -15,7 +15,7 @@ const props = defineProps<{
15
15
  target?: string
16
16
  }>()
17
17
 
18
- const link = computed(() => props.href || props.to || '#')
18
+ const link = computed(() => sanitizeUrl(props.href || props.to))
19
19
 
20
20
  const isExternalLink = computed(() => {
21
21
  return (link.value && EXTERNAL_URL_RE.test(link.value)) || props.target === '_blank'
@@ -1,7 +1,6 @@
1
1
  <script lang="ts" setup>
2
- import { isClient } from '@vueuse/core'
3
2
  import { runContentUpdated, useDecrypt, useFrontmatter } from 'valaxy'
4
- import { computed, ref } from 'vue'
3
+ import { onMounted, ref } from 'vue'
5
4
 
6
5
  const props = withDefaults(defineProps<{
7
6
  encryptedContent: string
@@ -40,7 +39,10 @@ function encryptAgain() {
40
39
  }, 16)
41
40
  }
42
41
 
43
- const hasWarning = computed(() => isClient && location.protocol !== 'https:')
42
+ const hasWarning = ref(false)
43
+ onMounted(() => {
44
+ hasWarning.value = window.location.protocol !== 'https:'
45
+ })
44
46
  </script>
45
47
 
46
48
  <template>
@@ -1,6 +1,6 @@
1
1
  <script lang="ts" setup>
2
2
  import type { Post } from 'valaxy'
3
- import { onContentUpdated, runContentUpdated, setIframeAspectRatios, useCodePen, useCollapseCode, useCopyCode, useMediumZoom, wrapTable } from 'valaxy'
3
+ import { onContentUpdated, runContentUpdated, sanitizeUrl, setIframeAspectRatios, useCodePen, useCollapseCode, useCopyCode, useMediumZoom, wrapTable } from 'valaxy'
4
4
  import { onMounted, onUpdated, ref } from 'vue'
5
5
  import { useI18n } from 'vue-i18n'
6
6
  import { useCodeGroups } from '../composables/codeGroups'
@@ -51,8 +51,7 @@ useVanillaLazyLoad()
51
51
 
52
52
  <div v-if="frontmatter.url" text="center">
53
53
  <a
54
-
55
- :href="frontmatter.url"
54
+ :href="sanitizeUrl(frontmatter.url)"
56
55
  class="post-link-btn shadow hover:shadow-md"
57
56
  rounded
58
57
  target="_blank"
@@ -5,12 +5,14 @@ import pkg from '../../../package.json' with { type: 'json' }
5
5
  import { useFrontmatter, useValaxyI18n } from '../../composables'
6
6
  import { useSiteConfig } from '../../config'
7
7
  import { withBase } from '../../utils'
8
+ import { useLayout } from '../../utils/layouts'
8
9
  import { usePageSeo } from './usePageSeo'
9
10
 
10
11
  export function useValaxyHead() {
11
12
  const { $t, $tO, locale } = useValaxyI18n()
12
13
 
13
14
  const fm = useFrontmatter()
15
+ const layout = useLayout()
14
16
  const siteConfig = useSiteConfig()
15
17
  const { description, pageUrl } = usePageSeo()
16
18
  const $title = computed(() => $tO(fm.value.title))
@@ -52,9 +54,15 @@ export function useValaxyHead() {
52
54
  },
53
55
  })
54
56
 
55
- useHead(computed(() => canonicalUrl.value
56
- ? { link: [{ rel: 'canonical', href: canonicalUrl.value }] }
57
- : {}))
57
+ useHead(computed(() => {
58
+ // YAML frontmatter can supply the layout name as a number.
59
+ if (String(layout.value) === '404')
60
+ return { meta: [{ name: 'robots', content: 'noindex' }] }
61
+
62
+ return canonicalUrl.value
63
+ ? { link: [{ rel: 'canonical', href: canonicalUrl.value }] }
64
+ : {}
65
+ }))
58
66
 
59
67
  // Add mac detection class on client side only, after hydration
60
68
  // to avoid SSR/client mismatch on the <html> element
@@ -1,50 +1,76 @@
1
1
  // ref vitepress copyCode.ts
2
2
  import { isClient } from '@vueuse/core'
3
+ import { getCurrentScope, onScopeDispose } from 'vue'
4
+
5
+ const timeoutIdMap: WeakMap<HTMLElement, ReturnType<typeof setTimeout>> = new WeakMap()
6
+ let activeCopyCodeListeners = 0
7
+
8
+ function handleCopyClick(e: MouseEvent) {
9
+ const el = e.target
10
+ if (!(el instanceof Element) || !el.matches('div[class*="language-"] > button.copy'))
11
+ return
12
+
13
+ const parent = el.parentElement
14
+ const sibling = el.nextElementSibling?.nextElementSibling
15
+ if (!parent || !sibling)
16
+ return
17
+
18
+ // eslint-disable-next-line regexp/no-unused-capturing-group
19
+ const isShell = /language-(shellscript|shell|bash|sh|zsh)/.test(
20
+ parent.className,
21
+ )
22
+
23
+ let text = ''
24
+
25
+ sibling
26
+ .querySelectorAll('span.line:not(.diff.remove)')
27
+ .forEach(node => (text += `${node.textContent || ''}\n`))
28
+ text = text.slice(0, -1)
29
+
30
+ if (isShell)
31
+ text = text.replace(/^ *(\$|>) /gm, '').trim()
32
+
33
+ copyToClipboard(text)
34
+ .then(() => {
35
+ el.classList.add('copied')
36
+ clearTimeout(timeoutIdMap.get(el as HTMLElement))
37
+ const timeoutId = setTimeout(() => {
38
+ el.classList.remove('copied')
39
+ ;(el as HTMLElement).blur?.()
40
+ timeoutIdMap.delete(el as HTMLElement)
41
+ }, 2000)
42
+ timeoutIdMap.set(el as HTMLElement, timeoutId)
43
+ })
44
+ .catch(() => {})
45
+ }
3
46
 
4
47
  export function useCopyCode() {
5
- if (isClient) {
6
- const timeoutIdMap: WeakMap<HTMLElement, ReturnType<typeof setTimeout>> = new WeakMap()
7
- window.addEventListener('click', (e) => {
8
- const el = e.target as HTMLElement
9
- if (el.matches('div[class*="language-"] > button.copy')) {
10
- const parent = el.parentElement
11
- const sibling = el.nextElementSibling?.nextElementSibling
12
- if (!parent || !sibling)
13
- return
14
-
15
- // eslint-disable-next-line regexp/no-unused-capturing-group
16
- const isShell = /language-(shellscript|shell|bash|sh|zsh)/.test(
17
- parent.className,
18
- )
19
-
20
- let text = ''
21
-
22
- sibling
23
- .querySelectorAll('span.line:not(.diff.remove)')
24
- .forEach(node => (text += `${node.textContent || ''}\n`))
25
- text = text.slice(0, -1)
26
-
27
- if (isShell)
28
- text = text.replace(/^ *(\$|>) /gm, '').trim()
29
-
30
- copyToClipboard(text).then(() => {
31
- el.classList.add('copied')
32
- clearTimeout(timeoutIdMap.get(el))
33
- const timeoutId = setTimeout(() => {
34
- el.classList.remove('copied')
35
- el.blur()
36
- timeoutIdMap.delete(el)
37
- }, 2000)
38
- timeoutIdMap.set(el, timeoutId)
39
- })
40
- }
41
- })
48
+ if (!isClient)
49
+ return () => {}
50
+
51
+ if (activeCopyCodeListeners === 0)
52
+ window.addEventListener('click', handleCopyClick)
53
+ activeCopyCodeListeners++
54
+
55
+ let disposed = false
56
+ const cleanup = () => {
57
+ if (disposed)
58
+ return
59
+ disposed = true
60
+ activeCopyCodeListeners = Math.max(0, activeCopyCodeListeners - 1)
61
+ if (activeCopyCodeListeners === 0)
62
+ window.removeEventListener('click', handleCopyClick)
42
63
  }
64
+
65
+ if (getCurrentScope())
66
+ onScopeDispose(cleanup)
67
+
68
+ return cleanup
43
69
  }
44
70
 
45
71
  async function copyToClipboard(text: string) {
46
72
  try {
47
- return navigator.clipboard.writeText(text)
73
+ return await navigator.clipboard.writeText(text)
48
74
  }
49
75
  catch {
50
76
  const element = document.createElement('textarea')
@@ -1,6 +1,7 @@
1
1
  import { isClient, useClipboard } from '@vueuse/core'
2
2
  import { computed, ref, watchEffect } from 'vue'
3
3
  import { useRoute } from 'vue-router'
4
+ import { urlPathToMarkdownPath } from '../../../shared/utils/uri'
4
5
  import { useSiteConfig } from '../../config'
5
6
 
6
7
  /**
@@ -34,12 +35,7 @@ export function useCopyMarkdown() {
34
35
  const error = ref<string | null>(null)
35
36
  const { copy: copyToClipboard } = useClipboard({ legacy: true })
36
37
 
37
- const mdUrl = computed(() => {
38
- const p = route.path !== '/' && route.path.endsWith('/')
39
- ? route.path.slice(0, -1)
40
- : route.path
41
- return `${p}.md`
42
- })
38
+ const mdUrl = computed(() => urlPathToMarkdownPath(route.path).href)
43
39
 
44
40
  // Only probe when raw Markdown output is enabled.
45
41
  if (isClient) {
@@ -5,6 +5,17 @@ import { useFuse } from '@vueuse/integrations/useFuse'
5
5
  import { computed, shallowRef } from 'vue'
6
6
  import { useSiteConfig } from '../../config'
7
7
 
8
+ const fuseDataCache = new Map<string, FuseListItem[]>()
9
+ const fuseInFlight = new Map<string, Promise<FuseListItem[]>>()
10
+
11
+ /**
12
+ * Clear module-scoped Fuse search caches (intended for tests or cache invalidation).
13
+ */
14
+ export function clearFuseSearchCache() {
15
+ fuseDataCache.clear()
16
+ fuseInFlight.clear()
17
+ }
18
+
8
19
  export function useFuseSearch<T extends FuseListItem = FuseListItem>(
9
20
  search: MaybeRefOrGetter<string>,
10
21
  options?: MaybeRefOrGetter<UseFuseOptions<T>>,
@@ -12,6 +23,7 @@ export function useFuseSearch<T extends FuseListItem = FuseListItem>(
12
23
  const siteConfig = useSiteConfig()
13
24
 
14
25
  const fuseListData = shallowRef<T[]>([])
26
+ let latestRequestId = 0
15
27
 
16
28
  const keys = computed(() => {
17
29
  const ks = siteConfig.value.fuse.options.keys || []
@@ -45,11 +57,33 @@ export function useFuseSearch<T extends FuseListItem = FuseListItem>(
45
57
  ? siteConfig.value.fuse.dataPath
46
58
  : `${import.meta.env.BASE_URL}${siteConfig.value.fuse.dataPath}`)
47
59
 
48
- const res = await fetch(fuseListDataPath)
49
- const data = await res.json()
60
+ const requestId = ++latestRequestId
61
+
62
+ const cached = fuseDataCache.get(fuseListDataPath)
63
+ if (cached) {
64
+ fuseListData.value = cached as T[]
65
+ return
66
+ }
67
+
68
+ let pending = fuseInFlight.get(fuseListDataPath)
69
+ if (!pending) {
70
+ pending = (async () => {
71
+ const res = await fetch(fuseListDataPath)
72
+ if (!res.ok)
73
+ throw new Error(`Failed to fetch fuse list data (${res.status}): ${fuseListDataPath}`)
74
+ const data = await res.json()
75
+ const items = Array.isArray(data) ? data : []
76
+ fuseDataCache.set(fuseListDataPath, items)
77
+ return items
78
+ })().finally(() => {
79
+ fuseInFlight.delete(fuseListDataPath)
80
+ })
81
+ fuseInFlight.set(fuseListDataPath, pending)
82
+ }
50
83
 
51
- if (Array.isArray(data))
52
- fuseListData.value = data
84
+ const data = await pending
85
+ if (requestId === latestRequestId)
86
+ fuseListData.value = data as T[]
53
87
  }
54
88
 
55
89
  return {
@@ -10,30 +10,64 @@ export interface LocalSearchResult {
10
10
  titles: string[]
11
11
  }
12
12
 
13
+ const localSearchCache = new Map<string, MiniSearch>()
14
+ const localSearchInFlight = new Map<string, Promise<MiniSearch | null>>()
15
+
16
+ /**
17
+ * Clear module-scoped local search caches (intended for tests or index invalidation).
18
+ */
19
+ export function clearLocalSearchCache() {
20
+ localSearchCache.clear()
21
+ localSearchInFlight.clear()
22
+ }
23
+
13
24
  export function useLocalSearch(query: Ref<string>) {
14
25
  const results = shallowRef<LocalSearchResult[]>([])
15
26
  const loading = ref(false)
16
27
  const miniSearch = shallowRef<MiniSearch | null>(null)
28
+ let latestRequestId = 0
17
29
 
18
30
  async function load(locale = 'root') {
31
+ const requestId = ++latestRequestId
32
+
33
+ const cached = localSearchCache.get(locale)
34
+ if (cached) {
35
+ miniSearch.value = cached
36
+ loading.value = false
37
+ return
38
+ }
39
+
19
40
  loading.value = true
20
41
  try {
21
- const searchIndex = (await import('@localSearchIndex')).default
22
- const loader = searchIndex[locale] ?? searchIndex[Object.keys(searchIndex)[0]]
23
- if (!loader) {
24
- loading.value = false
25
- return
42
+ let pending = localSearchInFlight.get(locale)
43
+ if (!pending) {
44
+ pending = (async () => {
45
+ const searchIndex = (await import('@localSearchIndex')).default
46
+ const loader = searchIndex[locale] ?? searchIndex[Object.keys(searchIndex)[0]]
47
+ if (!loader)
48
+ return null
49
+ const mod = await loader()
50
+ const data: string = mod.default
51
+ const { default: MiniSearchCtor } = await import('minisearch')
52
+ const instance = MiniSearchCtor.loadJSON(data, {
53
+ fields: ['title', 'titles', 'text'],
54
+ storeFields: ['title', 'titles'],
55
+ })
56
+ localSearchCache.set(locale, instance)
57
+ return instance
58
+ })().finally(() => {
59
+ localSearchInFlight.delete(locale)
60
+ })
61
+ localSearchInFlight.set(locale, pending)
26
62
  }
27
- const mod = await loader()
28
- const data: string = mod.default
29
- const { default: MiniSearchCtor } = await import('minisearch')
30
- miniSearch.value = MiniSearchCtor.loadJSON(data, {
31
- fields: ['title', 'titles', 'text'],
32
- storeFields: ['title', 'titles'],
33
- })
63
+
64
+ const instance = await pending
65
+ if (requestId === latestRequestId)
66
+ miniSearch.value = instance
34
67
  }
35
68
  finally {
36
- loading.value = false
69
+ if (requestId === latestRequestId)
70
+ loading.value = false
37
71
  }
38
72
  }
39
73
 
@@ -64,48 +64,94 @@ export function scrollTo(el: HTMLElement, hash: string, options: Partial<ScrollT
64
64
  }
65
65
  }
66
66
 
67
+ interface ClickHandlerEntry {
68
+ refCount: number
69
+ detach: () => void
70
+ }
71
+
72
+ const activeClickHandlers = new WeakMap<Router, ClickHandlerEntry>()
73
+
74
+ function safeDecodeHash(hash: string): string {
75
+ try {
76
+ return decodeURIComponent(hash)
77
+ }
78
+ catch {
79
+ return hash
80
+ }
81
+ }
82
+
67
83
  /**
68
- * @description Intercept click events and handle offset positions for jump links on the same page
69
- * @description:zh-CN 拦截点击事件,处理同一页面下跳转链接的偏移位置
84
+ * @description Intercept same-page inbound anchor clicks and handle offset positions for jump links on the same page
85
+ * @description:zh-CN 拦截点击事件,处理同一页面下跳转链接的偏移位置(按 router 实例引用计数共享监听,并返回独立的幂等清理函数)
70
86
  * @param router Vue Router
71
87
  */
72
- export function onClickHref(router: Router) {
73
- // to extract
74
- // click title scroll
75
- window.addEventListener(
76
- 'click',
77
- async (e) => {
78
- const link = (e.target as Element).closest('a')
79
- if (link) {
80
- const { protocol, hostname, pathname, hash, target } = link
81
- const currentUrl = window.location
82
- const extMatch = pathname.match(/\.\w+$/)
83
- // only intercept inbound links
84
- if (
85
- !e.ctrlKey
86
- && !e.shiftKey
87
- && !e.altKey
88
- && !e.metaKey
89
- && target !== '_blank'
90
- && protocol === currentUrl.protocol
91
- && hostname === currentUrl.hostname
92
- && !(extMatch && extMatch[0] !== '.html')
93
- ) {
94
- if (pathname === currentUrl.pathname) {
95
- e.preventDefault()
96
- // scroll between hash anchors in the same page
97
- if (hash && hash !== currentUrl.hash) {
98
- await router.push({ hash: decodeURIComponent(hash) })
88
+ export function onClickHref(router: Router): () => void {
89
+ if (typeof window === 'undefined')
90
+ return () => {}
91
+
92
+ let entry = activeClickHandlers.get(router)
93
+ if (!entry) {
94
+ const handleClick = async (e: MouseEvent) => {
95
+ const targetEl = e.target instanceof Element
96
+ ? e.target
97
+ : (e.target as Node | null)?.parentElement
98
+ const link = targetEl?.closest('a')
99
+ if (!link)
100
+ return
99
101
 
100
- // use smooth scroll when clicking on header anchor links
101
- scrollTo(link, hash, {
102
- smooth: link.classList.contains('header-anchor'),
103
- })
104
- }
102
+ const { protocol, hostname, pathname, hash, target } = link
103
+ const currentUrl = window.location
104
+ const extMatch = pathname.match(/\.\w+$/)
105
+ // only intercept inbound links
106
+ if (
107
+ !e.ctrlKey
108
+ && !e.shiftKey
109
+ && !e.altKey
110
+ && !e.metaKey
111
+ && target !== '_blank'
112
+ && protocol === currentUrl.protocol
113
+ && hostname === currentUrl.hostname
114
+ && !(extMatch && extMatch[0] !== '.html')
115
+ ) {
116
+ if (pathname === currentUrl.pathname) {
117
+ e.preventDefault()
118
+ // scroll between hash anchors in the same page
119
+ if (hash && hash !== currentUrl.hash) {
120
+ await router.push({ hash: safeDecodeHash(hash) })
121
+
122
+ // use smooth scroll when clicking on header anchor links
123
+ scrollTo(link, hash, {
124
+ smooth: link.classList.contains('header-anchor'),
125
+ })
105
126
  }
106
127
  }
107
128
  }
108
- },
109
- { capture: true },
110
- )
129
+ }
130
+
131
+ window.addEventListener('click', handleClick, { capture: true })
132
+
133
+ const createdEntry: ClickHandlerEntry = {
134
+ refCount: 0,
135
+ detach: () => {
136
+ window.removeEventListener('click', handleClick, { capture: true })
137
+ if (activeClickHandlers.get(router) === createdEntry)
138
+ activeClickHandlers.delete(router)
139
+ },
140
+ }
141
+ entry = createdEntry
142
+ activeClickHandlers.set(router, entry)
143
+ }
144
+
145
+ const currentEntry = entry
146
+ currentEntry.refCount += 1
147
+ let cleaned = false
148
+
149
+ return () => {
150
+ if (cleaned)
151
+ return
152
+ cleaned = true
153
+ currentEntry.refCount -= 1
154
+ if (currentEntry.refCount <= 0)
155
+ currentEntry.detach()
156
+ }
111
157
  }
@@ -7,7 +7,7 @@ import { LogLevel, InlineConfig, ViteDevServer } from 'vite';
7
7
  declare function execBuild({ ssg, root, output, log, siteUrl }: {
8
8
  ssg: boolean;
9
9
  root: string;
10
- output: string;
10
+ output?: string;
11
11
  log: string;
12
12
  siteUrl?: string;
13
13
  }): Promise<void>;
@@ -2,7 +2,7 @@ import 'node:path';
2
2
  import 'node:process';
3
3
  import 'yargs';
4
4
  import 'yargs/helpers';
5
- export { c as createCli, s as desktopRuntimeVersion, u as execBuild, O as registerDevCommand, a1 as run, a3 as startValaxyDev } from '../../shared/valaxy.aOnvqwjo.mjs';
5
+ export { a as createCli, t as desktopRuntimeVersion, v as execBuild, R as registerDevCommand, a3 as run, a5 as startValaxyDev } from '../../shared/valaxy.DQnMfBEN.mjs';
6
6
  import 'node:os';
7
7
  import '@11ty/gray-matter';
8
8
  import 'consola';
@@ -24,12 +24,15 @@ import 'mlly';
24
24
  import 'resolve-global';
25
25
  import '@valaxyjs/utils';
26
26
  import 'node:fs';
27
+ import 'p-map';
27
28
  import 'picomatch';
28
29
  import 'node:fs/promises';
29
30
  import 'dayjs';
30
31
  import 'feed';
31
32
  import 'markdown-exit';
32
33
  import 'table';
34
+ import 'htmlparser2';
35
+ import 'magic-string';
33
36
  import 'hookable';
34
37
  import '@unhead/bundler/vite';
35
38
  import 'vitepress-plugin-group-icons';
@@ -38,8 +41,6 @@ import 'chokidar';
38
41
  import 'unplugin';
39
42
  import 'unplugin-utils';
40
43
  import 'obug';
41
- import 'magic-string';
42
- import 'p-map';
43
44
  import 'pascalcase';
44
45
  import '@intlify/unplugin-vue-i18n/vite';
45
46
  import 'minisearch';
@@ -53,7 +54,6 @@ import 'markdown-it-emoji';
53
54
  import 'markdown-it-footnote';
54
55
  import 'markdown-it-image-figures';
55
56
  import 'markdown-it-task-lists';
56
- import 'node:url';
57
57
  import 'markdown-it-container';
58
58
  import 'katex';
59
59
  import 'katex/contrib/mhchem';
@@ -62,8 +62,8 @@ import 'jiti';
62
62
  import 'unocss';
63
63
  import 'html-to-text';
64
64
  import 'vue-router/vite';
65
+ import 'node:url';
65
66
  import '@unhead/vue/server';
66
- import 'htmlparser2';
67
67
  import 'escape-html';
68
68
  import 'vue-router/unplugin';
69
69
  import 'node:child_process';
@@ -908,6 +908,18 @@ interface ResolvedValaxyOptions<ThemeConfig = DefaultTheme.Config> {
908
908
  * @default process.cwd()
909
909
  */
910
910
  userRoot: string;
911
+ /**
912
+ * Build output directory (resolved during build)
913
+ */
914
+ outDir?: string;
915
+ /**
916
+ * Public static asset directory (resolved during build/dev)
917
+ */
918
+ publicDir?: string | false;
919
+ /**
920
+ * Resolved Vite base URL
921
+ */
922
+ base?: string;
911
923
  /**
912
924
  * Theme root path
913
925
  */
@@ -1103,8 +1115,8 @@ interface ValaxyExtendConfig {
1103
1115
  */
1104
1116
  fullText: boolean;
1105
1117
  /**
1106
- * @zh 从构建后的 HTML 中提取图片路径(用于解析 Vite 打包后的 hash 文件名)
1107
- * @en Extract image paths from built HTML files (to resolve Vite hashed filenames)
1118
+ * @zh 使用构建产物中的图片 URL,兼容从旧版构建 HTML 中提取路径
1119
+ * @en Use emitted image URLs, falling back to rendered HTML for older builds
1108
1120
  * @default true
1109
1121
  */
1110
1122
  extractImagePathsFromHTML: boolean;
@@ -1362,10 +1374,10 @@ declare function postProcessForSSG(options: ResolvedValaxyOptions): Promise<void
1362
1374
  declare function generateClientRedirects(options: ResolvedValaxyOptions): Promise<void>;
1363
1375
 
1364
1376
  /**
1365
- * merge vite.config.ts (user & theme)
1377
+ * merge vite.config.* (theme & user, plus any required explicit config file)
1366
1378
  * @internal
1367
1379
  */
1368
- declare function mergeViteConfigs({ userRoot, themeRoot }: ResolvedValaxyOptions, command: 'serve' | 'build'): Promise<InlineConfig>;
1380
+ declare function mergeViteConfigs({ userRoot, themeRoot }: ResolvedValaxyOptions, command: 'serve' | 'build', mode?: string, extraFiles?: string[], isSsrBuild?: boolean, configLoader?: InlineConfig['configLoader'], logLevel?: InlineConfig['logLevel'], customLogger?: InlineConfig['customLogger']): Promise<InlineConfig>;
1369
1381
  /**
1370
1382
  * generate index.html from user/theme/client
1371
1383
  * @internal
@@ -1599,8 +1611,12 @@ declare function encryptContent(content: string, options: {
1599
1611
  salt: Uint8Array;
1600
1612
  }): Promise<string>;
1601
1613
 
1614
+ /** Return a pipeline-scoped Git timestamp cache keyed by an options/app object. */
1615
+ declare function getGitTimestampCache(scope: object): Map<string, Promise<number>>;
1616
+ /** Clear cached Git timestamps for a specific file or all files in a pipeline cache. */
1617
+ declare function clearGitTimestampCache(cache: Map<string, Promise<number>>, file?: string): void;
1602
1618
  /** Read commit timestamps from the file's repository, following renames. */
1603
- declare function getGitTimestamp(file: string, type?: 'created' | 'updated'): Promise<number>;
1619
+ declare function getGitTimestamp(file: string, type?: 'created' | 'updated', cache?: Map<string, Promise<number>>): Promise<number>;
1604
1620
 
1605
1621
  /**
1606
1622
  * is url external (http/https:)
@@ -1639,5 +1655,5 @@ declare function toAtFS(path: string): string;
1639
1655
  declare function resolveImportPath(importName: string, ensure?: true): Promise<string>;
1640
1656
  declare function resolveImportPath(importName: string, ensure?: boolean): Promise<string | undefined>;
1641
1657
 
1642
- export { $t, ALL_ROUTE, EXCERPT_SEPARATOR, GLOBAL_STATE, PATHNAME_PROTOCOL_RE, StateManager, ViteValaxyPlugins, build, createContentService, createMemoryReleasePlugin, createServer, createValaxyNode, createValaxyPlugin, customElements, defaultSiteConfig, defaultValaxyConfig, defaultViteConfig, defineAddon, defineConfig, defineContentLoader, defineSiteConfig, defineTheme, defineUnoSetup, defineValaxyAddon, defineValaxyConfig, defineValaxyTheme, encryptContent, generateClientRedirects, getGitTimestamp, getIndexHtml, getServerInfoText, isExternal, isInstalledGlobally, isKatexEnabled, isKatexPluginNeeded, isMathJaxEnabled, isPath, loadAllContent, loadConfigFromFile, mergeValaxyConfig, mergeViteConfigs, postProcessForSSG, processValaxyOptions, resolveAddonsConfig, resolveImportPath, resolveImportUrl, resolveOptions, resolveSiteConfig, resolveSiteConfigFromRoot, resolveThemeConfigFromRoot, resolveThemeValaxyConfig, resolveUserThemeConfig, resolveValaxyConfig, resolveValaxyConfigFromRoot, ssgBuild, toAtFS, transformObject, version };
1658
+ export { $t, ALL_ROUTE, EXCERPT_SEPARATOR, GLOBAL_STATE, PATHNAME_PROTOCOL_RE, StateManager, ViteValaxyPlugins, build, clearGitTimestampCache, createContentService, createMemoryReleasePlugin, createServer, createValaxyNode, createValaxyPlugin, customElements, defaultSiteConfig, defaultValaxyConfig, defaultViteConfig, defineAddon, defineConfig, defineContentLoader, defineSiteConfig, defineTheme, defineUnoSetup, defineValaxyAddon, defineValaxyConfig, defineValaxyTheme, encryptContent, generateClientRedirects, getGitTimestamp, getGitTimestampCache, getIndexHtml, getServerInfoText, isExternal, isInstalledGlobally, isKatexEnabled, isKatexPluginNeeded, isMathJaxEnabled, isPath, loadAllContent, loadConfigFromFile, mergeValaxyConfig, mergeViteConfigs, postProcessForSSG, processValaxyOptions, resolveAddonsConfig, resolveImportPath, resolveImportUrl, resolveOptions, resolveSiteConfig, resolveSiteConfigFromRoot, resolveThemeConfigFromRoot, resolveThemeValaxyConfig, resolveUserThemeConfig, resolveValaxyConfig, resolveValaxyConfigFromRoot, ssgBuild, toAtFS, transformObject, version };
1643
1659
  export type { CdnModule, ContentCheckResult, ContentDiagnostic, ContentItem, ContentLoader, ContentLoaderContext, ContentPageInfo, ContentServiceOptions, GroupIconOptions, GroupIconValue, HookResult, LoadConfigFromFileOptions, MarkdownRenderer, MdAfterRenderContext, ResolvedConfig, ResolvedValaxyOptions, UnoSetup, UserInputConfig, UserValaxyNodeConfig, ValaxyAddonCliContext, ValaxyAddonExport, ValaxyAddonExtendCli, ValaxyAddonFn, ValaxyAddonLike, ValaxyAddonResolver, ValaxyAddons, ValaxyApp, ValaxyConfigExport, ValaxyConfigExtendKey, ValaxyConfigFn, ValaxyEntryOptions, ValaxyExtendConfig, ValaxyFileInfo, ValaxyHooks, ValaxyNode, ValaxyNodeAddon, ValaxyNodeConfig, ValaxyPickConfig, ValaxyServerOptions, ValaxyTheme };