@types/semver - npm Package Compare versions

Comparing version 6.2.0 to 7.1.0

semver/index.d.ts

@@ -1,2 +0,2 @@
-// Type definitions for semver 6.2
+// Type definitions for semver 7.1
 // Project: https://github.com/npm/node-semver
@@ -10,6 +10,103 @@ // Definitions by: Bart van der Schoor <https://github.com/Bartvds>
 
-export const SEMVER_SPEC_VERSION: "2.0.0";
+/// <reference types="node" />
 
-export type ReleaseType = "major" | "premajor" | "minor" | "preminor" | "patch" | "prepatch" | "prerelease";
+// re-exports for index file
 
+// functions for working with versions
+import semverParse = require('./functions/parse');
+import semverValid = require('./functions/valid');
+import semverClean = require('./functions/clean');
+import semverInc = require('./functions/inc');
+import semverDiff = require('./functions/diff');
+import semverMajor = require('./functions/major');
+import semverMinor = require('./functions/minor');
+import semverPatch = require('./functions/patch');
+import semverPrerelease = require('./functions/prerelease');
+import semverCompare = require('./functions/compare');
+import semverRcompare = require('./functions/rcompare');
+import semverCompareLoose = require('./functions/compare-loose');
+import semverCompareBuild = require('./functions/compare-build');
+import semverSort = require('./functions/sort');
+import semverRsort = require('./functions/rsort');
+
+export {
+    semverParse as parse,
+    semverValid as valid,
+    semverClean as clean,
+    semverInc as inc,
+    semverDiff as diff,
+    semverMajor as major,
+    semverMinor as minor,
+    semverPatch as patch,
+    semverPrerelease as prerelease,
+    semverCompare as compare,
+    semverRcompare as rcompare,
+    semverCompareLoose as compareLoose,
+    semverCompareBuild as compareBuild,
+    semverSort as sort,
+    semverRsort as rsort,
+};
+
+// low-level comparators between versions
+import semverGt = require('./functions/gt');
+import semverLt = require('./functions/lt');
+import semverEq = require('./functions/eq');
+import semverNeq = require('./functions/neq');
+import semverGte = require('./functions/gte');
+import semverLte = require('./functions/lte');
+import semverCmp = require('./functions/cmp');
+import semverCoerce = require('./functions/coerce');
+
+export {
+    semverGt as gt,
+    semverLt as lt,
+    semverEq as eq,
+    semverNeq as neq,
+    semverGte as gte,
+    semverLte as lte,
+    semverCmp as cmp,
+    semverCoerce as coerce,
+};
+
+// working with ranges
+import semverSatisfies = require('./functions/satisfies');
+import semverMaxSatisfying = require('./ranges/max-satisfying');
+import semverMinSatisfying = require('./ranges/min-satisfying');
+import semverToComparators = require('./ranges/to-comparators');
+import semverMinVersion = require('./ranges/min-version');
+import semverValidRange = require('./ranges/valid');
+import semverOutside = require('./ranges/outside');
+import semverGtr = require('./ranges/gtr');
+import semverLtr = require('./ranges/ltr');
+import semverIntersects = require('./ranges/intersects');
+
+export {
+    semverSatisfies as satisfies,
+    semverMaxSatisfying as maxSatisfying,
+    semverMinSatisfying as minSatisfying,
+    semverToComparators as toComparators,
+    semverMinVersion as minVersion,
+    semverValidRange as validRange,
+    semverOutside as outside,
+    semverGtr as gtr,
+    semverLtr as ltr,
+    semverIntersects as intersects,
+};
+
+// classes
+import SemVer = require('./classes/semver');
+import Range = require('./classes/range');
+import Comparator = require('./classes/comparator');
+
+export { SemVer, Range, Comparator };
+
+// internals
+import identifiers = require('./internals/identifiers');
+export import compareIdentifiers = identifiers.compareIdentifiers;
+export import rcompareIdentifiers = identifiers.rcompareIdentifiers;
+
+export const SEMVER_SPEC_VERSION: '2.0.0';
+
+export type ReleaseType = 'major' | 'premajor' | 'minor' | 'preminor' | 'patch' | 'prepatch' | 'prerelease';
+
 export interface Options {
@@ -19,3 +116,2 @@ loose?: boolean;
 }
