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

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # envapt
 
+## 7.0.0-next.1
+
+### Patch Changes
+
+- 0bbcc85: Editor auto-import now suggests each public name once instead of once per runtime build. The published type declarations are emitted as a single shared tree that the Node, Workers, and browser entry points all re-export, so `Envapt`, `Envapter`, the converters, and the rest resolve to one declaration. The Workers and browser entries still expose the portable `Envapter` without the file-only APIs. The package no longer ships the redundant per-runtime declaration trees, so the install is smaller.
+
 ## 7.0.0-next.0
 
 ### Major Changes

package/dist/browser/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/browser.ts"],"sourcesContent":["import { Envapter } from './engine/Envapter';\nimport { installFileApiStubs } from './engine/installFileApiStubs';\n\nexport * from './common';\nexport * from './decorators/modern';\nexport { Envapter };\n\ninstallFileApiStubs();\n"],"mappings":"6mBAOA,EAAoB"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/browser.ts"],"sourcesContent":["import { installFileApiStubs } from './engine/installFileApiStubs';\n\nexport * from './index.portable';\n\ninstallFileApiStubs();\n"],"mappings":"6mBAIA,EAAoB"}

package/dist/{node → types}/engine/NodeEnvapter.d.mts

@@ -1,5 +1,3 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
 import { EnvFileOptions } from "../infra/Dotenv.mjs";
 import { ProfilesConfig } from "../types/Options.mjs";
 import { Envapter } from "./Envapter.mjs";

package/dist/{node → types}/index.d.mts

@@ -1,5 +1,3 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
 import { DebugLevel } from "./infra/Debug.mjs";
 import { EnvFileOptions } from "./infra/Dotenv.mjs";
 import { ArrayElement, ArrayOf, ConverterToken, Converters, CustomElementConverter, isArrayOf } from "./converters/Converters.mjs";

package/dist/{node/sources/NodeEnvSource.d.cts → types/sources/NodeEnvSource.d.mts}

@@ -1,4 +1,4 @@
-import { FileEnvSource } from "../types/Source.cjs";
+import { FileEnvSource } from "../types/Source.mjs";
 
 //#region src/sources/NodeEnvSource.d.ts
 /**
@@ -17,4 +17,4 @@ declare class NodeEnvSource implements FileEnvSource {
 }
 //#endregion
 export { NodeEnvSource };
-//# sourceMappingURL=NodeEnvSource.d.cts.map
+//# sourceMappingURL=NodeEnvSource.d.mts.map

package/package.json

@@ -1,84 +1,84 @@
 {
   "name": "envapt",
   "type": "module",
-  "version": "7.0.0-next.0",
+  "version": "7.0.0-next.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/node/index.d.mts",
+  "types": "./dist/types/index.d.mts",
   "exports": {
     ".": {
       "workerd": {
-        "types": "./dist/workerd/index.d.mts",
+        "types": "./dist/types/index.portable.d.mts",
         "default": "./dist/workerd/index.mjs"
       },
       "browser": {
-        "types": "./dist/browser/index.d.mts",
+        "types": "./dist/types/index.portable.d.mts",
         "default": "./dist/browser/index.mjs"
       },
       "node": {
         "import": {
-          "types": "./dist/node/index.d.mts",
+          "types": "./dist/types/index.d.mts",
           "default": "./dist/node/index.mjs"
         },
         "require": {
-          "types": "./dist/node/index.d.cts",
+          "types": "./dist/types/index.d.mts",
           "default": "./dist/node/index.cjs"
         }
       },
       "default": {
         "import": {
-          "types": "./dist/node/index.d.mts",
+          "types": "./dist/types/index.d.mts",
           "default": "./dist/node/index.mjs"
         },
         "require": {
-          "types": "./dist/node/index.d.cts",
+          "types": "./dist/types/index.d.mts",
           "default": "./dist/node/index.cjs"
         }
       }
     },
     "./workerd": {
-      "types": "./dist/workerd/index.d.mts",
+      "types": "./dist/types/index.portable.d.mts",
       "default": "./dist/workerd/index.mjs"
     },
     "./browser": {
-      "types": "./dist/browser/index.d.mts",
+      "types": "./dist/types/index.portable.d.mts",
       "default": "./dist/browser/index.mjs"
     },
     "./config": {
       "import": {
-        "types": "./dist/node/config.d.mts",
+        "types": "./dist/types/config.d.mts",
         "default": "./dist/node/config.mjs"
       },
       "require": {
-        "types": "./dist/node/config.d.cts",
+        "types": "./dist/types/config.d.mts",
         "default": "./dist/node/config.cjs"
       }
     },
     "./legacy": {
       "workerd": {
-        "types": "./dist/workerd/legacy.d.mts",
+        "types": "./dist/types/legacy.d.mts",
         "default": "./dist/workerd/legacy.mjs"
       },
       "browser": {
-        "types": "./dist/browser/legacy.d.mts",
+        "types": "./dist/types/legacy.d.mts",
         "default": "./dist/browser/legacy.mjs"
       },
       "node": {
         "import": {
-          "types": "./dist/node/legacy.d.mts",
+          "types": "./dist/types/legacy.d.mts",
           "default": "./dist/node/legacy.mjs"
         },
         "require": {
-          "types": "./dist/node/legacy.d.cts",
+          "types": "./dist/types/legacy.d.mts",
           "default": "./dist/node/legacy.cjs"
         }
       },
       "default": {
         "import": {
-          "types": "./dist/node/legacy.d.mts",
+          "types": "./dist/types/legacy.d.mts",
           "default": "./dist/node/legacy.mjs"
         },
         "require": {
-          "types": "./dist/node/legacy.d.cts",
+          "types": "./dist/types/legacy.d.mts",
           "default": "./dist/node/legacy.cjs"
         }
       }
@@ -91,7 +91,10 @@
     "./dist/workerd/index.mjs"
   ],
   "files": [
-    "dist",
+    "dist/**/*.mjs",
+    "dist/**/*.cjs",
+    "dist/**/*.map",
+    "dist/types",
     "NOTICE.md",
     "LICENSE",
     "README.md",
