Function resolveDotenvTarget

resolveDotenvTarget(
opts: ResolveDotenvTargetOptions,
): Promise<ResolveDotenvTargetResult>
Resolve a deterministic dotenv target across paths based on scope/privacy selectors.

Selection rules:
- Iterates paths in the requested search order.
- Returns the first existing target file.
- Otherwise, returns the first sibling template file (<target>.<templateExtension>) when present.
- Throws when neither a target nor a template exists anywhere under paths.
Parameters
- opts: ResolveDotenvTargetOptions
  Resolver options (paths + selector + fs port).
Returns Promise<ResolveDotenvTargetResult>
The resolved target path and optional template path.
- Defined in src/dotenv/edit/resolveDotenvTarget.ts:142