@theholocron/vite-config 4.1.0 → 5.0.0

package/README.md

@@ -0,0 +1,58 @@
+# Vite Config
+
+A [Vite configuration](https://vite.dev/config/) with presets for libraries, React apps, and Node.js tools within the Galaxy.
+
+## Installation
+
+```bash
+npm install --save-dev @theholocron/vite-config
+```
+
+## Usage
+
+Pick the preset that matches your project type. All presets accept an `overrides` object that is deep-merged last via `mergeConfig`.
+
+### Publishable library
+
+Outputs ESM only; externalises `react` and `react-dom` by default.
+
+```javascript
+import { defineConfig } from "vite";
+import { library } from "@theholocron/vite-config/library";
+
+export default defineConfig(
+    library({ entry: "src/index.ts", name: "MyLib" })
+);
+```
+
+### React single-page application
+
+Requires `@vitejs/plugin-react` as a peer dependency. Returns a `Promise` because the plugin is loaded dynamically.
+
+```javascript
+import { defineConfig } from "vite";
+import { reactApp } from "@theholocron/vite-config/react-app";
+
+export default defineConfig(await reactApp());
+```
+
+Pass `vite-tsconfig-paths` via `overrides.plugins` to enable tsconfig path aliases:
+
+```javascript
+import { defineConfig } from "vite";
+import tsconfigPaths from "vite-tsconfig-paths";
+import { reactApp } from "@theholocron/vite-config/react-app";
+
+export default defineConfig(await reactApp({ plugins: [tsconfigPaths()] }));
+```
+
+### Node.js CLI tool or server app
+
+Targets Node 22; outputs a single ESM bundle with no browser polyfills.
+
+```javascript
+import { defineConfig } from "vite";
+import { nodeApp } from "@theholocron/vite-config/node-app";
+
+export default defineConfig(nodeApp({ entry: "src/index.ts" }));
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/vite-config",
-  "version": "4.1.0",
+  "version": "5.0.0",
   "description": "Vite configuration presets for libraries, React apps, and Node tools within the Galaxy.",
   "homepage": "https://github.com/theholocron/configs/tree/main/packages/vite-config#readme",
   "bugs": "https://github.com/theholocron/configs/issues",

package/presets/react-app.js

@@ -1,5 +1,4 @@
 import { mergeConfig } from "vite";
-import react from "@vitejs/plugin-react";
 
 /**
  * Vite preset for React single-page applications.
@@ -7,9 +6,11 @@ import react from "@vitejs/plugin-react";
  * via options.plugins if tsconfig path aliases are needed.
  *
  * @param {import('vite').UserConfig} [overrides={}]
- * @returns {import('vite').UserConfig}
+ * @returns {Promise<import('vite').UserConfig>}
  */
-export function reactApp(overrides = {}) {
+export async function reactApp(overrides = {}) {
+	const { default: react } = await import("@vitejs/plugin-react");
+
 	return mergeConfig(
 		{
 			plugins: [react()],