@@ -168,6 +171,7 @@
     "test:workers": "tsc --noEmit -p tests/workers/tsconfig.json && vitest run --config vitest.workers.config.ts",
     "test:browser": "tsc --noEmit -p tests/browser/tsconfig.json && vitest run --config vitest.browser.config.ts",
     "test:consumer-build": "node tests/consumer-build/run.mjs",
+    "test:exports-dedup": "node tests/exports-dedup/run.mjs",
     "test:tsc-emit": "node tests/tsc-emit/run.mjs",
     "test:stage3-emit": "node tests/stage3-emit/run.mjs",
     "test:all": "node ../../scripts/test-all.mjs",

package/dist/node/config.d.mts

@@ -1,2 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';

package/dist/node/converters/Converters.d.cts

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

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

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

@@ -1,25 +0,0 @@
-import { EnvaptConverter } from "../types/Conversion.cjs";
-import { StandardSchemaV1 } from "../infra/StandardSchema.cjs";
-import { EnvKeyInput, EnvapterService } from "../types/Env.cjs";
-
-//#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.cts.map

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

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

package/dist/node/core/AdvancedMethods.d.cts

@@ -1,76 +0,0 @@
-import { ArrayOf } from "../converters/Converters.cjs";
-import { AdvancedConverterReturn, BuiltInConverter, ConditionalReturn, ConverterFunction, InferConverterReturnType, TimeFallback } from "../types/Conversion.cjs";
-import { InferSchemaOutput, StandardSchemaV1 } from "../infra/StandardSchema.cjs";
-import { SchemaConstraint } from "../types/Schema.cjs";
-import { EnvKeyInput } from "../types/Env.cjs";
-import { PrimitiveMethods } from "./PrimitiveMethods.cjs";
-
-//#region src/core/AdvancedMethods.d.ts
-interface GetUsingRequiredOptions<TConverter> {
-  converter: TConverter;
-  required: true;
-}
-interface GetWithRequiredOptions<TReturnType> {
-  converter: ConverterFunction<TReturnType>;
-  required: true;
-}
-/**
- * Mixin for advanced methods for environment variable conversion using built-in and custom converters
- * @internal
- */
-declare class AdvancedMethods extends PrimitiveMethods {
-  /**
-   * Get an environment variable using a built-in converter.
-   *
-   * Supports both scalar tokens (e.g. `Converters.Number`) and `ArrayOf<...>` tokens
-   * produced by `Converters.array(...)`. The key can be a single name or an ordered list;
-   * the first defined value wins.
-   */
-  static getUsing<TFallback extends TimeFallback | undefined = undefined>(key: EnvKeyInput, converter: 'time', fallback?: TFallback): ConditionalReturn<number, TFallback>;
-  static getUsing<TConverter extends BuiltInConverter | ArrayOf, TFallback = undefined>(key: EnvKeyInput, converter: TConverter, fallback?: TFallback): AdvancedConverterReturn<TConverter, TFallback>;
-  static getUsing<TReturn>(key: EnvKeyInput, converter: BuiltInConverter | ArrayOf, fallback?: TReturn): TReturn;
-  static getUsing(key: EnvKeyInput, options: GetUsingRequiredOptions<'time'>): number;
-  static getUsing<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: GetUsingRequiredOptions<TConverter>): InferConverterReturnType<TConverter>;
-  /**
-   * @see {@link AdvancedMethods.getUsing}
-   */
-  getUsing<TFallback extends TimeFallback | undefined = undefined>(key: EnvKeyInput, converter: 'time', fallback?: TFallback): ConditionalReturn<number, TFallback>;
-  getUsing<TConverter extends BuiltInConverter | ArrayOf, TFallback = undefined>(key: EnvKeyInput, converter: TConverter, fallback?: TFallback): AdvancedConverterReturn<TConverter, TFallback>;
-  getUsing<TReturn>(key: EnvKeyInput, converter: BuiltInConverter | ArrayOf, fallback?: TReturn): TReturn;
-  getUsing(key: EnvKeyInput, options: GetUsingRequiredOptions<'time'>): number;
-  getUsing<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: GetUsingRequiredOptions<TConverter>): InferConverterReturnType<TConverter>;
-  /**
-   * Get an environment variable using a custom converter function.
-   * Accepts a single key or an ordered list for automatic fallback.
-   */
-  static getWith<TReturnType, TFallback extends TReturnType | undefined = undefined>(key: EnvKeyInput, converter: ConverterFunction<TReturnType>, fallback?: TFallback): ConditionalReturn<TReturnType, TFallback>;
-  static getWith<TReturnType>(key: EnvKeyInput, options: GetWithRequiredOptions<TReturnType>): TReturnType;
-  /**
-   * @see {@link AdvancedMethods.getWith}
-   */
-  getWith<TReturnType, TFallback extends TReturnType | undefined = undefined>(key: EnvKeyInput, converter: ConverterFunction<TReturnType>, fallback?: TFallback): ConditionalReturn<TReturnType, TFallback>;
-  getWith<TReturnType>(key: EnvKeyInput, options: GetWithRequiredOptions<TReturnType>): TReturnType;
-  /**
-   * Validate an environment variable through a {@link StandardSchemaV1}-conformant schema
-   * (zod, valibot, arktype, etc). Throws `MissingEnvValue` if the env value is absent and
-   * no fallback is provided. The fallback, when provided, is returned as-is on missing;
-   * it does NOT pass through the schema (mirrors custom-converter behavior).
-   *
-   * Synchronous schemas only. A Promise-returning `validate` triggers an
-   * `InvalidUserDefinedConfig` throw at the call site.
-   *
-   * @example
-   * ```ts
-   * import { z } from 'zod';
-   * const port = Envapter.parse('PORT', z.coerce.number().min(1024).max(65535), 3000);
-   * ```
-   */
-  static parse<Schema extends StandardSchemaV1>(key: EnvKeyInput, schema: SchemaConstraint<Schema>, fallback?: InferSchemaOutput<Schema>): InferSchemaOutput<Schema>;
-  /**
-   * @see {@link AdvancedMethods.parse}
-   */
-  parse<Schema extends StandardSchemaV1>(key: EnvKeyInput, schema: SchemaConstraint<Schema>, fallback?: InferSchemaOutput<Schema>): InferSchemaOutput<Schema>;
-}
-//#endregion
-export { AdvancedMethods };
-//# sourceMappingURL=AdvancedMethods.d.cts.map

