@vite-env/core 0.5.4 → 0.6.1

package/README.md

@@ -7,6 +7,7 @@ The `env.ts` layer for Vite — define once, validate everywhere, import with ty
 - Typed virtual modules (`virtual:env/client`, `virtual:env/server`)
 - Server/client split with build-time leak detection
 - Runtime access protection — warns or errors when `virtual:env/server` is imported from a client environment
+- Standalone runtime loader — `loadEnv(config)` from `@vite-env/core/load` for scripts outside Vite
 - Auto-coercion via Zod v4 (`z.stringbool()`, `z.coerce.number()`)
 - Standard Schema support — use Valibot, ArkType, or any compliant validator
 - Platform presets — pre-built schemas for Vercel, Railway, and Netlify
@@ -24,8 +25,8 @@ npm install @vite-env/core zod
 **1. Define your schema** — `env.ts`
 
 ```ts
-import { defineEnv } from '@vite-env/core'
-import { z } from 'zod'
+import { defineEnv } from "@vite-env/core";
+import { z } from "zod";
 
 export default defineEnv({
   server: {
@@ -35,50 +36,65 @@ export default defineEnv({
   client: {
     VITE_API_URL: z.url(),
     VITE_DARK_MODE: z.stringbool().default(false),
-    VITE_NODE_ENV: z
-      .enum(['development', 'test', 'production'])
-      .default('development'),
+    VITE_NODE_ENV: z.enum(["development", "test", "production"]).default("development"),
   },
-})
+});
 ```
 
 **2. Add the plugin** — `vite.config.ts`
 
 ```ts
-import ViteEnv from '@vite-env/core/plugin'
-import { defineConfig } from 'vite'
+import ViteEnv from "@vite-env/core/plugin";
+import { defineConfig } from "vite";
 
 export default defineConfig({
   plugins: [ViteEnv()],
-})
+});
 ```
 
 **3. Import typed env**
 
 ```ts
-import { env } from 'virtual:env/client'
+import { env } from "virtual:env/client";
 
-env.VITE_API_URL // string
-env.VITE_DARK_MODE // boolean
-env.VITE_NODE_ENV // 'development' | 'test' | 'production'
+env.VITE_API_URL; // string
+env.VITE_DARK_MODE; // boolean
+env.VITE_NODE_ENV; // 'development' | 'test' | 'production'
 ```
 
 ### Platform presets
 
 ```ts
-import { defineEnv } from '@vite-env/core'
-import { vercel } from '@vite-env/core/presets'
-import { z } from 'zod'
+import { defineEnv } from "@vite-env/core";
+import { vercel } from "@vite-env/core/presets";
+import { z } from "zod";
 
 export default defineEnv({
   presets: [vercel],
   server: { DATABASE_URL: z.url() },
   client: { VITE_API_URL: z.url() },
-})
+});
 ```
 
 Available presets: `vercel`, `railway`, `netlify`.
 
+### Standalone runtime loader
+
+Use the same validated env in Node/Bun scripts outside of Vite:
+
+```ts
+// scripts/seed.ts
+import { loadEnv } from "@vite-env/core/load";
+import config from "../env";
+
+const { server, client } = await loadEnv(config);
+
+server.DATABASE_URL; // string
+client.VITE_API_URL; // string
+```
+
+Returns `{ server, client, all }`. Accepts an optional second argument `{ mode?, envDir? }`.
+
 See the [full documentation](https://pyyupsk.github.io/vite-env/) for server/client split details, CLI tools, and more.
 
 ## License

package/dist/chunk-CKQMccvm.cjs

@@ -0,0 +1,28 @@
+//#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
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});

package/dist/config.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("./dts-BX0Cnqo-.cjs");
+require("./chunk-CKQMccvm.cjs");
 let jiti = require("jiti");
 //#region src/config.ts
 async function loadEnvConfig(configPath) {

package/dist/config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.cjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["import type { EnvDefinition } from './types'\nimport { createJiti } from 'jiti'\n\nexport async function loadEnvConfig(configPath: string): Promise<EnvDefinition> {\n  const jiti = createJiti(configPath)\n  const mod = await jiti.import<Record<string, unknown>>(configPath)\n  const def: unknown = mod.default ?? mod\n\n  if (!def || typeof def !== 'object') {\n    throw new Error(\n      `[vite-env] env config at ${configPath} must export an object (got ${typeof def}).\\n`\n      + `  Use: export default defineEnv({ ... })`,\n    )\n  }\n\n  return def as EnvDefinition\n}\n"],"mappings":";;;;AAGA,eAAsB,cAAc,YAA4C;CAE9E,MAAM,MAAM,OAAA,GAAA,KAAA,YADY,WACF,CAAC,OAAgC,WAAW;CAClE,MAAM,MAAe,IAAI,WAAW;AAEpC,KAAI,CAAC,OAAO,OAAO,QAAQ,SACzB,OAAM,IAAI,MACR,4BAA4B,WAAW,8BAA8B,OAAO,IAAI,8CAEjF;AAGH,QAAO"}
+{"version":3,"file":"config.cjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["import type { EnvDefinition } from \"./types\";\nimport { createJiti } from \"jiti\";\n\nexport async function loadEnvConfig(configPath: string): Promise<EnvDefinition> {\n  const jiti = createJiti(configPath);\n  const mod = await jiti.import<Record<string, unknown>>(configPath);\n  const def: unknown = mod.default ?? mod;\n\n  if (!def || typeof def !== \"object\") {\n    throw new Error(\n      `[vite-env] env config at ${configPath} must export an object (got ${typeof def}).\\n` +\n        `  Use: export default defineEnv({ ... })`,\n    );\n  }\n\n  return def as EnvDefinition;\n}\n"],"mappings":";;;;AAGA,eAAsB,cAAc,YAA4C;CAE9E,MAAM,MAAM,OAAA,GAAA,KAAA,YADY,WACF,CAAC,OAAgC,WAAW;CAClE,MAAM,MAAe,IAAI,WAAW;AAEpC,KAAI,CAAC,OAAO,OAAO,QAAQ,SACzB,OAAM,IAAI,MACR,4BAA4B,WAAW,8BAA8B,OAAO,IAAI,8CAEjF;AAGH,QAAO"}

package/dist/config.d.cts

@@ -1,4 +1,4 @@
-import { n as EnvDefinition } from "./types-B61nsO8q.cjs";
+import { n as EnvDefinition } from "./types-DudMh278.cjs";
 
 //#region src/config.d.ts
 declare function loadEnvConfig(configPath: string): Promise<EnvDefinition>;

package/dist/config.d.mts

@@ -1,4 +1,4 @@
-import { n as EnvDefinition } from "./types-KniR_Oqf.mjs";
+import { n as EnvDefinition } from "./types-Ctg8aeXQ.mjs";
 
 //#region src/config.d.ts
 declare function loadEnvConfig(configPath: string): Promise<EnvDefinition>;

package/dist/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["import type { EnvDefinition } from './types'\nimport { createJiti } from 'jiti'\n\nexport async function loadEnvConfig(configPath: string): Promise<EnvDefinition> {\n  const jiti = createJiti(configPath)\n  const mod = await jiti.import<Record<string, unknown>>(configPath)\n  const def: unknown = mod.default ?? mod\n\n  if (!def || typeof def !== 'object') {\n    throw new Error(\n      `[vite-env] env config at ${configPath} must export an object (got ${typeof def}).\\n`\n      + `  Use: export default defineEnv({ ... })`,\n    )\n  }\n\n  return def as EnvDefinition\n}\n"],"mappings":";;AAGA,eAAsB,cAAc,YAA4C;CAE9E,MAAM,MAAM,MADC,WAAW,WACF,CAAC,OAAgC,WAAW;CAClE,MAAM,MAAe,IAAI,WAAW;AAEpC,KAAI,CAAC,OAAO,OAAO,QAAQ,SACzB,OAAM,IAAI,MACR,4BAA4B,WAAW,8BAA8B,OAAO,IAAI,8CAEjF;AAGH,QAAO"}
+{"version":3,"file":"config.mjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["import type { EnvDefinition } from \"./types\";\nimport { createJiti } from \"jiti\";\n\nexport async function loadEnvConfig(configPath: string): Promise<EnvDefinition> {\n  const jiti = createJiti(configPath);\n  const mod = await jiti.import<Record<string, unknown>>(configPath);\n  const def: unknown = mod.default ?? mod;\n\n  if (!def || typeof def !== \"object\") {\n    throw new Error(\n      `[vite-env] env config at ${configPath} must export an object (got ${typeof def}).\\n` +\n        `  Use: export default defineEnv({ ... })`,\n    );\n  }\n\n  return def as EnvDefinition;\n}\n"],"mappings":";;AAGA,eAAsB,cAAc,YAA4C;CAE9E,MAAM,MAAM,MADC,WAAW,WACF,CAAC,OAAgC,WAAW;CAClE,MAAM,MAAe,IAAI,WAAW;AAEpC,KAAI,CAAC,OAAO,OAAO,QAAQ,SACzB,OAAM,IAAI,MACR,4BAA4B,WAAW,8BAA8B,OAAO,IAAI,8CAEjF;AAGH,QAAO"}

package/dist/dts.cjs

@@ -1,4 +1,103 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dts = require("./dts-BX0Cnqo-.cjs");
-exports.generateDts = require_dts.generateDts;
-exports.generateStandardDts = require_dts.generateStandardDts;
+const require_chunk = require("./chunk-CKQMccvm.cjs");
+let node_path = require("node:path");
+node_path = require_chunk.__toESM(node_path, 1);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = require_chunk.__toESM(node_fs_promises, 1);
+//#region src/dts.ts
+/**
+* Writes vite-env.d.ts for Zod definitions.
+* Uses instanceof checks to infer TypeScript types from Zod schemas.
+* Zod is loaded dynamically so this module can be imported without zod installed.
+*/
+async function generateDts(def, root) {
+	const { z } = await import("zod");
+	const gatedKeys = gatedPresetKeys(def);
+	await writeDts(root, zodShapeToTsFields(z, { ...def.client }, gatedKeys), zodShapeToTsFields(z, {
+		...def.server,
+		...def.client
+	}, gatedKeys));
+}
+/**
+* Detection-gated preset keys (not user-overridden) validate as optional
+* off-platform — typing them required would lie during local dev.
+*/
+function gatedPresetKeys(def) {
+	const keys = /* @__PURE__ */ new Set();
+	for (const preset of def.presets ?? []) {
+		if (!preset.detect) continue;
+		for (const side of ["server", "client"]) for (const [key, schema] of Object.entries(preset[side] ?? {})) if (def[side]?.[key] === schema) keys.add(key);
+	}
+	return keys;
+}
+/**
+* Writes vite-env.d.ts for Standard Schema definitions.
+* All fields are typed as `string` — Standard Schema has no runtime type introspection.
+*/
+async function generateStandardDts(def, root) {
+	const clientKeys = Object.keys(def.client ?? {});
+	const serverKeys = [...Object.keys(def.server ?? {}), ...clientKeys];
+	await writeDts(root, keysToTsFields(clientKeys), keysToTsFields(serverKeys), "(Standard Schema)");
+}
+function buildHeader(tag = "") {
+	const lines = [
+		"/* oxlint-disable */",
+		"/* eslint-disable */",
+		"// @ts-nocheck",
+		"// biome-ignore-all lint: auto-generated",
+		tag ? `// Auto-generated by @vite-env/core ${tag}` : "// Auto-generated by @vite-env/core",
+		"// Do not edit manually — re-generated on every dev server start and build"
+	];
+	if (tag) lines.push("// Tip: for richer types, use defineEnv() with Zod instead of defineStandardEnv()");
+	return lines.join("\n");
+}
+async function writeDts(root, clientFields, serverFields, tag = "") {
+	const dts = `${buildHeader(tag)}
+
+declare module 'virtual:env/client' {
+  const env: {
+${clientFields}
+  }
+  export { env }
+  export default env
+}
+
+declare module 'virtual:env/server' {
+  const env: {
+${serverFields}
+  }
+  export { env }
+  export default env
+}
+`;
+	const filePath = node_path.default.join(root, "vite-env.d.ts");
+	try {
+		await node_fs_promises.default.writeFile(filePath, dts, "utf-8");
+	} catch (e) {
+		throw new Error(`[vite-env] Failed to write vite-env.d.ts to ${root}. Check file permissions.`, { cause: e });
+	}
+}
+function keysToTsFields(keys) {
+	return keys.map((key) => `    readonly ${key}: string`).join("\n");
+}
+function zodShapeToTsFields(z, shape, gatedKeys) {
+	return Object.entries(shape).map(([key, schema]) => {
+		const tsType = zodToTs(z, schema);
+		return `    readonly ${key}${schema instanceof z.ZodOptional || gatedKeys.has(key) ? "?" : ""}: ${tsType}`;
+	}).join("\n");
+}
+function zodToTs(z, schema) {
+	if (schema instanceof z.ZodOptional) return zodToTs(z, schema.unwrap());
+	if (schema instanceof z.ZodDefault) return zodToTs(z, schema.def.innerType);
+	if (schema instanceof z.ZodString) return "string";
+	if (schema instanceof z.ZodNumber) return "number";
+	if (schema instanceof z.ZodBoolean) return "boolean";
+	if (schema instanceof z.ZodEnum) return schema.options.map((o) => `'${o}'`).join(" | ");
+	if (schema instanceof z.ZodPipe) return zodToTs(z, schema.def.out);
+	return "string";
+}
+//#endregion
+exports.generateDts = generateDts;
+exports.generateStandardDts = generateStandardDts;
+
+//# sourceMappingURL=dts.cjs.map

