release: v6.0.0

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

.eslintignore

@@ -1,2 +0,0 @@
-node_modules
-dist

.eslintrc.js

@@ -1,38 +0,0 @@
-module.exports = {
-  root: true,
-  env: {
-    commonjs: true,
-    es6: true,
-    node: true
-  },
-  parser: '@typescript-eslint/parser',
-  parserOptions: {
-    sourceType: 'module',
-    ecmaVersion: 2021
-  },
-  plugins: ['@typescript-eslint'],
-  extends: [
-    'eslint:recommended',
-    'plugin:@typescript-eslint/recommended',
-    'plugin:@typescript-eslint/eslint-recommended',
-    'plugin:prettier/recommended'
-  ],
-  rules: {
-    'no-empty': ['warn', { allowEmptyCatch: true }],
-    '@typescript-eslint/ban-ts-comment': ['error', { 'ts-ignore': 'allow-with-description' }],
-    '@typescript-eslint/explicit-function-return-type': 'error',
-    '@typescript-eslint/explicit-module-boundary-types': 'off',
-    '@typescript-eslint/no-empty-function': ['error', { allow: ['arrowFunctions'] }],
-    '@typescript-eslint/no-explicit-any': 'error',
-    '@typescript-eslint/no-non-null-assertion': 'off',
-    '@typescript-eslint/no-var-requires': 'off'
-  },
-  overrides: [
-    {
-      files: ['*.js'],
-      rules: {
-        '@typescript-eslint/explicit-function-return-type': 'off'
-      }
-    }
-  ]
-}

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: alex8088

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,6 +1,5 @@
 name: "\U0001F41E Bug Report"
 description: Report an issue with electron-vite
-labels: ['bug', 'triage']
 body:
   - type: markdown
     attributes:
