@vite-env/core 0.2.2 → 0.4.0

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
 - Auto-coercion via Zod v4 (`z.stringbool()`, `z.coerce.number()`)
+- Standard Schema support — use Valibot, ArkType, or any compliant validator
 - Auto `.d.ts` generation
 - Vite 8 / Rolldown native
 
@@ -21,7 +22,8 @@ pnpm add @vite-env/core zod
 **1. Define your schema** — `env.ts`
 
 ```ts
-import { defineEnv, z } from '@vite-env/core'
+import { defineEnv } from '@vite-env/core'
+import { z } from 'zod'
 
 export default defineEnv({
   server: {

package/dist/config.cjs

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

package/dist/config.d.cts

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

package/dist/config.d.mts

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

package/dist/dts-BgHTl6hC.cjs

@@ -0,0 +1,114 @@
+//#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 node_path = require("node:path");
+node_path = __toESM(node_path);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = __toESM(node_fs_promises);
+//#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");
+	await writeDts(root, zodShapeToTsFields(z, { ...def.client }), zodShapeToTsFields(z, {
+		...def.server,
+		...def.client
+	}));
+}
+/**
+* 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)");
+}
+async function writeDts(root, clientFields, serverFields, tag = "") {
+	const dts = `${tag ? `// Auto-generated by @vite-env/core ${tag}\n// Do not edit manually — re-generated on every dev server start and build\n// Tip: for richer types, use defineEnv() with Zod instead of defineStandardEnv()` : `// Auto-generated by @vite-env/core\n// Do not edit manually — re-generated on every dev server start and build`}
+
+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) {
+	return Object.entries(shape).map(([key, schema]) => {
+		const tsType = zodToTs(z, schema);
+		return `    readonly ${key}${schema instanceof z.ZodOptional ? "?" : ""}: ${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
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});
+Object.defineProperty(exports, "generateDts", {
+	enumerable: true,
+	get: function() {
+		return generateDts;
+	}
+});
+Object.defineProperty(exports, "generateStandardDts", {
+	enumerable: true,
+	get: function() {
+		return generateStandardDts;
+	}
+});
+
+//# sourceMappingURL=dts-BgHTl6hC.cjs.map

package/dist/dts-BgHTl6hC.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dts-BgHTl6hC.cjs","names":["path","fs"],"sources":["../src/dts.ts"],"sourcesContent":["// @env node\nimport type { EnvDefinition, StandardEnvDefinition } from './types'\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 clientFields = zodShapeToTsFields(z, { ...def.client })\n  const serverFields = zodShapeToTsFields(z, { ...def.server, ...def.client })\n\n  await writeDts(root, clientFields, serverFields)\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\nasync function writeDts(\n  root: string,\n  clientFields: string,\n  serverFields: string,\n  tag = '',\n): Promise<void> {\n  const header = tag\n    ? `// Auto-generated by @vite-env/core ${tag}\\n// Do not edit manually — re-generated on every dev server start and build\\n// Tip: for richer types, use defineEnv() with Zod instead of defineStandardEnv()`\n    : `// Auto-generated by @vite-env/core\\n// Do not edit manually — re-generated on every dev server start and build`\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: any, shape: Record<string, unknown>): string {\n  return Object.entries(shape)\n    .map(([key, schema]) => {\n      const tsType = zodToTs(z, schema)\n      const optional = schema instanceof z.ZodOptional\n      return `    readonly ${key}${optional ? '?' : ''}: ${tsType}`\n    })\n    .join('\\n')\n}\n\nfunction zodToTs(z: any, schema: any): 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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,eAAsB,YACpB,KACA,MACe;CACf,MAAM,EAAE,MAAM,MAAM,OAAO;AAK3B,OAAM,SAAS,MAHM,mBAAmB,GAAG,EAAE,GAAG,IAAI,QAAQ,CAAC,EACxC,mBAAmB,GAAG;EAAE,GAAG,IAAI;EAAQ,GAAG,IAAI;EAAQ,CAAC,CAE5B;;;;;;AAOlD,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,WAAW,EAC1B,eAAe,WAAW,EAEE,oBAAoB;;AAGvE,eAAe,SACb,MACA,cACA,cACA,MAAM,IACS;CAKf,MAAM,MAAM,GAJG,MACX,uCAAuC,IAAI,mKAC3C,kHAEkB;;;;EAItB,aAAa;;;;;;;;EAQb,aAAa;;;;;;CAOb,MAAM,WAAWA,UAAAA,QAAK,KAAK,MAAM,gBAAgB;AACjD,KAAI;AACF,QAAMC,iBAAAA,QAAG,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,GAAQ,OAAwC;AAC1E,QAAO,OAAO,QAAQ,MAAM,CACzB,KAAK,CAAC,KAAK,YAAY;EACtB,MAAM,SAAS,QAAQ,GAAG,OAAO;AAEjC,SAAO,gBAAgB,MADN,kBAAkB,EAAE,cACG,MAAM,GAAG,IAAI;GACrD,CACD,KAAK,KAAK;;AAGf,SAAS,QAAQ,GAAQ,QAAqB;AAC5C,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"}

package/dist/dts.cjs

@@ -1,3 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dts = require("./dts-DF71HNdJ.cjs");
+const require_dts = require("./dts-BgHTl6hC.cjs");
 exports.generateDts = require_dts.generateDts;
+exports.generateStandardDts = require_dts.generateStandardDts;

package/dist/dts.d.cts

@@ -1,12 +1,17 @@
-import { t as EnvDefinition } from "./types-DqTMuWwc.cjs";
+import { a as StandardEnvDefinition, n as EnvDefinition } from "./types-1okexcwM.cjs";
 
 //#region src/dts.d.ts
 /**
- * Writes vite-env.d.ts to project root.
- * Declares virtual:env/client and virtual:env/server module types.
- * Users never need to manually augment ImportMetaEnv again.
+ * 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.
  */
 declare function generateDts(def: EnvDefinition, root: string): Promise<void>;
+/**
+ * Writes vite-env.d.ts for Standard Schema definitions.
+ * All fields are typed as `string` — Standard Schema has no runtime type introspection.
+ */
+declare function generateStandardDts(def: StandardEnvDefinition, root: string): Promise<void>;
 //#endregion
-export { generateDts };
+export { generateDts, generateStandardDts };
 //# sourceMappingURL=dts.d.cts.map

package/dist/dts.d.mts

@@ -1,12 +1,17 @@
-import { t as EnvDefinition } from "./types-CluiDKAQ.mjs";
+import { a as StandardEnvDefinition, n as EnvDefinition } from "./types-DuWT_251.mjs";
 
 //#region src/dts.d.ts
 /**
- * Writes vite-env.d.ts to project root.
- * Declares virtual:env/client and virtual:env/server module types.
- * Users never need to manually augment ImportMetaEnv again.
+ * 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.
  */
 declare function generateDts(def: EnvDefinition, root: string): Promise<void>;
+/**
+ * Writes vite-env.d.ts for Standard Schema definitions.
+ * All fields are typed as `string` — Standard Schema has no runtime type introspection.
+ */
+declare function generateStandardDts(def: StandardEnvDefinition, root: string): Promise<void>;
 //#endregion
-export { generateDts };
+export { generateDts, generateStandardDts };
 //# sourceMappingURL=dts.d.mts.map

package/dist/dts.mjs

@@ -1,24 +1,33 @@
-import { z } from "zod";
 import path from "node:path";
 import fs from "node:fs/promises";
 //#region src/dts.ts
 /**
-* Writes vite-env.d.ts to project root.
-* Declares virtual:env/client and virtual:env/server module types.
-* Users never need to manually augment ImportMetaEnv again.
+* 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 clientKeys = { ...def.client };
-	const serverKeys = {
+	const { z } = await import("zod");
+	await writeDts(root, zodShapeToTsFields(z, { ...def.client }), zodShapeToTsFields(z, {
 		...def.server,
 		...def.client
-	};
-	const dts = `// Auto-generated by @vite-env/core
-// Do not edit manually — re-generated on every dev server start and build
+	}));
+}
+/**
+* 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)");
+}
+async function writeDts(root, clientFields, serverFields, tag = "") {
+	const dts = `${tag ? `// Auto-generated by @vite-env/core ${tag}\n// Do not edit manually — re-generated on every dev server start and build\n// Tip: for richer types, use defineEnv() with Zod instead of defineStandardEnv()` : `// Auto-generated by @vite-env/core\n// Do not edit manually — re-generated on every dev server start and build`}
 
 declare module 'virtual:env/client' {
   const env: {
-${zodShapeToTsFields(clientKeys)}
+${clientFields}
   }
   export { env }
   export default env
@@ -26,7 +35,7 @@ ${zodShapeToTsFields(clientKeys)}
 
 declare module 'virtual:env/server' {
   const env: {
-${zodShapeToTsFields(serverKeys)}
+${serverFields}
   }
   export { env }
   export default env
@@ -39,27 +48,26 @@ ${zodShapeToTsFields(serverKeys)}
 		throw new Error(`[vite-env] Failed to write vite-env.d.ts to ${root}. Check file permissions.`, { cause: e });
 	}
 }
-function zodShapeToTsFields(shape) {
+function keysToTsFields(keys) {
+	return keys.map((key) => `    readonly ${key}: string`).join("\n");
+}
+function zodShapeToTsFields(z, shape) {
 	return Object.entries(shape).map(([key, schema]) => {
-		const s = schema;
-		const tsType = zodToTs(s);
-		return `    readonly ${key}${isOptional(s) ? "?" : ""}: ${tsType}`;
+		const tsType = zodToTs(z, schema);
+		return `    readonly ${key}${schema instanceof z.ZodOptional ? "?" : ""}: ${tsType}`;
 	}).join("\n");
 }
-function zodToTs(schema) {
-	if (schema instanceof z.ZodOptional) return zodToTs(schema.unwrap());
-	if (schema instanceof z.ZodDefault) return zodToTs(schema.def.innerType);
+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(schema.def.out);
+	if (schema instanceof z.ZodPipe) return zodToTs(z, schema.def.out);
 	return "string";
 }
-function isOptional(schema) {
-	return schema instanceof z.ZodOptional;
-}
 //#endregion
-export { generateDts };
+export { generateDts, generateStandardDts };
 
 //# sourceMappingURL=dts.mjs.map

package/dist/dts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dts.mjs","names":[],"sources":["../src/dts.ts"],"sourcesContent":["// @env node\nimport type { EnvDefinition } from './types'\nimport fs from 'node:fs/promises'\nimport path from 'node:path'\nimport { z } from 'zod'\n\n/**\n * Writes vite-env.d.ts to project root.\n * Declares virtual:env/client and virtual:env/server module types.\n * Users never need to manually augment ImportMetaEnv again.\n */\nexport async function generateDts(\n  def: EnvDefinition,\n  root: string,\n): Promise<void> {\n  const clientKeys = {\n    ...def.client,\n  }\n  const serverKeys = {\n    ...def.server,\n    ...def.client,\n  }\n\n  const clientFields = zodShapeToTsFields(clientKeys)\n  const serverFields = zodShapeToTsFields(serverKeys)\n\n  const dts = `// Auto-generated by @vite-env/core\n// Do not edit manually — re-generated on every dev server start and build\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 zodShapeToTsFields(shape: z.ZodRawShape): string {\n  return Object.entries(shape)\n    .map(([key, schema]) => {\n      // Zod v4: ZodRawShape values are $ZodType, cast to ZodTypeAny for instanceof checks\n      const s = schema as z.ZodTypeAny\n      const tsType = zodToTs(s)\n      const optional = isOptional(s)\n      return `    readonly ${key}${optional ? '?' : ''}: ${tsType}`\n    })\n    .join('\\n')\n}\n\nfunction zodToTs(schema: z.ZodTypeAny): string {\n  if (schema instanceof z.ZodOptional)\n    return zodToTs(schema.unwrap() as unknown as z.ZodTypeAny)\n  if (schema instanceof z.ZodDefault)\n    return zodToTs(schema.def.innerType as unknown as z.ZodTypeAny)\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(schema.def.out as unknown as z.ZodTypeAny)\n  return 'string'\n}\n\nfunction isOptional(schema: z.ZodTypeAny): boolean {\n  return schema instanceof z.ZodOptional\n}\n"],"mappings":";;;;;;;;;AAWA,eAAsB,YACpB,KACA,MACe;CACf,MAAM,aAAa,EACjB,GAAG,IAAI,QACR;CACD,MAAM,aAAa;EACjB,GAAG,IAAI;EACP,GAAG,IAAI;EACR;CAKD,MAAM,MAAM;;;;;EAHS,mBAAmB,WAAW,CAQtC;;;;;;;;EAPQ,mBAAmB,WAAW,CAetC;;;;;;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,mBAAmB,OAA8B;AACxD,QAAO,OAAO,QAAQ,MAAM,CACzB,KAAK,CAAC,KAAK,YAAY;EAEtB,MAAM,IAAI;EACV,MAAM,SAAS,QAAQ,EAAE;AAEzB,SAAO,gBAAgB,MADN,WAAW,EAAE,GACU,MAAM,GAAG,IAAI;GACrD,CACD,KAAK,KAAK;;AAGf,SAAS,QAAQ,QAA8B;AAC7C,KAAI,kBAAkB,EAAE,YACtB,QAAO,QAAQ,OAAO,QAAQ,CAA4B;AAC5D,KAAI,kBAAkB,EAAE,WACtB,QAAO,QAAQ,OAAO,IAAI,UAAqC;AACjE,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,OAAO,IAAI,IAA+B;AAC3D,QAAO;;AAGT,SAAS,WAAW,QAA+B;AACjD,QAAO,kBAAkB,EAAE"}
+{"version":3,"file":"dts.mjs","names":[],"sources":["../src/dts.ts"],"sourcesContent":["// @env node\nimport type { EnvDefinition, StandardEnvDefinition } from './types'\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 clientFields = zodShapeToTsFields(z, { ...def.client })\n  const serverFields = zodShapeToTsFields(z, { ...def.server, ...def.client })\n\n  await writeDts(root, clientFields, serverFields)\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\nasync function writeDts(\n  root: string,\n  clientFields: string,\n  serverFields: string,\n  tag = '',\n): Promise<void> {\n  const header = tag\n    ? `// Auto-generated by @vite-env/core ${tag}\\n// Do not edit manually — re-generated on every dev server start and build\\n// Tip: for richer types, use defineEnv() with Zod instead of defineStandardEnv()`\n    : `// Auto-generated by @vite-env/core\\n// Do not edit manually — re-generated on every dev server start and build`\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: any, shape: Record<string, unknown>): string {\n  return Object.entries(shape)\n    .map(([key, schema]) => {\n      const tsType = zodToTs(z, schema)\n      const optional = schema instanceof z.ZodOptional\n      return `    readonly ${key}${optional ? '?' : ''}: ${tsType}`\n    })\n    .join('\\n')\n}\n\nfunction zodToTs(z: any, schema: any): 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":";;;;;;;;AAUA,eAAsB,YACpB,KACA,MACe;CACf,MAAM,EAAE,MAAM,MAAM,OAAO;AAK3B,OAAM,SAAS,MAHM,mBAAmB,GAAG,EAAE,GAAG,IAAI,QAAQ,CAAC,EACxC,mBAAmB,GAAG;EAAE,GAAG,IAAI;EAAQ,GAAG,IAAI;EAAQ,CAAC,CAE5B;;;;;;AAOlD,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,WAAW,EAC1B,eAAe,WAAW,EAEE,oBAAoB;;AAGvE,eAAe,SACb,MACA,cACA,cACA,MAAM,IACS;CAKf,MAAM,MAAM,GAJG,MACX,uCAAuC,IAAI,mKAC3C,kHAEkB;;;;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,GAAQ,OAAwC;AAC1E,QAAO,OAAO,QAAQ,MAAM,CACzB,KAAK,CAAC,KAAK,YAAY;EACtB,MAAM,SAAS,QAAQ,GAAG,OAAO;AAEjC,SAAO,gBAAgB,MADN,kBAAkB,EAAE,cACG,MAAM,GAAG,IAAI;GACrD,CACD,KAAK,KAAK;;AAGf,SAAS,QAAQ,GAAQ,QAAqB;AAC5C,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"}

package/dist/format.cjs

@@ -5,7 +5,95 @@ function formatZodError(issues) {
 		return `  \x1B[31m✗\x1B[0m ${(issue.path.length > 0 ? issue.path.join(".") : "(root)").padEnd(28)} ${issue.message}`;
 	}).join("\n");
 }
+function formatStandardSchemaError(issues) {
+	return issues.map((issue) => {
+		return `  \x1B[31m✗\x1B[0m ${(issue.path.length > 0 ? issue.path.map((seg) => typeof seg === "object" && seg !== null && "key" in seg ? String(seg.key) : String(seg)).join(".") : "(root)").padEnd(28)} ${issue.message}`;
+	}).join("\n");
+}
+const YELLOW = "\x1B[33m";
+const BOLD_YELLOW = "\x1B[1;33m";
+const CYAN = "\x1B[36m";
+const RESET = "\x1B[0m";
+const BOX_WIDTH = 66;
+const CONTENT_AREA = BOX_WIDTH - 4;
+/** Maximum visible character length for an importer path inside the warning box. */
+const IMPORTER_MAX_LEN = CONTENT_AREA - 10;
+/**
+* Truncates an importer path to fit within maxLen visible characters.
+* Adds a leading '…' when truncation occurs so the rightmost (most specific) part is preserved.
+*/
+function truncateImporter(importerPath, maxLen) {
+	if (importerPath.length <= maxLen) return importerPath;
+	return `\u2026${importerPath.slice(-(maxLen - 1))}`;
+}
+function boxTop() {
+	return `${YELLOW}\u250C${"─".repeat(BOX_WIDTH - 2)}\u2510${RESET}`;
+}
+function boxBottom() {
+	return `${YELLOW}\u2514${"─".repeat(BOX_WIDTH - 2)}\u2518${RESET}`;
+}
+function boxLine(visibleText, renderedText = visibleText) {
+	return `${YELLOW}\u2502${RESET}  ${renderedText}${" ".repeat(Math.max(0, CONTENT_AREA - visibleText.length))}${YELLOW}\u2502${RESET}`;
+}
+/**
+* Renders the colored terminal warning box for 'warn' mode.
+* Every line is exactly 66 characters wide (visible chars, excluding ANSI codes),
+* assuming Vite environment names are short (≤19 chars). Longer names will extend
+* the line beyond 66 chars without crashing — Math.max(0) prevents negative padding.
+* Use in logger.warn() calls — not in log files.
+*/
+function formatGuardWarning(fail) {
+	const importerDisplay = fail.importer === void 0 ? "(unknown)" : truncateImporter(fail.importer, 52);
+	return [
+		boxTop(),
+		boxLine("[vite-env] DEPRECATION WARNING", `${BOLD_YELLOW}[vite-env] DEPRECATION WARNING${RESET}`),
+		boxLine(""),
+		boxLine(`virtual:env/server was imported from the "${fail.envName}"`),
+		boxLine("environment. This will be a hard build error in 1.0.0."),
+		boxLine(""),
+		boxLine("To enforce now:  onClientAccessOfServerModule: 'error'", `To enforce now:  ${CYAN}onClientAccessOfServerModule: 'error'${RESET}`),
+		boxLine("To silence:      onClientAccessOfServerModule: 'stub'", `To silence:      ${CYAN}onClientAccessOfServerModule: 'stub'${RESET}`),
+		boxLine(""),
+		boxLine(`Found in: ${importerDisplay}`),
+		boxBottom()
+	].join("\n");
+}
+/**
+* Renders the plain-text hard error message thrown in 'error' mode.
+* No ANSI — thrown as an Error message, not printed via logger.
+*/
+function formatHardError(fail) {
+	const importerLine = fail.importer ?? "(unknown)";
+	return [
+		`[vite-env] virtual:env/server is not available in the "${fail.envName}" environment.`,
+		``,
+		`  Server-only modules cannot be imported from client code.`,
+		`  Add this environment to serverEnvironments if intentional:`,
+		``,
+		`    ViteEnv({ serverEnvironments: ['ssr', '${fail.envName}'] })`,
+		``,
+		`  Or change enforcement:`,
+		``,
+		`    ViteEnv({ onClientAccessOfServerModule: 'stub' })`,
+		``,
+		`  Imported from: ${importerLine}`
+	].join("\n");
+}
+/**
+* Renders a single ANSI-free log entry for vite-env-warnings.log.
+* Uses the same (unknown) convention as formatGuardWarning for missing importers.
+*/
+function formatGuardLogEntry(fail, timestamp) {
+	const importerLine = fail.importer ?? "(unknown)";
+	return [`[${timestamp}] virtual:env/server accessed from "${fail.envName}" environment`, `  Importer: ${importerLine}`].join("\n");
+}
 //#endregion
+exports.IMPORTER_MAX_LEN = IMPORTER_MAX_LEN;
+exports.formatGuardLogEntry = formatGuardLogEntry;
+exports.formatGuardWarning = formatGuardWarning;
+exports.formatHardError = formatHardError;
+exports.formatStandardSchemaError = formatStandardSchemaError;
 exports.formatZodError = formatZodError;
+exports.truncateImporter = truncateImporter;
 
 //# sourceMappingURL=format.cjs.map

package/dist/format.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"format.cjs","names":[],"sources":["../src/format.ts"],"sourcesContent":["import type { core } from 'zod'\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"],"mappings":";;AAEA,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"}
+{"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,CAAC,GACd,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,QAbgB,0DAaG,oBAAoB,KAAK,uCAAuC,QAAQ;EAC3F,QAbgB,yDAaG,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,7 +1,48 @@
+import { o as StandardValidationIssue } from "./types-1okexcwM.cjs";
 import { core } from "zod";
 
+//#region src/guard.d.ts
+type GuardMode = 'error' | 'stub' | 'warn';
+type GuardResult = {
+  allowed: true;
+} | {
+  allowed: false;
+  mode: GuardMode;
+  envName: string;
+  importer: string | undefined;
+};
+type GuardFail = Extract<GuardResult, {
+  allowed: false;
+}>;
+//#endregion
 //#region src/format.d.ts
 declare function formatZodError(issues: core.$ZodIssue[]): string;
+declare function formatStandardSchemaError(issues: StandardValidationIssue[]): string;
+/** Maximum visible character length for an importer path inside the warning box. */
+declare const IMPORTER_MAX_LEN: number;
+/**
+ * Truncates an importer path to fit within maxLen visible characters.
+ * Adds a leading '…' when truncation occurs so the rightmost (most specific) part is preserved.
+ */
+declare function truncateImporter(importerPath: string, maxLen: number): string;
+/**
+ * Renders the colored terminal warning box for 'warn' mode.
+ * Every line is exactly 66 characters wide (visible chars, excluding ANSI codes),
+ * assuming Vite environment names are short (≤19 chars). Longer names will extend
+ * the line beyond 66 chars without crashing — Math.max(0) prevents negative padding.
+ * Use in logger.warn() calls — not in log files.
+ */
+declare function formatGuardWarning(fail: GuardFail): string;
+/**
+ * Renders the plain-text hard error message thrown in 'error' mode.
+ * No ANSI — thrown as an Error message, not printed via logger.
+ */
+declare function formatHardError(fail: GuardFail): string;
+/**
+ * Renders a single ANSI-free log entry for vite-env-warnings.log.
+ * Uses the same (unknown) convention as formatGuardWarning for missing importers.
+ */
+declare function formatGuardLogEntry(fail: GuardFail, timestamp: string): string;
 //#endregion
-export { formatZodError };
+export { IMPORTER_MAX_LEN, formatGuardLogEntry, formatGuardWarning, formatHardError, formatStandardSchemaError, formatZodError, truncateImporter };
 //# sourceMappingURL=format.d.cts.map

package/dist/format.d.mts

@@ -1,7 +1,48 @@
+import { o as StandardValidationIssue } from "./types-DuWT_251.mjs";
 import { core } from "zod";
 
+//#region src/guard.d.ts
+type GuardMode = 'error' | 'stub' | 'warn';
+type GuardResult = {
+  allowed: true;
+} | {
+  allowed: false;
+  mode: GuardMode;
+  envName: string;
+  importer: string | undefined;
+};
+type GuardFail = Extract<GuardResult, {
+  allowed: false;
+}>;
+//#endregion
 //#region src/format.d.ts
 declare function formatZodError(issues: core.$ZodIssue[]): string;
+declare function formatStandardSchemaError(issues: StandardValidationIssue[]): string;
+/** Maximum visible character length for an importer path inside the warning box. */
+declare const IMPORTER_MAX_LEN: number;
+/**
+ * Truncates an importer path to fit within maxLen visible characters.
+ * Adds a leading '…' when truncation occurs so the rightmost (most specific) part is preserved.
+ */
+declare function truncateImporter(importerPath: string, maxLen: number): string;
+/**
+ * Renders the colored terminal warning box for 'warn' mode.
+ * Every line is exactly 66 characters wide (visible chars, excluding ANSI codes),
+ * assuming Vite environment names are short (≤19 chars). Longer names will extend
+ * the line beyond 66 chars without crashing — Math.max(0) prevents negative padding.
+ * Use in logger.warn() calls — not in log files.
+ */
+declare function formatGuardWarning(fail: GuardFail): string;
+/**
+ * Renders the plain-text hard error message thrown in 'error' mode.
+ * No ANSI — thrown as an Error message, not printed via logger.
+ */
+declare function formatHardError(fail: GuardFail): string;
+/**
+ * Renders a single ANSI-free log entry for vite-env-warnings.log.
+ * Uses the same (unknown) convention as formatGuardWarning for missing importers.
+ */
+declare function formatGuardLogEntry(fail: GuardFail, timestamp: string): string;
 //#endregion
-export { formatZodError };
+export { IMPORTER_MAX_LEN, formatGuardLogEntry, formatGuardWarning, formatHardError, formatStandardSchemaError, formatZodError, truncateImporter };
 //# sourceMappingURL=format.d.mts.map

package/dist/format.mjs

@@ -4,7 +4,89 @@ function formatZodError(issues) {
 		return `  \x1B[31m✗\x1B[0m ${(issue.path.length > 0 ? issue.path.join(".") : "(root)").padEnd(28)} ${issue.message}`;
 	}).join("\n");
 }