package/dist/dts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dts.cjs","names":["path","fs"],"sources":["../src/dts.ts"],"sourcesContent":["// @env node\nimport type { EnvDefinition, StandardEnvDefinition } from \"./types\";\nimport type { z as ZodNs } from \"zod\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/**\n * Writes vite-env.d.ts for Zod definitions.\n * Uses instanceof checks to infer TypeScript types from Zod schemas.\n * Zod is loaded dynamically so this module can be imported without zod installed.\n */\nexport async function generateDts(def: EnvDefinition, root: string): Promise<void> {\n  const { z } = await import(\"zod\");\n\n  const gatedKeys = gatedPresetKeys(def);\n  const clientFields = zodShapeToTsFields(z, { ...def.client }, gatedKeys);\n  const serverFields = zodShapeToTsFields(z, { ...def.server, ...def.client }, gatedKeys);\n\n  await writeDts(root, clientFields, serverFields);\n}\n\n/**\n * Detection-gated preset keys (not user-overridden) validate as optional\n * off-platform — typing them required would lie during local dev.\n */\nfunction gatedPresetKeys(def: EnvDefinition): Set<string> {\n  const keys = new Set<string>();\n  for (const preset of def.presets ?? []) {\n    if (!preset.detect) continue;\n    for (const side of [\"server\", \"client\"] as const) {\n      for (const [key, schema] of Object.entries(preset[side] ?? {})) {\n        if (def[side]?.[key] === schema) keys.add(key);\n      }\n    }\n  }\n  return keys;\n}\n\n/**\n * Writes vite-env.d.ts for Standard Schema definitions.\n * All fields are typed as `string` — Standard Schema has no runtime type introspection.\n */\nexport async function generateStandardDts(def: StandardEnvDefinition, root: string): Promise<void> {\n  const clientKeys = Object.keys(def.client ?? {});\n  const serverKeys = [...Object.keys(def.server ?? {}), ...clientKeys];\n\n  const clientFields = keysToTsFields(clientKeys);\n  const serverFields = keysToTsFields(serverKeys);\n\n  await writeDts(root, clientFields, serverFields, \"(Standard Schema)\");\n}\n\nfunction buildHeader(tag = \"\"): string {\n  const lines = [\n    \"/* oxlint-disable */\",\n    \"/* eslint-disable */\",\n    \"// @ts-nocheck\",\n    \"// biome-ignore-all lint: auto-generated\",\n    tag ? `// Auto-generated by @vite-env/core ${tag}` : \"// Auto-generated by @vite-env/core\",\n    \"// Do not edit manually — re-generated on every dev server start and build\",\n  ];\n  if (tag) {\n    lines.push(\"// Tip: for richer types, use defineEnv() with Zod instead of defineStandardEnv()\");\n  }\n  return lines.join(\"\\n\");\n}\n\nasync function writeDts(\n  root: string,\n  clientFields: string,\n  serverFields: string,\n  tag = \"\",\n): Promise<void> {\n  const header = buildHeader(tag);\n\n  const dts = `${header}\n\ndeclare module 'virtual:env/client' {\n  const env: {\n${clientFields}\n  }\n  export { env }\n  export default env\n}\n\ndeclare module 'virtual:env/server' {\n  const env: {\n${serverFields}\n  }\n  export { env }\n  export default env\n}\n`;\n\n  const filePath = path.join(root, \"vite-env.d.ts\");\n  try {\n    await fs.writeFile(filePath, dts, \"utf-8\");\n  } catch (e) {\n    throw new Error(\n      `[vite-env] Failed to write vite-env.d.ts to ${root}. Check file permissions.`,\n      { cause: e },\n    );\n  }\n}\n\nfunction keysToTsFields(keys: string[]): string {\n  return keys.map((key) => `    readonly ${key}: string`).join(\"\\n\");\n}\n\nfunction zodShapeToTsFields(\n  z: typeof ZodNs,\n  shape: Record<string, unknown>,\n  gatedKeys: Set<string>,\n): string {\n  return Object.entries(shape)\n    .map(([key, schema]) => {\n      const tsType = zodToTs(z, schema);\n      const optional = schema instanceof z.ZodOptional || gatedKeys.has(key);\n      return `    readonly ${key}${optional ? \"?\" : \"\"}: ${tsType}`;\n    })\n    .join(\"\\n\");\n}\n\nfunction zodToTs(z: typeof ZodNs, schema: unknown): string {\n  if (schema instanceof z.ZodOptional) return zodToTs(z, schema.unwrap());\n  if (schema instanceof z.ZodDefault) return zodToTs(z, schema.def.innerType);\n  if (schema instanceof z.ZodString) return \"string\";\n  if (schema instanceof z.ZodNumber) return \"number\";\n  if (schema instanceof z.ZodBoolean) return \"boolean\";\n  if (schema instanceof z.ZodEnum)\n    return (schema.options as string[]).map((o) => `'${o}'`).join(\" | \");\n  if (schema instanceof z.ZodPipe) return zodToTs(z, schema.def.out);\n  return \"string\";\n}\n"],"mappings":";;;;;;;;;;;;AAWA,eAAsB,YAAY,KAAoB,MAA6B;CACjF,MAAM,EAAE,MAAM,MAAM,OAAO;CAE3B,MAAM,YAAY,gBAAgB,IAAI;AAItC,OAAM,SAAS,MAHM,mBAAmB,GAAG,EAAE,GAAG,IAAI,QAAQ,EAAE,UAG7B,EAFZ,mBAAmB,GAAG;EAAE,GAAG,IAAI;EAAQ,GAAG,IAAI;EAAQ,EAAE,UAE9B,CAAC;;;;;;AAOlD,SAAS,gBAAgB,KAAiC;CACxD,MAAM,uBAAO,IAAI,KAAa;AAC9B,MAAK,MAAM,UAAU,IAAI,WAAW,EAAE,EAAE;AACtC,MAAI,CAAC,OAAO,OAAQ;AACpB,OAAK,MAAM,QAAQ,CAAC,UAAU,SAAS,CACrC,MAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,OAAO,SAAS,EAAE,CAAC,CAC5D,KAAI,IAAI,QAAQ,SAAS,OAAQ,MAAK,IAAI,IAAI;;AAIpD,QAAO;;;;;;AAOT,eAAsB,oBAAoB,KAA4B,MAA6B;CACjG,MAAM,aAAa,OAAO,KAAK,IAAI,UAAU,EAAE,CAAC;CAChD,MAAM,aAAa,CAAC,GAAG,OAAO,KAAK,IAAI,UAAU,EAAE,CAAC,EAAE,GAAG,WAAW;AAKpE,OAAM,SAAS,MAHM,eAAe,WAGH,EAFZ,eAAe,WAEW,EAAE,oBAAoB;;AAGvE,SAAS,YAAY,MAAM,IAAY;CACrC,MAAM,QAAQ;EACZ;EACA;EACA;EACA;EACA,MAAM,uCAAuC,QAAQ;EACrD;EACD;AACD,KAAI,IACF,OAAM,KAAK,oFAAoF;AAEjG,QAAO,MAAM,KAAK,KAAK;;AAGzB,eAAe,SACb,MACA,cACA,cACA,MAAM,IACS;CAGf,MAAM,MAAM,GAFG,YAAY,IAEN,CAAC;;;;EAItB,aAAa;;;;;;;;EAQb,aAAa;;;;;;CAOb,MAAM,WAAWA,UAAAA,QAAK,KAAK,MAAM,gBAAgB;AACjD,KAAI;AACF,QAAMC,iBAAAA,QAAG,UAAU,UAAU,KAAK,QAAQ;UACnC,GAAG;AACV,QAAM,IAAI,MACR,+CAA+C,KAAK,4BACpD,EAAE,OAAO,GAAG,CACb;;;AAIL,SAAS,eAAe,MAAwB;AAC9C,QAAO,KAAK,KAAK,QAAQ,gBAAgB,IAAI,UAAU,CAAC,KAAK,KAAK;;AAGpE,SAAS,mBACP,GACA,OACA,WACQ;AACR,QAAO,OAAO,QAAQ,MAAM,CACzB,KAAK,CAAC,KAAK,YAAY;EACtB,MAAM,SAAS,QAAQ,GAAG,OAAO;AAEjC,SAAO,gBAAgB,MADN,kBAAkB,EAAE,eAAe,UAAU,IAAI,IAAI,GAC9B,MAAM,GAAG,IAAI;GACrD,CACD,KAAK,KAAK;;AAGf,SAAS,QAAQ,GAAiB,QAAyB;AACzD,KAAI,kBAAkB,EAAE,YAAa,QAAO,QAAQ,GAAG,OAAO,QAAQ,CAAC;AACvE,KAAI,kBAAkB,EAAE,WAAY,QAAO,QAAQ,GAAG,OAAO,IAAI,UAAU;AAC3E,KAAI,kBAAkB,EAAE,UAAW,QAAO;AAC1C,KAAI,kBAAkB,EAAE,UAAW,QAAO;AAC1C,KAAI,kBAAkB,EAAE,WAAY,QAAO;AAC3C,KAAI,kBAAkB,EAAE,QACtB,QAAQ,OAAO,QAAqB,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,MAAM;AACtE,KAAI,kBAAkB,EAAE,QAAS,QAAO,QAAQ,GAAG,OAAO,IAAI,IAAI;AAClE,QAAO"}

package/dist/dts.d.cts

@@ -1,4 +1,4 @@
-import { n as EnvDefinition, o as StandardEnvDefinition } from "./types-B61nsO8q.cjs";
+import { n as EnvDefinition, o as StandardEnvDefinition } from "./types-DudMh278.cjs";
 
 //#region src/dts.d.ts
 /**

package/dist/dts.d.mts

@@ -1,4 +1,4 @@
-import { n as EnvDefinition, o as StandardEnvDefinition } from "./types-KniR_Oqf.mjs";
+import { n as EnvDefinition, o as StandardEnvDefinition } from "./types-Ctg8aeXQ.mjs";
 
 //#region src/dts.d.ts
 /**

package/dist/dts.mjs

@@ -41,7 +41,7 @@ function buildHeader(tag = "") {
 		"/* eslint-disable */",
 		"// @ts-nocheck",
 		"// biome-ignore-all lint: auto-generated",
-		`// Auto-generated by @vite-env/core${tag ? ` ${tag}` : ""}`,
+		tag ? `// Auto-generated by @vite-env/core ${tag}` : "// Auto-generated by @vite-env/core",
 		"// Do not edit manually — re-generated on every dev server start and build"
 	];
 	if (tag) lines.push("// Tip: for richer types, use defineEnv() with Zod instead of defineStandardEnv()");

