keep-a-changelog 0.10.3 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (92) hide show
  1. package/CHANGELOG.md +13 -185
  2. package/LICENSE +1 -1
  3. package/README.md +93 -63
  4. package/esm/_dnt.shims.js +62 -0
  5. package/esm/bin.js +114 -0
  6. package/esm/deps/deno_land/std_0.120.0/_util/assert.js +13 -0
  7. package/esm/deps/deno_land/std_0.120.0/_util/os.js +15 -0
  8. package/esm/deps/deno_land/std_0.120.0/flags/mod.js +255 -0
  9. package/esm/deps/deno_land/std_0.120.0/path/_constants.js +45 -0
  10. package/esm/deps/deno_land/std_0.120.0/path/_interface.js +3 -0
  11. package/esm/deps/deno_land/std_0.120.0/path/_util.js +114 -0
  12. package/esm/deps/deno_land/std_0.120.0/path/common.js +36 -0
  13. package/esm/deps/deno_land/std_0.120.0/path/glob.js +361 -0
  14. package/esm/deps/deno_land/std_0.120.0/path/mod.js +14 -0
  15. package/esm/deps/deno_land/std_0.120.0/path/posix.js +493 -0
  16. package/esm/deps/deno_land/std_0.120.0/path/separator.js +5 -0
  17. package/esm/deps/deno_land/std_0.120.0/path/win32.js +963 -0
  18. package/esm/deps/deno_land/std_0.51.0/fs/eol.js +29 -0
  19. package/esm/deps/deno_land/x/ini_v2.1.0/ini.js +226 -0
  20. package/esm/deps/deno_land/x/ini_v2.1.0/mod.js +1 -0
  21. package/esm/deps/deno_land/x/semver_v1.4.0/mod.js +1527 -0
  22. package/esm/mod.js +5 -0
  23. package/esm/package.json +3 -0
  24. package/esm/src/Change.js +48 -0
  25. package/esm/src/Changelog.js +137 -0
  26. package/esm/src/Release.js +204 -0
  27. package/esm/src/deps.js +1 -0
  28. package/esm/src/parser.js +159 -0
  29. package/esm/test/changelog.custom.type.md +24 -0
  30. package/esm/test/changelog.expected.md +169 -0
  31. package/esm/test/changelog.md +200 -0
  32. package/esm/test/empty.expected.md +6 -0
  33. package/package.json +26 -24
  34. package/types/_dnt.shims.d.ts +9 -0
  35. package/types/bin.d.ts +2 -0
  36. package/types/deps/deno_land/std_0.120.0/_util/assert.d.ts +5 -0
  37. package/types/deps/deno_land/std_0.120.0/_util/os.d.ts +3 -0
  38. package/types/deps/deno_land/std_0.120.0/flags/mod.d.ts +50 -0
  39. package/types/deps/deno_land/std_0.120.0/path/_constants.d.ts +39 -0
  40. package/types/deps/deno_land/std_0.120.0/path/_interface.d.ts +26 -0
  41. package/types/deps/deno_land/std_0.120.0/path/_util.d.ts +8 -0
  42. package/types/deps/deno_land/std_0.120.0/path/common.d.ts +13 -0
  43. package/types/deps/deno_land/std_0.120.0/path/glob.d.ts +78 -0
  44. package/types/deps/deno_land/std_0.120.0/path/mod.d.ts +9 -0
  45. package/types/deps/deno_land/std_0.120.0/path/posix.d.ts +80 -0
  46. package/types/deps/deno_land/std_0.120.0/path/separator.d.ts +2 -0
  47. package/types/deps/deno_land/std_0.120.0/path/win32.d.ts +87 -0
  48. package/types/deps/deno_land/std_0.51.0/fs/eol.d.ts +12 -0
  49. package/types/deps/deno_land/x/ini_v2.1.0/ini.d.ts +53 -0
  50. package/types/deps/deno_land/x/ini_v2.1.0/mod.d.ts +1 -0
  51. package/types/deps/deno_land/x/semver_v1.4.0/mod.d.ts +116 -0
  52. package/types/mod.d.ts +5 -0
  53. package/types/src/Change.d.ts +8 -0
  54. package/types/src/Changelog.d.ts +18 -0
  55. package/types/src/Release.d.ts +25 -0
  56. package/types/src/deps.d.ts +1 -0
  57. package/types/src/parser.d.ts +11 -0
  58. package/umd/_dnt.shims.js +76 -0
  59. package/umd/bin.js +145 -0
  60. package/umd/deps/deno_land/std_0.120.0/_util/assert.js +28 -0
  61. package/umd/deps/deno_land/std_0.120.0/_util/os.js +47 -0
  62. package/umd/deps/deno_land/std_0.120.0/flags/mod.js +269 -0
  63. package/umd/deps/deno_land/std_0.120.0/path/_constants.js +58 -0
  64. package/umd/deps/deno_land/std_0.120.0/path/_interface.js +14 -0
  65. package/umd/deps/deno_land/std_0.120.0/path/_util.js +134 -0
  66. package/umd/deps/deno_land/std_0.120.0/path/common.js +50 -0
  67. package/umd/deps/deno_land/std_0.120.0/path/glob.js +397 -0
  68. package/umd/deps/deno_land/std_0.120.0/path/mod.js +51 -0
  69. package/umd/deps/deno_land/std_0.120.0/path/posix.js +538 -0
  70. package/umd/deps/deno_land/std_0.120.0/path/separator.js +18 -0
  71. package/umd/deps/deno_land/std_0.120.0/path/win32.js +1008 -0
  72. package/umd/deps/deno_land/std_0.51.0/fs/eol.js +44 -0
  73. package/umd/deps/deno_land/x/ini_v2.1.0/ini.js +262 -0
  74. package/umd/deps/deno_land/x/ini_v2.1.0/mod.js +23 -0
  75. package/umd/deps/deno_land/x/semver_v1.4.0/mod.js +1578 -0
  76. package/umd/mod.js +24 -0
  77. package/umd/package.json +3 -0
  78. package/umd/src/Change.js +61 -0
  79. package/umd/src/Changelog.js +150 -0
  80. package/umd/src/Release.js +220 -0
  81. package/umd/src/deps.js +19 -0
  82. package/umd/src/parser.js +175 -0
  83. package/umd/test/changelog.custom.type.md +24 -0
  84. package/umd/test/changelog.expected.md +169 -0
  85. package/umd/test/changelog.md +200 -0
  86. package/umd/test/empty.expected.md +6 -0
  87. package/bin.js +0 -114
  88. package/src/Change.js +0 -40
  89. package/src/Changelog.js +0 -121
  90. package/src/Release.js +0 -220
  91. package/src/index.js +0 -6
  92. package/src/parser.js +0 -182