@@ -45,7 +44,7 @@ body:
           required: true
         - label: Read the [Contributing Guidelines](https://github.com/alex8088/electron-vite/blob/master/CONTRIBUTING.md).
           required: true
-        - label: Read the [docs](https://evite.netlify.app).
+        - label: Read the [docs](https://electron-vite.org).
           required: true
         - label: Check that there isn't [already an issue](https://github.com/alex8088/electron-vite/issues) that reports the same bug to avoid creating a duplicate.
           required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -1 +1,5 @@
 blank_issues_enabled: false
+contact_links:
+  - name: Questions & Discussions
+    url: https://github.com/alex8088/electron-vite/discussions
+    about: Use GitHub discussions for message-board style questions and discussions.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -40,7 +40,7 @@ body:
           required: true
         - label: Read the [Contributing Guidelines](https://github.com/alex8088/electron-vite/blob/master/CONTRIBUTING.md).
           required: true
-        - label: Read the [docs](https://evite.netlify.app).
+        - label: Read the [docs](https://electron-vite.org).
           required: true
-        - label: Check that there isn't [already an issue](https://github.com/alex8088/electron-vite/issues) that reports the same bug to avoid creating a duplicate.
+        - label: Check that there isn't [already an issue](https://github.com/alex8088/electron-vite/issues) that requests the same feature to avoid creating a duplicate.
           required: true

.gitignore

@@ -1,4 +1,5 @@
 node_modules
 dist
-
+.DS_Store
+.eslintcache
 *.log*

.vscode/settings.json

@@ -0,0 +1,11 @@
+{
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  }
+}

CHANGELOG.md

@@ -1,3 +1,392 @@
+### v6.0.0 (_2026-10-15_)
+
+- feat(bytecode): support RegExp for chunkAlias option ([#885](https://github.com/alex8088/electron-vite/issues/885))
+- refactor: share and normalize build output resolution
+- refactor: inline bytecode build plugin name
+- refactor!: invoke the bytecode compiler only once to compile all code
+- refactor: use pipe stdio for spawn Electron bytecode compliler and append stderr error
+- refactor: use rolldown instead of esbuild to bundle config file
+- refactor: compile bytecode using the Electron main process or renderer process rather then via the `ELECTRON_RUN_AS_NODE`
+- refactor!: simplify resolve config and isolate user config for sub-builds
+- refactor: `?modulePath` sub-build output strategy
+- perf(swcPlugin): skip redundant minification when using Oxc ([#922](https://github.com/alex8088/electron-vite/issues/922))
+- perf: skip Babel loading in development and builds without bytecode
+- perf: short-circuit bytecode detection in builds
+- perf: setup rollupOption compatibility via config factory
+- perf: build compatibility target for Electron 42, 43, 44
+- fix(asset): use consistent file paths for asset cache lookups
+- fix(bytecode): unable to obtain the bytecode build session in Node.js 24 ([#928](https://github.com/alex8088/electron-vite/issues/928))
+- fix(dev): exit non-zero when Electron is killed by a signal ([#918](https://github.com/alex8088/electron-vite/issues/918))
+- fix(dev): forward termination signals to Electron child ([#900](https://github.com/alex8088/electron-vite/issues/900))
+- fix(dev): improve Electron process signal handling
+- fix(bytecode): set the regular expression's `lastIndex` to 0 to perform a global match for chunkAlias option
+- fix(esmShim)!: use `this.parse` to find the last static import ([#906](https://github.com/alex8088/electron-vite/issues/906))
+- fix(deps)!: downgraded @babel/* to v7 due to Node requirements
+- fix: remove useless preset config
+- fix(swcPlugin): also disable oxc on Vite 8 ([#920](https://github.com/alex8088/electron-vite/issues/920))
+- fix: clone config without plugins [#902](https://github.com/alex8088/electron-vite/issues/902)
+- fix(deps)!: update magic-string to v1
+- fix(deps)!: update @babel/* to v8
+- fix!: compatible with rollupOptions and rolldownOptions
+- fix: chunk filename is wrong in ES mode
+- fix(asset): isolate asset caches per environment
+- fix: use the environment api in plugins
+- fix: skip TTY terminal manipulations in CI environments
+- fix(deps)!: update vite to v8 ([#894](https://github.com/alex8088/electron-vite/issues/894))
+- fix: Typescript compiler option 'outDir' must be located inside Rollup 'dir' option
+- fix(isolateEntries): handle non-TTY stdout in build reporter (#887)
+- chore: simplify bytecode compiler initialization
+- chore: improve jsdoc for bytecode options ([#898](https://github.com/alex8088/electron-vite/issues/898))
+- chore(deps): update all non-major dependencies
+- chore(deps): update lint-staged to v17
+- chore(deps): update cac to v7
+- chore(deps): update globals to v17
+- chore(deps): update eslint and @eslint/js to v10
+- chore(deps): update all non-major dependencies
+
+### v6.0.0-beta.8 (_2026-10-11_)
+
+See [v6.0.0-beta.8 changelog](https://github.com/alex8088/electron-vite/blob/v6.0.0-beta.8/CHANGELOG.md)
+
+### v6.0.0-beta.7 (_2026-10-08_)
+
+See [v6.0.0-beta.7 changelog](https://github.com/alex8088/electron-vite/blob/v6.0.0-beta.7/CHANGELOG.md)
+
+### v6.0.0-beta.6 (_2026-10-07_)
+
+See [v6.0.0-beta.6 changelog](https://github.com/alex8088/electron-vite/blob/v6.0.0-beta.6/CHANGELOG.md)
+
+### v6.0.0-beta.5 (_2026-09-29_)
+
+See [v6.0.0-beta.5 changelog](https://github.com/alex8088/electron-vite/blob/v6.0.0-beta.5/CHANGELOG.md)
+
+### v6.0.0-beta.4 (_2026-09-28_)
+
+See [v6.0.0-beta.4 changelog](https://github.com/alex8088/electron-vite/blob/v6.0.0-beta.4/CHANGELOG.md)
+
+### v6.0.0-beta.3 (_2026-09-27_)
+
+See [v6.0.0-beta.3 changelog](https://github.com/alex8088/electron-vite/blob/v6.0.0-beta.3/CHANGELOG.md)
+
+### v6.0.0-beta.2 (_2026-09-27_)
+
+See [v6.0.0-beta.2 changelog](https://github.com/alex8088/electron-vite/blob/v6.0.0-beta.2/CHANGELOG.md)
+
+### v6.0.0-beta.1 (_2026-04-12_)
+
+See [v6.0.0-beta.1 changelog](https://github.com/alex8088/electron-vite/blob/v6.0.0-beta.1/CHANGELOG.md)
+
+### v6.0.0-beta.0 (_2026-04-09_)
+
+See [v6.0.0-beta.0 changelog](https://github.com/alex8088/electron-vite/blob/v6.0.0-beta.0/CHANGELOG.md)
+
+### v5.0.0 (_2025-12-07_)
+
+- feat(config): add `build.externalizeDeps` and `build.bytecode` config options to replace `externalizeDepsPlugin` and `bytecodePlugin`
+- feat: reporter plugin for isolated builds
+- feat: enhanced string protection
+- feat: add `isolatedEntries` option for `preload` and `renderer` to build entries as standalone bundles [#154](https://github.com/alex8088/electron-vite/issues/154)
+- refactor(config): move the `isolateEntries` options to the `build` option
+- refactor: deprecated `externalizeDepsPlugin` and `bytecodePlugin`
+- refactor(config)!: remove function resolution for nested config fields
+- refactor(asset): remove redundant path normalization
+- refactor: split electron plugin into preset and validator plugins
+- refactor(config)!: restructure Electron Vite config interfaces
+- refactor(build): simplify build logic
+- refactor: replace `JSON.parse/stringify` with manual deep clone
+- refactor(bytecodePlugin): improved bytecode bundle generation and made a new string protection plugin
+- refactor(modulePath): better support for tree-shaking and code-splitting
+- refactor: remove Electron 18, 19, 20, 21 build compatilibity target
+- perf(buildReport): exclude node_modules from watch list
+- perf(isolateEntries): transform log
+- perf(isolateEntries): optimize entries transformation
+- perf: build compatibility target for Electron 39
+- perf(plugin): more efficient module filtering via regular expressions
+- perf(plugin): no need to cache `sourcemap` option
+- perf(plugin): lazily initialize `MagicString` and remove the redundant pre-check
+- perf(bytecodePlugin): better way to count bytecode chunks
+- perf(plugin): enhance path resolution using `import.meta.dirname` for ES modules
+- fix(modulePath): rewrite the build input instead of merging
+- fix(asset): normalize imported public asset chunk path
+- fix: avoid duplicate chunk emission
+- fix(modulePath): prevent duplicate asset emission
+- fix(modulePath): support watch mode
+- chore: fix jsdoc
+- chore: improve logging message clarity and consistency
+- chore(deps): update all non-major dependencies
+- chore: update eslint config
+- chore: replace `tseslint.config` with `defineConfig`
+- chore: remove redundant external id
+- chore: rename the file `esm` to `esmShim`
+- docs: update
+
+### v5.0.0-beta.3 (_2025-11-01_)
+
+See [v5.0.0-beta.3 changelog](https://github.com/alex8088/electron-vite/blob/v5.0.0-beta.3/CHANGELOG.md)
+
+### v5.0.0-beta.2 (_2025-10-30_)
+
+See [v5.0.0-beta.2 changelog](https://github.com/alex8088/electron-vite/blob/v5.0.0-beta.2/CHANGELOG.md)
+
+### v5.0.0-beta.1 (_2025-10-29_)
+
+See [v5.0.0-beta.1 changelog](https://github.com/alex8088/electron-vite/blob/v5.0.0-beta.1/CHANGELOG.md)
+
+### v5.0.0-beta.0 (_2025-10-19_)
+
+See [v5.0.0-beta.0 changelog](https://github.com/alex8088/electron-vite/blob/v5.0.0-beta.0/CHANGELOG.md)
+
+### v4.0.1 (_2025-09-21_)
+
+- perf: build compatibility target for Electron 38
+
+### v4.0.0 (_2025-07-06_)
+
+- refactor!: bump required node version to 20.19+, 22.12+
+- fix(deps)!: update Vite to v7 and remove cjs build
+- fix: use `import type` for type-only imports
+- perf: build compatibility target for Electron 36 ([#766](https://github.com/alex8088/electron-vite/pull/766))
+- perf: build compatibility target for Electron 37
+- chore(deps): update pnpm to v10
+- chore(deps): update all non-major dependencies
+- chore(deps): update lint-staged to v16
+
+### v4.0.0-beta.0 (_2025-06-28_)
+
+See [v4.0.0-beta.0 changelog](https://github.com/alex8088/electron-vite/blob/v4.0.0-beta.0/CHANGELOG.md)
+
+### v3.1.0 (_2025-03-25_)
+
+- fix(bytecodePlugin): optimize 'use strict' directive replacement ([#681](https://github.com/alex8088/electron-vite/issues/681))
+- perf: build compatilibity target for Electron 35 ([#729](https://github.com/alex8088/electron-vite/pull/729))
+- chore(deps): update all non-major dependencies
+- chore(deps): update globals to v16
+- chore(deps): update esbuild to v0.25
+
+### v3.1.0-beta.0 (_2025-03-12_)
+
+See [v3.1.0-beta.0 changelog](https://github.com/alex8088/electron-vite/blob/v3.1.0-beta.0/CHANGELOG.md)
+
+### v3.0.0 (_2025-02-16_)
+
+- feat: resolve conditions for preload
+- perf: build compatilibity target for Electron 32
+- perf: build compatilibity target for Electron 33 ([#651](https://github.com/alex8088/electron-vite/pull/651))
+- perf: build compatilibity target for Electron 34
+- chore: move to eslint flat config
+- chore(deps): update all non-major dependencies
+- chore(deps): update @rollup/plugin-node-resolve to v16
+- chore(deps): update @rollup/plugin-typescript to v12
+- chore(deps): update esbuild to v0.24
+- chore(deps): update vite to v6
+- chore(deps): update @type/node to v22
+
+### v3.0.0-beta.0 (_2025-01-22_)
+
+See [v3.0.0-beta.0 changelog](https://github.com/alex8088/electron-vite/blob/v3.0.0-beta.0/CHANGELOG.md)
+
+### v2.3.0 (_2024-06-23_)
+
+- feat: resolve import.meta.\[dirname|filename\] to support CommonJS format
+- fix: don't handle module ID that begin with \0 ([#530](https://github.com/alex8088/electron-vite/pull/530))
+- fix: not using the mode from the config file ([#539](https://github.com/alex8088/electron-vite/pull/539))
+- fix: default mode should not overrite user config mode
+- perf: build compatilibity target for Electron 31
+- perf: improve cjs shim
+- chore(deps): update all non-major dependencies
+- chore(deps): update @typescript-eslint/\* to v7
+- chore(deps): update esbuild to v0.21
+
+### v2.2.0 (_2024-04-21_)
+
+- feat: export mergeConfig from vite ([#471](https://github.com/alex8088/electron-vite/issues/471))
+- fix(types): narrow down the return type of defineConfig
+- perf: build compatilibity target for Electron 30
+- refactor(config): defineConfig types
+- chore: fix camelcase typo
+- chore: use rollup-plugin-rm to clean dist
+
+### v2.1.0 (_2024-03-03_)
+
+- feat: easy way to fork processes and use workers
+- fix: config via build.lib fails when default entry point not found ([#393](https://github.com/alex8088/electron-vite/issues/393))
+- perf: build compatilibity target for Electron 29
+- perf: allow integrating more complex render solutions ([#412](https://github.com/alex8088/electron-vite/pull/412))
+- perf(bytecodePlugin): warn that strings cannot be protected when minification is enabled ([#417](https://github.com/alex8088/electron-vite/issues/417))
+
+### v2.0.0 (_2024-01-09_)
+
+- feat: bump minimum node version to 18
+- feat: migrate to ESM
+- feat: support vite 5
+- feat: add package.json to export map
+- feat: support ESM in Electron
+- feat: env variables prefixed with VITE\_ will be shared in main process and renderer
+- feat: support for passing arguments to electron in dev and preview commands ([#339](https://github.com/alex8088/electron-vite/pull/339))
+- feat: config file supports "type": "module" in package.json
+- fix: emit assets when ssr is enabled
+- fix: externalizeDepPlugin not work
+- fix: electron's export subpaths also need to be externalized ([#372](https://github.com/alex8088/electron-vite/issues/372))
+- perf: improve package.json resolve
+- perf: use magic-string hires boundary for sourcemaps
+- perf: build compatilibity target for Electron 28
+- pref: resolve import meta url in CommonJS format
+- perf(worker): ESM syntax
+- perf: package version
+- perf: dev error message
+- perf(externalizeDepsPlugin): use cached package data to improve performance
+- perf: loadEnv api also needs to load shared env variables prefixed with VITE\_
+- refactor: build
+- refactor: file hashes use url-safe base64 encoded hashes in vite 5 (rollup 4)
+- refactor: remove Electron 11, 12 build compatilibity target
+- refactor: use dynamic import directly
+- build: use rollup-plugin-dts
+- chore(deps): update all non-major dependencies
+- chore(deps): update lint-staged to v15
+- chore(deps): update eslint-config-prettier to v9
+- chore(deps): update @rollup/plugin-typescript to v11
+- chore(deps): update rollup to v4
+- chore(deps): update vite to v5
+- chore(deps): update esbuild to v0.19
+- chore(deps): update typescript to 5.3.3
+- chore: improve prettier config
+- chore: update homepage
+
+### v2.0.0-beta.4 (_2024-01-06_)
+
+See [v2.0.0-beta.4 changelog](https://github.com/alex8088/electron-vite/blob/v2.0.0-beta.4/CHANGELOG.md)
+
+### v2.0.0-beta.3 (_2024-01-04_)
+
+See [v2.0.0-beta.3 changelog](https://github.com/alex8088/electron-vite/blob/v2.0.0-beta.3/CHANGELOG.md)
+
+### v2.0.0-beta.2 (_2023-12-19_)
+
+See [v2.0.0-beta.2 changelog](https://github.com/alex8088/electron-vite/blob/v2.0.0-beta.2/CHANGELOG.md)
+
+### v2.0.0-beta.1 (_2023-12-14_)
+
+See [v2.0.0-beta.1 changelog](https://github.com/alex8088/electron-vite/blob/v2.0.0-beta.1/CHANGELOG.md)
+
+### v2.0.0-beta.0 (_2023-12-13_)
+
+See [v2.0.0-beta.0 changelog](https://github.com/alex8088/electron-vite/blob/v2.0.0-beta.0/CHANGELOG.md)
+
+### v1.0.29 (_2023-11-17_)
+
+- feat(cli): support --noSandbox option for dev and preview command
+- perf: build compatilibity target for Electron 27
+
+### v1.0.28 (_2023-09-18_)
+
+- feat(cli): supports specifying electron entry file ([#270](https://github.com/alex8088/electron-vite/issues/270))
+- fix(externalizeDepsPlugin): supports subpath
+- perf: build compatilibity target for Electron 26
+- chore(types): add .json?commonjs-external&asset typing
+
+### v1.0.27 (_2023-08-01_)
+
+- chore: remove preinstall script
+
+### v1.0.26 (_2023-07-30_)
+
+- feat(cli): add CLI `--inspect[-brk]` to support debugging without IDEs ([#231](https://github.com/alex8088/electron-vite/issues/231))
+- feat(types): add process.env.ELECTRON_RENDERER_URL type
+- feat(types): add Vite importMeta types
+- perf: spawn Electron process using parent's stdios ([#236](https://github.com/alex8088/electron-vite/issues/236))
+- chore: update user config interface jsdoc
+- chore(deps): update pnpm to v8
+- chore(deps): update prettier to v3
+- chore(deps): update @typescript-eslint/\* to v6
+
+### v1.0.25 (_2023-07-11_)
+
+- fix: remove node resolve condition for preload [#204](https://github.com/alex8088/electron-vite/issues/204)
+- fix(asset): asset handling error when hot reloading
+- chore(deps): update all non-major dependencies
+- chore(deps): update fs-extra to v11
+- chore(deps): update @types/node to v18
+- chore(deps): update typescript to 5.0.4
+- chore(deps): update vite to 4.4.2
+- chore(deps): update esbuild to v0.18
+- chore(deps): update rollup to 3.26.2
+
+### v1.0.24 (_2023-06-25_)
+
+- fix(bytecodePlugin): bytecode loader relative path is incorrect
+- perf: ignore `browser` field and additional `node` condition for main config
+
+### v1.0.23 (_2023-06-04_)
+
+- feat: supports ES build target for renderer [#174](https://github.com/alex8088/electron-vite/issues/174)
+- revert: chore: remove process env define [#159](https://github.com/alex8088/electron-vite/issues/174)
+- perf: build compatilibity target for Electron 25
+- chore(deps): update all non-major dependencies
+
+### v1.0.22 (_2023-04-23_)
+
+- feat(cli): add --rendererOnly flag to dev command
+- perf: build compatilibity target for Electron 24
+- chore: remove process env define
+- chore: typo error messages
+
+### v1.0.21 (_2023-03-27_)
+
+- fix(bytecodePlugin): bytecode loader is not referenced correctly in the chunks
+- fix(bytecodePlugin): sub-chunks are not compliled in vite 4
+- perf: always disable build.modulePreload in main and preload config
+- chore(deps): update esbuild to 0.17
+- chore(deps): update vite to 4.2.1
+
+### v1.0.20 (_2023-03-12_)
+
+- feat: support for renderer debugging [#130](https://github.com/alex8088/electron-vite/issues/130)
+- fix(asset): asset path is not resolved correctly when outDir is specified [#117](https://github.com/alex8088/electron-vite/issues/117)
+- fix: specified renderer outDir is not parsed correctly
+- fix(bytecodePlugin): not work in monorepo [#128](https://github.com/alex8088/electron-vite/issues/128)
+- perf: build compatilibity target for Electron 23
+- perf: print log
+- chore(deps): update all non-major dependencies
+- chore(deps): update vite to 4.1.4
+- chore(deps): update rollup to 3.18
+- chore(deps): update magic-string to 0.30.0
+
+### v1.0.19 (_2023-02-06_)
+
+- feat(bytecodePlugin): protect strings [#91](https://github.com/alex8088/electron-vite/issues/91)
+- fix(bytecodePlugin): escape protected strings (thanks to [@jeremyben](https://github.com/jeremyben))
+
+### v1.0.18 (_2023-01-16_)
+
+- feat(asset): support for WebAssembly in the main process
+- fix(asset): wasm must be suffixed with `?loader`
+
+### v1.0.17 (_2023-01-08_)
+
+- feat: static asset handling
+- fix: output duplicate log in vscode debugging [#75](https://github.com/alex8088/electron-vite/issues/75)
+- chore(bytecodePlugin): KiB to kB
+- chore(worker): use toRelativePath helper
+- chore(deps): update all non-major dependencies
+- chore(deps): update vite to 4.0.4
+
+### v1.0.16 (_2022-12-12_)
+
+- feat: vite 4.x support [#69](https://github.com/alex8088/electron-vite/issues/69)
+- fix: `NODE_ENV` is incorrect in vite 4.x [#70](https://github.com/alex8088/electron-vite/issues/70)
+- fix: invalid output format check
+- fix: output format check
+- chore(deps): update all non-major dependencies
+- chore(deps): update esbuild and magic-string
+- chore(deps): update vite to 4.0.0
+
+### v1.0.15 (_2022-12-05_)
+
+- feat: support mode and command conditional config
+- feat: specify env prefixes for vite's loadEnv and export it
+- perf: build compatilibity target for Electron 22
+- perf: do not externalize node builtin modules for the renderer [#61](https://github.com/alex8088/electron-vite/issues/61)
+
 ### v1.0.14 (_2022-11-13_)
 
 - fix(bytecodePlugin): replace bytecode module regex
@@ -8,7 +397,7 @@
 - refactor: plugins
 - fix(swcPlugin): unreachable code
 - fix(bytecodePlugin): bytecode loader injection and chunk module parsing errors [#49](https://github.com/alex8088/electron-vite/issues/49)
-- fix: incorrect replace __dirname/__filename in config file
+- fix: incorrect replace `__dirname`/`__filename` in config file
 - fix: output format error under multiple entries
 
 ### v1.0.12 (_2022-11-02_)

README.md

@@ -9,17 +9,17 @@
 
 <p align="center">
 <img src="https://img.shields.io/npm/v/electron-vite?color=6988e6&label=version">
-<img src="https://img.shields.io/github/license/alex8088/wx-vue-next?color=blue" alt="license" />
+<img src="https://img.shields.io/github/license/alex8088/electron-vite?color=blue" alt="license" />
 </p>
 
 <p align="center">
-<a href="https://evite.netlify.app/">Documentation</a> |
+<a href="https://electron-vite.org">Documentation</a> |
-<a href="https://evite.netlify.app/guide/">Getting Started</a> |
+<a href="https://electron-vite.org/guide">Getting Started</a> |
 <a href="https://github.com/alex8088/quick-start/tree/master/packages/create-electron">create-electron</a>
 </p>
 
 <p align="center">
-<a href="https://cn-evite.netlify.app/">中文文档</a>
+<a href="https://cn.electron-vite.org">中文文档</a>
 </p>
 
 <br />
@@ -28,14 +28,13 @@
 ## Features
 
 - ⚡️ [Vite](https://vitejs.dev) powered and use the same way.
-- 🛠 Centralized Configuration.
+- 🛠 Pre-configure with sensible defaults optimized for Electron.
-- 💡 Pre-configured for Electron, don't worry about configuration.
+- 💡 Optimize asset handling for Electron main process.
-- 🚀 Fast HMR for renderers.
+- 🚀 Fast HMR & hot reloading.
-- 🔥 Hot reloading for main process and preload scripts.
+- 🔥 Isolated build for multi-entry application development.
-- 🔌 Easy to debug.
+- ✨ Simplify multi-threading development.
-- 🔒 Compile to v8 bytecode to protect source code.
+- 🔒 Compile code to v8 bytecode to protect source code.
-- 🏷️ Support for TypeScript decorators.
+- 🔌 Easy to debug in IDEs such as VSCode or WebStorm.
-- 🔩 Easy to use workers and fork process.
 - 📦 Out-of-the-box support for TypeScript, Vue, React, Svelte, SolidJS and more.
 
 ## Usage
@@ -60,7 +59,7 @@ In a project where `electron-vite` is installed, you can use `electron-vite` bin
 }
 ```
 
-### Configuring
+### Configuration
 
 When running `electron-vite` from the command line, electron-vite will automatically try to resolve a config file named `electron.vite.config.js` inside project root. The most basic config file looks like this:
 
@@ -79,97 +78,24 @@ export default {
 }
 ```
 
-### Use HMR in Renderer
-
-In order to use the renderer process HMR, you need to use the `environment variables` to determine whether the window browser loads a local html file or a local URL.
-
-```js
-function createWindow() {
-  // Create the browser window
-  const mainWindow = new BrowserWindow({
-    width: 800,
-    height: 600,
-    webPreferences: {
-      preload: path.join(__dirname, '../preload/index.js')
-    }
-  })
-
-  // Load the remote URL for development or the local html file for production
-  if (!app.isPackaged && process.env['ELECTRON_RENDERER_URL']) {
-    mainWindow.loadURL(process.env['ELECTRON_RENDERER_URL'])
-  } else {
-    mainWindow.loadFile(path.join(__dirname, '../renderer/index.html'))
-  }
-}
-```
-
-### Hot Reloading
-
-Hot reloading refers to quickly rebuilding and restarting the Electron app when the main process or preload scripts module changes. In fact, it's not really hot reloading, but similar. It also brings a good development experience to developers.
-
-There are two ways to enable it:
-
-1. Use CLI option `-w` or `--watch`, e.g. `electron-vite dev --watch`. This is the preferred way, it's more flexible.
-
-2. Use configuration option `build.watch` and set to `{}`. In addition, more watcher options can be configured, see [WatcherOptions](https://rollupjs.org/guide/en/#watch-options).
-
-### Debugging in VSCode
-
-Add a file `.vscode/launch.json` with the following configuration:
-
-```json
-{
-  "version": "0.2.0",
-  "configurations": [
-    {
-      "name": "Debug Main Process",
-      "type": "node",
-      "request": "launch",
-      "cwd": "${workspaceRoot}",
-      "runtimeExecutable": "${workspaceRoot}/node_modules/.bin/electron-vite",
-      "windows": {
-        "runtimeExecutable": "${workspaceRoot}/node_modules/.bin/electron-vite.cmd"
-      },
-      "runtimeArgs": ["--sourcemap"]
-    }
-  ]
-}
-```
-
-Then, set some breakpoints in `main.ts` (source code), and start debugging in the `VSCode Debug View`.
-
-### Source Code Protection
-
-Use the plugin `bytecodePlugin` to enable it:
-
-```js
-import { defineConfig, bytecodePlugin } from 'electron-vite'
-
-export default defineConfig({
-  main: {
-    plugins: [bytecodePlugin()]
-  },
-  preload: {
-    plugins: [bytecodePlugin()]
-  },
-  renderer: {
-    // ...
-  }
-})
-```
-
-`bytecodePlugin` only works in production and supports the main process and preload scripts.
-
-Also, you can learn more by playing with the [example](https://github.com/alex8088/electron-vite-bytecode-example).
-
 ### Getting Started
 
 Clone the [electron-vite-boilerplate](https://github.com/alex8088/electron-vite-boilerplate) or use the [create-electron](https://github.com/alex8088/quick-start/tree/master/packages/create-electron) tool to scaffold your project.
 
 ```bash
-npm init @quick-start/electron
+npm create @quick-start/electron@latest
 ```
 
+Currently supported template presets include:
+
+|                                                 JavaScript                                                 |                                                    TypeScript                                                    |
+| :--------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------: |
+| [vanilla](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/vanilla) | [vanilla-ts](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/vanilla-ts) |
+|     [vue](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/vue)     |     [vue-ts](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/vue-ts)     |
+|   [react](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/react)   |   [react-ts](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/react-ts)   |
+|  [svelte](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/svelte)  |  [svelte-ts](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/svelte-ts)  |
+|   [solid](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/solid)   |   [solid-ts](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/solid-ts)   |
+
 ## Contribution
 
 See [Contributing Guide](CONTRIBUTING.md).

api-extractor.json

@@ -1,52 +0,0 @@
-{
-  "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
-
-  "mainEntryPointFilePath": "./dist/types/index.d.ts",
-
-  "dtsRollup": {
-    "enabled": true,
-    "untrimmedFilePath": "",
-    "publicTrimmedFilePath": "./dist/index.d.ts"
-  },
-
-  "apiReport": {
-    "enabled": false
-  },
-
-  "docModel": {
-    "enabled": false
-  },
-
-  "tsdocMetadata": {
-    "enabled": false
-  },
-
-  "messages": {
-    "compilerMessageReporting": {
-      "default": {
-        "logLevel": "warning"
-      }
-    },
-
-    "extractorMessageReporting": {
-      "default": {
-        "logLevel": "warning",
-        "addToApiReportFile": true
-      },
-
-      "ae-missing-release-tag": {
-        "logLevel": "none"
-      }
-    },
-
-    "tsdocMessageReporting": {
-      "default": {
-        "logLevel": "warning"
-      },
-
-      "tsdoc-undefined-tag": {
-        "logLevel": "none"
-      }
-    }
-  }
-}

bin/bytecode-compiler.cjs

@@ -0,0 +1,15 @@
+const vm = require('node:vm')
+const v8 = require('node:v8')
+
+v8.setFlagsFromString('--no-lazy')
+v8.setFlagsFromString('--no-flush-bytecode')
+
+const params = ['exports', 'require', 'module', '__filename', '__dirname']
+
+module.exports = function compile(code) {
+  if (typeof code !== 'string') throw new TypeError('Compilation source must be a string')
+  const { cachedData } = vm.compileFunction(code, params, { produceCachedData: true })
+  if (!Buffer.isBuffer(cachedData)) throw new Error('V8 did not produce cached data')
+  // Explicit wire format works across both Node IPC and Electron structured clone.
+  return { sourceLength: code.length, cachedData: cachedData.toString('base64') }
+}

bin/electron-bytecode-main.cjs

@@ -0,0 +1,109 @@
+const { app, BrowserWindow, ipcMain } = require('electron')
+const path = require('node:path')
+const RpcPeer = require('./rpc-peer.cjs')
+const compile = require('./bytecode-compiler.cjs')
+
+if (process.platform === 'darwin') {
+  app.dock.hide()
+}
+
+const channel = 'electron-vite:bytecode:rpc'
+const readyChannel = 'electron-vite:bytecode:ready'
+let win
+let rendererRPC
+let rendererStarting
+let stopping = false
+
+function fail(error) {
+  console.error(error)
+  parentRPC.close(error)
+  rendererRPC?.close(error)
+  app.exit(1)
+}
+
+const parentRPC = new RpcPeer(
+  message =>
+    new Promise((resolve, reject) => {
+      if (!process.connected || !process.send) return reject(new Error('Parent IPC is disconnected'))
+      process.send(message, error => (error ? reject(error) : resolve()))
+    })
+)
+
+function createRenderer() {
+  return new Promise((resolve, reject) => {
+    let ready = false
+    const timer = setTimeout(() => finish(new Error('Compiler preload readiness timed out')), 30000)
+    function finish(error) {
+      clearTimeout(timer)
+      ipcMain.removeListener(readyChannel, onReady)
+      if (error) reject(error)
+      else {
+        ready = true
+        resolve()
+      }
+    }
+    function onReady(event) {
+      if (event.sender === win.webContents) finish()
+    }
+    function onFailure(error) {
+      if (stopping) return
+      if (ready) fail(error)
+      else finish(error)
+    }
+    ipcMain.on(readyChannel, onReady)
+    win = new BrowserWindow({
+      show: false,
+      webPreferences: {
+        preload: path.join(__dirname, 'electron-bytecode-preload.cjs'),
+        sandbox: false,
+        contextIsolation: true
+      }
+    })
+    rendererRPC = new RpcPeer(message => {
+      if (win.isDestroyed()) throw new Error('Compiler window is closed')
+      win.webContents.send(channel, message)
+    })
+    ipcMain.on(channel, (event, message) => {
+      if (!win.isDestroyed() && event.sender === win.webContents) void rendererRPC.receive(message)
+    })
+    win.webContents.on('preload-error', (_event, _path, error) => onFailure(error))
+    win.webContents.on('render-process-gone', (_event, details) => {
+      onFailure(new Error(`Compiler renderer exited: ${details.reason}`))
+    })
+    win.on('closed', () => onFailure(new Error('Compiler window closed unexpectedly')))
+    win.loadURL('data:text/html,<!doctype html><html></html>').catch(onFailure)
+  })
+}
+
+const initialized = app.whenReady().then(() => true)
+parentRPC.register('ready', () => initialized)
+parentRPC.register('compile', async (target, code) => {
+  await initialized
+  if (target === 'main') return compile(code)
+  if (target === 'preload') {
+    rendererStarting ||= createRenderer()
+    await rendererStarting
+    return rendererRPC.request('compile', code)
+  }
+  throw new Error(`Invalid bytecode target: ${target}`)
+})
+initialized.catch(fail)
+
+process.on('message', message => {
+  if (message?.type === 'shutdown') {
+    stopping = true
+    app.quit()
+  } else {
+    void parentRPC.receive(message)
+  }
+})
+process.on('disconnect', () => {
+  stopping = true
+  app.quit()
+})
+app.on('before-quit', () => {
+  stopping = true
+  parentRPC.close()
+  rendererRPC?.close()
+})
+if (!process.send) fail(new Error('Bytecode compiler must be launched with an IPC channel'))

bin/electron-bytecode-preload.cjs

@@ -0,0 +1,10 @@
+const { ipcRenderer } = require('electron')
+const RpcPeer = require('./rpc-peer.cjs')
+const compile = require('./bytecode-compiler.cjs')
+
+const channel = 'electron-vite:bytecode:rpc'
+const rpc = new RpcPeer(message => ipcRenderer.send(channel, message))
+rpc.register('ready', () => true)
+rpc.register('compile', compile)
+ipcRenderer.on(channel, (_event, message) => void rpc.receive(message))
+ipcRenderer.send('electron-vite:bytecode:ready')

bin/electron-vite.js

@@ -24,7 +24,7 @@ if (debugIndex > 0) {
 }
 
 function run() {
-  require('../dist/cli')
+  import('../dist/cli.js')
 }
 
 run()

bin/rpc-peer.cjs

@@ -0,0 +1,89 @@
+// Transport-independent peer. Messages must be JSON serializable.
+class RpcPeer {
+  constructor(send, timeout = 30000) {
+    this.send = send
+    this.timeout = timeout
+    this.methods = new Map()
+    this.pending = new Map()
+    this.nextId = 0
+    this.closed = false
+  }
+
+  register(cmd, method) {
+    this.methods.set(cmd, method)
+    return this
+  }
+
+  request(cmd, ...args) {
+    if (this.closed) return Promise.reject(new Error('RPC connection is closed'))
+    const invocationId = this.nextId++
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pending.delete(invocationId)
+        reject(new Error(`RPC request timed out: ${cmd}`))
+      }, this.timeout)
+      this.pending.set(invocationId, { resolve, reject, timer })
+      Promise.resolve()
+        .then(() => this.send({ type: 'request', invocationId, cmd, args }))
+        .catch(error => {
+          const pending = this.pending.get(invocationId)
+          if (!pending) return
+          clearTimeout(timer)
+          this.pending.delete(invocationId)
+          reject(error)
+        })
+    })
+  }
+
+  async receive(message) {
+    if (this.closed || !message || !Number.isSafeInteger(message.invocationId)) return
+    const { type, invocationId } = message
+    if (type === 'response') {
+      const pending = this.pending.get(invocationId)
+      if (!pending) return
+      this.pending.delete(invocationId)
+      clearTimeout(pending.timer)
+      if (message.error) {
+        const error = new Error(message.error.message)
+        error.name = message.error.name || 'Error'
+        if (message.error.stack) error.stack = message.error.stack
+        pending.reject(error)
+      } else {
+        pending.resolve(message.result)
+      }
+      return
+    }
+    if (type !== 'request' || typeof message.cmd !== 'string' || !Array.isArray(message.args)) return
+    const response = { type: 'response', invocationId }
+    try {
+      const method = this.methods.get(message.cmd)
+      if (!method) throw new Error(`Invalid method: ${message.cmd}`)
+      response.result = await method(...message.args)
+    } catch (error) {
+      response.error = {
+        name: error instanceof Error ? error.name : 'Error',
+        message: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : undefined
+      }
+    }
+    if (!this.closed) {
+      try {
+        await this.send(response)
+      } catch (error) {
+        this.close(error)
+      }
+    }
+  }
+
+  close(error = new Error('RPC connection is closed')) {
+    this.closed = true
+    for (const pending of this.pending.values()) {
+      clearTimeout(pending.timer)
+      pending.reject(error)
+    }
+    this.pending.clear()
+    this.methods.clear()
+  }
+}
+
+module.exports = RpcPeer

eslint.config.js

@@ -0,0 +1,69 @@
+// ts-check
+import { defineConfig } from 'eslint/config'
+import eslint from '@eslint/js'
+import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended'
+import globals from 'globals'
+import tseslint from 'typescript-eslint'
+
+export default defineConfig(
+  { ignores: ['**/node_modules', '**/dist', '**/bin'] },
+  eslint.configs.recommended,
+  tseslint.configs.recommended,
+  eslintPluginPrettierRecommended,
+  {
+    languageOptions: {
+      parser: tseslint.parser,
+      parserOptions: {
+        sourceType: 'module',
+        ecmaVersion: 2022
+      },
+      globals: {
+        ...globals.es2021,
+        ...globals.node
+      }
+    },
+    settings: {
+      node: {
+        version: '^20.19.0 || >=22.12.0'
+      }
+    },
+    rules: {
+      'prettier/prettier': 'warn',
+      'no-empty': ['warn', { allowEmptyCatch: true }],
+      '@typescript-eslint/ban-ts-comment': ['error', { 'ts-ignore': 'allow-with-description' }],
+      '@typescript-eslint/explicit-function-return-type': [
+        'error',
+        {
+          allowExpressions: true,
+          allowTypedFunctionExpressions: true,
+          allowHigherOrderFunctions: true,
+          allowIIFEs: true
+        }
+      ],
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-empty-function': ['error', { allow: ['arrowFunctions'] }],
+      '@typescript-eslint/no-empty-object-type': ['error', { allowInterfaces: 'always' }],
+      '@typescript-eslint/no-explicit-any': 'error',
+      '@typescript-eslint/no-non-null-assertion': 'off',
+      '@typescript-eslint/no-require-imports': 'error',
+      '@typescript-eslint/no-unused-expressions': [
+        'error',
+        {
+          allowShortCircuit: true,
+          allowTaggedTemplates: true,
+          allowTernary: true
+        }
+      ],
+      '@typescript-eslint/consistent-type-imports': [
+        'error',
+        { prefer: 'type-imports', disallowTypeAnnotations: false }
+      ]
+    }
+  },
+  {
+    files: ['*.js', '*.mjs'],
+    rules: {
+      '@typescript-eslint/explicit-function-return-type': 'off'
+    }
+  }
+)

node.d.ts

@@ -1,5 +1,112 @@
 // node worker
 declare module '*?nodeWorker' {
-  import { Worker, WorkerOptions } from 'node:worker_threads'
+  import type { Worker, WorkerOptions } from 'node:worker_threads'
   export default function (options: WorkerOptions): Worker
 }
+
+// module path
+declare module '*?modulePath' {
+  const src: string
+  export default src
+}
+
+// node asset
+declare module '*?asset' {
+  const src: string
+  export default src
+}
+
+declare module '*?asset&asarUnpack' {
+  const src: string
+  export default src
+}
+
+declare module '*.json?commonjs-external&asset' {
+  const src: string
+  export default src
+}
+
+// native node module
+declare module '*.node' {
+  /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
+  const node: any
+  export default node
+}
+
+// node wasm
+declare module '*.wasm?loader' {
+  const loadWasm: (options?: WebAssembly.Imports) => Promise<WebAssembly.Instance>
+  export default loadWasm
+}
+
+// build-in process env
+declare namespace NodeJS {
+  interface ProcessEnv {
+    /**
+     * Vite's dev server address for Electron renderers.
+     */
+    readonly ELECTRON_RENDERER_URL?: string
+  }
+}
+
+// Refer to Vite's ImportMeta type declarations
+// <https://github.com/vitejs/vite/blob/main/packages/vite/types/importMeta.d.ts>
+
+interface ImportMetaEnv {
+  MODE: string
+  DEV: boolean
+  PROD: boolean
+}
+
+interface ImportGlobOptions<Eager extends boolean, AsType extends string> {
+  /**
+   * Import type for the import url.
+   */
+  as?: AsType
+  /**
+   * Import as static or dynamic
+   *
+   * @default false
+   */
+  eager?: Eager
+  /**
+   * Import only the specific named export. Set to `default` to import the default export.
+   */
+  import?: string
+  /**
+   * Custom queries
+   */
+  query?: string | Record<string, string | number | boolean>
+  /**
+   * Search files also inside `node_modules/` and hidden directories (e.g. `.git/`). This might have impact on performance.
+   *
+   * @default false
+   */
+  exhaustive?: boolean
+}
+
+interface KnownAsTypeMap {
+  raw: string
+  url: string
+  worker: Worker
+}
+
+interface ImportGlobFunction {
+  /**
+   * Import a list of files with a glob pattern.
+   *
+   * https://vitejs.dev/guide/features.html#glob-import
+   */
+  <Eager extends boolean, As extends string, T = As extends keyof KnownAsTypeMap ? KnownAsTypeMap[As] : unknown>(
+    glob: string | string[],
+    options?: ImportGlobOptions<Eager, As>
+  ): (Eager extends true ? true : false) extends true ? Record<string, T> : Record<string, () => Promise<T>>
+  <M>(glob: string | string[], options?: ImportGlobOptions<false, string>): Record<string, () => Promise<M>>
+  <M>(glob: string | string[], options: ImportGlobOptions<true, string>): Record<string, M>
+}
+
+interface ImportMeta {
+  url: string
+  readonly env: ImportMetaEnv
+  glob: ImportGlobFunction
+}

package.json

@@ -1,9 +1,17 @@
 {
   "name": "electron-vite",
-  "version": "1.0.14",
+  "version": "6.0.0",
   "description": "Electron build tooling based on Vite",
-  "main": "dist/index.js",
+  "type": "module",
-  "types": "dist/index.d.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./node": {
+      "types": "./node.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
   "bin": {
     "electron-vite": "bin/electron-vite.js"
   },
@@ -13,8 +21,9 @@
     "node.d.ts"
   ],
   "engines": {
-    "node": "^14.18.0 || >=16.0.0"
+    "node": "^20.19.0 || >=22.12.0"
   },
+  "packageManager": "pnpm@10.12.4",
   "author": "Alex Wei<https://github.com/alex8088>",
   "license": "MIT",
   "repository": {
@@ -24,7 +33,7 @@
   "bugs": {
     "url": "https://github.com/alex8088/electron-vite/issues"
   },
-  "homepage": "https://github.com/alex8088/electron-vite#readme",
+  "homepage": "https://electron-vite.org",
   "keywords": [
     "electron",
     "vite",
@@ -33,9 +42,9 @@
   ],
   "scripts": {
     "format": "prettier --write .",
-    "lint": "eslint --ext .ts src/**",
+    "lint": "eslint --cache .",
     "typecheck": "tsc --noEmit",
-    "build": "npm run lint && node scripts/build.js"
+    "build": "pnpm run lint && rollup -c rollup.config.ts --configPlugin typescript"
   },
   "simple-git-hooks": {
     "pre-commit": "npx lint-staged",
@@ -52,7 +61,7 @@
   },
   "peerDependencies": {
     "@swc/core": "^1.0.0",
-    "vite": "^3.0.0"
+    "vite": "^6.0.0 || ^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {
     "@swc/core": {
@@ -60,31 +69,40 @@
     }
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.33.5",
+    "@eslint/js": "^10.0.1",
-    "@rollup/plugin-node-resolve": "^15.0.1",
+    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-typescript": "^9.0.2",
+    "@rollup/plugin-node-resolve": "^16.0.3",
-    "@swc/core": "^1.3.11",
+    "@rollup/plugin-typescript": "^12.3.0",
-    "@types/node": "16.18.3",
+    "@swc/core": "^1.16.2",
-    "@typescript-eslint/eslint-plugin": "^5.42.0",
+    "@types/babel__core": "^7.20.5",
-    "@typescript-eslint/parser": "^5.42.0",
+    "@types/node": "^22.20.4",
-    "eslint": "^8.26.0",
+    "eslint": "^10.11.0",
-    "eslint-config-prettier": "^8.5.0",
+    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^4.2.1",
+    "eslint-plugin-prettier": "^5.5.6",
-    "fs-extra": "^10.1.0",
+    "globals": "^17.12.0",
-    "lint-staged": "^13.0.3",
+    "lint-staged": "^17.5.1",
-    "prettier": "^2.7.1",
+    "prettier": "^3.9.9",
-    "rollup": "^2.79.1",
+    "rollup": "^4.63.5",
-    "simple-git-hooks": "^2.8.1",
+    "rollup-plugin-dts": "^6.5.1",
-    "tslib": "^2.4.1",
+    "rollup-plugin-rm": "^1.0.2",
-    "typescript": "^4.8.4",
+    "simple-git-hooks": "^2.14.0",
-    "vite": "^3.2.2"
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.70.1",
+    "vite": "^8.3.1"
   },
   "dependencies": {
-    "@babel/core": "^7.19.6",
+    "@babel/core": "^7.29.7",
-    "@babel/plugin-transform-arrow-functions": "^7.18.6",
+    "@babel/plugin-transform-arrow-functions": "^7.29.7",
-    "cac": "^6.7.14",
+    "cac": "^7.0.0",
-    "esbuild": "^0.15.12",
+    "magic-string": "^1.4.2",
-    "magic-string": "^0.26.7",
+    "picocolors": "^1.1.1",
-    "picocolors": "^1.0.0"
+    "rolldown": "~1.2.10"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "@swc/core",
+      "simple-git-hooks"
+    ]
   }
 }

rollup.config.ts

@@ -0,0 +1,42 @@
+import { createRequire } from 'node:module'
+import { defineConfig } from 'rollup'
+import ts from '@rollup/plugin-typescript'
+import resolve from '@rollup/plugin-node-resolve'
+import json from '@rollup/plugin-json'
+import dts from 'rollup-plugin-dts'
+import rm from 'rollup-plugin-rm'
+
+const require = createRequire(import.meta.url)
+const pkg = require('./package.json')
+
+const external = [...Object.keys(pkg.dependencies || {}), ...Object.keys(pkg.peerDependencies || {})]
+
+export default defineConfig([
+  {
+    input: ['src/index.ts', 'src/cli.ts'],
+    output: [
+      {
+        dir: 'dist',
+        entryFileNames: '[name].js',
+        chunkFileNames: 'chunks/lib-[hash].js',
+        format: 'es'
+      }
+    ],
+    external,
+    plugins: [
+      rm('dist', 'buildStart'),
+      json(),
+      ts({ compilerOptions: { rootDir: 'src', outDir: 'dist', declaration: true, declarationDir: 'dist/types' } }),
+      resolve()
+    ],
+    treeshake: {
+      moduleSideEffects: false
+    }
+  },
+  {
+    input: 'dist/types/index.d.ts',
+    external: ['vite'],
+    output: [{ file: pkg.types, format: 'es' }],
+    plugins: [dts(), rm('dist/types', 'buildEnd')]
+  }
+])

scripts/build.js

@@ -1,67 +0,0 @@
-const path = require('path')
-const colors = require('picocolors')
-const fs = require('fs-extra')
-const rollup = require('rollup')
-const typescript = require('@rollup/plugin-typescript')
-const { nodeResolve } = require('@rollup/plugin-node-resolve')
-const { Extractor, ExtractorConfig } = require('@microsoft/api-extractor')
-
-;(async () => {
-  const dist = path.resolve(__dirname, '../dist')
-
-  await fs.remove(dist)
-
-  console.log()
-  console.log(colors.bold(colors.yellow(`Rolling up ts code...`)))
-
-  const pkg = require('../package.json')
-
-  const external = ['esbuild', ...Object.keys(pkg.dependencies || {}), ...Object.keys(pkg.peerDependencies || {})]
-
-  const bundle = await rollup.rollup({
-    input: {
-      index: path.resolve(__dirname, '../src/index.ts'),
-      cli: path.resolve(__dirname, '../src/cli.ts')
-    },
-    external,
-    plugins: [
-      typescript({
-        tsconfig: path.resolve(__dirname, '../tsconfig.json')
-      }),
-      nodeResolve()
-    ],
-    treeshake: {
-      moduleSideEffects: false
-    }
-  })
-  await bundle.write({
-    dir: dist,
-    entryFileNames: '[name].js',
-    chunkFileNames: 'chunks/lib-[hash].js',
-    format: 'cjs'
-  })
-
-  console.log(colors.bold(colors.yellow(`Rolling up type definitions...`)))
-
-  if (pkg.types) {
-    const extractorConfig = ExtractorConfig.loadFileAndPrepare(path.resolve(__dirname, '../api-extractor.json'))
-    const extractorResult = Extractor.invoke(extractorConfig, {
-      localBuild: true,
-      showVerboseMessages: true
-    })
-
-    if (extractorResult.succeeded) {
-      console.log(colors.green('API Extractor completed successfully'))
-    } else {
-      console.error(
-        `API Extractor completed with ${extractorResult.errorCount} errors` +
-          ` and ${extractorResult.warningCount} warnings`
-      )
-      process.exitCode = 1
-    }
-  }
-
-  await fs.remove(path.resolve(dist, 'types'))
-
-  console.log(colors.green(`Build ${pkg.name}@${pkg.version} successfully`))
-})()

scripts/verifyCommit.js

@@ -1,13 +1,13 @@
 // Invoked on the commit-msg git hook by simple-git-hooks.
 
-const colors = require('picocolors')
+import colors from 'picocolors'
-const fs = require('fs')
+import fs from 'node:fs'
 
 const msgPath = process.argv[2]
 const msg = fs.readFileSync(msgPath, 'utf-8').trim()
 
 const commitRE =
-  /^(revert: )?(feat|fix|docs|dx|style|refactor|perf|test|workflow|build|ci|chore|types|wip|release)(\(.+\))?: .{1,50}/
+  /^(revert: )?(feat|fix|docs|dx|style|refactor|perf|test|workflow|build|ci|chore|types|wip|release)(\(.+\))?!?: .{1,50}/
 
 if (!commitRE.test(msg)) {
   console.log()

src/build.ts

@@ -1,33 +1,56 @@
-import { build as viteBuild } from 'vite'
+import { build as viteBuild, mergeConfig } from 'vite'
-import { InlineConfig, resolveConfig } from './config'
+import { type InlineConfig, type MainViteConfig, type PreloadViteConfig, resolveConfig } from './config'
+import { BytecodeCompiler } from './bytecodeCompiler'
+import { asyncFlatten } from './utils'
+
+async function usesBytecode(config?: MainViteConfig | PreloadViteConfig): Promise<boolean> {
+  if (!config) return false
+  if (config.build?.bytecode) return true
+  const plugins = await asyncFlatten(config.plugins || [])
+  return plugins.some(plugin => plugin && typeof plugin === 'object' && plugin.name === 'vite:bytecode')
+}
 
 /**
  * Bundles the electron app for production.
  */
 export async function build(inlineConfig: InlineConfig = {}): Promise<void> {
   process.env.NODE_ENV_ELECTRON_VITE = 'production'
-  const config = await resolveConfig(inlineConfig, 'build', 'production')
+
-  if (config.config) {
+  const bytecodeCompiler = new BytecodeCompiler()
-    const mainViteConfig = config.config?.main
+  const config = await resolveConfig(
-    if (mainViteConfig) {
+    mergeConfig(inlineConfig, {
-      if (mainViteConfig.build?.watch) {
+      plugins: [{ name: 'vite:electron-bytecode-build', api: { compiler: bytecodeCompiler } }]
-        mainViteConfig.build.watch = null
+    }),
+    'build',
+    'production'
+  )
+
+  if (!config.config) {
+    return
   }
-      await viteBuild(mainViteConfig)
+
+  const hasBytecode = (await usesBytecode(config.config.main)) || (await usesBytecode(config.config.preload))
+
+  const buildTargets = async (): Promise<void> => {
+    // Build targets in order: main -> preload -> renderer
+    for (const target of ['main', 'preload', 'renderer'] as const) {
+      const viteConfig = config.config?.[target]
+      if (viteConfig) {
+        // Disable watch mode in production builds
+        if (viteConfig.build?.watch) {
+          viteConfig.build.watch = null
         }
-    const preloadViteConfig = config.config?.preload
+        await viteBuild(viteConfig)
-    if (preloadViteConfig) {
-      if (preloadViteConfig.build?.watch) {
-        preloadViteConfig.build.watch = null
       }
-      await viteBuild(preloadViteConfig)
     }
-    const rendererViteConfig = config.config?.renderer
-    if (rendererViteConfig) {
-      if (rendererViteConfig.build?.watch) {
-        rendererViteConfig.build.watch = null
-      }
-      await viteBuild(rendererViteConfig)
   }
+
+  if (!hasBytecode) return buildTargets()
+
+  try {
+    await bytecodeCompiler.start()
+    await buildTargets()
+  } finally {
+    await bytecodeCompiler.stop()
   }
 }

src/bytecodeCompiler.ts

@@ -0,0 +1,188 @@
+import { type ChildProcess, spawn } from 'node:child_process'
+import path from 'node:path'
+import { createRequire } from 'node:module'
+import { getElectronPath } from './electron'
+
+const require = createRequire(import.meta.url)
+const RPC_TIMEOUT = 30_000
+const SHUTDOWN_TIMEOUT = 3_000
+
+export type BytecodeCompileResult = {
+  sourceLength: number
+  /** Base64-encoded V8 cachedData; decode with Buffer.from(cachedData, 'base64'). */
+  cachedData: string
+}
+
+export type BytecodeTarget = 'main' | 'preload'
+
+type CompilerResponse = {
+  type: 'response'
+  invocationId: number
+  result?: unknown
+  error?: { name: string; message: string; stack?: string }
+}
+
+type PendingRequest = {
+  resolve: (value: unknown) => void
+  reject: (reason: Error) => void
+  timer: ReturnType<typeof setTimeout>
+}
+
+export class BytecodeCompiler {
+  private ps?: ChildProcess
+  private rpcMap = new Map<number, PendingRequest>()
+  private invocationId = 0
+  private starting?: Promise<void>
+  private stopping?: Promise<void>
+  private ready = false
+  private stderr = ''
+
+  start(): Promise<void> {
+    if (this.stopping) return Promise.reject(new Error('BytecodeCompiler is stopping'))
+    if (this.starting) return this.starting
+    if (this.ready) return Promise.resolve()
+    if (this.ps) return Promise.reject(new Error('Previous Electron process has not closed; await stop() first'))
+    this.starting = this.initialize().finally(() => {
+      this.starting = undefined
+    })
+    return this.starting
+  }
+
+  private async initialize(): Promise<void> {
+    const env: NodeJS.ProcessEnv = { ...process.env, ELECTRON_VITE_RPC: 'true' }
+    delete env.ELECTRON_RUN_AS_NODE
+    this.stderr = ''
+    const compilerPath = path.join(
+      path.dirname(require.resolve('electron-vite/package.json')),
+      'bin',
+      'electron-bytecode-main.cjs'
+    )
+    const ps = spawn(getElectronPath(), [compilerPath], {
+      stdio: ['ignore', 'ignore', 'pipe', 'ipc'],
+      windowsHide: true,
+      env
+    })
+    this.ps = ps
+    if (ps.stderr) {
+      ps.stderr.setEncoding('utf8')
+      ps.stderr.on('data', (chunk: string) => {
+        if (this.ps === ps) this.stderr = (this.stderr + chunk).slice(-64 * 1024)
+      })
+    }
+    ps.on('message', (message: CompilerResponse) => {
+      if (this.ps !== ps || !message || message.type !== 'response') return
+      const pending = this.rpcMap.get(message.invocationId)
+      if (!pending) return
+      clearTimeout(pending.timer)
+      this.rpcMap.delete(message.invocationId)
+      if (message.error) {
+        const error = new Error(message.error.message)
+        error.name = message.error.name
+        if (message.error.stack) error.stack = message.error.stack
+        pending.reject(error)
+      } else pending.resolve(message.result)
+    })
+    ps.on('error', error => {
+      if (this.ps === ps) this.rejectPending(error)
+    })
+    ps.on('disconnect', () => {
+      if (this.ps === ps) this.rejectPending(new Error('Electron IPC disconnected'))
+    })
+    ps.on('exit', (code, signal) => {
+      if (this.ps === ps) this.rejectPending(new Error('Electron exited (code ' + code + ', signal ' + signal + ')'))
+    })
+    ps.on('close', () => {
+      if (this.ps === ps) {
+        this.rejectPending(new Error('Electron process closed'))
+        this.ps = undefined
+      }
+    })
+    try {
+      await this.sendRequest('ready', [])
+      if (!ps.connected || this.stopping) throw new Error('Electron stopped during initialization')
+      this.ready = true
+    } catch (error) {
+      await this.stop()
+      throw error
+    }
+  }
+
+  compile(target: BytecodeTarget, code: string): Promise<BytecodeCompileResult> {
+    return this.request<BytecodeCompileResult>('compile', target, code)
+  }
+
+  async request<T = unknown>(cmd: string, ...args: unknown[]): Promise<T> {
+    if (!this.ready || this.stopping) throw new Error('BytecodeCompiler is not ready; await start() first')
+    return this.sendRequest(cmd, args) as Promise<T>
+  }
+
+  private sendRequest(cmd: string, args: unknown[]): Promise<unknown> {
+    const ps = this.ps
+    if (!ps?.connected) return Promise.reject(new Error('Electron IPC is not connected'))
+    const invocationId = this.invocationId++
+    return new Promise((resolve, reject) => {
+      const fail = (error: Error): void => {
+        const pending = this.rpcMap.get(invocationId)
+        if (!pending) return
+        clearTimeout(pending.timer)
+        this.rpcMap.delete(invocationId)
+        reject(this.withStderr(error))
+      }
+      const timer = setTimeout(() => fail(new Error('Electron RPC timed out: ' + cmd)), RPC_TIMEOUT)
+      this.rpcMap.set(invocationId, { resolve, reject, timer })
+      try {
+        ps.send({ type: 'request', invocationId, cmd, args }, error => {
+          if (error) fail(error)
+        })
+      } catch (error) {
+        fail(error instanceof Error ? error : new Error(String(error)))
+      }
+    })
+  }
+
+  private rejectPending(error: Error): void {
+    this.ready = false
+    if (this.rpcMap.size) this.withStderr(error)
+    for (const pending of this.rpcMap.values()) {
+      clearTimeout(pending.timer)
+      pending.reject(error)
+    }
+    this.rpcMap.clear()
+  }
+
+  private withStderr(error: Error): Error {
+    const stderr = this.stderr.trim()
+    if (stderr) {
+      const stack = error.stack
+      error.message += '\n' + stderr
+      if (stack) error.stack = stack + '\n' + stderr
+    }
+    return error
+  }
+
+  stop(): Promise<void> {
+    if (this.stopping) return this.stopping
+    this.rejectPending(new Error('BytecodeCompiler stopped'))
+    const ps = this.ps
+    if (!ps) return Promise.resolve()
+    this.stopping = new Promise<void>(resolve => {
+      const timer = setTimeout(() => ps.kill('SIGKILL'), SHUTDOWN_TIMEOUT)
+      ps.once('close', () => {
+        clearTimeout(timer)
+        resolve()
+      })
+      if (ps.connected) {
+        try {
+          ps.send({ type: 'shutdown' }, error => {
+            if (error) ps.kill()
+          })
+        } catch {
+          ps.kill()
+        }
+      } else ps.kill()
+    }).finally(() => {
+      this.stopping = undefined
+    })
+    return this.stopping
+  }
+}

src/cli.ts

@@ -1,7 +1,8 @@
 import { cac } from 'cac'
 import colors from 'picocolors'
-import { LogLevel, createLogger } from 'vite'
+import { type LogLevel, createLogger } from 'vite'
-import { InlineConfig } from './config'
+import type { InlineConfig } from './config'
+import { version } from '../package.json'
 
 const cli = cac('electron-vite')
 
@@ -24,6 +25,20 @@ interface GlobalCLIOptions {
   w?: boolean
   watch?: boolean
   outDir?: string
+  entry?: string
+}
+
+interface DevCLIOptions {
+  inspect?: boolean | string
+  inspectBrk?: boolean | string
+  remoteDebuggingPort?: string
+  noSandbox?: boolean
+  rendererOnly?: boolean
+}
+
+interface PreviewCLIOptions {
+  noSandbox?: boolean
+  skipBuild?: boolean
 }
 
 function createInlineConfig(root: string, options: GlobalCLIOptions): InlineConfig {
@@ -52,6 +67,7 @@ cli
   .option('--ignoreConfigWarning', `[boolean] ignore config warning`)
   .option('--sourcemap', `[boolean] output source maps for debug (default: false)`)
   .option('--outDir <dir>', `[string] output directory (default: out)`)
+  .option('--entry <file>', `[string] specify electron entry file`)
 
 // dev
 cli
@@ -59,12 +75,41 @@ cli
   .alias('serve')
   .alias('dev')
   .option('-w, --watch', `[boolean] rebuilds when main process or preload script modules have changed on disk`)
-  .action(async (root: string, options: GlobalCLIOptions) => {
+  .option('--inspect [port]', `[boolean | number] enable V8 inspector on the specified port`)
+  .option('--inspectBrk [port]', `[boolean | number] enable V8 inspector on the specified port`)
+  .option('--remoteDebuggingPort <port>', `[string] port for remote debugging`)
+  .option('--noSandbox', `[boolean] forces renderer process to run un-sandboxed`)
+  .option('--rendererOnly', `[boolean] only dev server for the renderer`)
+  .action(async (root: string, options: DevCLIOptions & GlobalCLIOptions) => {
+    if (options.remoteDebuggingPort) {
+      process.env.REMOTE_DEBUGGING_PORT = options.remoteDebuggingPort
+    }
+
+    if (options.inspect) {
+      process.env.V8_INSPECTOR_PORT = typeof options.inspect === 'number' ? `${options.inspect}` : '5858'
+    }
+
+    if (options.inspectBrk) {
+      process.env.V8_INSPECTOR_BRK_PORT = typeof options.inspectBrk === 'number' ? `${options.inspectBrk}` : '5858'
+    }
+
+    if (options.noSandbox) {
+      process.env.NO_SANDBOX = '1'
+    }
+
+    if (options['--']) {
+      process.env.ELECTRON_CLI_ARGS = JSON.stringify(options['--'])
+    }
+
+    if (options.entry) {
+      process.env.ELECTRON_ENTRY = options.entry
+    }
+
     const { createServer } = await import('./server')
     const inlineConfig = createInlineConfig(root, options)
 
     try {
-      await createServer(inlineConfig)
+      await createServer(inlineConfig, { rendererOnly: options.rendererOnly })
     } catch (e) {
       const error = e as Error
       createLogger(options.logLevel).error(
@@ -80,6 +125,10 @@ cli.command('build [root]', 'build for production').action(async (root: string,
   const { build } = await import('./build')
   const inlineConfig = createInlineConfig(root, options)
 
+  if (options.entry) {
+    process.env.ELECTRON_ENTRY = options.entry
+  }
+
   try {
     await build(inlineConfig)
   } catch (e) {
@@ -92,11 +141,24 @@ cli.command('build [root]', 'build for production').action(async (root: string,
 // preview
 cli
   .command('preview [root]', 'start electron app to preview production build')
+  .option('--noSandbox', `[boolean] forces renderer process to run un-sandboxed`)
   .option('--skipBuild', `[boolean] skip build`)
-  .action(async (root: string, options: { skipBuild?: boolean } & GlobalCLIOptions) => {
+  .action(async (root: string, options: PreviewCLIOptions & GlobalCLIOptions) => {
     const { preview } = await import('./preview')
     const inlineConfig = createInlineConfig(root, options)
 
+    if (options.noSandbox) {
+      process.env.NO_SANDBOX = '1'
+    }
+
+    if (options.entry) {
+      process.env.ELECTRON_ENTRY = options.entry
+    }
+
+    if (options['--']) {
+      process.env.ELECTRON_CLI_ARGS = JSON.stringify(options['--'])
+    }
+
     try {
       await preview(inlineConfig, { skipBuild: options.skipBuild })
     } catch (e) {
@@ -107,6 +169,6 @@ cli
   })
 
 cli.help()
-cli.version(require('../package.json').version)
+cli.version(version)
 
 cli.parse()

src/config.ts

@@ -1,66 +1,138 @@
 import path from 'node:path'
-import fs from 'node:fs'
-import { pathToFileURL } from 'node:url'
-import { createRequire } from 'node:module'
 import colors from 'picocolors'
 import {
   type UserConfig as ViteConfig,
-  type UserConfigExport as UserViteConfigExport,
   type ConfigEnv,
+  type PluginOption,
   type Plugin,
+  type BuildEnvironmentOptions as ViteBuildOptions,
   type LogLevel,
   createLogger,
   mergeConfig,
   normalizePath
 } from 'vite'
-import { build } from 'esbuild'
 
-import { electronMainVitePlugin, electronPreloadVitePlugin, electronRendererVitePlugin } from './plugins/electron'
+import {
+  electronMainConfigPresetPlugin,
+  electronMainConfigValidatorPlugin,
+  electronPreloadConfigPresetPlugin,
+  electronPreloadConfigValidatorPlugin,
+  electronRendererConfigPresetPlugin,
+  electronRendererConfigValidatorPlugin
+} from './plugins/electron'
+import assetPlugin from './plugins/asset'
 import workerPlugin from './plugins/worker'
-import { isObject, dynamicImport } from './utils'
+import importMetaPlugin from './plugins/importMeta'
+import esmShimPlugin from './plugins/esmShim'
+import modulePathPlugin from './plugins/modulePath'
+import isolateEntriesPlugin from './plugins/isolateEntries'
+import { type ExternalOptions, externalizeDepsPlugin } from './plugins/externalizeDeps'
+import { type BytecodeOptions, bytecodePlugin } from './plugins/bytecode'
+import { isObject, isFilePathESM, cloneConfig, asyncFlatten } from './utils'
+import { findConfigFile, bundleConfigFile, loadConfigFormBundledFile } from './load'
 
 export { defineConfig as defineViteConfig } from 'vite'
 
+interface IsolatedEntriesMixin {
+  /**
+   * Build each entry point as an isolated bundle without code splitting.
+   *
+   * When enabled, each entry will include all its dependencies inline,
+   * preventing automatic code splitting across entries and ensuring each
+   * output file is fully standalone.
+   *
+   * **Important**: When using `isolatedEntries` in `preload` config, you
+   * should also disable `build.externalizeDeps` to ensure third-party dependencies
+   * from `node_modules` are bundled together, which is required for Electron
+   * sandbox support.
+   *
+   * @experimental
+   * @default false
+   */
+  isolatedEntries?: boolean
+}
+
+interface ExternalizeDepsMixin {
+  /**
+   * Options pass on to `externalizeDeps` plugin in electron-vite.
+   *
+   * Automatically externalize dependencies.
+   *
+   * @default true
+   */
+  externalizeDeps?: boolean | ExternalOptions
+}
+
+interface BytecodeMixin {
+  /**
+   * Options pass on to `bytecode` plugin in electron-vite.
+   * https://electron-vite.org/guide/source-code-protection#options
+   *
+   * Compiles source code to v8 bytecode and works only in the `build` command.
+   */
+  bytecode?: boolean | BytecodeOptions
+}
+
+interface MainBuildOptions extends ViteBuildOptions, ExternalizeDepsMixin, BytecodeMixin {}
+
+interface PreloadBuildOptions extends ViteBuildOptions, ExternalizeDepsMixin, BytecodeMixin, IsolatedEntriesMixin {}
+
+interface RendererBuildOptions extends ViteBuildOptions, IsolatedEntriesMixin {}
+
+interface BaseViteConfig<T> extends Omit<ViteConfig, 'build'> {
+  /**
+   * Build specific options
+   */
+  build?: T
+}
+
+export interface MainViteConfig extends BaseViteConfig<MainBuildOptions> {}
+
+export interface PreloadViteConfig extends BaseViteConfig<PreloadBuildOptions> {}
+
+export interface RendererViteConfig extends BaseViteConfig<RendererBuildOptions> {}
+
 export interface UserConfig {
   /**
    * Vite config options for electron main process
    *
-   * https://cn.vitejs.dev/config/
+   * @see https://vitejs.dev/config/
    */
-  main?: ViteConfig & { configFile?: string | false }
+  main?: MainViteConfig
   /**
    * Vite config options for electron renderer process
    *
-   * https://cn.vitejs.dev/config/
+   * @see https://vitejs.dev/config/
    */
-  renderer?: ViteConfig & { configFile?: string | false }
+  renderer?: RendererViteConfig
   /**
-   * Vite config options for electron preload files
+   * Vite config options for electron preload scripts
    *
-   * https://cn.vitejs.dev/config/
+   * @see https://vitejs.dev/config/
    */
-  preload?: ViteConfig & { configFile?: string | false }
+  preload?: PreloadViteConfig
 }
 
-export interface UserConfigSchema {
+export type ElectronViteConfigFnObject = (env: ConfigEnv) => UserConfig
-  /**
+export type ElectronViteConfigFnPromise = (env: ConfigEnv) => Promise<UserConfig>
-   * Vite config options for electron main process
+export type ElectronViteConfigFn = (env: ConfigEnv) => UserConfig | Promise<UserConfig>
-   *
+
-   * https://cn.vitejs.dev/config/
+export type ElectronViteConfigExport =
+  UserConfig | Promise<UserConfig> | ElectronViteConfigFnObject | ElectronViteConfigFnPromise | ElectronViteConfigFn
+
+/**
+ * Type helper to make it easier to use `electron.vite.config.*`
+ * accepts a direct {@link UserConfig} object, or a function that returns it.
+ * The function receives a object that exposes two properties:
+ * `command` (either `'build'` or `'serve'`), and `mode`.
  */
-  main?: UserViteConfigExport
+export function defineConfig(config: UserConfig): UserConfig
-  /**
+export function defineConfig(config: Promise<UserConfig>): Promise<UserConfig>
-   * Vite config options for electron renderer process
+export function defineConfig(config: ElectronViteConfigFnObject): ElectronViteConfigFnObject
-   *
+export function defineConfig(config: ElectronViteConfigFnPromise): ElectronViteConfigFnPromise
-   * https://cn.vitejs.dev/config/
+export function defineConfig(config: ElectronViteConfigExport): ElectronViteConfigExport
-   */
+export function defineConfig(config: ElectronViteConfigExport): ElectronViteConfigExport {
-  renderer?: UserViteConfigExport
+  return config
-  /**
-   * Vite config options for electron preload files
-   *
-   * https://cn.vitejs.dev/config/
-   */
-  preload?: UserViteConfigExport
 }
 
 export type InlineConfig = Omit<ViteConfig, 'base'> & {
@@ -69,17 +141,6 @@ export type InlineConfig = Omit<ViteConfig, 'base'> & {
   ignoreConfigWarning?: boolean
 }
 
-export type UserConfigFn = () => UserConfigSchema | Promise<UserConfigSchema>
-export type UserConfigExport = UserConfigSchema | Promise<UserConfigSchema> | UserConfigFn
-
-/**
- * Type helper to make it easier to use `electron.vite.config.ts`
- * accepts a direct {@link UserConfig} object, or a function that returns it.
- */
-export function defineConfig(config: UserConfigExport): UserConfigExport {
-  return config
-}
-
 export interface ResolvedConfig {
   config?: UserConfig
   configFile?: string
@@ -94,13 +155,10 @@ export async function resolveConfig(
   const config = inlineConfig
   const mode = inlineConfig.mode || defaultMode
 
-  config.mode = mode
+  process.env.NODE_ENV = defaultMode
 
-  if (mode === 'production') {
+  const userConfig: UserConfig | undefined = {}
-    process.env.NODE_ENV = 'production'
-  }
 
-  let userConfig: UserConfig | undefined
   let configFileDependencies: string[] = []
 
   let { configFile } = config
@@ -109,6 +167,7 @@ export async function resolveConfig(
       mode,
       command
     }
+
     const loadResult = await loadConfigFromFile(
       configEnv,
       configFile,
@@ -116,52 +175,30 @@ export async function resolveConfig(
       config.logLevel,
       config.ignoreConfigWarning
     )
+
     if (loadResult) {
       const root = config.root
       delete config.root
       delete config.configFile
 
+      config.configFile = false
+
       const outDir = config.build?.outDir
 
-      if (loadResult.config.main) {
+      const { main, preload, renderer } = loadResult.config
-        const mainViteConfig: ViteConfig = mergeConfig(loadResult.config.main, deepClone(config))
 
-        if (outDir) {
+      if (main) {
-          resetOutDir(mainViteConfig, outDir, 'main')
+        userConfig.main = await new MainConfigFactory(main, config, { outDir, root }).build()
       }
 
-        mergePlugins(mainViteConfig, [...electronMainVitePlugin({ root }), workerPlugin()])
+      if (preload) {
-
+        userConfig.preload = await new PreloadConfigFactory(preload, config, { outDir, root }).build()
-        loadResult.config.main = mainViteConfig
-        loadResult.config.main.configFile = false
       }
 
-      if (loadResult.config.preload) {
+      if (renderer) {
-        const preloadViteConfig: ViteConfig = mergeConfig(loadResult.config.preload, deepClone(config))
+        userConfig.renderer = await new RendererConfigFactory(renderer, config, { outDir, root }).build()
-
-        if (outDir) {
-          resetOutDir(preloadViteConfig, outDir, 'preload')
-        }
-        mergePlugins(preloadViteConfig, electronPreloadVitePlugin({ root }))
-
-        loadResult.config.preload = preloadViteConfig
-        loadResult.config.preload.configFile = false
       }
 
-      if (loadResult.config.renderer) {
-        const rendererViteConfig: ViteConfig = mergeConfig(loadResult.config.renderer, deepClone(config))
-
-        if (outDir) {
-          resetOutDir(rendererViteConfig, outDir, 'renderer')
-        }
-
-        mergePlugins(rendererViteConfig, electronRendererVitePlugin({ root }))
-
-        loadResult.config.renderer = rendererViteConfig
-        loadResult.config.renderer.configFile = false
-      }
-
-      userConfig = loadResult.config
       configFile = loadResult.path
       configFileDependencies = loadResult.dependencies
     }
@@ -176,8 +213,109 @@ export async function resolveConfig(
   return resolved
 }
 
-function deepClone<T>(data: T): T {
+export abstract class ConfigFactory<T extends MainViteConfig | PreloadViteConfig | RendererViteConfig> {
-  return JSON.parse(JSON.stringify(data))
+  constructor(
+    protected readonly baseConfig: T,
+    protected readonly inlineConfig: InlineConfig,
+    protected readonly options: { outDir?: string; root?: string }
+  ) {
+    baseConfig.build ??= {}
+    baseConfig.build.rolldownOptions ??= baseConfig.build.rollupOptions
+  }
+
+  async build(cleanMode?: boolean): Promise<T> {
+    /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
+    const config = mergeConfig(cloneConfig(this.baseConfig) as any, cloneConfig(this.inlineConfig)) as T
+
+    config.mode = this.inlineConfig.mode || config.mode || process.env.NODE_ENV
+
+    if (this.options.outDir) {
+      resetOutDir(config, this.options.outDir, this.processType())
+    }
+
+    const builtinPlugins = await this.resolveBuiltinPlugins(config, cleanMode)
+
+    config.plugins = builtinPlugins.concat(config.plugins || [])
+
+    return config
+  }
+
+  protected abstract processType(): 'main' | 'preload' | 'renderer'
+
+  protected abstract resolveBuiltinPlugins(config: T, cleanMode?: boolean): Promise<PluginOption[]>
+}
+
+export class MainConfigFactory extends ConfigFactory<MainViteConfig> {
+  protected processType(): 'main' {
+    return 'main'
+  }
+
+  protected async resolveBuiltinPlugins(config: MainViteConfig, cleanMode?: boolean): Promise<PluginOption[]> {
+    const configDrivenPlugins: PluginOption[] = await resolveConfigDrivenPlugins(config)
+
+    return cleanMode
+      ? [
+          electronMainConfigPresetPlugin({ root: this.options.root }),
+          assetPlugin(),
+          importMetaPlugin(),
+          esmShimPlugin(),
+          ...configDrivenPlugins
+        ]
+      : [
+          electronMainConfigPresetPlugin({ root: this.options.root }),
+          electronMainConfigValidatorPlugin(),
+          assetPlugin(),
+          workerPlugin(),
+          modulePathPlugin(this),
+          importMetaPlugin(),
+          esmShimPlugin(),
+          ...configDrivenPlugins
+        ]
+  }
+}
+
+export class PreloadConfigFactory extends ConfigFactory<PreloadViteConfig> {
+  protected processType(): 'preload' {
+    return 'preload'
+  }
+
+  protected async resolveBuiltinPlugins(config: PreloadViteConfig, cleanMode?: boolean): Promise<PluginOption[]> {
+    const configDrivenPlugins: PluginOption[] = await resolveConfigDrivenPlugins(config)
+
+    return cleanMode
+      ? [
+          electronPreloadConfigPresetPlugin({ root: this.options.root }),
+          assetPlugin(),
+          importMetaPlugin(),
+          esmShimPlugin(),
+          ...configDrivenPlugins
+        ]
+      : [
+          electronPreloadConfigPresetPlugin({ root: this.options.root }),
+          electronPreloadConfigValidatorPlugin(),
+          assetPlugin(),
+          importMetaPlugin(),
+          esmShimPlugin(),
+          ...configDrivenPlugins,
+          ...(config.build?.isolatedEntries ? [isolateEntriesPlugin(this)] : [])
+        ]
+  }
+}
+
+export class RendererConfigFactory extends ConfigFactory<RendererViteConfig> {
+  protected processType(): 'renderer' {
+    return 'renderer'
+  }
+
+  protected async resolveBuiltinPlugins(config: RendererViteConfig, cleanMode?: boolean): Promise<PluginOption[]> {
+    return cleanMode
+      ? [electronRendererConfigPresetPlugin({ root: this.options.root })]
+      : [
+          electronRendererConfigPresetPlugin({ root: this.options.root }),
+          electronRendererConfigValidatorPlugin(),
+          ...(config.build?.isolatedEntries ? [isolateEntriesPlugin(this)] : [])
+        ]
+  }
 }
 
 function resetOutDir(config: ViteConfig, outDir: string, subOutDir: string): void {
@@ -192,12 +330,37 @@ function resetOutDir(config: ViteConfig, outDir: string, subOutDir: string): voi
   }
 }
 
-function mergePlugins(config: ViteConfig, plugins: Plugin[]): void {
+async function resolveConfigDrivenPlugins(config: MainViteConfig | PreloadViteConfig): Promise<PluginOption[]> {
-  const userPlugins = config.plugins || []
+  const userPlugins = (await asyncFlatten(config.plugins || [])).filter(Boolean) as Plugin[]
-  config.plugins = userPlugins.concat(plugins)
+
+  const configDrivenPlugins: PluginOption[] = []
+
+  const hasExternalizeDepsPlugin = userPlugins.some(p => p.name === 'vite:externalize-deps')
+  if (!hasExternalizeDepsPlugin) {
+    const externalOptions = config.build?.externalizeDeps ?? true
+    if (externalOptions) {
+      isOptions<ExternalOptions>(externalOptions)
+        ? configDrivenPlugins.push(externalizeDepsPlugin(externalOptions))
+        : configDrivenPlugins.push(externalizeDepsPlugin())
+    }
+  }
+
+  const hasBytecodePlugin = userPlugins.some(p => p.name === 'vite:bytecode')
+  if (!hasBytecodePlugin) {
+    const bytecodeOptions = config.build?.bytecode
+    if (bytecodeOptions) {
+      isOptions<BytecodeOptions>(bytecodeOptions)
+        ? configDrivenPlugins.push(bytecodePlugin(bytecodeOptions))
+        : configDrivenPlugins.push(bytecodePlugin())
+    }
+  }
+
+  return configDrivenPlugins
 }
 
-const CONFIG_FILE_NAME = 'electron.vite.config'
+function isOptions<T extends object>(value: boolean | T): value is T {
+  return typeof value === 'object' && value !== null
+}
 
 export async function loadConfigFromFile(
   configEnv: ConfigEnv,
@@ -214,9 +377,7 @@ export async function loadConfigFromFile(
     throw new Error(`config file cannot be named ${configFile}.`)
   }
 
-  const resolvedPath = configFile
+  const resolvedPath = configFile ? path.resolve(configFile) : findConfigFile(configRoot)
-    ? path.resolve(configFile)
-    : findConfigFile(configRoot, ['js', 'ts', 'mjs', 'cjs', 'mts', 'cts'])
 
   if (!resolvedPath) {
     return {
@@ -226,186 +387,33 @@ export async function loadConfigFromFile(
     }
   }
 
-  // electron does not support adding type: "module" to package.json
+  const isESM = isFilePathESM(resolvedPath)
-  let isESM = false
-  if (/\.m[jt]s$/.test(resolvedPath) || resolvedPath.endsWith('.ts')) {
-    isESM = true
-  }
 
   try {
-    const bundled = await bundleConfigFile(resolvedPath, isESM)
+    const { code, dependencies } = await bundleConfigFile(resolvedPath, isESM)
-    const userConfig = await loadConfigFormBundledFile(configRoot, resolvedPath, bundled.code, isESM)
+    const configExport = await loadConfigFormBundledFile<ElectronViteConfigExport>(resolvedPath, code, isESM)
 
-    const config = await (typeof userConfig === 'function' ? userConfig() : userConfig)
+    const config = await (typeof configExport === 'function' ? configExport(configEnv) : configExport)
     if (!isObject(config)) {
       throw new Error(`config must export or return an object`)
     }
 
-    const configRequired: string[] = []
+    if (!ignoreConfigWarning) {
-
+      const missingFields = ['main', 'renderer', 'preload'].filter(field => !config[field])
-    let mainConfig
+      if (missingFields.length > 0) {
-    if (config.main) {
+        createLogger(logLevel).warn(
-      const mainViteConfig = config.main
+          `${colors.yellow(colors.bold('(!)'))} ${colors.yellow(`${missingFields.join(' and ')} config is missing`)}\n`
-      mainConfig = await (typeof mainViteConfig === 'function' ? mainViteConfig(configEnv) : mainViteConfig)
+        )
-      if (!isObject(mainConfig)) {
-        throw new Error(`main config must export or return an object`)
       }
-    } else {
-      configRequired.push('main')
-    }
-
-    let rendererConfig
-    if (config.renderer) {
-      const rendererViteConfig = config.renderer
-      rendererConfig = await (typeof rendererViteConfig === 'function'
-        ? rendererViteConfig(configEnv)
-        : rendererViteConfig)
-      if (!isObject(rendererConfig)) {
-        throw new Error(`renderer config must export or return an object`)
-      }
-    } else {
-      configRequired.push('renderer')
-    }
-
-    let preloadConfig
-    if (config.preload) {
-      const preloadViteConfig = config.preload
-      preloadConfig = await (typeof preloadViteConfig === 'function' ? preloadViteConfig(configEnv) : preloadViteConfig)
-      if (!isObject(preloadConfig)) {
-        throw new Error(`preload config must export or return an object`)
-      }
-    } else {
-      configRequired.push('preload')
-    }
-
-    if (!ignoreConfigWarning && configRequired.length > 0) {
-      createLogger(logLevel).warn(colors.yellow(`${configRequired.join(' and ')} config is missing`))
     }
 
     return {
       path: normalizePath(resolvedPath),
-      config: {
+      config,
-        main: mainConfig,
+      dependencies
-        renderer: rendererConfig,
-        preload: preloadConfig
-      },
-      dependencies: bundled.dependencies
     }
   } catch (e) {
     createLogger(logLevel).error(colors.red(`failed to load config from ${resolvedPath}`), { error: e as Error })
     throw e
   }
 }
-
-function findConfigFile(configRoot: string, extensions: string[]): string {
-  for (const ext of extensions) {
-    const configFile = path.resolve(configRoot, `${CONFIG_FILE_NAME}.${ext}`)
-    if (fs.existsSync(configFile)) {
-      return configFile
-    }
-  }
-  return ''
-}
-
-async function bundleConfigFile(fileName: string, isESM: boolean): Promise<{ code: string; dependencies: string[] }> {
-  const dirnameVarName = '__electron_vite_injected_dirname'
-  const filenameVarName = '__electron_vite_injected_filename'
-  const importMetaUrlVarName = '__electron_vite_injected_import_meta_url'
-  const result = await build({
-    absWorkingDir: process.cwd(),
-    entryPoints: [fileName],
-    write: false,
-    target: ['node14.18', 'node16'],
-    platform: 'node',
-    bundle: true,
-    format: isESM ? 'esm' : 'cjs',
-    sourcemap: false,
-    metafile: true,
-    define: {
-      __dirname: dirnameVarName,
-      __filename: filenameVarName,
-      'import.meta.url': importMetaUrlVarName
-    },
-    plugins: [
-      {
-        name: 'externalize-deps',
-        setup(build): void {
-          build.onResolve({ filter: /.*/ }, args => {
-            const id = args.path
-            if (id[0] !== '.' && !path.isAbsolute(id)) {
-              return {
-                external: true
-              }
-            }
-            return null
-          })
-        }
-      },
-      {
-        name: 'replace-import-meta',
-        setup(build): void {
-          build.onLoad({ filter: /\.[cm]?[jt]s$/ }, async args => {
-            const contents = await fs.promises.readFile(args.path, 'utf8')
-            const injectValues =
-              `const ${dirnameVarName} = ${JSON.stringify(path.dirname(args.path))};` +
-              `const ${filenameVarName} = ${JSON.stringify(args.path)};` +
-              `const ${importMetaUrlVarName} = ${JSON.stringify(pathToFileURL(args.path).href)};`
-
-            return {
-              loader: args.path.endsWith('ts') ? 'ts' : 'js',
-              contents: injectValues + contents
-            }
-          })
-        }
-      }
-    ]
-  })
-  const { text } = result.outputFiles[0]
-  return {
-    code: text,
-    dependencies: result.metafile ? Object.keys(result.metafile.inputs) : []
-  }
-}
-
-interface NodeModuleWithCompile extends NodeModule {
-  /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
-  _compile(code: string, filename: string): any
-}
-
-const _require = createRequire(import.meta.url)
-async function loadConfigFormBundledFile(
-  configRoot: string,
-  configFile: string,
-  bundledCode: string,
-  isESM: boolean
-): Promise<UserConfigExport> {
-  if (isESM) {
-    const fileNameTmp = path.resolve(configRoot, `${CONFIG_FILE_NAME}.${Date.now()}.mjs`)
-    fs.writeFileSync(fileNameTmp, bundledCode)
-
-    const fileUrl = pathToFileURL(fileNameTmp)
-    try {
-      return (await dynamicImport(fileUrl)).default
-    } finally {
-      try {
-        fs.unlinkSync(fileNameTmp)
-      } catch {}
-    }
-  } else {
-    const extension = path.extname(configFile)
-    const realFileName = fs.realpathSync(configFile)
-    const loaderExt = extension in _require.extensions ? extension : '.js'
-    const defaultLoader = _require.extensions[loaderExt]!
-    _require.extensions[loaderExt] = (module: NodeModule, filename: string): void => {
-      if (filename === realFileName) {
-        ;(module as NodeModuleWithCompile)._compile(bundledCode, filename)
-      } else {
-        defaultLoader(module, filename)
-      }
-    }
-    delete _require.cache[_require.resolve(configFile)]
-    const raw = _require(configFile)
-    _require.extensions[loaderExt] = defaultLoader
-    return raw.__esModule ? raw.default : raw
-  }
-}

src/electron.ts

@@ -1,25 +1,25 @@
 import path from 'node:path'
 import fs from 'node:fs'
 import { createRequire } from 'node:module'
-import { type ChildProcessWithoutNullStreams, spawn } from 'node:child_process'
+import { type ChildProcess, spawn } from 'node:child_process'
-import { type Logger } from 'vite'
+import { loadPackageData } from './utils'
 
 const _require = createRequire(import.meta.url)
 
 const ensureElectronEntryFile = (root = process.cwd()): void => {
-  const pkg = path.join(root, 'package.json')
+  if (process.env.ELECTRON_ENTRY) return
-  if (fs.existsSync(pkg)) {
+  const pkg = loadPackageData()
-    const main = require(pkg).main
+  if (pkg) {
-    if (!main) {
+    if (!pkg.main) {
-      throw new Error('not found an entry point to electorn app, please add main field for your package.json')
+      throw new Error('No entry point found for electron app, please add a "main" field to package.json')
     } else {
-      const entryPath = path.resolve(root, main)
+      const entryPath = path.resolve(root, pkg.main)
       if (!fs.existsSync(entryPath)) {
-        throw new Error(`not found the electorn app entry file: ${entryPath}`)
+        throw new Error(`No electron app entry file found: ${entryPath}`)
       }
     }
   } else {
-    throw new Error('no package.json')
+    throw new Error('Not found: package.json')
   }
 }
 
@@ -36,6 +36,16 @@ const getElectronMajorVer = (): string => {
   return majorVer
 }
 
+export function supportESM(): boolean {
+  const majorVer = getElectronMajorVer()
+  return parseInt(majorVer) >= 28
+}
+
+export function supportImportMetaPaths(): boolean {
+  const majorVer = getElectronMajorVer()
+  return parseInt(majorVer) >= 30
+}
+
 export function getElectronPath(): string {
   let electronExecPath = process.env.ELECTRON_EXEC_PATH || ''
   if (!electronExecPath) {
@@ -59,17 +69,29 @@ export function getElectronNodeTarget(): string {
   const electronVer = getElectronMajorVer()
 
   const nodeVer = {
-    '21': '16.16',
+    '44': '24.18',
-    '20': '16.15',
+    '43': '24.17',
-    '19': '16.14',
+    '42': '24.15',
-    '18': '16.13',
+    '41': '24.14',
-    '17': '16.13',
+    '40': '24.14',
-    '16': '16.9',
+    '39': '22.20',
-    '15': '16.5',
+    '38': '22.19',
-    '14': '14.17',
+    '37': '22.16',
-    '13': '14.17',
+    '36': '22.14',
-    '12': '14.16',
+    '35': '22.14',
-    '11': '12.18'
+    '34': '20.18',
+    '33': '20.18',
+    '32': '20.16',
+    '31': '20.14',
+    '30': '20.11',
+    '29': '20.9',
+    '28': '18.18',
+    '27': '18.17',
+    '26': '18.16',
+    '25': '18.15',
+    '24': '18.14',
+    '23': '18.12',
+    '22': '16.17'
   }
   if (electronVer && parseInt(electronVer) > 10) {
     let target = nodeVer[electronVer]
@@ -83,17 +105,29 @@ export function getElectronChromeTarget(): string {
   const electronVer = getElectronMajorVer()
 
   const chromeVer = {
-    '21': '106',
+    '44': '152',
-    '20': '104',
+    '43': '150',
-    '19': '102',
+    '42': '148',
-    '18': '100',
+    '41': '146',
-    '17': '98',
+    '40': '144',
-    '16': '96',
+    '39': '142',
-    '15': '94',
+    '38': '140',
-    '14': '93',
+    '37': '138',
-    '13': '91',
+    '36': '136',
-    '12': '89',
+    '35': '134',
-    '11': '87'
+    '34': '132',
+    '33': '130',
+    '32': '128',
+    '31': '126',
+    '30': '124',
+    '29': '122',
+    '28': '120',
+    '27': '118',
+    '26': '116',
+    '25': '114',
+    '24': '112',
+    '23': '110',
+    '22': '108'
   }
   if (electronVer && parseInt(electronVer) > 10) {
     let target = chromeVer[electronVer]
@@ -103,19 +137,64 @@ export function getElectronChromeTarget(): string {
   return ''
 }
 
-export function startElectron(root: string | undefined, logger: Logger): ChildProcessWithoutNullStreams {
+export function startElectron(root: string | undefined): ChildProcess {
   ensureElectronEntryFile(root)
 
   const electronPath = getElectronPath()
 
-  const ps = spawn(electronPath, ['.'])
+  const isDev = process.env.NODE_ENV_ELECTRON_VITE === 'development'
-  ps.stdout.on('data', chunk => {
+
-    chunk.toString().trim() && logger.info(chunk.toString())
+  const args: string[] = process.env.ELECTRON_CLI_ARGS ? JSON.parse(process.env.ELECTRON_CLI_ARGS) : []
-  })
+
-  ps.stderr.on('data', chunk => {
+  if (!!process.env.REMOTE_DEBUGGING_PORT && isDev) {
-    chunk.toString().trim() && logger.error(chunk.toString())
+    args.push(`--remote-debugging-port=${process.env.REMOTE_DEBUGGING_PORT}`)
-  })
+  }
-  ps.on('close', process.exit)
+
+  if (!!process.env.V8_INSPECTOR_PORT && isDev) {
+    args.push(`--inspect=${process.env.V8_INSPECTOR_PORT}`)
+  }
+
+  if (!!process.env.V8_INSPECTOR_BRK_PORT && isDev) {
+    args.push(`--inspect-brk=${process.env.V8_INSPECTOR_BRK_PORT}`)
+  }
+
+  if (process.env.NO_SANDBOX === '1') {
+    args.push('--no-sandbox')
+  }
+
+  const entry = process.env.ELECTRON_ENTRY || '.'
+
+  const ps = spawn(electronPath, [entry].concat(args), { stdio: 'inherit' })
+  // `code` is null when the child was terminated by a signal, and `process.exit` ignores
+  // its second argument, so passing the listener directly would report every crash as a
+  // successful exit. Map a signal death to a non-zero status instead.
+  ps.on('close', (code, signal) => process.exit(code ?? (signal ? 1 : 0)))
+
+  setupElectronSignalHandlers(ps)
 
   return ps
 }
+
+let electronPs: ChildProcess | undefined
+let signalHandlersRegistered = false
+
+function setupElectronSignalHandlers(child: ChildProcess): void {
+  electronPs = child
+
+  if (signalHandlersRegistered) return
+
+  const signals: NodeJS.Signals[] =
+    process.platform === 'win32' ? ['SIGINT', 'SIGTERM'] : ['SIGINT', 'SIGTERM', 'SIGHUP', 'SIGUSR2']
+
+  for (const signal of signals) {
+    process.on(signal, () => {
+      const child = electronPs
+      if (!child?.pid || child.exitCode !== null || child.signalCode !== null) return
+
+      // A previously sent signal does not mean the child has exited.
+      child.kill(signal)
+    })
+  }
+
+  signalHandlersRegistered = true
+}

src/index.ts

@@ -1,8 +1,9 @@
-export { type LogLevel, createLogger, splitVendorChunkPlugin, splitVendorChunk } from 'vite'
+export { type LogLevel, createLogger, mergeConfig } from 'vite'
 export * from './config'
 export { createServer } from './server'
 export { build } from './build'
 export { preview } from './preview'
+export { loadEnv } from './utils'
 export * from './plugins/bytecode'
 export * from './plugins/externalizeDeps'
 export * from './plugins/swc'

src/load.ts

@@ -0,0 +1,130 @@
+import path from 'node:path'
+import fs from 'node:fs'
+import { pathToFileURL } from 'node:url'
+import { createRequire } from 'node:module'
+import { rolldown } from 'rolldown'
+import type { RolldownOutput, OutputChunk } from 'rolldown'
+
+const CONFIG_FILE_NAME = 'electron.vite.config'
+
+export function findConfigFile(
+  configRoot: string,
+  extensions: string[] = ['js', 'ts', 'mjs', 'cjs', 'mts', 'cts']
+): string {
+  for (const ext of extensions) {
+    const configFile = path.resolve(configRoot, `${CONFIG_FILE_NAME}.${ext}`)
+    if (fs.existsSync(configFile)) {
+      return configFile
+    }
+  }
+  return ''
+}
+
+export async function bundleConfigFile(
+  fileName: string,
+  isESM: boolean
+): Promise<{ code: string; dependencies: string[] }> {
+  const dirnameVarName = '__electron_vite_injected_dirname'
+  const filenameVarName = '__electron_vite_injected_filename'
+  const importMetaUrlVarName = '__electron_vite_injected_import_meta_url'
+
+  const bundle = await rolldown({
+    input: path.resolve(fileName),
+    platform: 'node',
+    transform: {
+      target: 'node20',
+      define: {
+        __dirname: dirnameVarName,
+        __filename: filenameVarName,
+        'import.meta.url': importMetaUrlVarName
+      }
+    },
+    plugins: [
+      {
+        name: 'externalize-deps',
+        resolveId(id) {
+          if (id[0] !== '.' && !path.isAbsolute(id)) {
+            return { id, external: true }
+          }
+          return null
+        }
+      },
+      {
+        name: 'inject-file-scope-variables',
+        transform: {
+          filter: { id: /\.[cm]?[jt]s$/ },
+          handler(code, id) {
+            const injectValues =
+              `const ${dirnameVarName} = ${JSON.stringify(path.dirname(id))};` +
+              `const ${filenameVarName} = ${JSON.stringify(id)};` +
+              `const ${importMetaUrlVarName} = ${JSON.stringify(pathToFileURL(id).href)};`
+            return { code: injectValues + code, map: null }
+          }
+        }
+      }
+    ]
+  })
+
+  let result: RolldownOutput
+  try {
+    result = await bundle.generate({
+      format: isESM ? 'esm' : 'cjs',
+      sourcemap: 'inline',
+      sourcemapPathTransform(relative, sourcemapPath) {
+        return path.resolve(path.dirname(sourcemapPath), relative)
+      },
+      codeSplitting: false
+    })
+  } finally {
+    await bundle.close()
+  }
+
+  const entryChunk = result.output.find((chunk): chunk is OutputChunk => chunk.type === 'chunk' && chunk.isEntry)
+  if (!entryChunk) {
+    throw new Error(`Failed to bundle config file: ${fileName}`)
+  }
+
+  return {
+    code: entryChunk.code,
+    dependencies: entryChunk.moduleIds.filter(id => !id.startsWith('\0'))
+  }
+}
+
+interface NodeModuleWithCompile extends NodeModule {
+  /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
+  _compile(code: string, filename: string): any
+}
+
+const _require = createRequire(import.meta.url)
+
+export async function loadConfigFormBundledFile<T>(fileName: string, bundledCode: string, isESM: boolean): Promise<T> {
+  if (isESM) {
+    const fileNameTmp = `${fileName}.${Date.now()}-${Math.random().toString(16).slice(2)}.mjs`
+    fs.writeFileSync(fileNameTmp, bundledCode)
+
+    const fileUrl = pathToFileURL(fileNameTmp)
+    try {
+      return (await import(fileUrl.href)).default
+    } finally {
+      try {
+        fs.unlinkSync(fileNameTmp)
+      } catch {}
+    }
+  } else {
+    const extension = path.extname(fileName)
+    const realFileName = fs.realpathSync(fileName)
+    const loaderExt = extension in _require.extensions ? extension : '.js'
+    const defaultLoader = _require.extensions[loaderExt]!
+    _require.extensions[loaderExt] = (module: NodeModule, filename: string): void => {
+      if (filename === realFileName) {
+        ;(module as NodeModuleWithCompile)._compile(bundledCode, filename)
+      } else {
+        defaultLoader(module, filename)
+      }
+    }
+    delete _require.cache[_require.resolve(fileName)]
+    const raw = _require(fileName)
+    _require.extensions[loaderExt] = defaultLoader
+    return raw.__esModule ? raw.default : raw
+  }
+}

src/plugins/asset.ts

@@ -0,0 +1,148 @@
+import path from 'node:path'
+import fs from 'node:fs/promises'
+import { type Plugin, type Environment, normalizePath } from 'vite'
+import MagicString from 'magic-string'
+import { cleanUrl, getHash, toRelativePath } from '../utils'
+import { supportImportMetaPaths } from '../electron'
+
+const nodeAssetRE = /__VITE_NODE_ASSET__([\w$]+)__/g
+const nodePublicAssetRE = /__VITE_NODE_PUBLIC_ASSET__([a-z\d]{8})__/g
+
+const assetImportRE = /(?:[?|&]asset(?:&|$)|\.wasm\?loader$|\.node$)/
+const assetRE = /[?|&]asset(?:&|$)/
+const assetUnpackRE = /[?|&]asset&asarUnpack$/
+
+const wasmHelperId = '\0__electron-vite-wasm-helper'
+
+const wasmHelperCode = `
+import { join } from 'path'
+import { readFile } from 'fs/promises'
+
+export default async function loadWasm(file, importObject = {}) {
+  const wasmBuffer = await readFile(join(__dirname, file))
+  const result = await WebAssembly.instantiate(wasmBuffer, importObject)
+  return result.instance
+}
+`
+
+const assetCache = new WeakMap<Environment, Map<string, string>>()
+const publicAssetPathCache = new WeakMap<Environment, Map<string, string>>()
+
+export default function assetPlugin(): Plugin {
+  const isImportMetaPathSupported = supportImportMetaPaths()
+  return {
+    name: 'vite:node-asset',
+    apply: 'build',
+    enforce: 'pre',
+    buildStart(): void {
+      publicAssetPathCache.set(this.environment, new Map())
+      assetCache.set(this.environment, new Map())
+    },
+    resolveId(id): string | void {
+      if (id === wasmHelperId) {
+        return id
+      }
+    },
+    async load(id): Promise<string | void> {
+      if (id === wasmHelperId) {
+        return wasmHelperCode
+      }
+
+      if (id.startsWith('\0') || !assetImportRE.test(id)) {
+        return
+      }
+
+      let referenceId: string
+
+      const file = cleanUrl(id)
+
+      const { publicDir } = this.environment.config
+
+      if (publicDir && file.startsWith(publicDir)) {
+        const hash = getHash(file)
+        const publicAssetPathMap = publicAssetPathCache.get(this.environment)!
+        if (!publicAssetPathMap.get(hash)) {
+          publicAssetPathMap.set(hash, file)
+        }
+        referenceId = `__VITE_NODE_PUBLIC_ASSET__${hash}__`
+      } else {
+        const cache = assetCache.get(this.environment)!
+        const cached = cache.get(file)
+        if (cached) {
+          referenceId = cached
+        } else {
+          const source = await fs.readFile(file)
+          const hash = this.emitFile({
+            type: 'asset',
+            name: path.basename(file),
+            source: source as unknown as Uint8Array
+          })
+          referenceId = `__VITE_NODE_ASSET__${hash}__`
+          cache.set(file, referenceId)
+        }
+      }
+
+      if (assetRE.test(id)) {
+        const dirnameExpr = isImportMetaPathSupported ? 'import.meta.dirname' : '__dirname'
+        if (assetUnpackRE.test(id)) {
+          return `
+          import { join } from 'path'
+          export default join(${dirnameExpr}, ${referenceId}).replace('app.asar', 'app.asar.unpacked')`
+        } else {
+          return `
+          import { join } from 'path'
+          export default join(${dirnameExpr}, ${referenceId})`
+        }
+      }
+
+      if (id.endsWith('.node')) {
+        return `export default require(${referenceId})`
+      }
+
+      if (id.endsWith('.wasm?loader')) {
+        return `
+        import loadWasm from ${JSON.stringify(wasmHelperId)}
+        export default importObject => loadWasm(${referenceId}, importObject)`
+      }
+    },
+    renderChunk(code, chunk, { sourcemap, dir }) {
+      let match: RegExpExecArray | null
+      let s: MagicString | undefined
+
+      nodeAssetRE.lastIndex = 0
+      while ((match = nodeAssetRE.exec(code))) {
+        s ||= new MagicString(code)
+        const [full, hash] = match
+        const filename = this.getFileName(hash)
+        const outputFilepath = toRelativePath(filename, chunk.fileName)
+        const replacement = JSON.stringify(outputFilepath)
+        s.overwrite(match.index, match.index + full.length, replacement, {
+          contentOnly: true
+        })
+      }
+
+      const publicAssetPathMap = publicAssetPathCache.get(this.environment)!
+
+      nodePublicAssetRE.lastIndex = 0
+      while ((match = nodePublicAssetRE.exec(code))) {
+        s ||= new MagicString(code)
+        const [full, hash] = match
+        const filename = publicAssetPathMap.get(hash)!
+        const outputFilepath = toRelativePath(filename, normalizePath(path.join(dir!, chunk.fileName)))
+        const replacement = JSON.stringify(outputFilepath)
+        s.overwrite(match.index, match.index + full.length, replacement, {
+          contentOnly: true
+        })
+      }
+
+      if (s) {
+        return {
+          code: s.toString(),
+          map: sourcemap ? s.generateMap({ hires: 'boundary' }) : null
+        }
+      }
+
+      return null
+    }
+  }
+}

src/plugins/bytecode.ts

@@ -1,266 +1,242 @@
 import path from 'node:path'
-import fs from 'node:fs'
+import { randomBytes } from 'node:crypto'
-import { spawn } from 'node:child_process'
+import { createRequire } from 'node:module'
 import colors from 'picocolors'
-import { type Plugin, type ResolvedConfig, normalizePath } from 'vite'
+import { type Plugin, type Rolldown, normalizePath } from 'vite'
-import * as babel from '@babel/core'
+import type * as Babel from '@babel/core'
 import MagicString from 'magic-string'
-import { getElectronPath } from '../electron'
+import { toRelativePath, resolveBuildOutputs } from '../utils'
+import type { BytecodeCompiler, BytecodeTarget } from '../bytecodeCompiler'
 
 // Inspired by https://github.com/bytenode/bytenode
 
-function getBytecodeCompilerPath(): string {
+const require = createRequire(import.meta.url)
-  return path.resolve(process.cwd(), 'node_modules', 'electron-vite', 'bin', 'electron-bytecode.js')
+let babel: typeof Babel | undefined
+
+function getBytecodeCompiler(plugins: readonly Plugin[]): BytecodeCompiler | undefined {
+  const plugin = plugins.find(plugin => plugin.name === 'vite:electron-bytecode-build')
+  return (plugin?.api as { compiler?: BytecodeCompiler } | undefined)?.compiler
 }
 
-function compileToBytecode(code: string): Promise<Buffer> {
+// Versioned envelope: magic/version (8), UTF-16 source length (4), module ID (16), V8 cache.
-  return new Promise((resolve, reject) => {
+// Keep our metadata separate from the private V8 cache header.
-    let data = Buffer.from([])
+async function compileToBytecode(compiler: BytecodeCompiler, target: BytecodeTarget, code: string): Promise<Buffer> {
-
+  const id = randomBytes(16)
-    const electronPath = getElectronPath()
+  // Reserve enough source space for an untruncated, per-artifact placeholder identity.
-    const bytecodePath = getBytecodeCompilerPath()
+  const source = code + '\n/*' + id.toString('hex') + '*/'
-
+  const result = await compiler.compile(target, source)
-    const proc = spawn(electronPath, [bytecodePath], {
+  const header = Buffer.alloc(28)
-      env: { ELECTRON_RUN_AS_NODE: '1' },
+  header.write('EVBC0001', 0, 'ascii')
-      stdio: ['pipe', 'pipe', 'pipe', 'ipc']
+  header.writeUInt32LE(result.sourceLength, 8)
-    })
+  id.copy(header, 12)
-
+  return Buffer.concat([header, Buffer.from(result.cachedData, 'base64')])
-    if (proc.stdin) {
-      proc.stdin.write(code)
-      proc.stdin.end()
-    }
-
-    if (proc.stdout) {
-      proc.stdout.on('data', chunk => {
-        data = Buffer.concat([data, chunk])
-      })
-      proc.stdout.on('error', err => {
-        console.error(err)
-      })
-      proc.stdout.on('end', () => {
-        resolve(data)
-      })
-    }
-
-    if (proc.stderr) {
-      proc.stderr.on('data', chunk => {
-        console.error('Error: ', chunk.toString())
-      })
-      proc.stderr.on('error', err => {
-        console.error('Error: ', err)
-      })
-    }
-
-    proc.addListener('message', message => console.log(message))
-    proc.addListener('error', err => console.error(err))
-
-    proc.on('error', err => reject(err))
-    proc.on('exit', () => {
-      resolve(data)
-    })
-  })
 }
 
 const bytecodeModuleLoaderCode = [
-  `"use strict";`,
+  '"use strict";',
-  `const fs = require("fs");`,
+  'const fs = require("node:fs");',
-  `const path = require("path");`,
+  'const path = require("node:path");',
-  `const vm = require("vm");`,
+  'const vm = require("node:vm");',
-  `const v8 = require("v8");`,
+  'const v8 = require("node:v8");',
-  `const Module = require("module");`,
+  'const Module = require("node:module");',
-  `v8.setFlagsFromString("--no-lazy");`,
+  'v8.setFlagsFromString("--no-lazy");',
-  `v8.setFlagsFromString("--no-flush-bytecode");`,
+  'v8.setFlagsFromString("--no-flush-bytecode");',
-  `const FLAG_HASH_OFFSET = 12;`,
+  'const params = ["exports", "require", "module", "__filename", "__dirname"];',
-  `const SOURCE_HASH_OFFSET = 8;`,
+  'Module._extensions[".jsc"] = Module._extensions[".cjsc"] = function (module, filename) {',
-  `let dummyBytecode;`,
+  '  const data = fs.readFileSync(filename);',
-  `function setFlagHashHeader(bytecodeBuffer) {`,
+  '  if (data.length <= 28 || data.toString("ascii", 0, 8) !== "EVBC0001") {',
-  `  if (!dummyBytecode) {`,
+  '    throw new Error("Invalid electron-vite bytecode format; rebuild the application: " + filename);',
-  `    const script = new vm.Script("", {`,
+  '  }',
-  `      produceCachedData: true`,
+  '  const length = data.readUInt32LE(8);',
-  `    });`,
+  '  const tag = "/*" + data.subarray(12, 28).toString("hex") + "*/";',
-  `    dummyBytecode = script.createCachedData();`,
+  '  if (length < tag.length || length > 0x1fffffff) {',
-  `  }`,
+  '    throw new Error("Invalid bytecode source length: " + filename);',
-  `  dummyBytecode.slice(FLAG_HASH_OFFSET, FLAG_HASH_OFFSET + 4).copy(bytecodeBuffer, FLAG_HASH_OFFSET);`,
+  '  }',
-  `};`,
+  '  const placeholder = tag + " ".repeat(length - tag.length);',
-  `function getSourceHashHeader(bytecodeBuffer) {`,
+  '  const compiledWrapper = vm.compileFunction(placeholder, params, {',
-  `  return bytecodeBuffer.slice(SOURCE_HASH_OFFSET, SOURCE_HASH_OFFSET + 4);`,
+  '    filename,',
-  `};`,
+  '    cachedData: data.subarray(28)',
-  `function buffer2Number(buffer) {`,
+  '  });',
-  `  let ret = 0;`,
+  '  if (compiledWrapper.cachedDataRejected) {',
-  `  ret |= buffer[3] << 24;`,
+  '    throw new Error("Invalid or incompatible cached data (cachedDataRejected): " + filename);',
-  `  ret |= buffer[2] << 16;`,
+  '  }',
-  `  ret |= buffer[1] << 8;`,
+  '  const require = function (id) { return module.require(id); };',
-  `  ret |= buffer[0];`,
+  '  require.resolve = function (request, options) {',
-  `  return ret;`,
+  '    return Module._resolveFilename(request, module, false, options);',
-  `};`,
+  '  };',
-  `Module._extensions[".jsc"] = function (module, filename) {`,
+  '  if (process.mainModule) require.main = process.mainModule;',
-  `  const bytecodeBuffer = fs.readFileSync(filename);`,
+  '  require.extensions = Module._extensions;',
-  `  if (!Buffer.isBuffer(bytecodeBuffer)) {`,
+  '  require.cache = Module._cache;',
-  `    throw new Error("BytecodeBuffer must be a buffer object.");`,
+  '  return compiledWrapper.call(module.exports, module.exports, require, module, filename, path.dirname(filename));',
-  `  }`,
+  '};'
-  `  setFlagHashHeader(bytecodeBuffer);`,
-  `  const length = buffer2Number(getSourceHashHeader(bytecodeBuffer));`,
-  `  let dummyCode = "";`,
-  `  if (length > 1) {`,
-  `    dummyCode = "\\"" + "\\u200b".repeat(length - 2) + "\\"";`,
-  `  }`,
-  `  const script = new vm.Script(dummyCode, {`,
-  `    filename: filename,`,
-  `    lineOffset: 0,`,
-  `    displayErrors: true,`,
-  `    cachedData: bytecodeBuffer`,
-  `  });`,
-  `  if (script.cachedDataRejected) {`,
-  `    throw new Error("Invalid or incompatible cached data (cachedDataRejected)");`,
-  `  }`,
-  `  const require = function (id) {`,
-  `    return module.require(id);`,
-  `  };`,
-  `  require.resolve = function (request, options) {`,
-  `    return Module._resolveFilename(request, module, false, options);`,
-  `  };`,
-  `  if (process.mainModule) {`,
-  `    require.main = process.mainModule;`,
-  `  }`,
-  `  require.extensions = Module._extensions;`,
-  `  require.cache = Module._cache;`,
-  `  const compiledWrapper = script.runInThisContext({`,
-  `    filename: filename,`,
-  `    lineOffset: 0,`,
-  `    columnOffset: 0,`,
-  `    displayErrors: true`,
-  `  });`,
-  `  const dirname = path.dirname(filename);`,
-  `  const args = [module.exports, require, module, filename, dirname, process, global];`,
-  `  return compiledWrapper.apply(module.exports, args);`,
-  `};`
 ]
 
+const bytecodeChunkExtensionRE = /.(jsc|cjsc)$/
+
 export interface BytecodeOptions {
-  chunkAlias?: string | string[]
+  chunkAlias?: string | string[] | RegExp
   transformArrowFunctions?: boolean
   removeBundleJS?: boolean
+  protectedStrings?: string[]
 }
 
 /**
- * Compile to v8 bytecode to protect source code.
+ * Compile source code to v8 bytecode.
+ *
+ * @deprecated use `build.bytecode` config option instead
  */
 export function bytecodePlugin(options: BytecodeOptions = {}): Plugin | null {
   if (process.env.NODE_ENV_ELECTRON_VITE !== 'production') {
     return null
   }
 
-  const { chunkAlias = [], transformArrowFunctions = true, removeBundleJS = true } = options
+  const { chunkAlias = [], transformArrowFunctions = true, removeBundleJS = true, protectedStrings = [] } = options
-  const _chunkAlias = Array.isArray(chunkAlias) ? chunkAlias : [chunkAlias]
+  const _chunkAlias = chunkAlias instanceof RegExp ? chunkAlias : Array.isArray(chunkAlias) ? chunkAlias : [chunkAlias]
 
-  const bytecodeChunks: string[] = []
-  const nonEntryChunks: string[] = []
-
-  const transformAllChunks = _chunkAlias.length === 0
   const isBytecodeChunk = (chunkName: string): boolean => {
-    return transformAllChunks || _chunkAlias.some(alias => alias === chunkName)
+    if (_chunkAlias instanceof RegExp) {
+      _chunkAlias.lastIndex = 0
+      return _chunkAlias.test(chunkName)
+    }
+    return _chunkAlias.length === 0 || _chunkAlias.some(alias => alias === chunkName)
   }
 
-  const _transform = (code: string): string => {
+  const plugins: Babel.PluginItem[] = []
-    const re = babel.transform(code, {
+
-      plugins: ['@babel/plugin-transform-arrow-functions']
+  if (transformArrowFunctions) {
-    })
+    plugins.push('@babel/plugin-transform-arrow-functions')
-    return re.code || ''
   }
 
-  const requireBytecodeLoaderStr = '"use strict";\nrequire("./bytecode-loader.js");'
+  if (protectedStrings.length > 0) {
+    plugins.push([protectStringsPlugin as Babel.PluginTarget, { protectedStrings: new Set(protectedStrings) }])
+  }
 
-  let config: ResolvedConfig
+  const shouldTransformBytecodeChunk = plugins.length !== 0
-  let useInRenderer = false
+
-  let bytecodeFiles: { name: string; size: number }[] = []
+  const _transform = (
+    code: string,
+    sourceMaps: boolean = false
+  ): { code: string; map?: Rolldown.SourceMapInput } | null => {
+    babel ??= require('@babel/core') as typeof Babel
+    const re = babel.transformSync(code, { plugins, sourceMaps })
+    return re ? { code: re.code || '', map: re.map as Rolldown.SourceMapInput } : null
+  }
+
+  const useStrict = '"use strict";'
+  const bytecodeModuleLoader = 'bytecode-loader.cjs'
+
+  let supported = false
+  let isPreload = false
+  let bytecodeCompiler: BytecodeCompiler | undefined
 
   return {
     name: 'vite:bytecode',
     apply: 'build',
     enforce: 'post',
-    configResolved(resolvedConfig): void {
+    configResolved(config): void {
-      config = resolvedConfig
+      bytecodeCompiler = getBytecodeCompiler(config.plugins)
-      useInRenderer = config.plugins.some(p => p.name === 'vite:electron-renderer-preset-config')
+      if (supported) {
-      if (useInRenderer) {
-        config.logger.warn(colors.yellow('bytecodePlugin is not support renderers'))
-      }
-    },
-    renderChunk(code, chunk): { code: string } | null {
-      if (useInRenderer) {
-        return null
-      }
-      if (chunk.type === 'chunk' && isBytecodeChunk(chunk.name)) {
-        bytecodeChunks.push(chunk.fileName)
-        if (!chunk.isEntry) {
-          nonEntryChunks.push(chunk.fileName)
-        }
-        if (transformArrowFunctions) {
-          return {
-            code: _transform(code)
-          }
-        }
-      }
-      return null
-    },
-    generateBundle(): void {
-      if (!useInRenderer && bytecodeChunks.length) {
-        this.emitFile({
-          type: 'asset',
-          source: bytecodeModuleLoaderCode.join('\n') + '\n',
-          name: 'Bytecode Loader File',
-          fileName: 'bytecode-loader.js'
-        })
-      }
-    },
-    async writeBundle(options, output): Promise<void> {
-      if (useInRenderer || bytecodeChunks.length === 0) {
         return
       }
-      const bundles = Object.keys(output)
+      isPreload = config.plugins.some(p => p.name === 'vite:electron-preload-config-preset')
-      const outDir = options.dir!
+      const useInRenderer = config.plugins.some(p => p.name === 'vite:electron-renderer-config-preset')
-      bytecodeFiles = []
+      if (useInRenderer) {
-      const pattern = nonEntryChunks.length ? nonEntryChunks.map(chunk => `(${chunk})`).join('|') : null
+        config.logger.warn(colors.yellow('bytecodePlugin does not support renderer.'))
-      const bytecodeRE = pattern ? new RegExp(`require\\(\\S*(?=(${pattern})\\S*\\))`, 'g') : null
+        return
-      const keepBundle = (chunkFileName: string): void => {
-        const newFileName = path.resolve(path.dirname(chunkFileName), `_${path.basename(chunkFileName)}`)
-        fs.renameSync(chunkFileName, newFileName)
       }
-      await Promise.all(
+      const build = config.build
-        bundles.map(async name => {
+      const outputs = resolveBuildOutputs(build.rolldownOptions.output, build.lib)
+      const output = outputs[0]
+      if (output) {
+        if (output.format === 'es') {
+          config.logger.warn(
+            colors.yellow(
+              'bytecodePlugin does not support ES module, please remove "type": "module" ' +
+                'in package.json or set build.rollupOptions.output.format (or build.rolldownOptions.output.format) to "cjs".'
+            )
+          )
+        }
+        supported = output.format === 'cjs' && !useInRenderer
+      }
+    },
+    renderChunk(code, chunk, { sourcemap }): { code: string; map?: Rolldown.SourceMapInput } | null {
+      if (supported && isBytecodeChunk(chunk.name) && shouldTransformBytecodeChunk) {
+        return _transform(code, !!sourcemap)
+      }
+      return null
+    },
+    async generateBundle(_, output): Promise<void> {
+      if (!supported) {
+        return
+      }
+      const _chunks = Object.values(output)
+      const chunks = _chunks.filter(
+        chunk => chunk.type === 'chunk' && isBytecodeChunk(chunk.name)
+      ) as Rolldown.OutputChunk[]
+
+      if (chunks.length === 0) {
+        return
+      }
+
+      const bytecodeChunks = chunks.map(chunk => chunk.fileName)
+      const nonEntryChunks = chunks.filter(chunk => !chunk.isEntry).map(chunk => path.basename(chunk.fileName))
+
+      const pattern = nonEntryChunks.map(chunk => `(${chunk})`).join('|')
+      const bytecodeRE = pattern ? new RegExp(`require\\(\\S*(?=(${pattern})\\S*\\))`, 'g') : null
+
+      const getBytecodeLoaderBlock = (chunkFileName: string): string => {
+        return `require("${toRelativePath(bytecodeModuleLoader, normalizePath(chunkFileName))}");`
+      }
+
+      let bytecodeChunkCount = 0
+
+      const bundles = Object.keys(output)
+
+      if (!bytecodeCompiler) {
+        throw new Error('Bytecode compilation requires an electron-vite build')
+      }
+      for (const name of bundles) {
         const chunk = output[name]
         if (chunk.type === 'chunk') {
           let _code = chunk.code
-            if (bytecodeRE && _code.match(bytecodeRE)) {
+          if (bytecodeRE) {
             let match: RegExpExecArray | null
-              const s = new MagicString(_code)
+            let s: MagicString | undefined
             while ((match = bytecodeRE.exec(_code))) {
+              s ||= new MagicString(_code)
               const [prefix, chunkName] = match
               const len = prefix.length + chunkName.length
               s.overwrite(match.index, match.index + len, prefix + chunkName + 'c', {
                 contentOnly: true
               })
             }
+            if (s) {
               _code = s.toString()
             }
-            const chunkFileName = path.resolve(outDir, name)
+          }
           if (bytecodeChunks.includes(name)) {
-              const bytecodeBuffer = await compileToBytecode(_code)
+            const bytecodeBuffer = await compileToBytecode(bytecodeCompiler, isPreload ? 'preload' : 'main', _code)
-              const bytecodeFileName = path.resolve(outDir, name + 'c')
+            this.emitFile({
-              fs.writeFileSync(bytecodeFileName, bytecodeBuffer)
+              type: 'asset',
-              if (chunk.isEntry) {
+              fileName: name + 'c',
+              source: bytecodeBuffer
+            })
             if (!removeBundleJS) {
-                  keepBundle(chunkFileName)
+              this.emitFile({
+                type: 'asset',
+                fileName: '_' + chunk.fileName,
+                source: chunk.code
+              })
             }
-                const code = requireBytecodeLoaderStr + `\nrequire("./${normalizePath(name + 'c')}");\n`
+            if (chunk.isEntry) {
-                fs.writeFileSync(chunkFileName, code)
+              const bytecodeLoaderBlock = getBytecodeLoaderBlock(chunk.fileName)
+              const bytecodeModuleBlock = `require("./${path.basename(name) + 'c'}");`
+              const code = `${useStrict}\n${bytecodeLoaderBlock}\n${bytecodeModuleBlock}\n`
+              chunk.code = code
             } else {
-                if (removeBundleJS) {
+              delete output[chunk.fileName]
-                  fs.unlinkSync(chunkFileName)
-                } else {
-                  keepBundle(chunkFileName)
             }
-              }
+            bytecodeChunkCount += 1
-              bytecodeFiles.push({ name: name + 'c', size: bytecodeBuffer.length })
           } else {
             if (chunk.isEntry) {
               let hasBytecodeMoudle = false
@@ -271,39 +247,113 @@ export function bytecodePlugin(options: BytecodeOptions = {}): Plugin | null {
                   break
                 }
                 const moduleInfo = this.getModuleInfo(moduleId)
-                  if (moduleInfo && !moduleInfo.isExternal) {
+                if (moduleInfo) {
                   const { importers, dynamicImporters } = moduleInfo
                   for (const importerId of importers) idsToHandle.add(importerId)
                   for (const importerId of dynamicImporters) idsToHandle.add(importerId)
                 }
               }
-                _code = hasBytecodeMoudle ? _code.replace('"use strict";', requireBytecodeLoaderStr) : _code
+              if (hasBytecodeMoudle) {
-              }
+                const loader = getBytecodeLoaderBlock(chunk.fileName)
-              fs.writeFileSync(chunkFileName, _code)
+                const strictRE = /^(#![^\n]*\n)?(["'])use strict\2;/
+                _code = strictRE.test(_code)
+                  ? _code.replace(strictRE, `$&\n${loader}`)
+                  : _code.replace(/^(#![^\n]*\n)?/, `$&${loader}\n`)
               }
             }
+            chunk.code = _code
+          }
+        }
+      }
+
+      if (bytecodeChunkCount && !_chunks.some(ass => ass.type === 'asset' && ass.fileName === bytecodeModuleLoader)) {
+        this.emitFile({
+          type: 'asset',
+          source: bytecodeModuleLoaderCode.join('\n') + '\n',
+          name: 'Bytecode Loader File',
+          fileName: bytecodeModuleLoader
         })
-      )
+      }
     },
-    closeBundle(): void {
+    writeBundle(_, output): void {
-      if (!useInRenderer) {
+      if (supported) {
-        const chunkLimit = config.build.chunkSizeWarningLimit
+        const bytecodeChunkCount = Object.keys(output).filter(chunk => bytecodeChunkExtensionRE.test(chunk)).length
-        const outDir = normalizePath(path.relative(config.root, path.resolve(config.root, config.build.outDir))) + '/'
+        this.environment.logger.info(`${colors.green(`✓`)} ${bytecodeChunkCount} chunks compiled into bytecode.`)
-        config.logger.info(`${colors.green(`✓`)} ${bytecodeFiles.length} bundles compiled into bytecode.`)
+      }
-        let longest = 0
+    }
-        bytecodeFiles.forEach(file => {
+  }
-          const len = file.name.length
+}
-          if (len > longest) longest = len
+
-        })
+interface ProtectStringsPluginState extends Babel.PluginPass {
-        bytecodeFiles.forEach(file => {
+  opts: { protectedStrings: Set<string> }
-          const kibs = file.size / 1024
+}
-          config.logger.info(
+
-            `${colors.gray(colors.white(colors.dim(outDir)))}${colors.green(file.name.padEnd(longest + 2))} ${
+function protectStringsPlugin(api: typeof Babel & Babel.ConfigAPI): Babel.PluginObj<ProtectStringsPluginState> {
-              kibs > chunkLimit ? colors.yellow(`${kibs.toFixed(2)} KiB`) : colors.dim(`${kibs.toFixed(2)} KiB`)
+  const { types: t } = api
-            }`
+
-          )
+  function createFromCharCodeFunction(value: string): Babel.types.CallExpression {
-        })
+    const charCodes = Array.from(value).map(s => s.charCodeAt(0))
-        bytecodeFiles = []
+    const charCodeLiterals = charCodes.map(code => t.numericLiteral(code))
+
+    // String.fromCharCode
+    const memberExpression = t.memberExpression(t.identifier('String'), t.identifier('fromCharCode'))
+    // String.fromCharCode(...arr)
+    const callExpression = t.callExpression(memberExpression, [t.spreadElement(t.identifier('arr'))])
+    // return String.fromCharCode(...arr)
+    const returnStatement = t.returnStatement(callExpression)
+    // function (arr) { return ... }
+    const functionExpression = t.functionExpression(null, [t.identifier('arr')], t.blockStatement([returnStatement]))
+
+    // (function(...) { ... })([x, x, x])
+    return t.callExpression(functionExpression, [t.arrayExpression(charCodeLiterals)])
+  }
+
+  return {
+    name: 'protect-strings-plugin',
+    visitor: {
+      StringLiteral(path, state) {
+        // obj['property']
+        if (path.parentPath.isMemberExpression({ property: path.node, computed: true })) {
+          return
+        }
+
+        // { 'key': value }
+        if (path.parentPath.isObjectProperty({ key: path.node, computed: false })) {
+          return
+        }
+
+        // require('fs')
+        if (
+          path.parentPath.isCallExpression() &&
+          t.isIdentifier(path.parentPath.node.callee) &&
+          path.parentPath.node.callee.name === 'require' &&
+          path.parentPath.node.arguments[0] === path.node
+        ) {
+          return
+        }
+
+        // Only CommonJS is supported, import declaration and export declaration checks are ignored
+
+        const { value } = path.node
+        if (state.opts.protectedStrings.has(value)) {
+          path.replaceWith(createFromCharCodeFunction(value))
+        }
+      },
+      TemplateLiteral(path, state) {
+        // Must be a pure static template literal
+        // expressions must be empty (no ${variables})
+        // quasis must have only one element (meaning the entire string is a single static part).
+        if (path.node.expressions.length > 0 || path.node.quasis.length !== 1) {
+          return
+        }
+
+        // Extract the raw value of the template literal
+        // path.node.quasis[0].value.raw is used to get the raw string, including escape sequences
+        // path.node.quasis[0].value.cooked is used to get the processed/cooked string (with escape sequences handled)
+        const value = path.node.quasis[0].value.cooked
+        if (value && state.opts.protectedStrings.has(value)) {
+          path.replaceWith(createFromCharCodeFunction(value))
+        }
       }
     }
   }

src/plugins/electron.ts

@@ -2,14 +2,15 @@ import path from 'node:path'
 import fs from 'node:fs'
 import { builtinModules } from 'node:module'
 import colors from 'picocolors'
-import { type Plugin, mergeConfig, normalizePath } from 'vite'
+import { type Plugin, type UserConfig, mergeConfig, normalizePath } from 'vite'
-import { getElectronNodeTarget, getElectronChromeTarget } from '../electron'
+import { getElectronNodeTarget, getElectronChromeTarget, supportESM } from '../electron'
+import { loadPackageData, resolveBuildOutputs } from '../utils'
 
 export interface ElectronPluginOptions {
   root?: string
 }
 
-function findLibEntry(root: string, scope: string): string {
+function findLibEntry(root: string, scope: string): string | undefined {
   for (const name of ['index', scope]) {
     for (const ext of ['js', 'ts', 'mjs', 'cjs']) {
       const entryFile = path.resolve(root, 'src', scope, `${name}.${ext}`)
@@ -18,7 +19,7 @@ function findLibEntry(root: string, scope: string): string {
       }
     }
   }
-  return ''
+  return undefined
 }
 
 function findInput(root: string, scope = 'renderer'): string {
@@ -37,10 +38,9 @@ function processEnvDefine(): Record<string, string> {
   }
 }
 
-export function electronMainVitePlugin(options?: ElectronPluginOptions): Plugin[] {
+export function electronMainConfigPresetPlugin(options?: ElectronPluginOptions): Plugin {
-  return [
+  return {
-    {
+    name: 'vite:electron-main-config-preset',
-      name: 'vite:electron-main-preset-config',
     apply: 'build',
     enforce: 'pre',
     config(config): void {
@@ -48,90 +48,123 @@ export function electronMainVitePlugin(options?: ElectronPluginOptions): Plugin[
 
       const nodeTarget = getElectronNodeTarget()
 
+      const pkg = loadPackageData() || { type: 'commonjs' }
+
+      const format = pkg.type && pkg.type === 'module' && supportESM() ? 'es' : 'cjs'
+
       const defaultConfig = {
         build: {
           outDir: path.resolve(root, 'out', 'main'),
           target: nodeTarget,
           assetsDir: 'chunks',
-            rollupOptions: {
+          rolldownOptions: {
-              external: ['electron', ...builtinModules.flatMap(m => [m, `node:${m}`])],
+            external: ['electron', /^electron\/.+/, ...builtinModules.flatMap(m => [m, `node:${m}`])],
-              output: {
+            output: {}
-                entryFileNames: '[name].js'
-              }
           },
           reportCompressedSize: false,
           minify: false
         }
-        }
+      } satisfies UserConfig
 
       const build = config.build || {}
-        const rollupOptions = build.rollupOptions || {}
+      const rolldownOptions = build.rolldownOptions || {}
-        if (!rollupOptions.input) {
+      if (!rolldownOptions.input) {
+        const libOptions = build.lib
+        const outputOptions = rolldownOptions.output
         defaultConfig.build['lib'] = {
           entry: findLibEntry(root, 'main'),
-            formats: ['cjs']
+          formats:
+            libOptions && libOptions.formats && libOptions.formats.length > 0
+              ? []
+              : [outputOptions && !Array.isArray(outputOptions) && outputOptions.format ? outputOptions.format : format]
         }
       } else {
-          defaultConfig.build.rollupOptions.output['format'] = 'cjs'
+        defaultConfig.build.rolldownOptions.output['format'] = format
       }
 
+      defaultConfig.build.rolldownOptions.output['assetFileNames'] = path.posix.join(
+        build.assetsDir || defaultConfig.build.assetsDir,
+        '[name]-[hash].[ext]'
+      )
+
       const buildConfig = mergeConfig(defaultConfig.build, build)
       config.build = buildConfig
 
       config.define = config.define || {}
       config.define = { ...processEnvDefine(), ...config.define }
 
-        config.envPrefix = config.envPrefix || 'MAIN_VITE_'
+      config.envPrefix = config.envPrefix || ['MAIN_VITE_', 'VITE_']
+
+      config.publicDir = config.publicDir || 'resources'
+      // do not copy public dir
+      config.build.copyPublicDir = false
+      // module preload polyfill does not apply to nodejs (main process)
+      config.build.modulePreload = false
+      // enable ssr build
+      config.build.ssr = true
+      config.build.ssrEmitAssets = true
+      config.ssr = { ...config.ssr, ...{ noExternal: true } }
+
+      config.build.rollupOptions = config.build.rolldownOptions
     }
-    },
+  }
-    {
+}
-      name: 'vite:electron-main-resolved-config',
+
+export function electronMainConfigValidatorPlugin(): Plugin {
+  return {
+    name: 'vite:electron-main-config-validator',
     apply: 'build',
     enforce: 'post',
     configResolved(config): void {
       const build = config.build
       if (!build.target) {
-          throw new Error('build target required for the electron vite main config')
+        throw new Error('build.target option is required in the electron vite main config.')
       } else {
         const targets = Array.isArray(build.target) ? build.target : [build.target]
         if (targets.some(t => !t.startsWith('node'))) {
-            throw new Error('the electron vite main config build target must be node')
+          throw new Error('The electron vite main config build.target option must be "node?".')
         }
       }
 
-        const lib = build.lib
+      const libOptions = build.lib
-        if (!lib) {
+      const rolldownOptions = build.rolldownOptions
-          const rollupOptions = build.rollupOptions
+
-          if (!rollupOptions?.input) {
+      if (!(libOptions && libOptions.entry) && !rolldownOptions?.input) {
-            throw new Error('build lib field required for the electron vite main config')
+        throw new Error(
+          'An entry point is required in the electron vite main config, ' +
+            'which can be specified using build.lib.entry, build.rollupOptions.input, ' +
+            'or build.rolldownOptions.input.'
+        )
+      }
+
+      const outputs = resolveBuildOutputs(rolldownOptions.output, libOptions)
+
+      if (outputs.length > 0) {
+        if (outputs.length > 1) {
+          throw new Error('The electron vite main config does not support multiple outputs.')
         } else {
-            const output = rollupOptions?.output
+          const output = outputs[0]
-            if (output) {
+          if (['es', 'cjs'].includes(output.format || '')) {
-              const formats = Array.isArray(output) ? output : [output]
+            if (output.format === 'es' && !supportESM()) {
-              if (!formats.some(f => f !== 'cjs')) {
+              throw new Error(
-                throw new Error('the electron vite main config output format must be cjs')
+                'The electron vite main config output format does not support "es", ' +
-              }
+                  'you can upgrade electron to the latest version or switch to "cjs" format.'
-            }
+              )
             }
           } else {
-          if (!lib.entry) {
+            throw new Error(
-            throw new Error('build entry field required for the electron vite main config')
+              `The electron vite main config output format must be "cjs"${supportESM() ? ' or "es"' : ''}.`
-          }
+            )
-          if (!lib.formats) {
+          }
-            throw new Error('build format field required for the electron vite main config')
-          } else if (!lib.formats.includes('cjs')) {
-            throw new Error('the electron vite main config build lib format must be cjs')
         }
       }
     }
   }
-  ]
 }
 
-export function electronPreloadVitePlugin(options?: ElectronPluginOptions): Plugin[] {
+export function electronPreloadConfigPresetPlugin(options?: ElectronPluginOptions): Plugin {
-  return [
+  return {
-    {
+    name: 'vite:electron-preload-config-preset',
-      name: 'vite:electron-preload-preset-config',
     apply: 'build',
     enforce: 'pre',
     config(config): void {
@@ -139,90 +172,148 @@ export function electronPreloadVitePlugin(options?: ElectronPluginOptions): Plug
 
       const nodeTarget = getElectronNodeTarget()
 
+      const pkg = loadPackageData() || { type: 'commonjs' }
+
+      const format = pkg.type && pkg.type === 'module' && supportESM() ? 'es' : 'cjs'
+
       const defaultConfig = {
+        ssr: {
+          resolve: {
+            conditions: ['module', 'browser', 'development|production'],
+            mainFields: ['browser', 'module', 'jsnext:main', 'jsnext']
+          }
+        },
         build: {
           outDir: path.resolve(root, 'out', 'preload'),
           target: nodeTarget,
           assetsDir: 'chunks',
-            rollupOptions: {
+          rolldownOptions: {
-              external: ['electron', ...builtinModules.flatMap(m => [m, `node:${m}`])],
+            external: ['electron', /^electron\/.+/, ...builtinModules.flatMap(m => [m, `node:${m}`])],
-              output: {
+            output: {}
-                entryFileNames: '[name].js'
-              }
           },
           reportCompressedSize: false,
           minify: false
         }
-        }
+      } satisfies UserConfig
 
       const build = config.build || {}
-        const rollupOptions = build.rollupOptions || {}
+      const rolldownOptions = build.rolldownOptions || {}
-        if (!rollupOptions.input) {
+      if (!rolldownOptions.input) {
+        const libOptions = build.lib
+        const outputOptions = rolldownOptions.output
         defaultConfig.build['lib'] = {
           entry: findLibEntry(root, 'preload'),
-            formats: ['cjs']
+          formats:
+            libOptions && libOptions.formats && libOptions.formats.length > 0
+              ? []
+              : [outputOptions && !Array.isArray(outputOptions) && outputOptions.format ? outputOptions.format : format]
         }
       } else {
-          defaultConfig.build.rollupOptions.output['format'] = 'cjs'
+        defaultConfig.build.rolldownOptions.output['format'] = format
       }
 
+      defaultConfig.build.rolldownOptions.output['assetFileNames'] = path.posix.join(
+        build.assetsDir || defaultConfig.build.assetsDir,
+        '[name]-[hash].[ext]'
+      )
+
       const buildConfig = mergeConfig(defaultConfig.build, build)
       config.build = buildConfig
 
+      const outputs = resolveBuildOutputs(config.build.rolldownOptions!.output, config.build.lib)
+
+      if (outputs.some(({ format }) => format === 'es')) {
+        if (Array.isArray(config.build.rolldownOptions!.output)) {
+          config.build.rolldownOptions!.output.forEach(output => {
+            if (output.format === 'es') {
+              output['entryFileNames'] = '[name].mjs'
+              output['chunkFileNames'] = '[name]-[hash].mjs'
+            }
+          })
+        } else {
+          config.build.rolldownOptions!.output!['entryFileNames'] = '[name].mjs'
+          config.build.rolldownOptions!.output!['chunkFileNames'] = config.build.lib
+            ? '[name]-[hash].mjs'
+            : path.posix.join(build.assetsDir || defaultConfig.build.assetsDir, '[name]-[hash].mjs')
+        }
+      }
+
       config.define = config.define || {}
       config.define = { ...processEnvDefine(), ...config.define }
 
-        config.envPrefix = config.envPrefix || 'PRELOAD_VITE_'
+      config.envPrefix = config.envPrefix || ['PRELOAD_VITE_', 'VITE_']
+
+      config.publicDir = config.publicDir || 'resources'
+      // do not copy public dir
+      config.build.copyPublicDir = false
+      // module preload polyfill does not apply to nodejs (preload scripts)
+      config.build.modulePreload = false
+      // enable ssr build
+      config.build.ssr = true
+      config.build.ssrEmitAssets = true
+      config.ssr = mergeConfig(defaultConfig.ssr, config.ssr || {})
+      config.ssr.noExternal = true
+
+      config.build.rollupOptions = config.build.rolldownOptions
     }
-    },
+  }
-    {
+}
-      name: 'vite:electron-preload-resolved-config',
+
+export function electronPreloadConfigValidatorPlugin(): Plugin {
+  return {
+    name: 'vite:electron-preload-config-validator',
     apply: 'build',
     enforce: 'post',
     configResolved(config): void {
       const build = config.build
       if (!build.target) {
-          throw new Error('build target required for the electron vite preload config')
+        throw new Error('build.target option is required in the electron vite preload config.')
       } else {
         const targets = Array.isArray(build.target) ? build.target : [build.target]
         if (targets.some(t => !t.startsWith('node'))) {
-            throw new Error('the electron vite preload config build target must be node')
+          throw new Error('The electron vite preload config build.target must be "node?".')
         }
       }
 
-        const lib = build.lib
+      const libOptions = build.lib
-        if (!lib) {
+      const rolldownOptions = build.rolldownOptions
-          const rollupOptions = build.rollupOptions
+
-          if (!rollupOptions?.input) {
+      if (!(libOptions && libOptions.entry) && !rolldownOptions?.input) {
-            throw new Error('build lib field required for the electron vite preload config')
+        throw new Error(
+          'An entry point is required in the electron vite preload config, ' +
+            'which can be specified using build.lib.entry, build.rollupOptions.input, ' +
+            ' or build.rolldownOptions.input.'
+        )
+      }
+
+      const outputs = resolveBuildOutputs(rolldownOptions.output, libOptions)
+
+      if (outputs.length > 0) {
+        if (outputs.length > 1) {
+          throw new Error('The electron vite preload config does not support multiple outputs.')
         } else {
-            const output = rollupOptions?.output
+          const output = outputs[0]
-            if (output) {
+          if (['es', 'cjs'].includes(output.format || '')) {
-              const formats = Array.isArray(output) ? output : [output]
+            if (output.format === 'es' && !supportESM()) {
-              if (!formats.some(f => f !== 'cjs')) {
+              throw new Error(
-                throw new Error('the electron vite preload config output format must be cjs')
+                'The electron vite preload config output format does not support "es", ' +
-              }
+                  'you can upgrade electron to the latest version or switch to "cjs" format.'
-            }
+              )
             }
           } else {
-          if (!lib.entry) {
+            throw new Error(
-            throw new Error('build entry field required for the electron vite preload config')
+              `The electron vite preload config output format must be "cjs"${supportESM() ? ' or "es"' : ''}.`
-          }
+            )
-          if (!lib.formats) {
+          }
-            throw new Error('build format field required for the electron vite preload config')
-          } else if (!lib.formats.includes('cjs')) {
-            throw new Error('the electron vite preload config lib format must be cjs')
         }
       }
     }
   }
-  ]
 }
 
-export function electronRendererVitePlugin(options?: ElectronPluginOptions): Plugin[] {
+export function electronRendererConfigPresetPlugin(options?: ElectronPluginOptions): Plugin {
-  return [
+  return {
-    {
+    name: 'vite:electron-renderer-config-preset',
-      name: 'vite:electron-renderer-preset-config',
     enforce: 'pre',
     config(config): void {
       const root = options?.root || process.cwd()
@@ -250,14 +341,17 @@ export function electronRendererVitePlugin(options?: ElectronPluginOptions): Plu
           outDir: path.resolve(root, 'out', 'renderer'),
           target: chromeTarget,
           modulePreload: { polyfill: false },
-            rollupOptions: {
+          rolldownOptions: {
-              input: findInput(root),
+            input: findInput(root)
-              external: [...builtinModules.flatMap(m => [m, `node:${m}`])]
           },
           reportCompressedSize: false,
           minify: false,
           emptyOutDir: emptyOutDir()
         }
+      } satisfies UserConfig
+
+      if (config.build?.outDir) {
+        config.build.outDir = path.resolve(root, config.build.outDir)
       }
 
       const buildConfig = mergeConfig(defaultConfig.build, config.build || {})
@@ -265,33 +359,41 @@ export function electronRendererVitePlugin(options?: ElectronPluginOptions): Plu
 
       config.envDir = config.envDir || path.resolve(root)
 
-        config.envPrefix = config.envPrefix || 'RENDERER_VITE_'
+      config.envPrefix = config.envPrefix || ['RENDERER_VITE_', 'VITE_']
+
+      config.build.rollupOptions = config.build.rolldownOptions
     }
-    },
+  }
-    {
+}
-      name: 'vite:electron-renderer-resolved-config',
+
+export function electronRendererConfigValidatorPlugin(): Plugin {
+  return {
+    name: 'vite:electron-renderer-config-validator',
     enforce: 'post',
     configResolved(config): void {
       if (config.base !== './' && config.base !== '/') {
-          config.logger.warn(colors.yellow('should not set base field for the electron vite renderer config'))
+        config.logger.warn(colors.yellow('(!) Should not set "base" option for the electron vite renderer config.'))
       }
 
       const build = config.build
       if (!build.target) {
-          throw new Error('build target required for the electron vite renderer config')
+        throw new Error('build.target option is required in the electron vite renderer config.')
       } else {
         const targets = Array.isArray(build.target) ? build.target : [build.target]
-          if (targets.some(t => !t.startsWith('chrome'))) {
+        if (targets.some(t => !t.startsWith('chrome') && !/^es((202\d{1})|next)$/.test(t))) {
-            throw new Error('the electron vite renderer config build target must be chrome')
+          config.logger.warn(
+            'The electron vite renderer config build.target is not "chrome?" or "es?". This could be a mistake.'
+          )
         }
       }
 
-        const rollupOptions = build.rollupOptions
+      const rolldownOptions = build.rolldownOptions
-        if (!rollupOptions.input) {
+      if (!rolldownOptions.input) {
-          config.logger.warn(colors.yellow(`index.html file is not found in ${colors.dim('/src/renderer')} directory`))
+        config.logger.warn(colors.yellow(`index.html file is not found in ${colors.dim('/src/renderer')} directory.`))
-          throw new Error('build rollupOptions input field required for the electron vite renderer config')
+        throw new Error(
+          'build.rollupOptions.input or build.rolldownOptions.input option is required in the electron vite renderer config.'
+        )
       }
     }
   }
-  ]
 }

src/plugins/esmShim.ts

@@ -0,0 +1,55 @@
+import MagicString from 'magic-string'
+import type { Plugin } from 'vite'
+
+import { supportImportMetaPaths } from '../electron'
+
+const CJSyntaxRe = /__filename|__dirname|require\(|require\.resolve\(/
+
+const CJSShim_normal = `
+// -- CommonJS Shims --
+import __shims_url__ from 'node:url';
+import __shims_path__ from 'node:path';
+import __shims_module__ from 'node:module';
+const __filename = __shims_url__.fileURLToPath(import.meta.url);
+const __dirname = __shims_path__.dirname(__filename);
+const require = __shims_module__.createRequire(import.meta.url);
+`
+
+const CJSShim_node_20_11 = `
+// -- CommonJS Shims --
+import __shims_module__ from 'node:module';
+const __filename = import.meta.filename;
+const __dirname = import.meta.dirname;
+const require = __shims_module__.createRequire(import.meta.url);
+`
+
+export default function esmShimPlugin(): Plugin {
+  const CJSShim = supportImportMetaPaths() ? CJSShim_node_20_11 : CJSShim_normal
+
+  return {
+    name: 'vite:esm-shim',
+    apply: 'build',
+    enforce: 'post',
+    renderChunk(code, _chunk, { format, sourcemap }) {
+      if (format === 'es') {
+        // Rolldown may remove unused shim bindings after this hook; referenced bindings remain available.
+        if (code.includes(CJSShim) || !CJSyntaxRe.test(code)) {
+          return null
+        }
+
+        const lastESMImport = this.parse(code)
+          .body.filter(node => node.type === 'ImportDeclaration')
+          .pop()
+        const indexToAppend = lastESMImport ? lastESMImport.end : 0
+        const s = new MagicString(code)
+        s.appendRight(indexToAppend, CJSShim)
+        return {
+          code: s.toString(),
+          map: sourcemap ? s.generateMap({ hires: 'boundary' }) : null
+        }
+      }
+
+      return null
+    }
+  }
+}

src/plugins/externalizeDeps.ts

@@ -1,6 +1,5 @@
-import path from 'node:path'
-import { createRequire } from 'node:module'
 import { type Plugin, mergeConfig } from 'vite'
+import { loadPackageData } from '../utils'
 
 export interface ExternalOptions {
   exclude?: string[]
@@ -8,37 +7,41 @@ export interface ExternalOptions {
 }
 
 /**
- * Automatically externalize dependencies
+ * Automatically externalize dependencies.
+ *
+ * @deprecated use `build.externalizeDeps` config option instead
  */
 export function externalizeDepsPlugin(options: ExternalOptions = {}): Plugin | null {
   const { exclude = [], include = [] } = options
 
-  const packagePath = path.resolve(process.cwd(), 'package.json')
+  const pkg = loadPackageData() || {}
-  const require = createRequire(import.meta.url)
-  const pkg = require(packagePath)
   let deps = Object.keys(pkg.dependencies || {})
 
   if (include.length) {
-    deps = deps.concat(include)
+    deps = deps.concat(include.filter(dep => dep.trim() !== ''))
   }
 
   if (exclude.length) {
     deps = deps.filter(dep => !exclude.includes(dep))
   }
 
+  deps = [...new Set(deps)]
+
   return {
     name: 'vite:externalize-deps',
     enforce: 'pre',
     config(config): void {
       const defaultConfig = {
         build: {
-          rollupOptions: {
+          rolldownOptions: {
-            external: [...new Set(deps)]
+            external: deps.length > 0 ? [...deps, new RegExp(`^(${deps.join('|')})/.+`)] : []
           }
         }
       }
       const buildConfig = mergeConfig(defaultConfig.build, config.build || {})
       config.build = buildConfig
+
+      config.build.rollupOptions = config.build.rolldownOptions
     }
   }
 }

src/plugins/importMeta.ts

@@ -0,0 +1,34 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { type Plugin, version } from 'vite'
+
+/**
+ * @deprecated Vite 8 (Rolldown) now provides native support for these
+ * `import.meta` properties. These properties are polyfilled when the output
+ * format is CJS.
+ *
+ * @see https://rolldown.rs/in-depth/non-esm-output-formats#well-known-import-meta-properties
+ */
+export default function importMetaPlugin(): Plugin | null {
+  const currentVersion = version.split('.')
+  const major = parseInt(currentVersion[0], 10)
+  if (major >= 8) {
+    return null
+  }
+  return {
+    name: 'vite:import-meta',
+    apply: 'build',
+    enforce: 'pre',
+    resolveImportMeta(property, { format }): string | null {
+      if (property === 'url' && format === 'cjs') {
+        return `require("url").pathToFileURL(__filename).href`
+      }
+      if (property === 'filename' && format === 'cjs') {
+        return `__filename`
+      }
+      if (property === 'dirname' && format === 'cjs') {
+        return `__dirname`
+      }
+      return null
+    }
+  } as any
+}

src/plugins/isolateEntries.ts

@@ -0,0 +1,199 @@
+/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-function-type */
+import path from 'node:path'
+import { type InlineConfig, type Plugin, type LogLevel, type Rolldown, build as viteBuild, mergeConfig } from 'vite'
+import colors from 'picocolors'
+import { cleanUrl } from '../utils'
+import type { ConfigFactory, PreloadViteConfig, RendererViteConfig } from '../config'
+
+const VIRTUAL_ENTRY_ID = '\0virtual:isolate-entries'
+
+const LogLevels: Record<LogLevel, number> = {
+  silent: 0,
+  error: 1,
+  warn: 2,
+  info: 3
+}
+
+export default function isolateEntriesPlugin(factory: ConfigFactory<PreloadViteConfig | RendererViteConfig>): Plugin {
+  let entries: string[] | { [x: string]: string }[]
+
+  let transformedCount = 0
+
+  const assetCache = new Set<string>()
+
+  return {
+    name: 'vite:isolate-entries',
+    apply: 'build',
+
+    options(opts): Rolldown.InputOptions | void {
+      const { input } = opts
+      if (input && typeof input === 'object') {
+        if ((Array.isArray(input) && input.length > 0) || Object.keys(input).length > 1) {
+          opts.input = VIRTUAL_ENTRY_ID
+          entries = Array.isArray(input) ? input : Object.entries(input).map(([key, value]) => ({ [key]: value }))
+          return opts
+        }
+      }
+    },
+
+    buildStart(): void {
+      transformedCount = 0
+      assetCache.clear()
+    },
+
+    resolveId(id): string | null {
+      if (id === VIRTUAL_ENTRY_ID) {
+        return id
+      }
+      return null
+    },
+
+    async load(id): Promise<string | void> {
+      if (id === VIRTUAL_ENTRY_ID) {
+        const userConfig = await factory.build(true)
+        const shouldLog = LogLevels[userConfig.logLevel || 'info'] >= LogLevels.info
+
+        const watchFiles = new Set<string>()
+
+        for (const entry of entries) {
+          const re = await bundleEntryFile(entry, userConfig, shouldLog, transformedCount)
+
+          const outputChunks = re.bundles.output
+          for (const chunk of outputChunks) {
+            if (assetCache.has(chunk.fileName)) {
+              continue
+            }
+            this.emitFile({
+              type: 'asset',
+              fileName: chunk.fileName,
+              source: chunk.type === 'chunk' ? chunk.code : chunk.source
+            })
+            assetCache.add(chunk.fileName)
+          }
+
+          if (this.meta.watchMode) {
+            const moduleIds = new Set<string>()
+            for (const chunk of re.bundles.output) {
+              if (chunk.type === 'chunk') {
+                for (const id of chunk.moduleIds) {
+                  if (!id.startsWith('\0')) {
+                    moduleIds.add(cleanUrl(id))
+                  }
+                }
+              }
+            }
+            for (const id of moduleIds) {
+              this.addWatchFile(id)
+            }
+          }
+
+          transformedCount += re.transformedCount
+        }
+
+        for (const id of watchFiles) {
+          this.addWatchFile(id)
+        }
+
+        return `
+        // This is the virtual entry file
+        console.log(1)`
+      }
+    },
+
+    renderStart(): void {
+      clearLine(-1)
+      this.environment.logger.info(`${colors.green(`✓`)} ${transformedCount} modules transformed.`)
+    },
+
+    generateBundle(_, bundle): void {
+      for (const chunkName in bundle) {
+        if (chunkName.includes('virtual_isolate-entries')) {
+          delete bundle[chunkName]
+        }
+      }
+    }
+  }
+}
+
+async function bundleEntryFile(
+  input: string | Record<string, string>,
+  config: InlineConfig,
+  shouldLog: boolean,
+  preTransformedCount: number
+): Promise<{ bundles: Rolldown.RolldownOutput; transformedCount: number }> {
+  const transformReporter = transformReporterPlugin(preTransformedCount, shouldLog)
+
+  const viteConfig = mergeConfig(config, {
+    build: {
+      write: false,
+      watch: false
+    },
+    plugins: [transformReporter],
+    logLevel: 'warn',
+    configFile: false
+  }) as InlineConfig
+
+  // rewrite the input instead of merging
+  viteConfig.build!.rolldownOptions!.input = input
+
+  const bundles = (await viteBuild(viteConfig)) as Rolldown.RolldownOutput
+
+  return {
+    bundles: bundles,
+    transformedCount: transformReporter?.api?.getTransformedCount() || 0
+  }
+}
+
+function transformReporterPlugin(
+  preTransformedCount = 0,
+  shouldLog = true
+): Plugin<{ getTransformedCount: () => number }> {
+  let transformedCount = 0
+  const log = throttle((id, root) => {
+    writeLine(`transforming (${preTransformedCount + transformedCount}) ${colors.dim(path.relative(root, id))}`)
+  })
+  return {
+    name: 'vite:transform-reporter',
+    transform(_, id) {
+      transformedCount++
+      if (!shouldLog) return
+      if (id.includes('?')) return
+      log(id, this.environment.config.root)
+    },
+    api: {
+      getTransformedCount() {
+        return transformedCount
+      }
+    }
+  }
+}
+
+function writeLine(output: string): void {
+  if (!process.stdout.isTTY || process.env.CI) return
+  clearLine()
+  if (output.length < process.stdout.columns) {
+    process.stdout.write(output)
+  } else {
+    process.stdout.write(output.substring(0, process.stdout.columns - 1))
+  }
+}
+
+function clearLine(move: number = 0): void {
+  if (!process.stdout.isTTY || process.env.CI) return
+  if (move < 0) {
+    process.stdout.moveCursor(0, move)
+  }
+  process.stdout.clearLine(0)
+  process.stdout.cursorTo(0)
+}
+
+function throttle(fn: Function) {
+  let timerHandle: NodeJS.Timeout | null = null
+  return (...args: any[]) => {
+    if (timerHandle) return
+    fn(...args)
+    timerHandle = setTimeout(() => {
+      timerHandle = null
+    }, 100)
+  }
+}

src/plugins/modulePath.ts

@@ -0,0 +1,126 @@
+import { type Plugin, type InlineConfig, type Rolldown, build as viteBuild, mergeConfig } from 'vite'
+import MagicString from 'magic-string'
+import { cleanUrl, toRelativePath } from '../utils'
+import { supportImportMetaPaths } from '../electron'
+import type { ConfigFactory, MainViteConfig } from '../config'
+
+const modulePathRE = /__VITE_MODULE_PATH__([\w$]+)__/g
+
+/**
+ * Resolve `?modulePath` import and return the module bundle path.
+ */
+export default function modulePathPlugin(factory: ConfigFactory<MainViteConfig>): Plugin {
+  const isImportMetaPathSupported = supportImportMetaPaths()
+  const assetCache = new Set<string>()
+  return {
+    name: 'vite:module-path',
+    apply: 'build',
+    enforce: 'pre',
+    buildStart(): void {
+      assetCache.clear()
+    },
+    async load(id): Promise<string | void> {
+      if (id.endsWith('?modulePath')) {
+        // id resolved by Vite resolve plugin
+        const config = await factory.build(true)
+        const bundles = await bundleEntryFile(cleanUrl(id), config)
+        const [outputChunk, ...outputChunks] = bundles.output
+        const hash = this.emitFile({
+          type: 'asset',
+          fileName: outputChunk.fileName,
+          source: outputChunk.code
+        })
+        for (const chunk of outputChunks) {
+          if (assetCache.has(chunk.fileName)) {
+            continue
+          }
+          this.emitFile({
+            type: 'asset',
+            fileName: chunk.fileName,
+            source: chunk.type === 'chunk' ? chunk.code : chunk.source
+          })
+          assetCache.add(chunk.fileName)
+        }
+        if (this.meta.watchMode) {
+          const moduleIds = new Set<string>()
+          for (const chunk of bundles.output) {
+            if (chunk.type === 'chunk') {
+              for (const id of chunk.moduleIds) {
+                if (!id.startsWith('\0')) {
+                  moduleIds.add(cleanUrl(id))
+                }
+              }
+            }
+          }
+          for (const id of moduleIds) {
+            this.addWatchFile(id)
+          }
+        }
+        const refId = `__VITE_MODULE_PATH__${hash}__`
+        const dirnameExpr = isImportMetaPathSupported ? 'import.meta.dirname' : '__dirname'
+        return `
+          import { join } from 'path'
+          export default join(${dirnameExpr}, ${refId})`
+      }
+    },
+    renderChunk(code, chunk, { sourcemap }): { code: string; map: Rolldown.SourceMapInput } | null {
+      let match: RegExpExecArray | null
+      let s: MagicString | undefined
+
+      modulePathRE.lastIndex = 0
+      while ((match = modulePathRE.exec(code))) {
+        s ||= new MagicString(code)
+        const [full, hash] = match
+        const filename = this.getFileName(hash)
+        const outputFilepath = toRelativePath(filename, chunk.fileName)
+        const replacement = JSON.stringify(outputFilepath)
+        s.overwrite(match.index, match.index + full.length, replacement, {
+          contentOnly: true
+        })
+      }
+
+      if (s) {
+        return {
+          code: s.toString(),
+          map: sourcemap ? s.generateMap({ hires: 'boundary' }) : null
+        }
+      }
+
+      return null
+    }
+  }
+}
+
+async function bundleEntryFile(input: string, config: InlineConfig): Promise<Rolldown.RolldownOutput> {
+  const viteConfig = mergeConfig(config, {
+    build: {
+      write: false,
+      watch: false
+    },
+    plugins: [
+      {
+        name: 'vite:entry-file-name',
+        outputOptions(output): Rolldown.OutputOptions {
+          // Prevent output conflicts
+          output.hashCharacters = 'hex'
+          // Assign chunkFileNames to entryFileNames to treat sub-entries as internal chunks
+          output.entryFileNames = output.chunkFileNames
+          return output
+        }
+      }
+    ] as Plugin[],
+    logLevel: 'warn',
+    configFile: false
+  }) as InlineConfig
+
+  // rewrite the input instead of merging
+  const buildOptions = viteConfig.build!
+  buildOptions.rolldownOptions = {
+    ...buildOptions.rolldownOptions,
+    input
+  }
+
+  const bundles = await viteBuild(viteConfig)
+
+  return bundles as Rolldown.RolldownOutput
+}

src/plugins/swc.ts

@@ -79,12 +79,16 @@ export type SwcOptions = {
 export function swcPlugin(options: SwcOptions = {}): Plugin {
   const filter = createFilter(options.include || /\.(m?ts|[jt]sx)$/, options.exclude || /\.js$/)
   let sourcemap: boolean | 'inline' = false
-  let minify: boolean | 'esbuild' | 'terser' = false
+  let minify: boolean | 'esbuild' | 'oxc' | 'terser' = false
   return {
     name: 'vite:swc',
     config(): UserConfig {
+      // Vite 8 defaults to Oxc for transform; `esbuild: false` is ignored and
+      // warns. SWC replaces both paths when this plugin is active.
+      // See https://github.com/alex8088/electron-vite/issues/916
       return {
-        esbuild: false
+        esbuild: false,
+        oxc: false
       }
     },
     async configResolved(resolvedConfig): Promise<void> {
@@ -101,7 +105,7 @@ export function swcPlugin(options: SwcOptions = {}): Plugin {
       }
     },
     async renderChunk(code, chunk): Promise<null | { code: string; map: SourceMap }> {
-      if (!minify || minify === 'terser') {
+      if (!minify || minify === 'terser' || minify === 'oxc') {
         return null
       }
       const result = await transformWithSWC(code, chunk.fileName, {

src/plugins/worker.ts

@@ -1,65 +1,60 @@
-import path from 'node:path'
 import type { Plugin } from 'vite'
-import type { SourceMapInput } from 'rollup'
 import MagicString from 'magic-string'
-import { cleanUrl, parseRequest } from '../utils'
+import { cleanUrl, toRelativePath } from '../utils'
 
-const nodeWorkerAssetUrlRE = /__VITE_NODE_WORKER_ASSET__([a-z\d]{8})__/g
+const nodeWorkerAssetUrlRE = /__VITE_NODE_WORKER_ASSET__([\w$]+)__/g
+const nodeWorkerRE = /\?nodeWorker(?:&|$)/
+const nodeWorkerImporterRE = /(?:\?)nodeWorker&importer=([^&]+)(?:&|$)/
 
 /**
  * Resolve `?nodeWorker` import and automatically generate `Worker` wrapper.
  */
 export default function workerPlugin(): Plugin {
-  let sourcemap: boolean | 'inline' | 'hidden' = false
   return {
     name: 'vite:node-worker',
     apply: 'build',
     enforce: 'pre',
-    configResolved(config): void {
-      sourcemap = config.build.sourcemap
-    },
     resolveId(id, importer): string | void {
-      const query = parseRequest(id)
+      if (id.endsWith('?nodeWorker')) {
-      if (query && typeof query.nodeWorker === 'string') {
         return id + `&importer=${importer}`
       }
     },
     load(id): string | void {
-      const query = parseRequest(id)
+      if (nodeWorkerRE.test(id)) {
-      if (query && typeof query.nodeWorker === 'string' && typeof query.importer === 'string') {
+        const match = nodeWorkerImporterRE.exec(id)
-        const cleanPath = cleanUrl(id)
+        if (match) {
           const hash = this.emitFile({
             type: 'chunk',
-          id: cleanPath,
+            id: cleanUrl(id),
-          importer: query.importer
+            importer: match[1]
           })
           const assetRefId = `__VITE_NODE_WORKER_ASSET__${hash}__`
           return `
           import { Worker } from 'node:worker_threads';
-        export default function (options) { return new Worker(require.resolve(${assetRefId}), options); }`
+          export default function (options) { return new Worker(new URL(${assetRefId}, import.meta.url), options); }`
+        }
       }
     },
-    renderChunk(code, chunk): { code: string; map: SourceMapInput } | null {
+    renderChunk(code, chunk, { sourcemap }) {
-      if (code.match(nodeWorkerAssetUrlRE)) {
       let match: RegExpExecArray | null
-        const s = new MagicString(code)
+      let s: MagicString | undefined
 
+      nodeWorkerAssetUrlRE.lastIndex = 0
       while ((match = nodeWorkerAssetUrlRE.exec(code))) {
+        s ||= new MagicString(code)
         const [full, hash] = match
         const filename = this.getFileName(hash)
-          let outputFilepath = path.posix.relative(path.dirname(chunk.fileName), filename)
+        const outputFilepath = toRelativePath(filename, chunk.fileName)
-          if (!outputFilepath.startsWith('.')) {
-            outputFilepath = './' + outputFilepath
-          }
         const replacement = JSON.stringify(outputFilepath)
         s.overwrite(match.index, match.index + full.length, replacement, {
           contentOnly: true
         })
       }
 
+      if (s) {
         return {
           code: s.toString(),
-          map: sourcemap ? s.generateMap({ hires: true }) : null
+          map: sourcemap ? s.generateMap({ hires: 'boundary' }) : null
         }
       }
 

src/preview.ts

@@ -11,7 +11,7 @@ export async function preview(inlineConfig: InlineConfig = {}, options: { skipBu
 
   const logger = createLogger(inlineConfig.logLevel)
 
-  startElectron(inlineConfig.root, logger)
+  startElectron(inlineConfig.root)
 
-  logger.info(colors.green(`\nstart electron app...`))
+  logger.info(colors.green(`\nstarting electron app...\n`))
 }

src/server.ts

@@ -1,8 +1,8 @@
-import type { ChildProcessWithoutNullStreams } from 'node:child_process'
+import type { ChildProcess } from 'node:child_process'
 import {
   type UserConfig as ViteConfig,
   type ViteDevServer,
-  createServer as ViteCreateServer,
+  createServer as viteCreateServer,
   build as viteBuild,
   createLogger,
   mergeConfig
@@ -12,60 +12,71 @@ import { type InlineConfig, resolveConfig } from './config'
 import { resolveHostname } from './utils'
 import { startElectron } from './electron'
 
-export async function createServer(inlineConfig: InlineConfig = {}): Promise<void> {
+export async function createServer(
+  inlineConfig: InlineConfig = {},
+  options: { rendererOnly?: boolean }
+): Promise<void> {
   process.env.NODE_ENV_ELECTRON_VITE = 'development'
   const config = await resolveConfig(inlineConfig, 'serve', 'development')
   if (config.config) {
     const logger = createLogger(inlineConfig.logLevel)
 
     let server: ViteDevServer | undefined
-    let ps: ChildProcessWithoutNullStreams | undefined
+    let ps: ChildProcess | undefined
+
+    const errorHook = (e): void => {
+      logger.error(`${colors.bgRed(colors.white(' ERROR '))} ${colors.red(e.message)}`)
+    }
 
     const mainViteConfig = config.config?.main
-    if (mainViteConfig) {
+    if (mainViteConfig && !options.rendererOnly) {
       const watchHook = (): void => {
-        logger.info(colors.green(`\nrebuild the electron main process successfully`))
+        logger.info(colors.green(`\nelectron main process rebuilt successfully`))
 
         if (ps) {
-          logger.info(colors.cyan(`\n  waiting for electron to exit...`))
-
           ps.removeAllListeners()
           ps.kill()
-          ps = startElectron(inlineConfig.root, logger)
+          ps = startElectron(inlineConfig.root)
 
-          logger.info(colors.green(`\nrestart electron app...`))
+          logger.info(colors.green(`\nrestarting electron app...\n`))
         }
       }
 
-      await doBuild(mainViteConfig, watchHook)
+      await doBuild(mainViteConfig, watchHook, errorHook)
 
-      logger.info(colors.green(`\nbuild the electron main process successfully`))
+      logger.info(colors.green(`\nelectron main process built successfully`))
     }
 
     const preloadViteConfig = config.config?.preload
-    if (preloadViteConfig) {
+    if (preloadViteConfig && !options.rendererOnly) {
       logger.info(colors.gray(`\n-----\n`))
 
       const watchHook = (): void => {
-        logger.info(colors.green(`\nrebuild the electron preload files successfully`))
+        logger.info(colors.green(`\nelectron preload scripts rebuilt successfully`))
 
         if (server) {
-          logger.info(colors.cyan(`\n  trigger renderer reload`))
+          logger.info(colors.cyan(`\nreloading electron renderer...\n`))
 
           server.ws.send({ type: 'full-reload' })
         }
       }
 
-      await doBuild(preloadViteConfig, watchHook)
+      await doBuild(preloadViteConfig, watchHook, errorHook)
 
-      logger.info(colors.green(`\nbuild the electron preload files successfully`))
+      logger.info(colors.green(`\nelectron preload scripts built successfully`))
+    }
+
+    if (options.rendererOnly) {
+      logger.warn(
+        `\n${colors.yellow(colors.bold('(!)'))} ${colors.yellow('skipped building main process and preload scripts (using previous build)')}`
+      )
     }
 
     const rendererViteConfig = config.config?.renderer
     if (rendererViteConfig) {
       logger.info(colors.gray(`\n-----\n`))
 
-      server = await ViteCreateServer(rendererViteConfig)
+      server = await viteCreateServer(rendererViteConfig)
 
       if (!server.httpServer) {
         throw new Error('HTTP server not available')
@@ -83,21 +94,21 @@ export async function createServer(inlineConfig: InlineConfig = {}): Promise<voi
       const slogger = server.config.logger
 
       slogger.info(colors.green(`dev server running for the electron renderer process at:\n`), {
-        clear: !slogger.hasWarned
+        clear: !slogger.hasWarned && !options.rendererOnly
       })
 
       server.printUrls()
     }
 
-    ps = startElectron(inlineConfig.root, logger)
+    ps = startElectron(inlineConfig.root)
 
-    logger.info(colors.green(`\nstart electron app...`))
+    logger.info(colors.green(`\nstarting electron app...\n`))
   }
 }
 
 type UserConfig = ViteConfig & { configFile?: string | false }
 
-async function doBuild(config: UserConfig, watchHook: () => void): Promise<void> {
+async function doBuild(config: UserConfig, watchHook: () => void, errorHook: (e: Error) => void): Promise<void> {
   return new Promise(resolve => {
     if (config.build?.watch) {
       let firstBundle = true
@@ -120,10 +131,12 @@ async function doBuild(config: UserConfig, watchHook: () => void): Promise<void>
       })
     }
 
-    viteBuild(config).then(() => {
+    viteBuild(config)
+      .then(() => {
         if (!config.build?.watch) {
           resolve()
         }
       })
+      .catch(e => errorHook(e))
   })
 }

src/utils.ts

@@ -1,11 +1,14 @@
-import { URL, URLSearchParams } from 'node:url'
+/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-function-type */
+import path from 'node:path'
+import fs from 'node:fs'
+import { createHash } from 'node:crypto'
+import { createRequire } from 'node:module'
+import { type LibraryOptions, type Rolldown, loadEnv as viteLoadEnv } from 'vite'
 
 export function isObject(value: unknown): value is Record<string, unknown> {
   return Object.prototype.toString.call(value) === '[object Object]'
 }
 
-export const dynamicImport = new Function('file', 'return import(file)')
-
 export const wildcardHosts = new Set(['0.0.0.0', '::', '0000:0000:0000:0000:0000:0000:0000:0000'])
 
 export function resolveHostname(optionsHost: string | boolean | undefined): string {
@@ -17,10 +20,173 @@ export const hashRE = /#.*$/s
 
 export const cleanUrl = (url: string): string => url.replace(hashRE, '').replace(queryRE, '')
 
-export function parseRequest(id: string): Record<string, string> | null {
+export function getHash(text: Buffer | string): string {
-  const { search } = new URL(id, 'file:')
+  return createHash('sha256')
-  if (!search) {
+    .update(text as unknown as Uint8Array)
-    return null
+    .digest('hex')
-  }
+    .substring(0, 8)
-  return Object.fromEntries(new URLSearchParams(search))
+}
+
+export function toRelativePath(filename: string, importer: string): string {
+  const relPath = path.posix.relative(path.dirname(importer), filename)
+  return relPath.startsWith('.') ? relPath : `./${relPath}`
+}
+
+/**
+ * Resolve configured build outputs into an array.
+ */
+export function resolveBuildOutputs(
+  outputs: Rolldown.OutputOptions | Rolldown.OutputOptions[] | undefined,
+  libOptions: LibraryOptions | false | undefined
+): Rolldown.OutputOptions[] {
+  if (Array.isArray(outputs)) {
+    return outputs
+  }
+  if (libOptions) {
+    const libFormats = libOptions.formats || []
+    return libFormats.map(format => ({ ...outputs, format }))
+  }
+  return outputs ? [outputs] : []
+}
+
+/**
+ * Load `.env` files within the `envDir` (default: `process.cwd()`) .
+ * By default, only env variables prefixed with `VITE_`, `MAIN_VITE_`, `PRELOAD_VITE_` and
+ * `RENDERER_VITE_` are loaded, unless `prefixes` is changed.
+ */
+export function loadEnv(
+  mode: string,
+  envDir: string = process.cwd(),
+  prefixes: string | string[] = ['VITE_', 'MAIN_VITE_', 'PRELOAD_VITE_', 'RENDERER_VITE_']
+): Record<string, string> {
+  return viteLoadEnv(mode, envDir, prefixes)
+}
+
+interface PackageData {
+  main?: string
+  type?: 'module' | 'commonjs'
+  dependencies?: Record<string, string>
+}
+
+let packageCached: PackageData | null = null
+
+export function loadPackageData(root = process.cwd()): PackageData | null {
+  if (packageCached) return packageCached
+  const pkg = path.join(root, 'package.json')
+  if (fs.existsSync(pkg)) {
+    const _require = createRequire(import.meta.url)
+    const data = _require(pkg)
+    packageCached = {
+      main: data.main,
+      type: data.type,
+      dependencies: data.dependencies
+    }
+    return packageCached
+  }
+  return null
+}
+
+export function isFilePathESM(filePath: string): boolean {
+  if (/\.m[jt]s$/.test(filePath) || filePath.endsWith('.ts')) {
+    return true
+  } else if (/\.c[jt]s$/.test(filePath)) {
+    return false
+  } else {
+    const pkg = loadPackageData()
+    return pkg?.type === 'module'
+  }
+}
+
+type DeepWritable<T> =
+  T extends ReadonlyArray<unknown>
+    ? { -readonly [P in keyof T]: DeepWritable<T[P]> }
+    : T extends RegExp
+      ? RegExp
+      : T[keyof T] extends Function
+        ? T
+        : { -readonly [P in keyof T]: DeepWritable<T[P]> }
+
+export function deepClone<T>(value: T): DeepWritable<T> {
+  if (Array.isArray(value)) {
+    return value.map(v => deepClone(v)) as DeepWritable<T>
+  }
+  if (isObject(value)) {
+    const cloned: Record<string, any> = {}
+    for (const key in value) {
+      cloned[key] = deepClone(value[key])
+    }
+    return cloned as DeepWritable<T>
+  }
+  if (typeof value === 'function') {
+    return value as DeepWritable<T>
+  }
+  if (value instanceof RegExp) {
+    return new RegExp(value) as DeepWritable<T>
+  }
+  if (typeof value === 'object' && value != null) {
+    throw new Error('Cannot deep clone non-plain object')
+  }
+  return value as DeepWritable<T>
+}
+
+/**
+ * Isolate configuration data without cloning plugins or runtime instances.
+ * Plugins may capture their own object in hooks, so their identity must survive.
+ */
+export function cloneConfig<T>(config: T): T {
+  const seen = new WeakMap<object, unknown>()
+  const pluginArrays = new WeakMap<object, unknown>()
+
+  function clone(value: unknown, plugins = false): unknown {
+    if (value === null || typeof value !== 'object') return value
+
+    const cache = plugins ? pluginArrays : seen
+    if (cache.has(value)) return cache.get(value)
+
+    if (Array.isArray(value)) {
+      const result: unknown[] = new Array(value.length)
+      cache.set(value, result)
+      value.forEach((item, index) => {
+        result[index] = clone(item, plugins)
+      })
+      return result
+    }
+
+    // Preserve plugin objects, promises and other opaque plugin options.
+    if (plugins) return value
+
+    if (value instanceof RegExp) {
+      const result = new RegExp(value)
+      result.lastIndex = value.lastIndex
+      cache.set(value, result)
+      return result
+    }
+
+    const prototype = Object.getPrototypeOf(value)
+    if (prototype !== Object.prototype && prototype !== null) return value
+
+    const result = Object.create(prototype) as Record<PropertyKey, unknown>
+    cache.set(value, result)
+    for (const key of Reflect.ownKeys(value)) {
+      if (!Object.prototype.propertyIsEnumerable.call(value, key)) continue
+      Object.defineProperty(result, key, {
+        value: clone((value as Record<PropertyKey, unknown>)[key], key === 'plugins'),
+        enumerable: true,
+        configurable: true,
+        writable: true
+      })
+    }
+    return result
+  }
+
+  return clone(config) as T
+}
+
+type AsyncFlatten<T extends unknown[]> = T extends (infer U)[] ? Exclude<Awaited<U>, U[]>[] : never
+
+export async function asyncFlatten<T extends unknown[]>(arr: T): Promise<AsyncFlatten<T>> {
+  do {
+    arr = (await Promise.all(arr)).flat(Infinity) as any
+  } while (arr.some((v: any) => v?.then))
+  return arr as unknown[] as AsyncFlatten<T>
 }

tsconfig.json

@@ -1,23 +1,20 @@
 {
   "compilerOptions": {
-    "target": "es2019",
+    "target": "ES2023",
-    "module": "esnext",
+    "module": "ESNext",
-    "lib": ["esnext"],
+    "lib": ["ESNext"],
     "sourceMap": false,
     "strict": true,
     "allowJs": true,
     "esModuleInterop": true,
-    "moduleResolution": "node",
+    "moduleResolution": "bundler",
     "resolveJsonModule": true,
     "forceConsistentCasingInFileNames": true,
     "skipLibCheck": true,
     "noUnusedLocals": true,
     "noUnusedParameters": true,
     "noImplicitAny": false,
-    "noImplicitReturns": true,
+    "noImplicitReturns": true
-    "declaration": true,
-    "declarationDir": "dist/types",
-    "outDir": "dist"
   },
-  "include": ["src"]
+  "include": ["src", "rollup.config.ts"]
 }