package/dist/dts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dts.mjs","names":[],"sources":["../src/dts.ts"],"sourcesContent":["// @env node\nimport type { EnvDefinition, StandardEnvDefinition } from './types'\nimport type { z as ZodNs } from 'zod'\nimport fs from 'node:fs/promises'\nimport path from 'node:path'\n\n/**\n * Writes vite-env.d.ts for Zod definitions.\n * Uses instanceof checks to infer TypeScript types from Zod schemas.\n * Zod is loaded dynamically so this module can be imported without zod installed.\n */\nexport async function generateDts(\n  def: EnvDefinition,\n  root: string,\n): Promise<void> {\n  const { z } = await import('zod')\n\n  const gatedKeys = gatedPresetKeys(def)\n  const clientFields = zodShapeToTsFields(z, { ...def.client }, gatedKeys)\n  const serverFields = zodShapeToTsFields(z, { ...def.server, ...def.client }, gatedKeys)\n\n  await writeDts(root, clientFields, serverFields)\n}\n\n/**\n * Detection-gated preset keys (not user-overridden) validate as optional\n * off-platform — typing them required would lie during local dev.\n */\nfunction gatedPresetKeys(def: EnvDefinition): Set<string> {\n  const keys = new Set<string>()\n  for (const preset of def.presets ?? []) {\n    if (!preset.detect)\n      continue\n    for (const side of ['server', 'client'] as const) {\n      for (const [key, schema] of Object.entries(preset[side] ?? {})) {\n        if (def[side]?.[key] === schema)\n          keys.add(key)\n      }\n    }\n  }\n  return keys\n}\n\n/**\n * Writes vite-env.d.ts for Standard Schema definitions.\n * All fields are typed as `string` — Standard Schema has no runtime type introspection.\n */\nexport async function generateStandardDts(\n  def: StandardEnvDefinition,\n  root: string,\n): Promise<void> {\n  const clientKeys = Object.keys(def.client ?? {})\n  const serverKeys = [...Object.keys(def.server ?? {}), ...clientKeys]\n\n  const clientFields = keysToTsFields(clientKeys)\n  const serverFields = keysToTsFields(serverKeys)\n\n  await writeDts(root, clientFields, serverFields, '(Standard Schema)')\n}\n\nfunction buildHeader(tag = ''): string {\n  const lines = [\n    '/* oxlint-disable */',\n    '/* eslint-disable */',\n    '// @ts-nocheck',\n    '// biome-ignore-all lint: auto-generated',\n    `// Auto-generated by @vite-env/core${tag ? ` ${tag}` : ''}`,\n    '// Do not edit manually — re-generated on every dev server start and build',\n  ]\n  if (tag) {\n    lines.push('// Tip: for richer types, use defineEnv() with Zod instead of defineStandardEnv()')\n  }\n  return lines.join('\\n')\n}\n\nasync function writeDts(\n  root: string,\n  clientFields: string,\n  serverFields: string,\n  tag = '',\n): Promise<void> {\n  const header = buildHeader(tag)\n\n  const dts = `${header}\n\ndeclare module 'virtual:env/client' {\n  const env: {\n${clientFields}\n  }\n  export { env }\n  export default env\n}\n\ndeclare module 'virtual:env/server' {\n  const env: {\n${serverFields}\n  }\n  export { env }\n  export default env\n}\n`\n\n  const filePath = path.join(root, 'vite-env.d.ts')\n  try {\n    await fs.writeFile(filePath, dts, 'utf-8')\n  }\n  catch (e) {\n    throw new Error(\n      `[vite-env] Failed to write vite-env.d.ts to ${root}. Check file permissions.`,\n      { cause: e },\n    )\n  }\n}\n\nfunction keysToTsFields(keys: string[]): string {\n  return keys\n    .map(key => `    readonly ${key}: string`)\n    .join('\\n')\n}\n\nfunction zodShapeToTsFields(z: typeof ZodNs, shape: Record<string, unknown>, gatedKeys: Set<string>): string {\n  return Object.entries(shape)\n    .map(([key, schema]) => {\n      const tsType = zodToTs(z, schema)\n      const optional = schema instanceof z.ZodOptional || gatedKeys.has(key)\n      return `    readonly ${key}${optional ? '?' : ''}: ${tsType}`\n    })\n    .join('\\n')\n}\n\nfunction zodToTs(z: typeof ZodNs, schema: unknown): string {\n  if (schema instanceof z.ZodOptional)\n    return zodToTs(z, schema.unwrap())\n  if (schema instanceof z.ZodDefault)\n    return zodToTs(z, schema.def.innerType)\n  if (schema instanceof z.ZodString)\n    return 'string'\n  if (schema instanceof z.ZodNumber)\n    return 'number'\n  if (schema instanceof z.ZodBoolean)\n    return 'boolean'\n  if (schema instanceof z.ZodEnum)\n    return (schema.options as string[]).map(o => `'${o}'`).join(' | ')\n  if (schema instanceof z.ZodPipe)\n    return zodToTs(z, schema.def.out)\n  return 'string'\n}\n"],"mappings":";;;;;;;;AAWA,eAAsB,YACpB,KACA,MACe;CACf,MAAM,EAAE,MAAM,MAAM,OAAO;CAE3B,MAAM,YAAY,gBAAgB,IAAI;AAItC,OAAM,SAAS,MAHM,mBAAmB,GAAG,EAAE,GAAG,IAAI,QAAQ,EAAE,UAG7B,EAFZ,mBAAmB,GAAG;EAAE,GAAG,IAAI;EAAQ,GAAG,IAAI;EAAQ,EAAE,UAE9B,CAAC;;;;;;AAOlD,SAAS,gBAAgB,KAAiC;CACxD,MAAM,uBAAO,IAAI,KAAa;AAC9B,MAAK,MAAM,UAAU,IAAI,WAAW,EAAE,EAAE;AACtC,MAAI,CAAC,OAAO,OACV;AACF,OAAK,MAAM,QAAQ,CAAC,UAAU,SAAS,CACrC,MAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,OAAO,SAAS,EAAE,CAAC,CAC5D,KAAI,IAAI,QAAQ,SAAS,OACvB,MAAK,IAAI,IAAI;;AAIrB,QAAO;;;;;;AAOT,eAAsB,oBACpB,KACA,MACe;CACf,MAAM,aAAa,OAAO,KAAK,IAAI,UAAU,EAAE,CAAC;CAChD,MAAM,aAAa,CAAC,GAAG,OAAO,KAAK,IAAI,UAAU,EAAE,CAAC,EAAE,GAAG,WAAW;AAKpE,OAAM,SAAS,MAHM,eAAe,WAGH,EAFZ,eAAe,WAEW,EAAE,oBAAoB;;AAGvE,SAAS,YAAY,MAAM,IAAY;CACrC,MAAM,QAAQ;EACZ;EACA;EACA;EACA;EACA,sCAAsC,MAAM,IAAI,QAAQ;EACxD;EACD;AACD,KAAI,IACF,OAAM,KAAK,oFAAoF;AAEjG,QAAO,MAAM,KAAK,KAAK;;AAGzB,eAAe,SACb,MACA,cACA,cACA,MAAM,IACS;CAGf,MAAM,MAAM,GAFG,YAAY,IAEN,CAAC;;;;EAItB,aAAa;;;;;;;;EAQb,aAAa;;;;;;CAOb,MAAM,WAAW,KAAK,KAAK,MAAM,gBAAgB;AACjD,KAAI;AACF,QAAM,GAAG,UAAU,UAAU,KAAK,QAAQ;UAErC,GAAG;AACR,QAAM,IAAI,MACR,+CAA+C,KAAK,4BACpD,EAAE,OAAO,GAAG,CACb;;;AAIL,SAAS,eAAe,MAAwB;AAC9C,QAAO,KACJ,KAAI,QAAO,gBAAgB,IAAI,UAAU,CACzC,KAAK,KAAK;;AAGf,SAAS,mBAAmB,GAAiB,OAAgC,WAAgC;AAC3G,QAAO,OAAO,QAAQ,MAAM,CACzB,KAAK,CAAC,KAAK,YAAY;EACtB,MAAM,SAAS,QAAQ,GAAG,OAAO;AAEjC,SAAO,gBAAgB,MADN,kBAAkB,EAAE,eAAe,UAAU,IAAI,IAAI,GAC9B,MAAM,GAAG,IAAI;GACrD,CACD,KAAK,KAAK;;AAGf,SAAS,QAAQ,GAAiB,QAAyB;AACzD,KAAI,kBAAkB,EAAE,YACtB,QAAO,QAAQ,GAAG,OAAO,QAAQ,CAAC;AACpC,KAAI,kBAAkB,EAAE,WACtB,QAAO,QAAQ,GAAG,OAAO,IAAI,UAAU;AACzC,KAAI,kBAAkB,EAAE,UACtB,QAAO;AACT,KAAI,kBAAkB,EAAE,UACtB,QAAO;AACT,KAAI,kBAAkB,EAAE,WACtB,QAAO;AACT,KAAI,kBAAkB,EAAE,QACtB,QAAQ,OAAO,QAAqB,KAAI,MAAK,IAAI,EAAE,GAAG,CAAC,KAAK,MAAM;AACpE,KAAI,kBAAkB,EAAE,QACtB,QAAO,QAAQ,GAAG,OAAO,IAAI,IAAI;AACnC,QAAO"}
+{"version":3,"file":"dts.mjs","names":[],"sources":["../src/dts.ts"],"sourcesContent":["// @env node\nimport type { EnvDefinition, StandardEnvDefinition } from \"./types\";\nimport type { z as ZodNs } from \"zod\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/**\n * Writes vite-env.d.ts for Zod definitions.\n * Uses instanceof checks to infer TypeScript types from Zod schemas.\n * Zod is loaded dynamically so this module can be imported without zod installed.\n */\nexport async function generateDts(def: EnvDefinition, root: string): Promise<void> {\n  const { z } = await import(\"zod\");\n\n  const gatedKeys = gatedPresetKeys(def);\n  const clientFields = zodShapeToTsFields(z, { ...def.client }, gatedKeys);\n  const serverFields = zodShapeToTsFields(z, { ...def.server, ...def.client }, gatedKeys);\n\n  await writeDts(root, clientFields, serverFields);\n}\n\n/**\n * Detection-gated preset keys (not user-overridden) validate as optional\n * off-platform — typing them required would lie during local dev.\n */\nfunction gatedPresetKeys(def: EnvDefinition): Set<string> {\n  const keys = new Set<string>();\n  for (const preset of def.presets ?? []) {\n    if (!preset.detect) continue;\n    for (const side of [\"server\", \"client\"] as const) {\n      for (const [key, schema] of Object.entries(preset[side] ?? {})) {\n        if (def[side]?.[key] === schema) keys.add(key);\n      }\n    }\n  }\n  return keys;\n}\n\n/**\n * Writes vite-env.d.ts for Standard Schema definitions.\n * All fields are typed as `string` — Standard Schema has no runtime type introspection.\n */\nexport async function generateStandardDts(def: StandardEnvDefinition, root: string): Promise<void> {\n  const clientKeys = Object.keys(def.client ?? {});\n  const serverKeys = [...Object.keys(def.server ?? {}), ...clientKeys];\n\n  const clientFields = keysToTsFields(clientKeys);\n  const serverFields = keysToTsFields(serverKeys);\n\n  await writeDts(root, clientFields, serverFields, \"(Standard Schema)\");\n}\n\nfunction buildHeader(tag = \"\"): string {\n  const lines = [\n    \"/* oxlint-disable */\",\n    \"/* eslint-disable */\",\n    \"// @ts-nocheck\",\n    \"// biome-ignore-all lint: auto-generated\",\n    tag ? `// Auto-generated by @vite-env/core ${tag}` : \"// Auto-generated by @vite-env/core\",\n    \"// Do not edit manually — re-generated on every dev server start and build\",\n  ];\n  if (tag) {\n    lines.push(\"// Tip: for richer types, use defineEnv() with Zod instead of defineStandardEnv()\");\n  }\n  return lines.join(\"\\n\");\n}\n\nasync function writeDts(\n  root: string,\n  clientFields: string,\n  serverFields: string,\n  tag = \"\",\n): Promise<void> {\n  const header = buildHeader(tag);\n\n  const dts = `${header}\n\ndeclare module 'virtual:env/client' {\n  const env: {\n${clientFields}\n  }\n  export { env }\n  export default env\n}\n\ndeclare module 'virtual:env/server' {\n  const env: {\n${serverFields}\n  }\n  export { env }\n  export default env\n}\n`;\n\n  const filePath = path.join(root, \"vite-env.d.ts\");\n  try {\n    await fs.writeFile(filePath, dts, \"utf-8\");\n  } catch (e) {\n    throw new Error(\n      `[vite-env] Failed to write vite-env.d.ts to ${root}. Check file permissions.`,\n      { cause: e },\n    );\n  }\n}\n\nfunction keysToTsFields(keys: string[]): string {\n  return keys.map((key) => `    readonly ${key}: string`).join(\"\\n\");\n}\n\nfunction zodShapeToTsFields(\n  z: typeof ZodNs,\n  shape: Record<string, unknown>,\n  gatedKeys: Set<string>,\n): string {\n  return Object.entries(shape)\n    .map(([key, schema]) => {\n      const tsType = zodToTs(z, schema);\n      const optional = schema instanceof z.ZodOptional || gatedKeys.has(key);\n      return `    readonly ${key}${optional ? \"?\" : \"\"}: ${tsType}`;\n    })\n    .join(\"\\n\");\n}\n\nfunction zodToTs(z: typeof ZodNs, schema: unknown): string {\n  if (schema instanceof z.ZodOptional) return zodToTs(z, schema.unwrap());\n  if (schema instanceof z.ZodDefault) return zodToTs(z, schema.def.innerType);\n  if (schema instanceof z.ZodString) return \"string\";\n  if (schema instanceof z.ZodNumber) return \"number\";\n  if (schema instanceof z.ZodBoolean) return \"boolean\";\n  if (schema instanceof z.ZodEnum)\n    return (schema.options as string[]).map((o) => `'${o}'`).join(\" | \");\n  if (schema instanceof z.ZodPipe) return zodToTs(z, schema.def.out);\n  return \"string\";\n}\n"],"mappings":";;;;;;;;AAWA,eAAsB,YAAY,KAAoB,MAA6B;CACjF,MAAM,EAAE,MAAM,MAAM,OAAO;CAE3B,MAAM,YAAY,gBAAgB,IAAI;AAItC,OAAM,SAAS,MAHM,mBAAmB,GAAG,EAAE,GAAG,IAAI,QAAQ,EAAE,UAG7B,EAFZ,mBAAmB,GAAG;EAAE,GAAG,IAAI;EAAQ,GAAG,IAAI;EAAQ,EAAE,UAE9B,CAAC;;;;;;AAOlD,SAAS,gBAAgB,KAAiC;CACxD,MAAM,uBAAO,IAAI,KAAa;AAC9B,MAAK,MAAM,UAAU,IAAI,WAAW,EAAE,EAAE;AACtC,MAAI,CAAC,OAAO,OAAQ;AACpB,OAAK,MAAM,QAAQ,CAAC,UAAU,SAAS,CACrC,MAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,OAAO,SAAS,EAAE,CAAC,CAC5D,KAAI,IAAI,QAAQ,SAAS,OAAQ,MAAK,IAAI,IAAI;;AAIpD,QAAO;;;;;;AAOT,eAAsB,oBAAoB,KAA4B,MAA6B;CACjG,MAAM,aAAa,OAAO,KAAK,IAAI,UAAU,EAAE,CAAC;CAChD,MAAM,aAAa,CAAC,GAAG,OAAO,KAAK,IAAI,UAAU,EAAE,CAAC,EAAE,GAAG,WAAW;AAKpE,OAAM,SAAS,MAHM,eAAe,WAGH,EAFZ,eAAe,WAEW,EAAE,oBAAoB;;AAGvE,SAAS,YAAY,MAAM,IAAY;CACrC,MAAM,QAAQ;EACZ;EACA;EACA;EACA;EACA,MAAM,uCAAuC,QAAQ;EACrD;EACD;AACD,KAAI,IACF,OAAM,KAAK,oFAAoF;AAEjG,QAAO,MAAM,KAAK,KAAK;;AAGzB,eAAe,SACb,MACA,cACA,cACA,MAAM,IACS;CAGf,MAAM,MAAM,GAFG,YAAY,IAEN,CAAC;;;;EAItB,aAAa;;;;;;;;EAQb,aAAa;;;;;;CAOb,MAAM,WAAW,KAAK,KAAK,MAAM,gBAAgB;AACjD,KAAI;AACF,QAAM,GAAG,UAAU,UAAU,KAAK,QAAQ;UACnC,GAAG;AACV,QAAM,IAAI,MACR,+CAA+C,KAAK,4BACpD,EAAE,OAAO,GAAG,CACb;;;AAIL,SAAS,eAAe,MAAwB;AAC9C,QAAO,KAAK,KAAK,QAAQ,gBAAgB,IAAI,UAAU,CAAC,KAAK,KAAK;;AAGpE,SAAS,mBACP,GACA,OACA,WACQ;AACR,QAAO,OAAO,QAAQ,MAAM,CACzB,KAAK,CAAC,KAAK,YAAY;EACtB,MAAM,SAAS,QAAQ,GAAG,OAAO;AAEjC,SAAO,gBAAgB,MADN,kBAAkB,EAAE,eAAe,UAAU,IAAI,IAAI,GAC9B,MAAM,GAAG,IAAI;GACrD,CACD,KAAK,KAAK;;AAGf,SAAS,QAAQ,GAAiB,QAAyB;AACzD,KAAI,kBAAkB,EAAE,YAAa,QAAO,QAAQ,GAAG,OAAO,QAAQ,CAAC;AACvE,KAAI,kBAAkB,EAAE,WAAY,QAAO,QAAQ,GAAG,OAAO,IAAI,UAAU;AAC3E,KAAI,kBAAkB,EAAE,UAAW,QAAO;AAC1C,KAAI,kBAAkB,EAAE,UAAW,QAAO;AAC1C,KAAI,kBAAkB,EAAE,WAAY,QAAO;AAC3C,KAAI,kBAAkB,EAAE,QACtB,QAAQ,OAAO,QAAqB,KAAK,MAAM,IAAI,EAAE,GAAG,CAAC,KAAK,MAAM;AACtE,KAAI,kBAAkB,EAAE,QAAS,QAAO,QAAQ,GAAG,OAAO,IAAI,IAAI;AAClE,QAAO"}

