envapt 7.0.0-next.0 → 7.0.0-next.1

package/dist/workerd/index.d.mts

@@ -1,18 +0,0 @@
-import { ArrayElement, ArrayOf, ConverterToken, Converters, CustomElementConverter, isArrayOf } from "./converters/Converters.mjs";
-import { AdvancedConverterReturn, BuiltInConverter, BuiltInConverterFunction, ConditionalReturn, ConverterFunction, EnvaptConverter, InferConverterFallbackType, InferConverterReturnType, InferPrimitiveReturnType, JsonValue, MapOfConverterFunctions, PrimitiveConstructor, TimeFallback, TimeUnit } from "./types/Conversion.mjs";
-import { InferSchemaInput, InferSchemaOutput, StandardSchemaV1 } from "./infra/StandardSchema.mjs";
-import { Err, SchemaConstraint, SchemaMustBeSync } from "./types/Schema.mjs";
-import { DebugLevel } from "./infra/Debug.mjs";
-import { EnvFileOptions } from "./infra/Dotenv.mjs";
-import { Environment } from "./core/EnvironmentMethods.mjs";
-import { EnvProfile, EnvaptOptions, ProfilesConfig } from "./types/Options.mjs";
-import { EnvKeyInput } from "./types/Env.mjs";
-import { BareEnvSource, EnvSource, FileEnvSource } from "./types/Source.mjs";
-import { EnvaptAccessorDecorator, EnvaptFieldDecorator } from "./types/Decorator.mjs";
-import { Envapter } from "./engine/Envapter.mjs";
-import { ManualEnvSource } from "./sources/ManualEnvSource.mjs";
-import { WorkerEnvSource } from "./sources/WorkerEnvSource.mjs";
-import { EnvaptError, EnvaptErrorCodes } from "./infra/Error.mjs";
-import { Envapt } from "./decorators/modern/Envapt.mjs";
-import { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl } from "./decorators/modern/SugarDecorators.mjs";
-export { type AdvancedConverterReturn, type ArrayElement, type ArrayOf, type BareEnvSource, type BuiltInConverter, type BuiltInConverterFunction, type ConditionalReturn, type ConverterFunction, type ConverterToken, Converters, type CustomElementConverter, type DebugLevel, EnvBool, type EnvFileOptions, type EnvKeyInput, EnvNum, type EnvProfile, type EnvSource, EnvStr, EnvTime, EnvUrl, Envapt, type EnvaptAccessorDecorator, type EnvaptConverter, EnvaptError, EnvaptErrorCodes, type EnvaptFieldDecorator, type EnvaptOptions, Envapter, Environment, type Err, type FileEnvSource, type InferConverterFallbackType, type InferConverterReturnType, type InferPrimitiveReturnType, type InferSchemaInput, type InferSchemaOutput, type JsonValue, ManualEnvSource, type MapOfConverterFunctions, type PrimitiveConstructor, type ProfilesConfig, type SchemaConstraint, type SchemaMustBeSync, type StandardSchemaV1, type TimeFallback, type TimeUnit, WorkerEnvSource, isArrayOf };

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

@@ -1,13 +0,0 @@
-//#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), fallback values used in place of missing
- * env. `verbose` adds every loaded file, per-file key count, per-key load lines, and
- * effective-paths / cache-rebuild notices.
- * @public
- */
-type DebugLevel = 'silent' | 'warn' | 'verbose';
-//#endregion
-export { DebugLevel };
-//# sourceMappingURL=Debug.d.mts.map

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

@@ -1,17 +0,0 @@
-//#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).
- * For debug output, use `Envapter.debug` (or the `ENVAPT_DEBUG` env var).
- *
- * @public
- */
-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/workerd/infra/Error.d.mts

