vite-plugin-typed-env 0.1.2 → 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vite-plugin-typed-env contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -197,4 +197,4 @@ Files are loaded in this order (later overrides earlier):
 
 ## License
 
-MIT
+MIT

package/dist/index.cjs

@@ -28,84 +28,102 @@ let node_fs = require("node:fs");
 node_fs = __toESM(node_fs);
 let node_path = require("node:path");
 node_path = __toESM(node_path);
-//#region src/parser.ts
-const ANNOTATION_RE = /^#\s*@(\w+)(?::\s*(.+))?$/;
-function parseAnnotations(lines) {
-	const ann = {};
-	for (const line of lines) {
-		const m = line.match(ANNOTATION_RE);
-		if (!m) continue;
-		const [, key, value] = m;
-		if (key === "optional") ann.optional = true;
-		else if (key === "type" && value) ann.type = value.trim();
-		else if (key === "default" && value) ann.default = value.trim();
-		else if (key === "desc" && value) ann.description = value.trim();
-	}
-	return ann;
-}
-function parseEnvFile(content) {
-	const lines = content.split("\n");
-	const entries = [];
-	const pendingComments = [];
-	for (let i = 0; i < lines.length; i++) {
-		const raw = lines[i].trim();
-		if (raw === "") {
-			pendingComments.length = 0;
-			continue;
+//#region src/generator.ts
+function generateDts(items, options) {
+	const lines = [];
+	lines.push(`// Auto-generated by vite-plugin-typed-env. DO NOT EDIT.`);
+	lines.push(`// Re-run vite to regenerate this file.`);
+	lines.push(``);
+	if (options.augmentImportMeta) {
+		lines.push(`/// <reference types="vite/client" />`);
+		lines.push(``);
+		lines.push(`interface ImportMetaEnv {`);
+		for (const { entry, inferred } of items) {
+			if (entry.annotations.description) lines.push(`  /** ${entry.annotations.description} */`);
+			const opt = inferred.isOptional ? "?" : "";
+			lines.push(`  readonly ${entry.key}${opt}: ${inferred.tsType}`);
 		}
-		if (raw.startsWith("#")) {
-			pendingComments.push(raw);
-			continue;
+		lines.push(`}`);
+		lines.push(``);
+		lines.push(`interface ImportMeta {`);
+		lines.push(`  readonly env: ImportMetaEnv`);
+		lines.push(`}`);
+	} else {
+		lines.push(`export interface Env {`);
+		for (const { entry, inferred } of items) {
+			if (entry.annotations.description) lines.push(`  /** ${entry.annotations.description} */`);
+			const opt = inferred.isOptional ? "?" : "";
+			lines.push(`  ${entry.key}${opt}: ${inferred.tsType}`);
 		}
-		const eqIdx = raw.indexOf("=");
-		if (eqIdx === -1) continue;
-		const key = raw.slice(0, eqIdx).trim();
-		let value = raw.slice(eqIdx + 1).trim();
-		if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) value = value.slice(1, -1);
-		const annotations = parseAnnotations(pendingComments);
-		const description = pendingComments.filter((l) => !ANNOTATION_RE.test(l)).map((l) => l.replace(/^#\s*/, "")).join(" ").trim();
-		entries.push({
-			key,
-			value,
-			annotations: {
-				...annotations,
-				description: description || void 0
-			},
-			comment: ""
-		});
-		pendingComments.length = 0;
+		lines.push(`}`);
 	}
-	return entries;
-}
-//#endregion
-//#region src/inferrer.ts
-function isBoolean(v) {
-	return [
-		"true",
-		"false",
-		"1",
-		"0",
-		"yes",
-		"no"
-	].includes(v.toLowerCase());
-}
-function isNumber(v) {
-	return v !== "" && !isNaN(Number(v));
+	return lines.join("\n");
 }
-function isUrl(v) {
-	try {
-		new URL(v);
-		return v.startsWith("http://") || v.startsWith("https://") || v.includes("://");
-	} catch {
-		return false;
+function generateLoader(items, options) {
+	const lines = [];
+	lines.push(`// Auto-generated by vite-plugin-typed-env. DO NOT EDIT.`);
+	lines.push(``);
+	if (options.schema === "zod") {
+		lines.push(`import { envSchema } from './env.schema'`);
+		lines.push(``);
+		lines.push(`const _parsed = envSchema.safeParse(import.meta.env)`);
+		lines.push(``);
+		lines.push(`if (!_parsed.success) {`);
+		lines.push(`  const errors = _parsed.error.flatten().fieldErrors`);
+		lines.push(`  const msg = Object.entries(errors)`);
+		lines.push(`    .map(([k, v]) => \`  \${k}: \${(v as string[]).join(', ')}\`)`);
+		lines.push(`    .join('\\n')`);
+		lines.push(`  throw new Error(\`[env-ts] Invalid environment variables:\\n\${msg}\`)`);
+		lines.push(`}`);
+		lines.push(``);
+		lines.push(`export const env = _parsed.data`);
+		lines.push(`export default env`);
+	} else {
+		const required = items.filter(({ inferred }) => !inferred.isOptional);
+		lines.push(`const _raw = import.meta.env`);
+		lines.push(``);
+		if (required.length > 0) {
+			lines.push(`const _required = [${required.map(({ entry }) => `'${entry.key}'`).join(", ")}] as const`);
+			lines.push(`for (const key of _required) {`);
+			lines.push(`  if (!_raw[key]) throw new Error(\`[env-ts] Missing required env var: \${key}\`)`);
+			lines.push(`}`);
+			lines.push(``);
+		}
+		lines.push(`export const env = _raw as import('./env').Env`);
+		lines.push(`export default env`);
 	}
+	return lines.join("\n");
 }
-function isNumberArray(v) {
-	if (!v.includes(",")) return false;
-	return v.split(",").every((s) => isNumber(s.trim()));
+function generateZodSchema(items) {
+	const lines = [];
+	lines.push(`// Auto-generated by vite-plugin-typed-env. DO NOT EDIT.`);
+	lines.push(`import { z } from 'zod'`);
+	lines.push(``);
+	lines.push(`export const envSchema = z.object({`);
+	for (const { entry, inferred } of items) {
+		if (entry.annotations.description) lines.push(`  // ${entry.annotations.description}`);
+		lines.push(`  ${entry.key}: ${inferred.zodSchema},`);
+	}
+	lines.push(`})`);
+	lines.push(``);
+	lines.push(`export type Env = z.infer<typeof envSchema>`);
+	return lines.join("\n");
 }
-function isStringArray(v) {
-	return v.includes(",") && v.split(",").length > 1;
+//#endregion
+//#region src/inferrer.ts
+function inferType(entry) {
+	const { annotations, value } = entry;
+	const isOptional = annotations.optional === true || value === "";
+	const base = (annotations.type ? inferFromAnnotation(annotations.type) : null) ?? inferFromValue(value);
+	let zodSchema = base.zodSchema;
+	if (annotations.default !== void 0) zodSchema = `${zodSchema}.default('${annotations.default}')`;
+	else if (isOptional) zodSchema = `${zodSchema}.optional()`;
+	return {
+		defaultValue: annotations.default,
+		isOptional,
+		tsType: base.tsType,
+		zodSchema
+	};
 }
 function inferFromAnnotation(ann) {
 	const enumMatch = ann.match(/^enum\((.+)\)$/);
@@ -176,104 +194,117 @@ function inferFromValue(value) {
 		zodSchema: "z.string().min(1)"
 	};
 }
-function inferType(entry) {
-	const { value, annotations } = entry;
-	const isOptional = annotations.optional === true || value === "";
-	const base = (annotations.type ? inferFromAnnotation(annotations.type) : null) ?? inferFromValue(value);
-	let zodSchema = base.zodSchema;
-	if (annotations.default !== void 0) zodSchema = `${zodSchema}.default('${annotations.default}')`;
-	else if (isOptional) zodSchema = `${zodSchema}.optional()`;
-	return {
-		tsType: base.tsType,
-		zodSchema,
-		isOptional,
-		defaultValue: annotations.default
-	};
+function isBoolean(v) {
+	return [
+		"0",
+		"1",
+		"false",
+		"no",
+		"true",
+		"yes"
+	].includes(v.toLowerCase());
+}
+function isNumber(v) {
+	return v !== "" && !isNaN(Number(v));
+}
+function isNumberArray(v) {
+	if (!v.includes(",")) return false;
+	return v.split(",").every((s) => isNumber(s.trim()));
+}
+function isStringArray(v) {
+	return v.includes(",") && v.split(",").length > 1;
+}
+function isUrl(v) {
+	try {
+		new URL(v);
+		return v.startsWith("http://") || v.startsWith("https://") || v.includes("://");
+	} catch {
+		return false;
+	}
 }
 //#endregion
-//#region src/generator.ts
-function generateDts(items, options) {
-	const lines = [];
-	lines.push(`// Auto-generated by vite-plugin-typed-env. DO NOT EDIT.`);
-	lines.push(`// Re-run vite to regenerate this file.`);
-	lines.push(``);
-	if (options.augmentImportMeta) {
-		lines.push(`/// <reference types="vite/client" />`);
-		lines.push(``);
-		lines.push(`interface ImportMetaEnv {`);
-		for (const { entry, inferred } of items) {
-			if (entry.annotations.description) lines.push(`  /** ${entry.annotations.description} */`);
-			const opt = inferred.isOptional ? "?" : "";
-			lines.push(`  readonly ${entry.key}${opt}: ${inferred.tsType}`);
+//#region src/parser.ts
+const ANNOTATION_RE = /^#\s*@(\w+)(?::\s*(.+))?$/;
+function parseEnvFile(content) {
+	const lines = content.split("\n");
+	const entries = [];
+	const pendingComments = [];
+	for (let i = 0; i < lines.length; i++) {
+		const raw = lines[i].trim();
+		if (raw === "") {
+			pendingComments.length = 0;
+			continue;
 		}
-		lines.push(`}`);
-		lines.push(``);
-		lines.push(`interface ImportMeta {`);
-		lines.push(`  readonly env: ImportMetaEnv`);
-		lines.push(`}`);
-	} else {
-		lines.push(`export interface Env {`);
-		for (const { entry, inferred } of items) {
-			if (entry.annotations.description) lines.push(`  /** ${entry.annotations.description} */`);
-			const opt = inferred.isOptional ? "?" : "";
-			lines.push(`  ${entry.key}${opt}: ${inferred.tsType}`);
+		if (raw.startsWith("#")) {
+			pendingComments.push(raw);
+			continue;
 		}
-		lines.push(`}`);
-	}
-	return lines.join("\n");
-}
-function generateZodSchema(items) {
-	const lines = [];
-	lines.push(`// Auto-generated by vite-plugin-typed-env. DO NOT EDIT.`);
-	lines.push(`import { z } from 'zod'`);
-	lines.push(``);
-	lines.push(`export const envSchema = z.object({`);
-	for (const { entry, inferred } of items) {
-		if (entry.annotations.description) lines.push(`  // ${entry.annotations.description}`);
-		lines.push(`  ${entry.key}: ${inferred.zodSchema},`);
+		const eqIdx = raw.indexOf("=");
+		if (eqIdx === -1) continue;
+		const key = raw.slice(0, eqIdx).trim();
+		let value = raw.slice(eqIdx + 1).trim();
+		if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) value = value.slice(1, -1);
+		const annotations = parseAnnotations(pendingComments);
+		const description = pendingComments.filter((l) => !ANNOTATION_RE.test(l)).map((l) => l.replace(/^#\s*/, "")).join(" ").trim();
+		entries.push({
+			annotations: {
+				...annotations,
+				description: description || void 0
+			},
+			comment: "",
+			key,
+			value
+		});
+		pendingComments.length = 0;
 	}
-	lines.push(`})`);
-	lines.push(``);
-	lines.push(`export type Env = z.infer<typeof envSchema>`);
-	return lines.join("\n");
+	return entries;
 }
-function generateLoader(items, options) {
-	const lines = [];
-	lines.push(`// Auto-generated by vite-plugin-typed-env. DO NOT EDIT.`);
-	lines.push(``);
-	if (options.schema === "zod") {
-		lines.push(`import { envSchema } from './env.schema'`);
-		lines.push(``);
-		lines.push(`const _parsed = envSchema.safeParse(import.meta.env)`);
-		lines.push(``);
-		lines.push(`if (!_parsed.success) {`);
-		lines.push(`  const errors = _parsed.error.flatten().fieldErrors`);
-		lines.push(`  const msg = Object.entries(errors)`);
-		lines.push(`    .map(([k, v]) => \`  \${k}: \${(v as string[]).join(', ')}\`)`);
-		lines.push(`    .join('\\n')`);
-		lines.push(`  throw new Error(\`[env-ts] Invalid environment variables:\\n\${msg}\`)`);
-		lines.push(`}`);
-		lines.push(``);
-		lines.push(`export const env = _parsed.data`);
-		lines.push(`export default env`);
-	} else {
-		const required = items.filter(({ inferred }) => !inferred.isOptional);
-		lines.push(`const _raw = import.meta.env`);
-		lines.push(``);
-		if (required.length > 0) {
-			lines.push(`const _required = [${required.map(({ entry }) => `'${entry.key}'`).join(", ")}] as const`);
-			lines.push(`for (const key of _required) {`);
-			lines.push(`  if (!_raw[key]) throw new Error(\`[env-ts] Missing required env var: \${key}\`)`);
-			lines.push(`}`);
-			lines.push(``);
-		}
-		lines.push(`export const env = _raw as import('./env').Env`);
-		lines.push(`export default env`);
+function parseAnnotations(lines) {
+	const ann = {};
+	for (const line of lines) {
+		const m = line.match(ANNOTATION_RE);
+		if (!m) continue;
+		const [, key, value] = m;
+		if (key === "optional") ann.optional = true;
+		else if (key === "type" && value) ann.type = value.trim();
+		else if (key === "default" && value) ann.default = value.trim();
+		else if (key === "desc" && value) ann.description = value.trim();
 	}
-	return lines.join("\n");
+	return ann;
 }
 //#endregion
 //#region src/index.ts
+function envTs(userOptions = {}) {
+	const options = {
+		augmentImportMeta: true,
+		envFiles: [],
+		output: "src",
+		schema: "zod",
+		strict: true,
+		...userOptions
+	};
+	let config;
+	let outputDir;
+	return {
+		async buildStart() {
+			await generateTypes(config.envDir === false ? config.root : config.envDir, outputDir, options);
+		},
+		configResolved(resolvedConfig) {
+			config = resolvedConfig;
+			outputDir = node_path.default.resolve(config.root, options.output);
+		},
+		enforce: "pre",
+		async handleHotUpdate({ file, server }) {
+			if (!file) return;
+			const fileName = node_path.default.basename(file);
+			if (!(fileName.startsWith(".env") || options.envFiles.includes(file))) return;
+			console.log(`[env-ts] Detected change in ${fileName}, regenerating...`);
+			await generateTypes(config.envDir === false ? config.root : config.envDir, outputDir, options);
+			server.hot.send({ type: "full-reload" });
+		},
+		name: "vite-plugin-typed-env"
+	};
+}
 async function generateTypes(envDir, outputDir, options) {
 	const envFileNames = [
 		".env",
@@ -310,8 +341,8 @@ async function generateTypes(envDir, outputDir, options) {
 	}
 	node_fs.default.mkdirSync(outputDir, { recursive: true });
 	const genOptions = {
-		schema: options.schema,
-		augmentImportMeta: options.augmentImportMeta
+		augmentImportMeta: options.augmentImportMeta,
+		schema: options.schema
 	};
 	const dtsContent = generateDts(items, genOptions);
 	writeIfChanged(node_path.default.join(outputDir, "env.d.ts"), dtsContent);
@@ -329,37 +360,6 @@ function writeIfChanged(filePath, content) {
 	}
 	node_fs.default.writeFileSync(filePath, content, "utf-8");
 }
-function envTs(userOptions = {}) {
-	const options = {
-		schema: "zod",
-		output: "src",
-		augmentImportMeta: true,
-		strict: true,
-		envFiles: [],
-		...userOptions
-	};
-	let config;
-	let outputDir;
-	return {
-		name: "vite-plugin-typed-env",
-		enforce: "pre",
-		configResolved(resolvedConfig) {
-			config = resolvedConfig;
-			outputDir = node_path.default.resolve(config.root, options.output);
-		},
-		async buildStart() {
-			await generateTypes(config.envDir === false ? config.root : config.envDir, outputDir, options);
-		},
-		async handleHotUpdate({ file, server }) {
-			if (!file) return;
-			const fileName = node_path.default.basename(file);
-			if (!(fileName.startsWith(".env") || options.envFiles.includes(file))) return;
-			console.log(`[env-ts] Detected change in ${fileName}, regenerating...`);
-			await generateTypes(config.envDir === false ? config.root : config.envDir, outputDir, options);
-			server.hot.send({ type: "full-reload" });
-		}
-	};
-}
 //#endregion
 exports.default = envTs;
 exports.generateTypes = generateTypes;

package/dist/index.d.cts

@@ -3,33 +3,33 @@ import { Plugin } from "vite";
 //#region src/index.d.ts
 interface EnvTsOptions {
   /**
-   * 生成 Zod schema 文件
-   * @default 'zod'
+   * 是否扩展 Vite 的 ImportMetaEnv 类型
+   * 开启后 import.meta.env.YOUR_VAR 自动有类型
+   * @default true
    */
-  schema?: 'zod' | false;
+  augmentImportMeta?: boolean;
+  /**
+   * 额外监听的 .env 文件（默认自动检测 .env, .env.local 等）
+   */
+  envFiles?: string[];
   /**
    * 生成文件的输出目录（相对于项目根目录）
    * @default 'src'
    */
   output?: string;
   /**
-   * 是否扩展 Vite 的 ImportMetaEnv 类型
-   * 开启后 import.meta.env.YOUR_VAR 自动有类型
-   * @default true
+   * 生成 Zod schema 文件
+   * @default 'zod'
    */
-  augmentImportMeta?: boolean;
+  schema?: 'zod' | false;
   /**
    * 缺失必填变量时是否让构建失败
    * @default true
    */
   strict?: boolean;
-  /**
-   * 额外监听的 .env 文件（默认自动检测 .env, .env.local 等）
-   */
-  envFiles?: string[];
 }
-declare function generateTypes(envDir: string, outputDir: string, options: Required<EnvTsOptions>): Promise<void>;
 declare function envTs(userOptions?: EnvTsOptions): Plugin;
+declare function generateTypes(envDir: string, outputDir: string, options: Required<EnvTsOptions>): Promise<void>;
 //#endregion
 export { EnvTsOptions, envTs as default, generateTypes };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -3,33 +3,33 @@ import { Plugin } from "vite";
 //#region src/index.d.ts
 interface EnvTsOptions {
   /**
-   * 生成 Zod schema 文件
-   * @default 'zod'
+   * 是否扩展 Vite 的 ImportMetaEnv 类型
+   * 开启后 import.meta.env.YOUR_VAR 自动有类型
+   * @default true
    */
-  schema?: 'zod' | false;
+  augmentImportMeta?: boolean;
+  /**
+   * 额外监听的 .env 文件（默认自动检测 .env, .env.local 等）
+   */
+  envFiles?: string[];
   /**
    * 生成文件的输出目录（相对于项目根目录）
    * @default 'src'
    */
   output?: string;
   /**
-   * 是否扩展 Vite 的 ImportMetaEnv 类型
-   * 开启后 import.meta.env.YOUR_VAR 自动有类型
-   * @default true
+   * 生成 Zod schema 文件
+   * @default 'zod'
    */
-  augmentImportMeta?: boolean;
+  schema?: 'zod' | false;
   /**
    * 缺失必填变量时是否让构建失败
    * @default true
    */
   strict?: boolean;
-  /**
-   * 额外监听的 .env 文件（默认自动检测 .env, .env.local 等）
-   */
-  envFiles?: string[];
 }
-declare function generateTypes(envDir: string, outputDir: string, options: Required<EnvTsOptions>): Promise<void>;
 declare function envTs(userOptions?: EnvTsOptions): Plugin;
+declare function generateTypes(envDir: string, outputDir: string, options: Required<EnvTsOptions>): Promise<void>;
 //#endregion
 export { EnvTsOptions, envTs as default, generateTypes };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,83 +1,101 @@
 import fs from "node:fs";
 import path from "node:path";
-//#region src/parser.ts
-const ANNOTATION_RE = /^#\s*@(\w+)(?::\s*(.+))?$/;
-function parseAnnotations(lines) {
-	const ann = {};
-	for (const line of lines) {
-		const m = line.match(ANNOTATION_RE);
-		if (!m) continue;
-		const [, key, value] = m;
-		if (key === "optional") ann.optional = true;
-		else if (key === "type" && value) ann.type = value.trim();
-		else if (key === "default" && value) ann.default = value.trim();
-		else if (key === "desc" && value) ann.description = value.trim();
-	}
-	return ann;
-}
-function parseEnvFile(content) {
-	const lines = content.split("\n");
-	const entries = [];
-	const pendingComments = [];
-	for (let i = 0; i < lines.length; i++) {
-		const raw = lines[i].trim();
-		if (raw === "") {
-			pendingComments.length = 0;
-			continue;
+//#region src/generator.ts
+function generateDts(items, options) {
+	const lines = [];
+	lines.push(`// Auto-generated by vite-plugin-typed-env. DO NOT EDIT.`);
+	lines.push(`// Re-run vite to regenerate this file.`);
+	lines.push(``);
+	if (options.augmentImportMeta) {
+		lines.push(`/// <reference types="vite/client" />`);
+		lines.push(``);
+		lines.push(`interface ImportMetaEnv {`);
+		for (const { entry, inferred } of items) {
+			if (entry.annotations.description) lines.push(`  /** ${entry.annotations.description} */`);
+			const opt = inferred.isOptional ? "?" : "";
+			lines.push(`  readonly ${entry.key}${opt}: ${inferred.tsType}`);
 		}
-		if (raw.startsWith("#")) {
-			pendingComments.push(raw);
-			continue;
+		lines.push(`}`);
+		lines.push(``);
+		lines.push(`interface ImportMeta {`);
+		lines.push(`  readonly env: ImportMetaEnv`);
+		lines.push(`}`);
+	} else {
+		lines.push(`export interface Env {`);
+		for (const { entry, inferred } of items) {
+			if (entry.annotations.description) lines.push(`  /** ${entry.annotations.description} */`);
+			const opt = inferred.isOptional ? "?" : "";
+			lines.push(`  ${entry.key}${opt}: ${inferred.tsType}`);
 		}
-		const eqIdx = raw.indexOf("=");
-		if (eqIdx === -1) continue;
-		const key = raw.slice(0, eqIdx).trim();
-		let value = raw.slice(eqIdx + 1).trim();
-		if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) value = value.slice(1, -1);
-		const annotations = parseAnnotations(pendingComments);
-		const description = pendingComments.filter((l) => !ANNOTATION_RE.test(l)).map((l) => l.replace(/^#\s*/, "")).join(" ").trim();
-		entries.push({
-			key,
-			value,
-			annotations: {
-				...annotations,
-				description: description || void 0
-			},
-			comment: ""
-		});
-		pendingComments.length = 0;
+		lines.push(`}`);
 	}
-	return entries;
-}
-//#endregion
-//#region src/inferrer.ts
-function isBoolean(v) {
-	return [
-		"true",
-		"false",
-		"1",
-		"0",
-		"yes",
-		"no"
-	].includes(v.toLowerCase());
-}
-function isNumber(v) {
-	return v !== "" && !isNaN(Number(v));
+	return lines.join("\n");
 }
-function isUrl(v) {
-	try {
-		new URL(v);
-		return v.startsWith("http://") || v.startsWith("https://") || v.includes("://");
-	} catch {
-		return false;
+function generateLoader(items, options) {
+	const lines = [];
+	lines.push(`// Auto-generated by vite-plugin-typed-env. DO NOT EDIT.`);
+	lines.push(``);
+	if (options.schema === "zod") {
+		lines.push(`import { envSchema } from './env.schema'`);
+		lines.push(``);
+		lines.push(`const _parsed = envSchema.safeParse(import.meta.env)`);
+		lines.push(``);
+		lines.push(`if (!_parsed.success) {`);
+		lines.push(`  const errors = _parsed.error.flatten().fieldErrors`);
+		lines.push(`  const msg = Object.entries(errors)`);
+		lines.push(`    .map(([k, v]) => \`  \${k}: \${(v as string[]).join(', ')}\`)`);
+		lines.push(`    .join('\\n')`);
+		lines.push(`  throw new Error(\`[env-ts] Invalid environment variables:\\n\${msg}\`)`);
+		lines.push(`}`);
+		lines.push(``);
+		lines.push(`export const env = _parsed.data`);
+		lines.push(`export default env`);
+	} else {
+		const required = items.filter(({ inferred }) => !inferred.isOptional);
+		lines.push(`const _raw = import.meta.env`);
+		lines.push(``);
+		if (required.length > 0) {
+			lines.push(`const _required = [${required.map(({ entry }) => `'${entry.key}'`).join(", ")}] as const`);
+			lines.push(`for (const key of _required) {`);
+			lines.push(`  if (!_raw[key]) throw new Error(\`[env-ts] Missing required env var: \${key}\`)`);
+			lines.push(`}`);
+			lines.push(``);
+		}
+		lines.push(`export const env = _raw as import('./env').Env`);
+		lines.push(`export default env`);
 	}
+	return lines.join("\n");
 }
-function isNumberArray(v) {
-	if (!v.includes(",")) return false;
-	return v.split(",").every((s) => isNumber(s.trim()));
+function generateZodSchema(items) {
+	const lines = [];
+	lines.push(`// Auto-generated by vite-plugin-typed-env. DO NOT EDIT.`);
+	lines.push(`import { z } from 'zod'`);
+	lines.push(``);
+	lines.push(`export const envSchema = z.object({`);
+	for (const { entry, inferred } of items) {
+		if (entry.annotations.description) lines.push(`  // ${entry.annotations.description}`);
+		lines.push(`  ${entry.key}: ${inferred.zodSchema},`);
+	}
+	lines.push(`})`);
+	lines.push(``);
+	lines.push(`export type Env = z.infer<typeof envSchema>`);
+	return lines.join("\n");
 }
-function isStringArray(v) {
-	return v.includes(",") && v.split(",").length > 1;
+//#endregion
+//#region src/inferrer.ts
+function inferType(entry) {
+	const { annotations, value } = entry;
+	const isOptional = annotations.optional === true || value === "";
+	const base = (annotations.type ? inferFromAnnotation(annotations.type) : null) ?? inferFromValue(value);
+	let zodSchema = base.zodSchema;
+	if (annotations.default !== void 0) zodSchema = `${zodSchema}.default('${annotations.default}')`;
+	else if (isOptional) zodSchema = `${zodSchema}.optional()`;
+	return {
+		defaultValue: annotations.default,
+		isOptional,
+		tsType: base.tsType,
+		zodSchema
+	};
 }
 function inferFromAnnotation(ann) {
 	const enumMatch = ann.match(/^enum\((.+)\)$/);
@@ -148,104 +166,117 @@ function inferFromValue(value) {
 		zodSchema: "z.string().min(1)"
 	};
 }
-function inferType(entry) {
-	const { value, annotations } = entry;
-	const isOptional = annotations.optional === true || value === "";
-	const base = (annotations.type ? inferFromAnnotation(annotations.type) : null) ?? inferFromValue(value);
-	let zodSchema = base.zodSchema;
-	if (annotations.default !== void 0) zodSchema = `${zodSchema}.default('${annotations.default}')`;
-	else if (isOptional) zodSchema = `${zodSchema}.optional()`;
-	return {
-		tsType: base.tsType,
-		zodSchema,
-		isOptional,
-		defaultValue: annotations.default
-	};
+function isBoolean(v) {
+	return [
+		"0",
+		"1",
+		"false",
+		"no",
+		"true",
+		"yes"
+	].includes(v.toLowerCase());
+}
+function isNumber(v) {
+	return v !== "" && !isNaN(Number(v));
+}
+function isNumberArray(v) {
+	if (!v.includes(",")) return false;
+	return v.split(",").every((s) => isNumber(s.trim()));
+}
+function isStringArray(v) {
+	return v.includes(",") && v.split(",").length > 1;
+}
+function isUrl(v) {
+	try {
+		new URL(v);
+		return v.startsWith("http://") || v.startsWith("https://") || v.includes("://");
+	} catch {
+		return false;
+	}
 }
 //#endregion
-//#region src/generator.ts
-function generateDts(items, options) {
-	const lines = [];
-	lines.push(`// Auto-generated by vite-plugin-typed-env. DO NOT EDIT.`);
-	lines.push(`// Re-run vite to regenerate this file.`);
-	lines.push(``);
-	if (options.augmentImportMeta) {
-		lines.push(`/// <reference types="vite/client" />`);
-		lines.push(``);
-		lines.push(`interface ImportMetaEnv {`);
-		for (const { entry, inferred } of items) {
-			if (entry.annotations.description) lines.push(`  /** ${entry.annotations.description} */`);
-			const opt = inferred.isOptional ? "?" : "";
-			lines.push(`  readonly ${entry.key}${opt}: ${inferred.tsType}`);
+//#region src/parser.ts
+const ANNOTATION_RE = /^#\s*@(\w+)(?::\s*(.+))?$/;
+function parseEnvFile(content) {
+	const lines = content.split("\n");
+	const entries = [];
+	const pendingComments = [];
+	for (let i = 0; i < lines.length; i++) {
+		const raw = lines[i].trim();
+		if (raw === "") {
+			pendingComments.length = 0;
+			continue;
 		}
-		lines.push(`}`);
-		lines.push(``);
-		lines.push(`interface ImportMeta {`);
-		lines.push(`  readonly env: ImportMetaEnv`);
-		lines.push(`}`);
-	} else {
-		lines.push(`export interface Env {`);
-		for (const { entry, inferred } of items) {
-			if (entry.annotations.description) lines.push(`  /** ${entry.annotations.description} */`);
-			const opt = inferred.isOptional ? "?" : "";
-			lines.push(`  ${entry.key}${opt}: ${inferred.tsType}`);
+		if (raw.startsWith("#")) {
+			pendingComments.push(raw);
+			continue;
 		}
-		lines.push(`}`);
-	}
-	return lines.join("\n");
-}
-function generateZodSchema(items) {
-	const lines = [];
-	lines.push(`// Auto-generated by vite-plugin-typed-env. DO NOT EDIT.`);
-	lines.push(`import { z } from 'zod'`);
-	lines.push(``);
-	lines.push(`export const envSchema = z.object({`);
-	for (const { entry, inferred } of items) {
-		if (entry.annotations.description) lines.push(`  // ${entry.annotations.description}`);
-		lines.push(`  ${entry.key}: ${inferred.zodSchema},`);
+		const eqIdx = raw.indexOf("=");
+		if (eqIdx === -1) continue;
+		const key = raw.slice(0, eqIdx).trim();
+		let value = raw.slice(eqIdx + 1).trim();
+		if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) value = value.slice(1, -1);
+		const annotations = parseAnnotations(pendingComments);
+		const description = pendingComments.filter((l) => !ANNOTATION_RE.test(l)).map((l) => l.replace(/^#\s*/, "")).join(" ").trim();
+		entries.push({
+			annotations: {
+				...annotations,
+				description: description || void 0
+			},
+			comment: "",
+			key,
+			value
+		});
+		pendingComments.length = 0;
 	}
-	lines.push(`})`);
-	lines.push(``);
-	lines.push(`export type Env = z.infer<typeof envSchema>`);
-	return lines.join("\n");
+	return entries;
 }
-function generateLoader(items, options) {
-	const lines = [];
-	lines.push(`// Auto-generated by vite-plugin-typed-env. DO NOT EDIT.`);
-	lines.push(``);
-	if (options.schema === "zod") {
-		lines.push(`import { envSchema } from './env.schema'`);
-		lines.push(``);
-		lines.push(`const _parsed = envSchema.safeParse(import.meta.env)`);
-		lines.push(``);
-		lines.push(`if (!_parsed.success) {`);
-		lines.push(`  const errors = _parsed.error.flatten().fieldErrors`);
-		lines.push(`  const msg = Object.entries(errors)`);
-		lines.push(`    .map(([k, v]) => \`  \${k}: \${(v as string[]).join(', ')}\`)`);
-		lines.push(`    .join('\\n')`);
-		lines.push(`  throw new Error(\`[env-ts] Invalid environment variables:\\n\${msg}\`)`);
-		lines.push(`}`);
-		lines.push(``);
-		lines.push(`export const env = _parsed.data`);
-		lines.push(`export default env`);
-	} else {
-		const required = items.filter(({ inferred }) => !inferred.isOptional);
-		lines.push(`const _raw = import.meta.env`);
-		lines.push(``);
-		if (required.length > 0) {
-			lines.push(`const _required = [${required.map(({ entry }) => `'${entry.key}'`).join(", ")}] as const`);
-			lines.push(`for (const key of _required) {`);
-			lines.push(`  if (!_raw[key]) throw new Error(\`[env-ts] Missing required env var: \${key}\`)`);
-			lines.push(`}`);
-			lines.push(``);
-		}
-		lines.push(`export const env = _raw as import('./env').Env`);
-		lines.push(`export default env`);
+function parseAnnotations(lines) {
+	const ann = {};
+	for (const line of lines) {
+		const m = line.match(ANNOTATION_RE);
+		if (!m) continue;
+		const [, key, value] = m;
+		if (key === "optional") ann.optional = true;
+		else if (key === "type" && value) ann.type = value.trim();
+		else if (key === "default" && value) ann.default = value.trim();
+		else if (key === "desc" && value) ann.description = value.trim();
 	}
-	return lines.join("\n");
+	return ann;
 }
 //#endregion
 //#region src/index.ts
+function envTs(userOptions = {}) {
+	const options = {
+		augmentImportMeta: true,
+		envFiles: [],
+		output: "src",
+		schema: "zod",
+		strict: true,
+		...userOptions
+	};
+	let config;
+	let outputDir;
+	return {
+		async buildStart() {
+			await generateTypes(config.envDir === false ? config.root : config.envDir, outputDir, options);
+		},
+		configResolved(resolvedConfig) {
+			config = resolvedConfig;
+			outputDir = path.resolve(config.root, options.output);
+		},
+		enforce: "pre",
+		async handleHotUpdate({ file, server }) {
+			if (!file) return;
+			const fileName = path.basename(file);
+			if (!(fileName.startsWith(".env") || options.envFiles.includes(file))) return;
+			console.log(`[env-ts] Detected change in ${fileName}, regenerating...`);
+			await generateTypes(config.envDir === false ? config.root : config.envDir, outputDir, options);
+			server.hot.send({ type: "full-reload" });
+		},
+		name: "vite-plugin-typed-env"
+	};
+}
 async function generateTypes(envDir, outputDir, options) {
 	const envFileNames = [
 		".env",
@@ -282,8 +313,8 @@ async function generateTypes(envDir, outputDir, options) {
 	}
 	fs.mkdirSync(outputDir, { recursive: true });
 	const genOptions = {
-		schema: options.schema,
-		augmentImportMeta: options.augmentImportMeta
+		augmentImportMeta: options.augmentImportMeta,
+		schema: options.schema
 	};
 	const dtsContent = generateDts(items, genOptions);
 	writeIfChanged(path.join(outputDir, "env.d.ts"), dtsContent);
@@ -301,37 +332,6 @@ function writeIfChanged(filePath, content) {
 	}
 	fs.writeFileSync(filePath, content, "utf-8");
 }
-function envTs(userOptions = {}) {
-	const options = {
-		schema: "zod",
-		output: "src",
-		augmentImportMeta: true,
-		strict: true,
-		envFiles: [],
-		...userOptions
-	};
-	let config;
-	let outputDir;
-	return {
-		name: "vite-plugin-typed-env",
-		enforce: "pre",
-		configResolved(resolvedConfig) {
-			config = resolvedConfig;
-			outputDir = path.resolve(config.root, options.output);
-		},
-		async buildStart() {
-			await generateTypes(config.envDir === false ? config.root : config.envDir, outputDir, options);
-		},
-		async handleHotUpdate({ file, server }) {
-			if (!file) return;
-			const fileName = path.basename(file);
-			if (!(fileName.startsWith(".env") || options.envFiles.includes(file))) return;
-			console.log(`[env-ts] Detected change in ${fileName}, regenerating...`);
-			await generateTypes(config.envDir === false ? config.root : config.envDir, outputDir, options);
-			server.hot.send({ type: "full-reload" });
-		}
-	};
-}
 //#endregion
 export { envTs as default, generateTypes };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-typed-env",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -23,16 +23,8 @@
     "dist/*.d.cts",
     "dist/*.d.mts"
   ],
-  "scripts": {
-    "build": "tsdown",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\" \"*.ts\" \"*.cjs\" \"*.json\" \"*.md\"",
-    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\" \"*.ts\" \"*.cjs\" \"*.json\" \"*.md\""
-  },
   "devDependencies": {
     "@types/node": "^25.5.2",
-    "prettier": "^3.8.2",
     "tsdown": "^0.21.7",
     "typescript": "^6.0.2",
     "vite": "^8.0.8",
@@ -46,5 +38,12 @@
     "zod": {
       "optional": true
     }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}