package/dist/format.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"format.cjs","names":[],"sources":["../src/format.ts"],"sourcesContent":["import type { core } from 'zod'\nimport type { GuardFail } from './guard'\nimport type { StandardValidationIssue } from './types'\n\nexport function formatZodError(issues: core.$ZodIssue[]): string {\n  return issues\n    .map((issue) => {\n      const path = issue.path.length > 0 ? issue.path.join('.') : '(root)'\n      return `  \\x1B[31m✗\\x1B[0m ${path.padEnd(28)} ${issue.message}`\n    })\n    .join('\\n')\n}\n\nexport function formatStandardSchemaError(issues: StandardValidationIssue[]): string {\n  return issues\n    .map((issue) => {\n      const path = issue.path.length > 0\n        ? issue.path.map(seg => typeof seg === 'object' && seg !== null && 'key' in seg ? String(seg.key) : String(seg)).join('.')\n        : '(root)'\n      return `  \\x1B[31m✗\\x1B[0m ${path.padEnd(28)} ${issue.message}`\n    })\n    .join('\\n')\n}\n\nconst YELLOW = '\\x1B[33m'\nconst BOLD_YELLOW = '\\x1B[1;33m'\nconst CYAN = '\\x1B[36m'\nconst RESET = '\\x1B[0m'\n\nconst BOX_WIDTH = 66\n// 1 left border + 2 left spaces + content + 1 right border = BOX_WIDTH\n// content area = BOX_WIDTH - 4\nconst CONTENT_AREA = BOX_WIDTH - 4\n\n/** Maximum visible character length for an importer path inside the warning box. */\nexport const IMPORTER_MAX_LEN = CONTENT_AREA - 'Found in: '.length\n\n/**\n * Truncates an importer path to fit within maxLen visible characters.\n * Adds a leading '…' when truncation occurs so the rightmost (most specific) part is preserved.\n */\nexport function truncateImporter(importerPath: string, maxLen: number): string {\n  if (importerPath.length <= maxLen)\n    return importerPath\n  return `\\u2026${importerPath.slice(-(maxLen - 1))}`\n}\n\nfunction boxTop(): string {\n  return `${YELLOW}\\u250C${'─'.repeat(BOX_WIDTH - 2)}\\u2510${RESET}`\n}\n\nfunction boxBottom(): string {\n  return `${YELLOW}\\u2514${'─'.repeat(BOX_WIDTH - 2)}\\u2518${RESET}`\n}\n\nfunction boxLine(visibleText: string, renderedText = visibleText): string {\n  const rightPad = ' '.repeat(Math.max(0, CONTENT_AREA - visibleText.length))\n  return `${YELLOW}\\u2502${RESET}  ${renderedText}${rightPad}${YELLOW}\\u2502${RESET}`\n}\n\n/**\n * Renders the colored terminal warning box for 'warn' mode.\n * Every line is exactly 66 characters wide (visible chars, excluding ANSI codes),\n * assuming Vite environment names are short (≤19 chars). Longer names will extend\n * the line beyond 66 chars without crashing — Math.max(0) prevents negative padding.\n * Use in logger.warn() calls — not in log files.\n */\nexport function formatGuardWarning(fail: GuardFail): string {\n  const importerDisplay = fail.importer === undefined\n    ? '(unknown)'\n    : truncateImporter(fail.importer, IMPORTER_MAX_LEN)\n\n  const warnTitle = 'To enforce now:  onClientAccessOfServerModule: \\'error\\''\n  const stubTitle = 'To silence:      onClientAccessOfServerModule: \\'stub\\''\n\n  return [\n    boxTop(),\n    boxLine(\n      '[vite-env] DEPRECATION WARNING',\n      `${BOLD_YELLOW}[vite-env] DEPRECATION WARNING${RESET}`,\n    ),\n    boxLine(''),\n    boxLine(`virtual:env/server was imported from the \"${fail.envName}\"`),\n    boxLine('environment. This will be a hard build error in 1.0.0.'),\n    boxLine(''),\n    boxLine(warnTitle, `To enforce now:  ${CYAN}onClientAccessOfServerModule: 'error'${RESET}`),\n    boxLine(stubTitle, `To silence:      ${CYAN}onClientAccessOfServerModule: 'stub'${RESET}`),\n    boxLine(''),\n    boxLine(`Found in: ${importerDisplay}`),\n    boxBottom(),\n  ].join('\\n')\n}\n\n/**\n * Renders the plain-text hard error message thrown in 'error' mode.\n * No ANSI — thrown as an Error message, not printed via logger.\n */\nexport function formatHardError(fail: GuardFail): string {\n  const importerLine = fail.importer ?? '(unknown)'\n  return [\n    `[vite-env] virtual:env/server is not available in the \"${fail.envName}\" environment.`,\n    ``,\n    `  Server-only modules cannot be imported from client code.`,\n    `  Add this environment to serverEnvironments if intentional:`,\n    ``,\n    `    ViteEnv({ serverEnvironments: ['ssr', '${fail.envName}'] })`,\n    ``,\n    `  Or change enforcement:`,\n    ``,\n    `    ViteEnv({ onClientAccessOfServerModule: 'stub' })`,\n    ``,\n    `  Imported from: ${importerLine}`,\n  ].join('\\n')\n}\n\n/**\n * Renders a single ANSI-free log entry for vite-env-warnings.log.\n * Uses the same (unknown) convention as formatGuardWarning for missing importers.\n */\nexport function formatGuardLogEntry(fail: GuardFail, timestamp: string): string {\n  const importerLine = fail.importer ?? '(unknown)'\n  return [\n    `[${timestamp}] virtual:env/server accessed from \"${fail.envName}\" environment`,\n    `  Importer: ${importerLine}`,\n  ].join('\\n')\n}\n"],"mappings":";;AAIA,SAAgB,eAAe,QAAkC;AAC/D,QAAO,OACJ,KAAK,UAAU;AAEd,SAAO,uBADM,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,KAAK,IAAI,GAAG,UAC1B,OAAO,GAAG,CAAC,GAAG,MAAM;GACtD,CACD,KAAK,KAAK;;AAGf,SAAgB,0BAA0B,QAA2C;AACnF,QAAO,OACJ,KAAK,UAAU;AAId,SAAO,uBAHM,MAAM,KAAK,SAAS,IAC7B,MAAM,KAAK,KAAI,QAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,SAAS,MAAM,OAAO,IAAI,IAAI,GAAG,OAAO,IAAI,CAAC,CAAC,KAAK,IAAI,GACxH,UAC8B,OAAO,GAAG,CAAC,GAAG,MAAM;GACtD,CACD,KAAK,KAAK;;AAGf,MAAM,SAAS;AACf,MAAM,cAAc;AACpB,MAAM,OAAO;AACb,MAAM,QAAQ;AAEd,MAAM,YAAY;AAGlB,MAAM,eAAe,YAAY;;AAGjC,MAAa,mBAAmB,eAAe;;;;;AAM/C,SAAgB,iBAAiB,cAAsB,QAAwB;AAC7E,KAAI,aAAa,UAAU,OACzB,QAAO;AACT,QAAO,SAAS,aAAa,MAAM,EAAE,SAAS,GAAG;;AAGnD,SAAS,SAAiB;AACxB,QAAO,GAAG,OAAO,QAAQ,IAAI,OAAO,YAAY,EAAE,CAAC,QAAQ;;AAG7D,SAAS,YAAoB;AAC3B,QAAO,GAAG,OAAO,QAAQ,IAAI,OAAO,YAAY,EAAE,CAAC,QAAQ;;AAG7D,SAAS,QAAQ,aAAqB,eAAe,aAAqB;AAExE,QAAO,GAAG,OAAO,QAAQ,MAAM,IAAI,eADlB,IAAI,OAAO,KAAK,IAAI,GAAG,eAAe,YAAY,OAAO,CAChB,GAAG,OAAO,QAAQ;;;;;;;;;AAU9E,SAAgB,mBAAmB,MAAyB;CAC1D,MAAM,kBAAkB,KAAK,aAAa,KAAA,IACtC,cACA,iBAAiB,KAAK,UAAA,GAA2B;AAKrD,QAAO;EACL,QAAQ;EACR,QACE,kCACA,GAAG,YAAY,gCAAgC,QAChD;EACD,QAAQ,GAAG;EACX,QAAQ,6CAA6C,KAAK,QAAQ,GAAG;EACrE,QAAQ,yDAAyD;EACjE,QAAQ,GAAG;EACX,QAAQ,0DAAW,oBAAoB,KAAK,uCAAuC,QAAQ;EAC3F,QAAQ,yDAAW,oBAAoB,KAAK,sCAAsC,QAAQ;EAC1F,QAAQ,GAAG;EACX,QAAQ,aAAa,kBAAkB;EACvC,WAAW;EACZ,CAAC,KAAK,KAAK;;;;;;AAOd,SAAgB,gBAAgB,MAAyB;CACvD,MAAM,eAAe,KAAK,YAAY;AACtC,QAAO;EACL,0DAA0D,KAAK,QAAQ;EACvE;EACA;EACA;EACA;EACA,8CAA8C,KAAK,QAAQ;EAC3D;EACA;EACA;EACA;EACA;EACA,oBAAoB;EACrB,CAAC,KAAK,KAAK;;;;;;AAOd,SAAgB,oBAAoB,MAAiB,WAA2B;CAC9E,MAAM,eAAe,KAAK,YAAY;AACtC,QAAO,CACL,IAAI,UAAU,sCAAsC,KAAK,QAAQ,gBACjE,eAAe,eAChB,CAAC,KAAK,KAAK"}
+{"version":3,"file":"format.cjs","names":[],"sources":["../src/format.ts"],"sourcesContent":["import type { core } from \"zod\";\nimport type { GuardFail } from \"./guard\";\nimport type { StandardValidationIssue } from \"./types\";\n\nexport function formatZodError(issues: core.$ZodIssue[]): string {\n  return issues\n    .map((issue) => {\n      const path = issue.path.length > 0 ? issue.path.join(\".\") : \"(root)\";\n      return `  \\x1B[31m✗\\x1B[0m ${path.padEnd(28)} ${issue.message}`;\n    })\n    .join(\"\\n\");\n}\n\nexport function formatStandardSchemaError(issues: StandardValidationIssue[]): string {\n  return issues\n    .map((issue) => {\n      const path =\n        issue.path.length > 0\n          ? issue.path\n              .map((seg) =>\n                typeof seg === \"object\" && seg !== null && \"key\" in seg\n                  ? String(seg.key)\n                  : String(seg),\n              )\n              .join(\".\")\n          : \"(root)\";\n      return `  \\x1B[31m✗\\x1B[0m ${path.padEnd(28)} ${issue.message}`;\n    })\n    .join(\"\\n\");\n}\n\nconst YELLOW = \"\\x1B[33m\";\nconst BOLD_YELLOW = \"\\x1B[1;33m\";\nconst CYAN = \"\\x1B[36m\";\nconst RESET = \"\\x1B[0m\";\n\nconst BOX_WIDTH = 66;\n// 1 left border + 2 left spaces + content + 1 right border = BOX_WIDTH\n// content area = BOX_WIDTH - 4\nconst CONTENT_AREA = BOX_WIDTH - 4;\n\n/** Maximum visible character length for an importer path inside the warning box. */\nexport const IMPORTER_MAX_LEN = CONTENT_AREA - \"Found in: \".length;\n\n/**\n * Truncates an importer path to fit within maxLen visible characters.\n * Adds a leading '…' when truncation occurs so the rightmost (most specific) part is preserved.\n */\nexport function truncateImporter(importerPath: string, maxLen: number): string {\n  if (importerPath.length <= maxLen) return importerPath;\n  return `\\u2026${importerPath.slice(-(maxLen - 1))}`;\n}\n\nfunction boxTop(): string {\n  return `${YELLOW}\\u250C${\"─\".repeat(BOX_WIDTH - 2)}\\u2510${RESET}`;\n}\n\nfunction boxBottom(): string {\n  return `${YELLOW}\\u2514${\"─\".repeat(BOX_WIDTH - 2)}\\u2518${RESET}`;\n}\n\nfunction boxLine(visibleText: string, renderedText = visibleText): string {\n  const rightPad = \" \".repeat(Math.max(0, CONTENT_AREA - visibleText.length));\n  return `${YELLOW}\\u2502${RESET}  ${renderedText}${rightPad}${YELLOW}\\u2502${RESET}`;\n}\n\n/**\n * Renders the colored terminal warning box for 'warn' mode.\n * Every line is exactly 66 characters wide (visible chars, excluding ANSI codes),\n * assuming Vite environment names are short (≤19 chars). Longer names will extend\n * the line beyond 66 chars without crashing — Math.max(0) prevents negative padding.\n * Use in logger.warn() calls — not in log files.\n */\nexport function formatGuardWarning(fail: GuardFail): string {\n  const importerDisplay =\n    fail.importer === undefined ? \"(unknown)\" : truncateImporter(fail.importer, IMPORTER_MAX_LEN);\n\n  const warnTitle = \"To enforce now:  onClientAccessOfServerModule: 'error'\";\n  const stubTitle = \"To silence:      onClientAccessOfServerModule: 'stub'\";\n\n  return [\n    boxTop(),\n    boxLine(\n      \"[vite-env] DEPRECATION WARNING\",\n      `${BOLD_YELLOW}[vite-env] DEPRECATION WARNING${RESET}`,\n    ),\n    boxLine(\"\"),\n    boxLine(`virtual:env/server was imported from the \"${fail.envName}\"`),\n    boxLine(\"environment. This will be a hard build error in 1.0.0.\"),\n    boxLine(\"\"),\n    boxLine(warnTitle, `To enforce now:  ${CYAN}onClientAccessOfServerModule: 'error'${RESET}`),\n    boxLine(stubTitle, `To silence:      ${CYAN}onClientAccessOfServerModule: 'stub'${RESET}`),\n    boxLine(\"\"),\n    boxLine(`Found in: ${importerDisplay}`),\n    boxBottom(),\n  ].join(\"\\n\");\n}\n\n/**\n * Renders the plain-text hard error message thrown in 'error' mode.\n * No ANSI — thrown as an Error message, not printed via logger.\n */\nexport function formatHardError(fail: GuardFail): string {\n  const importerLine = fail.importer ?? \"(unknown)\";\n  return [\n    `[vite-env] virtual:env/server is not available in the \"${fail.envName}\" environment.`,\n    ``,\n    `  Server-only modules cannot be imported from client code.`,\n    `  Add this environment to serverEnvironments if intentional:`,\n    ``,\n    `    ViteEnv({ serverEnvironments: ['ssr', '${fail.envName}'] })`,\n    ``,\n    `  Or change enforcement:`,\n    ``,\n    `    ViteEnv({ onClientAccessOfServerModule: 'stub' })`,\n    ``,\n    `  Imported from: ${importerLine}`,\n  ].join(\"\\n\");\n}\n\n/**\n * Renders a single ANSI-free log entry for vite-env-warnings.log.\n * Uses the same (unknown) convention as formatGuardWarning for missing importers.\n */\nexport function formatGuardLogEntry(fail: GuardFail, timestamp: string): string {\n  const importerLine = fail.importer ?? \"(unknown)\";\n  return [\n    `[${timestamp}] virtual:env/server accessed from \"${fail.envName}\" environment`,\n    `  Importer: ${importerLine}`,\n  ].join(\"\\n\");\n}\n"],"mappings":";;AAIA,SAAgB,eAAe,QAAkC;AAC/D,QAAO,OACJ,KAAK,UAAU;AAEd,SAAO,uBADM,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,KAAK,IAAI,GAAG,UAC1B,OAAO,GAAG,CAAC,GAAG,MAAM;GACtD,CACD,KAAK,KAAK;;AAGf,SAAgB,0BAA0B,QAA2C;AACnF,QAAO,OACJ,KAAK,UAAU;AAWd,SAAO,uBATL,MAAM,KAAK,SAAS,IAChB,MAAM,KACH,KAAK,QACJ,OAAO,QAAQ,YAAY,QAAQ,QAAQ,SAAS,MAChD,OAAO,IAAI,IAAI,GACf,OAAO,IAAI,CAChB,CACA,KAAK,IAAI,GACZ,UAC4B,OAAO,GAAG,CAAC,GAAG,MAAM;GACtD,CACD,KAAK,KAAK;;AAGf,MAAM,SAAS;AACf,MAAM,cAAc;AACpB,MAAM,OAAO;AACb,MAAM,QAAQ;AAEd,MAAM,YAAY;AAGlB,MAAM,eAAe,YAAY;;AAGjC,MAAa,mBAAmB,eAAe;;;;;AAM/C,SAAgB,iBAAiB,cAAsB,QAAwB;AAC7E,KAAI,aAAa,UAAU,OAAQ,QAAO;AAC1C,QAAO,SAAS,aAAa,MAAM,EAAE,SAAS,GAAG;;AAGnD,SAAS,SAAiB;AACxB,QAAO,GAAG,OAAO,QAAQ,IAAI,OAAO,YAAY,EAAE,CAAC,QAAQ;;AAG7D,SAAS,YAAoB;AAC3B,QAAO,GAAG,OAAO,QAAQ,IAAI,OAAO,YAAY,EAAE,CAAC,QAAQ;;AAG7D,SAAS,QAAQ,aAAqB,eAAe,aAAqB;AAExE,QAAO,GAAG,OAAO,QAAQ,MAAM,IAAI,eADlB,IAAI,OAAO,KAAK,IAAI,GAAG,eAAe,YAAY,OAAO,CAChB,GAAG,OAAO,QAAQ;;;;;;;;;AAU9E,SAAgB,mBAAmB,MAAyB;CAC1D,MAAM,kBACJ,KAAK,aAAa,KAAA,IAAY,cAAc,iBAAiB,KAAK,UAAA,GAA2B;AAK/F,QAAO;EACL,QAAQ;EACR,QACE,kCACA,GAAG,YAAY,gCAAgC,QAChD;EACD,QAAQ,GAAG;EACX,QAAQ,6CAA6C,KAAK,QAAQ,GAAG;EACrE,QAAQ,yDAAyD;EACjE,QAAQ,GAAG;EACX,QAAQ,0DAAW,oBAAoB,KAAK,uCAAuC,QAAQ;EAC3F,QAAQ,yDAAW,oBAAoB,KAAK,sCAAsC,QAAQ;EAC1F,QAAQ,GAAG;EACX,QAAQ,aAAa,kBAAkB;EACvC,WAAW;EACZ,CAAC,KAAK,KAAK;;;;;;AAOd,SAAgB,gBAAgB,MAAyB;CACvD,MAAM,eAAe,KAAK,YAAY;AACtC,QAAO;EACL,0DAA0D,KAAK,QAAQ;EACvE;EACA;EACA;EACA;EACA,8CAA8C,KAAK,QAAQ;EAC3D;EACA;EACA;EACA;EACA;EACA,oBAAoB;EACrB,CAAC,KAAK,KAAK;;;;;;AAOd,SAAgB,oBAAoB,MAAiB,WAA2B;CAC9E,MAAM,eAAe,KAAK,YAAY;AACtC,QAAO,CACL,IAAI,UAAU,sCAAsC,KAAK,QAAQ,gBACjE,eAAe,eAChB,CAAC,KAAK,KAAK"}

