envapt 8.2.0 → 8.2.1

package/dist/types/decorators/legacy/SugarDecorators.d.mts

@@ -7,38 +7,37 @@ import { EnvaptFieldDecorator } from "../../types/Decorator.mjs";
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
-declare function EnvBool(key: EnvKeyInput, fallback: boolean): EnvaptFieldDecorator<boolean>;
-declare function EnvBool(key: EnvKeyInput): EnvaptFieldDecorator<boolean | undefined>;
+export declare function EnvBool(key: EnvKeyInput, fallback: boolean): EnvaptFieldDecorator<boolean>;
+export declare function EnvBool(key: EnvKeyInput): EnvaptFieldDecorator<boolean | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.Number, fallback })`.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
-declare function EnvNum(key: EnvKeyInput, fallback: number): EnvaptFieldDecorator<number>;
-declare function EnvNum(key: EnvKeyInput): EnvaptFieldDecorator<number | undefined>;
+export declare function EnvNum(key: EnvKeyInput, fallback: number): EnvaptFieldDecorator<number>;
+export declare function EnvNum(key: EnvKeyInput): EnvaptFieldDecorator<number | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.String, fallback })`.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
-declare function EnvStr(key: EnvKeyInput, fallback: string): EnvaptFieldDecorator<string>;
-declare function EnvStr(key: EnvKeyInput): EnvaptFieldDecorator<string | undefined>;
+export declare function EnvStr(key: EnvKeyInput, fallback: string): EnvaptFieldDecorator<string>;
+export declare function EnvStr(key: EnvKeyInput): EnvaptFieldDecorator<string | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.Time, fallback })`. The fallback is a
  * millisecond number or a time string (`'15m'`), and the resolved value is always milliseconds.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
-declare function EnvTime(key: EnvKeyInput, fallback: TimeFallback): EnvaptFieldDecorator<number>;
-declare function EnvTime(key: EnvKeyInput): EnvaptFieldDecorator<number | undefined>;
+export declare function EnvTime(key: EnvKeyInput, fallback: TimeFallback): EnvaptFieldDecorator<number>;
+export declare function EnvTime(key: EnvKeyInput): EnvaptFieldDecorator<number | undefined>;
 /**
- * Shorthand for `@Envapt(key, { converter: Converters.Url, fallback })`. The fallback is a `URL`
- * instance, not a URL string.
+ * Shorthand for `@Envapt(key, { converter: Converters.Url, fallback })`. The fallback must be a
+ * `URL` instance.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
-declare function EnvUrl(key: EnvKeyInput, fallback: URL): EnvaptFieldDecorator<URL>;
-declare function EnvUrl(key: EnvKeyInput): EnvaptFieldDecorator<URL | undefined>;
+export declare function EnvUrl(key: EnvKeyInput, fallback: URL): EnvaptFieldDecorator<URL>;
+export declare function EnvUrl(key: EnvKeyInput): EnvaptFieldDecorator<URL | undefined>;
 //#endregion
-export { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl };
 //# sourceMappingURL=SugarDecorators.d.mts.map

package/dist/types/decorators/modern/Envapt.d.mts

@@ -31,11 +31,11 @@ import { EnvaptAccessorDecorator } from "../../types/Decorator.mjs";
  * }
  * ```
  */
