methanol 0.0.7 → 0.0.9

package/README.md

@@ -44,6 +44,11 @@ export default () => ({
 	// optional: code highlighting (Starry Night)
 	starryNight: false,
 
+	// optional: site metadata
+	site: {
+		base: '/docs/'
+	},
+
 	// optional: theme sources
 	theme: {
 		sources: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "methanol",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "Static site generator powered by rEFui and MDX",
   "main": "./index.js",
   "type": "module",
@@ -39,6 +39,7 @@
     "refurbish": "^0.1.8",
     "rehype-slug": "^6.0.0",
     "rehype-starry-night": "^2.2.0",
+    "remark-gfm": "^4.0.1",
     "unist-util-visit": "^5.0.0",
     "vite": "^7.3.0",
     "yargs": "^18.0.0"

package/src/assets.js

@@ -27,4 +27,4 @@ const __dirname = dirname(__filename)
 
 export const INJECT_SCRIPT = readFileSync(resolve(__dirname, './virtual-module/inject.js'), 'utf-8')
 export const LOADER_SCRIPT = readFileSync(resolve(__dirname, './virtual-module/loader.js'), 'utf-8')
-export const PAGEFIND_SCRIPT = readFileSync(resolve(__dirname, './virtual-module/pagefind.js'), 'utf-8')
+export const PAGEFIND_LOADER_SCRIPT = readFileSync(resolve(__dirname, './virtual-module/pagefind-loader.js'), 'utf-8')

package/src/build-system.js

@@ -61,12 +61,13 @@ const collectHtmlFiles = async (dir, basePath = '') => {
 }
 
 export const buildHtmlEntries = async () => {
+	await resolveUserViteConfig('build') // Prepare `base`
 	if (state.INTERMEDIATE_DIR) {
 		await rm(state.INTERMEDIATE_DIR, { recursive: true, force: true })
 		await ensureDir(state.INTERMEDIATE_DIR)
 	}
 
-	const logEnabled = state.CURRENT_MODE === 'production' && cli.command === 'build'
+	const logEnabled = state.CURRENT_MODE === 'production' && cli.command === 'build' && !cli.CLI_VERBOSE
 	const stageLogger = createStageLogger(logEnabled)
 	const themeComponentsDir = state.THEME_COMPONENTS_DIR
 	const themeEnv = state.THEME_ENV
@@ -163,6 +164,10 @@ export const buildHtmlEntries = async () => {
 }
 
 export const runViteBuild = async (entry, htmlCache) => {
+	const logEnabled = state.CURRENT_MODE === 'production' && cli.command === 'build' && !cli.CLI_VERBOSE
+	const stageLogger = createStageLogger(logEnabled)
+	const token = stageLogger.start('Building bundle')
+
 	if (state.STATIC_DIR !== false && state.MERGED_ASSETS_DIR) {
 		await preparePublicAssets({
 			themeDir: state.THEME_ASSETS_DIR,
@@ -174,8 +179,9 @@ export const runViteBuild = async (entry, htmlCache) => {
 	const baseConfig = {
 		configFile: false,
 		root: state.PAGES_DIR,
-		base: '/',
+		appType: 'mpa',
 		publicDir: state.STATIC_DIR === false ? false : state.STATIC_DIR,
+		logLevel: cli.CLI_VERBOSE ? 'info' : 'silent',
 		build: {
 			outDir: state.DIST_DIR,
 			emptyOutDir: true,
@@ -197,4 +203,5 @@ export const runViteBuild = async (entry, htmlCache) => {
 	const userConfig = await resolveUserViteConfig('build')
 	const finalConfig = userConfig ? mergeConfig(baseConfig, userConfig) : baseConfig
 	await viteBuild(finalConfig)
+	stageLogger.end(token)
 }

package/src/config.js

@@ -24,9 +24,11 @@ import { resolve, isAbsolute, extname, basename } from 'path'
 import { pathToFileURL } from 'url'
 import { mergeConfig } from 'vite'
 import { cli, state } from './state.js'
+import { logger } from './logger.js'
 import { HTMLRenderer } from './renderer.js'
 import { rewindEnv } from './components.js'
 import { env as createEnv } from './rewind.js'
+import { cached, cachedStr } from './utils.js'
 import defaultTheme from '../themes/default/index.js'
 
 const CONFIG_FILENAMES = [
@@ -79,6 +81,52 @@ const resolveThemePublicDir = (root, value) => {
 	return isAbsolute(value) ? value : resolve(root, value)
 }
 
+let devBaseWarningShown = false
+
+const normalizeSiteBase = (value) => {
+	if (value == null) return null
+	if (typeof value !== 'string') return null
+	const trimmed = value.trim()
+	if (!trimmed || trimmed === './') return '/'
+	if (trimmed.startsWith('http://') || trimmed.startsWith('https://')) {
+		return trimmed
+	}
+	let base = trimmed
+	if (!base.startsWith('/')) {
+		base = `/${base}`
+	}
+	if (!base.endsWith('/')) {
+		base = `${base}/`
+	}
+	return base
+}
+
+const normalizeViteBase = (value) => {
+	if (!value || value === '/' || value === './') return '/'
+	if (typeof value !== 'string') return '/'
+	let base = value.trim()
+	if (!base || base === './') return '/'
+	if (base.startsWith('http://') || base.startsWith('https://')) {
+		try {
+			base = new URL(base).pathname
+		} catch {
+			return '/'
+		}
+	}
+	if (!base.startsWith('/')) return '/'
+	if (!base.endsWith('/')) {
+		base = `${base}/`
+	}
+	return base
+}
+
+const warnDevBase = (value) => {
+	if (devBaseWarningShown) return
+	devBaseWarningShown = true
+	const label = value ? ` (received "${value}")` : ''
+	logger.warn(`Methanol: \`base\`${label} is disabled in dev mode due to module resolution inconsistencies in Vite. Using "/".\n`)
+}
+
 const hasOwn = (obj, key) => Object.prototype.hasOwnProperty.call(obj || {}, key)
 const normalizeSources = (value, root) => {
 	if (!value) return []
@@ -216,11 +264,20 @@ export const applyConfig = async (config, mode) => {
 	state.ROOT_DIR = root
 	const configSiteName = cli.CLI_SITE_NAME ?? config.site?.name ?? null
 	state.SITE_NAME = configSiteName || basename(root) || 'Methanol Site'
-	state.USER_SITE = config.site && typeof config.site === 'object' ? { ...config.site } : null
+	const userSite = config.site && typeof config.site === 'object' ? { ...config.site } : null
+	const siteBase = normalizeSiteBase(cli.CLI_BASE || userSite?.base)
+	state.SITE_BASE = siteBase
+	if (userSite) {
+		if (siteBase == null) {
+			delete userSite.base
+		} else {
+			userSite.base = siteBase
+		}
+	}
+	state.USER_SITE = userSite
 	if (mode) {
 		state.CURRENT_MODE = mode
 	}
-	// config.paths / config.dirs are intentionally ignored (deprecated)
 
 	const pagesDirValue = cli.CLI_PAGES_DIR || config.pagesDir
 	const componentsDirValue = cli.CLI_COMPONENTS_DIR || config.componentsDir
@@ -336,6 +393,9 @@ export const applyConfig = async (config, mode) => {
 	state.THEME_POST_BUILD_HOOKS = normalizeHooks(state.USER_THEME?.postBuild)
 	state.THEME_PRE_BUNDLE_HOOKS = normalizeHooks(state.USER_THEME?.preBundle)
 	state.THEME_POST_BUNDLE_HOOKS = normalizeHooks(state.USER_THEME?.postBundle)
+	if (hasOwn(config, 'gfm')) {
+		state.GFM_ENABLED = config.gfm !== false
+	}
 	const starryNight = resolveStarryNightConfig(config.starryNight)
 	const cliCodeHighlighting = cli.CLI_CODE_HIGHLIGHTING
 	if (cliCodeHighlighting != null) {
@@ -392,6 +452,7 @@ export const resolveUserViteConfig = async (command) => {
 	if (state.RESOLVED_VITE_CONFIG !== undefined) {
 		return state.RESOLVED_VITE_CONFIG
 	}
+
 	const resolveConfig = async (config) => {
 		if (!config) return null
 		if (typeof config === 'function') {
@@ -407,16 +468,85 @@ export const resolveUserViteConfig = async (command) => {
 		}
 		return config || null
 	}
+
 	const themeConfig = await resolveConfig(state.USER_THEME.vite)
 	const userConfig = await resolveConfig(state.USER_VITE_CONFIG)
+
 	if (!themeConfig && !userConfig) {
-		state.RESOLVED_VITE_CONFIG = null
-		return null
+		if (state.SITE_BASE) {
+			state.RESOLVED_VITE_CONFIG = { base: state.SITE_BASE }
+		} else {
+			state.RESOLVED_VITE_CONFIG = null
+		}
+		state.VITE_BASE = normalizeViteBase(state.RESOLVED_VITE_CONFIG?.base || state.SITE_BASE || '/')
+		if (command === 'serve') {
+			if (state.VITE_BASE !== '/' || (state.SITE_BASE && state.SITE_BASE !== '/')) {
+				warnDevBase(state.RESOLVED_VITE_CONFIG?.base || state.SITE_BASE || '')
+			}
+			if (state.RESOLVED_VITE_CONFIG) {
+				state.RESOLVED_VITE_CONFIG.base = '/'
+			}
+			state.VITE_BASE = '/'
+		}
+		return state.RESOLVED_VITE_CONFIG
 	}
+
 	state.RESOLVED_VITE_CONFIG = themeConfig
 		? userConfig
 			? mergeConfig(themeConfig, userConfig)
 			: themeConfig
 		: userConfig
+
+	const userHasBase = userConfig && hasOwn(userConfig, 'base')
+	if (state.SITE_BASE && (cli.CLI_BASE || !userHasBase)) {
+		state.RESOLVED_VITE_CONFIG.base = state.SITE_BASE
+	}
+
+	state.VITE_BASE = normalizeViteBase(state.RESOLVED_VITE_CONFIG?.base || state.SITE_BASE || '/')
+
+	if (command === 'serve') {
+		if (state.VITE_BASE !== '/' || (state.SITE_BASE && state.SITE_BASE !== '/')) {
+			warnDevBase(state.RESOLVED_VITE_CONFIG?.base || state.SITE_BASE || '')
+		}
+		state.RESOLVED_VITE_CONFIG.base = '/'
+		state.VITE_BASE = '/'
+	}
+
 	return state.RESOLVED_VITE_CONFIG
 }
+
+export const resolveBasePrefix = cached(() => {
+	const value = state.VITE_BASE || state.SITE_BASE || '/'
+	if (!value || value === '/' || value === './') return ''
+	if (typeof value !== 'string') return ''
+	let base = value.trim()
+	if (!base || base === '/' || base === './') return ''
+	if (base.startsWith('http://') || base.startsWith('https://')) {
+		try {
+			base = new URL(base).pathname
+		} catch {
+			return ''
+		}
+	}
+	if (!base.startsWith('/')) return ''
+	if (base.endsWith('/')) base = base.slice(0, -1)
+	return base
+})
+
+export const withBase = cachedStr((value) => {
+	if (!value || typeof value !== 'string') return value
+	if (
+		value.startsWith('http://') ||
+		value.startsWith('https://') ||
+		value.startsWith('//') ||
+		value.startsWith('data:') ||
+		value.startsWith('mailto:') ||
+		value.startsWith('#')
+	) {
+		return value
+	}
+	if (!value.startsWith('/')) return value
+	const prefix = resolveBasePrefix()
+	if (!prefix || value.startsWith(`${prefix}/`)) return value
+	return `${prefix}${value}`
+})

package/src/dev-server.js

@@ -49,6 +49,7 @@ export const runViteDev = async () => {
 	const baseConfig = {
 		configFile: false,
 		root: state.PAGES_DIR,
+		appType: 'mpa',
 		publicDir: state.STATIC_DIR === false ? false : state.STATIC_DIR,
 		server: {
 			fs: {
@@ -66,6 +67,8 @@ export const runViteDev = async () => {
 	}
 	const userConfig = await resolveUserViteConfig('serve')
 	const finalConfig = userConfig ? mergeConfig(baseConfig, userConfig) : baseConfig
+	const devBase = state.VITE_BASE || '/'
+	const devBasePrefix = devBase === '/' ? '' : devBase.slice(0, -1)
 	if (state.STATIC_DIR !== false && state.MERGED_ASSETS_DIR) {
 		await preparePublicAssets({
 			themeDir: state.THEME_ASSETS_DIR,
@@ -169,7 +172,14 @@ export const runViteDev = async () => {
 	}
 
 	const resolvePageFile = (routePath) => {
-		const name = routePath === '/' ? 'index' : routePath.slice(1)
+		let name = 'index'
+		if (routePath && routePath !== '/') {
+			if (routePath.endsWith('/')) {
+				name = `${routePath.slice(1, -1)}/index`
+			} else {
+				name = routePath.slice(1)
+			}
+		}
 		const mdxPath = resolve(state.PAGES_DIR, `${name}.mdx`)
 		if (existsSync(mdxPath)) return mdxPath
 		const mdPath = resolve(state.PAGES_DIR, `${name}.md`)
@@ -181,6 +191,8 @@ export const runViteDev = async () => {
 		const candidates = []
 		if (pathname === '/' || pathname === '') {
 			candidates.push('/index.html')
+		} else if (pathname.endsWith('/')) {
+			candidates.push(`${pathname}index.html`)
 		} else if (pathname.endsWith('.html')) {
 			candidates.push(pathname)
 		} else {
@@ -196,7 +208,7 @@ export const runViteDev = async () => {
 		if (hasMdx) return false
 		const baseName = basename(relativePath, '.html')
 		if (baseName.startsWith('_') || baseName.startsWith('.')) return false
-		const excludedDirs = pagesContext?.excludedDirs
+		const excludedDirs = pagesContext.excludedDirs
 		if (excludedDirs?.size) {
 			const dir = relativePath.split('/').slice(0, -1).join('/')
 			for (const excludedDir of excludedDirs) {
@@ -206,9 +218,9 @@ export const runViteDev = async () => {
 				}
 			}
 		}
-		const excludedRoutes = pagesContext?.excludedRoutes
+		const excludedRoutes = pagesContext.excludedRoutes
 		if (excludedRoutes?.has(requestedPath)) return false
-		const excludedDirPaths = pagesContext?.excludedDirPaths
+		const excludedDirPaths = pagesContext.excludedDirPaths
 		if (excludedDirPaths?.size) {
 			for (const dirPath of excludedDirPaths) {
 				if (requestedPath === dirPath || requestedPath.startsWith(`${dirPath}/`)) {
@@ -223,9 +235,6 @@ export const runViteDev = async () => {
 		if (!req.url || req.method !== 'GET') {
 			return next()
 		}
-		if (req.url.startsWith('/@vite') || req.url.startsWith('/__vite')) {
-			return next()
-		}
 
 		const url = new URL(req.url, 'http://methanol')
 		let pathname = url.pathname
@@ -233,7 +242,20 @@ export const runViteDev = async () => {
 			pathname = decodeURIComponent(pathname)
 		} catch {}
 		const originalPathname = pathname
-		const hasTrailingSlash = originalPathname.endsWith('/') && originalPathname !== '/'
+		if (devBase !== '/') {
+			const baseNoSlash = devBasePrefix
+			if (originalPathname === baseNoSlash) {
+				pathname = '/'
+			} else if (originalPathname.startsWith(devBase)) {
+				pathname = originalPathname.slice(devBase.length - 1)
+			} else {
+				return next()
+			}
+		}
+
+		if (pathname.startsWith('/@vite') || pathname.startsWith('/__vite')) {
+			return next()
+		}
 
 		if (pathname.includes('.') && !pathname.endsWith('.html')) {
 			return next()
@@ -251,15 +273,11 @@ export const runViteDev = async () => {
 				routePath = '/'
 			}
 		}
-		if (routePath.endsWith('/') && routePath !== '/') {
-			routePath = routePath.slice(0, -1)
-		}
-
 		const requestedPath = routePath
 		const isExcludedPath = () => {
-			const excludedRoutes = pagesContext?.excludedRoutes
+			const excludedRoutes = pagesContext.excludedRoutes
 			if (excludedRoutes?.has(requestedPath)) return true
-			const excludedDirPaths = pagesContext?.excludedDirPaths
+			const excludedDirPaths = pagesContext.excludedDirPaths
 			if (excludedDirPaths?.size) {
 				for (const dirPath of excludedDirPaths) {
 					if (requestedPath === dirPath || requestedPath.startsWith(`${dirPath}/`)) {
@@ -269,10 +287,8 @@ export const runViteDev = async () => {
 			}
 			return false
 		}
-		const notFoundPage = pagesContext?.pagesByRoute?.get('/404') ?? null
-		const pageMeta = hasTrailingSlash
-			? (pagesContext?.pagesByRouteIndex?.get(requestedPath) ?? pagesContext?.pagesByRoute?.get(requestedPath) ?? null)
-			: (pagesContext?.pagesByRoute?.get(requestedPath) ?? null)
+		const notFoundPage = pagesContext.pagesByRoute.get('/404')
+		let pageMeta = pagesContext.pagesByRoute.get(requestedPath)
 		let filePath = pageMeta?.filePath || resolvePageFile(requestedPath)
 		const hasMdx = Boolean(pageMeta) || existsSync(filePath)
 		let status = 200
@@ -291,7 +307,9 @@ export const runViteDev = async () => {
 				}
 				try {
 					const html = await readFile(candidate, 'utf-8')
-					const candidateUrl = `/${relativePath}`
+					const candidateUrl = devBasePrefix
+						? `${devBasePrefix}/${relativePath}`
+						: `/${relativePath}`
 					const transformed = await server.transformIndexHtml(candidateUrl, html)
 					res.statusCode = 200
 					res.setHeader('Content-Type', 'text/html')
@@ -326,6 +344,8 @@ export const runViteDev = async () => {
 			} else {
 				return next()
 			}
+		} else if (requestedPath.endsWith('/index')) {
+			renderRoutePath = requestedPath.slice(0, -5) // remove last 'index'
 		}
 
 		try {
@@ -338,6 +358,8 @@ export const runViteDev = async () => {
 				return
 			}
 
+			pageMeta ??= pagesContext.getPageByRoute(renderRoutePath, { filePath })
+
 			const html = await renderHtml({
 				routePath: renderRoutePath,
 				filePath,
@@ -374,16 +396,18 @@ export const runViteDev = async () => {
 	await server.listen()
 	server.printUrls()
 
-	const invalidateRewindInject = () => {
-		const registryModule = server.moduleGraph.getModuleById('\0/.methanol_virtual_module/registry.js')
-		if (registryModule) {
-			server.moduleGraph.invalidateModule(registryModule)
-		}
-		const injectModule = server.moduleGraph.getModuleById('\0/.methanol_virtual_module/inject.js')
-		if (injectModule) {
-			server.moduleGraph.invalidateModule(injectModule)
+	const _invalidate = (id) => {
+		const _module = server.moduleGraph.getModuleById(id)
+		if (_module) {
+			server.moduleGraph.invalidateModule(_module)
 		}
 	}
+	const invalidateRewindInject = () => {
+		_invalidate('\0/.methanol_virtual_module/registry.js')
+		_invalidate('\0methanol:registry')
+		_invalidate('\0/.methanol_virtual_module/inject.js')
+		_invalidate('\0methanol:inject')
+	}
 
 	let queue = Promise.resolve()
 	const enqueue = (task) => {

package/src/logger.js

@@ -0,0 +1,80 @@
+/* Copyright Yukino Song, SudoMaker Ltd.
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * 	http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+const supportColor =
+	typeof process !== 'undefined' &&
+	process.stdout &&
+	(process.stdout.isTTY || process.env.FORCE_COLOR)
+
+const formatter = (open, close, replace = open) =>
+	supportColor
+		? (input) => {
+				const string = '' + input
+				const index = string.indexOf(close, open.length)
+				return ~index
+					? open + getReplace(string, index, close, replace) + close
+					: open + string + close
+			}
+		: (input) => '' + input
+
+const getReplace = (string, index, close, replace) => {
+	const head = string.substring(0, index) + replace
+	const tail = string.substring(index + close.length)
+	const next = tail.indexOf(close)
+	return ~next ? head + getReplace(tail, next, close, replace) : head + tail
+}
+
+export const style = {
+	reset: formatter('\x1b[0m', '\x1b[0m'),
+	bold: formatter('\x1b[1m', '\x1b[22m', '\x1b[22m\x1b[1m'),
+	dim: formatter('\x1b[2m', '\x1b[22m', '\x1b[22m\x1b[2m'),
+	italic: formatter('\x1b[3m', '\x1b[23m'),
+	underline: formatter('\x1b[4m', '\x1b[24m'),
+	inverse: formatter('\x1b[7m', '\x1b[27m'),
+	hidden: formatter('\x1b[8m', '\x1b[28m'),
+	strikethrough: formatter('\x1b[9m', '\x1b[29m'),
+
+	black: formatter('\x1b[30m', '\x1b[39m'),
+	red: formatter('\x1b[31m', '\x1b[39m'),
+	green: formatter('\x1b[32m', '\x1b[39m'),
+	yellow: formatter('\x1b[33m', '\x1b[39m'),
+	blue: formatter('\x1b[34m', '\x1b[39m'),
+	magenta: formatter('\x1b[35m', '\x1b[39m'),
+	cyan: formatter('\x1b[36m', '\x1b[39m'),
+	white: formatter('\x1b[37m', '\x1b[39m'),
+	gray: formatter('\x1b[90m', '\x1b[39m'),
+
+	bgBlack: formatter('\x1b[40m', '\x1b[49m'),
+	bgRed: formatter('\x1b[41m', '\x1b[49m'),
+	bgGreen: formatter('\x1b[42m', '\x1b[49m'),
+	bgYellow: formatter('\x1b[43m', '\x1b[49m'),
+	bgBlue: formatter('\x1b[44m', '\x1b[49m'),
+	bgMagenta: formatter('\x1b[45m', '\x1b[49m'),
+	bgCyan: formatter('\x1b[46m', '\x1b[49m'),
+	bgWhite: formatter('\x1b[47m', '\x1b[49m')
+}
+
+export const logger = {
+	info: (msg) => console.log(`${style.blue('ℹ')}  ${msg}`),
+	success: (msg) => console.log(`${style.green('✔')}  ${msg}`),
+	warn: (msg) => console.log(`${style.yellow('⚠')}  ${msg}`),
+	error: (msg) => console.log(`${style.red('✖')}  ${msg}`),
+	dim: (msg) => console.log(style.dim(msg))
+}

package/src/main.js

@@ -26,13 +26,14 @@ import { runVitePreview } from './preview-server.js'
 import { cli, state } from './state.js'
 import { HTMLRenderer } from './renderer.js'
 import { readFile } from 'fs/promises'
+import { style, logger } from './logger.js'
 
 const printBanner = async () => {
 	try {
 		const pkgUrl = new URL('../package.json', import.meta.url)
 		const raw = await readFile(pkgUrl, 'utf-8')
 		const pkg = JSON.parse(raw)
-		const version = pkg?.version ? `v${pkg.version}` : ''
+		const version = `v${pkg.version}`
 		const isTty = Boolean(process.stdout && process.stdout.isTTY)
 		const label = `Methanol ${version}`.trim()
 		if (isTty) {
@@ -63,6 +64,7 @@ const main = async () => {
 	const config = await loadUserConfig(mode, cli.CLI_CONFIG_PATH)
 	await applyConfig(config, mode)
 	const userSite = state.USER_SITE || {}
+	const siteBase = state.VITE_BASE ?? userSite.base ?? null
 	const hookContext = {
 		mode,
 		root: state.ROOT_DIR,
@@ -73,6 +75,7 @@ const main = async () => {
 		HTMLRenderer,
 		site: {
 			...userSite,
+			base: siteBase,
 			name: state.SITE_NAME,
 			root: state.ROOT_DIR,
 			pagesDir: state.PAGES_DIR,
@@ -105,6 +108,7 @@ const main = async () => {
 		return
 	}
 	if (isBuild) {
+		const startTime = performance.now()
 		await runHooks(state.USER_PRE_BUILD_HOOKS)
 		await runHooks(state.THEME_PRE_BUILD_HOOKS)
 		const { entry, htmlCache, pagesContext } = await buildHtmlEntries()
@@ -127,6 +131,11 @@ const main = async () => {
 		}
 		await runHooks(state.THEME_POST_BUILD_HOOKS, buildContext)
 		await runHooks(state.USER_POST_BUILD_HOOKS, buildContext)
+		const endTime = performance.now()
+		const duration = endTime - startTime
+		const timeString = duration > 1000 ? `${(duration / 1000).toFixed(2)}s` : `${Math.round(duration)}ms`
+		console.log()
+		logger.success(`Build completed in ${style.bold(timeString)}.`)
 		return
 	}
 	cli.showHelp()