mirror of
https://github.com/denoland/std.git
synced 2024-11-22 04:59:05 +00:00
37 lines
1.1 KiB
TypeScript
37 lines
1.1 KiB
TypeScript
// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
|
|
// This module is browser compatible.
|
|
import type { Range, SemVer } from "./types.ts";
|
|
import { satisfies } from "./satisfies.ts";
|
|
import { lessThan } from "./less_than.ts";
|
|
|
|
/**
|
|
* Returns the lowest SemVer in the list that satisfies the range, or `undefined` if
|
|
* none of them do.
|
|
*
|
|
* @example Usage
|
|
* ```ts
|
|
* import { parse, parseRange, minSatisfying } from "@std/semver";
|
|
* import { assertEquals } from "@std/assert";
|
|
*
|
|
* const versions = ["0.2.0", "1.2.3", "1.3.0", "2.0.0", "2.1.0"].map(parse);
|
|
* const range = parseRange(">=1.0.0 <2.0.0");
|
|
*
|
|
* assertEquals(minSatisfying(versions, range), parse("1.2.3"));
|
|
* ```
|
|
*
|
|
* @param versions The versions to check.
|
|
* @param range The range of possible versions to compare to.
|
|
* @returns The lowest version in versions that satisfies the range.
|
|
*/
|
|
export function minSatisfying(
|
|
versions: SemVer[],
|
|
range: Range,
|
|
): SemVer | undefined {
|
|
let min;
|
|
for (const version of versions) {
|
|
if (!satisfies(version, range)) continue;
|
|
min = min && lessThan(min, version) ? min : version;
|
|
}
|
|
return min;
|
|
}
|