package/dist/node/core/AdvancedMethods.d.mts

@@ -1,78 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { ArrayOf } from "../converters/Converters.mjs";
-import { AdvancedConverterReturn, BuiltInConverter, ConditionalReturn, ConverterFunction, InferConverterReturnType, TimeFallback } from "../types/Conversion.mjs";
-import { InferSchemaOutput, StandardSchemaV1 } from "../infra/StandardSchema.mjs";
-import { SchemaConstraint } from "../types/Schema.mjs";
-import { EnvKeyInput } from "../types/Env.mjs";
-import { PrimitiveMethods } from "./PrimitiveMethods.mjs";
-
-//#region src/core/AdvancedMethods.d.ts
-interface GetUsingRequiredOptions<TConverter> {
-  converter: TConverter;
-  required: true;
-}
-interface GetWithRequiredOptions<TReturnType> {
-  converter: ConverterFunction<TReturnType>;
-  required: true;
-}
-/**
- * Mixin for advanced methods for environment variable conversion using built-in and custom converters
- * @internal
- */
-declare class AdvancedMethods extends PrimitiveMethods {
-  /**
-   * Get an environment variable using a built-in converter.
-   *
-   * Supports both scalar tokens (e.g. `Converters.Number`) and `ArrayOf<...>` tokens
-   * produced by `Converters.array(...)`. The key can be a single name or an ordered list;
-   * the first defined value wins.
-   */
-  static getUsing<TFallback extends TimeFallback | undefined = undefined>(key: EnvKeyInput, converter: 'time', fallback?: TFallback): ConditionalReturn<number, TFallback>;
-  static getUsing<TConverter extends BuiltInConverter | ArrayOf, TFallback = undefined>(key: EnvKeyInput, converter: TConverter, fallback?: TFallback): AdvancedConverterReturn<TConverter, TFallback>;
-  static getUsing<TReturn>(key: EnvKeyInput, converter: BuiltInConverter | ArrayOf, fallback?: TReturn): TReturn;
-  static getUsing(key: EnvKeyInput, options: GetUsingRequiredOptions<'time'>): number;
-  static getUsing<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: GetUsingRequiredOptions<TConverter>): InferConverterReturnType<TConverter>;
-  /**
-   * @see {@link AdvancedMethods.getUsing}
-   */
-  getUsing<TFallback extends TimeFallback | undefined = undefined>(key: EnvKeyInput, converter: 'time', fallback?: TFallback): ConditionalReturn<number, TFallback>;
-  getUsing<TConverter extends BuiltInConverter | ArrayOf, TFallback = undefined>(key: EnvKeyInput, converter: TConverter, fallback?: TFallback): AdvancedConverterReturn<TConverter, TFallback>;
-  getUsing<TReturn>(key: EnvKeyInput, converter: BuiltInConverter | ArrayOf, fallback?: TReturn): TReturn;
-  getUsing(key: EnvKeyInput, options: GetUsingRequiredOptions<'time'>): number;
-  getUsing<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: GetUsingRequiredOptions<TConverter>): InferConverterReturnType<TConverter>;
-  /**
-   * Get an environment variable using a custom converter function.
-   * Accepts a single key or an ordered list for automatic fallback.
-   */
-  static getWith<TReturnType, TFallback extends TReturnType | undefined = undefined>(key: EnvKeyInput, converter: ConverterFunction<TReturnType>, fallback?: TFallback): ConditionalReturn<TReturnType, TFallback>;
-  static getWith<TReturnType>(key: EnvKeyInput, options: GetWithRequiredOptions<TReturnType>): TReturnType;
-  /**
-   * @see {@link AdvancedMethods.getWith}
-   */
-  getWith<TReturnType, TFallback extends TReturnType | undefined = undefined>(key: EnvKeyInput, converter: ConverterFunction<TReturnType>, fallback?: TFallback): ConditionalReturn<TReturnType, TFallback>;
-  getWith<TReturnType>(key: EnvKeyInput, options: GetWithRequiredOptions<TReturnType>): TReturnType;
-  /**
-   * Validate an environment variable through a {@link StandardSchemaV1}-conformant schema
-   * (zod, valibot, arktype, etc). Throws `MissingEnvValue` if the env value is absent and
-   * no fallback is provided. The fallback, when provided, is returned as-is on missing;
-   * it does NOT pass through the schema (mirrors custom-converter behavior).
-   *
-   * Synchronous schemas only. A Promise-returning `validate` triggers an
-   * `InvalidUserDefinedConfig` throw at the call site.
-   *
-   * @example
-   * ```ts
-   * import { z } from 'zod';
-   * const port = Envapter.parse('PORT', z.coerce.number().min(1024).max(65535), 3000);
-   * ```
-   */
-  static parse<Schema extends StandardSchemaV1>(key: EnvKeyInput, schema: SchemaConstraint<Schema>, fallback?: InferSchemaOutput<Schema>): InferSchemaOutput<Schema>;
-  /**
-   * @see {@link AdvancedMethods.parse}
-   */
-  parse<Schema extends StandardSchemaV1>(key: EnvKeyInput, schema: SchemaConstraint<Schema>, fallback?: InferSchemaOutput<Schema>): InferSchemaOutput<Schema>;
-}
-//#endregion
-export { AdvancedMethods };
-//# sourceMappingURL=AdvancedMethods.d.mts.map

