feat: support config file and export a server

Author: axiaoan

build.config.ts

@@ -4,7 +4,7 @@ export default defineBuildConfig({
   entries: [
     { input: 'src/index', name: 'index' },
     { input: 'src/node/cli', name: 'node/cli' },
-    { input: 'src/server/express', name: 'express' },
+    { input: 'src/server/index', name: 'server' },
   ],
   clean: true,
   declaration: true,

package.json

@@ -18,10 +18,10 @@
       "import": "./dist/index.mjs",
       "types": "./dist/index.d.ts"
     },
-    "./express": {
-      "require": "./dist/express.cjs",
-      "import": "./dist/express.mjs",
-      "types": "./dist/express.d.ts"
+    "./server": {
+      "require": "./dist/server.cjs",
+      "import": "./dist/server.mjs",
+      "types": "./dist/server.d.ts"
     }
   },
   "files": [
@@ -33,17 +33,27 @@
     "vite-ssr": "./bin/vite-ssr.js"
   },
   "sideEffects": false,
+  "typesVersions": {
+    "*": {
+      "server": [
+        "dist/server.d.ts"
+      ]
+    }
+  },
   "scripts": {
     "dev": "tsup --watch src --onSuccess",
     "build": "unbuild",
     "basic:dev": "pnpm dev \"pnpm -F basic dev\"",
     "basic:build": "pnpm build & pnpm -F basic build",
     "basic:serve": "pnpm basic:build & pnpm -F basic serve",
-    "basic:preview": "pnpm basic:build & pnpm -F basic preview",
+    "basic:serve:bin": "pnpm basic:build & pnpm -F basic serve:bin",
+    "basic:build:noexternal": "pnpm build & pnpm -F basic build:noexternal",
+    "basic:preview": "pnpm basic:build:noexternal & pnpm -F basic preview",
     "vl-naive:dev": "pnpm dev \"pnpm -F vitesse-lite-naive-ui dev\"",
     "vl-naive:build": "pnpm build & pnpm -F vitesse-lite-naive-ui build",
     "vl-naive:serve": "pnpm vl-naive:build & pnpm -F vitesse-lite-naive-ui serve",
-    "vl-naive:preview": "pnpm vl-naive:build & pnpm -F vitesse-lite-naive-ui preview",
+    "vl-naive:build:noexternal": "pnpm build & pnpm -F vitesse-lite-naive-ui build:noexternal",
+    "vl-naive:preview": "pnpm vl-naive:build:noexternal & pnpm -F vitesse-lite-naive-ui preview",
     "lint": "eslint .",
     "lint:fix": "eslint --fix .",
     "prepublishOnly": "npm run build",

src/config.ts

@@ -1,6 +1,6 @@
 import path, { join as _join, resolve as _resolve } from 'path'
 import { resolveConfig } from 'vite'
-import type { ResolvedConfig } from 'vite'
+import type { InlineConfig, ResolvedConfig } from 'vite'
 import fs from 'fs-extra'
 
 import type { ViteSSROptions } from './types'
@@ -67,6 +67,6 @@ export async function getEntryPoint(
 }
 
 // Get all vite configurations
-export function resolveViteConfig(mode?: string) {
-  return resolveConfig({}, 'build', mode || process.env.MODE || process.env.NODE_ENV)
+export function resolveViteConfig(mode?: string, config: InlineConfig = {}) {
+  return resolveConfig(config, 'build', mode || process.env.MODE || process.env.NODE_ENV)
 }

src/entry.ts

@@ -37,7 +37,6 @@ export function ViteSSR(
       initialState: {},
       transformState,
       routePath,
-      render: undefined,
       onBeforePageRender: undefined,
       onPageRender: undefined,
     }
@@ -72,7 +71,6 @@ export function ViteSSR(
 
       await router.isReady()
       context.initialState = router.currentRoute.value.meta.state as Record<string, any> || {}
-      // context.render = createRender(app, context) as any
     }
 
     const initialState = context.initialState

src/node/build.ts

@@ -1,28 +1,29 @@
 /* eslint-disable no-console */
 import { isAbsolute, join } from 'path'
 import type { ResolvedConfig, UserConfig } from 'vite'
-import { build as viteBuild } from 'vite'
+import { mergeConfig, build as viteBuild } from 'vite'
 import { getEntryPoint, resolveViteConfig } from '../config'
 import { buildLog } from './utils'
 
 export interface CliOptions {
   mode?: string
   format?: string
+  config?: string
 }
 
 export async function build(cliOptions: CliOptions = {}) {
   const mode = process.env.MODE || process.env.NODE_ENV || cliOptions.mode || 'production'
-  const config: ResolvedConfig = await resolveViteConfig(mode)
+  const config: ResolvedConfig = await resolveViteConfig(mode, { configFile: cliOptions.config })
 
   const cwd = process.cwd()
   const root = config.root || cwd
   const outDir = config.build.outDir || 'dist'
   const out = isAbsolute(outDir) ? outDir : join(root, outDir)
 
-  const { input } = Object.assign({}, config.ssrOptions || {}, cliOptions)
+  const { input, clientConfig = {}, serverConfig = {} } = Object.assign({}, config.ssrOptions || {}, cliOptions)
 
   buildLog('Build for client...')
-  await viteBuild({
+  await viteBuild(mergeConfig({
     build: {
       ssrManifest: true,
       outDir: join(out, 'client'),
@@ -33,10 +34,10 @@ export async function build(cliOptions: CliOptions = {}) {
       },
     },
     mode: config.mode,
-  } as UserConfig)
+  }, clientConfig) as UserConfig)
 
   buildLog('Build for server...')
-  await viteBuild({
+  await viteBuild(mergeConfig({
     build: {
       ssr: await getEntryPoint(config.ssrOptions || {}, config),
       outDir: join(out, 'server'),
@@ -50,5 +51,5 @@ export async function build(cliOptions: CliOptions = {}) {
       },
     },
     mode: config.mode,
-  } as UserConfig)
+  }, serverConfig) as UserConfig)
 }

src/node/render.ts

@@ -98,7 +98,7 @@ export async function createRender({
   return render
 }
 
-export async function renderPreloadLinks(modules: any, manifest: any) {
+async function renderPreloadLinks(modules: any, manifest: any) {
   let links = ''
   const seen = new Set()
   const { basename } = await import('path')

src/server/express.ts

@@ -1,10 +1,9 @@
-/* eslint-disable @typescript-eslint/no-var-requires, no-console */
 import path from 'path'
+import { performance } from 'perf_hooks'
 import express from 'express'
 import type { CreateServerOptions, ViteSSRContext } from '../types'
 import { createRender } from '../node/render'
 import { createStartServer } from './common'
-const { performance } = require('perf_hooks')
 
 export async function createServer({
   createApp,

src/server/index.ts

@@ -0,0 +1,2 @@
+export { createRender } from '../node/render'
+export { createServer as createExpressServer, startServer as startExpressServer } from './express'

src/types.ts

@@ -1,9 +1,10 @@
 /* eslint-disable no-use-before-define */
-import type { ViteDevServer } from 'vite'
+import type { UserConfigExport, ViteDevServer } from 'vite'
 import type { App } from 'vue'
 import type { RouteRecordRaw, Router, RouterOptions as VueRouterOptions } from 'vue-router'
 
 type PartialKeys<T, Keys extends keyof T> = Omit<T, Keys> & Partial<Pick<T, Keys>>
+type OmitExcludeKey<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>
 
 export interface ViteSSROptions {
   /**
@@ -37,6 +38,8 @@ export interface ViteSSROptions {
    * @see https://cn.vitejs.dev/config/#mode
    */
   mode?: 'development' | 'production'
+  clientConfig?: UserConfigExport
+  serverConfig?: UserConfigExport
 }
 
 interface RenderHtml {
@@ -64,7 +67,6 @@ export interface ViteSSRContext<HasRouter extends boolean = true> {
    * `undefined` on client side.
    */
   routePath?: string
-  render?: (url: string, manifest: any) => Promise<{ appHtml: string; preloadLinks: string }>
 }
 
 export type RouterOptions = PartialKeys<VueRouterOptions, 'history'> & { base?: string }

tsup.config.ts

@@ -3,7 +3,7 @@ import type { Options } from 'tsup'
 export default <Options><unknown>{
   entryPoints: {
     'index': 'src/index.ts',
-    'express': 'src/server/express.ts',
+    'server': 'src/server/index.ts',
     'node/cli': 'src/node/cli.ts',
   },
   dts: true,