@karmaniverous/get-dotenv 5.0.0-0 → 5.0.0-2

package/dist/cliHost.cjs

@@ -100,10 +100,7 @@ const defaultsDeep = (...layers) => {
 };
 
 // src/GetDotenvOptions.ts
-const getDotenvOptionsFilename = 'getdotenv.config.json'; /**
- * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
+const getDotenvOptionsFilename = 'getdotenv.config.json';
 /**
  * Converts programmatic CLI options to `getDotenv` options. *
  * @param cliOptions - CLI options. Defaults to `{}`.
@@ -114,8 +111,7 @@ const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPatt
     /**
      * Convert CLI-facing string options into {@link GetDotenvOptions}.
      *
-     * - Splits {@link GetDotenvCliOptions.paths} using either a delimiter
-     *   or a regular expression pattern into a string array.   * - Parses {@link GetDotenvCliOptions.vars} as space-separated `KEY=VALUE`
+     * - Splits {@link GetDotenvCliOptions.paths} using either a delimiter   *   or a regular expression pattern into a string array.   * - Parses {@link GetDotenvCliOptions.vars} as space-separated `KEY=VALUE`
      *   pairs (configurable delimiters) into a {@link ProcessEnv}.
      * - Drops CLI-only keys that have no programmatic equivalent.
      *
@@ -128,21 +124,36 @@ const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPatt
     delete restObj.debug;
     delete restObj.scripts;
     const splitBy = (value, delim, pattern) => (value ? value.split(pattern ? RegExp(pattern) : (delim ?? ' ')) : []);
-    const kvPairs = (vars
-        ? splitBy(vars, varsDelimiter, varsDelimiterPattern).map((v) => v.split(varsAssignorPattern
+    // Tolerate vars as either a CLI string ("A=1 B=2") or an object map.
+    let parsedVars;
+    if (typeof vars === 'string') {
+        const kvPairs = splitBy(vars, varsDelimiter, varsDelimiterPattern).map((v) => v.split(varsAssignorPattern
             ? RegExp(varsAssignorPattern)
-            : (varsAssignor ?? '=')))
-        : []);
-    const parsedVars = Object.fromEntries(kvPairs);
+            : (varsAssignor ?? '=')));
+        parsedVars = Object.fromEntries(kvPairs);
+    }
+    else if (vars && typeof vars === 'object' && !Array.isArray(vars)) {
+        // Keep only string or undefined values to match ProcessEnv.
+        const entries = Object.entries(vars).filter(([k, v]) => typeof k === 'string' && (typeof v === 'string' || v === undefined));
+        parsedVars = Object.fromEntries(entries);
+    }
+    // Drop undefined-valued entries at the converter stage to match ProcessEnv
+    // expectations and the compat test assertions.
+    if (parsedVars) {
+        parsedVars = Object.fromEntries(Object.entries(parsedVars).filter(([, v]) => v !== undefined));
+    }
+    // Tolerate paths as either a delimited string or string[]
+    // Use a locally cast union type to avoid lint warnings about always-falsy conditions
+    // under the RootOptionsShape (which declares paths as string | undefined).
+    const pathsAny = paths;
+    const pathsOut = Array.isArray(pathsAny)
+        ? pathsAny.filter((p) => typeof p === 'string')
+        : splitBy(pathsAny, pathsDelimiter, pathsDelimiterPattern);
     // Preserve exactOptionalPropertyTypes: only include keys when defined.
     return {
         ...restObj,
-        ...(paths !== undefined
-            ? {
-                paths: splitBy(paths, pathsDelimiter, pathsDelimiterPattern),
-            }
-            : {}),
-        ...(vars !== undefined ? { vars: parsedVars } : {}),
+        ...(pathsOut.length > 0 ? { paths: pathsOut } : {}),
+        ...(parsedVars !== undefined ? { vars: parsedVars } : {}),
     };
 };
 const resolveGetDotenvOptions = async (customOptions) => {

package/dist/cliHost.d.cts

@@ -3,9 +3,7 @@ import { Command } from 'commander';
 
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set

package/dist/cliHost.d.mts

@@ -3,9 +3,7 @@ import { Command } from 'commander';
 
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set

package/dist/cliHost.d.ts

@@ -3,9 +3,7 @@ import { Command } from 'commander';
 
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set

package/dist/cliHost.mjs

@@ -97,10 +97,7 @@ const defaultsDeep = (...layers) => {
 };
 
 // src/GetDotenvOptions.ts
-const getDotenvOptionsFilename = 'getdotenv.config.json'; /**
- * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
+const getDotenvOptionsFilename = 'getdotenv.config.json';
 /**
  * Converts programmatic CLI options to `getDotenv` options. *
  * @param cliOptions - CLI options. Defaults to `{}`.
@@ -111,8 +108,7 @@ const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPatt
     /**
      * Convert CLI-facing string options into {@link GetDotenvOptions}.
      *
-     * - Splits {@link GetDotenvCliOptions.paths} using either a delimiter
-     *   or a regular expression pattern into a string array.   * - Parses {@link GetDotenvCliOptions.vars} as space-separated `KEY=VALUE`
+     * - Splits {@link GetDotenvCliOptions.paths} using either a delimiter   *   or a regular expression pattern into a string array.   * - Parses {@link GetDotenvCliOptions.vars} as space-separated `KEY=VALUE`
      *   pairs (configurable delimiters) into a {@link ProcessEnv}.
      * - Drops CLI-only keys that have no programmatic equivalent.
      *
@@ -125,21 +121,36 @@ const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPatt
     delete restObj.debug;
     delete restObj.scripts;
     const splitBy = (value, delim, pattern) => (value ? value.split(pattern ? RegExp(pattern) : (delim ?? ' ')) : []);
-    const kvPairs = (vars
-        ? splitBy(vars, varsDelimiter, varsDelimiterPattern).map((v) => v.split(varsAssignorPattern
+    // Tolerate vars as either a CLI string ("A=1 B=2") or an object map.
+    let parsedVars;
+    if (typeof vars === 'string') {
+        const kvPairs = splitBy(vars, varsDelimiter, varsDelimiterPattern).map((v) => v.split(varsAssignorPattern
             ? RegExp(varsAssignorPattern)
-            : (varsAssignor ?? '=')))
-        : []);
-    const parsedVars = Object.fromEntries(kvPairs);
+            : (varsAssignor ?? '=')));
+        parsedVars = Object.fromEntries(kvPairs);
+    }
+    else if (vars && typeof vars === 'object' && !Array.isArray(vars)) {
+        // Keep only string or undefined values to match ProcessEnv.
+        const entries = Object.entries(vars).filter(([k, v]) => typeof k === 'string' && (typeof v === 'string' || v === undefined));
+        parsedVars = Object.fromEntries(entries);
+    }
+    // Drop undefined-valued entries at the converter stage to match ProcessEnv
+    // expectations and the compat test assertions.
+    if (parsedVars) {
+        parsedVars = Object.fromEntries(Object.entries(parsedVars).filter(([, v]) => v !== undefined));
+    }
+    // Tolerate paths as either a delimited string or string[]
+    // Use a locally cast union type to avoid lint warnings about always-falsy conditions
+    // under the RootOptionsShape (which declares paths as string | undefined).
+    const pathsAny = paths;
+    const pathsOut = Array.isArray(pathsAny)
+        ? pathsAny.filter((p) => typeof p === 'string')
+        : splitBy(pathsAny, pathsDelimiter, pathsDelimiterPattern);
     // Preserve exactOptionalPropertyTypes: only include keys when defined.
     return {
         ...restObj,
-        ...(paths !== undefined
-            ? {
-                paths: splitBy(paths, pathsDelimiter, pathsDelimiterPattern),
-            }
-            : {}),
-        ...(vars !== undefined ? { vars: parsedVars } : {}),
+        ...(pathsOut.length > 0 ? { paths: pathsOut } : {}),
+        ...(parsedVars !== undefined ? { vars: parsedVars } : {}),
     };
 };
 const resolveGetDotenvOptions = async (customOptions) => {

package/dist/env-overlay.d.cts

@@ -1,8 +1,6 @@
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 
 type Scripts = Record<string, string | {
     cmd: string;

package/dist/env-overlay.d.mts

@@ -1,8 +1,6 @@
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 
 type Scripts = Record<string, string | {
     cmd: string;

package/dist/env-overlay.d.ts

@@ -1,8 +1,6 @@
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 
 type Scripts = Record<string, string | {
     cmd: string;

package/dist/getdotenv.cli.mjs

@@ -81,10 +81,7 @@ const defaultsDeep = (...layers) => {
 };
 
 // src/GetDotenvOptions.ts
-const getDotenvOptionsFilename = 'getdotenv.config.json'; /**
- * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
+const getDotenvOptionsFilename = 'getdotenv.config.json';
 /**
  * Converts programmatic CLI options to `getDotenv` options. *
  * @param cliOptions - CLI options. Defaults to `{}`.
@@ -95,8 +92,7 @@ const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPatt
     /**
      * Convert CLI-facing string options into {@link GetDotenvOptions}.
      *
-     * - Splits {@link GetDotenvCliOptions.paths} using either a delimiter
-     *   or a regular expression pattern into a string array.   * - Parses {@link GetDotenvCliOptions.vars} as space-separated `KEY=VALUE`
+     * - Splits {@link GetDotenvCliOptions.paths} using either a delimiter   *   or a regular expression pattern into a string array.   * - Parses {@link GetDotenvCliOptions.vars} as space-separated `KEY=VALUE`
      *   pairs (configurable delimiters) into a {@link ProcessEnv}.
      * - Drops CLI-only keys that have no programmatic equivalent.
      *
@@ -109,21 +105,36 @@ const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPatt
     delete restObj.debug;
     delete restObj.scripts;
     const splitBy = (value, delim, pattern) => (value ? value.split(pattern ? RegExp(pattern) : (delim ?? ' ')) : []);
-    const kvPairs = (vars
-        ? splitBy(vars, varsDelimiter, varsDelimiterPattern).map((v) => v.split(varsAssignorPattern
+    // Tolerate vars as either a CLI string ("A=1 B=2") or an object map.
+    let parsedVars;
+    if (typeof vars === 'string') {
+        const kvPairs = splitBy(vars, varsDelimiter, varsDelimiterPattern).map((v) => v.split(varsAssignorPattern
             ? RegExp(varsAssignorPattern)
-            : (varsAssignor ?? '=')))
-        : []);
-    const parsedVars = Object.fromEntries(kvPairs);
+            : (varsAssignor ?? '=')));
+        parsedVars = Object.fromEntries(kvPairs);
+    }
+    else if (vars && typeof vars === 'object' && !Array.isArray(vars)) {
+        // Keep only string or undefined values to match ProcessEnv.
+        const entries = Object.entries(vars).filter(([k, v]) => typeof k === 'string' && (typeof v === 'string' || v === undefined));
+        parsedVars = Object.fromEntries(entries);
+    }
+    // Drop undefined-valued entries at the converter stage to match ProcessEnv
+    // expectations and the compat test assertions.
+    if (parsedVars) {
+        parsedVars = Object.fromEntries(Object.entries(parsedVars).filter(([, v]) => v !== undefined));
+    }
+    // Tolerate paths as either a delimited string or string[]
+    // Use a locally cast union type to avoid lint warnings about always-falsy conditions
+    // under the RootOptionsShape (which declares paths as string | undefined).
+    const pathsAny = paths;
+    const pathsOut = Array.isArray(pathsAny)
+        ? pathsAny.filter((p) => typeof p === 'string')
+        : splitBy(pathsAny, pathsDelimiter, pathsDelimiterPattern);
     // Preserve exactOptionalPropertyTypes: only include keys when defined.
     return {
         ...restObj,
-        ...(paths !== undefined
-            ? {
-                paths: splitBy(paths, pathsDelimiter, pathsDelimiterPattern),
-            }
-            : {}),
-        ...(vars !== undefined ? { vars: parsedVars } : {}),
+        ...(pathsOut.length > 0 ? { paths: pathsOut } : {}),
+        ...(parsedVars !== undefined ? { vars: parsedVars } : {}),
     };
 };
 const resolveGetDotenvOptions = async (customOptions) => {

package/dist/index.cjs

@@ -498,7 +498,8 @@ const cmdCommand$1 = new commander.Command()
     .description('execute command, conflicts with --command option (default subcommand)')
     .enablePositionalOptions()
     .passThroughOptions()
-    .action(async (_options, thisCommand) => {
+    .argument('[command...]')
+    .action(async (commandParts, _options, thisCommand) => {
     if (!thisCommand.parent)
         throw new Error(`unable to resolve parent command`);
     if (!thisCommand.parent.parent)
@@ -511,7 +512,12 @@ const cmdCommand$1 = new commander.Command()
     const pkgCwd = !!raw.pkgCwd;
     const rootPath = typeof raw.rootPath === 'string' ? raw.rootPath : './';
     // Execute command.
-    const command = thisCommand.args.join(' ');
+    const args = Array.isArray(commandParts) ? commandParts : [];
+    // When no positional tokens are provided (e.g., option form `-c/--command`),
+    // the preSubcommand hook handles execution. Avoid a duplicate call here.
+    if (args.length === 0)
+        return;
+    const command = args.map(String).join(' ');
     await execShellCommandBatch({
         command: resolveCommand(getDotenvCliOptions.scripts, command),
         getDotenvCliOptions,
@@ -578,8 +584,9 @@ const cmdCommand = new commander.Command()
     .configureHelp({ showGlobalOptions: true })
     .enablePositionalOptions()
     .passThroughOptions()
-    .action(async (_options, thisCommand) => {
-    const args = thisCommand.args;
+    .argument('[command...]')
+    .action(async (commandParts, _options, thisCommand) => {
+    const args = Array.isArray(commandParts) ? commandParts : [];
     if (args.length === 0)
         return;
     if (!thisCommand.parent)
@@ -682,10 +689,7 @@ const defaultsDeep = (...layers) => {
 };
 
 // src/GetDotenvOptions.ts
-const getDotenvOptionsFilename = 'getdotenv.config.json'; /**
- * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
+const getDotenvOptionsFilename = 'getdotenv.config.json';
 /**
  * Helper to define a dynamic map with strong inference.
  *
@@ -703,8 +707,7 @@ const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPatt
     /**
      * Convert CLI-facing string options into {@link GetDotenvOptions}.
      *
-     * - Splits {@link GetDotenvCliOptions.paths} using either a delimiter
-     *   or a regular expression pattern into a string array.   * - Parses {@link GetDotenvCliOptions.vars} as space-separated `KEY=VALUE`
+     * - Splits {@link GetDotenvCliOptions.paths} using either a delimiter   *   or a regular expression pattern into a string array.   * - Parses {@link GetDotenvCliOptions.vars} as space-separated `KEY=VALUE`
      *   pairs (configurable delimiters) into a {@link ProcessEnv}.
      * - Drops CLI-only keys that have no programmatic equivalent.
      *
@@ -717,21 +720,36 @@ const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPatt
     delete restObj.debug;
     delete restObj.scripts;
     const splitBy = (value, delim, pattern) => (value ? value.split(pattern ? RegExp(pattern) : (delim ?? ' ')) : []);
-    const kvPairs = (vars
-        ? splitBy(vars, varsDelimiter, varsDelimiterPattern).map((v) => v.split(varsAssignorPattern
+    // Tolerate vars as either a CLI string ("A=1 B=2") or an object map.
+    let parsedVars;
+    if (typeof vars === 'string') {
+        const kvPairs = splitBy(vars, varsDelimiter, varsDelimiterPattern).map((v) => v.split(varsAssignorPattern
             ? RegExp(varsAssignorPattern)
-            : (varsAssignor ?? '=')))
-        : []);
-    const parsedVars = Object.fromEntries(kvPairs);
+            : (varsAssignor ?? '=')));
+        parsedVars = Object.fromEntries(kvPairs);
+    }
+    else if (vars && typeof vars === 'object' && !Array.isArray(vars)) {
+        // Keep only string or undefined values to match ProcessEnv.
+        const entries = Object.entries(vars).filter(([k, v]) => typeof k === 'string' && (typeof v === 'string' || v === undefined));
+        parsedVars = Object.fromEntries(entries);
+    }
+    // Drop undefined-valued entries at the converter stage to match ProcessEnv
+    // expectations and the compat test assertions.
+    if (parsedVars) {
+        parsedVars = Object.fromEntries(Object.entries(parsedVars).filter(([, v]) => v !== undefined));
+    }
+    // Tolerate paths as either a delimited string or string[]
+    // Use a locally cast union type to avoid lint warnings about always-falsy conditions
+    // under the RootOptionsShape (which declares paths as string | undefined).
+    const pathsAny = paths;
+    const pathsOut = Array.isArray(pathsAny)
+        ? pathsAny.filter((p) => typeof p === 'string')
+        : splitBy(pathsAny, pathsDelimiter, pathsDelimiterPattern);
     // Preserve exactOptionalPropertyTypes: only include keys when defined.
     return {
         ...restObj,
-        ...(paths !== undefined
-            ? {
-                paths: splitBy(paths, pathsDelimiter, pathsDelimiterPattern),
-            }
-            : {}),
-        ...(vars !== undefined ? { vars: parsedVars } : {}),
+        ...(pathsOut.length > 0 ? { paths: pathsOut } : {}),
+        ...(parsedVars !== undefined ? { vars: parsedVars } : {}),
     };
 };
 const resolveGetDotenvOptions = async (customOptions) => {

package/dist/index.d.cts

@@ -42,11 +42,13 @@ type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<s
     shell?: TShell;
 }>;
 
+type RootOptionsShapeCompat = Omit<RootOptionsShape, 'vars' | 'paths'> & {
+    vars?: string | Record<string, string | undefined>;
+    paths?: string | string[];
+};
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set
@@ -150,7 +152,7 @@ interface GetDotenvOptions {
  *
  * @returns `getDotenv` options.
  */