package/dist/node/core/EnvapterBase.d.cts

@@ -1,75 +0,0 @@
-import { DebugLevel } from "../infra/Debug.cjs";
-import { EnvFileOptions } from "../infra/Dotenv.cjs";
-import { EnvKeyInput } from "../types/Env.cjs";
-import { EnvSource, FileEnvSource } from "../types/Source.cjs";
-
-//#region src/core/EnvapterBase.d.ts
-/** @internal */
-declare abstract class EnvapterBase {
-  protected static _envPaths: string[];
-  protected static _envPathsExplicitlySet: boolean;
-  protected static _baseDir: string | undefined;
-  protected static _userDefinedEnvFileOptions: EnvFileOptions;
-  protected static _strict: boolean;
-  protected static _syncProcessEnv: boolean;
-  protected static _dotenvAddedKeys: Set<string>;
-  protected static _source: EnvSource;
-  /**
-   * Enable or disable strict mode. Default `false`. Setting refreshes the cache so
-   * previously-cached converted values get re-evaluated under the new rule.
-   */
-  static set strict(value: boolean);
-  static get strict(): boolean;
-  /**
-   * Set the debug log level. Defaults to `silent`. When unset, reads `ENVAPT_DEBUG` from the
-   * bound source on first access; the setter overrides any env-var value. Output goes to stderr
-   * on Node (the console elsewhere), prefixed with `[envapt]`.
-   */
-  static set debug(level: DebugLevel);
-  static get debug(): DebugLevel;
-  /**
-   * Opt-in mirror of dotenv-loaded keys back to `process.env`. Default `false`.
-   *
-   * Only keys the loader actually wrote are mirrored, so collision behavior follows
-   * `envFileOptions.override`: with the default `false`, pre-existing `process.env` values
-   * are preserved; with `true`, the file value wins in both the cache and the mirror.
-   *
-   * Flipping `false → true` mirrors the existing tracked delta immediately (no cache
-   * refresh). Flipping `true → false` is one-way: previously mirrored keys remain in
-   * `process.env` until the process exits.
-   */
-  static set syncProcessEnv(value: boolean);
-  static get syncProcessEnv(): boolean;
-  protected static treatAsMissing(value: string | undefined): boolean;
-  protected static resolveAgainstBase(candidate: string): string;
-  protected static assertFileApiSupported(api: string, source: EnvSource): asserts source is FileEnvSource;
-  protected static sourceFileExists(path: string): boolean;
-  protected static refreshCache(): void;
-  protected static mirrorToProcessEnv(): void;
-  protected static resolveEffectivePaths(): string[];
-  protected static resolveKeyInput(keyInput: EnvKeyInput): {
-    key: string;
-    value: string | undefined;
-  };
-  protected static get config(): Map<string, unknown>;
-  /**
-   * Eagerly load the `.env` cascade now instead of lazily on the first read. Idempotent: a no-op
-   * once the cache is built. Useful before mirroring to `process.env` (see {@link syncProcessEnv}),
-   * which is what the `envapt/config` side-effect entry does.
-   */
-  static load(): void;
-  /**
-   * Bind the environment {@link EnvSource}. On Node the entry binds {@link NodeEnvSource} for you
-   * (a `process.env` snapshot plus the `.env` cascade); on the browser or Workers, pass a
-   * `ManualEnvSource` / `WorkerEnvSource` (or any `EnvSource`) before reading. Clears and rebuilds
-   * the cache.
-   */
-  static useSource(source: EnvSource): void;
-  /**
-   * Read an environment variable as its raw string, skipping parsing and conversion.
-   */
-  getRaw(key: EnvKeyInput): string | undefined;
-}
-//#endregion
-export { EnvapterBase };
-//# sourceMappingURL=EnvapterBase.d.cts.map