// Types for `nodeEnvironment.mjs`. Hand-written because the implementation is
// plain ESM on purpose — `bin/voltro.mjs` runs before the tsx loader and cannot
// import TypeScript, so the rule has to live in a file BOTH sides can load.
// `src/nodeEnvironment.ts` is the TypeScript face of it.

export type NodeEnvironmentName = string

/** Which environment an undeclared `NODE_ENV` resolves to, per command. */
export declare const COMMAND_ENVIRONMENT_DEFAULTS: Readonly<Record<string, NodeEnvironmentName | undefined>>

/** The first non-flag token of a `voltro …` argv, lowercased. */
export declare const commandOf: (argv: ReadonlyArray<string>) => string | undefined

/** Resolve this invocation's environment WITHOUT mutating `process.env`. */
export declare const resolveNodeEnvironment: (
  argv: ReadonlyArray<string>,
  env?: Record<string, string | undefined>,
) => NodeEnvironmentName | undefined

/** Was `NODE_ENV` defaulted by us rather than declared by the operator? */
export declare const nodeEnvironmentWasDefaulted: () => boolean

/** Write the resolved environment into `process.env.NODE_ENV` when unset. */
export declare const declareNodeEnvironment: (
  argv: ReadonlyArray<string>,
  env?: Record<string, string | undefined>,
) => NodeEnvironmentName | undefined

/** Tests only. */
export declare const resetNodeEnvironmentDeclaration: () => void