@@ -1,72 +0,0 @@
-import { StandardSchemaV1 } from "./StandardSchema.mjs";
-
-//#region src/infra/Error.d.ts
-declare enum EnvaptErrorCodes {
-  /** Thrown when an invalid fallback value is provided */
-  InvalidFallback = 101,
-  /** Thrown when fallback value type doesn't match expected converter type */
-  InvalidFallbackType = 102,
-  /** Thrown when array fallback contains elements of wrong type */
-  ArrayFallbackElementTypeMismatch = 103,
-  /** Thrown when fallback type doesn't match the specified converter */
-  FallbackConverterTypeMismatch = 104,
-  /** Thrown when a time-string fallback is malformed (does not match the required `<number><unit>` format) */
-  MalformedTimeFallback = 105,
-  /** Thrown when invalid array converter configuration is provided */
-  InvalidArrayConverterType = 201,
-  /** Thrown when an invalid built-in converter is specified */
-  InvalidBuiltInConverter = 202,
-  /** Thrown when a custom converter is not a function */
-  InvalidCustomConverter = 203,
-  /** Thrown when converter type is not recognized */
-  InvalidConverterType = 204,
-  /** Thrown when primitive type coercion on fallback value fails */
-  PrimitiveCoercionFailed = 205,
-  /** Thrown when an array element fails to convert to the configured element type */
-  ArrayElementConversionFailed = 206,
-  /** Thrown under strict mode when an array element is empty or whitespace only */
-  EmptyArrayElement = 207,
-  /** Thrown when a Standard Schema returns issues for a non-empty env value */
-  SchemaValidationFailed = 208,
-  /** Thrown when a Standard Schema's `validate` itself throws (e.g. a refinement that crashes) */
-  SchemaThrew = 209,
-  /** Thrown when delimiter is missing in array converter configuration */
-  MissingDelimiter = 301,
-  /** Thrown when invalid user-defined configuration is provided */
-  InvalidUserDefinedConfig = 302,
-  /** Thrown when specified environment files don't exist */
-  EnvFilesNotFound = 303,
-  /** Thrown when no valid environment key is provided */
-  InvalidKeyInput = 304,
-  /** Thrown when a required environment value is missing or empty (post-trim) */
-  MissingEnvValue = 305,
-  /** Thrown when a file-based API (envPaths, baseDir, configureProfiles) is used on a source without filesystem support */
-  FileApiUnsupported = 306,
-  /** Thrown when an environment value is read before a source is bound via Envapter.useSource */
-  NoSourceBound = 307
-}
-interface EnvaptErrorOptions {
-  issues?: readonly StandardSchemaV1.Issue[];
-  cause?: unknown;
-}
-/**
- * Custom error for better DX and debugging when using Envapt.
- *
- * @example
- * ```ts
- * throw new EnvaptError(EnvaptErrorCodes.InvalidFallback, "Invalid fallback value provided for environment variable.");
- * ```
- */
-declare class EnvaptError extends Error {
-  readonly code: EnvaptErrorCodes;
-  /**
-   * Populated only for {@link EnvaptErrorCodes.SchemaValidationFailed} (208). For every other
-   * code this is `undefined`. Lets callers do `if (err.code === 208) err.issues?.forEach(...)`
-   * without a type cast.
-   */
-  readonly issues: readonly StandardSchemaV1.Issue[] | undefined;
-  constructor(code: EnvaptErrorCodes, message: string, options?: EnvaptErrorOptions);
-}
-//#endregion
-export { EnvaptError, EnvaptErrorCodes };
-//# sourceMappingURL=Error.d.mts.map

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

@@ -1,59 +0,0 @@
-//#region src/infra/StandardSchema.d.ts
-/**
- * Standard Schema V1 interface. Inlined verbatim from the spec at https://standardschema.dev
- * 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.
- *
- * @public
- */
-interface StandardSchemaV1<Input = unknown, Output = Input> {
-  readonly '~standard': StandardSchemaV1.Props<Input, Output>;
-}
-declare namespace StandardSchemaV1 {
-  interface Props<Input = unknown, Output = Input> {
-    readonly version: 1;
-    readonly vendor: string;
-    readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
-    readonly types?: Types<Input, Output> | undefined;
-  }
-  type Result<Output> = SuccessResult<Output> | FailureResult;
-  interface SuccessResult<Output> {
-    readonly value: Output;
-    readonly issues?: undefined;
-  }
-  interface FailureResult {
-    readonly issues: readonly Issue[];
-  }
-  interface Issue {
-    readonly message: string;
-    readonly path?: readonly (PropertyKey | PathSegment)[] | undefined;
-  }
-  interface PathSegment {
-    readonly key: PropertyKey;
-  }
-  interface Types<Input = unknown, Output = Input> {
-    readonly input: Input;
-    readonly output: Output;
-  }
-  type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['input'];
-  type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
-}
-/**
- * Envapt-side alias for {@link StandardSchemaV1.InferOutput}. Re-exported under a friendlier
- * name so consumers writing `static readonly x: InferSchemaOutput<typeof mySchema>`
- * don't need the namespace path.
- * @public
- */
-type InferSchemaOutput<Schema extends StandardSchemaV1> = StandardSchemaV1.InferOutput<Schema>;
-/**
- * Envapt-side alias for {@link StandardSchemaV1.InferInput}.
- * @public
- */
-type InferSchemaInput<Schema extends StandardSchemaV1> = StandardSchemaV1.InferInput<Schema>;
-//#endregion
-export { InferSchemaInput, InferSchemaOutput, StandardSchemaV1 };
-//# sourceMappingURL=StandardSchema.d.mts.map

