envapt 8.1.1 → 8.2.1

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

@@ -31,11 +31,11 @@ import { EnvaptFieldDecorator } from "../../types/Decorator.mjs";
  * }
  * ```
  */
-declare function Envapt(key: EnvKeyInput, options?: {
+export declare function Envapt(key: EnvKeyInput, options?: {
   fallback: undefined;
   converter?: undefined;
 }): EnvaptFieldDecorator<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 readonly 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 readonly 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 readonly 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;
 }): EnvaptFieldDecorator<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;
 }): EnvaptFieldDecorator<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;
 }): EnvaptFieldDecorator<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;
 }): EnvaptFieldDecorator<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;
 }): EnvaptFieldDecorator<InferSchemaOutput<Schema>>;
 //#endregion
-export { Envapt };
 //# sourceMappingURL=Envapt.d.mts.map

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