-declare const getDotenvCliOptions2Options: ({ paths, pathsDelimiter, pathsDelimiterPattern, vars, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, ...rest }: RootOptionsShape) => GetDotenvOptions;
+declare const getDotenvCliOptions2Options: ({ paths, pathsDelimiter, pathsDelimiterPattern, vars, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, ...rest }: RootOptionsShapeCompat) => GetDotenvOptions;
 
 /**
  * Recursively expands environment variables in a string. Variables may be

package/dist/index.d.mts

@@ -42,11 +42,13 @@ type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<s
     shell?: TShell;
 }>;
 
+type RootOptionsShapeCompat = Omit<RootOptionsShape, 'vars' | 'paths'> & {
+    vars?: string | Record<string, string | undefined>;
+    paths?: string | string[];
+};
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set
@@ -150,7 +152,7 @@ interface GetDotenvOptions {
  *
  * @returns `getDotenv` options.
  */
-declare const getDotenvCliOptions2Options: ({ paths, pathsDelimiter, pathsDelimiterPattern, vars, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, ...rest }: RootOptionsShape) => GetDotenvOptions;
+declare const getDotenvCliOptions2Options: ({ paths, pathsDelimiter, pathsDelimiterPattern, vars, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, ...rest }: RootOptionsShapeCompat) => GetDotenvOptions;
 
 /**
  * Recursively expands environment variables in a string. Variables may be

package/dist/index.d.ts

@@ -42,11 +42,13 @@ type ScriptsTable<TShell extends string | boolean = string | boolean> = Record<s
     shell?: TShell;
 }>;
 
+type RootOptionsShapeCompat = Omit<RootOptionsShape, 'vars' | 'paths'> & {
+    vars?: string | Record<string, string | undefined>;
+    paths?: string | string[];
+};
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set
@@ -150,7 +152,7 @@ interface GetDotenvOptions {
  *
  * @returns `getDotenv` options.
  */