package/dist/workerd/legacy.d.mts

@@ -1,4 +0,0 @@
-import { EnvaptFieldDecorator } from "./types/Decorator.mjs";
-import { Envapt } from "./decorators/legacy/Envapt.mjs";
-import { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl } from "./decorators/legacy/SugarDecorators.mjs";
-export { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl, Envapt, type EnvaptFieldDecorator };

package/dist/workerd/sources/ManualEnvSource.d.mts

@@ -1,19 +0,0 @@
-import { BareEnvSource } from "../types/Source.mjs";
-
-//#region src/sources/ManualEnvSource.d.ts
-/**
- * Environment source seeded from an object you provide: the config your bundler injects into a browser
- * build (Vite's `import.meta.env`, a webpack `DefinePlugin` global), a test fixture, or any other plain
- * object. Pass it straight through; non-string values are JSON-stringified so the converters still apply.
- * It has no filesystem, so the `.env` cascade and file-based APIs do not apply.
- * @public
- */
-declare class ManualEnvSource implements BareEnvSource {
-  readonly supportsFiles = false;
-  private readonly vars;
-  constructor(vars: Record<string, unknown>);
-  readVars(): Record<string, string>;
-}
-//#endregion
-export { ManualEnvSource };
-//# sourceMappingURL=ManualEnvSource.d.mts.map

package/dist/workerd/sources/WorkerEnvSource.d.mts

@@ -1,19 +0,0 @@
-import { BareEnvSource } from "../types/Source.mjs";
-
-//#region src/sources/WorkerEnvSource.d.ts
-/**
- * Environment source for Cloudflare Workers, seeded from the `env` binding. String bindings pass
- * through; non-string bindings are JSON-stringified so the converters still apply, and so must be
- * JSON-serializable (a `bigint` or circular value throws). No filesystem, so the `.env` cascade and
- * file-based APIs do not apply.
- * @public
- */
-declare class WorkerEnvSource implements BareEnvSource {
-  readonly supportsFiles = false;
-  private readonly vars;
-  constructor(env: Record<string, unknown>);
-  readVars(): Record<string, string>;
-}
-//#endregion
-export { WorkerEnvSource };
-//# sourceMappingURL=WorkerEnvSource.d.mts.map

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