+function formatStandardSchemaError(issues) {
+	return issues.map((issue) => {
+		return `  \x1B[31m✗\x1B[0m ${(issue.path.length > 0 ? issue.path.map((seg) => typeof seg === "object" && seg !== null && "key" in seg ? String(seg.key) : String(seg)).join(".") : "(root)").padEnd(28)} ${issue.message}`;
+	}).join("\n");
+}
+const YELLOW = "\x1B[33m";
+const BOLD_YELLOW = "\x1B[1;33m";
+const CYAN = "\x1B[36m";
+const RESET = "\x1B[0m";
+const BOX_WIDTH = 66;
+const CONTENT_AREA = BOX_WIDTH - 4;
+/** Maximum visible character length for an importer path inside the warning box. */
+const IMPORTER_MAX_LEN = CONTENT_AREA - 10;
+/**
+* Truncates an importer path to fit within maxLen visible characters.
+* Adds a leading '…' when truncation occurs so the rightmost (most specific) part is preserved.
+*/
+function truncateImporter(importerPath, maxLen) {
+	if (importerPath.length <= maxLen) return importerPath;
+	return `\u2026${importerPath.slice(-(maxLen - 1))}`;
+}
+function boxTop() {
+	return `${YELLOW}\u250C${"─".repeat(BOX_WIDTH - 2)}\u2510${RESET}`;
+}
+function boxBottom() {
+	return `${YELLOW}\u2514${"─".repeat(BOX_WIDTH - 2)}\u2518${RESET}`;
+}
+function boxLine(visibleText, renderedText = visibleText) {
+	return `${YELLOW}\u2502${RESET}  ${renderedText}${" ".repeat(Math.max(0, CONTENT_AREA - visibleText.length))}${YELLOW}\u2502${RESET}`;
+}
+/**
+* Renders the colored terminal warning box for 'warn' mode.
+* Every line is exactly 66 characters wide (visible chars, excluding ANSI codes),
+* assuming Vite environment names are short (≤19 chars). Longer names will extend
+* the line beyond 66 chars without crashing — Math.max(0) prevents negative padding.
+* Use in logger.warn() calls — not in log files.
+*/
+function formatGuardWarning(fail) {
+	const importerDisplay = fail.importer === void 0 ? "(unknown)" : truncateImporter(fail.importer, 52);
+	return [
+		boxTop(),
+		boxLine("[vite-env] DEPRECATION WARNING", `${BOLD_YELLOW}[vite-env] DEPRECATION WARNING${RESET}`),
+		boxLine(""),
+		boxLine(`virtual:env/server was imported from the "${fail.envName}"`),
+		boxLine("environment. This will be a hard build error in 1.0.0."),
+		boxLine(""),
+		boxLine("To enforce now:  onClientAccessOfServerModule: 'error'", `To enforce now:  ${CYAN}onClientAccessOfServerModule: 'error'${RESET}`),
+		boxLine("To silence:      onClientAccessOfServerModule: 'stub'", `To silence:      ${CYAN}onClientAccessOfServerModule: 'stub'${RESET}`),
+		boxLine(""),
+		boxLine(`Found in: ${importerDisplay}`),
+		boxBottom()
+	].join("\n");
+}
+/**
+* Renders the plain-text hard error message thrown in 'error' mode.
+* No ANSI — thrown as an Error message, not printed via logger.
+*/
+function formatHardError(fail) {
+	const importerLine = fail.importer ?? "(unknown)";
+	return [
+		`[vite-env] virtual:env/server is not available in the "${fail.envName}" environment.`,
+		``,
+		`  Server-only modules cannot be imported from client code.`,
+		`  Add this environment to serverEnvironments if intentional:`,
+		``,
+		`    ViteEnv({ serverEnvironments: ['ssr', '${fail.envName}'] })`,
+		``,
+		`  Or change enforcement:`,
+		``,
+		`    ViteEnv({ onClientAccessOfServerModule: 'stub' })`,
+		``,
+		`  Imported from: ${importerLine}`
+	].join("\n");
+}
+/**
+* Renders a single ANSI-free log entry for vite-env-warnings.log.
+* Uses the same (unknown) convention as formatGuardWarning for missing importers.
+*/
+function formatGuardLogEntry(fail, timestamp) {
+	const importerLine = fail.importer ?? "(unknown)";
+	return [`[${timestamp}] virtual:env/server accessed from "${fail.envName}" environment`, `  Importer: ${importerLine}`].join("\n");
+}
 //#endregion
-export { formatZodError };
+export { IMPORTER_MAX_LEN, formatGuardLogEntry, formatGuardWarning, formatHardError, formatStandardSchemaError, formatZodError, truncateImporter };
 
 //# sourceMappingURL=format.mjs.map