-declare function Envapt(key: EnvKeyInput, options?: {
+export declare function Envapt(key: EnvKeyInput, options?: {
   fallback: undefined;
   converter?: undefined;
 }): EnvaptAccessorDecorator<string | undefined>;
-declare function Envapt<TFallback>(key: EnvKeyInput, options: {
+export declare function Envapt<TFallback>(key: EnvKeyInput, options: {
   converter: (raw: string | undefined, fallback: TFallback) => TFallback;
   fallback: TFallback;
 } | {
@@ -66,7 +66,7 @@ declare function Envapt<TFallback>(key: EnvKeyInput, options: {
  * }
  * ```
  */
-declare function Envapt<TReturnType>(key: EnvKeyInput, options: {
+export declare function Envapt<TReturnType>(key: EnvKeyInput, options: {
   converter: ConverterFunction<TReturnType>;
   required?: false;
 } | {
@@ -89,11 +89,11 @@ declare function Envapt<TReturnType>(key: EnvKeyInput, options: {
  *   \@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })
  *   static accessor port: number;
  *
- *   // the Url fallback is a URL instance, not a string
+ *   // the Url fallback is a URL instance
  *   \@Envapt('APP_URL', { converter: Converters.Url, fallback: new URL('http://localhost:3000') })
  *   static accessor url: URL;
  *
- *   // prefers CANARY_URL when present, otherwise APP_URL
+ *   // reads CANARY_URL when present, otherwise APP_URL
  *   \@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })
  *   static accessor canaryUrl: URL | undefined;
  *
@@ -112,7 +112,7 @@ declare function Envapt<TReturnType>(key: EnvKeyInput, options: {
  * }
  * ```
  */
-declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
+export declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
   converter: TConverter;
   fallback: InferConverterFallbackType<TConverter>;
   required?: false;
@@ -120,7 +120,7 @@ declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvK
   converter: TConverter;
   required: true;
 }): EnvaptAccessorDecorator<InferConverterReturnType<TConverter>>;
-declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
+export declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
   converter: TConverter;
   fallback?: undefined;
   required?: false;
@@ -142,7 +142,7 @@ declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvK
  * }
  * ```
  */
-declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
+export declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
   converter: TConstructor;
   fallback: InferPrimitiveReturnType<TConstructor>;
   required?: false;
@@ -150,16 +150,15 @@ declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyIn
   converter: TConstructor;
   required: true;
 }): EnvaptAccessorDecorator<InferPrimitiveReturnType<TConstructor>>;
-declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
+export declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
   converter: TConstructor;
   fallback?: undefined;
   required?: false;
 }): EnvaptAccessorDecorator<InferPrimitiveReturnType<TConstructor> | undefined>;
 /**
  * Required, no converter (raw string). Throws `MissingEnvValue` on first access when the env
- * value is missing or empty after trimming, independent of the global `Envapter.strict` flag.
- * Pairing `required: true` with `fallback` matches no overload at compile time, and the runtime
- * Validator rejects dynamic objects that bypass the types.
+ * value is missing or empty. Pairing `required: true` with `fallback` matches no overload at
+ * compile time, and a call that bypasses the types throws `InvalidUserDefinedConfig` at runtime.
  *
  * @param key - Environment variable name(s) to load
  * @param options - `{ required: true }`
@@ -172,17 +171,17 @@ declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyIn
  * }
  * ```
  */
-declare function Envapt(key: EnvKeyInput, options: {
+export declare function Envapt(key: EnvKeyInput, options: {
   required: true;
 }): EnvaptAccessorDecorator<string>;
 /**
- * A Standard Schema v1 adapter (zod, valibot, arktype, hand-rolled). Synchronous schemas only,
- * so a Promise-returning `validate` throws `InvalidUserDefinedConfig` at runtime. Pairing
- * `schema` with `converter` matches no overload at compile time, and the runtime Validator
- * rejects dynamic objects that bypass the types.
+ * A Standard Schema v1 adapter (zod, valibot, arktype, hand-rolled). Synchronous schemas only.
+ * A `validate` that returns a Promise throws `InvalidUserDefinedConfig` at runtime. Pairing
+ * `schema` with `converter` matches no overload at compile time, and a call that bypasses the
+ * types throws `InvalidUserDefinedConfig` at runtime.
  * @public
  */
-declare function Envapt<Schema extends StandardSchemaV1>(key: EnvKeyInput, options: {
+export declare function Envapt<Schema extends StandardSchemaV1>(key: EnvKeyInput, options: {
   schema: SchemaConstraint<Schema>;
   fallback?: InferSchemaOutput<Schema>;
   required?: false;
@@ -191,5 +190,4 @@ declare function Envapt<Schema extends StandardSchemaV1>(key: EnvKeyInput, optio
   required: true;
 }): EnvaptAccessorDecorator<InferSchemaOutput<Schema>>;
 //#endregion
-export { Envapt };
 //# sourceMappingURL=Envapt.d.mts.map

package/dist/types/decorators/modern/SugarDecorators.d.mts

@@ -7,38 +7,37 @@ import { EnvaptAccessorDecorator } from "../../types/Decorator.mjs";
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
-declare function EnvBool(key: EnvKeyInput, fallback: boolean): EnvaptAccessorDecorator<boolean>;
-declare function EnvBool(key: EnvKeyInput): EnvaptAccessorDecorator<boolean | undefined>;
+export declare function EnvBool(key: EnvKeyInput, fallback: boolean): EnvaptAccessorDecorator<boolean>;
+export declare function EnvBool(key: EnvKeyInput): EnvaptAccessorDecorator<boolean | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.Number, fallback })`.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
-declare function EnvNum(key: EnvKeyInput, fallback: number): EnvaptAccessorDecorator<number>;
-declare function EnvNum(key: EnvKeyInput): EnvaptAccessorDecorator<number | undefined>;
+export declare function EnvNum(key: EnvKeyInput, fallback: number): EnvaptAccessorDecorator<number>;
+export declare function EnvNum(key: EnvKeyInput): EnvaptAccessorDecorator<number | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.String, fallback })`.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
-declare function EnvStr(key: EnvKeyInput, fallback: string): EnvaptAccessorDecorator<string>;
-declare function EnvStr(key: EnvKeyInput): EnvaptAccessorDecorator<string | undefined>;
+export declare function EnvStr(key: EnvKeyInput, fallback: string): EnvaptAccessorDecorator<string>;
+export declare function EnvStr(key: EnvKeyInput): EnvaptAccessorDecorator<string | undefined>;
 /**
  * Shorthand for `@Envapt(key, { converter: Converters.Time, fallback })`. The fallback is a
  * millisecond number or a time string (`'15m'`), and the resolved value is always milliseconds.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
-declare function EnvTime(key: EnvKeyInput, fallback: TimeFallback): EnvaptAccessorDecorator<number>;
-declare function EnvTime(key: EnvKeyInput): EnvaptAccessorDecorator<number | undefined>;
+export declare function EnvTime(key: EnvKeyInput, fallback: TimeFallback): EnvaptAccessorDecorator<number>;
+export declare function EnvTime(key: EnvKeyInput): EnvaptAccessorDecorator<number | undefined>;
 /**
- * Shorthand for `@Envapt(key, { converter: Converters.Url, fallback })`. The fallback is a `URL`
- * instance, not a URL string.
+ * Shorthand for `@Envapt(key, { converter: Converters.Url, fallback })`. The fallback must be a
+ * `URL` instance.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}
  */
-declare function EnvUrl(key: EnvKeyInput, fallback: URL): EnvaptAccessorDecorator<URL>;
-declare function EnvUrl(key: EnvKeyInput): EnvaptAccessorDecorator<URL | undefined>;
+export declare function EnvUrl(key: EnvKeyInput, fallback: URL): EnvaptAccessorDecorator<URL>;
+export declare function EnvUrl(key: EnvKeyInput): EnvaptAccessorDecorator<URL | undefined>;
 //#endregion
-export { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl };
 //# sourceMappingURL=SugarDecorators.d.mts.map

package/dist/types/engine/Envapter.d.mts

@@ -25,7 +25,7 @@ import { AdvancedMethods } from "../core/AdvancedMethods.mjs";
  *
  * @public
  */
-declare class Envapter extends AdvancedMethods {
+export declare class Envapter extends AdvancedMethods {
   /**
    * Tagged template literal for resolving environment variables in template strings.
    *
@@ -84,5 +84,5 @@ declare class Envapter extends AdvancedMethods {
   has(key: EnvKeyInput): boolean;
 }
 //#endregion
-export { Envapter, Environment };
+export { Environment };
 //# sourceMappingURL=Envapter.d.mts.map

package/dist/types/engine/NodeEnvapter.d.mts

@@ -9,7 +9,7 @@ import { EnvFileOptions } from "../infra/Dotenv.mjs";
  * `Envapter.fileApiMode`.
  * @public
  */
-declare class NodeEnvapter extends Envapter {
+export declare class NodeEnvapter extends Envapter {
   /**
    * Set custom .env file paths. Accepts either a single path or array of paths.
    * Setting new paths clears the cache and reloads environment variables.
@@ -27,12 +27,12 @@ declare class NodeEnvapter extends Envapter {
   /**
    * Set a base directory that relative `.env` paths resolve against instead of
    * `process.cwd()`: the auto-cascade, `Envapter.configureProfiles` paths, and relative
-   * `envPaths`. Absolute paths always bypass it. Pass a directory, or a module URL
-   * (`import.meta.url`, ESM) / `import.meta.dirname` / `__dirname` (CJS) to anchor
-   * resolution next to the calling file regardless of launch directory.
+   * `envPaths`. Absolute paths always bypass it. Pass a directory path (`import.meta.dirname`,
+   * or `__dirname` in CJS) or a module URL (`import.meta.url`) to resolve paths next to the
+   * calling file regardless of launch directory.
    *
    * Set this before `envPaths` so relative `envPaths` validate against the right directory.
-   * Unset (`undefined`) restores `process.cwd()` resolution.
+   * Setting `undefined` restores `process.cwd()` resolution.
    * @see {@link https://envapt.materwelon.dev/docs/configuration#reading-from-a-fixed-directory}
    */
   static set baseDir(value: string | URL | undefined);
@@ -79,5 +79,4 @@ declare class NodeEnvapter extends Envapter {
   static resetProfiles(): void;
 }
 //#endregion
-export { NodeEnvapter };
 //# sourceMappingURL=NodeEnvapter.d.mts.map

package/dist/types/engine/PortableEnvapter.d.mts

@@ -3,14 +3,13 @@ import { Envapter } from "./Envapter.mjs";
 import { EnvFileOptions } from "../infra/Dotenv.mjs";
 //#region src/engine/PortableEnvapter.d.ts
 /**
- * The browser/Workers/edge facade. {@link Envapter} with the filesystem-only config APIs present in
- * the type but inert at runtime by default. Under the default `fileApiMode` of `'warn'` they warn once
- * and no-op (getters return an empty default matching their type, setters do nothing). `'throw'` restores
- * the {@link EnvaptError} `FileApiUnsupported`. The read side still throws `NoSourceBound` on first read
- * until `useSource` binds a source.
+ * The browser/Workers/edge facade. It is {@link Envapter} with the filesystem-only config APIs kept in
+ * the type. Under the default `fileApiMode` of `'warn'` they warn once and no-op (getters return an
+ * empty default matching their type and setters do nothing). `'throw'` makes them throw
+ * {@link EnvaptError} `FileApiUnsupported`. Reads throw `NoSourceBound` until `useSource` binds a source.
  * @public
  */
-declare class PortableEnvapter extends Envapter {
+export declare class PortableEnvapter extends Envapter {
   static get envPaths(): string[];
   static set envPaths(_paths: string[] | string);
   static get baseDir(): string | undefined;
@@ -21,5 +20,4 @@ declare class PortableEnvapter extends Envapter {
   static resetProfiles(): void;
 }
 //#endregion
-export { PortableEnvapter };
 //# sourceMappingURL=PortableEnvapter.d.mts.map

package/dist/types/infra/Debug.d.mts

@@ -1,14 +1,12 @@
 //#region src/infra/Debug.d.ts
 /**
  * Debug log levels for {@link Envapter.debug}. `silent` (default) emits nothing.
- * `warn` covers signals that might indicate misconfiguration, failed file reads,
- * unresolved templates (when not strict), and any read of a missing or empty variable
- * (whether it returns a fallback or `undefined`). `verbose` adds every loaded file,
+ * `warn` logs failed file reads, unresolved templates (when not strict), and any read of a
+ * missing or empty variable, whether it returns a fallback or `undefined`. `verbose` adds every loaded file,
  * per-file key count, per-key load lines, and effective-paths / cache-rebuild notices.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/configuration#debug-logging}
  */
-type DebugLevel = 'silent' | 'warn' | 'verbose';
+export type DebugLevel = 'silent' | 'warn' | 'verbose';
 //#endregion
-export { DebugLevel };
 //# sourceMappingURL=Debug.d.mts.map

package/dist/types/infra/Dotenv.d.mts

@@ -1,18 +1,16 @@
 //#region src/infra/Dotenv.d.ts
 /**
- * Public options for the internal `.env` loader. Mirrors the subset of dotenv's
- * `config()` options that envapt actually supports (no DOTENV_KEY, no quiet).
+ * Options for the `.env` loader, matching the dotenv `config()` options of the same name.
  * For debug output, use `Envapter.debug` (or the `ENVAPT_DEBUG` env var).
  *
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/configuration#which-files-load}
  */
-interface EnvFileOptions {
+export interface EnvFileOptions {
   /** Encoding for reading .env files. Defaults to 'utf8'. */
   encoding?: string;
   /** When true, later files override earlier ones (and existing processEnv values). Default false (first-wins). */
   override?: boolean;
 }
 //#endregion
-export { EnvFileOptions };
 //# sourceMappingURL=Dotenv.d.mts.map

package/dist/types/infra/Error.d.mts

@@ -5,7 +5,7 @@ import { StandardSchemaV1 } from "./StandardSchema.mjs";
  * and configuration (3xx) failures.
  * @see {@link https://envapt.materwelon.dev/docs/errors#codes}
  */
-declare enum EnvaptErrorCodes {
+export declare enum EnvaptErrorCodes {
   /** Thrown when an invalid fallback value is provided */
   InvalidFallback = 101,
   /** Thrown when fallback value type doesn't match expected converter type */
@@ -42,7 +42,7 @@ declare enum EnvaptErrorCodes {
   EnvFilesNotFound = 303,
   /** Thrown when no valid environment key is provided */
   InvalidKeyInput = 304,
-  /** Thrown when a required environment value is missing or empty (post-trim) */
+  /** Thrown when a required environment value is missing or empty */
   MissingEnvValue = 305,
   /** Thrown when a file-based API (envPaths, baseDir, configureProfiles) is used on a source without filesystem support */
   FileApiUnsupported = 306,
@@ -56,7 +56,7 @@ interface EnvaptErrorOptions {
   cause?: unknown;
 }
 /**
- * Custom error for better DX and debugging when using Envapt.
+ * The error envapt throws. Its `code` identifies the failure.
  *
  * @example
  * ```ts
@@ -64,7 +64,7 @@ interface EnvaptErrorOptions {
  * ```
  * @see {@link https://envapt.materwelon.dev/docs/errors#the-error-shape}
  */
-declare class EnvaptError extends Error {
+export declare class EnvaptError extends Error {
   /** The {@link EnvaptErrorCodes} value identifying what failed. */
   readonly code: EnvaptErrorCodes;
   /**
@@ -77,5 +77,4 @@ declare class EnvaptError extends Error {
   constructor(code: EnvaptErrorCodes, message: string, options?: EnvaptErrorOptions);
 }
 //#endregion
-export { EnvaptError, EnvaptErrorCodes };
 //# sourceMappingURL=Error.d.mts.map

package/dist/types/infra/StandardSchema.d.mts

@@ -4,18 +4,17 @@
  * so envapt has zero runtime peer dependencies on any specific schema library
  * (zod / valibot / arktype / etc).
  *
- * envapt narrows usage to SYNCHRONOUS schemas only: env loading is boot-time,
- * `validate` returning `Promise<Result>` is rejected at the type level (see
- * `SchemaMustBeSync` brand in `Types.ts`) and at runtime by the Parser dispatch.
+ * envapt accepts synchronous schemas only. A `validate` that returns a Promise fails to
+ * type-check and throws `InvalidUserDefinedConfig` at runtime.
  *
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/standard-schema#any-conformant-validator-or-none}
  */
-interface StandardSchemaV1<Input = unknown, Output = Input> {
+export interface StandardSchemaV1<Input = unknown, Output = Input> {
   /** The Standard Schema entry point holding the validator and the inferred input/output types. */
   readonly '~standard': StandardSchemaV1.Props<Input, Output>;
 }
-declare namespace StandardSchemaV1 {
+export declare namespace StandardSchemaV1 {
   interface Props<Input = unknown, Output = Input> {
     readonly version: 1;
     readonly vendor: string;
@@ -44,7 +43,6 @@ declare namespace StandardSchemaV1 {
   type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['input'];
   type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
 }
-type InferSchemaOutput<Schema extends StandardSchemaV1> = StandardSchemaV1.InferOutput<Schema>;
+export type InferSchemaOutput<Schema extends StandardSchemaV1> = StandardSchemaV1.InferOutput<Schema>;
 //#endregion
-export { InferSchemaOutput, StandardSchemaV1 };
 //# sourceMappingURL=StandardSchema.d.mts.map

package/dist/types/sources/FileSource.d.mts

@@ -7,7 +7,7 @@ import { FileCapableSource } from "../types/Source.mjs";
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/sources#the-providers}
  */
-declare class FileSource implements FileCapableSource {
+export declare class FileSource implements FileCapableSource {
   /** Always `true`. The engine layers the `.env` cascade and `baseDir` on top of `process.env`. */
   readonly supportsFiles = true;
   /** Returns a snapshot clone of `process.env` as plain strings. */
@@ -26,5 +26,4 @@ declare class FileSource implements FileCapableSource {
   writeVars(vars: Record<string, string>): void;
 }
 //#endregion
-export { FileSource };
 //# sourceMappingURL=FileSource.d.mts.map

package/dist/types/sources/PortableSource.d.mts

@@ -1,16 +1,16 @@
 import { BareSource } from "../types/Source.mjs";
 //#region src/sources/PortableSource.d.ts
 /**
- * Environment source seeded from an object you provide, for every runtime without a filesystem. The
- * config your bundler injects into a browser build (Vite's `import.meta.env`, a webpack `DefinePlugin`
- * global), the Cloudflare `env` binding, a Vercel Edge or Fastly config object, a test fixture, or any
- * plain object. Pass it straight through. Non-string values are JSON-stringified so the converters
- * still apply, which means they must be JSON-serializable. Without a filesystem the `.env` cascade and
- * file APIs do not apply.
+ * Environment source seeded from an object you provide, for every runtime without a filesystem. Pass
+ * the object straight through, such as the config your bundler injects into a browser build (Vite's
+ * `import.meta.env`, a webpack `DefinePlugin` global), the Cloudflare `env` binding, a Vercel Edge or
+ * Fastly config object, a test fixture, or any plain object. Non-string values are JSON-stringified so
+ * the converters still apply. Those values must be JSON-serializable. Without a filesystem the `.env`
+ * cascade and file APIs do not apply.
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/sources#the-providers}
  */
-declare class PortableSource implements BareSource {
+export declare class PortableSource implements BareSource {
   /** Always `false`. With no filesystem, the `.env` cascade and file APIs do not apply. */
   readonly supportsFiles = false;
   private readonly vars;
@@ -20,5 +20,4 @@ declare class PortableSource implements BareSource {
   readVars(): Record<string, string>;
 }
 //#endregion
-export { PortableSource };
 //# sourceMappingURL=PortableSource.d.mts.map

package/dist/types/sources/merge.d.mts

@@ -9,7 +9,6 @@ import { Source } from "../types/Source.mjs";
  * @public
  * @see {@link https://envapt.materwelon.dev/docs/sources#combining-sources}
  */
-declare function merge(...members: (Source | ((key: string) => string | undefined))[]): Source;
+export declare function merge(...members: (Source | ((key: string) => string | undefined))[]): Source;
 //#endregion
-export { merge };
 //# sourceMappingURL=merge.d.mts.map

package/dist/types/types/Conversion.d.mts

@@ -42,10 +42,6 @@ interface ConverterMap {
   email: string;
 }
 type BuiltInConverterReturnType<ConverterKey extends BuiltInConverter> = ConverterMap[ConverterKey];
-/**
- * Time unit types for duration conversions
- * @internal
- */
 type TimeUnit = 'ms' | 's' | 'm' | 'h' | 'd' | 'w';
 /**
  * Fallback type for time duration conversions

package/dist/types/types/Decorator.d.mts

@@ -1,12 +1,11 @@
 //#region src/types/Decorator.d.ts
-type EnvaptFieldDecorator<Output> = <Target, Key extends keyof Target>(target: Target, key: [Output] extends [Target[Key]] ? Key : {
+export type EnvaptFieldDecorator<Output> = <Target, Key extends keyof Target>(target: Target, key: [Output] extends [Target[Key]] ? Key : {
   '[envapt] field type must hold the converter output': Output;
 }) => void;
-type EnvaptAccessorDecorator<Output> = <This, Value>(target: ClassAccessorDecoratorTarget<This, [Output] extends [Value] ? Value : {
+export type EnvaptAccessorDecorator<Output> = <This, Value>(target: ClassAccessorDecoratorTarget<This, [Output] extends [Value] ? Value : {
   '[envapt] field type must hold the converter output': Output;
 }>, context: ClassAccessorDecoratorContext<This, [Output] extends [Value] ? Value : {
   '[envapt] field type must hold the converter output': Output;
 }>) => ClassAccessorDecoratorResult<This, Value>;
 //#endregion
-export { EnvaptAccessorDecorator, EnvaptFieldDecorator };
 //# sourceMappingURL=Decorator.d.mts.map

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.1",
   "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,15 @@
     "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",
+    "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 +207,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",