package/dist/format.d.cts

@@ -1,8 +1,8 @@
-import { s as StandardValidationIssue } from "./types-B61nsO8q.cjs";
+import { s as StandardValidationIssue } from "./types-DudMh278.cjs";
 import { core } from "zod";
 
 //#region src/guard.d.ts
-type GuardMode = 'error' | 'stub' | 'warn';
+type GuardMode = "error" | "stub" | "warn";
 type GuardResult = {
   allowed: true;
 } | {

package/dist/format.d.mts

@@ -1,8 +1,8 @@
-import { s as StandardValidationIssue } from "./types-KniR_Oqf.mjs";
+import { s as StandardValidationIssue } from "./types-Ctg8aeXQ.mjs";
 import { core } from "zod";
 
 //#region src/guard.d.ts
-type GuardMode = 'error' | 'stub' | 'warn';
+type GuardMode = "error" | "stub" | "warn";
 type GuardResult = {
   allowed: true;
 } | {

package/dist/format.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"format.mjs","names":[],"sources":["../src/format.ts"],"sourcesContent":["import type { core } from 'zod'\nimport type { GuardFail } from './guard'\nimport type { StandardValidationIssue } from './types'\n\nexport function formatZodError(issues: core.$ZodIssue[]): string {\n  return issues\n    .map((issue) => {\n      const path = issue.path.length > 0 ? issue.path.join('.') : '(root)'\n      return `  \\x1B[31m✗\\x1B[0m ${path.padEnd(28)} ${issue.message}`\n    })\n    .join('\\n')\n}\n\nexport function formatStandardSchemaError(issues: StandardValidationIssue[]): string {\n  return issues\n    .map((issue) => {\n      const path = issue.path.length > 0\n        ? issue.path.map(seg => typeof seg === 'object' && seg !== null && 'key' in seg ? String(seg.key) : String(seg)).join('.')\n        : '(root)'\n      return `  \\x1B[31m✗\\x1B[0m ${path.padEnd(28)} ${issue.message}`\n    })\n    .join('\\n')\n}\n\nconst YELLOW = '\\x1B[33m'\nconst BOLD_YELLOW = '\\x1B[1;33m'\nconst CYAN = '\\x1B[36m'\nconst RESET = '\\x1B[0m'\n\nconst BOX_WIDTH = 66\n// 1 left border + 2 left spaces + content + 1 right border = BOX_WIDTH\n// content area = BOX_WIDTH - 4\nconst CONTENT_AREA = BOX_WIDTH - 4\n\n/** Maximum visible character length for an importer path inside the warning box. */\nexport const IMPORTER_MAX_LEN = CONTENT_AREA - 'Found in: '.length\n\n/**\n * Truncates an importer path to fit within maxLen visible characters.\n * Adds a leading '…' when truncation occurs so the rightmost (most specific) part is preserved.\n */\nexport function truncateImporter(importerPath: string, maxLen: number): string {\n  if (importerPath.length <= maxLen)\n    return importerPath\n  return `\\u2026${importerPath.slice(-(maxLen - 1))}`\n}\n\nfunction boxTop(): string {\n  return `${YELLOW}\\u250C${'─'.repeat(BOX_WIDTH - 2)}\\u2510${RESET}`\n}\n\nfunction boxBottom(): string {\n  return `${YELLOW}\\u2514${'─'.repeat(BOX_WIDTH - 2)}\\u2518${RESET}`\n}\n\nfunction boxLine(visibleText: string, renderedText = visibleText): string {\n  const rightPad = ' '.repeat(Math.max(0, CONTENT_AREA - visibleText.length))\n  return `${YELLOW}\\u2502${RESET}  ${renderedText}${rightPad}${YELLOW}\\u2502${RESET}`\n}\n\n/**\n * Renders the colored terminal warning box for 'warn' mode.\n * Every line is exactly 66 characters wide (visible chars, excluding ANSI codes),\n * assuming Vite environment names are short (≤19 chars). Longer names will extend\n * the line beyond 66 chars without crashing — Math.max(0) prevents negative padding.\n * Use in logger.warn() calls — not in log files.\n */\nexport function formatGuardWarning(fail: GuardFail): string {\n  const importerDisplay = fail.importer === undefined\n    ? '(unknown)'\n    : truncateImporter(fail.importer, IMPORTER_MAX_LEN)\n\n  const warnTitle = 'To enforce now:  onClientAccessOfServerModule: \\'error\\''\n  const stubTitle = 'To silence:      onClientAccessOfServerModule: \\'stub\\''\n\n  return [\n    boxTop(),\n    boxLine(\n      '[vite-env] DEPRECATION WARNING',\n      `${BOLD_YELLOW}[vite-env] DEPRECATION WARNING${RESET}`,\n    ),\n    boxLine(''),\n    boxLine(`virtual:env/server was imported from the \"${fail.envName}\"`),\n    boxLine('environment. This will be a hard build error in 1.0.0.'),\n    boxLine(''),\n    boxLine(warnTitle, `To enforce now:  ${CYAN}onClientAccessOfServerModule: 'error'${RESET}`),\n    boxLine(stubTitle, `To silence:      ${CYAN}onClientAccessOfServerModule: 'stub'${RESET}`),\n    boxLine(''),\n    boxLine(`Found in: ${importerDisplay}`),\n    boxBottom(),\n  ].join('\\n')\n}\n\n/**\n * Renders the plain-text hard error message thrown in 'error' mode.\n * No ANSI — thrown as an Error message, not printed via logger.\n */\nexport function formatHardError(fail: GuardFail): string {\n  const importerLine = fail.importer ?? '(unknown)'\n  return [\n    `[vite-env] virtual:env/server is not available in the \"${fail.envName}\" environment.`,\n    ``,\n    `  Server-only modules cannot be imported from client code.`,\n    `  Add this environment to serverEnvironments if intentional:`,\n    ``,\n    `    ViteEnv({ serverEnvironments: ['ssr', '${fail.envName}'] })`,\n    ``,\n    `  Or change enforcement:`,\n    ``,\n    `    ViteEnv({ onClientAccessOfServerModule: 'stub' })`,\n    ``,\n    `  Imported from: ${importerLine}`,\n  ].join('\\n')\n}\n\n/**\n * Renders a single ANSI-free log entry for vite-env-warnings.log.\n * Uses the same (unknown) convention as formatGuardWarning for missing importers.\n */\nexport function formatGuardLogEntry(fail: GuardFail, timestamp: string): string {\n  const importerLine = fail.importer ?? '(unknown)'\n  return [\n    `[${timestamp}] virtual:env/server accessed from \"${fail.envName}\" environment`,\n    `  Importer: ${importerLine}`,\n  ].join('\\n')\n}\n"],"mappings":";AAIA,SAAgB,eAAe,QAAkC;AAC/D,QAAO,OACJ,KAAK,UAAU;AAEd,SAAO,uBADM,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,KAAK,IAAI,GAAG,UAC1B,OAAO,GAAG,CAAC,GAAG,MAAM;GACtD,CACD,KAAK,KAAK;;AAGf,SAAgB,0BAA0B,QAA2C;AACnF,QAAO,OACJ,KAAK,UAAU;AAId,SAAO,uBAHM,MAAM,KAAK,SAAS,IAC7B,MAAM,KAAK,KAAI,QAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,SAAS,MAAM,OAAO,IAAI,IAAI,GAAG,OAAO,IAAI,CAAC,CAAC,KAAK,IAAI,GACxH,UAC8B,OAAO,GAAG,CAAC,GAAG,MAAM;GACtD,CACD,KAAK,KAAK;;AAGf,MAAM,SAAS;AACf,MAAM,cAAc;AACpB,MAAM,OAAO;AACb,MAAM,QAAQ;AAEd,MAAM,YAAY;AAGlB,MAAM,eAAe,YAAY;;AAGjC,MAAa,mBAAmB,eAAe;;;;;AAM/C,SAAgB,iBAAiB,cAAsB,QAAwB;AAC7E,KAAI,aAAa,UAAU,OACzB,QAAO;AACT,QAAO,SAAS,aAAa,MAAM,EAAE,SAAS,GAAG;;AAGnD,SAAS,SAAiB;AACxB,QAAO,GAAG,OAAO,QAAQ,IAAI,OAAO,YAAY,EAAE,CAAC,QAAQ;;AAG7D,SAAS,YAAoB;AAC3B,QAAO,GAAG,OAAO,QAAQ,IAAI,OAAO,YAAY,EAAE,CAAC,QAAQ;;AAG7D,SAAS,QAAQ,aAAqB,eAAe,aAAqB;AAExE,QAAO,GAAG,OAAO,QAAQ,MAAM,IAAI,eADlB,IAAI,OAAO,KAAK,IAAI,GAAG,eAAe,YAAY,OAAO,CAChB,GAAG,OAAO,QAAQ;;;;;;;;;AAU9E,SAAgB,mBAAmB,MAAyB;CAC1D,MAAM,kBAAkB,KAAK,aAAa,KAAA,IACtC,cACA,iBAAiB,KAAK,UAAA,GAA2B;AAKrD,QAAO;EACL,QAAQ;EACR,QACE,kCACA,GAAG,YAAY,gCAAgC,QAChD;EACD,QAAQ,GAAG;EACX,QAAQ,6CAA6C,KAAK,QAAQ,GAAG;EACrE,QAAQ,yDAAyD;EACjE,QAAQ,GAAG;EACX,QAAQ,0DAAW,oBAAoB,KAAK,uCAAuC,QAAQ;EAC3F,QAAQ,yDAAW,oBAAoB,KAAK,sCAAsC,QAAQ;EAC1F,QAAQ,GAAG;EACX,QAAQ,aAAa,kBAAkB;EACvC,WAAW;EACZ,CAAC,KAAK,KAAK;;;;;;AAOd,SAAgB,gBAAgB,MAAyB;CACvD,MAAM,eAAe,KAAK,YAAY;AACtC,QAAO;EACL,0DAA0D,KAAK,QAAQ;EACvE;EACA;EACA;EACA;EACA,8CAA8C,KAAK,QAAQ;EAC3D;EACA;EACA;EACA;EACA;EACA,oBAAoB;EACrB,CAAC,KAAK,KAAK;;;;;;AAOd,SAAgB,oBAAoB,MAAiB,WAA2B;CAC9E,MAAM,eAAe,KAAK,YAAY;AACtC,QAAO,CACL,IAAI,UAAU,sCAAsC,KAAK,QAAQ,gBACjE,eAAe,eAChB,CAAC,KAAK,KAAK"}
+{"version":3,"file":"format.mjs","names":[],"sources":["../src/format.ts"],"sourcesContent":["import type { core } from \"zod\";\nimport type { GuardFail } from \"./guard\";\nimport type { StandardValidationIssue } from \"./types\";\n\nexport function formatZodError(issues: core.$ZodIssue[]): string {\n  return issues\n    .map((issue) => {\n      const path = issue.path.length > 0 ? issue.path.join(\".\") : \"(root)\";\n      return `  \\x1B[31m✗\\x1B[0m ${path.padEnd(28)} ${issue.message}`;\n    })\n    .join(\"\\n\");\n}\n\nexport function formatStandardSchemaError(issues: StandardValidationIssue[]): string {\n  return issues\n    .map((issue) => {\n      const path =\n        issue.path.length > 0\n          ? issue.path\n              .map((seg) =>\n                typeof seg === \"object\" && seg !== null && \"key\" in seg\n                  ? String(seg.key)\n                  : String(seg),\n              )\n              .join(\".\")\n          : \"(root)\";\n      return `  \\x1B[31m✗\\x1B[0m ${path.padEnd(28)} ${issue.message}`;\n    })\n    .join(\"\\n\");\n}\n\nconst YELLOW = \"\\x1B[33m\";\nconst BOLD_YELLOW = \"\\x1B[1;33m\";\nconst CYAN = \"\\x1B[36m\";\nconst RESET = \"\\x1B[0m\";\n\nconst BOX_WIDTH = 66;\n// 1 left border + 2 left spaces + content + 1 right border = BOX_WIDTH\n// content area = BOX_WIDTH - 4\nconst CONTENT_AREA = BOX_WIDTH - 4;\n\n/** Maximum visible character length for an importer path inside the warning box. */\nexport const IMPORTER_MAX_LEN = CONTENT_AREA - \"Found in: \".length;\n\n/**\n * Truncates an importer path to fit within maxLen visible characters.\n * Adds a leading '…' when truncation occurs so the rightmost (most specific) part is preserved.\n */\nexport function truncateImporter(importerPath: string, maxLen: number): string {\n  if (importerPath.length <= maxLen) return importerPath;\n  return `\\u2026${importerPath.slice(-(maxLen - 1))}`;\n}\n\nfunction boxTop(): string {\n  return `${YELLOW}\\u250C${\"─\".repeat(BOX_WIDTH - 2)}\\u2510${RESET}`;\n}\n\nfunction boxBottom(): string {\n  return `${YELLOW}\\u2514${\"─\".repeat(BOX_WIDTH - 2)}\\u2518${RESET}`;\n}\n\nfunction boxLine(visibleText: string, renderedText = visibleText): string {\n  const rightPad = \" \".repeat(Math.max(0, CONTENT_AREA - visibleText.length));\n  return `${YELLOW}\\u2502${RESET}  ${renderedText}${rightPad}${YELLOW}\\u2502${RESET}`;\n}\n\n/**\n * Renders the colored terminal warning box for 'warn' mode.\n * Every line is exactly 66 characters wide (visible chars, excluding ANSI codes),\n * assuming Vite environment names are short (≤19 chars). Longer names will extend\n * the line beyond 66 chars without crashing — Math.max(0) prevents negative padding.\n * Use in logger.warn() calls — not in log files.\n */\nexport function formatGuardWarning(fail: GuardFail): string {\n  const importerDisplay =\n    fail.importer === undefined ? \"(unknown)\" : truncateImporter(fail.importer, IMPORTER_MAX_LEN);\n\n  const warnTitle = \"To enforce now:  onClientAccessOfServerModule: 'error'\";\n  const stubTitle = \"To silence:      onClientAccessOfServerModule: 'stub'\";\n\n  return [\n    boxTop(),\n    boxLine(\n      \"[vite-env] DEPRECATION WARNING\",\n      `${BOLD_YELLOW}[vite-env] DEPRECATION WARNING${RESET}`,\n    ),\n    boxLine(\"\"),\n    boxLine(`virtual:env/server was imported from the \"${fail.envName}\"`),\n    boxLine(\"environment. This will be a hard build error in 1.0.0.\"),\n    boxLine(\"\"),\n    boxLine(warnTitle, `To enforce now:  ${CYAN}onClientAccessOfServerModule: 'error'${RESET}`),\n    boxLine(stubTitle, `To silence:      ${CYAN}onClientAccessOfServerModule: 'stub'${RESET}`),\n    boxLine(\"\"),\n    boxLine(`Found in: ${importerDisplay}`),\n    boxBottom(),\n  ].join(\"\\n\");\n}\n\n/**\n * Renders the plain-text hard error message thrown in 'error' mode.\n * No ANSI — thrown as an Error message, not printed via logger.\n */\nexport function formatHardError(fail: GuardFail): string {\n  const importerLine = fail.importer ?? \"(unknown)\";\n  return [\n    `[vite-env] virtual:env/server is not available in the \"${fail.envName}\" environment.`,\n    ``,\n    `  Server-only modules cannot be imported from client code.`,\n    `  Add this environment to serverEnvironments if intentional:`,\n    ``,\n    `    ViteEnv({ serverEnvironments: ['ssr', '${fail.envName}'] })`,\n    ``,\n    `  Or change enforcement:`,\n    ``,\n    `    ViteEnv({ onClientAccessOfServerModule: 'stub' })`,\n    ``,\n    `  Imported from: ${importerLine}`,\n  ].join(\"\\n\");\n}\n\n/**\n * Renders a single ANSI-free log entry for vite-env-warnings.log.\n * Uses the same (unknown) convention as formatGuardWarning for missing importers.\n */\nexport function formatGuardLogEntry(fail: GuardFail, timestamp: string): string {\n  const importerLine = fail.importer ?? \"(unknown)\";\n  return [\n    `[${timestamp}] virtual:env/server accessed from \"${fail.envName}\" environment`,\n    `  Importer: ${importerLine}`,\n  ].join(\"\\n\");\n}\n"],"mappings":";AAIA,SAAgB,eAAe,QAAkC;AAC/D,QAAO,OACJ,KAAK,UAAU;AAEd,SAAO,uBADM,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,KAAK,IAAI,GAAG,UAC1B,OAAO,GAAG,CAAC,GAAG,MAAM;GACtD,CACD,KAAK,KAAK;;AAGf,SAAgB,0BAA0B,QAA2C;AACnF,QAAO,OACJ,KAAK,UAAU;AAWd,SAAO,uBATL,MAAM,KAAK,SAAS,IAChB,MAAM,KACH,KAAK,QACJ,OAAO,QAAQ,YAAY,QAAQ,QAAQ,SAAS,MAChD,OAAO,IAAI,IAAI,GACf,OAAO,IAAI,CAChB,CACA,KAAK,IAAI,GACZ,UAC4B,OAAO,GAAG,CAAC,GAAG,MAAM;GACtD,CACD,KAAK,KAAK;;AAGf,MAAM,SAAS;AACf,MAAM,cAAc;AACpB,MAAM,OAAO;AACb,MAAM,QAAQ;AAEd,MAAM,YAAY;AAGlB,MAAM,eAAe,YAAY;;AAGjC,MAAa,mBAAmB,eAAe;;;;;AAM/C,SAAgB,iBAAiB,cAAsB,QAAwB;AAC7E,KAAI,aAAa,UAAU,OAAQ,QAAO;AAC1C,QAAO,SAAS,aAAa,MAAM,EAAE,SAAS,GAAG;;AAGnD,SAAS,SAAiB;AACxB,QAAO,GAAG,OAAO,QAAQ,IAAI,OAAO,YAAY,EAAE,CAAC,QAAQ;;AAG7D,SAAS,YAAoB;AAC3B,QAAO,GAAG,OAAO,QAAQ,IAAI,OAAO,YAAY,EAAE,CAAC,QAAQ;;AAG7D,SAAS,QAAQ,aAAqB,eAAe,aAAqB;AAExE,QAAO,GAAG,OAAO,QAAQ,MAAM,IAAI,eADlB,IAAI,OAAO,KAAK,IAAI,GAAG,eAAe,YAAY,OAAO,CAChB,GAAG,OAAO,QAAQ;;;;;;;;;AAU9E,SAAgB,mBAAmB,MAAyB;CAC1D,MAAM,kBACJ,KAAK,aAAa,KAAA,IAAY,cAAc,iBAAiB,KAAK,UAAA,GAA2B;AAK/F,QAAO;EACL,QAAQ;EACR,QACE,kCACA,GAAG,YAAY,gCAAgC,QAChD;EACD,QAAQ,GAAG;EACX,QAAQ,6CAA6C,KAAK,QAAQ,GAAG;EACrE,QAAQ,yDAAyD;EACjE,QAAQ,GAAG;EACX,QAAQ,0DAAW,oBAAoB,KAAK,uCAAuC,QAAQ;EAC3F,QAAQ,yDAAW,oBAAoB,KAAK,sCAAsC,QAAQ;EAC1F,QAAQ,GAAG;EACX,QAAQ,aAAa,kBAAkB;EACvC,WAAW;EACZ,CAAC,KAAK,KAAK;;;;;;AAOd,SAAgB,gBAAgB,MAAyB;CACvD,MAAM,eAAe,KAAK,YAAY;AACtC,QAAO;EACL,0DAA0D,KAAK,QAAQ;EACvE;EACA;EACA;EACA;EACA,8CAA8C,KAAK,QAAQ;EAC3D;EACA;EACA;EACA;EACA;EACA,oBAAoB;EACrB,CAAC,KAAK,KAAK;;;;;;AAOd,SAAgB,oBAAoB,MAAiB,WAA2B;CAC9E,MAAM,eAAe,KAAK,YAAY;AACtC,QAAO,CACL,IAAI,UAAU,sCAAsC,KAAK,QAAQ,gBACjE,eAAe,eAChB,CAAC,KAAK,KAAK"}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { a as InferServerEnv, i as InferClientEnv, n as EnvDefinition, o as StandardEnvDefinition, r as EnvPreset, t as AnyEnvDefinition } from "./types-B61nsO8q.cjs";
+import { a as InferServerEnv, i as InferClientEnv, n as EnvDefinition, o as StandardEnvDefinition, r as EnvPreset, t as AnyEnvDefinition } from "./types-DudMh278.cjs";
 import { defineEnv } from "./schema.cjs";
 import { defineStandardEnv } from "./standard.cjs";
 export { type AnyEnvDefinition, type EnvDefinition, type EnvPreset, type InferClientEnv, type InferServerEnv, type StandardEnvDefinition, defineEnv, defineStandardEnv };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as InferServerEnv, i as InferClientEnv, n as EnvDefinition, o as StandardEnvDefinition, r as EnvPreset, t as AnyEnvDefinition } from "./types-KniR_Oqf.mjs";
