feat: simple API 🥳

Author: caoxiemeihao

README.md

@@ -28,12 +28,12 @@
 
 ## Features
 
-- 🐣 Few APIs, easy to use
-- 🌱 Fully compatible with Vite and Vite's ecosystem <sub><sup>(Based on Vite)</sup></sub>
-- [🚀 Not Bundle, It's fast <sub><sup>(Like Vite's Not Bundle)</sup></sub>](https://github.com/electron-vite/vite-plugin-electron#not-bundle)
 - [🔥 Hot Restart <sub><sup>(Main process)</sup></sub>](https://electron-vite.github.io/guide/features.html#hot-restart)
 - [🔄 Hot Reload <sub><sup>(Preload scripts)</sup></sub>](https://electron-vite.github.io/guide/features.html#hot-reload)
 - [⚡️ HMR <sub><sup>(Renderer process)</sup></sub>](https://electron-vite.github.io/guide/features.html#hmr)
+- [🚀 Not Bundle, It's fast <sub><sup>(Like Vite's Not Bundle)</sup></sub>](https://github.com/electron-vite/vite-plugin-electron#not-bundle)
+- 🌱 Fully compatible with Vite and Vite's ecosystem <sub><sup>(Based on Vite)</sup></sub>
+- 🐣 Few APIs, easy to use
 
 <!-- ![vite-plugin-electron.gif](https://github.com/electron-vite/vite-plugin-electron/blob/main/vite-plugin-electron.gif?raw=true) -->
 
@@ -89,9 +89,33 @@ app.whenReady().then(() => {
 
 That's it! You can now use Electron in your Vite app ✨
 
+## Simple API
+
+Many times, for a developer who is new to Vite and Electron, the oversimplified and open API design is confusing to them. Maybe Simple API makes them easier to understand. :)
+
+```js
+import electron from 'vite-plugin-electron/simple'
+
+export default {
+  plugins: [
+    electron({
+      main: {
+        entry: 'electron/main.ts',
+      },
+      // Optional: input must be use absolute path
+      preload: {
+        input: __dirname + '/electron/preload.ts',
+      },
+      // Optional: Use Node.js API in the Renderer process
+      renderer: {},
+    }),
+  ],
+}
+```
+
 ## API <sub><sup>(Define)</sup></sub>
 
-`electron(config: ElectronOptions | ElectronOptions[])`
+`electron(options: ElectronOptions | ElectronOptions[])`
 
 ```ts
 export interface ElectronOptions {

plugin.d.ts

@@ -0,0 +1,2 @@
+// For import intellisense
+export * from './dist/plugin'

simple.d.ts

@@ -0,0 +1,4 @@
+// For import intellisense
+export * from './dist/simple'
+import simple from './dist/simple'
+export default simple

src/simple.ts

@@ -0,0 +1,78 @@
+import {
+  type Plugin,
+  type UserConfig,
+  mergeConfig,
+} from 'vite'
+import type { InputOption } from 'rollup'
+import electron, { type ElectronOptions } from '.'
+
+export interface ElectronSimpleOptions {
+  main: ElectronOptions
+  preload?: Omit<ElectronOptions, 'entry'> & {
+    /**
+     * Shortcut of `build.rollupOptions.input`.
+     * 
+     * Preload scripts perhaps bundle as web format, so use the `build.rollupOptions.input` instead `build.lib.entry`.
+     */
+    input: InputOption
+  }
+  /**
+   * Support use Node.js API in Electron-Renderer
+   * @see https://github.com/electron-vite/vite-plugin-electron-renderer
+   */
+  renderer?: import('vite-plugin-electron-renderer').RendererOptions
+}
+
+// Vite v3.x support async plugin.
+export default async function electronSimple(options: ElectronSimpleOptions): Promise<Plugin[]> {
+  const opts = [options.main]
+  if (options.preload) {
+    const {
+      input,
+      vite: viteConfig = {},
+      ...preloadOptions
+    } = options.preload
+    const preload: ElectronOptions = {
+      onstart(args) {
+        // Notify the Renderer-Process to reload the page when the Preload-Scripts build is complete, 
+        // instead of restarting the entire Electron App.
+        args.reload()
+      },
+      ...preloadOptions,
+      vite: mergeConfig({
+        build: {
+          rollupOptions: {
+            input,
+            output: {
+              // Only one file will be bundled, which is consistent with the behavior of `build.lib`
+              manualChunks: {},
+              // https://github.com/vitejs/vite/blob/v4.4.9/packages/vite/src/node/build.ts#L604
+              entryFileNames: '[name].js',
+              chunkFileNames: '[name].js',
+              assetFileNames: '[name].[ext]',
+            },
+          },
+        } as UserConfig,
+      }, viteConfig),
+    }
+    opts.push(preload)
+  }
+  const plugins = electron(opts)
+
+  if (options.renderer) {
+    try {
+      const renderer = await import('vite-plugin-electron-renderer')
+      plugins.push(renderer.default(options.renderer))
+    } catch (error: any) {
+      if (error.code === 'ERR_MODULE_NOT_FOUND') {
+        throw new Error(
+          `\`renderer\` option dependency "vite-plugin-electron-renderer" not found. Did you install it? Try \`npm i -D vite-plugin-electron-renderer\`.`,
+        )
+      }
+
+      throw error
+    }
+  }
+
+  return plugins
+}