@karmaniverous/get-dotenv 6.3.0 → 6.5.0

package/dist/cliHost.d.ts

@@ -2,6 +2,218 @@ import { OptionValues, Command, InferCommandArguments, Option, CommandUnknownOpt
 import { z, ZodObject } from 'zod';
 export { z } from 'zod';
 
+/**
+ * Dotenv provenance model (descriptor-only).
+ *
+ * Requirements addressed:
+ * - Host ctx carries a dotenv provenance mapping describing per-key origin and override history.
+ * - Provenance is descriptor-only (no value payloads).
+ * - Provenance is an ordered stack per key in ascending precedence; the last entry is effective.
+ * - Explicit unsets are represented as `op: 'unset'` without requiring deletion of keys from the env map.
+ */
+/**
+ * Provenance kind for an entry in {@link DotenvProvenance}.
+ *
+ * @public
+ */
+type DotenvProvenanceKind = 'file' | 'config' | 'vars' | 'dynamic';
+/**
+ * Operation represented by a provenance entry.
+ *
+ * @public
+ */
+type DotenvProvenanceOp = 'set' | 'unset';
+/**
+ * Base shape for all provenance entries.
+ *
+ * @public
+ */
+interface DotenvProvenanceEntryBase {
+    /**
+     * The kind of provenance entry.
+     */
+    kind: DotenvProvenanceKind;
+    /**
+     * The operation applied at this layer.
+     */
+    op: DotenvProvenanceOp;
+}
+/**
+ * Provenance entry representing a value sourced from a dotenv file in the cascade.
+ *
+ * @public
+ */
+interface DotenvFileProvenanceEntry extends DotenvProvenanceEntryBase {
+    /** Discriminator. */
+    kind: 'file';
+    /** Global vs env-scoped file. */
+    scope: 'global' | 'env';
+    /** Public vs private file. */
+    privacy: 'public' | 'private';
+    /** Environment name (required when scope is `env`). */
+    env?: string;
+    /**
+     * The corresponding `paths[]` entry as provided by the caller/CLI.
+     * This is not an absolute path by policy.
+     */
+    path: string;
+    /**
+     * The computed dotenv filename token (e.g., `.env`, `.env.dev`, `.env.local`, `.env.dev.local`).
+     */
+    file: string;
+}
+/**
+ * Provenance entry representing a value sourced from config overlays (`vars` / `envVars`).
+ *
+ * @public
+ */
+interface DotenvConfigProvenanceEntry extends DotenvProvenanceEntryBase {
+    /** Discriminator. */
+    kind: 'config';
+    /** Global vs env-scoped config slice. */
+    scope: 'global' | 'env';
+    /** Public vs private on the privacy axis (`local` config maps to `private`). */
+    privacy: 'public' | 'private';
+    /** Environment name (required when scope is `env`). */
+    env?: string;
+    /** Packaged vs project config origin. */
+    configScope: 'packaged' | 'project';
+    /** Public vs local config file. */
+    configPrivacy: 'public' | 'local';
+}
+/**
+ * Provenance entry representing explicit variables overrides.
+ *
+ * Notes:
+ * - This kind represents values injected via `vars` (CLI/programmatic), not dotenv files.
+ *
+ * @public
+ */
+interface DotenvVarsProvenanceEntry extends DotenvProvenanceEntryBase {
+    /** Discriminator. */
+    kind: 'vars';
+}
+/**
+ * Source tier for dynamic variables.
+ *
+ * @public
+ */
+type DotenvDynamicSource = 'config' | 'programmatic' | 'dynamicPath';
+/**
+ * Provenance entry representing dynamic variables.
+ *
+ * @public
+ */
+interface DotenvDynamicProvenanceEntry extends DotenvProvenanceEntryBase {
+    /** Discriminator. */
+    kind: 'dynamic';
+    /** Dynamic source tier. */
+    dynamicSource: DotenvDynamicSource;
+    /**
+     * The `dynamicPath` value as provided by the caller/CLI when `dynamicSource` is `dynamicPath`.
+     * This is not resolved to an absolute path by provenance policy.
+     */
+    dynamicPath?: string;
+}
+/**
+ * Union of all supported provenance entry shapes.
+ *
+ * @public
+ */
+type DotenvProvenanceEntry = DotenvFileProvenanceEntry | DotenvConfigProvenanceEntry | DotenvVarsProvenanceEntry | DotenvDynamicProvenanceEntry;
+/**
+ * Per-key provenance history.
+ *
+ * Each key maps to an array of entries ordered in ascending precedence (lower to higher).
+ *
+ * @public
+ */
+type DotenvProvenance = Record<string, DotenvProvenanceEntry[]>;
+
+/**
+ * Resolved CLI options schema.
+ * For the current step this mirrors the RAW schema; later stages may further
+ * narrow types post-resolution in the host pipeline.
+ */
+/**
+ * CLI options schema (resolved).
+ *
+ * Today this mirrors {@link getDotenvCliOptionsSchemaRaw}, but is kept as a distinct export
+ * so future resolution steps can narrow or materialize defaults without breaking the API.
+ *
+ * @public
+ */
+declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
+    defaultEnv: z.ZodOptional<z.ZodString>;
+    dotenvToken: z.ZodOptional<z.ZodString>;
+    dynamicPath: z.ZodOptional<z.ZodString>;
+    dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    env: z.ZodOptional<z.ZodString>;
+    excludeDynamic: z.ZodOptional<z.ZodBoolean>;
+    excludeEnv: z.ZodOptional<z.ZodBoolean>;
+    excludeGlobal: z.ZodOptional<z.ZodBoolean>;
+    excludePrivate: z.ZodOptional<z.ZodBoolean>;
+    excludePublic: z.ZodOptional<z.ZodBoolean>;
+    loadProcess: z.ZodOptional<z.ZodBoolean>;
+    log: z.ZodOptional<z.ZodBoolean>;
+    logger: z.ZodDefault<z.ZodUnknown>;
+    outputPath: z.ZodOptional<z.ZodString>;
+    privateToken: z.ZodOptional<z.ZodString>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+    strict: z.ZodOptional<z.ZodBoolean>;
+    capture: z.ZodOptional<z.ZodBoolean>;
+    trace: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+    redact: z.ZodOptional<z.ZodBoolean>;
+    warnEntropy: z.ZodOptional<z.ZodBoolean>;
+    entropyThreshold: z.ZodOptional<z.ZodNumber>;
+    entropyMinLength: z.ZodOptional<z.ZodNumber>;
+    entropyWhitelist: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    redactPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    paths: z.ZodOptional<z.ZodString>;
+    pathsDelimiter: z.ZodOptional<z.ZodString>;
+    pathsDelimiterPattern: z.ZodOptional<z.ZodString>;
+    scripts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    shell: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    vars: z.ZodOptional<z.ZodString>;
+    varsAssignor: z.ZodOptional<z.ZodString>;
+    varsAssignorPattern: z.ZodOptional<z.ZodString>;
+    varsDelimiter: z.ZodOptional<z.ZodString>;
+    varsDelimiterPattern: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+
+/**
+ * Resolved programmatic options schema (post-inheritance).
+ * For now, this mirrors the RAW schema; future stages may materialize defaults
+ * and narrow shapes as resolution is wired into the host.
+ */
+/**
+ * Programmatic options schema (resolved).
+ *
+ * Today this mirrors {@link getDotenvOptionsSchemaRaw}, but is kept as a distinct export
+ * so future resolution steps can narrow or materialize defaults without breaking the API.
+ *
+ * @public
+ */
+declare const getDotenvOptionsSchemaResolved: z.ZodObject<{
+    defaultEnv: z.ZodOptional<z.ZodString>;
+    dotenvToken: z.ZodOptional<z.ZodString>;
+    dynamicPath: z.ZodOptional<z.ZodString>;
+    dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    env: z.ZodOptional<z.ZodString>;
+    excludeDynamic: z.ZodOptional<z.ZodBoolean>;
+    excludeEnv: z.ZodOptional<z.ZodBoolean>;
+    excludeGlobal: z.ZodOptional<z.ZodBoolean>;
+    excludePrivate: z.ZodOptional<z.ZodBoolean>;
+    excludePublic: z.ZodOptional<z.ZodBoolean>;
+    loadProcess: z.ZodOptional<z.ZodBoolean>;
+    log: z.ZodOptional<z.ZodBoolean>;
+    logger: z.ZodDefault<z.ZodUnknown>;
+    outputPath: z.ZodOptional<z.ZodString>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    privateToken: z.ZodOptional<z.ZodString>;
+    vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodString>>>;
+}, z.core.$strip>;
+
 /**
  * Minimal root options shape shared by CLI and generator layers.
  * Keep keys optional to respect exactOptionalPropertyTypes semantics.
@@ -121,6 +333,12 @@ interface GetDotenvCliCtx<TOptions extends GetDotenvOptions = GetDotenvOptions>
      * Final composed dotenv environment for this invocation.
      */
     dotenv: ProcessEnv;
+    /**
+     * Dotenv provenance history for {@link GetDotenvCliCtx.dotenv}.
+     *
+     * Descriptor-only: does not include value payloads.
+     */
+    dotenvProvenance: DotenvProvenance;
     /**
      * Optional runtime plugin state bag. Plugins may publish non-sensitive metadata here.
      */
@@ -148,100 +366,6 @@ interface BrandOptions {
     helpHeader?: string;
 }
 
-/**
- * Resolved CLI options schema.
- * For the current step this mirrors the RAW schema; later stages may further
- * narrow types post-resolution in the host pipeline.
- */
-/**
- * CLI options schema (resolved).
- *
- * Today this mirrors {@link getDotenvCliOptionsSchemaRaw}, but is kept as a distinct export
- * so future resolution steps can narrow or materialize defaults without breaking the API.
- *
- * @public
- */
-declare const getDotenvCliOptionsSchemaResolved: z.ZodObject<{
-    defaultEnv: z.ZodOptional<z.ZodString>;
-    dotenvToken: z.ZodOptional<z.ZodString>;
-    dynamicPath: z.ZodOptional<z.ZodString>;
-    dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    env: z.ZodOptional<z.ZodString>;
-    excludeDynamic: z.ZodOptional<z.ZodBoolean>;
-    excludeEnv: z.ZodOptional<z.ZodBoolean>;
-    excludeGlobal: z.ZodOptional<z.ZodBoolean>;
-    excludePrivate: z.ZodOptional<z.ZodBoolean>;
-    excludePublic: z.ZodOptional<z.ZodBoolean>;
-    loadProcess: z.ZodOptional<z.ZodBoolean>;
-    log: z.ZodOptional<z.ZodBoolean>;
-    logger: z.ZodDefault<z.ZodUnknown>;
-    outputPath: z.ZodOptional<z.ZodString>;
-    privateToken: z.ZodOptional<z.ZodString>;
-    debug: z.ZodOptional<z.ZodBoolean>;
-    strict: z.ZodOptional<z.ZodBoolean>;
-    capture: z.ZodOptional<z.ZodBoolean>;
-    trace: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
-    redact: z.ZodOptional<z.ZodBoolean>;
-    warnEntropy: z.ZodOptional<z.ZodBoolean>;
-    entropyThreshold: z.ZodOptional<z.ZodNumber>;
-    entropyMinLength: z.ZodOptional<z.ZodNumber>;
-    entropyWhitelist: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    redactPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    paths: z.ZodOptional<z.ZodString>;
-    pathsDelimiter: z.ZodOptional<z.ZodString>;
-    pathsDelimiterPattern: z.ZodOptional<z.ZodString>;
-    scripts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    shell: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
-    vars: z.ZodOptional<z.ZodString>;
-    varsAssignor: z.ZodOptional<z.ZodString>;
-    varsAssignorPattern: z.ZodOptional<z.ZodString>;
-    varsDelimiter: z.ZodOptional<z.ZodString>;
-    varsDelimiterPattern: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-
-/**
- * Resolved programmatic options schema (post-inheritance).
- * For now, this mirrors the RAW schema; future stages may materialize defaults
- * and narrow shapes as resolution is wired into the host.
- */
-/**
- * Programmatic options schema (resolved).
- *
- * Today this mirrors {@link getDotenvOptionsSchemaRaw}, but is kept as a distinct export
- * so future resolution steps can narrow or materialize defaults without breaking the API.
- *
- * @public
- */
-declare const getDotenvOptionsSchemaResolved: z.ZodObject<{
-    defaultEnv: z.ZodOptional<z.ZodString>;
-    dotenvToken: z.ZodOptional<z.ZodString>;
-    dynamicPath: z.ZodOptional<z.ZodString>;
-    dynamic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    env: z.ZodOptional<z.ZodString>;
-    excludeDynamic: z.ZodOptional<z.ZodBoolean>;
-    excludeEnv: z.ZodOptional<z.ZodBoolean>;
-    excludeGlobal: z.ZodOptional<z.ZodBoolean>;
-    excludePrivate: z.ZodOptional<z.ZodBoolean>;
-    excludePublic: z.ZodOptional<z.ZodBoolean>;
-    loadProcess: z.ZodOptional<z.ZodBoolean>;
-    log: z.ZodOptional<z.ZodBoolean>;
-    logger: z.ZodDefault<z.ZodUnknown>;
-    outputPath: z.ZodOptional<z.ZodString>;
-    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    privateToken: z.ZodOptional<z.ZodString>;
-    vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodString>>>;
-}, z.core.$strip>;
-
-/**
- * Canonical programmatic options and helpers for get-dotenv.
- *
- * Requirements addressed:
- * - GetDotenvOptions derives from the Zod schema output (single source of truth).
- * - Removed deprecated/compat flags from the public shape (e.g., useConfigLoader).
- * - Provide Vars-aware defineDynamic and a typed config builder defineGetDotenvConfig\<Vars, Env\>().
- * - Preserve existing behavior for defaults resolution and compat converters.
- */
-
 /**
  * A minimal representation of an environment key/value mapping.
  * Values may be `undefined` to represent "unset".
@@ -520,6 +644,16 @@ declare function definePlugin<TOptions extends GetDotenvOptions, Schema extends
 }): PluginWithInstanceHelpers<TOptions, z.output<Schema>>;
 declare function definePlugin<TOptions extends GetDotenvOptions>(spec: DefineSpec<TOptions>): PluginWithInstanceHelpers<TOptions, {}>;
 
+/**
+ * Non-interactive confirm guard for destructive ops.
+ * Returns true when force is provided; otherwise warns and sets exitCode.
+ *
+ * @param force - The force flag value (truthy allows proceed).
+ * @param op - Operation name for the warning message.
+ * @param flag - The flag name to suggest in the warning message (default: '--force').
+ */
+declare function ensureForce(force: unknown, op: string, flag?: string): boolean;
+
 /**
  * Helper to decide whether to capture child stdio.
  * Checks GETDOTENV_STDIO env var or the provided bag capture flag.
@@ -825,6 +959,33 @@ interface GroupPluginsOptions<TOptions extends GetDotenvOptions = GetDotenvOptio
  */
 declare function groupPlugins<TOptions extends GetDotenvOptions = GetDotenvOptions>(options: GroupPluginsOptions<TOptions>): PluginWithInstanceHelpers<TOptions, {}>;
 
+/**
+ * Return type for {@link describeConfigKeyListDefaults}.
+ *
+ * @public
+ */
+interface DescribeConfigKeyListDefaultsResult {
+    /** Description for the include list default. */
+    includeDefault: string;
+    /** Description for the exclude list default. */
+    excludeDefault: string;
+}
+/**
+ * Describe a default value for help text.
+ * Handles arrays (joins with space) and strings; returns 'none' if empty/undefined.
+ */
+declare const describeDefault: (v: unknown) => string;
+/**
+ * Describe default values for a pair of include/exclude list options.
+ * Returns an object with `includeDefault` and `excludeDefault` strings.
+ *
+ * If both lists are populated, returns an invalid marker for both.
+ */
+declare const describeConfigKeyListDefaults: ({ cfgInclude, cfgExclude, }: {
+    cfgInclude?: string[];
+    cfgExclude?: string[];
+}) => DescribeConfigKeyListDefaultsResult;
+
 /** src/cliHost/invoke.ts
  * Shared helpers for composing child env overlays and preserving argv for Node -e.
  */
@@ -837,7 +998,7 @@ declare function groupPlugins<TOptions extends GetDotenvOptions = GetDotenvOptio
  * @param dotenv - Composed dotenv variables for the current invocation.
  * @returns A string-only env overlay suitable for child process spawning.
  */
-declare function composeNestedEnv(merged: GetDotenvCliOptions | Record<string, unknown>, dotenv: Record<string, string | undefined>): Record<string, string>;
+declare function composeNestedEnv(merged: GetDotenvCliOptions | Record<string, unknown>, dotenv: ProcessEnv): Record<string, string>;
 /**
  * Strip one layer of symmetric outer quotes (single or double) from a string.
  *
@@ -952,7 +1113,7 @@ declare const resolveCliOptions: <T extends ResolveCliOptionsShape>(rawCliOption
  * @param base - Base environment (usually `process.env`).
  * @param overlay - Environment variables to overlay.
  */
-declare const buildSpawnEnv: (base?: NodeJS.ProcessEnv, overlay?: Record<string, string | undefined>) => NodeJS.ProcessEnv;
+declare const buildSpawnEnv: (base?: NodeJS.ProcessEnv, overlay?: ProcessEnv) => NodeJS.ProcessEnv;
 
-export { GetDotenvCli, baseGetDotenvCliOptions, buildSpawnEnv, composeNestedEnv, definePlugin, defineScripts, getRootCommand, groupPlugins, maybePreserveNodeEvalArgv, readMergedOptions, resolveCliOptions, resolveCommand, resolveShell, runCommand, runCommandResult, shouldCapture, stripOne, toHelpConfig };
+export { GetDotenvCli, baseGetDotenvCliOptions, buildSpawnEnv, composeNestedEnv, definePlugin, defineScripts, describeConfigKeyListDefaults, describeDefault, ensureForce, getRootCommand, groupPlugins, maybePreserveNodeEvalArgv, readMergedOptions, resolveCliOptions, resolveCommand, resolveShell, runCommand, runCommandResult, shouldCapture, stripOne, toHelpConfig };
 export type { BrandOptions, DefineSpec, GetDotenvCliCtx, GetDotenvCliOptions, GetDotenvCliPlugin, GetDotenvCliPublic, GroupPluginsOptions, InferPluginConfig, PluginChildEntry, PluginFlattenedEntry, PluginNamespaceOverride, PluginWithInstanceHelpers, ResolveAndLoadOptions, ResolveCliOptionsResult, ResolvedHelpConfig, RootOptionsShape, RunCommandOptions, RunCommandResultOptions, ScriptDef, Scripts, ScriptsTable };

package/dist/cliHost.mjs

@@ -1,25 +1,43 @@
-export { G as GetDotenvCli, d as definePlugin, r as readMergedOptions } from './chunks/readMergedOptions-DLBDzpXX.mjs';
-export { d as buildSpawnEnv, b as resolveCommand, c as resolveShell, r as runCommand, a as runCommandResult, s as shouldCapture } from './chunks/spawnEnv-CQwFu7ZJ.mjs';
-export { b as baseGetDotenvCliOptions, r as resolveCliOptions } from './chunks/resolveCliOptions-_qtsVxda.mjs';
-export { d as defineScripts, g as groupPlugins } from './chunks/types-DdqcXCV1.mjs';
+export { G as GetDotenvCli, d as definePlugin, r as readMergedOptions } from './chunks/readMergedOptions-DLRFU2qO.mjs';
+export { d as buildSpawnEnv, b as resolveCommand, c as resolveShell, r as runCommand, a as runCommandResult, s as shouldCapture } from './chunks/spawnEnv-5kdIVv0x.mjs';
+export { b as baseGetDotenvCliOptions, r as resolveCliOptions } from './chunks/resolveCliOptions-C6oeNl9S.mjs';
+export { d as defineScripts, g as groupPlugins } from './chunks/types-BC96rfQj.mjs';
 export { t as toHelpConfig } from './chunks/helpConfig-CGejgwWW.mjs';
 export { c as composeNestedEnv, m as maybePreserveNodeEvalArgv, s as stripOne } from './chunks/invoke-DuRPU1oC.mjs';
 export { z } from 'zod';
 import '@commander-js/extra-typings';
-import './chunks/overlayEnv-Bqh_kPGA.mjs';
+import './chunks/readDotenvCascade-Bymjvyit.mjs';
 import 'fs-extra';
+import 'radash';
+import 'node:buffer';
 import 'node:path';
 import './chunks/loadModuleDefault-Dj8B3Stt.mjs';
 import 'crypto';
 import 'path';
 import 'url';
-import 'nanoid';
 import 'dotenv';
-import './chunks/loader-CePOf74i.mjs';
+import 'nanoid';
+import './chunks/loader-CE4HSRN4.mjs';
 import 'package-directory';
 import 'yaml';
 import 'execa';
 
+/**
+ * Non-interactive confirm guard for destructive ops.
+ * Returns true when force is provided; otherwise warns and sets exitCode.
+ *
+ * @param force - The force flag value (truthy allows proceed).
+ * @param op - Operation name for the warning message.
+ * @param flag - The flag name to suggest in the warning message (default: '--force').
+ */
+function ensureForce(force, op, flag = '--force') {
+    if (force)
+        return true;
+    console.warn(`${op} requires confirmation. Re-run with ${flag} to proceed.`);
+    process.exitCode = 2;
+    return false;
+}
+
 /**
  * Return the top-level root command for a given mount or action's thisCommand.
  *
@@ -33,4 +51,33 @@ const getRootCommand = (cmd) => {
     return node;
 };
 
-export { getRootCommand };
+/**
+ * Describe a default value for help text.
+ * Handles arrays (joins with space) and strings; returns 'none' if empty/undefined.
+ */
+const describeDefault = (v) => {
+    if (Array.isArray(v))
+        return v.length ? v.join(' ') : 'none';
+    if (typeof v === 'string' && v.trim())
+        return v;
+    return 'none';
+};
+/**
+ * Describe default values for a pair of include/exclude list options.
+ * Returns an object with `includeDefault` and `excludeDefault` strings.
+ *
+ * If both lists are populated, returns an invalid marker for both.
+ */
+const describeConfigKeyListDefaults = ({ cfgInclude, cfgExclude, }) => {
+    // Avoid throwing in help rendering: show an explicit invalid marker.
+    if (cfgInclude?.length && cfgExclude?.length) {
+        const msg = '(invalid: both set in config)';
+        return { includeDefault: msg, excludeDefault: msg };
+    }
+    return {
+        includeDefault: describeDefault(cfgExclude?.length ? undefined : cfgInclude),
+        excludeDefault: describeDefault(cfgInclude?.length ? undefined : cfgExclude),
+    };
+};
+
+export { describeConfigKeyListDefaults, describeDefault, ensureForce, getRootCommand };

package/dist/config.d.ts

@@ -99,16 +99,6 @@ interface ScriptDef<TShell extends string | boolean = string | boolean> {
  */
 type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<string, string | ScriptDef<TShell>>;
 
-/**
- * Canonical programmatic options and helpers for get-dotenv.
- *
- * Requirements addressed:
- * - GetDotenvOptions derives from the Zod schema output (single source of truth).
- * - Removed deprecated/compat flags from the public shape (e.g., useConfigLoader).
- * - Provide Vars-aware defineDynamic and a typed config builder defineGetDotenvConfig\<Vars, Env\>().
- * - Preserve existing behavior for defaults resolution and compat converters.
- */
-
 /**
  * A minimal representation of an environment key/value mapping.
  * Values may be `undefined` to represent "unset".

package/dist/config.mjs

@@ -1,4 +1,4 @@
-export { d as discoverConfigFiles, l as loadConfigFile, r as resolveGetDotenvConfigSources, t as toFileUrl } from './chunks/loader-CePOf74i.mjs';
+export { d as discoverConfigFiles, l as loadConfigFile, r as resolveGetDotenvConfigSources, t as toFileUrl } from './chunks/loader-CE4HSRN4.mjs';
 export { v as validateEnvAgainstSources } from './chunks/validate-CDl0rE6k.mjs';
 import 'fs-extra';
 import 'package-directory';
@@ -6,6 +6,9 @@ import 'path';
 import 'url';
 import 'yaml';
 import 'zod';
+import 'radash';
+import 'node:buffer';
 import 'node:path';
 import './chunks/loadModuleDefault-Dj8B3Stt.mjs';
 import 'crypto';
+import '@commander-js/extra-typings';