@@ -1,123 +0,0 @@
-import { ArrayOf, ConverterToken, CustomElementConverter } from "../converters/Converters.mjs";
-
-//#region src/types/Conversion.d.ts
-/**
- * Scalar built-in converter tokens (e.g. `'number'`, `'time'`).
- * Excludes the array builder (see {@link ArrayOf}).
- * @public
- */
-type BuiltInConverter = ConverterToken;
-/**
- * Primitive types supported by Envapter
- * @public
- */
-type PrimitiveConstructor = typeof String | typeof Number | typeof Boolean | typeof BigInt | typeof Symbol;
-/**
- * String value from a .env file or environment variable
- * @public
- */
-type BaseInput = string | undefined;
-/**
- * Custom parser function type for environment variables
- * @param raw - Raw string value from environment
- * @param fallback - Fallback value if parsing fails
- * @returns Parsed value of type T
- * @public
- */
-type ConverterFunction<TFallback = unknown> = (raw: BaseInput, fallback?: TFallback) => TFallback;
-/**
- * Environment variable converter: a primitive constructor, a built-in scalar token, an `ArrayOf<...>`
- * produced by {@link Converters.array}, or a custom parser function.
- * @public
- */
-type EnvaptConverter<TFallback> = PrimitiveConstructor | BuiltInConverter | ArrayOf | ConverterFunction<TFallback>;
-type JsonPrimitive = string | number | boolean | null;
-type JsonArray = JsonValue[];
-interface JsonObject {
-  [key: string]: JsonValue;
-}
-/**
- * JSON value types for custom converters
- * @public
- */
-type JsonValue = JsonPrimitive | JsonArray | JsonObject;
-interface ConverterMap {
-  string: string;
-  number: number;
-  boolean: boolean;
-  bigint: bigint;
-  symbol: symbol;
-  integer: number;
-  float: number;
-  json: JsonValue;
-  url: URL;
-  regexp: RegExp;
-  date: Date;
-  time: number;
-}
-/**
- * Type mapping for built-in scalar converters to their return types
- * @internal
- */
-type BuiltInConverterReturnType<ConverterKey extends BuiltInConverter> = ConverterMap[ConverterKey];
-/**
- * Return type for built-in converter functions
- * @internal
- */
-type ReturnValuesOfConverterFunctions = ConverterMap[BuiltInConverter];
-/**
- * Function type for built-in converter functions
- * @internal
- */
-type BuiltInConverterFunction = (...args: Parameters<(...args: any[]) => ReturnValuesOfConverterFunctions>) => ReturnValuesOfConverterFunctions | undefined;
-/**
- * Map of built-in converter functions
- * @internal
- */
-type MapOfConverterFunctions = Record<BuiltInConverter, BuiltInConverterFunction>;
-/**
- * Time unit types for duration conversions
- * @internal
- */
-type TimeUnit = 'ms' | 's' | 'm' | 'h' | 'd' | 'w';
-/**
- * Fallback type for time duration conversions
- * @public
- */
-type TimeFallback = number | `${number}${TimeUnit}`;
-/**
- * Helper type for getter methods that conditionally return undefined based on whether a fallback is provided
- * If fallback is provided, return ReturnType. If no fallback (undefined), return ReturnType | undefined.
- * @internal
- */
-type ConditionalReturn<ReturnType, TFallback> = TFallback extends undefined ? ReturnType | undefined : ReturnType;
-/**
- * Inferred return type for a converter.
- *
- * - `ArrayOf<E>` resolves to the element type's return as an array. When `E` is a custom
- *   function, the function's return type drives the array element. When `E` is a scalar
- *   token, `ConverterMap` provides the element type.
- * - Bare scalar tokens resolve through `ConverterMap`.
- * @internal
- */
-type InferConverterReturnType<TConverter> = TConverter extends ArrayOf<infer Element> ? Element extends BuiltInConverter ? ConverterMap[Element][] : Element extends CustomElementConverter<infer Returned> ? Returned[] : never : TConverter extends BuiltInConverter ? BuiltInConverterReturnType<TConverter> : never;
-/**
- * Type inference for the *fallback* slot of a converter. `Converters.Time` (scalar or array
- * element) accepts {@link TimeFallback} / `TimeFallback[]`; everything else mirrors the
- * return type. Add future asymmetric fallback/return converters to this conditional.
- * @internal
- */
-type InferConverterFallbackType<TConverter> = TConverter extends 'time' ? TimeFallback : TConverter extends ArrayOf<infer Element> ? Element extends 'time' ? TimeFallback[] : InferConverterReturnType<TConverter> : InferConverterReturnType<TConverter>;
-/**
- * Complete type inference for advanced converter methods
- * @internal
- */
-type AdvancedConverterReturn<TConverter, TFallback = undefined> = ConditionalReturn<InferConverterReturnType<TConverter>, TFallback>;
-/**
- * Type inference for primitive constructor return types
- * @internal
- */
-type InferPrimitiveReturnType<TConstructor extends PrimitiveConstructor> = TConstructor extends typeof String ? string : TConstructor extends typeof Number ? number : TConstructor extends typeof Boolean ? boolean : TConstructor extends typeof BigInt ? bigint : TConstructor extends typeof Symbol ? symbol : never;
-//#endregion
-export type { AdvancedConverterReturn, BuiltInConverter, BuiltInConverterFunction, ConditionalReturn, ConverterFunction, EnvaptConverter, InferConverterFallbackType, InferConverterReturnType, InferPrimitiveReturnType, JsonValue, MapOfConverterFunctions, PrimitiveConstructor, TimeFallback, TimeUnit };
-//# sourceMappingURL=Conversion.d.mts.map

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

@@ -1,26 +0,0 @@
-//#region src/types/Decorator.d.ts
-/**
- * A legacy (experimentalDecorators) property decorator that also constrains the decorated field's
- * declared type. `Output` is the value the decorator produces. The field must be wide enough to hold
- * it, so a field narrower than `Output` fails to compile while a wider or nullable field is accepted.
- * The tuple wrap stops `Output` from distributing when it is a union.
- * @public
- */
-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;
-/**
- * A modern (TC39 Stage 3) accessor decorator that also constrains the decorated `accessor`'s
- * declared type. `Output` is the value the decorator produces. The accessor must be wide enough to
- * hold it, so an accessor narrower than `Output` fails to compile while a wider or nullable one is
- * accepted. The tuple wrap stops `Output` from distributing when it is a union.
- * @public
- */
-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/workerd/types/Env.d.mts