+import { a as InferServerEnv, i as InferClientEnv, n as EnvDefinition, o as StandardEnvDefinition, r as EnvPreset, t as AnyEnvDefinition } from "./types-Ctg8aeXQ.mjs";
 import { defineEnv } from "./schema.mjs";
 import { defineStandardEnv } from "./standard.mjs";
 export { type AnyEnvDefinition, type EnvDefinition, type EnvPreset, type InferClientEnv, type InferServerEnv, type StandardEnvDefinition, defineEnv, defineStandardEnv };

package/dist/leak.cjs

@@ -1,12 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/leak.ts
 /**
-* Scans all client-destined chunks for literal values of server-only vars.
-* Fires in generateBundle() — Rolldown sequential hook, safe.
-*
-* Strategy: for each server-only key, check if its actual runtime value
-* appears as a literal string in any output chunk's source code.
-* Short/common values (< 8 chars) are skipped to avoid false positives.
+* Scans client-destined chunks for server-only var values appearing as quoted
+* string literals. Bare substring matches are ignored — only quoted literals
+* indicate a real bundler-inlined leak. Values < 8 chars are skipped.
 */
 function detectServerLeak(def, data, bundle, onSkipped) {
 	const serverKeys = new Set(Object.keys(def.server ?? {}));
@@ -15,10 +12,14 @@ function detectServerLeak(def, data, bundle, onSkipped) {
 	const serverSecrets = Object.entries(data).filter((entry) => serverKeys.has(entry[0]) && typeof entry[1] === "string" && entry[1].length >= 8);
 	const chunks = Object.entries(bundle).filter(([, chunk]) => chunk.type === "chunk" && !!chunk.code);
 	const leaks = [];
-	for (const [key, value] of serverSecrets) for (const [chunkName, chunk] of chunks) if (chunk.code.includes(value)) leaks.push({
-		key,
-		chunk: chunkName
-	});
+	for (const [key, value] of serverSecrets) {
+		const escaped = value.replace(/[.*+?^${}()|[\]\\]/g, String.raw`\$&`);
+		const pattern = new RegExp(`(["'\`])${escaped}\\1`);
+		for (const [chunkName, chunk] of chunks) if (pattern.test(chunk.code)) leaks.push({
+			key,
+			chunk: chunkName
+		});
+	}
 	return leaks;
 }
 //#endregion

package/dist/leak.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"leak.cjs","names":[],"sources":["../src/leak.ts"],"sourcesContent":["import type { AnyEnvDefinition } from './types'\n\ntype LeakReport = {\n  key: string\n  chunk: string\n}\n\n/**\n * Scans all client-destined chunks for literal values of server-only vars.\n * Fires in generateBundle() — Rolldown sequential hook, safe.\n *\n * Strategy: for each server-only key, check if its actual runtime value\n * appears as a literal string in any output chunk's source code.\n * Short/common values (< 8 chars) are skipped to avoid false positives.\n */\nexport function detectServerLeak(\n  def: AnyEnvDefinition,\n  data: Record<string, unknown>,\n  bundle: Record<string, { type: string, code?: string }>,\n  onSkipped?: (keys: string[]) => void,\n): LeakReport[] {\n  const serverKeys = new Set(Object.keys(def.server ?? {}))\n\n  const shortSecrets = Object.entries(data).filter(\n    (entry): entry is [string, string] =>\n      serverKeys.has(entry[0])\n      && typeof entry[1] === 'string'\n      && entry[1].length < 8,\n  )\n\n  if (shortSecrets.length > 0 && onSkipped) {\n    onSkipped(shortSecrets.map(([k]) => k))\n  }\n\n  const serverSecrets = Object.entries(data).filter(\n    (entry): entry is [string, string] =>\n      serverKeys.has(entry[0])\n      && typeof entry[1] === 'string'\n      && entry[1].length >= 8,\n  )\n\n  const chunks = Object.entries(bundle).filter(\n    ([, chunk]) => chunk.type === 'chunk' && !!chunk.code,\n  )\n\n  const leaks: LeakReport[] = []\n  for (const [key, value] of serverSecrets) {\n    for (const [chunkName, chunk] of chunks) {\n      if (chunk.code!.includes(value)) {\n        leaks.push({ key, chunk: chunkName })\n      }\n    }\n  }\n\n  return leaks\n}\n"],"mappings":";;;;;;;;;;AAeA,SAAgB,iBACd,KACA,MACA,QACA,WACc;CACd,MAAM,aAAa,IAAI,IAAI,OAAO,KAAK,IAAI,UAAU,EAAE,CAAC,CAAC;CAEzD,MAAM,eAAe,OAAO,QAAQ,KAAK,CAAC,QACvC,UACC,WAAW,IAAI,MAAM,GAAG,IACrB,OAAO,MAAM,OAAO,YACpB,MAAM,GAAG,SAAS,EACxB;AAED,KAAI,aAAa,SAAS,KAAK,UAC7B,WAAU,aAAa,KAAK,CAAC,OAAO,EAAE,CAAC;CAGzC,MAAM,gBAAgB,OAAO,QAAQ,KAAK,CAAC,QACxC,UACC,WAAW,IAAI,MAAM,GAAG,IACrB,OAAO,MAAM,OAAO,YACpB,MAAM,GAAG,UAAU,EACzB;CAED,MAAM,SAAS,OAAO,QAAQ,OAAO,CAAC,QACnC,GAAG,WAAW,MAAM,SAAS,WAAW,CAAC,CAAC,MAAM,KAClD;CAED,MAAM,QAAsB,EAAE;AAC9B,MAAK,MAAM,CAAC,KAAK,UAAU,cACzB,MAAK,MAAM,CAAC,WAAW,UAAU,OAC/B,KAAI,MAAM,KAAM,SAAS,MAAM,CAC7B,OAAM,KAAK;EAAE;EAAK,OAAO;EAAW,CAAC;AAK3C,QAAO"}
+{"version":3,"file":"leak.cjs","names":[],"sources":["../src/leak.ts"],"sourcesContent":["import type { AnyEnvDefinition } from \"./types\";\n\ntype LeakReport = {\n  key: string;\n  chunk: string;\n};\n\n/**\n * Scans client-destined chunks for server-only var values appearing as quoted\n * string literals. Bare substring matches are ignored — only quoted literals\n * indicate a real bundler-inlined leak. Values < 8 chars are skipped.\n */\nexport function detectServerLeak(\n  def: AnyEnvDefinition,\n  data: Record<string, unknown>,\n  bundle: Record<string, { type: string; code?: string }>,\n  onSkipped?: (keys: string[]) => void,\n): LeakReport[] {\n  const serverKeys = new Set(Object.keys(def.server ?? {}));\n\n  const shortSecrets = Object.entries(data).filter(\n    (entry): entry is [string, string] =>\n      serverKeys.has(entry[0]) && typeof entry[1] === \"string\" && entry[1].length < 8,\n  );\n\n  if (shortSecrets.length > 0 && onSkipped) {\n    onSkipped(shortSecrets.map(([k]) => k));\n  }\n\n  const serverSecrets = Object.entries(data).filter(\n    (entry): entry is [string, string] =>\n      serverKeys.has(entry[0]) && typeof entry[1] === \"string\" && entry[1].length >= 8,\n  );\n\n  const chunks = Object.entries(bundle).filter(\n    ([, chunk]) => chunk.type === \"chunk\" && !!chunk.code,\n  );\n\n  const leaks: LeakReport[] = [];\n  for (const [key, value] of serverSecrets) {\n    const escaped = value.replace(/[.*+?^${}()|[\\]\\\\]/g, String.raw`\\$&`);\n    const pattern = new RegExp(`([\"'\\`])${escaped}\\\\1`);\n    for (const [chunkName, chunk] of chunks) {\n      if (pattern.test(chunk.code!)) {\n        leaks.push({ key, chunk: chunkName });\n      }\n    }\n  }\n\n  return leaks;\n}\n"],"mappings":";;;;;;;AAYA,SAAgB,iBACd,KACA,MACA,QACA,WACc;CACd,MAAM,aAAa,IAAI,IAAI,OAAO,KAAK,IAAI,UAAU,EAAE,CAAC,CAAC;CAEzD,MAAM,eAAe,OAAO,QAAQ,KAAK,CAAC,QACvC,UACC,WAAW,IAAI,MAAM,GAAG,IAAI,OAAO,MAAM,OAAO,YAAY,MAAM,GAAG,SAAS,EACjF;AAED,KAAI,aAAa,SAAS,KAAK,UAC7B,WAAU,aAAa,KAAK,CAAC,OAAO,EAAE,CAAC;CAGzC,MAAM,gBAAgB,OAAO,QAAQ,KAAK,CAAC,QACxC,UACC,WAAW,IAAI,MAAM,GAAG,IAAI,OAAO,MAAM,OAAO,YAAY,MAAM,GAAG,UAAU,EAClF;CAED,MAAM,SAAS,OAAO,QAAQ,OAAO,CAAC,QACnC,GAAG,WAAW,MAAM,SAAS,WAAW,CAAC,CAAC,MAAM,KAClD;CAED,MAAM,QAAsB,EAAE;AAC9B,MAAK,MAAM,CAAC,KAAK,UAAU,eAAe;EACxC,MAAM,UAAU,MAAM,QAAQ,uBAAuB,OAAO,GAAG,MAAM;EACrE,MAAM,UAAU,IAAI,OAAO,WAAW,QAAQ,KAAK;AACnD,OAAK,MAAM,CAAC,WAAW,UAAU,OAC/B,KAAI,QAAQ,KAAK,MAAM,KAAM,CAC3B,OAAM,KAAK;GAAE;GAAK,OAAO;GAAW,CAAC;;AAK3C,QAAO"}

