envapt 8.2.0 → 8.2.2

package/dist/types/types/Options.d.mts

@@ -2,8 +2,8 @@ import { Environment } from "../core/Environment.mjs";
 import { EnvaptConverter } from "./Conversion.mjs";
 //#region src/types/Options.d.ts
 /**
- * Options for the \@Envapt decorator (modern API). `required: true` is mutually exclusive
- * with `fallback`; see the per-converter overloads in `Envapt.ts` for the type-level mutex.
+ * Options for the \@Envapt decorator (modern API). `required: true` and `fallback` cannot be
+ * used together, and the `@Envapt` overloads reject the pair at compile time.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#declaring-decorated-fields}
  */
@@ -21,27 +21,27 @@ interface EnvaptOptions<TFallback = string> {
  * @see {@link https://envapt.materwelon.dev/docs/environment#custom-profiles}
  */
 interface EnvProfile {
-  /** One or more `.env` paths to load for this environment. Order matters: earlier paths take precedence. */
+  /** One or more `.env` paths to load for this environment. Earlier paths take precedence. */
   paths: string | string[];
 }
 /**
  * Configuration object for `Envapter.configureProfiles`. Maps each `Environment` to an optional
  * profile override. Unspecified environments fall through to the default cascade behavior
- * (`.env.${env}.local`, `.env.local`, `.env.${env}`, `.env`).
+ * (`.env.${env}.local`, `.env.${env}`, `.env.local`, `.env`).
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/environment#custom-profiles}
  */
 type ProfilesConfig = Partial<Record<Environment, EnvProfile>> & {
   /**
    * When `false`, disables the default dotenv-flow cascade entirely. Only the explicitly
-   * configured paths are loaded. Defaults to `true` (cascade still runs, configured paths
-   * are layered on top with higher precedence).
+   * configured paths are loaded. Defaults to `true` (the cascade still runs and configured
+   * paths take higher precedence).
    */
   useDefaults?: boolean;
 };
 /**
  * How the portable build's filesystem-only config APIs behave when called. `'warn'` (the default)
- * warns once and no-ops, `'throw'` throws `FileApiUnsupported`. The node build runs these APIs
+ * warns once and no-ops. `'throw'` throws `FileApiUnsupported`. The node build runs these APIs
  * normally and is unaffected by this value.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/compatibility#binding-by-runtime}

package/dist/types/types/Schema.d.mts

@@ -7,5 +7,5 @@ type Err<Msg extends string> = Msg & {
 type SchemaMustBeSync = Err<'Schema must be synchronous. envapt is boot-time config loading; async refinements (validate returning `Promise<Result>`) belong outside the env layer.'>;
 type SchemaConstraint<Schema extends StandardSchemaV1> = ReturnType<Schema['~standard']['validate']> extends Promise<unknown> ? SchemaMustBeSync : Schema;
 //#endregion
-export type { Err, SchemaConstraint, SchemaMustBeSync };
+export type { SchemaConstraint };
 //# sourceMappingURL=Schema.d.mts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "envapt",
   "type": "module",
-  "version": "8.2.0",
+  "version": "8.2.2",
   "description": "Type-safe config for TypeScript. Read typed values from any source, process.env, .env files, Cloudflare Workers bindings, browser bundles, or any object you supply. Zero runtime dependencies, one API across Node, Bun, Deno, Workers, and the browser. TC39 accessor decorators (legacy decorators at envapt/legacy), converters, and Standard Schema (zod/valibot/arktype) validation.",
   "types": "./dist/types/index.d.mts",
   "exports": {
@@ -186,16 +186,16 @@
     "provenance": true
   },
   "devDependencies": {
-    "@cloudflare/vitest-pool-workers": "0.18.0",
-    "@cloudflare/workers-types": "^5.20260730.1",
-    "@vitest/browser": "4.1.10",
-    "@vitest/browser-playwright": "4.1.10",
-    "arktype": "^2.2.2",
-    "esbuild": "^0.28.1",
-    "playwright": "1.61.1",
+    "@cloudflare/vitest-pool-workers": "0.22.0",
+    "@cloudflare/workers-types": "^5.20260911.1",
+    "@vitest/browser-playwright": "4.1.11",
+    "arktype": "^2.2.3",
+    "esbuild": "^0.28.2",
+    "jiti": "^2.7.0",
+    "playwright": "1.63.0",
     "typescript7": "npm:typescript@7.0.2",
-    "valibot": "^1.4.2",
-    "zod": "4.4.3"
+    "valibot": "^1.5.0",
+    "zod": "4.6.4"
   },
   "scripts": {
     "clean": "rm -rf dist",
@@ -208,7 +208,6 @@
     "fmt:check": "prettier --check '{src,tests,scripts}/**/*.{ts,tsx,json,md}' --cache",
     "fmt:all": "prettier --write .",
     "tc": "tsc --noEmit",
-    "tsd": "tsd",
     "test": "vitest run",
     "test:watch": "vitest dev",
     "test:integration": "node tests/integration/run.mjs",
@@ -221,6 +220,7 @@
     "test:cjs-validity": "node tests/cjs-validity/run.mjs",
     "test:tsc-emit": "node tests/tsc-emit/run.mjs",
     "test:tsc-emit:ts7": "ENVAPT_TSC_PACKAGE=typescript7 node tests/tsc-emit/run.mjs",
+    "test:babel-emit": "node tests/babel-emit/run.mjs",
     "test:stage3-emit": "node tests/stage3-emit/run.mjs",
     "test:stage3-emit:ts7": "ENVAPT_TSC_PACKAGE=typescript7 node tests/stage3-emit/run.mjs",
     "test:all": "node ../../scripts/test-all.mjs",