@vite-env/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pyyupsk
+
+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/dist/index.cjs

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let citty = require("citty");
+let node_path = require("node:path");
+node_path = __toESM(node_path);
+let node_process = require("node:process");
+node_process = __toESM(node_process);
+let _vite_env_core_format = require("@vite-env/core/format");
+let _vite_env_core_schema = require("@vite-env/core/schema");
+let consola = require("consola");
+consola = __toESM(consola);
+let vite = require("vite");
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = __toESM(node_fs_promises);
+let zod = require("zod");
+let _vite_env_core_dts = require("@vite-env/core/dts");
+//#region src/commands/check.ts
+function loadCliEnv(mode, root) {
+	const fileEnv = (0, vite.loadEnv)(mode, root, "");
+	const procEnv = Object.fromEntries(Object.entries(node_process.default.env).filter((entry) => typeof entry[1] === "string"));
+	return {
+		...fileEnv,
+		...procEnv
+	};
+}
+const checkCommand = (0, citty.defineCommand)({
+	meta: { description: "Validate environment variables without starting dev server" },
+	args: {
+		config: {
+			type: "string",
+			default: "env.ts",
+			description: "Path to env definition file"
+		},
+		mode: {
+			type: "string",
+			default: "development",
+			description: "Vite mode"
+		}
+	},
+	async run({ args }) {
+		const root = node_process.default.cwd();
+		const configPath = node_path.default.resolve(root, args.config);
+		const { loadEnvConfig } = await import("@vite-env/core/config");
+		const result = (0, _vite_env_core_schema.validateEnv)(await loadEnvConfig(configPath), loadCliEnv(args.mode, root));
+		if (result.success) {
+			const count = Object.keys(result.data ?? {}).length;
+			consola.default.success(`${count} environment variables valid`);
+			node_process.default.exit(0);
+		} else {
+			consola.default.error("Environment validation failed:");
+			consola.default.log((0, _vite_env_core_format.formatZodError)(result.errors));
+			node_process.default.exit(1);
+		}
+	}
+});
+//#endregion
+//#region src/commands/generate.ts
+const generateCommand = (0, citty.defineCommand)({
+	meta: { description: "Generate .env.example from your env.ts schema" },
+	args: {
+		config: {
+			type: "string",
+			default: "env.ts"
+		},
+		output: {
+			type: "string",
+			default: ".env.example"
+		}
+	},
+	async run({ args }) {
+		const root = node_process.default.cwd();
+		const configPath = node_path.default.resolve(root, args.config);
+		const { loadEnvConfig } = await import("@vite-env/core/config");
+		const def = await loadEnvConfig(configPath);
+		const lines = [
+			"# Auto-generated by @vite-env/cli — do not edit manually",
+			"# Run: npx vite-env generate",
+			""
+		];
+		const sections = [
+			["Public variables (VITE_ prefix — safe for browser)", def.client],
+			["Shared variables (available server + client)", def.shared],
+			["Server-only variables (never sent to browser)", def.server]
+		];
+		for (const [heading, shape] of sections) {
+			if (!shape || Object.keys(shape).length === 0) continue;
+			lines.push(`# ── ${heading}`);
+			for (const [key, schema] of Object.entries(shape)) {
+				const s = schema;
+				const hint = buildHint(s);
+				const defaultVal = getDefault(s);
+				const reqFlag = isRequired(s) ? " — required" : "";
+				lines.push(`# ${key}: ${hint}${reqFlag}`, `${key}=${defaultVal}`, "");
+			}
+		}
+		const output = node_path.default.resolve(root, args.output);
+		await node_fs_promises.default.writeFile(output, lines.join("\n"), "utf-8");
+		consola.default.success(`Generated ${args.output}`);
+	}
+});
+function buildHint(schema) {
+	const inner = unwrap(schema);
+	if (inner instanceof zod.z.ZodString) return "string";
+	if (inner instanceof zod.z.ZodNumber) return "number";
+	if (inner instanceof zod.z.ZodBoolean) return "boolean (true | false | 1 | 0)";
+	if (inner instanceof zod.z.ZodEnum) return `enum: ${inner.options.join(" | ")}`;
+	if (inner instanceof zod.z.ZodPipe) return buildHint(inner.def.out);
+	return "string";
+}
+function getDefault(schema) {
+	if (schema instanceof zod.z.ZodDefault) {
+		const val = schema.def.defaultValue;
+		return String(typeof val === "function" ? val() : val);
+	}
+	return "";
+}
+function isRequired(schema) {
+	return !(schema instanceof zod.z.ZodOptional) && !(schema instanceof zod.z.ZodDefault);
+}
+function unwrap(schema) {
+	if (schema instanceof zod.z.ZodOptional) return unwrap(schema.unwrap());
+	if (schema instanceof zod.z.ZodDefault) return unwrap(schema.def.innerType);
+	if (schema instanceof zod.z.ZodPipe) return unwrap(schema.def.out);
+	return schema;
+}
+//#endregion
+//#region src/commands/types.ts
+const typesCommand = (0, citty.defineCommand)({
+	meta: { description: "Regenerate vite-env.d.ts from your env.ts schema" },
+	args: { config: {
+		type: "string",
+		default: "env.ts"
+	} },
+	async run({ args }) {
+		const root = node_process.default.cwd();
+		const configPath = node_path.default.resolve(root, args.config);
+		const { loadEnvConfig } = await import("@vite-env/core/config");
+		await (0, _vite_env_core_dts.generateDts)(await loadEnvConfig(configPath), root);
+		consola.default.success("Generated vite-env.d.ts");
+	}
+});
+//#endregion
+//#region src/index.ts
+(0, citty.runMain)((0, citty.defineCommand)({
+	meta: {
+		name: "vite-env",
+		description: "The env.ts layer for Vite",
+		version: "0.1.0"
+	},
+	subCommands: {
+		check: checkCommand,
+		generate: generateCommand,
+		types: typesCommand
+	}
+}));
+//#endregion
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["process","path","process","path","fs","z","process","path"],"sources":["../src/commands/check.ts","../src/commands/generate.ts","../src/commands/types.ts","../src/index.ts"],"sourcesContent":["import type { EnvDefinition } from '@vite-env/core'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { formatZodError } from '@vite-env/core/format'\nimport { validateEnv } from '@vite-env/core/schema'\nimport { defineCommand } from 'citty'\nimport consola from 'consola'\nimport { loadEnv } from 'vite'\n\nexport function loadCliEnv(mode: string, root: string): Record<string, string> {\n  const fileEnv = loadEnv(mode, root, '')\n  const procEnv = Object.fromEntries(\n    Object.entries(process.env).filter(\n      (entry): entry is [string, string] => typeof entry[1] === 'string',\n    ),\n  )\n  return { ...fileEnv, ...procEnv }\n}\n\nexport const checkCommand = defineCommand({\n  meta: {\n    description: 'Validate environment variables without starting dev server',\n  },\n  args: {\n    config: {\n      type: 'string',\n      default: 'env.ts',\n      description: 'Path to env definition file',\n    },\n    mode: { type: 'string', default: 'development', description: 'Vite mode' },\n  },\n  async run({ args }) {\n    const root = process.cwd()\n    const configPath = path.resolve(root, args.config)\n\n    const { loadEnvConfig } = await import('@vite-env/core/config')\n    const def: EnvDefinition = await loadEnvConfig(configPath)\n\n    const rawEnv = loadCliEnv(args.mode, root)\n    const result = validateEnv(def, rawEnv)\n\n    if (result.success) {\n      const count = Object.keys(result.data ?? {}).length\n      consola.success(`${count} environment variables valid`)\n      process.exit(0)\n    }\n    else {\n      consola.error('Environment validation failed:')\n      consola.log(formatZodError(result.errors))\n      process.exit(1)\n    }\n  },\n})\n","import type { EnvDefinition } from '@vite-env/core'\nimport fs from 'node:fs/promises'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { defineCommand } from 'citty'\nimport consola from 'consola'\nimport { z } from 'zod'\n\nexport const generateCommand = defineCommand({\n  meta: { description: 'Generate .env.example from your env.ts schema' },\n  args: {\n    config: { type: 'string', default: 'env.ts' },\n    output: { type: 'string', default: '.env.example' },\n  },\n  async run({ args }) {\n    const root = process.cwd()\n    const configPath = path.resolve(root, args.config)\n    const { loadEnvConfig } = await import('@vite-env/core/config')\n    const def: EnvDefinition = await loadEnvConfig(configPath)\n\n    const lines: string[] = [\n      '# Auto-generated by @vite-env/cli — do not edit manually',\n      '# Run: npx vite-env generate',\n      '',\n    ]\n\n    const sections: Array<[string, z.ZodRawShape | undefined]> = [\n      ['Public variables (VITE_ prefix — safe for browser)', def.client],\n      ['Shared variables (available server + client)', def.shared],\n      ['Server-only variables (never sent to browser)', def.server],\n    ]\n\n    for (const [heading, shape] of sections) {\n      if (!shape || Object.keys(shape).length === 0)\n        continue\n      lines.push(`# ── ${heading}`)\n\n      for (const [key, schema] of Object.entries(shape)) {\n        // Zod v4: ZodRawShape values are $ZodType, cast for instanceof checks\n        const s = schema as unknown as z.ZodTypeAny\n        const hint = buildHint(s)\n        const defaultVal = getDefault(s)\n        const reqFlag = isRequired(s) ? ' — required' : ''\n        lines.push(`# ${key}: ${hint}${reqFlag}`, `${key}=${defaultVal}`, '')\n      }\n    }\n\n    const output = path.resolve(root, args.output)\n    await fs.writeFile(output, lines.join('\\n'), 'utf-8')\n    consola.success(`Generated ${args.output}`)\n  },\n})\n\nexport function buildHint(schema: z.ZodTypeAny): string {\n  const inner = unwrap(schema)\n  if (inner instanceof z.ZodString)\n    return 'string'\n  if (inner instanceof z.ZodNumber)\n    return 'number'\n  if (inner instanceof z.ZodBoolean)\n    return 'boolean (true | false | 1 | 0)'\n  if (inner instanceof z.ZodEnum)\n    return `enum: ${(inner.options as string[]).join(' | ')}`\n  if (inner instanceof z.ZodPipe)\n    return buildHint(inner.def.out as unknown as z.ZodTypeAny)\n  return 'string'\n}\n\nexport function getDefault(schema: z.ZodTypeAny): string {\n  if (schema instanceof z.ZodDefault) {\n    const val = (schema.def as { defaultValue: unknown }).defaultValue\n    return String(typeof val === 'function' ? val() : val)\n  }\n  return ''\n}\n\nfunction isRequired(schema: z.ZodTypeAny): boolean {\n  return !(schema instanceof z.ZodOptional) && !(schema instanceof z.ZodDefault)\n}\n\nfunction unwrap(schema: z.ZodTypeAny): z.ZodTypeAny {\n  if (schema instanceof z.ZodOptional)\n    return unwrap(schema.unwrap() as unknown as z.ZodTypeAny)\n  if (schema instanceof z.ZodDefault)\n    return unwrap((schema.def as { innerType: unknown }).innerType as z.ZodTypeAny)\n  if (schema instanceof z.ZodPipe)\n    return unwrap(schema.def.out as unknown as z.ZodTypeAny)\n  return schema\n}\n","import type { EnvDefinition } from '@vite-env/core'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { generateDts } from '@vite-env/core/dts'\nimport { defineCommand } from 'citty'\nimport consola from 'consola'\n\nexport const typesCommand = defineCommand({\n  meta: { description: 'Regenerate vite-env.d.ts from your env.ts schema' },\n  args: {\n    config: { type: 'string', default: 'env.ts' },\n  },\n  async run({ args }) {\n    const root = process.cwd()\n    const configPath = path.resolve(root, args.config)\n    const { loadEnvConfig } = await import('@vite-env/core/config')\n    const def: EnvDefinition = await loadEnvConfig(configPath)\n\n    await generateDts(def, root)\n    consola.success('Generated vite-env.d.ts')\n  },\n})\n","#!/usr/bin/env node\nimport { defineCommand, runMain } from 'citty'\nimport { checkCommand } from './commands/check'\nimport { generateCommand } from './commands/generate'\nimport { typesCommand } from './commands/types'\n\nconst main = defineCommand({\n  meta: {\n    name: 'vite-env',\n    description: 'The env.ts layer for Vite',\n    version: '0.1.0',\n  },\n  subCommands: {\n    check: checkCommand,\n    generate: generateCommand,\n    types: typesCommand,\n  },\n})\n\nrunMain(main)\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/index.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/index.mjs

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+import { defineCommand, runMain } from "citty";
+import path from "node:path";
+import process from "node:process";
+import { formatZodError } from "@vite-env/core/format";
+import { validateEnv } from "@vite-env/core/schema";
+import consola from "consola";
+import { loadEnv } from "vite";
+import fs from "node:fs/promises";
+import { z } from "zod";
+import { generateDts } from "@vite-env/core/dts";
+//#region src/commands/check.ts
+function loadCliEnv(mode, root) {
+	const fileEnv = loadEnv(mode, root, "");
+	const procEnv = Object.fromEntries(Object.entries(process.env).filter((entry) => typeof entry[1] === "string"));
+	return {
+		...fileEnv,
+		...procEnv
+	};
+}
+const checkCommand = defineCommand({
+	meta: { description: "Validate environment variables without starting dev server" },
+	args: {
+		config: {
+			type: "string",
+			default: "env.ts",
+			description: "Path to env definition file"
+		},
+		mode: {
+			type: "string",
+			default: "development",
+			description: "Vite mode"
+		}
+	},
+	async run({ args }) {
+		const root = process.cwd();
+		const configPath = path.resolve(root, args.config);
+		const { loadEnvConfig } = await import("@vite-env/core/config");
+		const result = validateEnv(await loadEnvConfig(configPath), loadCliEnv(args.mode, root));
+		if (result.success) {
+			const count = Object.keys(result.data ?? {}).length;
+			consola.success(`${count} environment variables valid`);
+			process.exit(0);
+		} else {
+			consola.error("Environment validation failed:");
+			consola.log(formatZodError(result.errors));
+			process.exit(1);
+		}
+	}
+});
+//#endregion
+//#region src/commands/generate.ts
+const generateCommand = defineCommand({
+	meta: { description: "Generate .env.example from your env.ts schema" },
+	args: {
+		config: {
+			type: "string",
+			default: "env.ts"
+		},
+		output: {
+			type: "string",
+			default: ".env.example"
+		}
+	},
+	async run({ args }) {
+		const root = process.cwd();
+		const configPath = path.resolve(root, args.config);
+		const { loadEnvConfig } = await import("@vite-env/core/config");
+		const def = await loadEnvConfig(configPath);
+		const lines = [
+			"# Auto-generated by @vite-env/cli — do not edit manually",
+			"# Run: npx vite-env generate",
+			""
+		];
+		const sections = [
+			["Public variables (VITE_ prefix — safe for browser)", def.client],
+			["Shared variables (available server + client)", def.shared],
+			["Server-only variables (never sent to browser)", def.server]
+		];
+		for (const [heading, shape] of sections) {
+			if (!shape || Object.keys(shape).length === 0) continue;
+			lines.push(`# ── ${heading}`);
+			for (const [key, schema] of Object.entries(shape)) {
+				const s = schema;
+				const hint = buildHint(s);
+				const defaultVal = getDefault(s);
+				const reqFlag = isRequired(s) ? " — required" : "";
+				lines.push(`# ${key}: ${hint}${reqFlag}`, `${key}=${defaultVal}`, "");
+			}
+		}
+		const output = path.resolve(root, args.output);
+		await fs.writeFile(output, lines.join("\n"), "utf-8");
+		consola.success(`Generated ${args.output}`);
+	}
+});
+function buildHint(schema) {
+	const inner = unwrap(schema);
+	if (inner instanceof z.ZodString) return "string";
+	if (inner instanceof z.ZodNumber) return "number";
+	if (inner instanceof z.ZodBoolean) return "boolean (true | false | 1 | 0)";
+	if (inner instanceof z.ZodEnum) return `enum: ${inner.options.join(" | ")}`;
+	if (inner instanceof z.ZodPipe) return buildHint(inner.def.out);
+	return "string";
+}
+function getDefault(schema) {
+	if (schema instanceof z.ZodDefault) {
+		const val = schema.def.defaultValue;
+		return String(typeof val === "function" ? val() : val);
+	}
+	return "";
+}
+function isRequired(schema) {
+	return !(schema instanceof z.ZodOptional) && !(schema instanceof z.ZodDefault);
+}
+function unwrap(schema) {
+	if (schema instanceof z.ZodOptional) return unwrap(schema.unwrap());
+	if (schema instanceof z.ZodDefault) return unwrap(schema.def.innerType);
+	if (schema instanceof z.ZodPipe) return unwrap(schema.def.out);
+	return schema;
+}
+//#endregion
+//#region src/index.ts
+runMain(defineCommand({
+	meta: {
+		name: "vite-env",
+		description: "The env.ts layer for Vite",
+		version: "0.1.0"
+	},
+	subCommands: {
+		check: checkCommand,
+		generate: generateCommand,
+		types: defineCommand({
+			meta: { description: "Regenerate vite-env.d.ts from your env.ts schema" },
+			args: { config: {
+				type: "string",
+				default: "env.ts"
+			} },
+			async run({ args }) {
+				const root = process.cwd();
+				const configPath = path.resolve(root, args.config);
+				const { loadEnvConfig } = await import("@vite-env/core/config");
+				await generateDts(await loadEnvConfig(configPath), root);
+				consola.success("Generated vite-env.d.ts");
+			}
+		})
+	}
+}));
+//#endregion
+export {};
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/commands/check.ts","../src/commands/generate.ts","../src/commands/types.ts","../src/index.ts"],"sourcesContent":["import type { EnvDefinition } from '@vite-env/core'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { formatZodError } from '@vite-env/core/format'\nimport { validateEnv } from '@vite-env/core/schema'\nimport { defineCommand } from 'citty'\nimport consola from 'consola'\nimport { loadEnv } from 'vite'\n\nexport function loadCliEnv(mode: string, root: string): Record<string, string> {\n  const fileEnv = loadEnv(mode, root, '')\n  const procEnv = Object.fromEntries(\n    Object.entries(process.env).filter(\n      (entry): entry is [string, string] => typeof entry[1] === 'string',\n    ),\n  )\n  return { ...fileEnv, ...procEnv }\n}\n\nexport const checkCommand = defineCommand({\n  meta: {\n    description: 'Validate environment variables without starting dev server',\n  },\n  args: {\n    config: {\n      type: 'string',\n      default: 'env.ts',\n      description: 'Path to env definition file',\n    },\n    mode: { type: 'string', default: 'development', description: 'Vite mode' },\n  },\n  async run({ args }) {\n    const root = process.cwd()\n    const configPath = path.resolve(root, args.config)\n\n    const { loadEnvConfig } = await import('@vite-env/core/config')\n    const def: EnvDefinition = await loadEnvConfig(configPath)\n\n    const rawEnv = loadCliEnv(args.mode, root)\n    const result = validateEnv(def, rawEnv)\n\n    if (result.success) {\n      const count = Object.keys(result.data ?? {}).length\n      consola.success(`${count} environment variables valid`)\n      process.exit(0)\n    }\n    else {\n      consola.error('Environment validation failed:')\n      consola.log(formatZodError(result.errors))\n      process.exit(1)\n    }\n  },\n})\n","import type { EnvDefinition } from '@vite-env/core'\nimport fs from 'node:fs/promises'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { defineCommand } from 'citty'\nimport consola from 'consola'\nimport { z } from 'zod'\n\nexport const generateCommand = defineCommand({\n  meta: { description: 'Generate .env.example from your env.ts schema' },\n  args: {\n    config: { type: 'string', default: 'env.ts' },\n    output: { type: 'string', default: '.env.example' },\n  },\n  async run({ args }) {\n    const root = process.cwd()\n    const configPath = path.resolve(root, args.config)\n    const { loadEnvConfig } = await import('@vite-env/core/config')\n    const def: EnvDefinition = await loadEnvConfig(configPath)\n\n    const lines: string[] = [\n      '# Auto-generated by @vite-env/cli — do not edit manually',\n      '# Run: npx vite-env generate',\n      '',\n    ]\n\n    const sections: Array<[string, z.ZodRawShape | undefined]> = [\n      ['Public variables (VITE_ prefix — safe for browser)', def.client],\n      ['Shared variables (available server + client)', def.shared],\n      ['Server-only variables (never sent to browser)', def.server],\n    ]\n\n    for (const [heading, shape] of sections) {\n      if (!shape || Object.keys(shape).length === 0)\n        continue\n      lines.push(`# ── ${heading}`)\n\n      for (const [key, schema] of Object.entries(shape)) {\n        // Zod v4: ZodRawShape values are $ZodType, cast for instanceof checks\n        const s = schema as unknown as z.ZodTypeAny\n        const hint = buildHint(s)\n        const defaultVal = getDefault(s)\n        const reqFlag = isRequired(s) ? ' — required' : ''\n        lines.push(`# ${key}: ${hint}${reqFlag}`, `${key}=${defaultVal}`, '')\n      }\n    }\n\n    const output = path.resolve(root, args.output)\n    await fs.writeFile(output, lines.join('\\n'), 'utf-8')\n    consola.success(`Generated ${args.output}`)\n  },\n})\n\nexport function buildHint(schema: z.ZodTypeAny): string {\n  const inner = unwrap(schema)\n  if (inner instanceof z.ZodString)\n    return 'string'\n  if (inner instanceof z.ZodNumber)\n    return 'number'\n  if (inner instanceof z.ZodBoolean)\n    return 'boolean (true | false | 1 | 0)'\n  if (inner instanceof z.ZodEnum)\n    return `enum: ${(inner.options as string[]).join(' | ')}`\n  if (inner instanceof z.ZodPipe)\n    return buildHint(inner.def.out as unknown as z.ZodTypeAny)\n  return 'string'\n}\n\nexport function getDefault(schema: z.ZodTypeAny): string {\n  if (schema instanceof z.ZodDefault) {\n    const val = (schema.def as { defaultValue: unknown }).defaultValue\n    return String(typeof val === 'function' ? val() : val)\n  }\n  return ''\n}\n\nfunction isRequired(schema: z.ZodTypeAny): boolean {\n  return !(schema instanceof z.ZodOptional) && !(schema instanceof z.ZodDefault)\n}\n\nfunction unwrap(schema: z.ZodTypeAny): z.ZodTypeAny {\n  if (schema instanceof z.ZodOptional)\n    return unwrap(schema.unwrap() as unknown as z.ZodTypeAny)\n  if (schema instanceof z.ZodDefault)\n    return unwrap((schema.def as { innerType: unknown }).innerType as z.ZodTypeAny)\n  if (schema instanceof z.ZodPipe)\n    return unwrap(schema.def.out as unknown as z.ZodTypeAny)\n  return schema\n}\n","import type { EnvDefinition } from '@vite-env/core'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { generateDts } from '@vite-env/core/dts'\nimport { defineCommand } from 'citty'\nimport consola from 'consola'\n\nexport const typesCommand = defineCommand({\n  meta: { description: 'Regenerate vite-env.d.ts from your env.ts schema' },\n  args: {\n    config: { type: 'string', default: 'env.ts' },\n  },\n  async run({ args }) {\n    const root = process.cwd()\n    const configPath = path.resolve(root, args.config)\n    const { loadEnvConfig } = await import('@vite-env/core/config')\n    const def: EnvDefinition = await loadEnvConfig(configPath)\n\n    await generateDts(def, root)\n    consola.success('Generated vite-env.d.ts')\n  },\n})\n","#!/usr/bin/env node\nimport { defineCommand, runMain } from 'citty'\nimport { checkCommand } from './commands/check'\nimport { generateCommand } from './commands/generate'\nimport { typesCommand } from './commands/types'\n\nconst main = defineCommand({\n  meta: {\n    name: 'vite-env',\n    description: 'The env.ts layer for Vite',\n    version: '0.1.0',\n  },\n  subCommands: {\n    check: checkCommand,\n    generate: generateCommand,\n    types: typesCommand,\n  },\n})\n\nrunMain(main)\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@vite-env/cli",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "CLI for @vite-env/core — check, generate, types",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "bin": {
+    "vite-env": "./dist/index.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "dependencies": {
+    "citty": "^0.2.2",
+    "consola": "^3.4.2",
+    "jiti": "^2.6.1",
+    "vite": "^8.0.3",
+    "zod": "^4.3.6",
+    "@vite-env/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "tsdown": "^0.21.7",
+    "typescript": "^6.0.2"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}