-
 export interface CoerceOptions extends Options {
@@ -36,267 +132,2 @@ /**
 
-/**
- * Return the parsed version as a SemVer object, or null if it's not valid.
- */
-export function parse(version: string | SemVer | null | undefined, optionsOrLoose?: boolean | Options): SemVer | null;
-
-/**
- * Return the parsed version as a string, or null if it's not valid.
- */
-export function valid(version: string | SemVer | null | undefined, optionsOrLoose?: boolean | Options): string | null;
-
-/**
- * Coerces a string to SemVer if possible
- */
-export function coerce(version: string | number | SemVer | null | undefined, options?: CoerceOptions): SemVer | null;
-
-/**
- * Returns cleaned (removed leading/trailing whitespace, remove '=v' prefix) and parsed version, or null if version is invalid.
- */
-export function clean(version: string, optionsOrLoose?: boolean | Options): string | null;
-
-/**
- * Return the version incremented by the release type (major, minor, patch, or prerelease), or null if it's not valid.
- */
-export function inc(version: string | SemVer, release: ReleaseType, optionsOrLoose?: boolean | Options, identifier?: string): string | null;
-export function inc(version: string | SemVer, release: ReleaseType, identifier?: string): string | null;
-
-/**
- * Return the major version number.
- */
-export function major(version: string | SemVer, optionsOrLoose?: boolean | Options): number;
-
-/**
- * Return the minor version number.
- */
-export function minor(version: string | SemVer, optionsOrLoose?: boolean | Options): number;
-
-/**
- * Return the patch version number.
- */
-export function patch(version: string | SemVer, optionsOrLoose?: boolean | Options): number;
-
-/**
- * Returns an array of prerelease components, or null if none exist.
- */
-export function prerelease(version: string | SemVer, optionsOrLoose?: boolean | Options): ReadonlyArray<string> | null;
-
-// Comparison
-/**
- * v1 > v2
- */
-export function gt(v1: string | SemVer, v2: string | SemVer, optionsOrLoose?: boolean | Options): boolean;
-/**
- * v1 >= v2
- */
-export function gte(v1: string | SemVer, v2: string | SemVer, optionsOrLoose?: boolean | Options): boolean;
-/**
- * v1 < v2
- */
-export function lt(v1: string | SemVer, v2: string | SemVer, optionsOrLoose?: boolean | Options): boolean;
-/**
- * v1 <= v2
- */
-export function lte(v1: string | SemVer, v2: string | SemVer, optionsOrLoose?: boolean | Options): boolean;
-/**
- * v1 == v2 This is true if they're logically equivalent, even if they're not the exact same string. You already know how to compare strings.
- */
-export function eq(v1: string | SemVer, v2: string | SemVer, optionsOrLoose?: boolean | Options): boolean;
-/**
- * v1 != v2 The opposite of eq.
- */
-export function neq(v1: string | SemVer, v2: string | SemVer, optionsOrLoose?: boolean | Options): boolean;
-
-/**
- * Pass in a comparison string, and it'll call the corresponding semver comparison function.
- * "===" and "!==" do simple string comparison, but are included for completeness.
- * Throws if an invalid comparison string is provided.
- */
-export function cmp(v1: string | SemVer, operator: Operator, v2: string | SemVer, optionsOrLoose?: boolean | Options): boolean;
 export type Operator = '===' | '!==' | '' | '=' | '==' | '!=' | '>' | '>=' | '<' | '<=';
-
-/**
- * Compares two versions excluding build identifiers (the bit after `+` in the semantic version string).
- *
- * Sorts in ascending order when passed to `Array.sort()`.
- *
- * @return
- * - `0` if `v1` == `v2`
- * - `1` if `v1` is greater
- * - `-1` if `v2` is greater.
- */
-export function compare(v1: string | SemVer, v2: string | SemVer, optionsOrLoose?: boolean | Options): 1 | 0 | -1;
-/**
- * The reverse of compare.
- *
- * Sorts in descending order when passed to `Array.sort()`.
- */
-export function rcompare(v1: string | SemVer, v2: string | SemVer, optionsOrLoose?: boolean | Options): 1 | 0 | -1;
-
-/**
- * Compares two identifiers, must be numeric strings or truthy/falsy values.
- *
- * Sorts in ascending order when passed to `Array.sort()`.
- */
-export function compareIdentifiers(a: string | null | undefined, b: string | null | undefined): 1 | 0 | -1;
-/**
- * The reverse of compareIdentifiers.
- *
- * Sorts in descending order when passed to `Array.sort()`.
- */
-export function rcompareIdentifiers(a: string | null | undefined, b: string | null | undefined): 1 | 0 | -1;
-
-/**
- * Compares two versions including build identifiers (the bit after `+` in the semantic version string).
- *
- * Sorts in ascending order when passed to `Array.sort()`.
- *
- * @return
- * - `0` if `v1` == `v2`
- * - `1` if `v1` is greater
- * - `-1` if `v2` is greater.
- *
- * @since 6.1.0
- */
-export function compareBuild(a: string | SemVer, b: string | SemVer): 1 | 0 | -1;
-
-/**
- * Sorts an array of semver entries in ascending order using `compareBuild()`.
- */
-export function sort<T extends string | SemVer>(list: T[], optionsOrLoose?: boolean | Options): T[];
-/**
- * Sorts an array of semver entries in descending order using `compareBuild()`.
- */
-export function rsort<T extends string | SemVer>(list: T[], optionsOrLoose?: boolean | Options): T[];
-
-/**
- * Returns difference between two versions by the release type (major, premajor, minor, preminor, patch, prepatch, or prerelease), or null if the versions are the same.
- */
-export function diff(v1: string | SemVer, v2: string | SemVer, optionsOrLoose?: boolean | Options): ReleaseType | null;
-
-// Ranges
-/**
- * Return the valid range or null if it's not valid
- */
-export function validRange(range: string | Range | null | undefined, optionsOrLoose?: boolean | Options): string;
-/**
- * Return true if the version satisfies the range.
- */
-export function satisfies(version: string | SemVer, range: string | Range, optionsOrLoose?: boolean | Options): boolean;
-/**
- * Return the highest version in the list that satisfies the range, or null if none of them do.
- */
-export function maxSatisfying<T extends string | SemVer>(versions: ReadonlyArray<T>, range: string | Range, optionsOrLoose?: boolean | Options): T | null;
-/**
- * Return the lowest version in the list that satisfies the range, or null if none of them do.
- */
-export function minSatisfying<T extends string | SemVer>(versions: ReadonlyArray<T>, range: string | Range, optionsOrLoose?: boolean | Options): T | null;
-/**
- * Return the lowest version that can possibly match the given range.
- */
-export function minVersion(range: string | Range, optionsOrLoose?: boolean | Options): SemVer | null;
-/**
- * Return true if version is greater than all the versions possible in the range.
- */
-export function gtr(version: string | SemVer, range: string | Range, optionsOrLoose?: boolean | Options): boolean;
-/**
- * Return true if version is less than all the versions possible in the range.
- */
-export function ltr(version: string | SemVer, range: string | Range, optionsOrLoose?: boolean | Options): boolean;
-/**
- * Return true if the version is outside the bounds of the range in either the high or low direction.
- * The hilo argument must be either the string '>' or '<'. (This is the function called by gtr and ltr.)
- */
-export function outside(version: string | SemVer, range: string | Range, hilo: '>' | '<', optionsOrLoose?: boolean | Options): boolean;
-/**
- * Return true if any of the ranges comparators intersect
- */
-export function intersects(range1: string | Range, range2: string | Range, optionsOrLoose?: boolean | Options): boolean;
-
-export class SemVer {
-    constructor(version: string | SemVer, optionsOrLoose?: boolean | Options);
-
-    raw: string;
-    loose: boolean;
-    options: Options;
-    format(): string;
-    inspect(): string;
-
-    major: number;
-    minor: number;
-    patch: number;
-    version: string;
-    build: ReadonlyArray<string>;
-    prerelease: ReadonlyArray<string | number>;
-
-    /**
-     * Compares two versions excluding build identifiers (the bit after `+` in the semantic version string).
-     *
-     * @return
-     * - `0` if `this` == `other`
-     * - `1` if `this` is greater
-     * - `-1` if `other` is greater.
-     */
-    compare(other: string | SemVer): 1 | 0 | -1;
-
-    /**
-     * Compares the release portion of two versions.
-     *
-     * @return
-     * - `0` if `this` == `other`
-     * - `1` if `this` is greater
-     * - `-1` if `other` is greater.
-     */
-    compareMain(other: string | SemVer): 1 | 0 | -1;
-
-    /**
-     * Compares the prerelease portion of two versions.
-     *
-     * @return
-     * - `0` if `this` == `other`
-     * - `1` if `this` is greater
-     * - `-1` if `other` is greater.
-     */
-    comparePre(other: string | SemVer): 1 | 0 | -1;
-
-    /**
-     * Compares the build identifier of two versions.
-     *
-     * @return
-     * - `0` if `this` == `other`
-     * - `1` if `this` is greater
-     * - `-1` if `other` is greater.
-     */
-    compareBuild(other: string | SemVer): 1 | 0 | -1;
-
-    inc(release: ReleaseType, identifier?: string): SemVer;
-}
-
-export class Comparator {
-    constructor(comp: string | Comparator, optionsOrLoose?: boolean | Options);
-
-    semver: SemVer;
-    operator: '' | '=' | '<' | '>' | '<=' | '>=';
-    value: string;
-    loose: boolean;
-    options: Options;
-    parse(comp: string): void;
-    test(version: string | SemVer): boolean;
-    intersects(comp: Comparator, optionsOrLoose?: boolean | Options): boolean;
-}
-
-export class Range {
-    constructor(range: string | Range, optionsOrLoose?: boolean | Options);
-
-    range: string;
-    raw: string;
-    loose: boolean;
-    options: Options;
-    includePrerelease: boolean;
-    format(): string;
-    inspect(): string;
-
-    set: ReadonlyArray<ReadonlyArray<Comparator>>;
-    parseRange(range: string): ReadonlyArray<Comparator>;
-    test(version: string | SemVer): boolean;
-    intersects(range: Range, optionsOrLoose?: boolean | Options): boolean;
-}

semver/package.json

 {
     "name": "@types/semver",
-    "version": "6.2.0",
+    "version": "7.1.0",
     "description": "TypeScript definitions for semver",
@@ -34,3 +34,3 @@ "license": "MIT",
     "main": "",
-    "types": "index",
+    "types": "index.d.ts",
     "repository": {
@@ -42,5 +42,7 @@ "type": "git",
     "scripts": {},
-    "dependencies": {},
-    "typesPublisherContentHash": "f19d7b1ca506ce2f282d80a2b72e499a5dc5afed849026bc6a56307e1030e70a",
-    "typeScriptVersion": "2.0"
+    "dependencies": {
+        "@types/node": "*"
+    },
+    "typesPublisherContentHash": "416d3be355e7222d5f4e1aa0090d8831e4c7ea5f6a4e3cda4b1ecf3505f6fec4",
+    "typeScriptVersion": "2.8"
 }

semver/README.md

@@ -8,10 +8,10 @@ # Installation
 # Details
-Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/semver
+Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/semver.
 
-Additional Details
- * Last updated: Fri, 25 Oct 2019 20:12:50 GMT
- * Dependencies: none
+### Additional Details
+ * Last updated: Mon, 27 Jan 2020 21:41:19 GMT
+ * Dependencies: [@types/node](https://npmjs.com/package/@types/node)
  * Global values: none
 
 # Credits
-These definitions were written by Bart van der Schoor <https://github.com/Bartvds>, BendingBender <https://github.com/BendingBender>, Lucian Buzzo <https://github.com/LucianBuzzo>, Klaus Meinhardt <https://github.com/ajafff>, and ExE Boss <https://github.com/ExE-Boss>.
+These definitions were written by Bart van der Schoor (https://github.com/Bartvds), BendingBender (https://github.com/BendingBender), Lucian Buzzo (https://github.com/LucianBuzzo), Klaus Meinhardt (https://github.com/ajafff), and ExE Boss (https://github.com/ExE-Boss).

New alerts

Floating dependency

Quality

Package has a dependency with a floating version range. This can cause issues if the dependency publishes a new major version.

Found 1 instance in 1 package

Major refactor

Supply chain risk

Package has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

21762

increased by57.07%

Number of package files

42

increased by950%

Lines of code

534

increased by101.51%

Worsened metrics

Dependency count

1

increased byInfinity%

Number of medium quality alerts

1

increased byInfinity%

Number of medium supply chain risk alerts

1

increased byInfinity%

Dependency changes

• + Added@types/node@*

• + Added@types/node@20.12.12(transitive)

• + Addedundici-types@5.26.5(transitive)