envapt 7.0.0-next.0 → 7.0.0-next.2

package/dist/node/types/Conversion.d.cts

@@ -1,123 +0,0 @@
-import { ArrayOf, ConverterToken, CustomElementConverter } from "../converters/Converters.cjs";
-
-//#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.cts.map

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

@@ -1,125 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-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/node/types/Decorator.d.cts

@@ -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.cts.map

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

@@ -1,28 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-//#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/node/types/Env.d.cts

@@ -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.cts.map

package/dist/node/types/Env.d.mts

@@ -1,19 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-//#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/node/types/Options.d.cts

@@ -1,39 +0,0 @@
-import { EnvaptConverter } from "./Conversion.cjs";
-import { Environment } from "../core/EnvironmentMethods.cjs";
-
-//#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.cts.map

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

@@ -1,41 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-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/node/types/Schema.d.cts

@@ -1,12 +0,0 @@
-import { StandardSchemaV1 } from "../infra/StandardSchema.cjs";
-
-//#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.cts.map

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

@@ -1,14 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-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/node/types/Source.d.cts

@@ -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.cts.map

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

@@ -1,46 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-//#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

package/dist/workerd/converters/Converters.d.mts

@@ -1,93 +0,0 @@
-//#region src/converters/Converters.d.ts
-declare const SCALAR: {
-  readonly String: "string";
-  readonly Number: "number";
-  readonly Boolean: "boolean";
-  readonly Bigint: "bigint";
-  readonly Symbol: "symbol";
-  readonly Integer: "integer";
-  readonly Float: "float";
-  readonly Json: "json";
-  readonly Url: "url";
-  readonly Regexp: "regexp";
-  readonly Date: "date";
-  readonly Time: "time";
-};
-/**
- * String tokens for every built-in scalar converter.
- * @public
- */
-type ConverterToken = (typeof SCALAR)[keyof typeof SCALAR];
-/**
- * Custom element converter for use inside {@link Converters.array}. Receives the trimmed,
- * non-empty raw string for one array slot and returns the parsed value.
- * @public
- */
-type CustomElementConverter<TReturn = unknown> = (raw: string) => TReturn;
-/**
- * Valid element converters for {@link Converters.array}: any scalar token except
- * `json` and `regexp` (those don't compose as array elements), or a custom function.
- * @public
- */
-type ArrayElement = Exclude<ConverterToken, 'json' | 'regexp'> | CustomElementConverter;
-/**
- * Phantom-branded token produced by {@link Converters.array}. The `T` type parameter carries
- * the element converter through any variable indirection so inference survives. The
- * `__envaptKind` discriminant is present at runtime for dispatch.
- * @public
- */
-interface ArrayOf<TElement extends ArrayElement = ArrayElement> {
-  readonly __envaptKind: 'array';
-  readonly of: TElement;
-  readonly delimiter: string;
-}
-/**
- * Runtime type guard for tokens produced by {@link Converters.array}.
- * @internal
- */
-declare function isArrayOf(value: unknown): value is ArrayOf;
-type ArrayScalarElement = Exclude<ConverterToken, 'json' | 'regexp'>;
-declare function buildArrayConverter<TReturn>(opts: {
-  of: CustomElementConverter<TReturn>;
-  delimiter?: string;
-}): ArrayOf<CustomElementConverter<TReturn>>;
-declare function buildArrayConverter<TToken extends ArrayScalarElement>(opts: {
-  of: TToken;
-  delimiter?: string;
-}): ArrayOf<TToken>;
-declare function buildArrayConverter(opts?: {
-  delimiter?: string;
-}): ArrayOf<'string'>;
-/**
- * Built-in converters for environment variables. Use the scalar tokens (e.g. `Converters.Number`)
- * for primitive types and the {@link Converters.array} builder for delimited lists.
- *
- * @example
- * ```ts
- * \@Envapt('PORT', { converter: Converters.Number, fallback: 3000 })
- * static readonly port: number;
- *
- * \@Envapt('TAGS', { converter: Converters.array({ of: Converters.String, delimiter: ' ' }) })
- * static readonly tags: string[];
- * ```
- *
- * @public
- */
-declare const Converters: {
-  readonly array: typeof buildArrayConverter;
-  readonly String: "string";
-  readonly Number: "number";
-  readonly Boolean: "boolean";
-  readonly Bigint: "bigint";
-  readonly Symbol: "symbol";
-  readonly Integer: "integer";
-  readonly Float: "float";
-  readonly Json: "json";
-  readonly Url: "url";
-  readonly Regexp: "regexp";
-  readonly Date: "date";
-  readonly Time: "time";
-};
-//#endregion
-export { ArrayElement, ArrayOf, ConverterToken, Converters, CustomElementConverter, isArrayOf };
-//# sourceMappingURL=Converters.d.mts.map

package/dist/workerd/converters/ValueConverter.d.mts

@@ -1,25 +0,0 @@
-import { EnvaptConverter } from "../types/Conversion.mjs";
-import { StandardSchemaV1 } from "../infra/StandardSchema.mjs";
-import { EnvKeyInput, EnvapterService } from "../types/Env.mjs";
-
-//#region src/converters/ValueConverter.d.ts
-/**
- * Convert a resolved environment value to its declared type via built-in, primitive, array,
- * custom, or Standard Schema converters.
- * @internal
- */
-declare class ValueConverter {
-  private readonly envService;
-  constructor(envService: EnvapterService);
-  convertValue<TFallback>(key: EnvKeyInput, fallback: TFallback | undefined, converter: EnvaptConverter<TFallback> | undefined, hasFallback: boolean): TFallback | null | undefined;
-  private processFallbackForConverter;
-  private convertPrimitiveToString;
-  private processBuiltInConverter;
-  private processArrayConverter;
-  private processCustomConverter;
-  private resolveConverter;
-  convertWithSchema(key: EnvKeyInput, schema: StandardSchemaV1, fallback: unknown, hasFallback: boolean): unknown;
-}
-//#endregion
-export { ValueConverter };
-//# sourceMappingURL=ValueConverter.d.mts.map