-declare const getDotenvCliOptions2Options: ({ paths, pathsDelimiter, pathsDelimiterPattern, vars, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, ...rest }: RootOptionsShape) => GetDotenvOptions;
+declare const getDotenvCliOptions2Options: ({ paths, pathsDelimiter, pathsDelimiterPattern, vars, varsAssignor, varsAssignorPattern, varsDelimiter, varsDelimiterPattern, ...rest }: RootOptionsShapeCompat) => GetDotenvOptions;
 
 /**
  * Recursively expands environment variables in a string. Variables may be

package/dist/index.mjs

@@ -495,7 +495,8 @@ const cmdCommand$1 = new Command()
     .description('execute command, conflicts with --command option (default subcommand)')
     .enablePositionalOptions()
     .passThroughOptions()
-    .action(async (_options, thisCommand) => {
+    .argument('[command...]')
+    .action(async (commandParts, _options, thisCommand) => {
     if (!thisCommand.parent)
         throw new Error(`unable to resolve parent command`);
     if (!thisCommand.parent.parent)
@@ -508,7 +509,12 @@ const cmdCommand$1 = new Command()
     const pkgCwd = !!raw.pkgCwd;
     const rootPath = typeof raw.rootPath === 'string' ? raw.rootPath : './';
     // Execute command.
-    const command = thisCommand.args.join(' ');
+    const args = Array.isArray(commandParts) ? commandParts : [];
+    // When no positional tokens are provided (e.g., option form `-c/--command`),
+    // the preSubcommand hook handles execution. Avoid a duplicate call here.
+    if (args.length === 0)
+        return;
+    const command = args.map(String).join(' ');
     await execShellCommandBatch({
         command: resolveCommand(getDotenvCliOptions.scripts, command),
         getDotenvCliOptions,
@@ -575,8 +581,9 @@ const cmdCommand = new Command()
     .configureHelp({ showGlobalOptions: true })
     .enablePositionalOptions()
     .passThroughOptions()
-    .action(async (_options, thisCommand) => {
-    const args = thisCommand.args;
+    .argument('[command...]')
+    .action(async (commandParts, _options, thisCommand) => {
+    const args = Array.isArray(commandParts) ? commandParts : [];
     if (args.length === 0)
         return;
     if (!thisCommand.parent)
@@ -679,10 +686,7 @@ const defaultsDeep = (...layers) => {
 };
 
 // src/GetDotenvOptions.ts
-const getDotenvOptionsFilename = 'getdotenv.config.json'; /**
- * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
+const getDotenvOptionsFilename = 'getdotenv.config.json';
 /**
  * Helper to define a dynamic map with strong inference.
  *
@@ -700,8 +704,7 @@ const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPatt
     /**
      * Convert CLI-facing string options into {@link GetDotenvOptions}.
      *
-     * - Splits {@link GetDotenvCliOptions.paths} using either a delimiter
-     *   or a regular expression pattern into a string array.   * - Parses {@link GetDotenvCliOptions.vars} as space-separated `KEY=VALUE`
+     * - Splits {@link GetDotenvCliOptions.paths} using either a delimiter   *   or a regular expression pattern into a string array.   * - Parses {@link GetDotenvCliOptions.vars} as space-separated `KEY=VALUE`
      *   pairs (configurable delimiters) into a {@link ProcessEnv}.
      * - Drops CLI-only keys that have no programmatic equivalent.
      *
@@ -714,21 +717,36 @@ const getDotenvCliOptions2Options = ({ paths, pathsDelimiter, pathsDelimiterPatt
     delete restObj.debug;
     delete restObj.scripts;
     const splitBy = (value, delim, pattern) => (value ? value.split(pattern ? RegExp(pattern) : (delim ?? ' ')) : []);
-    const kvPairs = (vars
-        ? splitBy(vars, varsDelimiter, varsDelimiterPattern).map((v) => v.split(varsAssignorPattern
+    // Tolerate vars as either a CLI string ("A=1 B=2") or an object map.
+    let parsedVars;
+    if (typeof vars === 'string') {
+        const kvPairs = splitBy(vars, varsDelimiter, varsDelimiterPattern).map((v) => v.split(varsAssignorPattern
             ? RegExp(varsAssignorPattern)
-            : (varsAssignor ?? '=')))
-        : []);
-    const parsedVars = Object.fromEntries(kvPairs);
+            : (varsAssignor ?? '=')));
+        parsedVars = Object.fromEntries(kvPairs);
+    }
+    else if (vars && typeof vars === 'object' && !Array.isArray(vars)) {
+        // Keep only string or undefined values to match ProcessEnv.
+        const entries = Object.entries(vars).filter(([k, v]) => typeof k === 'string' && (typeof v === 'string' || v === undefined));
+        parsedVars = Object.fromEntries(entries);
+    }
+    // Drop undefined-valued entries at the converter stage to match ProcessEnv
+    // expectations and the compat test assertions.
+    if (parsedVars) {
+        parsedVars = Object.fromEntries(Object.entries(parsedVars).filter(([, v]) => v !== undefined));
+    }
+    // Tolerate paths as either a delimited string or string[]
+    // Use a locally cast union type to avoid lint warnings about always-falsy conditions
+    // under the RootOptionsShape (which declares paths as string | undefined).
+    const pathsAny = paths;
+    const pathsOut = Array.isArray(pathsAny)
+        ? pathsAny.filter((p) => typeof p === 'string')
+        : splitBy(pathsAny, pathsDelimiter, pathsDelimiterPattern);
     // Preserve exactOptionalPropertyTypes: only include keys when defined.
     return {
         ...restObj,
-        ...(paths !== undefined
-            ? {
-                paths: splitBy(paths, pathsDelimiter, pathsDelimiterPattern),
-            }
-            : {}),
-        ...(vars !== undefined ? { vars: parsedVars } : {}),
+        ...(pathsOut.length > 0 ? { paths: pathsOut } : {}),
+        ...(parsedVars !== undefined ? { vars: parsedVars } : {}),
     };
 };
 const resolveGetDotenvOptions = async (customOptions) => {

package/dist/plugins-aws.d.cts

@@ -3,9 +3,7 @@ import { Command } from 'commander';
 
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set

package/dist/plugins-aws.d.mts

@@ -3,9 +3,7 @@ import { Command } from 'commander';
 
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set

package/dist/plugins-aws.d.ts

@@ -3,9 +3,7 @@ import { Command } from 'commander';
 
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set

package/dist/plugins-batch.d.cts

@@ -3,9 +3,7 @@ import { Command } from 'commander';
 
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set

package/dist/plugins-batch.d.mts

@@ -3,9 +3,7 @@ import { Command } from 'commander';
 
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set

package/dist/plugins-batch.d.ts

@@ -3,9 +3,7 @@ import { Command } from 'commander';
 
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set

package/dist/plugins-init.d.cts

@@ -3,9 +3,7 @@ import { Command } from 'commander';
 
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set

package/dist/plugins-init.d.mts

@@ -3,9 +3,7 @@ import { Command } from 'commander';
 
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set

package/dist/plugins-init.d.ts

@@ -3,9 +3,7 @@ import { Command } from 'commander';
 
 /**
  * A minimal representation of an environment key/value mapping.
- * Values may be `undefined` to represent "unset".
- */
-type ProcessEnv = Record<string, string | undefined>;
+ * Values may be `undefined` to represent "unset". */ type ProcessEnv = Record<string, string | undefined>;
 /**
  * Dynamic variable function signature. Receives the current expanded variables
  * and the selected environment (if any), and returns either a string to set

package/package.json

@@ -224,5 +224,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "5.0.0-0"
+  "version": "5.0.0-2"
 }