package/dist/leak.d.cts

@@ -1,4 +1,4 @@
-import { t as AnyEnvDefinition } from "./types-B61nsO8q.cjs";
+import { t as AnyEnvDefinition } from "./types-DudMh278.cjs";
 
 //#region src/leak.d.ts
 type LeakReport = {
@@ -6,12 +6,9 @@ type LeakReport = {
   chunk: string;
 };
 /**
- * Scans all client-destined chunks for literal values of server-only vars.
- * Fires in generateBundle() — Rolldown sequential hook, safe.
- *
- * Strategy: for each server-only key, check if its actual runtime value
- * appears as a literal string in any output chunk's source code.
- * Short/common values (< 8 chars) are skipped to avoid false positives.
+ * Scans client-destined chunks for server-only var values appearing as quoted
+ * string literals. Bare substring matches are ignored — only quoted literals
+ * indicate a real bundler-inlined leak. Values < 8 chars are skipped.
  */
 declare function detectServerLeak(def: AnyEnvDefinition, data: Record<string, unknown>, bundle: Record<string, {
   type: string;

package/dist/leak.d.mts

@@ -1,4 +1,4 @@
-import { t as AnyEnvDefinition } from "./types-KniR_Oqf.mjs";
+import { t as AnyEnvDefinition } from "./types-Ctg8aeXQ.mjs";
 
 //#region src/leak.d.ts
 type LeakReport = {
@@ -6,12 +6,9 @@ type LeakReport = {
   chunk: string;
 };
 /**
- * Scans all client-destined chunks for literal values of server-only vars.
- * Fires in generateBundle() — Rolldown sequential hook, safe.
- *
- * Strategy: for each server-only key, check if its actual runtime value
- * appears as a literal string in any output chunk's source code.
- * Short/common values (< 8 chars) are skipped to avoid false positives.
+ * Scans client-destined chunks for server-only var values appearing as quoted
+ * string literals. Bare substring matches are ignored — only quoted literals
+ * indicate a real bundler-inlined leak. Values < 8 chars are skipped.
  */
 declare function detectServerLeak(def: AnyEnvDefinition, data: Record<string, unknown>, bundle: Record<string, {
   type: string;

package/dist/leak.mjs

@@ -1,11 +1,8 @@
 //#region src/leak.ts
 /**
-* Scans all client-destined chunks for literal values of server-only vars.
-* Fires in generateBundle() — Rolldown sequential hook, safe.
-*
-* Strategy: for each server-only key, check if its actual runtime value
-* appears as a literal string in any output chunk's source code.
-* Short/common values (< 8 chars) are skipped to avoid false positives.
+* Scans client-destined chunks for server-only var values appearing as quoted
+* string literals. Bare substring matches are ignored — only quoted literals
+* indicate a real bundler-inlined leak. Values < 8 chars are skipped.
 */
 function detectServerLeak(def, data, bundle, onSkipped) {
 	const serverKeys = new Set(Object.keys(def.server ?? {}));
@@ -14,10 +11,14 @@ function detectServerLeak(def, data, bundle, onSkipped) {
 	const serverSecrets = Object.entries(data).filter((entry) => serverKeys.has(entry[0]) && typeof entry[1] === "string" && entry[1].length >= 8);
 	const chunks = Object.entries(bundle).filter(([, chunk]) => chunk.type === "chunk" && !!chunk.code);
 	const leaks = [];
-	for (const [key, value] of serverSecrets) for (const [chunkName, chunk] of chunks) if (chunk.code.includes(value)) leaks.push({
-		key,
-		chunk: chunkName
-	});
+	for (const [key, value] of serverSecrets) {
+		const escaped = value.replace(/[.*+?^${}()|[\]\\]/g, String.raw`\$&`);
+		const pattern = new RegExp(`(["'\`])${escaped}\\1`);
+		for (const [chunkName, chunk] of chunks) if (pattern.test(chunk.code)) leaks.push({
+			key,
+			chunk: chunkName
+		});
+	}
 	return leaks;
 }
 //#endregion