vite-plugin-openapi-codegen 1.2.1 → 1.2.2

package/README.md

@@ -239,6 +239,8 @@ interface Options {
   pathPrefix?: string;
   stripPrefix?: boolean;
   typeAliases?: boolean;
+  generateOnDev?: boolean;
+  generateOnHmr?: boolean;
   httpClient?: {
     module?: string;
     jsonFunction?: string;
@@ -255,6 +257,14 @@ Path or URL to the OpenAPI JSON/YAML document. Local paths are resolved relative
 
 In dev mode, generation errors are logged and do not stop Vite from starting. In build mode, the plugin is skipped entirely.
 
+### `generateOnDev`
+
+Controls whether the plugin generates artifacts automatically when the Vite dev server starts. The default is `true`. Set it to `false` when you want dev startup to avoid touching generated files and rely on `vg` or another explicit generation step instead. This option only affects the Vite dev lifecycle; the `vg` CLI still generates when invoked.
+
+### `generateOnHmr`
+
+Controls whether the plugin regenerates artifacts through Vite HMR when a local OpenAPI input file changes. The default is `true`. Set it to `false` when local spec edits should not automatically rewrite generated files during an active dev session. Online `http://` and `https://` inputs are still not watched.
+
 ### `output`
 
 Directory where generated files are written, relative to the Vite project root. The `vg` CLI reads this value from `vite.config.*` when present, unless you override it with `--output`.

package/dist/index.d.mts

@@ -78,6 +78,10 @@ interface Options {
   httpClient?: HttpClientConfig;
   /** Generate and consume top-level type aliases. Default: false */
   typeAliases?: boolean;
+  /** Whether to generate during Vite dev server startup. Default: true */
+  generateOnDev?: boolean;
+  /** Whether to regenerate through Vite HMR for local inputs. Default: true */
+  generateOnHmr?: boolean;
 }
 interface GeneratedArtifacts {
   api: string;

package/dist/index.mjs

@@ -677,12 +677,13 @@ function openapiCodegen(options) {
 			command = config.command;
 		},
 		async buildStart() {
-			if (command === "serve") {
+			if (command === "serve" && options.generateOnDev !== false) {
 				runDevelopmentGeneration(root, options);
 				return;
 			}
 		},
 		async handleHotUpdate(ctx) {
+			if (options.generateOnHmr === false) return;
 			if (isHttpUrl(options.input)) return;
 			const inputPath = resolve(root, options.input);
 			if (resolve(ctx.file) !== inputPath) return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-openapi-codegen",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "Vite plugin that generates typed API clients and route builders from OpenAPI specs",
   "keywords": [
     "api-client",