async function createServer(inlineConfig?: InlineConfig): Promise<ViteDevServer>

import { createServer } from 'vite'

const server = await createServer({
  // 任何有效的用户配置选项，外加 `mode` 和 `configFile`
  configFile: false,
  root: import.meta.dirname,
  server: {
    port: 1337,
  },
})
await server.listen()

server.printUrls()
server.bindCLIShortcuts({ print: true })

interface ViteDevServer {
  /**
   * 解析后的 Vite 配置对象。
   */
  config: ResolvedConfig
  /**
   * 一个 connect 应用实例
   * - 可用于将自定义中间件附加到开发服务器。
   * - 也可用作自定义 http 服务器的处理函数
   *   或任何 connect 风格的 Node.js 框架中的中间件。
   *
   * https://github.com/senchalabs/connect#use-middleware
   */
  middlewares: Connect.Server
  /**
   * 原生 Node http 服务器实例。
   * 在中间件模式下为 null。
   */
  httpServer: http.Server | null
  /**
   * Chokidar 监听器实例。如果 `config.server.watch` 设置为 `null`，
   * 则不会监听任何文件，调用 `add` 或 `unwatch` 将无效。
   * https://github.com/paulmillr/chokidar/tree/3.6.0#api
   */
  watcher: FSWatcher
  /**
   * 带有 `send(payload)` 方法的 WebSocket 服务器。
   */
  ws: WebSocketServer
  /**
   * Rollup 插件容器，可以对给定文件运行插件钩子。
   */
  pluginContainer: PluginContainer
  /**
   * 模块图，跟踪导入关系、url 到文件的映射以及 hmr 状态。
   */
  moduleGraph: ModuleGraph
  /**
   * Vite 在 CLI 上打印的已解析 URL（URL 编码）。在中间件模式下或
   * 服务器未监听任何端口时返回 `null`。
   */
  resolvedUrls: ResolvedServerUrls | null
  /**
   * 以编程方式解析、加载和转换 URL 并获取结果，
   * 无需经过 http 请求管道。
   */
  transformRequest(
    url: string,
    options?: TransformOptions,
  ): Promise<TransformResult | null>
  /**
   * 应用 Vite 内置的 HTML 转换以及任何插件的 HTML 转换。
   */
  transformIndexHtml(
    url: string,
    html: string,
    originalUrl?: string,
  ): Promise<string>
  /**
   * 将给定的 URL 作为实例化的 SSR 模块加载。
   */
  ssrLoadModule(
    url: string,
    options?: { fixStacktrace?: boolean },
  ): Promise<Record<string, any>>
  /**
   * 修复 ssr 错误堆栈跟踪。
   */
  ssrFixStacktrace(e: Error): void
  /**
   * 为模块图中的模块触发 HMR。您可以使用 `server.moduleGraph`
   * API 来检索要重新加载的模块。如果 `hmr` 为 false，则此操作为空操作。
   */
  reloadModule(module: ModuleNode): Promise<void>
  /**
   * 启动服务器。
   */
  listen(port?: number, isRestart?: boolean): Promise<ViteDevServer>
  /**
   * 重启服务器。
   *
   * @param forceOptimize - 强制优化器重新打包，等同于 --force cli 标志
   */
  restart(forceOptimize?: boolean): Promise<void>
  /**
   * 停止服务器。
   */
  close(): Promise<void>
  /**
   * 绑定 CLI 快捷键
   */
  bindCLIShortcuts(options?: BindCLIShortcutsOptions<ViteDevServer>): void
  /**
   * 调用 `await server.waitForRequestsIdle(id)` 将等待所有静态导入
   * 被处理完毕。如果从 load 或 transform 插件钩子中调用，需要将 id
   * 作为参数传入以避免死锁。在模块图的第一个静态导入部分处理完毕后
   * 调用此函数将立即 resolve。
   * @experimental
   */
  waitForRequestsIdle: (ignoredId?: string) => Promise<void>
}

async function build(
  inlineConfig?: InlineConfig,
): Promise<RolldownOutput | RolldownOutput[] | RolldownWatcher>

import path from 'node:path'
import { build } from 'vite'

await build({
  root: path.resolve(import.meta.dirname, './project'),
  base: '/foo/',
  build: {
    rolldownOptions: {
      // ...
    },
  },
})

async function preview(inlineConfig?: InlineConfig): Promise<PreviewServer>

import { preview } from 'vite'

const previewServer = await preview({
  // 任何有效的用户配置选项，外加 `mode` 和 `configFile`
  preview: {
    port: 8080,
    open: true,
  },
})

previewServer.printUrls()
previewServer.bindCLIShortcuts({ print: true })

interface PreviewServer {
  /**
   * 解析后的 vite 配置对象
   */
  config: ResolvedConfig
  /**
   * 一个 connect 应用实例。
   * - 可用于将自定义中间件附加到预览服务器。
   * - 也可用作自定义 http 服务器的处理函数
   *   或任何 connect 风格的 Node.js 框架中的中间件
   *
   * https://github.com/senchalabs/connect#use-middleware
   */
  middlewares: Connect.Server
  /**
   * 原生 Node http 服务器实例
   */
  httpServer: http.Server
  /**
   * Vite 在 CLI 上打印的已解析 URL（URL 编码）。如果服务器
   * 未监听任何端口，则返回 `null`。
   */
  resolvedUrls: ResolvedServerUrls | null
  /**
   * 打印服务器 url
   */
  printUrls(): void
  /**
   * 绑定 CLI 快捷键
   */
  bindCLIShortcuts(options?: BindCLIShortcutsOptions<PreviewServer>): void
}

async function resolveConfig(
  inlineConfig: InlineConfig,
  command: 'build' | 'serve',
  defaultMode = 'development',
  defaultNodeEnv = 'development',
  isPreview = false,
): Promise<ResolvedConfig>

function mergeConfig(
  defaults: Record<string, any>,
  overrides: Record<string, any>,
  isRoot = true,
): Record<string, any>

import {
  defineConfig,
  mergeConfig,
  type UserConfigFnObject,
  type UserConfig,
} from 'vite'
declare const configAsCallback: UserConfigFnObject
declare const configAsObject: UserConfig

// ---cut---
export default defineConfig((configEnv) =>
  mergeConfig(configAsCallback(configEnv), configAsObject),
)

function searchForWorkspaceRoot(
  current: string,
  root = searchForPackageRoot(current),
): string

function loadEnv(
  mode: string,
  envDir: string,
  prefixes: string | string[] = 'VITE_',
): Record<string, string>

function normalizePath(id: string): string

async function transformWithOxc(
  code: string,
  filename: string,
  options?: OxcTransformOptions,
  inMap?: object,
): Promise<Omit<OxcTransformResult, 'errors'> & { warnings: string[] }>

async function transformWithEsbuild(
  code: string,
  filename: string,
  options?: EsbuildTransformOptions,
  inMap?: object,
): Promise<ESBuildTransformResult>

async function loadConfigFromFile(
  configEnv: ConfigEnv,
  configFile?: string,
  configRoot: string = process.cwd(),
  logLevel?: LogLevel,
  customLogger?: Logger,
): Promise<{
  path: string
  config: UserConfig
  dependencies: string[]
} | null>

async function preprocessCSS(
  code: string,
  filename: string,
  config: ResolvedConfig,
): Promise<PreprocessCSSResult>

interface PreprocessCSSResult {
  code: string
  map?: SourceMapInput
  modules?: Record<string, string>
  deps?: Set<string>
}