@@ -0,0 +1,1527 @@
1
+ // Note: this is the semver.org version of the spec that it implements
2
+ // Not necessarily the package version of this code.
3
+ export const SEMVER_SPEC_VERSION = "2.0.0";
4
+ const MAX_LENGTH = 256;
5
+ // Max safe segment length for coercion.
6
+ const MAX_SAFE_COMPONENT_LENGTH = 16;
7
+ // The actual regexps
8
+ const re = [];
9
+ const src = [];
10
+ let R = 0;
11
+ // The following Regular Expressions can be used for tokenizing,
12
+ // validating, and parsing SemVer version strings.
13
+ // ## Numeric Identifier
14
+ // A single `0`, or a non-zero digit followed by zero or more digits.
15
+ const NUMERICIDENTIFIER = R++;
16
+ src[NUMERICIDENTIFIER] = "0|[1-9]\\d*";
17
+ const NUMERICIDENTIFIERLOOSE = R++;
18
+ src[NUMERICIDENTIFIERLOOSE] = "[0-9]+";
19
+ // ## Non-numeric Identifier
20
+ // Zero or more digits, followed by a letter or hyphen, and then zero or
21
+ // more letters, digits, or hyphens.
22
+ const NONNUMERICIDENTIFIER = R++;
23
+ src[NONNUMERICIDENTIFIER] = "\\d*[a-zA-Z-][a-zA-Z0-9-]*";
24
+ // ## Main Version
25
+ // Three dot-separated numeric identifiers.
26
+ const MAINVERSION = R++;
27
+ const nid = src[NUMERICIDENTIFIER];
28
+ src[MAINVERSION] = `(${nid})\\.(${nid})\\.(${nid})`;
29
+ const MAINVERSIONLOOSE = R++;
30
+ const nidl = src[NUMERICIDENTIFIERLOOSE];
31
+ src[MAINVERSIONLOOSE] = `(${nidl})\\.(${nidl})\\.(${nidl})`;
32
+ // ## Pre-release Version Identifier
33
+ // A numeric identifier, or a non-numeric identifier.
34
+ const PRERELEASEIDENTIFIER = R++;
35
+ src[PRERELEASEIDENTIFIER] = "(?:" + src[NUMERICIDENTIFIER] + "|" +
36
+ src[NONNUMERICIDENTIFIER] + ")";
37
+ const PRERELEASEIDENTIFIERLOOSE = R++;
38
+ src[PRERELEASEIDENTIFIERLOOSE] = "(?:" + src[NUMERICIDENTIFIERLOOSE] + "|" +
39
+ src[NONNUMERICIDENTIFIER] + ")";
40
+ // ## Pre-release Version
41
+ // Hyphen, followed by one or more dot-separated pre-release version
42
+ // identifiers.
43
+ const PRERELEASE = R++;
44
+ src[PRERELEASE] = "(?:-(" +
45
+ src[PRERELEASEIDENTIFIER] +
46
+ "(?:\\." +
47
+ src[PRERELEASEIDENTIFIER] +
48
+ ")*))";
49
+ const PRERELEASELOOSE = R++;
50
+ src[PRERELEASELOOSE] = "(?:-?(" +
51
+ src[PRERELEASEIDENTIFIERLOOSE] +
52
+ "(?:\\." +
53
+ src[PRERELEASEIDENTIFIERLOOSE] +
54
+ ")*))";
55
+ // ## Build Metadata Identifier
56
+ // Any combination of digits, letters, or hyphens.
57
+ const BUILDIDENTIFIER = R++;
58
+ src[BUILDIDENTIFIER] = "[0-9A-Za-z-]+";
59
+ // ## Build Metadata
60
+ // Plus sign, followed by one or more period-separated build metadata
61
+ // identifiers.
62
+ const BUILD = R++;
63
+ src[BUILD] = "(?:\\+(" + src[BUILDIDENTIFIER] + "(?:\\." +
64
+ src[BUILDIDENTIFIER] + ")*))";
65
+ // ## Full Version String
66
+ // A main version, followed optionally by a pre-release version and
67
+ // build metadata.
68
+ // Note that the only major, minor, patch, and pre-release sections of
69
+ // the version string are capturing groups. The build metadata is not a
70
+ // capturing group, because it should not ever be used in version
71
+ // comparison.
72
+ const FULL = R++;
73
+ const FULLPLAIN = "v?" + src[MAINVERSION] + src[PRERELEASE] + "?" + src[BUILD] +
74
+ "?";
75
+ src[FULL] = "^" + FULLPLAIN + "$";
76
+ // like full, but allows v1.2.3 and =1.2.3, which people do sometimes.
77
+ // also, 1.0.0alpha1 (prerelease without the hyphen) which is pretty
78
+ // common in the npm registry.
79
+ const LOOSEPLAIN = "[v=\\s]*" +
80
+ src[MAINVERSIONLOOSE] +
81
+ src[PRERELEASELOOSE] +
82
+ "?" +
83
+ src[BUILD] +
84
+ "?";
85
+ const LOOSE = R++;
86
+ src[LOOSE] = "^" + LOOSEPLAIN + "$";
87
+ const GTLT = R++;
88
+ src[GTLT] = "((?:<|>)?=?)";
89
+ // Something like "2.*" or "1.2.x".
90
+ // Note that "x.x" is a valid xRange identifer, meaning "any version"
91
+ // Only the first item is strictly required.
92
+ const XRANGEIDENTIFIERLOOSE = R++;
93
+ src[XRANGEIDENTIFIERLOOSE] = src[NUMERICIDENTIFIERLOOSE] + "|x|X|\\*";
94
+ const XRANGEIDENTIFIER = R++;
95
+ src[XRANGEIDENTIFIER] = src[NUMERICIDENTIFIER] + "|x|X|\\*";
96
+ const XRANGEPLAIN = R++;
97
+ src[XRANGEPLAIN] = "[v=\\s]*(" +
98
+ src[XRANGEIDENTIFIER] +
99
+ ")" +
100
+ "(?:\\.(" +
101
+ src[XRANGEIDENTIFIER] +
102
+ ")" +
103
+ "(?:\\.(" +
104
+ src[XRANGEIDENTIFIER] +
105
+ ")" +
106
+ "(?:" +
107
+ src[PRERELEASE] +
108
+ ")?" +
109
+ src[BUILD] +
110
+ "?" +
111
+ ")?)?";
112
+ const XRANGEPLAINLOOSE = R++;
113
+ src[XRANGEPLAINLOOSE] = "[v=\\s]*(" +
114
+ src[XRANGEIDENTIFIERLOOSE] +
115
+ ")" +
116
+ "(?:\\.(" +
117
+ src[XRANGEIDENTIFIERLOOSE] +
118
+ ")" +
119
+ "(?:\\.(" +
120
+ src[XRANGEIDENTIFIERLOOSE] +
121
+ ")" +
122
+ "(?:" +
123
+ src[PRERELEASELOOSE] +
124
+ ")?" +
125
+ src[BUILD] +
126
+ "?" +
127
+ ")?)?";
128
+ const XRANGE = R++;
129
+ src[XRANGE] = "^" + src[GTLT] + "\\s*" + src[XRANGEPLAIN] + "$";
130
+ const XRANGELOOSE = R++;
131
+ src[XRANGELOOSE] = "^" + src[GTLT] + "\\s*" + src[XRANGEPLAINLOOSE] + "$";
132
+ // Coercion.
133
+ // Extract anything that could conceivably be a part of a valid semver
134
+ const COERCE = R++;
135
+ src[COERCE] = "(?:^|[^\\d])" +
136
+ "(\\d{1," +
137
+ MAX_SAFE_COMPONENT_LENGTH +
138
+ "})" +
139
+ "(?:\\.(\\d{1," +
140
+ MAX_SAFE_COMPONENT_LENGTH +
141
+ "}))?" +
142
+ "(?:\\.(\\d{1," +
143
+ MAX_SAFE_COMPONENT_LENGTH +
144
+ "}))?" +
145
+ "(?:$|[^\\d])";
146
+ // Tilde ranges.
147
+ // Meaning is "reasonably at or greater than"
148
+ const LONETILDE = R++;
149
+ src[LONETILDE] = "(?:~>?)";
150
+ const TILDETRIM = R++;
151
+ src[TILDETRIM] = "(\\s*)" + src[LONETILDE] + "\\s+";
152
+ re[TILDETRIM] = new RegExp(src[TILDETRIM], "g");
153
+ const tildeTrimReplace = "$1~";
154
+ const TILDE = R++;
155
+ src[TILDE] = "^" + src[LONETILDE] + src[XRANGEPLAIN] + "$";
156
+ const TILDELOOSE = R++;
157
+ src[TILDELOOSE] = "^" + src[LONETILDE] + src[XRANGEPLAINLOOSE] + "$";
158
+ // Caret ranges.
159
+ // Meaning is "at least and backwards compatible with"
160
+ const LONECARET = R++;
161
+ src[LONECARET] = "(?:\\^)";
162
+ const CARETTRIM = R++;
163
+ src[CARETTRIM] = "(\\s*)" + src[LONECARET] + "\\s+";
164
+ re[CARETTRIM] = new RegExp(src[CARETTRIM], "g");
165
+ const caretTrimReplace = "$1^";
166
+ const CARET = R++;
167
+ src[CARET] = "^" + src[LONECARET] + src[XRANGEPLAIN] + "$";
168
+ const CARETLOOSE = R++;
169
+ src[CARETLOOSE] = "^" + src[LONECARET] + src[XRANGEPLAINLOOSE] + "$";
170
+ // A simple gt/lt/eq thing, or just "" to indicate "any version"
171
+ const COMPARATORLOOSE = R++;
172
+ src[COMPARATORLOOSE] = "^" + src[GTLT] + "\\s*(" + LOOSEPLAIN + ")$|^$";
173
+ const COMPARATOR = R++;
174
+ src[COMPARATOR] = "^" + src[GTLT] + "\\s*(" + FULLPLAIN + ")$|^$";
175
+ // An expression to strip any whitespace between the gtlt and the thing
176
+ // it modifies, so that `> 1.2.3` ==> `>1.2.3`
177
+ const COMPARATORTRIM = R++;
178
+ src[COMPARATORTRIM] = "(\\s*)" + src[GTLT] + "\\s*(" + LOOSEPLAIN + "|" +
179
+ src[XRANGEPLAIN] + ")";
180
+ // this one has to use the /g flag
181
+ re[COMPARATORTRIM] = new RegExp(src[COMPARATORTRIM], "g");
182
+ const comparatorTrimReplace = "$1$2$3";
183
+ // Something like `1.2.3 - 1.2.4`
184
+ // Note that these all use the loose form, because they'll be
185
+ // checked against either the strict or loose comparator form
186
+ // later.
187
+ const HYPHENRANGE = R++;
188
+ src[HYPHENRANGE] = "^\\s*(" +
189
+ src[XRANGEPLAIN] +
190
+ ")" +
191
+ "\\s+-\\s+" +
192
+ "(" +
193
+ src[XRANGEPLAIN] +
194
+ ")" +
195
+ "\\s*$";
196
+ const HYPHENRANGELOOSE = R++;
197
+ src[HYPHENRANGELOOSE] = "^\\s*(" +
198
+ src[XRANGEPLAINLOOSE] +
199
+ ")" +
200
+ "\\s+-\\s+" +
201
+ "(" +
202
+ src[XRANGEPLAINLOOSE] +
203
+ ")" +
204
+ "\\s*$";
205
+ // Star ranges basically just allow anything at all.
206
+ const STAR = R++;
207
+ src[STAR] = "(<|>)?=?\\s*\\*";
208
+ // Compile to actual regexp objects.
209
+ // All are flag-free, unless they were created above with a flag.
210
+ for (let i = 0; i < R; i++) {
211
+ if (!re[i]) {
212
+ re[i] = new RegExp(src[i]);
213
+ }
214
+ }
215
+ export function parse(version, optionsOrLoose) {
216
+ if (!optionsOrLoose || typeof optionsOrLoose !== "object") {
217
+ optionsOrLoose = {
218
+ loose: !!optionsOrLoose,
219
+ includePrerelease: false,
220
+ };
221
+ }
222
+ if (version instanceof SemVer) {
223
+ return version;
224
+ }
225
+ if (typeof version !== "string") {
226
+ return null;
227
+ }
228
+ if (version.length > MAX_LENGTH) {
229
+ return null;
230
+ }
231
+ const r = optionsOrLoose.loose ? re[LOOSE] : re[FULL];
232
+ if (!r.test(version)) {
233
+ return null;
234
+ }
235
+ try {
236
+ return new SemVer(version, optionsOrLoose);
237
+ }
238
+ catch (er) {
239
+ return null;
240
+ }
241
+ }
242
+ export function valid(version, optionsOrLoose) {
243
+ if (version === null)
244
+ return null;
245
+ const v = parse(version, optionsOrLoose);
246
+ return v ? v.version : null;
247
+ }
248
+ export function clean(version, optionsOrLoose) {
249
+ const s = parse(version.trim().replace(/^[=v]+/, ""), optionsOrLoose);
250
+ return s ? s.version : null;
251
+ }
252
+ export class SemVer {
253
+ constructor(version, optionsOrLoose) {
254
+ Object.defineProperty(this, "raw", {
255
+ enumerable: true,
256
+ configurable: true,
257
+ writable: true,
258
+ value: void 0
259
+ });
260
+ Object.defineProperty(this, "loose", {
261
+ enumerable: true,
262
+ configurable: true,
263
+ writable: true,
264
+ value: void 0
265
+ });
266
+ Object.defineProperty(this, "options", {
267
+ enumerable: true,
268
+ configurable: true,
269
+ writable: true,
270
+ value: void 0
271
+ });
272
+ Object.defineProperty(this, "major", {
273
+ enumerable: true,
274
+ configurable: true,
275
+ writable: true,
276
+ value: void 0
277
+ });
278
+ Object.defineProperty(this, "minor", {
279
+ enumerable: true,
280
+ configurable: true,
281
+ writable: true,
282
+ value: void 0
283
+ });
284
+ Object.defineProperty(this, "patch", {
285
+ enumerable: true,
286
+ configurable: true,
287
+ writable: true,
288
+ value: void 0
289
+ });
290
+ Object.defineProperty(this, "version", {
291
+ enumerable: true,
292
+ configurable: true,
293
+ writable: true,
294
+ value: void 0
295
+ });
296
+ Object.defineProperty(this, "build", {
297
+ enumerable: true,
298
+ configurable: true,
299
+ writable: true,
300
+ value: void 0
301
+ });
302
+ Object.defineProperty(this, "prerelease", {
303
+ enumerable: true,
304
+ configurable: true,
305
+ writable: true,
306
+ value: void 0
307
+ });
308
+ if (!optionsOrLoose || typeof optionsOrLoose !== "object") {
309
+ optionsOrLoose = {
310
+ loose: !!optionsOrLoose,
311
+ includePrerelease: false,
312
+ };
313
+ }
314
+ if (version instanceof SemVer) {
315
+ if (version.loose === optionsOrLoose.loose) {
316
+ return version;
317
+ }
318
+ else {
319
+ version = version.version;
320
+ }
321
+ }
322
+ else if (typeof version !== "string") {
323
+ throw new TypeError("Invalid Version: " + version);
324
+ }
325
+ if (version.length > MAX_LENGTH) {
326
+ throw new TypeError("version is longer than " + MAX_LENGTH + " characters");
327
+ }
328
+ if (!(this instanceof SemVer)) {
329
+ return new SemVer(version, optionsOrLoose);
330
+ }
331
+ this.options = optionsOrLoose;
332
+ this.loose = !!optionsOrLoose.loose;
333
+ const m = version.trim().match(optionsOrLoose.loose ? re[LOOSE] : re[FULL]);
334
+ if (!m) {
335
+ throw new TypeError("Invalid Version: " + version);
336
+ }
337
+ this.raw = version;
338
+ // these are actually numbers
339
+ this.major = +m[1];
340
+ this.minor = +m[2];
341
+ this.patch = +m[3];
342
+ if (this.major > Number.MAX_SAFE_INTEGER || this.major < 0) {
343
+ throw new TypeError("Invalid major version");
344
+ }
345
+ if (this.minor > Number.MAX_SAFE_INTEGER || this.minor < 0) {
346
+ throw new TypeError("Invalid minor version");
347
+ }
348
+ if (this.patch > Number.MAX_SAFE_INTEGER || this.patch < 0) {
349
+ throw new TypeError("Invalid patch version");
350
+ }
351
+ // numberify any prerelease numeric ids
352
+ if (!m[4]) {
353
+ this.prerelease = [];
354
+ }
355
+ else {
356
+ this.prerelease = m[4].split(".").map((id) => {
357
+ if (/^[0-9]+$/.test(id)) {
358
+ const num = +id;
359
+ if (num >= 0 && num < Number.MAX_SAFE_INTEGER) {
360
+ return num;
361
+ }
362
+ }
363
+ return id;
364
+ });
365
+ }
366
+ this.build = m[5] ? m[5].split(".") : [];
367
+ this.format();
368
+ }
369
+ format() {
370
+ this.version = this.major + "." + this.minor + "." + this.patch;
371
+ if (this.prerelease.length) {
372
+ this.version += "-" + this.prerelease.join(".");
373
+ }
374
+ return this.version;
375
+ }
376
+ compare(other) {
377
+ if (!(other instanceof SemVer)) {
378
+ other = new SemVer(other, this.options);
379
+ }
380
+ return this.compareMain(other) || this.comparePre(other);
381
+ }
382
+ compareMain(other) {
383
+ if (!(other instanceof SemVer)) {
384
+ other = new SemVer(other, this.options);
385
+ }
386
+ return (compareIdentifiers(this.major, other.major) ||
387
+ compareIdentifiers(this.minor, other.minor) ||
388
+ compareIdentifiers(this.patch, other.patch));
389
+ }
390
+ comparePre(other) {
391
+ if (!(other instanceof SemVer)) {
392
+ other = new SemVer(other, this.options);
393
+ }
394
+ // NOT having a prerelease is > having one
395
+ if (this.prerelease.length && !other.prerelease.length) {
396
+ return -1;
397
+ }
398
+ else if (!this.prerelease.length && other.prerelease.length) {
399
+ return 1;
400
+ }
401
+ else if (!this.prerelease.length && !other.prerelease.length) {
402
+ return 0;
403
+ }
404
+ let i = 0;
405
+ do {
406
+ const a = this.prerelease[i];
407
+ const b = other.prerelease[i];
408
+ if (a === undefined && b === undefined) {
409
+ return 0;
410
+ }
411
+ else if (b === undefined) {
412
+ return 1;
413
+ }
414
+ else if (a === undefined) {
415
+ return -1;
416
+ }
417
+ else if (a === b) {
418
+ continue;
419
+ }
420
+ else {
421
+ return compareIdentifiers(a, b);
422
+ }
423
+ } while (++i);
424
+ return 1;
425
+ }
426
+ compareBuild(other) {
427
+ if (!(other instanceof SemVer)) {
428
+ other = new SemVer(other, this.options);
429
+ }
430
+ let i = 0;
431
+ do {
432
+ const a = this.build[i];
433
+ const b = other.build[i];
434
+ if (a === undefined && b === undefined) {
435
+ return 0;
436
+ }
437
+ else if (b === undefined) {
438
+ return 1;
439
+ }
440
+ else if (a === undefined) {
441
+ return -1;
442
+ }
443
+ else if (a === b) {
444
+ continue;
445
+ }
446
+ else {
447
+ return compareIdentifiers(a, b);
448
+ }
449
+ } while (++i);
450
+ return 1;
451
+ }
452
+ inc(release, identifier) {
453
+ switch (release) {
454
+ case "premajor":
455
+ this.prerelease.length = 0;
456
+ this.patch = 0;
457
+ this.minor = 0;
458
+ this.major++;
459
+ this.inc("pre", identifier);
460
+ break;
461
+ case "preminor":
462
+ this.prerelease.length = 0;
463
+ this.patch = 0;
464
+ this.minor++;
465
+ this.inc("pre", identifier);
466
+ break;
467
+ case "prepatch":
468
+ // If this is already a prerelease, it will bump to the next version
469
+ // drop any prereleases that might already exist, since they are not
470
+ // relevant at this point.
471
+ this.prerelease.length = 0;
472
+ this.inc("patch", identifier);
473
+ this.inc("pre", identifier);
474
+ break;
475
+ // If the input is a non-prerelease version, this acts the same as
476
+ // prepatch.
477
+ case "prerelease":
478
+ if (this.prerelease.length === 0) {
479
+ this.inc("patch", identifier);
480
+ }
481
+ this.inc("pre", identifier);
482
+ break;
483
+ case "major":
484
+ // If this is a pre-major version, bump up to the same major version.
485
+ // Otherwise increment major.
486
+ // 1.0.0-5 bumps to 1.0.0
487
+ // 1.1.0 bumps to 2.0.0
488
+ if (this.minor !== 0 ||
489
+ this.patch !== 0 ||
490
+ this.prerelease.length === 0) {
491
+ this.major++;
492
+ }
493
+ this.minor = 0;
494
+ this.patch = 0;
495
+ this.prerelease = [];
496
+ break;
497
+ case "minor":
498
+ // If this is a pre-minor version, bump up to the same minor version.
499
+ // Otherwise increment minor.
500
+ // 1.2.0-5 bumps to 1.2.0
501
+ // 1.2.1 bumps to 1.3.0
502
+ if (this.patch !== 0 || this.prerelease.length === 0) {
503
+ this.minor++;
504
+ }
505
+ this.patch = 0;
506
+ this.prerelease = [];
507
+ break;
508
+ case "patch":
509
+ // If this is not a pre-release version, it will increment the patch.
510
+ // If it is a pre-release it will bump up to the same patch version.
511
+ // 1.2.0-5 patches to 1.2.0
512
+ // 1.2.0 patches to 1.2.1
513
+ if (this.prerelease.length === 0) {
514
+ this.patch++;
515
+ }
516
+ this.prerelease = [];
517
+ break;
518
+ // This probably shouldn't be used publicly.
519
+ // 1.0.0 "pre" would become 1.0.0-0 which is the wrong direction.
520
+ case "pre":
521
+ if (this.prerelease.length === 0) {
522
+ this.prerelease = [0];
523
+ }
524
+ else {
525
+ let i = this.prerelease.length;
526
+ while (--i >= 0) {
527
+ if (typeof this.prerelease[i] === "number") {
528
+ this.prerelease[i]++;
529
+ i = -2;
530
+ }
531
+ }
532
+ if (i === -1) {
533
+ // didn't increment anything
534
+ this.prerelease.push(0);
535
+ }
536
+ }
537
+ if (identifier) {
538
+ // 1.2.0-beta.1 bumps to 1.2.0-beta.2,
539
+ // 1.2.0-beta.fooblz or 1.2.0-beta bumps to 1.2.0-beta.0
540
+ if (this.prerelease[0] === identifier) {
541
+ if (isNaN(this.prerelease[1])) {
542
+ this.prerelease = [identifier, 0];
543
+ }
544
+ }
545
+ else {
546
+ this.prerelease = [identifier, 0];
547
+ }
548
+ }
549
+ break;
550
+ default:
551
+ throw new Error("invalid increment argument: " + release);
552
+ }
553
+ this.format();
554
+ this.raw = this.version;
555
+ return this;
556
+ }
557
+ toString() {
558
+ return this.version;
559
+ }
560
+ }
561
+ /**
562
+ * Return the version incremented by the release type (major, minor, patch, or prerelease), or null if it's not valid.
563
+ */
564
+ export function inc(version, release, optionsOrLoose, identifier) {
565
+ if (typeof optionsOrLoose === "string") {
566
+ identifier = optionsOrLoose;
567
+ optionsOrLoose = undefined;
568
+ }
569
+ try {
570
+ return new SemVer(version, optionsOrLoose).inc(release, identifier).version;
571
+ }
572
+ catch (er) {
573
+ return null;
574
+ }
575
+ }
576
+ export function diff(version1, version2, optionsOrLoose) {
577
+ if (eq(version1, version2, optionsOrLoose)) {
578
+ return null;
579
+ }
580
+ else {
581
+ const v1 = parse(version1);
582
+ const v2 = parse(version2);
583
+ let prefix = "";
584
+ let defaultResult = null;
585
+ if (v1 && v2) {
586
+ if (v1.prerelease.length || v2.prerelease.length) {
587
+ prefix = "pre";
588
+ defaultResult = "prerelease";
589
+ }
590
+ for (const key in v1) {
591
+ if (key === "major" || key === "minor" || key === "patch") {
592
+ if (v1[key] !== v2[key]) {
593
+ return (prefix + key);
594
+ }
595
+ }
596
+ }
597
+ }
598
+ return defaultResult; // may be undefined
599
+ }
600
+ }
601
+ const numeric = /^[0-9]+$/;
602
+ export function compareIdentifiers(a, b) {
603
+ const anum = numeric.test(a);
604
+ const bnum = numeric.test(b);
605
+ if (a === null || b === null)
606
+ throw "Comparison against null invalid";
607
+ if (anum && bnum) {
608
+ a = +a;
609
+ b = +b;
610
+ }
611
+ return a === b ? 0 : anum && !bnum ? -1 : bnum && !anum ? 1 : a < b ? -1 : 1;
612
+ }
613
+ export function rcompareIdentifiers(a, b) {
614
+ return compareIdentifiers(b, a);
615
+ }
616
+ /**
617
+ * Return the major version number.
618
+ */
619
+ export function major(v, optionsOrLoose) {
620
+ return new SemVer(v, optionsOrLoose).major;
621
+ }
622
+ /**
623
+ * Return the minor version number.
624
+ */
625
+ export function minor(v, optionsOrLoose) {
626
+ return new SemVer(v, optionsOrLoose).minor;
627
+ }
628
+ /**
629
+ * Return the patch version number.
630
+ */
631
+ export function patch(v, optionsOrLoose) {
632
+ return new SemVer(v, optionsOrLoose).patch;
633
+ }
634
+ export function compare(v1, v2, optionsOrLoose) {
635
+ return new SemVer(v1, optionsOrLoose).compare(new SemVer(v2, optionsOrLoose));
636
+ }
637
+ export function compareLoose(a, b) {
638
+ return compare(a, b, true);
639
+ }
640
+ export function compareBuild(a, b, loose) {
641
+ var versionA = new SemVer(a, loose);
642
+ var versionB = new SemVer(b, loose);
643
+ return versionA.compare(versionB) || versionA.compareBuild(versionB);
644
+ }
645
+ export function rcompare(v1, v2, optionsOrLoose) {
646
+ return compare(v2, v1, optionsOrLoose);
647
+ }
648
+ export function sort(list, optionsOrLoose) {
649
+ return list.sort((a, b) => {
650
+ return compareBuild(a, b, optionsOrLoose);
651
+ });
652
+ }
653
+ export function rsort(list, optionsOrLoose) {
654
+ return list.sort((a, b) => {
655
+ return compareBuild(b, a, optionsOrLoose);
656
+ });
657
+ }
658
+ export function gt(v1, v2, optionsOrLoose) {
659
+ return compare(v1, v2, optionsOrLoose) > 0;
660
+ }
661
+ export function lt(v1, v2, optionsOrLoose) {
662
+ return compare(v1, v2, optionsOrLoose) < 0;
663
+ }
664
+ export function eq(v1, v2, optionsOrLoose) {
665
+ return compare(v1, v2, optionsOrLoose) === 0;
666
+ }
667
+ export function neq(v1, v2, optionsOrLoose) {
668
+ return compare(v1, v2, optionsOrLoose) !== 0;
669
+ }
670
+ export function gte(v1, v2, optionsOrLoose) {
671
+ return compare(v1, v2, optionsOrLoose) >= 0;
672
+ }
673
+ export function lte(v1, v2, optionsOrLoose) {
674
+ return compare(v1, v2, optionsOrLoose) <= 0;
675
+ }
676
+ export function cmp(v1, operator, v2, optionsOrLoose) {
677
+ switch (operator) {
678
+ case "===":
679
+ if (typeof v1 === "object")
680
+ v1 = v1.version;
681
+ if (typeof v2 === "object")
682
+ v2 = v2.version;
683
+ return v1 === v2;
684
+ case "!==":
685
+ if (typeof v1 === "object")
686
+ v1 = v1.version;
687
+ if (typeof v2 === "object")
688
+ v2 = v2.version;
689
+ return v1 !== v2;
690
+ case "":
691
+ case "=":
692
+ case "==":
693
+ return eq(v1, v2, optionsOrLoose);
694
+ case "!=":
695
+ return neq(v1, v2, optionsOrLoose);
696
+ case ">":
697
+ return gt(v1, v2, optionsOrLoose);
698
+ case ">=":
699
+ return gte(v1, v2, optionsOrLoose);
700
+ case "<":
701
+ return lt(v1, v2, optionsOrLoose);
702
+ case "<=":
703
+ return lte(v1, v2, optionsOrLoose);
704
+ default:
705
+ throw new TypeError("Invalid operator: " + operator);
706
+ }
707
+ }
708
+ const ANY = {};
709
+ export class Comparator {
710
+ constructor(comp, optionsOrLoose) {
711
+ Object.defineProperty(this, "semver", {
712
+ enumerable: true,
713
+ configurable: true,
714
+ writable: true,
715
+ value: void 0
716
+ });
717
+ Object.defineProperty(this, "operator", {
718
+ enumerable: true,
719
+ configurable: true,
720
+ writable: true,
721
+ value: void 0
722
+ });
723
+ Object.defineProperty(this, "value", {
724
+ enumerable: true,
725
+ configurable: true,
726
+ writable: true,
727
+ value: void 0
728
+ });
729
+ Object.defineProperty(this, "loose", {
730
+ enumerable: true,
731
+ configurable: true,
732
+ writable: true,
733
+ value: void 0
734
+ });
735
+ Object.defineProperty(this, "options", {
736
+ enumerable: true,
737
+ configurable: true,
738
+ writable: true,
739
+ value: void 0
740
+ });
741
+ if (!optionsOrLoose || typeof optionsOrLoose !== "object") {
742
+ optionsOrLoose = {
743
+ loose: !!optionsOrLoose,
744
+ includePrerelease: false,
745
+ };
746
+ }
747
+ if (comp instanceof Comparator) {
748
+ if (comp.loose === !!optionsOrLoose.loose) {
749
+ return comp;
750
+ }
751
+ else {
752
+ comp = comp.value;
753
+ }
754
+ }
755
+ if (!(this instanceof Comparator)) {
756
+ return new Comparator(comp, optionsOrLoose);
757
+ }
758
+ this.options = optionsOrLoose;
759
+ this.loose = !!optionsOrLoose.loose;
760
+ this.parse(comp);
761
+ if (this.semver === ANY) {
762
+ this.value = "";
763
+ }
764
+ else {
765
+ this.value = this.operator + this.semver.version;
766
+ }
767
+ }
768
+ parse(comp) {
769
+ const r = this.options.loose ? re[COMPARATORLOOSE] : re[COMPARATOR];
770
+ const m = comp.match(r);
771
+ if (!m) {
772
+ throw new TypeError("Invalid comparator: " + comp);
773
+ }
774
+ const m1 = m[1];
775
+ this.operator = m1 !== undefined ? m1 : "";
776
+ if (this.operator === "=") {
777
+ this.operator = "";
778
+ }
779
+ // if it literally is just '>' or '' then allow anything.
780
+ if (!m[2]) {
781
+ this.semver = ANY;
782
+ }
783
+ else {
784
+ this.semver = new SemVer(m[2], this.options.loose);
785
+ }
786
+ }
787
+ test(version) {
788
+ if (this.semver === ANY || version === ANY) {
789
+ return true;
790
+ }
791
+ if (typeof version === "string") {
792
+ version = new SemVer(version, this.options);
793
+ }
794
+ return cmp(version, this.operator, this.semver, this.options);
795
+ }
796
+ intersects(comp, optionsOrLoose) {
797
+ if (!(comp instanceof Comparator)) {
798
+ throw new TypeError("a Comparator is required");
799
+ }
800
+ if (!optionsOrLoose || typeof optionsOrLoose !== "object") {
801
+ optionsOrLoose = {
802
+ loose: !!optionsOrLoose,
803
+ includePrerelease: false,
804
+ };
805
+ }
806
+ let rangeTmp;
807
+ if (this.operator === "") {
808
+ if (this.value === "") {
809
+ return true;
810
+ }
811
+ rangeTmp = new Range(comp.value, optionsOrLoose);
812
+ return satisfies(this.value, rangeTmp, optionsOrLoose);
813
+ }
814
+ else if (comp.operator === "") {
815
+ if (comp.value === "") {
816
+ return true;
817
+ }
818
+ rangeTmp = new Range(this.value, optionsOrLoose);
819
+ return satisfies(comp.semver, rangeTmp, optionsOrLoose);
820
+ }
821
+ const sameDirectionIncreasing = (this.operator === ">=" || this.operator === ">") &&
822
+ (comp.operator === ">=" || comp.operator === ">");
823
+ const sameDirectionDecreasing = (this.operator === "<=" || this.operator === "<") &&
824
+ (comp.operator === "<=" || comp.operator === "<");
825
+ const sameSemVer = this.semver.version === comp.semver.version;
826
+ const differentDirectionsInclusive = (this.operator === ">=" || this.operator === "<=") &&
827
+ (comp.operator === ">=" || comp.operator === "<=");
828
+ const oppositeDirectionsLessThan = cmp(this.semver, "<", comp.semver, optionsOrLoose) &&
829
+ (this.operator === ">=" || this.operator === ">") &&
830
+ (comp.operator === "<=" || comp.operator === "<");
831
+ const oppositeDirectionsGreaterThan = cmp(this.semver, ">", comp.semver, optionsOrLoose) &&
832
+ (this.operator === "<=" || this.operator === "<") &&
833
+ (comp.operator === ">=" || comp.operator === ">");
834
+ return (sameDirectionIncreasing ||
835
+ sameDirectionDecreasing ||
836
+ (sameSemVer && differentDirectionsInclusive) ||
837
+ oppositeDirectionsLessThan ||
838
+ oppositeDirectionsGreaterThan);
839
+ }
840
+ toString() {
841
+ return this.value;
842
+ }
843
+ }
844
+ export class Range {
845
+ constructor(range, optionsOrLoose) {
846
+ Object.defineProperty(this, "range", {
847
+ enumerable: true,
848
+ configurable: true,
849
+ writable: true,
850
+ value: void 0
851
+ });
852
+ Object.defineProperty(this, "raw", {
853
+ enumerable: true,
854
+ configurable: true,
855
+ writable: true,
856
+ value: void 0
857
+ });
858
+ Object.defineProperty(this, "loose", {
859
+ enumerable: true,
860
+ configurable: true,
861
+ writable: true,
862
+ value: void 0
863
+ });
864
+ Object.defineProperty(this, "options", {
865
+ enumerable: true,
866
+ configurable: true,
867
+ writable: true,
868
+ value: void 0
869
+ });
870
+ Object.defineProperty(this, "includePrerelease", {
871
+ enumerable: true,
872
+ configurable: true,
873
+ writable: true,
874
+ value: void 0
875
+ });
876
+ Object.defineProperty(this, "set", {
877
+ enumerable: true,
878
+ configurable: true,
879
+ writable: true,
880
+ value: void 0
881
+ });
882
+ if (!optionsOrLoose || typeof optionsOrLoose !== "object") {
883
+ optionsOrLoose = {
884
+ loose: !!optionsOrLoose,
885
+ includePrerelease: false,
886
+ };
887
+ }
888
+ if (range instanceof Range) {
889
+ if (range.loose === !!optionsOrLoose.loose &&
890
+ range.includePrerelease === !!optionsOrLoose.includePrerelease) {
891
+ return range;
892
+ }
893
+ else {
894
+ return new Range(range.raw, optionsOrLoose);
895
+ }
896
+ }
897
+ if (range instanceof Comparator) {
898
+ return new Range(range.value, optionsOrLoose);
899
+ }
900
+ if (!(this instanceof Range)) {
901
+ return new Range(range, optionsOrLoose);
902
+ }
903
+ this.options = optionsOrLoose;
904
+ this.loose = !!optionsOrLoose.loose;
905
+ this.includePrerelease = !!optionsOrLoose.includePrerelease;
906
+ // First, split based on boolean or ||
907
+ this.raw = range;
908
+ this.set = range
909
+ .split(/\s*\|\|\s*/)
910
+ .map((range) => this.parseRange(range.trim()))
911
+ .filter((c) => {
912
+ // throw out any that are not relevant for whatever reason
913
+ return c.length;
914
+ });
915
+ if (!this.set.length) {
916
+ throw new TypeError("Invalid SemVer Range: " + range);
917
+ }
918
+ this.format();
919
+ }
920
+ format() {
921
+ this.range = this.set
922
+ .map((comps) => comps.join(" ").trim())
923
+ .join("||")
924
+ .trim();
925
+ return this.range;
926
+ }
927
+ parseRange(range) {
928
+ const loose = this.options.loose;
929
+ range = range.trim();
930
+ // `1.2.3 - 1.2.4` => `>=1.2.3 <=1.2.4`
931
+ const hr = loose ? re[HYPHENRANGELOOSE] : re[HYPHENRANGE];
932
+ range = range.replace(hr, hyphenReplace);
933
+ // `> 1.2.3 < 1.2.5` => `>1.2.3 <1.2.5`
934
+ range = range.replace(re[COMPARATORTRIM], comparatorTrimReplace);
935
+ // `~ 1.2.3` => `~1.2.3`
936
+ range = range.replace(re[TILDETRIM], tildeTrimReplace);
937
+ // `^ 1.2.3` => `^1.2.3`
938
+ range = range.replace(re[CARETTRIM], caretTrimReplace);
939
+ // normalize spaces
940
+ range = range.split(/\s+/).join(" ");
941
+ // At this point, the range is completely trimmed and
942
+ // ready to be split into comparators.
943
+ const compRe = loose ? re[COMPARATORLOOSE] : re[COMPARATOR];
944
+ let set = range
945
+ .split(" ")
946
+ .map((comp) => parseComparator(comp, this.options))
947
+ .join(" ")
948
+ .split(/\s+/);
949
+ if (this.options.loose) {
950
+ // in loose mode, throw out any that are not valid comparators
951
+ set = set.filter((comp) => {
952
+ return !!comp.match(compRe);
953
+ });
954
+ }
955
+ return set.map((comp) => new Comparator(comp, this.options));
956
+ }
957
+ test(version) {
958
+ if (typeof version === "string") {
959
+ version = new SemVer(version, this.options);
960
+ }
961
+ for (var i = 0; i < this.set.length; i++) {
962
+ if (testSet(this.set[i], version, this.options)) {
963
+ return true;
964
+ }
965
+ }
966
+ return false;
967
+ }
968
+ intersects(range, optionsOrLoose) {
969
+ if (!(range instanceof Range)) {
970
+ throw new TypeError("a Range is required");
971
+ }
972
+ return this.set.some((thisComparators) => {
973
+ return (isSatisfiable(thisComparators, optionsOrLoose) &&
974
+ range.set.some((rangeComparators) => {
975
+ return (isSatisfiable(rangeComparators, optionsOrLoose) &&
976
+ thisComparators.every((thisComparator) => {
977
+ return rangeComparators.every((rangeComparator) => {
978
+ return thisComparator.intersects(rangeComparator, optionsOrLoose);
979
+ });
980
+ }));
981
+ }));
982
+ });
983
+ }
984
+ toString() {
985
+ return this.range;
986
+ }
987
+ }
988
+ function testSet(set, version, options) {
989
+ for (let i = 0; i < set.length; i++) {
990
+ if (!set[i].test(version)) {
991
+ return false;
992
+ }
993
+ }
994
+ if (version.prerelease.length && !options.includePrerelease) {
995
+ // Find the set of versions that are allowed to have prereleases
996
+ // For example, ^1.2.3-pr.1 desugars to >=1.2.3-pr.1 <2.0.0
997
+ // That should allow `1.2.3-pr.2` to pass.
998
+ // However, `1.2.4-alpha.notready` should NOT be allowed,
999
+ // even though it's within the range set by the comparators.
1000
+ for (let i = 0; i < set.length; i++) {
1001
+ if (set[i].semver === ANY) {
1002
+ continue;
1003
+ }
1004
+ if (set[i].semver.prerelease.length > 0) {
1005
+ const allowed = set[i].semver;
1006
+ if (allowed.major === version.major &&
1007
+ allowed.minor === version.minor &&
1008
+ allowed.patch === version.patch) {
1009
+ return true;
1010
+ }
1011
+ }
1012
+ }
1013
+ // Version has a -pre, but it's not one of the ones we like.
1014
+ return false;
1015
+ }
1016
+ return true;
1017
+ }
1018
+ // take a set of comparators and determine whether there
1019
+ // exists a version which can satisfy it
1020
+ function isSatisfiable(comparators, options) {
1021
+ let result = true;
1022
+ const remainingComparators = comparators.slice();
1023
+ let testComparator = remainingComparators.pop();
1024
+ while (result && remainingComparators.length) {
1025
+ result = remainingComparators.every((otherComparator) => {
1026
+ return testComparator?.intersects(otherComparator, options);
1027
+ });
1028
+ testComparator = remainingComparators.pop();
1029
+ }
1030
+ return result;
1031
+ }
1032
+ // Mostly just for testing and legacy API reasons
1033
+ export function toComparators(range, optionsOrLoose) {
1034
+ return new Range(range, optionsOrLoose).set.map((comp) => {
1035
+ return comp
1036
+ .map((c) => c.value)
1037
+ .join(" ")
1038
+ .trim()
1039
+ .split(" ");
1040
+ });
1041
+ }
1042
+ // comprised of xranges, tildes, stars, and gtlt's at this point.
1043
+ // already replaced the hyphen ranges
1044
+ // turn into a set of JUST comparators.
1045
+ function parseComparator(comp, options) {
1046
+ comp = replaceCarets(comp, options);
1047
+ comp = replaceTildes(comp, options);
1048
+ comp = replaceXRanges(comp, options);
1049
+ comp = replaceStars(comp, options);
1050
+ return comp;
1051
+ }
1052
+ function isX(id) {
1053
+ return !id || id.toLowerCase() === "x" || id === "*";
1054
+ }
1055
+ // ~, ~> --> * (any, kinda silly)
1056
+ // ~2, ~2.x, ~2.x.x, ~>2, ~>2.x ~>2.x.x --> >=2.0.0 <3.0.0
1057
+ // ~2.0, ~2.0.x, ~>2.0, ~>2.0.x --> >=2.0.0 <2.1.0
1058
+ // ~1.2, ~1.2.x, ~>1.2, ~>1.2.x --> >=1.2.0 <1.3.0
1059
+ // ~1.2.3, ~>1.2.3 --> >=1.2.3 <1.3.0
1060
+ // ~1.2.0, ~>1.2.0 --> >=1.2.0 <1.3.0
1061
+ function replaceTildes(comp, options) {
1062
+ return comp
1063
+ .trim()
1064
+ .split(/\s+/)
1065
+ .map((comp) => replaceTilde(comp, options))
1066
+ .join(" ");
1067
+ }
1068
+ function replaceTilde(comp, options) {
1069
+ const r = options.loose ? re[TILDELOOSE] : re[TILDE];
1070
+ return comp.replace(r, (_, M, m, p, pr) => {
1071
+ let ret;
1072
+ if (isX(M)) {
1073
+ ret = "";
1074
+ }
1075
+ else if (isX(m)) {
1076
+ ret = ">=" + M + ".0.0 <" + (+M + 1) + ".0.0";
1077
+ }
1078
+ else if (isX(p)) {
1079
+ // ~1.2 == >=1.2.0 <1.3.0
1080
+ ret = ">=" + M + "." + m + ".0 <" + M + "." + (+m + 1) + ".0";
1081
+ }
1082
+ else if (pr) {
1083
+ ret = ">=" +
1084
+ M +
1085
+ "." +
1086
+ m +
1087
+ "." +
1088
+ p +
1089
+ "-" +
1090
+ pr +
1091
+ " <" +
1092
+ M +
1093
+ "." +
1094
+ (+m + 1) +
1095
+ ".0";
1096
+ }
1097
+ else {
1098
+ // ~1.2.3 == >=1.2.3 <1.3.0
1099
+ ret = ">=" + M + "." + m + "." + p + " <" + M + "." + (+m + 1) + ".0";
1100
+ }
1101
+ return ret;
1102
+ });
1103
+ }
1104
+ // ^ --> * (any, kinda silly)
1105
+ // ^2, ^2.x, ^2.x.x --> >=2.0.0 <3.0.0
1106
+ // ^2.0, ^2.0.x --> >=2.0.0 <3.0.0
1107
+ // ^1.2, ^1.2.x --> >=1.2.0 <2.0.0
1108
+ // ^1.2.3 --> >=1.2.3 <2.0.0
1109
+ // ^1.2.0 --> >=1.2.0 <2.0.0
1110
+ function replaceCarets(comp, options) {
1111
+ return comp
1112
+ .trim()
1113
+ .split(/\s+/)
1114
+ .map((comp) => replaceCaret(comp, options))
1115
+ .join(" ");
1116
+ }
1117
+ function replaceCaret(comp, options) {
1118
+ const r = options.loose ? re[CARETLOOSE] : re[CARET];
1119
+ return comp.replace(r, (_, M, m, p, pr) => {
1120
+ let ret;
1121
+ if (isX(M)) {
1122
+ ret = "";
1123
+ }
1124
+ else if (isX(m)) {
1125
+ ret = ">=" + M + ".0.0 <" + (+M + 1) + ".0.0";
1126
+ }
1127
+ else if (isX(p)) {
1128
+ if (M === "0") {
1129
+ ret = ">=" + M + "." + m + ".0 <" + M + "." + (+m + 1) + ".0";
1130
+ }
1131
+ else {
1132
+ ret = ">=" + M + "." + m + ".0 <" + (+M + 1) + ".0.0";
1133
+ }
1134
+ }
1135
+ else if (pr) {
1136
+ if (M === "0") {
1137
+ if (m === "0") {
1138
+ ret = ">=" +
1139
+ M +
1140
+ "." +
1141
+ m +
1142
+ "." +
1143
+ p +
1144
+ "-" +
1145
+ pr +
1146
+ " <" +
1147
+ M +
1148
+ "." +
1149
+ m +
1150
+ "." +
1151
+ (+p + 1);
1152
+ }
1153
+ else {
1154
+ ret = ">=" +
1155
+ M +
1156
+ "." +
1157
+ m +
1158
+ "." +
1159
+ p +
1160
+ "-" +
1161
+ pr +
1162
+ " <" +
1163
+ M +
1164
+ "." +
1165
+ (+m + 1) +
1166
+ ".0";
1167
+ }
1168
+ }
1169
+ else {
1170
+ ret = ">=" + M + "." + m + "." + p + "-" + pr + " <" + (+M + 1) +
1171
+ ".0.0";
1172
+ }
1173
+ }
1174
+ else {
1175
+ if (M === "0") {
1176
+ if (m === "0") {
1177
+ ret = ">=" + M + "." + m + "." + p + " <" + M + "." + m + "." +
1178
+ (+p + 1);
1179
+ }
1180
+ else {
1181
+ ret = ">=" + M + "." + m + "." + p + " <" + M + "." + (+m + 1) + ".0";
1182
+ }
1183
+ }
1184
+ else {
1185
+ ret = ">=" + M + "." + m + "." + p + " <" + (+M + 1) + ".0.0";
1186
+ }
1187
+ }
1188
+ return ret;
1189
+ });
1190
+ }
1191
+ function replaceXRanges(comp, options) {
1192
+ return comp
1193
+ .split(/\s+/)
1194
+ .map((comp) => replaceXRange(comp, options))
1195
+ .join(" ");
1196
+ }
1197
+ function replaceXRange(comp, options) {
1198
+ comp = comp.trim();
1199
+ const r = options.loose ? re[XRANGELOOSE] : re[XRANGE];
1200
+ return comp.replace(r, (ret, gtlt, M, m, p, pr) => {
1201
+ const xM = isX(M);
1202
+ const xm = xM || isX(m);
1203
+ const xp = xm || isX(p);
1204
+ const anyX = xp;
1205
+ if (gtlt === "=" && anyX) {
1206
+ gtlt = "";
1207
+ }
1208
+ if (xM) {
1209
+ if (gtlt === ">" || gtlt === "<") {
1210
+ // nothing is allowed
1211
+ ret = "<0.0.0";
1212
+ }
1213
+ else {
1214
+ // nothing is forbidden
1215
+ ret = "*";
1216
+ }
1217
+ }
1218
+ else if (gtlt && anyX) {
1219
+ // we know patch is an x, because we have any x at all.
1220
+ // replace X with 0
1221
+ if (xm) {
1222
+ m = 0;
1223
+ }
1224
+ p = 0;
1225
+ if (gtlt === ">") {
1226
+ // >1 => >=2.0.0
1227
+ // >1.2 => >=1.3.0
1228
+ // >1.2.3 => >= 1.2.4
1229
+ gtlt = ">=";
1230
+ if (xm) {
1231
+ M = +M + 1;
1232
+ m = 0;
1233
+ p = 0;
1234
+ }
1235
+ else {
1236
+ m = +m + 1;
1237
+ p = 0;
1238
+ }
1239
+ }
1240
+ else if (gtlt === "<=") {
1241
+ // <=0.7.x is actually <0.8.0, since any 0.7.x should
1242
+ // pass. Similarly, <=7.x is actually <8.0.0, etc.
1243
+ gtlt = "<";
1244
+ if (xm) {
1245
+ M = +M + 1;
1246
+ }
1247
+ else {
1248
+ m = +m + 1;
1249
+ }
1250
+ }
1251
+ ret = gtlt + M + "." + m + "." + p;
1252
+ }
1253
+ else if (xm) {
1254
+ ret = ">=" + M + ".0.0 <" + (+M + 1) + ".0.0";
1255
+ }
1256
+ else if (xp) {
1257
+ ret = ">=" + M + "." + m + ".0 <" + M + "." + (+m + 1) + ".0";
1258
+ }
1259
+ return ret;
1260
+ });
1261
+ }
1262
+ // Because * is AND-ed with everything else in the comparator,
1263
+ // and '' means "any version", just remove the *s entirely.
1264
+ function replaceStars(comp, options) {
1265
+ // Looseness is ignored here. star is always as loose as it gets!
1266
+ return comp.trim().replace(re[STAR], "");
1267
+ }
1268
+ // This function is passed to string.replace(re[HYPHENRANGE])
1269
+ // M, m, patch, prerelease, build
1270
+ // 1.2 - 3.4.5 => >=1.2.0 <=3.4.5
1271
+ // 1.2.3 - 3.4 => >=1.2.0 <3.5.0 Any 3.4.x will do
1272
+ // 1.2 - 3.4 => >=1.2.0 <3.5.0
1273
+ function hyphenReplace($0, from, fM, fm, fp, fpr, fb, to, tM, tm, tp, tpr, tb) {
1274
+ if (isX(fM)) {
1275
+ from = "";
1276
+ }
1277
+ else if (isX(fm)) {
1278
+ from = ">=" + fM + ".0.0";
1279
+ }
1280
+ else if (isX(fp)) {
1281
+ from = ">=" + fM + "." + fm + ".0";
1282
+ }
1283
+ else {
1284
+ from = ">=" + from;
1285
+ }
1286
+ if (isX(tM)) {
1287
+ to = "";
1288
+ }
1289
+ else if (isX(tm)) {
1290
+ to = "<" + (+tM + 1) + ".0.0";
1291
+ }
1292
+ else if (isX(tp)) {
1293
+ to = "<" + tM + "." + (+tm + 1) + ".0";
1294
+ }
1295
+ else if (tpr) {
1296
+ to = "<=" + tM + "." + tm + "." + tp + "-" + tpr;
1297
+ }
1298
+ else {
1299
+ to = "<=" + to;
1300
+ }
1301
+ return (from + " " + to).trim();
1302
+ }
1303
+ export function satisfies(version, range, optionsOrLoose) {
1304
+ try {
1305
+ range = new Range(range, optionsOrLoose);
1306
+ }
1307
+ catch (er) {
1308
+ return false;
1309
+ }
1310
+ return range.test(version);
1311
+ }
1312
+ export function maxSatisfying(versions, range, optionsOrLoose) {
1313
+ //todo
1314
+ var max = null;
1315
+ var maxSV = null;
1316
+ try {
1317
+ var rangeObj = new Range(range, optionsOrLoose);
1318
+ }
1319
+ catch (er) {
1320
+ return null;
1321
+ }
1322
+ versions.forEach((v) => {
1323
+ if (rangeObj.test(v)) {
1324
+ // satisfies(v, range, options)
1325
+ if (!max || (maxSV && maxSV.compare(v) === -1)) {
1326
+ // compare(max, v, true)
1327
+ max = v;
1328
+ maxSV = new SemVer(max, optionsOrLoose);
1329
+ }
1330
+ }
1331
+ });
1332
+ return max;
1333
+ }
1334
+ export function minSatisfying(versions, range, optionsOrLoose) {
1335
+ //todo
1336
+ var min = null;
1337
+ var minSV = null;
1338
+ try {
1339
+ var rangeObj = new Range(range, optionsOrLoose);
1340
+ }
1341
+ catch (er) {
1342
+ return null;
1343
+ }
1344
+ versions.forEach((v) => {
1345
+ if (rangeObj.test(v)) {
1346
+ // satisfies(v, range, options)
1347
+ if (!min || minSV.compare(v) === 1) {
1348
+ // compare(min, v, true)
1349
+ min = v;
1350
+ minSV = new SemVer(min, optionsOrLoose);
1351
+ }
1352
+ }
1353
+ });
1354
+ return min;
1355
+ }
1356
+ export function minVersion(range, optionsOrLoose) {
1357
+ range = new Range(range, optionsOrLoose);
1358
+ var minver = new SemVer("0.0.0");
1359
+ if (range.test(minver)) {
1360
+ return minver;
1361
+ }
1362
+ minver = new SemVer("0.0.0-0");
1363
+ if (range.test(minver)) {
1364
+ return minver;
1365
+ }
1366
+ minver = null;
1367
+ for (var i = 0; i < range.set.length; ++i) {
1368
+ var comparators = range.set[i];
1369
+ comparators.forEach((comparator) => {
1370
+ // Clone to avoid manipulating the comparator's semver object.
1371
+ var compver = new SemVer(comparator.semver.version);
1372
+ switch (comparator.operator) {
1373
+ case ">":
1374
+ if (compver.prerelease.length === 0) {
1375
+ compver.patch++;
1376
+ }
1377
+ else {
1378
+ compver.prerelease.push(0);
1379
+ }
1380
+ compver.raw = compver.format();
1381
+ /* fallthrough */
1382
+ case "":
1383
+ case ">=":
1384
+ if (!minver || gt(minver, compver)) {
1385
+ minver = compver;
1386
+ }
1387
+ break;
1388
+ case "<":
1389
+ case "<=":
1390
+ /* Ignore maximum versions */
1391
+ break;
1392
+ /* istanbul ignore next */
1393
+ default:
1394
+ throw new Error("Unexpected operation: " + comparator.operator);
1395
+ }
1396
+ });
1397
+ }
1398
+ if (minver && range.test(minver)) {
1399
+ return minver;
1400
+ }
1401
+ return null;
1402
+ }
1403
+ export function validRange(range, optionsOrLoose) {
1404
+ try {
1405
+ if (range === null)
1406
+ return null;
1407
+ // Return '*' instead of '' so that truthiness works.
1408
+ // This will throw if it's invalid anyway
1409
+ return new Range(range, optionsOrLoose).range || "*";
1410
+ }
1411
+ catch (er) {
1412
+ return null;
1413
+ }
1414
+ }
1415
+ /**
1416
+ * Return true if version is less than all the versions possible in the range.
1417
+ */
1418
+ export function ltr(version, range, optionsOrLoose) {
1419
+ return outside(version, range, "<", optionsOrLoose);
1420
+ }
1421
+ /**
1422
+ * Return true if version is greater than all the versions possible in the range.
1423
+ */
1424
+ export function gtr(version, range, optionsOrLoose) {
1425
+ return outside(version, range, ">", optionsOrLoose);
1426
+ }
1427
+ /**
1428
+ * Return true if the version is outside the bounds of the range in either the high or low direction.
1429
+ * The hilo argument must be either the string '>' or '<'. (This is the function called by gtr and ltr.)
1430
+ */
1431
+ export function outside(version, range, hilo, optionsOrLoose) {
1432
+ version = new SemVer(version, optionsOrLoose);
1433
+ range = new Range(range, optionsOrLoose);
1434
+ let gtfn;
1435
+ let ltefn;
1436
+ let ltfn;
1437
+ let comp;
1438
+ let ecomp;
1439
+ switch (hilo) {
1440
+ case ">":
1441
+ gtfn = gt;
1442
+ ltefn = lte;
1443
+ ltfn = lt;
1444
+ comp = ">";
1445
+ ecomp = ">=";
1446
+ break;
1447
+ case "<":
1448
+ gtfn = lt;
1449
+ ltefn = gte;
1450
+ ltfn = gt;
1451
+ comp = "<";
1452
+ ecomp = "<=";
1453
+ break;
1454
+ default:
1455
+ throw new TypeError('Must provide a hilo val of "<" or ">"');
1456
+ }
1457
+ // If it satisifes the range it is not outside
1458
+ if (satisfies(version, range, optionsOrLoose)) {
1459
+ return false;
1460
+ }
1461
+ // From now on, variable terms are as if we're in "gtr" mode.
1462
+ // but note that everything is flipped for the "ltr" function.
1463
+ for (let i = 0; i < range.set.length; ++i) {
1464
+ const comparators = range.set[i];
1465
+ let high = null;
1466
+ let low = null;
1467
+ for (let comparator of comparators) {
1468
+ if (comparator.semver === ANY) {
1469
+ comparator = new Comparator(">=0.0.0");
1470
+ }
1471
+ high = high || comparator;
1472
+ low = low || comparator;
1473
+ if (gtfn(comparator.semver, high.semver, optionsOrLoose)) {
1474
+ high = comparator;
1475
+ }
1476
+ else if (ltfn(comparator.semver, low.semver, optionsOrLoose)) {
1477
+ low = comparator;
1478
+ }
1479
+ }
1480
+ if (high === null || low === null)
1481
+ return true;
1482
+ // If the edge version comparator has a operator then our version
1483
+ // isn't outside it
1484
+ if (high.operator === comp || high.operator === ecomp) {
1485
+ return false;
1486
+ }
1487
+ // If the lowest version comparator has an operator and our version
1488
+ // is less than it then it isn't higher than the range
1489
+ if ((!low.operator || low.operator === comp) &&
1490
+ ltefn(version, low.semver)) {
1491
+ return false;
1492
+ }
1493
+ else if (low.operator === ecomp && ltfn(version, low.semver)) {
1494
+ return false;
1495
+ }
1496
+ }
1497
+ return true;
1498
+ }
1499
+ export function prerelease(version, optionsOrLoose) {
1500
+ var parsed = parse(version, optionsOrLoose);
1501
+ return parsed && parsed.prerelease.length ? parsed.prerelease : null;
1502
+ }
1503
+ /**
1504
+ * Return true if any of the ranges comparators intersect
1505
+ */
1506
+ export function intersects(range1, range2, optionsOrLoose) {
1507
+ range1 = new Range(range1, optionsOrLoose);
1508
+ range2 = new Range(range2, optionsOrLoose);
1509
+ return range1.intersects(range2);
1510
+ }
1511
+ /**
1512
+ * Coerces a string to semver if possible
1513
+ */
1514
+ export function coerce(version, optionsOrLoose) {
1515
+ if (version instanceof SemVer) {
1516
+ return version;
1517
+ }
1518
+ if (typeof version !== "string") {
1519
+ return null;
1520
+ }
1521
+ const match = version.match(re[COERCE]);
1522
+ if (match == null) {
1523
+ return null;
1524
+ }
1525
+ return parse(match[1] + "." + (match[2] || "0") + "." + (match[3] || "0"), optionsOrLoose);
1526
+ }
1527
+ export default SemVer;