@@ -1,17 +0,0 @@
-//#region src/types/Env.d.ts
-/**
- * Accepted shape for environment variable lookups. Either a single key or an ordered list of keys.
- * @public
- */
-type EnvKeyInput = string | readonly [string, ...string[]];
-/**
- * @internal
- */
-interface EnvapterService {
-  getRaw(key: EnvKeyInput): string | undefined;
-  get(key: EnvKeyInput, def?: string): string | undefined;
-  isStrict(): boolean;
-}
-//#endregion
-export type { EnvKeyInput, EnvapterService };
-//# sourceMappingURL=Env.d.mts.map

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

@@ -1,39 +0,0 @@
-import { EnvaptConverter } from "./Conversion.mjs";
-import { Environment } from "../core/EnvironmentMethods.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.
- * @public
- */
-interface EnvaptOptions<TFallback = string> {
-  fallback?: TFallback;
-  converter?: EnvaptConverter<TFallback>;
-  required?: boolean;
-}
-/**
- * Per-environment profile entry passed to `Envapter.configureProfiles`.
- * @public
- */
-interface EnvProfile {
-  /** One or more `.env` paths to load for this environment. Order matters: 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`).
- * @public
- */
-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).
-   */
-  useDefaults?: boolean;
-};
-//#endregion
-export type { EnvProfile, EnvaptOptions, ProfilesConfig };
-//# sourceMappingURL=Options.d.mts.map

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

@@ -1,12 +0,0 @@
-import { StandardSchemaV1 } from "../infra/StandardSchema.mjs";
-
-//#region src/types/Schema.d.ts
-declare const _envaptErrBrand: unique symbol;
-type Err<Msg extends string> = Msg & {
-  readonly [_envaptErrBrand]: never;
-};
-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 };
-//# sourceMappingURL=Schema.d.mts.map

package/dist/workerd/types/Source.d.mts

@@ -1,44 +0,0 @@
-//#region src/types/Source.d.ts
-/**
- * A source with no filesystem: an injected object on the browser, or the Cloudflare `env` binding on
- * Workers. The `.env` cascade, profiles, and the `envPaths`/`baseDir`/`configureProfiles` APIs do not
- * apply; only `readVars()` populates the cache.
- * @public
- */
-interface BareEnvSource {
-  /** Return every variable this source provides, as plain strings. */
-  readVars(): Record<string, string>;
-  /** Leave unset (or `false`); a bare source has no filesystem. */
-  readonly supportsFiles?: false;
-}
-/**
- * A filesystem-backed source, like the default {@link NodeEnvSource}. Setting `supportsFiles` to
- * `true` requires all four file capabilities, so the engine can load the `.env` cascade, resolve
- * `baseDir`, and mirror loaded keys back to the ambient environment.
- * @public
- */
-interface FileEnvSource {
-  /** Return every variable this source provides, as plain strings. */
-  readVars(): Record<string, string>;
-  /** When `true`, the engine loads the `.env` cascade, profiles, and `envPaths` through the methods below. */
-  readonly supportsFiles: true;
-  /** Read a file's text, or `undefined` when it is absent or unreadable. Backs the loader and existence checks. */
-  readFile(path: string, encoding: string): string | undefined;
-  /** Join a relative `.env` path onto `baseDir`; absolute paths are returned unchanged. */
-  resolvePath(baseDir: string, candidate: string): string;
-  /** Normalize a `baseDir` value (a directory path, or a module / `file:` URL) to an absolute directory path. */
-  normalizeBaseDir(value: string | URL): string;
-  /** Mirror loaded keys back to the ambient environment (e.g. `process.env`); backs `Envapter.syncProcessEnv`. */
-  writeVars(vars: Record<string, string>): void;
-}
-/**
- * A pluggable source of environment variables. The default {@link NodeEnvSource} (a
- * {@link FileEnvSource}) reads `process.env` plus the `.env` cascade; a {@link BareEnvSource} lets the
- * same engine run where there is no ambient environment (an injected object on the browser, the
- * Cloudflare `env` binding on Workers). Bind one with `Envapter.useSource`.
- * @public
- */
-type EnvSource = BareEnvSource | FileEnvSource;
-//#endregion
-export type { BareEnvSource, EnvSource, FileEnvSource };
-//# sourceMappingURL=Source.d.mts.map