step-node-agent 3.20.2 → 3.21.0

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 (732) hide show
  1. package/node_modules/aws4/README.md +31 -1
  2. package/node_modules/aws4/aws4.js +10 -2
  3. package/node_modules/aws4/package.json +1 -1
  4. package/node_modules/content-type/HISTORY.md +5 -0
  5. package/node_modules/content-type/README.md +21 -19
  6. package/node_modules/content-type/index.js +12 -9
  7. package/node_modules/content-type/package.json +13 -11
  8. package/node_modules/get-intrinsic/.eslintrc +1 -0
  9. package/node_modules/get-intrinsic/CHANGELOG.md +12 -0
  10. package/node_modules/get-intrinsic/index.js +10 -0
  11. package/node_modules/get-intrinsic/package.json +7 -6
  12. package/node_modules/get-intrinsic/test/GetIntrinsic.js +1 -1
  13. package/node_modules/minimist/.eslintrc +25 -50
  14. package/node_modules/minimist/CHANGELOG.md +87 -1
  15. package/node_modules/minimist/README.md +14 -10
  16. package/node_modules/minimist/example/parse.js +2 -0
  17. package/node_modules/minimist/index.js +256 -242
  18. package/node_modules/minimist/package.json +73 -73
  19. package/node_modules/minimist/test/all_bool.js +26 -24
  20. package/node_modules/minimist/test/bool.js +146 -147
  21. package/node_modules/minimist/test/dash.js +33 -21
  22. package/node_modules/minimist/test/default_bool.js +26 -24
  23. package/node_modules/minimist/test/dotted.js +13 -11
  24. package/node_modules/minimist/test/kv_short.js +26 -10
  25. package/node_modules/minimist/test/long.js +28 -26
  26. package/node_modules/minimist/test/num.js +30 -28
  27. package/node_modules/minimist/test/parse.js +169 -157
  28. package/node_modules/minimist/test/parse_modified.js +7 -5
  29. package/node_modules/minimist/test/proto.js +41 -37
  30. package/node_modules/minimist/test/short.js +57 -55
  31. package/node_modules/minimist/test/stop_early.js +10 -8
  32. package/node_modules/minimist/test/unknown.js +83 -81
  33. package/node_modules/minimist/test/whitespace.js +6 -4
  34. package/node_modules/npm/AUTHORS +6 -0
  35. package/node_modules/npm/CHANGELOG.md +57 -0
  36. package/node_modules/npm/Makefile +6 -8
  37. package/node_modules/npm/docs/config.json +5 -0
  38. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-access.md +4 -8
  39. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-adduser.md +6 -10
  40. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-audit.md +2 -6
  41. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-bin.md +4 -8
  42. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-bugs.md +5 -9
  43. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-build.md +4 -8
  44. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-bundle.md +2 -6
  45. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-cache.md +5 -9
  46. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-ci.md +3 -7
  47. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-completion.md +2 -6
  48. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-config.md +3 -7
  49. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-dedupe.md +4 -8
  50. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-deprecate.md +2 -5
  51. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-dist-tag.md +6 -11
  52. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-docs.md +4 -8
  53. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-doctor.md +4 -8
  54. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-edit.md +4 -8
  55. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-explore.md +6 -10
  56. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-fund.md +5 -9
  57. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-help-search.md +3 -7
  58. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-help.md +4 -8
  59. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-hook.md +1 -5
  60. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-init.md +2 -6
  61. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-install-ci-test.md +3 -7
  62. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-install-test.md +3 -7
  63. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-install.md +13 -17
  64. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-link.md +5 -9
  65. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-logout.md +5 -9
  66. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-ls.md +7 -11
  67. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-org.md +1 -5
  68. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-outdated.md +3 -7
  69. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-owner.md +3 -7
  70. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-pack.md +4 -8
  71. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-ping.md +2 -6
  72. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-prefix.md +5 -9
  73. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-profile.md +2 -5
  74. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-prune.md +3 -6
  75. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-publish.md +15 -18
  76. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-rebuild.md +3 -7
  77. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-repo.md +3 -7
  78. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-restart.md +6 -10
  79. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-root.md +4 -8
  80. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-run-script.md +6 -10
  81. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-search.md +3 -7
  82. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-shrinkwrap.md +4 -8
  83. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-star.md +4 -8
  84. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-stars.md +5 -9
  85. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-start.md +6 -10
  86. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-stop.md +5 -9
  87. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-team.md +2 -6
  88. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-test.md +5 -9
  89. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-token.md +1 -5
  90. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-uninstall.md +4 -8
  91. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-unpublish.md +5 -9
  92. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-update.md +5 -9
  93. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-version.md +3 -7
  94. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-view.md +5 -9
  95. package/node_modules/npm/docs/content/{cli-commands → commands}/npm-whoami.md +3 -6
  96. package/node_modules/npm/docs/content/{cli-commands → commands}/npm.md +6 -10
  97. package/node_modules/npm/docs/content/configuring-npm/folders.md +8 -12
  98. package/node_modules/npm/docs/content/configuring-npm/install.md +1 -5
  99. package/node_modules/npm/docs/content/configuring-npm/npmrc.md +3 -7
  100. package/node_modules/npm/docs/content/configuring-npm/package-json.md +9 -13
  101. package/node_modules/npm/docs/content/configuring-npm/package-lock-json.md +3 -7
  102. package/node_modules/npm/docs/content/configuring-npm/package-locks.md +3 -7
  103. package/node_modules/npm/docs/content/configuring-npm/shrinkwrap-json.md +4 -8
  104. package/node_modules/npm/docs/content/using-npm/config.md +8 -12
  105. package/node_modules/npm/docs/content/using-npm/developers.md +8 -12
  106. package/node_modules/npm/docs/content/using-npm/orgs.md +5 -9
  107. package/node_modules/npm/docs/content/using-npm/registry.md +3 -8
  108. package/node_modules/npm/docs/content/using-npm/removal.md +3 -7
  109. package/node_modules/npm/docs/content/using-npm/scope.md +7 -9
  110. package/node_modules/npm/docs/content/using-npm/scripts.md +7 -11
  111. package/node_modules/npm/docs/content/using-npm/semver.md +1 -4
  112. package/node_modules/npm/docs/dockhand.js +341 -0
  113. package/node_modules/npm/docs/nav.yml +236 -0
  114. package/node_modules/npm/docs/output/commands/npm-access.html +240 -0
  115. package/node_modules/npm/docs/output/commands/npm-adduser.html +220 -0
  116. package/node_modules/npm/docs/output/commands/npm-audit.html +253 -0
  117. package/node_modules/npm/docs/output/commands/npm-bin.html +174 -0
  118. package/node_modules/npm/docs/output/commands/npm-bugs.html +194 -0
  119. package/node_modules/npm/docs/output/commands/npm-build.html +181 -0
  120. package/node_modules/npm/docs/output/commands/npm-bundle.html +170 -0
  121. package/node_modules/npm/docs/output/commands/npm-cache.html +230 -0
  122. package/node_modules/npm/docs/output/commands/npm-ci.html +205 -0
  123. package/node_modules/npm/docs/output/commands/npm-completion.html +185 -0
  124. package/node_modules/npm/docs/output/commands/npm-config.html +213 -0
  125. package/node_modules/npm/docs/output/commands/npm-dedupe.html +203 -0
  126. package/node_modules/npm/docs/output/commands/npm-deprecate.html +181 -0
  127. package/node_modules/npm/docs/output/commands/npm-dist-tag.html +232 -0
  128. package/node_modules/npm/docs/output/commands/npm-docs.html +195 -0
  129. package/node_modules/npm/docs/output/commands/npm-doctor.html +241 -0
  130. package/node_modules/npm/docs/output/commands/npm-edit.html +190 -0
  131. package/node_modules/npm/docs/output/commands/npm-explore.html +190 -0
  132. package/node_modules/npm/docs/output/commands/npm-fund.html +208 -0
  133. package/node_modules/npm/docs/output/commands/npm-help-search.html +185 -0
  134. package/node_modules/npm/docs/output/commands/npm-help.html +187 -0
  135. package/node_modules/npm/docs/output/commands/npm-hook.html +206 -0
  136. package/node_modules/npm/docs/output/commands/npm-init.html +209 -0
  137. package/node_modules/npm/docs/output/commands/npm-install-ci-test.html +173 -0
  138. package/node_modules/npm/docs/output/commands/npm-install-test.html +182 -0
  139. package/node_modules/npm/docs/output/commands/npm-install.html +582 -0
  140. package/node_modules/npm/docs/output/commands/npm-link.html +217 -0
  141. package/node_modules/npm/docs/output/commands/npm-logout.html +190 -0
  142. package/node_modules/npm/docs/output/commands/npm-ls.html +257 -0
  143. package/node_modules/npm/docs/output/commands/npm-org.html +193 -0
  144. package/node_modules/npm/docs/output/commands/npm-outdated.html +260 -0
  145. package/node_modules/npm/docs/output/commands/npm-owner.html +193 -0
  146. package/node_modules/npm/docs/output/commands/npm-pack.html +182 -0
  147. package/node_modules/npm/docs/output/commands/npm-ping.html +177 -0
  148. package/node_modules/npm/docs/output/commands/npm-prefix.html +178 -0
  149. package/node_modules/npm/docs/output/commands/npm-profile.html +235 -0
  150. package/node_modules/npm/docs/output/commands/npm-prune.html +188 -0
  151. package/node_modules/npm/docs/output/commands/npm-publish.html +232 -0
  152. package/node_modules/npm/docs/output/commands/npm-rebuild.html +173 -0
  153. package/node_modules/npm/docs/output/commands/npm-repo.html +181 -0
  154. package/node_modules/npm/docs/output/commands/npm-restart.html +193 -0
  155. package/node_modules/npm/docs/output/commands/npm-root.html +174 -0
  156. package/node_modules/npm/docs/output/commands/npm-run-script.html +226 -0
  157. package/node_modules/npm/docs/output/commands/npm-search.html +248 -0
  158. package/node_modules/npm/docs/output/commands/npm-shrinkwrap.html +181 -0
  159. package/node_modules/npm/docs/output/commands/npm-star.html +176 -0
  160. package/node_modules/npm/docs/output/commands/npm-stars.html +176 -0
  161. package/node_modules/npm/docs/output/commands/npm-start.html +178 -0
  162. package/node_modules/npm/docs/output/commands/npm-stop.html +174 -0
  163. package/node_modules/npm/docs/output/commands/npm-team.html +213 -0
  164. package/node_modules/npm/docs/output/commands/npm-test.html +176 -0
  165. package/node_modules/npm/docs/output/commands/npm-token.html +215 -0
  166. package/node_modules/npm/docs/output/commands/npm-uninstall.html +208 -0
  167. package/node_modules/npm/docs/output/commands/npm-unpublish.html +187 -0
  168. package/node_modules/npm/docs/output/commands/npm-update.html +252 -0
  169. package/node_modules/npm/docs/output/commands/npm-version.html +263 -0
  170. package/node_modules/npm/docs/output/commands/npm-view.html +235 -0
  171. package/node_modules/npm/docs/output/commands/npm-whoami.html +172 -0
  172. package/node_modules/npm/docs/output/commands/npm.html +290 -0
  173. package/node_modules/npm/docs/output/configuring-npm/folders.html +321 -0
  174. package/node_modules/npm/docs/output/configuring-npm/install.html +203 -0
  175. package/node_modules/npm/docs/output/configuring-npm/npmrc.html +227 -0
  176. package/node_modules/npm/docs/output/configuring-npm/package-json.html +827 -0
  177. package/node_modules/npm/docs/output/configuring-npm/package-lock-json.html +273 -0
  178. package/node_modules/npm/docs/output/configuring-npm/package-locks.html +310 -0
  179. package/node_modules/npm/docs/output/configuring-npm/shrinkwrap-json.html +181 -0
  180. package/node_modules/npm/docs/output/using-npm/config.html +1248 -0
  181. package/node_modules/npm/docs/output/using-npm/developers.html +356 -0
  182. package/node_modules/npm/docs/output/using-npm/orgs.html +236 -0
  183. package/node_modules/npm/docs/output/using-npm/registry.html +234 -0
  184. package/node_modules/npm/docs/output/using-npm/removal.html +200 -0
  185. package/node_modules/npm/docs/output/using-npm/scope.html +244 -0
  186. package/node_modules/npm/docs/output/using-npm/scripts.html +410 -0
  187. package/node_modules/npm/docs/output/using-npm/semver.html +521 -0
  188. package/node_modules/npm/docs/template.html +161 -0
  189. package/node_modules/npm/lib/help.js +2 -2
  190. package/node_modules/npm/man/man1/npm-README.1 +1 -1
  191. package/node_modules/npm/man/man1/npm-access.1 +1 -1
  192. package/node_modules/npm/man/man1/npm-adduser.1 +1 -7
  193. package/node_modules/npm/man/man1/npm-audit.1 +1 -1
  194. package/node_modules/npm/man/man1/npm-bin.1 +1 -1
  195. package/node_modules/npm/man/man1/npm-bugs.1 +1 -1
  196. package/node_modules/npm/man/man1/npm-build.1 +2 -2
  197. package/node_modules/npm/man/man1/npm-bundle.1 +1 -1
  198. package/node_modules/npm/man/man1/npm-cache.1 +1 -1
  199. package/node_modules/npm/man/man1/npm-ci.1 +1 -1
  200. package/node_modules/npm/man/man1/npm-completion.1 +1 -1
  201. package/node_modules/npm/man/man1/npm-config.1 +1 -1
  202. package/node_modules/npm/man/man1/npm-dedupe.1 +1 -1
  203. package/node_modules/npm/man/man1/npm-deprecate.1 +1 -1
  204. package/node_modules/npm/man/man1/npm-dist-tag.1 +1 -7
  205. package/node_modules/npm/man/man1/npm-docs.1 +1 -1
  206. package/node_modules/npm/man/man1/npm-doctor.1 +1 -1
  207. package/node_modules/npm/man/man1/npm-edit.1 +1 -1
  208. package/node_modules/npm/man/man1/npm-explore.1 +1 -7
  209. package/node_modules/npm/man/man1/npm-fund.1 +1 -1
  210. package/node_modules/npm/man/man1/npm-help-search.1 +1 -1
  211. package/node_modules/npm/man/man1/npm-help.1 +1 -1
  212. package/node_modules/npm/man/man1/npm-hook.1 +1 -1
  213. package/node_modules/npm/man/man1/npm-init.1 +1 -1
  214. package/node_modules/npm/man/man1/npm-install-ci-test.1 +2 -2
  215. package/node_modules/npm/man/man1/npm-install-test.1 +2 -2
  216. package/node_modules/npm/man/man1/npm-install.1 +1 -1
  217. package/node_modules/npm/man/man1/npm-link.1 +1 -1
  218. package/node_modules/npm/man/man1/npm-logout.1 +1 -1
  219. package/node_modules/npm/man/man1/npm-ls.1 +2 -2
  220. package/node_modules/npm/man/man1/npm-org.1 +1 -1
  221. package/node_modules/npm/man/man1/npm-outdated.1 +1 -1
  222. package/node_modules/npm/man/man1/npm-owner.1 +1 -3
  223. package/node_modules/npm/man/man1/npm-pack.1 +1 -1
  224. package/node_modules/npm/man/man1/npm-ping.1 +1 -1
  225. package/node_modules/npm/man/man1/npm-prefix.1 +1 -1
  226. package/node_modules/npm/man/man1/npm-profile.1 +1 -1
  227. package/node_modules/npm/man/man1/npm-prune.1 +1 -1
  228. package/node_modules/npm/man/man1/npm-publish.1 +5 -5
  229. package/node_modules/npm/man/man1/npm-rebuild.1 +1 -1
  230. package/node_modules/npm/man/man1/npm-repo.1 +1 -1
  231. package/node_modules/npm/man/man1/npm-restart.1 +1 -1
  232. package/node_modules/npm/man/man1/npm-root.1 +1 -1
  233. package/node_modules/npm/man/man1/npm-run-script.1 +1 -1
  234. package/node_modules/npm/man/man1/npm-search.1 +1 -1
  235. package/node_modules/npm/man/man1/npm-shrinkwrap.1 +1 -1
  236. package/node_modules/npm/man/man1/npm-star.1 +1 -1
  237. package/node_modules/npm/man/man1/npm-stars.1 +1 -1
  238. package/node_modules/npm/man/man1/npm-start.1 +1 -1
  239. package/node_modules/npm/man/man1/npm-stop.1 +1 -1
  240. package/node_modules/npm/man/man1/npm-team.1 +1 -1
  241. package/node_modules/npm/man/man1/npm-test.1 +1 -1
  242. package/node_modules/npm/man/man1/npm-token.1 +1 -1
  243. package/node_modules/npm/man/man1/npm-uninstall.1 +1 -1
  244. package/node_modules/npm/man/man1/npm-unpublish.1 +1 -1
  245. package/node_modules/npm/man/man1/npm-update.1 +1 -1
  246. package/node_modules/npm/man/man1/npm-version.1 +1 -1
  247. package/node_modules/npm/man/man1/npm-view.1 +1 -1
  248. package/node_modules/npm/man/man1/npm-whoami.1 +1 -1
  249. package/node_modules/npm/man/man1/npm.1 +2 -2
  250. package/node_modules/npm/man/man5/folders.5 +1 -1
  251. package/node_modules/npm/man/man5/install.5 +2 -2
  252. package/node_modules/npm/man/man5/npmrc.5 +1 -1
  253. package/node_modules/npm/man/man5/package-json.5 +1 -1
  254. package/node_modules/npm/man/man5/package-lock-json.5 +1 -1
  255. package/node_modules/npm/man/man5/package-locks.5 +1 -1
  256. package/node_modules/npm/man/man5/shrinkwrap-json.5 +2 -2
  257. package/node_modules/npm/man/man7/config.7 +1 -1
  258. package/node_modules/npm/man/man7/developers.7 +1 -1
  259. package/node_modules/npm/man/man7/orgs.7 +1 -1
  260. package/node_modules/npm/man/man7/registry.7 +1 -3
  261. package/node_modules/npm/man/man7/removal.7 +1 -1
  262. package/node_modules/npm/man/man7/scope.7 +3 -2
  263. package/node_modules/npm/man/man7/scripts.7 +1 -1
  264. package/node_modules/npm/man/man7/semver.7 +1 -1
  265. package/node_modules/npm/node_modules/@iarna/cli/LICENSE +14 -0
  266. package/node_modules/npm/node_modules/@iarna/cli/README.md +152 -0
  267. package/node_modules/npm/node_modules/@iarna/cli/app.js +109 -0
  268. package/node_modules/npm/node_modules/@iarna/cli/package.json +35 -0
  269. package/node_modules/npm/{docs → node_modules/are-we-there-yet/node_modules/readable-stream/node_modules/safe-buffer}/LICENSE +5 -6
  270. package/node_modules/npm/node_modules/are-we-there-yet/node_modules/readable-stream/node_modules/safe-buffer/README.md +584 -0
  271. package/node_modules/npm/node_modules/are-we-there-yet/node_modules/readable-stream/node_modules/safe-buffer/index.d.ts +187 -0
  272. package/node_modules/npm/node_modules/are-we-there-yet/node_modules/readable-stream/node_modules/safe-buffer/index.js +62 -0
  273. package/node_modules/npm/node_modules/are-we-there-yet/node_modules/readable-stream/node_modules/safe-buffer/package.json +37 -0
  274. package/node_modules/npm/node_modules/are-we-there-yet/node_modules/string_decoder/node_modules/safe-buffer/LICENSE +21 -0
  275. package/node_modules/npm/node_modules/are-we-there-yet/node_modules/string_decoder/node_modules/safe-buffer/README.md +584 -0
  276. package/node_modules/npm/node_modules/are-we-there-yet/node_modules/string_decoder/node_modules/safe-buffer/index.d.ts +187 -0
  277. package/node_modules/npm/node_modules/are-we-there-yet/node_modules/string_decoder/node_modules/safe-buffer/index.js +62 -0
  278. package/node_modules/npm/node_modules/are-we-there-yet/node_modules/string_decoder/node_modules/safe-buffer/package.json +37 -0
  279. package/node_modules/npm/node_modules/asn1/Jenkinsfile +65 -0
  280. package/node_modules/npm/node_modules/asn1/package.json +2 -2
  281. package/node_modules/npm/node_modules/aws4/.github/FUNDING.yml +3 -0
  282. package/node_modules/npm/node_modules/aws4/.travis.yml +5 -1
  283. package/node_modules/npm/node_modules/aws4/README.md +50 -390
  284. package/node_modules/npm/node_modules/aws4/aws4.js +63 -22
  285. package/node_modules/npm/node_modules/aws4/package.json +9 -63
  286. package/node_modules/npm/node_modules/balanced-match/.github/FUNDING.yml +2 -0
  287. package/node_modules/npm/node_modules/balanced-match/README.md +6 -0
  288. package/node_modules/npm/node_modules/balanced-match/index.js +3 -0
  289. package/node_modules/npm/node_modules/balanced-match/package.json +3 -4
  290. package/node_modules/npm/node_modules/bluebird/README.md +1 -1
  291. package/node_modules/npm/node_modules/bluebird/js/browser/bluebird.core.js +210 -120
  292. package/node_modules/npm/node_modules/bluebird/js/browser/bluebird.core.min.js +3 -3
  293. package/node_modules/npm/node_modules/bluebird/js/browser/bluebird.js +240 -128
  294. package/node_modules/npm/node_modules/bluebird/js/browser/bluebird.min.js +4 -4
  295. package/node_modules/npm/node_modules/bluebird/js/release/async.js +3 -48
  296. package/node_modules/npm/node_modules/bluebird/js/release/debuggability.js +102 -27
  297. package/node_modules/npm/node_modules/bluebird/js/release/join.js +4 -7
  298. package/node_modules/npm/node_modules/bluebird/js/release/map.js +10 -3
  299. package/node_modules/npm/node_modules/bluebird/js/release/promise.js +58 -28
  300. package/node_modules/npm/node_modules/bluebird/js/release/promise_array.js +1 -0
  301. package/node_modules/npm/node_modules/bluebird/js/release/reduce.js +16 -5
  302. package/node_modules/npm/node_modules/bluebird/js/release/settle.js +4 -0
  303. package/node_modules/npm/node_modules/bluebird/js/release/util.js +39 -7
  304. package/node_modules/npm/node_modules/bluebird/package.json +1 -1
  305. package/node_modules/npm/node_modules/cacache/CHANGELOG.md +4 -0
  306. package/node_modules/npm/node_modules/cacache/package.json +6 -7
  307. package/node_modules/npm/node_modules/combined-stream/lib/combined_stream.js +21 -2
  308. package/node_modules/npm/node_modules/combined-stream/package.json +1 -1
  309. package/node_modules/npm/node_modules/combined-stream/yarn.lock +17 -0
  310. package/node_modules/npm/node_modules/concat-stream/node_modules/readable-stream/node_modules/safe-buffer/LICENSE +21 -0
  311. package/node_modules/npm/node_modules/concat-stream/node_modules/readable-stream/node_modules/safe-buffer/README.md +584 -0
  312. package/node_modules/npm/node_modules/concat-stream/node_modules/readable-stream/node_modules/safe-buffer/index.d.ts +187 -0
  313. package/node_modules/npm/node_modules/concat-stream/node_modules/readable-stream/node_modules/safe-buffer/index.js +62 -0
  314. package/node_modules/npm/node_modules/concat-stream/node_modules/readable-stream/node_modules/safe-buffer/package.json +37 -0
  315. package/node_modules/npm/node_modules/concat-stream/node_modules/string_decoder/node_modules/safe-buffer/LICENSE +21 -0
  316. package/node_modules/npm/node_modules/concat-stream/node_modules/string_decoder/node_modules/safe-buffer/README.md +584 -0
  317. package/node_modules/npm/node_modules/concat-stream/node_modules/string_decoder/node_modules/safe-buffer/index.d.ts +187 -0
  318. package/node_modules/npm/node_modules/concat-stream/node_modules/string_decoder/node_modules/safe-buffer/index.js +62 -0
  319. package/node_modules/npm/node_modules/concat-stream/node_modules/string_decoder/node_modules/safe-buffer/package.json +37 -0
  320. package/node_modules/npm/node_modules/config-chain/package.json +5 -7
  321. package/node_modules/npm/node_modules/decode-uri-component/index.js +4 -4
  322. package/node_modules/npm/node_modules/decode-uri-component/license +4 -16
  323. package/node_modules/npm/node_modules/decode-uri-component/package.json +35 -35
  324. package/node_modules/npm/node_modules/decode-uri-component/readme.md +14 -1
  325. package/node_modules/npm/node_modules/dezalgo/package.json +12 -8
  326. package/node_modules/npm/node_modules/duplexify/node_modules/readable-stream/node_modules/safe-buffer/LICENSE +21 -0
  327. package/node_modules/npm/node_modules/duplexify/node_modules/readable-stream/node_modules/safe-buffer/README.md +584 -0
  328. package/node_modules/npm/node_modules/duplexify/node_modules/readable-stream/node_modules/safe-buffer/index.d.ts +187 -0
  329. package/node_modules/npm/node_modules/duplexify/node_modules/readable-stream/node_modules/safe-buffer/index.js +62 -0
  330. package/node_modules/npm/node_modules/duplexify/node_modules/readable-stream/node_modules/safe-buffer/package.json +37 -0
  331. package/node_modules/npm/node_modules/duplexify/node_modules/string_decoder/node_modules/safe-buffer/LICENSE +21 -0
  332. package/node_modules/npm/node_modules/duplexify/node_modules/string_decoder/node_modules/safe-buffer/README.md +584 -0
  333. package/node_modules/npm/node_modules/duplexify/node_modules/string_decoder/node_modules/safe-buffer/index.d.ts +187 -0
  334. package/node_modules/npm/node_modules/duplexify/node_modules/string_decoder/node_modules/safe-buffer/index.js +62 -0
  335. package/node_modules/npm/node_modules/duplexify/node_modules/string_decoder/node_modules/safe-buffer/package.json +37 -0
  336. package/node_modules/npm/node_modules/env-paths/index.d.ts +32 -0
  337. package/node_modules/npm/node_modules/env-paths/package.json +1 -1
  338. package/node_modules/npm/node_modules/env-paths/readme.md +44 -5
  339. package/node_modules/npm/node_modules/figgy-pudding/CHANGELOG.md +38 -33
  340. package/node_modules/npm/node_modules/figgy-pudding/README.md +10 -2
  341. package/node_modules/npm/node_modules/figgy-pudding/package.json +4 -8
  342. package/node_modules/npm/node_modules/filter-obj/index.js +17 -0
  343. package/node_modules/npm/node_modules/filter-obj/license +21 -0
  344. package/node_modules/npm/node_modules/filter-obj/package.json +37 -0
  345. package/node_modules/npm/node_modules/filter-obj/readme.md +41 -0
  346. package/node_modules/npm/node_modules/flush-write-stream/node_modules/readable-stream/node_modules/safe-buffer/LICENSE +21 -0
  347. package/node_modules/npm/node_modules/flush-write-stream/node_modules/readable-stream/node_modules/safe-buffer/README.md +584 -0
  348. package/node_modules/npm/node_modules/flush-write-stream/node_modules/readable-stream/node_modules/safe-buffer/index.d.ts +187 -0
  349. package/node_modules/npm/node_modules/flush-write-stream/node_modules/readable-stream/node_modules/safe-buffer/index.js +62 -0
  350. package/node_modules/npm/node_modules/flush-write-stream/node_modules/readable-stream/node_modules/safe-buffer/package.json +37 -0
  351. package/node_modules/npm/node_modules/flush-write-stream/node_modules/string_decoder/node_modules/safe-buffer/LICENSE +21 -0
  352. package/node_modules/npm/node_modules/flush-write-stream/node_modules/string_decoder/node_modules/safe-buffer/README.md +584 -0
  353. package/node_modules/npm/node_modules/flush-write-stream/node_modules/string_decoder/node_modules/safe-buffer/index.d.ts +187 -0
  354. package/node_modules/npm/node_modules/flush-write-stream/node_modules/string_decoder/node_modules/safe-buffer/index.js +62 -0
  355. package/node_modules/npm/node_modules/flush-write-stream/node_modules/string_decoder/node_modules/safe-buffer/package.json +37 -0
  356. package/node_modules/npm/node_modules/form-data/README.md +4 -4
  357. package/node_modules/npm/node_modules/form-data/package.json +2 -2
  358. package/node_modules/npm/node_modules/form-data/yarn.lock +2662 -0
  359. package/node_modules/npm/node_modules/from2/node_modules/readable-stream/node_modules/safe-buffer/LICENSE +21 -0
  360. package/node_modules/npm/node_modules/from2/node_modules/readable-stream/node_modules/safe-buffer/README.md +584 -0
  361. package/node_modules/npm/node_modules/from2/node_modules/readable-stream/node_modules/safe-buffer/index.d.ts +187 -0
  362. package/node_modules/npm/node_modules/from2/node_modules/readable-stream/node_modules/safe-buffer/index.js +62 -0
  363. package/node_modules/npm/node_modules/from2/node_modules/readable-stream/node_modules/safe-buffer/package.json +37 -0
  364. package/node_modules/npm/node_modules/from2/node_modules/string_decoder/node_modules/safe-buffer/LICENSE +21 -0
  365. package/node_modules/npm/node_modules/from2/node_modules/string_decoder/node_modules/safe-buffer/README.md +584 -0
  366. package/node_modules/npm/node_modules/from2/node_modules/string_decoder/node_modules/safe-buffer/index.d.ts +187 -0
  367. package/node_modules/npm/node_modules/from2/node_modules/string_decoder/node_modules/safe-buffer/index.js +62 -0
  368. package/node_modules/npm/node_modules/from2/node_modules/string_decoder/node_modules/safe-buffer/package.json +37 -0
  369. package/node_modules/npm/node_modules/fs-write-stream-atomic/node_modules/readable-stream/node_modules/safe-buffer/LICENSE +21 -0
  370. package/node_modules/npm/node_modules/fs-write-stream-atomic/node_modules/readable-stream/node_modules/safe-buffer/README.md +584 -0
  371. package/node_modules/npm/node_modules/fs-write-stream-atomic/node_modules/readable-stream/node_modules/safe-buffer/index.d.ts +187 -0
  372. package/node_modules/npm/node_modules/fs-write-stream-atomic/node_modules/readable-stream/node_modules/safe-buffer/index.js +62 -0
  373. package/node_modules/npm/node_modules/fs-write-stream-atomic/node_modules/readable-stream/node_modules/safe-buffer/package.json +37 -0
  374. package/node_modules/npm/node_modules/fs-write-stream-atomic/node_modules/string_decoder/node_modules/safe-buffer/LICENSE +21 -0
  375. package/node_modules/npm/node_modules/fs-write-stream-atomic/node_modules/string_decoder/node_modules/safe-buffer/README.md +584 -0
  376. package/node_modules/npm/node_modules/fs-write-stream-atomic/node_modules/string_decoder/node_modules/safe-buffer/index.d.ts +187 -0
  377. package/node_modules/npm/node_modules/fs-write-stream-atomic/node_modules/string_decoder/node_modules/safe-buffer/index.js +62 -0
  378. package/node_modules/npm/node_modules/fs-write-stream-atomic/node_modules/string_decoder/node_modules/safe-buffer/package.json +37 -0
  379. package/node_modules/npm/node_modules/glob/README.md +4 -1
  380. package/node_modules/npm/node_modules/glob/common.js +6 -8
  381. package/node_modules/npm/node_modules/glob/glob.js +8 -8
  382. package/node_modules/npm/node_modules/glob/node_modules/minimatch/LICENSE +15 -0
  383. package/node_modules/npm/node_modules/glob/node_modules/minimatch/README.md +230 -0
  384. package/node_modules/npm/node_modules/glob/node_modules/minimatch/minimatch.js +947 -0
  385. package/node_modules/npm/node_modules/glob/node_modules/minimatch/package.json +33 -0
  386. package/node_modules/npm/node_modules/glob/package.json +13 -4
  387. package/node_modules/npm/node_modules/glob/sync.js +10 -10
  388. package/node_modules/npm/node_modules/graceful-fs/LICENSE +1 -1
  389. package/node_modules/npm/node_modules/graceful-fs/README.md +11 -1
  390. package/node_modules/npm/node_modules/graceful-fs/clone.js +5 -1
  391. package/node_modules/npm/node_modules/graceful-fs/graceful-fs.js +132 -38
  392. package/node_modules/npm/node_modules/graceful-fs/package.json +4 -4
  393. package/node_modules/npm/node_modules/graceful-fs/polyfills.js +48 -35
  394. package/node_modules/npm/node_modules/is-cidr/README.md +6 -10
  395. package/node_modules/npm/node_modules/is-cidr/index.d.ts +31 -0
  396. package/node_modules/npm/node_modules/is-cidr/index.js +1 -0
  397. package/node_modules/npm/node_modules/is-cidr/package.json +12 -6
  398. package/node_modules/npm/node_modules/json-parse-even-better-errors/CHANGELOG.md +50 -0
  399. package/node_modules/npm/node_modules/json-parse-even-better-errors/LICENSE.md +25 -0
  400. package/node_modules/npm/node_modules/json-parse-even-better-errors/README.md +96 -0
  401. package/node_modules/npm/node_modules/json-parse-even-better-errors/index.js +121 -0
  402. package/node_modules/npm/node_modules/json-parse-even-better-errors/package.json +33 -0
  403. package/node_modules/npm/node_modules/lock-verify/README.md +8 -0
  404. package/node_modules/npm/node_modules/lock-verify/cli.js +17 -0
  405. package/node_modules/npm/node_modules/lock-verify/package.json +8 -12
  406. package/node_modules/npm/node_modules/meant/CHANGELOG.md +7 -0
  407. package/node_modules/npm/node_modules/meant/package.json +4 -1
  408. package/node_modules/npm/node_modules/minimatch/README.md +22 -1
  409. package/node_modules/npm/node_modules/minimatch/minimatch.js +93 -69
  410. package/node_modules/npm/node_modules/minimatch/package.json +6 -3
  411. package/node_modules/npm/node_modules/mkdirp/index.js +5 -2
  412. package/node_modules/npm/node_modules/mkdirp/package.json +3 -4
  413. package/node_modules/npm/node_modules/node-gyp/.github/ISSUE_TEMPLATE.md +27 -5
  414. package/node_modules/npm/node_modules/node-gyp/.github/workflows/Python_tests.yml +1 -1
  415. package/node_modules/npm/node_modules/node-gyp/CHANGELOG.md +14 -0
  416. package/node_modules/npm/node_modules/node-gyp/CONTRIBUTING.md +1 -1
  417. package/node_modules/npm/node_modules/node-gyp/README.md +3 -3
  418. package/node_modules/npm/node_modules/node-gyp/addon.gypi +22 -1
  419. package/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js +2 -3
  420. package/node_modules/npm/node_modules/node-gyp/macOS_Catalina.md +14 -12
  421. package/node_modules/npm/node_modules/node-gyp/package.json +1 -1
  422. package/node_modules/npm/node_modules/parallel-transform/node_modules/readable-stream/node_modules/safe-buffer/LICENSE +21 -0
  423. package/node_modules/npm/node_modules/parallel-transform/node_modules/readable-stream/node_modules/safe-buffer/README.md +584 -0
  424. package/node_modules/npm/node_modules/parallel-transform/node_modules/readable-stream/node_modules/safe-buffer/index.d.ts +187 -0
  425. package/node_modules/npm/node_modules/parallel-transform/node_modules/readable-stream/node_modules/safe-buffer/index.js +62 -0
  426. package/node_modules/npm/node_modules/parallel-transform/node_modules/readable-stream/node_modules/safe-buffer/package.json +37 -0
  427. package/node_modules/npm/node_modules/parallel-transform/node_modules/string_decoder/node_modules/safe-buffer/LICENSE +21 -0
  428. package/node_modules/npm/node_modules/parallel-transform/node_modules/string_decoder/node_modules/safe-buffer/README.md +584 -0
  429. package/node_modules/npm/node_modules/parallel-transform/node_modules/string_decoder/node_modules/safe-buffer/index.d.ts +187 -0
  430. package/node_modules/npm/node_modules/parallel-transform/node_modules/string_decoder/node_modules/safe-buffer/index.js +62 -0
  431. package/node_modules/npm/node_modules/parallel-transform/node_modules/string_decoder/node_modules/safe-buffer/package.json +37 -0
  432. package/node_modules/npm/node_modules/psl/.env +0 -0
  433. package/node_modules/npm/node_modules/psl/LICENSE +9 -0
  434. package/node_modules/npm/node_modules/psl/README.md +4 -6
  435. package/node_modules/npm/node_modules/psl/browserstack-logo.svg +90 -0
  436. package/node_modules/npm/node_modules/psl/data/rules.json +9376 -1
  437. package/node_modules/npm/node_modules/psl/dist/psl.js +9378 -3
  438. package/node_modules/npm/node_modules/psl/dist/psl.min.js +1 -1
  439. package/node_modules/npm/node_modules/psl/package.json +24 -23
  440. package/node_modules/npm/node_modules/qs/.editorconfig +14 -1
  441. package/node_modules/npm/node_modules/qs/.eslintrc +21 -3
  442. package/node_modules/npm/node_modules/qs/.github/FUNDING.yml +12 -0
  443. package/node_modules/npm/node_modules/qs/.nycrc +13 -0
  444. package/node_modules/npm/node_modules/qs/CHANGELOG.md +24 -0
  445. package/node_modules/npm/node_modules/qs/LICENSE.md +29 -0
  446. package/node_modules/npm/node_modules/qs/README.md +54 -19
  447. package/node_modules/npm/node_modules/qs/bower.json +21 -0
  448. package/node_modules/npm/node_modules/qs/component.json +15 -0
  449. package/node_modules/npm/node_modules/qs/dist/qs.js +35 -25
  450. package/node_modules/npm/node_modules/qs/lib/formats.js +1 -1
  451. package/node_modules/npm/node_modules/qs/lib/parse.js +6 -5
  452. package/node_modules/npm/node_modules/qs/lib/stringify.js +21 -14
  453. package/node_modules/npm/node_modules/qs/lib/utils.js +7 -5
  454. package/node_modules/npm/node_modules/qs/package.json +18 -16
  455. package/node_modules/npm/node_modules/qs/test/parse.js +79 -4
  456. package/node_modules/npm/node_modules/qs/test/stringify.js +45 -0
  457. package/node_modules/npm/node_modules/qs/test/utils.js +31 -0
  458. package/node_modules/npm/node_modules/query-string/index.d.ts +290 -9
  459. package/node_modules/npm/node_modules/query-string/index.js +154 -28
  460. package/node_modules/npm/node_modules/query-string/license +1 -1
  461. package/node_modules/npm/node_modules/query-string/package.json +9 -4
  462. package/node_modules/npm/node_modules/query-string/readme.md +275 -26
  463. package/node_modules/npm/node_modules/qw/LICENSE +0 -0
  464. package/node_modules/npm/node_modules/qw/README.md +0 -0
  465. package/node_modules/npm/node_modules/qw/package.json +1 -1
  466. package/node_modules/npm/node_modules/qw/qw.js +1 -0
  467. package/node_modules/npm/node_modules/read-package-json/CHANGELOG.md +10 -0
  468. package/node_modules/npm/node_modules/read-package-json/package.json +3 -6
  469. package/node_modules/npm/node_modules/read-package-json/read-json.js +2 -7
  470. package/node_modules/npm/node_modules/request/CHANGELOG.md +8 -0
  471. package/node_modules/npm/node_modules/request/README.md +81 -45
  472. package/node_modules/npm/node_modules/request/index.js +1 -1
  473. package/node_modules/npm/node_modules/request/lib/auth.js +1 -1
  474. package/node_modules/npm/node_modules/request/lib/getProxyFromURI.js +1 -1
  475. package/node_modules/npm/node_modules/request/lib/har.js +1 -1
  476. package/node_modules/npm/node_modules/request/package.json +6 -6
  477. package/node_modules/npm/node_modules/request/request.js +13 -11
  478. package/node_modules/npm/node_modules/safe-buffer/index.js +3 -0
  479. package/node_modules/npm/node_modules/safe-buffer/package.json +18 -4
  480. package/node_modules/npm/node_modules/sshpk/Jenkinsfile +86 -0
  481. package/node_modules/npm/node_modules/sshpk/README.md +116 -10
  482. package/node_modules/npm/node_modules/sshpk/bin/sshpk-conv +73 -32
  483. package/node_modules/npm/node_modules/sshpk/lib/certificate.js +33 -1
  484. package/node_modules/npm/node_modules/sshpk/lib/dhe.js +4 -21
  485. package/node_modules/npm/node_modules/sshpk/lib/ed-compat.js +1 -7
  486. package/node_modules/npm/node_modules/sshpk/lib/fingerprint.js +69 -11
  487. package/node_modules/npm/node_modules/sshpk/lib/formats/auto.js +18 -1
  488. package/node_modules/npm/node_modules/sshpk/lib/formats/openssh-cert.js +37 -8
  489. package/node_modules/npm/node_modules/sshpk/lib/formats/pem.js +107 -9
  490. package/node_modules/npm/node_modules/sshpk/lib/formats/pkcs8.js +23 -4
  491. package/node_modules/npm/node_modules/sshpk/lib/formats/putty.js +194 -0
  492. package/node_modules/npm/node_modules/sshpk/lib/formats/x509-pem.js +14 -4
  493. package/node_modules/npm/node_modules/sshpk/lib/formats/x509.js +28 -5
  494. package/node_modules/npm/node_modules/sshpk/lib/identity.js +87 -3
  495. package/node_modules/npm/node_modules/sshpk/lib/index.js +1 -0
  496. package/node_modules/npm/node_modules/sshpk/lib/key.js +30 -11
  497. package/node_modules/npm/node_modules/sshpk/lib/private-key.js +11 -17
  498. package/node_modules/npm/node_modules/sshpk/lib/utils.js +48 -33
  499. package/node_modules/npm/node_modules/sshpk/package.json +5 -5
  500. package/node_modules/npm/node_modules/stream-iterate/node_modules/readable-stream/node_modules/safe-buffer/LICENSE +21 -0
  501. package/node_modules/npm/node_modules/stream-iterate/node_modules/readable-stream/node_modules/safe-buffer/README.md +584 -0
  502. package/node_modules/npm/node_modules/stream-iterate/node_modules/readable-stream/node_modules/safe-buffer/index.d.ts +187 -0
  503. package/node_modules/npm/node_modules/stream-iterate/node_modules/readable-stream/node_modules/safe-buffer/index.js +62 -0
  504. package/node_modules/npm/node_modules/stream-iterate/node_modules/readable-stream/node_modules/safe-buffer/package.json +37 -0
  505. package/node_modules/npm/node_modules/stream-iterate/node_modules/string_decoder/node_modules/safe-buffer/LICENSE +21 -0
  506. package/node_modules/npm/node_modules/stream-iterate/node_modules/string_decoder/node_modules/safe-buffer/README.md +584 -0
  507. package/node_modules/npm/node_modules/stream-iterate/node_modules/string_decoder/node_modules/safe-buffer/index.d.ts +187 -0
  508. package/node_modules/npm/node_modules/stream-iterate/node_modules/string_decoder/node_modules/safe-buffer/index.js +62 -0
  509. package/node_modules/npm/node_modules/stream-iterate/node_modules/string_decoder/node_modules/safe-buffer/package.json +37 -0
  510. package/node_modules/npm/node_modules/through2/node_modules/readable-stream/node_modules/safe-buffer/LICENSE +21 -0
  511. package/node_modules/npm/node_modules/through2/node_modules/readable-stream/node_modules/safe-buffer/README.md +584 -0
  512. package/node_modules/npm/node_modules/through2/node_modules/readable-stream/node_modules/safe-buffer/index.d.ts +187 -0
  513. package/node_modules/npm/node_modules/through2/node_modules/readable-stream/node_modules/safe-buffer/index.js +62 -0
  514. package/node_modules/npm/node_modules/through2/node_modules/readable-stream/node_modules/safe-buffer/package.json +37 -0
  515. package/node_modules/npm/node_modules/through2/node_modules/string_decoder/node_modules/safe-buffer/LICENSE +21 -0
  516. package/node_modules/npm/node_modules/through2/node_modules/string_decoder/node_modules/safe-buffer/README.md +584 -0
  517. package/node_modules/npm/node_modules/through2/node_modules/string_decoder/node_modules/safe-buffer/index.d.ts +187 -0
  518. package/node_modules/npm/node_modules/through2/node_modules/string_decoder/node_modules/safe-buffer/index.js +62 -0
  519. package/node_modules/npm/node_modules/through2/node_modules/string_decoder/node_modules/safe-buffer/package.json +37 -0
  520. package/node_modules/npm/node_modules/tough-cookie/README.md +24 -4
  521. package/node_modules/npm/node_modules/tough-cookie/lib/cookie.js +54 -3
  522. package/node_modules/npm/node_modules/tough-cookie/lib/memstore.js +5 -0
  523. package/node_modules/npm/node_modules/tough-cookie/lib/store.js +4 -0
  524. package/node_modules/npm/node_modules/tough-cookie/lib/version.js +2 -0
  525. package/node_modules/npm/node_modules/{punycode → tough-cookie/node_modules/punycode}/LICENSE-MIT.txt +0 -0
  526. package/node_modules/npm/node_modules/{punycode → tough-cookie/node_modules/punycode}/README.md +9 -63
  527. package/node_modules/npm/node_modules/tough-cookie/node_modules/punycode/package.json +58 -0
  528. package/node_modules/npm/node_modules/tough-cookie/node_modules/punycode/punycode.es6.js +441 -0
  529. package/node_modules/npm/node_modules/tough-cookie/node_modules/punycode/punycode.js +440 -0
  530. package/node_modules/npm/node_modules/tough-cookie/package.json +6 -4
  531. package/node_modules/npm/node_modules/uri-js/README.md +3 -1
  532. package/node_modules/npm/node_modules/uri-js/dist/es5/uri.all.js +1 -1
  533. package/node_modules/npm/node_modules/uri-js/dist/es5/uri.all.min.js +1 -1
  534. package/node_modules/npm/node_modules/uri-js/package.json +2 -2
  535. package/node_modules/npm/node_modules/uri-js/yarn.lock +1263 -628
  536. package/node_modules/npm/node_modules/uuid/CHANGELOG.md +25 -18
  537. package/node_modules/npm/node_modules/uuid/README.md +27 -44
  538. package/node_modules/npm/node_modules/uuid/lib/bytesToUuid.js +10 -8
  539. package/node_modules/npm/node_modules/uuid/package.json +13 -8
  540. package/node_modules/npm/node_modules/uuid/v1.js +1 -1
  541. package/node_modules/npm/package.json +27 -23
  542. package/node_modules/npm/scripts/docs-build.js +15 -3
  543. package/node_modules/object-inspect/CHANGELOG.md +10 -0
  544. package/node_modules/object-inspect/index.js +10 -6
  545. package/node_modules/object-inspect/package.json +10 -7
  546. package/node_modules/punycode/README.md +7 -3
  547. package/node_modules/punycode/package.json +5 -5
  548. package/node_modules/punycode/punycode.es6.js +24 -21
  549. package/node_modules/punycode/punycode.js +24 -21
  550. package/package.json +1 -1
  551. package/node_modules/npm/.eslintrc +0 -3
  552. package/node_modules/npm/docs/content/using-npm/disputes.md +0 -137
  553. package/node_modules/npm/docs/gatsby-browser.js +0 -8
  554. package/node_modules/npm/docs/gatsby-config.js +0 -88
  555. package/node_modules/npm/docs/gatsby-node.js +0 -43
  556. package/node_modules/npm/docs/gatsby-ssr.js +0 -6
  557. package/node_modules/npm/docs/package-lock.json +0 -18301
  558. package/node_modules/npm/docs/package.json +0 -45
  559. package/node_modules/npm/docs/public/cli-commands/npm/index.html +0 -213
  560. package/node_modules/npm/docs/public/cli-commands/npm-access/index.html +0 -151
  561. package/node_modules/npm/docs/public/cli-commands/npm-adduser/index.html +0 -146
  562. package/node_modules/npm/docs/public/cli-commands/npm-audit/index.html +0 -168
  563. package/node_modules/npm/docs/public/cli-commands/npm-bin/index.html +0 -97
  564. package/node_modules/npm/docs/public/cli-commands/npm-bugs/index.html +0 -117
  565. package/node_modules/npm/docs/public/cli-commands/npm-build/index.html +0 -103
  566. package/node_modules/npm/docs/public/cli-commands/npm-bundle/index.html +0 -94
  567. package/node_modules/npm/docs/public/cli-commands/npm-cache/index.html +0 -148
  568. package/node_modules/npm/docs/public/cli-commands/npm-ci/index.html +0 -125
  569. package/node_modules/npm/docs/public/cli-commands/npm-completion/index.html +0 -107
  570. package/node_modules/npm/docs/public/cli-commands/npm-config/index.html +0 -131
  571. package/node_modules/npm/docs/public/cli-commands/npm-dedupe/index.html +0 -124
  572. package/node_modules/npm/docs/public/cli-commands/npm-deprecate/index.html +0 -103
  573. package/node_modules/npm/docs/public/cli-commands/npm-dist-tag/index.html +0 -152
  574. package/node_modules/npm/docs/public/cli-commands/npm-docs/index.html +0 -118
  575. package/node_modules/npm/docs/public/cli-commands/npm-doctor/index.html +0 -166
  576. package/node_modules/npm/docs/public/cli-commands/npm-edit/index.html +0 -113
  577. package/node_modules/npm/docs/public/cli-commands/npm-explore/index.html +0 -117
  578. package/node_modules/npm/docs/public/cli-commands/npm-fund/index.html +0 -131
  579. package/node_modules/npm/docs/public/cli-commands/npm-help/index.html +0 -110
  580. package/node_modules/npm/docs/public/cli-commands/npm-help-search/index.html +0 -108
  581. package/node_modules/npm/docs/public/cli-commands/npm-hook/index.html +0 -122
  582. package/node_modules/npm/docs/public/cli-commands/npm-init/index.html +0 -129
  583. package/node_modules/npm/docs/public/cli-commands/npm-install/index.html +0 -471
  584. package/node_modules/npm/docs/public/cli-commands/npm-install-ci-test/index.html +0 -96
  585. package/node_modules/npm/docs/public/cli-commands/npm-install-test/index.html +0 -105
  586. package/node_modules/npm/docs/public/cli-commands/npm-link/index.html +0 -137
  587. package/node_modules/npm/docs/public/cli-commands/npm-logout/index.html +0 -112
  588. package/node_modules/npm/docs/public/cli-commands/npm-ls/index.html +0 -179
  589. package/node_modules/npm/docs/public/cli-commands/npm-org/index.html +0 -110
  590. package/node_modules/npm/docs/public/cli-commands/npm-outdated/index.html +0 -181
  591. package/node_modules/npm/docs/public/cli-commands/npm-owner/index.html +0 -117
  592. package/node_modules/npm/docs/public/cli-commands/npm-pack/index.html +0 -105
  593. package/node_modules/npm/docs/public/cli-commands/npm-ping/index.html +0 -98
  594. package/node_modules/npm/docs/public/cli-commands/npm-prefix/index.html +0 -101
  595. package/node_modules/npm/docs/public/cli-commands/npm-profile/index.html +0 -151
  596. package/node_modules/npm/docs/public/cli-commands/npm-prune/index.html +0 -111
  597. package/node_modules/npm/docs/public/cli-commands/npm-publish/index.html +0 -143
  598. package/node_modules/npm/docs/public/cli-commands/npm-rebuild/index.html +0 -96
  599. package/node_modules/npm/docs/public/cli-commands/npm-repo/index.html +0 -104
  600. package/node_modules/npm/docs/public/cli-commands/npm-restart/index.html +0 -116
  601. package/node_modules/npm/docs/public/cli-commands/npm-root/index.html +0 -97
  602. package/node_modules/npm/docs/public/cli-commands/npm-run-script/index.html +0 -146
  603. package/node_modules/npm/docs/public/cli-commands/npm-search/index.html +0 -171
  604. package/node_modules/npm/docs/public/cli-commands/npm-shrinkwrap/index.html +0 -104
  605. package/node_modules/npm/docs/public/cli-commands/npm-star/index.html +0 -99
  606. package/node_modules/npm/docs/public/cli-commands/npm-stars/index.html +0 -99
  607. package/node_modules/npm/docs/public/cli-commands/npm-start/index.html +0 -101
  608. package/node_modules/npm/docs/public/cli-commands/npm-stop/index.html +0 -97
  609. package/node_modules/npm/docs/public/cli-commands/npm-team/index.html +0 -128
  610. package/node_modules/npm/docs/public/cli-commands/npm-test/index.html +0 -99
  611. package/node_modules/npm/docs/public/cli-commands/npm-token/index.html +0 -136
  612. package/node_modules/npm/docs/public/cli-commands/npm-uninstall/index.html +0 -121
  613. package/node_modules/npm/docs/public/cli-commands/npm-unpublish/index.html +0 -109
  614. package/node_modules/npm/docs/public/cli-commands/npm-update/index.html +0 -170
  615. package/node_modules/npm/docs/public/cli-commands/npm-version/index.html +0 -183
  616. package/node_modules/npm/docs/public/cli-commands/npm-view/index.html +0 -148
  617. package/node_modules/npm/docs/public/cli-commands/npm-whoami/index.html +0 -95
  618. package/node_modules/npm/docs/public/configuring-npm/folders/index.html +0 -243
  619. package/node_modules/npm/docs/public/configuring-npm/install/index.html +0 -126
  620. package/node_modules/npm/docs/public/configuring-npm/npmrc/index.html +0 -148
  621. package/node_modules/npm/docs/public/configuring-npm/package-json/index.html +0 -714
  622. package/node_modules/npm/docs/public/configuring-npm/package-lock-json/index.html +0 -189
  623. package/node_modules/npm/docs/public/configuring-npm/package-locks/index.html +0 -217
  624. package/node_modules/npm/docs/public/configuring-npm/shrinkwrap-json/index.html +0 -105
  625. package/node_modules/npm/docs/public/icons/icon-144x144.png +0 -0
  626. package/node_modules/npm/docs/public/icons/icon-192x192.png +0 -0
  627. package/node_modules/npm/docs/public/icons/icon-256x256.png +0 -0
  628. package/node_modules/npm/docs/public/icons/icon-384x384.png +0 -0
  629. package/node_modules/npm/docs/public/icons/icon-48x48.png +0 -0
  630. package/node_modules/npm/docs/public/icons/icon-512x512.png +0 -0
  631. package/node_modules/npm/docs/public/icons/icon-72x72.png +0 -0
  632. package/node_modules/npm/docs/public/icons/icon-96x96.png +0 -0
  633. package/node_modules/npm/docs/public/index.html +0 -131
  634. package/node_modules/npm/docs/public/static/d/2215187023.json +0 -1
  635. package/node_modules/npm/docs/public/static/d/2417117884.json +0 -1
  636. package/node_modules/npm/docs/public/static/network-icon-f659855f70bb0e12addd96250807c241.svg +0 -1
  637. package/node_modules/npm/docs/public/styles.e93b5499b63484750fba.css +0 -1
  638. package/node_modules/npm/docs/public/using-npm/config/index.html +0 -1164
  639. package/node_modules/npm/docs/public/using-npm/developers/index.html +0 -262
  640. package/node_modules/npm/docs/public/using-npm/disputes/index.html +0 -195
  641. package/node_modules/npm/docs/public/using-npm/orgs/index.html +0 -147
  642. package/node_modules/npm/docs/public/using-npm/registry/index.html +0 -159
  643. package/node_modules/npm/docs/public/using-npm/removal/index.html +0 -119
  644. package/node_modules/npm/docs/public/using-npm/scope/index.html +0 -162
  645. package/node_modules/npm/docs/public/using-npm/scripts/index.html +0 -326
  646. package/node_modules/npm/docs/public/using-npm/semver/index.html +0 -438
  647. package/node_modules/npm/docs/src/components/Accordion.js +0 -57
  648. package/node_modules/npm/docs/src/components/Button.js +0 -22
  649. package/node_modules/npm/docs/src/components/DocLinks.js +0 -72
  650. package/node_modules/npm/docs/src/components/FoundTypo.js +0 -23
  651. package/node_modules/npm/docs/src/components/MobileSidebar.js +0 -33
  652. package/node_modules/npm/docs/src/components/Sidebar.js +0 -30
  653. package/node_modules/npm/docs/src/components/home/DarkBlock.js +0 -40
  654. package/node_modules/npm/docs/src/components/home/FeatureCard.js +0 -39
  655. package/node_modules/npm/docs/src/components/home/Features.js +0 -83
  656. package/node_modules/npm/docs/src/components/home/Footer.js +0 -29
  657. package/node_modules/npm/docs/src/components/home/Terminal.js +0 -120
  658. package/node_modules/npm/docs/src/components/home/Windows.js +0 -73
  659. package/node_modules/npm/docs/src/components/home/cubes.js +0 -101
  660. package/node_modules/npm/docs/src/components/home/hero.js +0 -25
  661. package/node_modules/npm/docs/src/components/layout.js +0 -24
  662. package/node_modules/npm/docs/src/components/links.js +0 -50
  663. package/node_modules/npm/docs/src/components/navbar.js +0 -136
  664. package/node_modules/npm/docs/src/components/scripts.js +0 -27
  665. package/node_modules/npm/docs/src/components/seo.js +0 -88
  666. package/node_modules/npm/docs/src/images/background-boxes.svg +0 -2782
  667. package/node_modules/npm/docs/src/images/background-cubes.svg +0 -2767
  668. package/node_modules/npm/docs/src/images/background-rectangles.svg +0 -1
  669. package/node_modules/npm/docs/src/images/bracket.svg +0 -1
  670. package/node_modules/npm/docs/src/images/cli-logo.svg +0 -1
  671. package/node_modules/npm/docs/src/images/down-carrot.svg +0 -1
  672. package/node_modules/npm/docs/src/images/hamburger-close.svg +0 -1
  673. package/node_modules/npm/docs/src/images/hamburger.svg +0 -1
  674. package/node_modules/npm/docs/src/images/manager-icon.svg +0 -1
  675. package/node_modules/npm/docs/src/images/network-icon.svg +0 -1
  676. package/node_modules/npm/docs/src/images/npm-icon.png +0 -0
  677. package/node_modules/npm/docs/src/images/orange-cube.svg +0 -1
  678. package/node_modules/npm/docs/src/images/pink-gradient-cube.svg +0 -1
  679. package/node_modules/npm/docs/src/images/purple-cube.svg +0 -1
  680. package/node_modules/npm/docs/src/images/purple-gradient-cube.svg +0 -1
  681. package/node_modules/npm/docs/src/images/red-cube.svg +0 -1
  682. package/node_modules/npm/docs/src/images/right-shadow-box.svg +0 -2809
  683. package/node_modules/npm/docs/src/images/terminal-icon.svg +0 -1
  684. package/node_modules/npm/docs/src/images/test-icon.svg +0 -1
  685. package/node_modules/npm/docs/src/images/up-carrot.svg +0 -1
  686. package/node_modules/npm/docs/src/images/x.svg +0 -1
  687. package/node_modules/npm/docs/src/main.css +0 -167
  688. package/node_modules/npm/docs/src/pages/404.js +0 -12
  689. package/node_modules/npm/docs/src/pages/index.js +0 -16
  690. package/node_modules/npm/docs/src/templates/Page.js +0 -40
  691. package/node_modules/npm/docs/src/theme.js +0 -50
  692. package/node_modules/npm/man/man7/disputes.7 +0 -149
  693. package/node_modules/npm/node_modules/balanced-match/.npmignore +0 -5
  694. package/node_modules/npm/node_modules/combined-stream/lib/defer.js +0 -26
  695. package/node_modules/npm/node_modules/dezalgo/.travis.yml +0 -7
  696. package/node_modules/npm/node_modules/dezalgo/test/basic.js +0 -29
  697. package/node_modules/npm/node_modules/glob/changelog.md +0 -67
  698. package/node_modules/npm/node_modules/meant/.github/workflows/ci.yml +0 -20
  699. package/node_modules/npm/node_modules/meant/test.js +0 -11
  700. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/.travis.yml +0 -8
  701. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/LICENSE +0 -18
  702. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/example/parse.js +0 -2
  703. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/index.js +0 -249
  704. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/package.json +0 -45
  705. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/readme.markdown +0 -98
  706. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/all_bool.js +0 -32
  707. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/bool.js +0 -178
  708. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/dash.js +0 -31
  709. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/default_bool.js +0 -35
  710. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/dotted.js +0 -22
  711. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/kv_short.js +0 -16
  712. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/long.js +0 -31
  713. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/num.js +0 -36
  714. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/parse.js +0 -197
  715. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/parse_modified.js +0 -9
  716. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/proto.js +0 -60
  717. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/short.js +0 -67
  718. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/stop_early.js +0 -15
  719. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/unknown.js +0 -102
  720. package/node_modules/npm/node_modules/mkdirp/node_modules/minimist/test/whitespace.js +0 -8
  721. package/node_modules/npm/node_modules/psl/.eslintignore +0 -1
  722. package/node_modules/npm/node_modules/psl/.eslintrc +0 -11
  723. package/node_modules/npm/node_modules/psl/.travis.yml +0 -6
  724. package/node_modules/npm/node_modules/psl/karma.conf.js +0 -38
  725. package/node_modules/npm/node_modules/psl/yarn.lock +0 -4532
  726. package/node_modules/npm/node_modules/punycode/package.json +0 -60
  727. package/node_modules/npm/node_modules/punycode/punycode.js +0 -533
  728. package/node_modules/npm/node_modules/qs/.eslintignore +0 -1
  729. package/node_modules/npm/node_modules/qs/LICENSE +0 -28
  730. package/node_modules/npm/node_modules/qs/test/.eslintrc +0 -15
  731. package/node_modules/npm/node_modules/qw/README.md~ +0 -27
  732. package/node_modules/npm/node_modules/sshpk/.npmignore +0 -9
@@ -1,438 +0,0 @@
1
- <!DOCTYPE html><html><head><script>"use strict";!function(){var i=(window.location.pathname.match(/^(\/(?:ipfs|ipns)\/[^/]+)/)||[])[1]||"";window.__GATSBY_IPFS_PATH_PREFIX__=i}();</script><meta charSet="utf-8"/><meta http-equiv="x-ua-compatible" content="ie=edge"/><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"/><style data-href="../../styles.e93b5499b63484750fba.css">code[class*=language-],pre[class*=language-]{color:#ccc;background:none;font-family:Consolas,Monaco,Andale Mono,Ubuntu Mono,monospace;font-size:1em;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;line-height:1.5;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-hyphens:none;-ms-hyphens:none;hyphens:none}pre[class*=language-]{padding:1em;margin:.5em 0;overflow:auto}:not(pre)>code[class*=language-],pre[class*=language-]{background:#2d2d2d}:not(pre)>code[class*=language-]{padding:.1em;border-radius:.3em;white-space:normal}.token.block-comment,.token.cdata,.token.comment,.token.doctype,.token.prolog{color:#999}.token.punctuation{color:#ccc}.token.attr-name,.token.deleted,.token.namespace,.token.tag{color:#e2777a}.token.function-name{color:#6196cc}.token.boolean,.token.function,.token.number{color:#f08d49}.token.class-name,.token.constant,.token.property,.token.symbol{color:#f8c555}.token.atrule,.token.builtin,.token.important,.token.keyword,.token.selector{color:#cc99cd}.token.attr-value,.token.char,.token.regex,.token.string,.token.variable{color:#7ec699}.token.entity,.token.operator,.token.url{color:#67cdcc}.token.bold,.token.important{font-weight:700}.token.italic{font-style:italic}.token.entity{cursor:help}.token.inserted{color:green}a,abbr,acronym,address,applet,article,aside,audio,b,big,blockquote,body,canvas,caption,center,cite,code,dd,del,details,dfn,div,dl,dt,em,embed,fieldset,figcaption,figure,footer,form,h1,h2,h3,h4,h5,h6,header,hgroup,html,i,iframe,img,ins,kbd,label,legend,li,mark,menu,nav,object,ol,output,p,pre,q,ruby,s,samp,section,small,span,strike,strong,sub,summary,sup,table,tbody,td,tfoot,th,thead,time,tr,tt,u,ul,var,video{margin:0;padding:0;border:0;font-size:100%;font:inherit;vertical-align:baseline}article,aside,details,figcaption,figure,footer,header,hgroup,menu,nav,section{display:block}body{line-height:1}ol,ul{list-style:none}blockquote,q{quotes:none}blockquote:after,blockquote:before,q:after,q:before{content:"";content:none}table{border-collapse:collapse;border-spacing:0}[hidden]{display:none}html{font-family:Poppins,sans-serif}*{box-sizing:border-box}li,p{font-size:15px;line-height:1.7;font-weight:300}p,ul{padding:10px 0}strong{font-weight:700;color:#c3f}li{list-style-type:disc;list-style-position:inside;padding:8px 0}.documentation h1{font-size:42px;font-weight:600;padding:30px 0 10px}.documentation h2{font-size:22px;font-weight:300}.documentation h3{color:#c3f;font-size:22px;padding:30px 0 5px;font-weight:500}.documentation h4{font-weight:600;padding:20px 0 5px}.documentation p{display:inline-block}:not(pre)>code[class*=language-],pre[class*=language-]{border-radius:4px;background-color:#413844;font-size:13px}:not(pre)>code[class*=language-text]{background-color:rgba(204,139,216,.1);color:#413844;padding:2px 6px;border-radius:0;font-size:14px;font-weight:700;border-radius:1px;display:inline-block}.documentation a,a>code[class*=language-text]{color:#fb3b49;font-weight:600}p>code[class*=language-text]{display:inline-block}.documentation h1:before{content:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' viewBox='0 0 27 26'%3E%3Cdefs%3E%3ClinearGradient id='a' x1='18.13' x2='25.6' y1='13.48' y2='13.48' gradientUnits='userSpaceOnUse'%3E%3Cstop offset='0' stop-color='%23fb8817'/%3E%3Cstop offset='.37' stop-color='%23fb8719'/%3E%3Cstop offset='.51' stop-color='%23fa8420'/%3E%3Cstop offset='.61' stop-color='%23f9802c'/%3E%3Cstop offset='.69' stop-color='%23f7793d'/%3E%3Cstop offset='.76' stop-color='%23f47053'/%3E%3Cstop offset='.82' stop-color='%23f1656e'/%3E%3Cstop offset='.87' stop-color='%23ed578f'/%3E%3Cstop offset='.92' stop-color='%23e948b5'/%3E%3Cstop offset='.97' stop-color='%23e437de'/%3E%3Cstop offset='1' stop-color='%23e02aff'/%3E%3C/linearGradient%3E%3ClinearGradient id='b' x1='17.89' x2='25.84' y1='13.48' y2='13.48' gradientUnits='userSpaceOnUse'%3E%3Cstop offset='0' stop-color='%23fb8817'/%3E%3Cstop offset='1' stop-color='%23e02aff'/%3E%3C/linearGradient%3E%3ClinearGradient id='c' x1='1' x2='18.69' y1='17.84' y2='17.84' xlink:href='%23a'/%3E%3ClinearGradient id='d' x1='.76' x2='18.93' y1='17.84' y2='17.84' xlink:href='%23b'/%3E%3ClinearGradient id='e' x1='1' x2='20.48' y1='7.33' y2='7.33' xlink:href='%23a'/%3E%3ClinearGradient id='f' x1='.76' x2='20.72' y1='7.33' y2='7.33' xlink:href='%23b'/%3E%3C/defs%3E%3Cpath fill='url(%23a)' stroke='url(%23b)' stroke-miterlimit='10' stroke-width='.48' d='M18.53 24.24a.28.28 0 01-.34-.41L25 14.06l-5-11a.28.28 0 11.5-.23L25.58 14a.28.28 0 010 .28l-6.91 9.9a.28.28 0 01-.14.06z'/%3E%3Cpath fill='url(%23c)' stroke='url(%23d)' stroke-miterlimit='10' stroke-width='.48' d='M18.53 24.24a.28.28 0 01-.14 0l-12-1.15a.28.28 0 01-.23-.09L1 11.81a.28.28 0 11.5-.23l5.07 11L18 23.68 13 13a.28.28 0 11.5-.23l5.12 11.12a.28.28 0 01-.09.35z'/%3E%3Cpath fill='url(%23e)' stroke='url(%23f)' stroke-miterlimit='10' stroke-width='.48' d='M13.4 13.12a.25.25 0 01-.14 0L1.25 12a.28.28 0 01-.2-.44L8 1.64a.28.28 0 01.25-.12l12 1.18a.28.28 0 01.2.44L13.51 13a.25.25 0 01-.11.12z'/%3E%3C/svg%3E");position:relative;display:inline-block;padding-right:8px;top:3px;width:28px}.active-sidebar-link{background-color:#ffebff}.active-navbar-link{border-bottom:3px solid #c3f}.header-link-class{margin-left:-24px}.disabled-body{overflow:hidden}</style><meta name="generator" content="Gatsby 2.18.18"/><title data-react-helmet="true"></title><style data-styled="UihHA jAtLxz bCnUTx bAGJfc hJcdbU kOyZtC eCQAUi fsnHHg bXQeSB dsecBh iPgskl bNiGAM gJQTGP fMOzaj" data-styled-version="4.4.1">
2
- /* sc-component-id: links__NavLink-sc-19vgq0o-1 */
3
- .kOyZtC{font-weight:500;-webkit-text-decoration:none;text-decoration:none;-webkit-letter-spacing:.3px;-moz-letter-spacing:.3px;-ms-letter-spacing:.3px;letter-spacing:.3px;font-size:14px;color:#231f20;-webkit-transition:opacity .5s;transition:opacity .5s;margin:0 10px;} .kOyZtC:hover{opacity:.5;}
4
- /* sc-component-id: links__BasicNavLink-sc-19vgq0o-2 */
5
- .eCQAUi{font-weight:500;-webkit-text-decoration:none;text-decoration:none;-webkit-letter-spacing:.3px;-moz-letter-spacing:.3px;-ms-letter-spacing:.3px;letter-spacing:.3px;font-size:14px;color:#231f20;-webkit-transition:opacity .5s;transition:opacity .5s;margin:0 10px;} .eCQAUi:hover{opacity:.5;}
6
- /* sc-component-id: links__SidebarLink-sc-19vgq0o-3 */
7
- .iPgskl{font-weight:500;-webkit-text-decoration:none;text-decoration:none;-webkit-letter-spacing:.3px;-moz-letter-spacing:.3px;-ms-letter-spacing:.3px;letter-spacing:.3px;font-size:14px;color:#fb3b49;padding:10px;-webkit-transition:background-color .3s;transition:background-color .3s;} .iPgskl:hover{background-color:#ffebff;}
8
- /* sc-component-id: Accordion__SectionButton-i8yhwx-0 */
9
- .dsecBh{outline:none;background-color:transparent;cursor:pointer;color:red;border:none;font-size:18px;font-weight:bold;padding:5px 0;-webkit-transition:opacity .5s;transition:opacity .5s;} .dsecBh:after{background:center / contain no-repeat url(data:image/svg+xml;base64,PHN2ZyBpZD0iTGF5ZXJfMSIgZGF0YS1uYW1lPSJMYXllciAxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxNi41IDEwIj48ZGVmcz48c3R5bGU+LmNscy0xe2ZpbGw6I2ZiM2I0OTt9PC9zdHlsZT48L2RlZnM+PHRpdGxlPnVwLWNhcnJvdDwvdGl0bGU+PHBhdGggY2xhc3M9ImNscy0xIiBkPSJNOC4yNS44NWExLjE1LDEuMTUsMCwwLDAtLjgxLjM0bC02LDZBMS4xNSwxLjE1LDAsMCwwLDMuMDYsOC44MUw4LjI1LDMuNjNsNS4xOSw1LjE5YTEuMTUsMS4xNSwwLDAsMCwxLjYzLTEuNjNsLTYtNkExLjE1LDEuMTUsMCwwLDAsOC4yNS44NVoiLz48L3N2Zz4=);content:'';height:11px;width:28px;display:inline-block;} .dsecBh:hover{opacity:.6;}
10
- /* sc-component-id: DocLinks__LinkDesc-sc-1vrw6od-0 */
11
- .bNiGAM{font-size:11px;line-height:1.5;text-transform:lowercase;display:block;font-weight:400;color:#767676;}
12
- /* sc-component-id: Sidebar__Container-gs0c67-0 */
13
- .bXQeSB{border-right:1px solid #86838333;padding:30px;height:100vh;display:none;width:380px;position:-webkit-sticky;position:sticky;overflow:scroll;padding-bottom:200px;top:54px;background-color:#ffffff;} @media screen and (min-width:48em){.bXQeSB{display:block;}}
14
- /* sc-component-id: navbar__Container-kjuegf-0 */
15
- .UihHA{width:100%;border-bottom:1px solid #86838333;position:-webkit-sticky;position:sticky;top:0;background-color:#ffffff;z-index:1;}
16
- /* sc-component-id: navbar__Inner-kjuegf-1 */
17
- .jAtLxz{border-top:3px solid;border-image:linear-gradient(139deg,#fb8817,#ff4b01,#c12127,#e02aff) 3;margin:auto;height:53px;padding:0 30px;-webkit-align-items:center;-webkit-box-align:center;-ms-flex-align:center;align-items:center;width:100%;}
18
- /* sc-component-id: navbar__Logo-kjuegf-2 */
19
- .bAGJfc{width:120px;padding:0px 5px;height:18px;vertical-align:middle;display:inline-block;-webkit-transition:opacity .5s;transition:opacity .5s;} .bAGJfc:hover{opacity:.8;}
20
- /* sc-component-id: navbar__Links-kjuegf-3 */
21
- .hJcdbU{display:none;} @media screen and (min-width:48em){.hJcdbU{display:block;margin-left:auto;}}
22
- /* sc-component-id: navbar__Heart-kjuegf-4 */
23
- .bCnUTx{font-size:15px;display:inline-block;}
24
- /* sc-component-id: navbar__Hamburger-kjuegf-5 */
25
- .fsnHHg{border:none;background:center no-repeat url(data:image/svg+xml;base64,PHN2ZyBpZD0iTGF5ZXJfMSIgZGF0YS1uYW1lPSJMYXllciAxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgMzUgMjMiPjxkZWZzPjxzdHlsZT4uY2xzLTF7ZmlsbDp1cmwoI2xpbmVhci1ncmFkaWVudCk7fS5jbHMtMntmaWxsOnVybCgjbGluZWFyLWdyYWRpZW50LTIpO30uY2xzLTN7ZmlsbDp1cmwoI2xpbmVhci1ncmFkaWVudC0zKTt9PC9zdHlsZT48bGluZWFyR3JhZGllbnQgaWQ9ImxpbmVhci1ncmFkaWVudCIgeTE9IjIiIHgyPSIzNSIgeTI9IjIiIGdyYWRpZW50VW5pdHM9InVzZXJTcGFjZU9uVXNlIj48c3RvcCBvZmZzZXQ9IjAiIHN0b3AtY29sb3I9IiNmYjg4MTciLz48c3RvcCBvZmZzZXQ9IjEiIHN0b3AtY29sb3I9IiNlMDJhZmYiLz48L2xpbmVhckdyYWRpZW50PjxsaW5lYXJHcmFkaWVudCBpZD0ibGluZWFyLWdyYWRpZW50LTIiIHkxPSIxMS41IiB5Mj0iMTEuNSIgeGxpbms6aHJlZj0iI2xpbmVhci1ncmFkaWVudCIvPjxsaW5lYXJHcmFkaWVudCBpZD0ibGluZWFyLWdyYWRpZW50LTMiIHkxPSIyMSIgeTI9IjIxIiB4bGluazpocmVmPSIjbGluZWFyLWdyYWRpZW50Ii8+PC9kZWZzPjx0aXRsZT5oYW1idXJnZXI8L3RpdGxlPjxyZWN0IGNsYXNzPSJjbHMtMSIgd2lkdGg9IjM1IiBoZWlnaHQ9IjQiIHJ4PSIyIiByeT0iMiIvPjxyZWN0IGNsYXNzPSJjbHMtMiIgeT0iOS41IiB3aWR0aD0iMzUiIGhlaWdodD0iNCIgcng9IjIiIHJ5PSIyIi8+PHJlY3QgY2xhc3M9ImNscy0zIiB5PSIxOSIgd2lkdGg9IjM1IiBoZWlnaHQ9IjQiIHJ4PSIyIiByeT0iMiIvPjwvc3ZnPg==);height:30px;width:30px;display:block;margin-left:auto;-webkit-transition:opacity .5s;transition:opacity .5s;cursor:pointer;} .fsnHHg:hover{opacity:.6;} @media screen and (min-width:48em){.fsnHHg{display:none;}}
26
- /* sc-component-id: FoundTypo__Container-sc-1e373sc-0 */
27
- .fMOzaj{margin:80px 0;border-top:1px solid black;padding:20px 0;}
28
- /* sc-component-id: Page__Content-sc-4b62ym-0 */
29
- .gJQTGP{max-width:760px;margin:auto;padding:0 30px 120px;}</style><link rel="icon" href="../../icons/icon-48x48.png?v=7a2e468321d0881d02a038e839dfc4a3"/><link rel="manifest" href="../../manifest.webmanifest"/><meta name="theme-color" content="#663399"/><link rel="apple-touch-icon" sizes="48x48" href="../../icons/icon-48x48.png?v=7a2e468321d0881d02a038e839dfc4a3"/><link rel="apple-touch-icon" sizes="72x72" href="../../icons/icon-72x72.png?v=7a2e468321d0881d02a038e839dfc4a3"/><link rel="apple-touch-icon" sizes="96x96" href="../../icons/icon-96x96.png?v=7a2e468321d0881d02a038e839dfc4a3"/><link rel="apple-touch-icon" sizes="144x144" href="../../icons/icon-144x144.png?v=7a2e468321d0881d02a038e839dfc4a3"/><link rel="apple-touch-icon" sizes="192x192" href="../../icons/icon-192x192.png?v=7a2e468321d0881d02a038e839dfc4a3"/><link rel="apple-touch-icon" sizes="256x256" href="../../icons/icon-256x256.png?v=7a2e468321d0881d02a038e839dfc4a3"/><link rel="apple-touch-icon" sizes="384x384" href="../../icons/icon-384x384.png?v=7a2e468321d0881d02a038e839dfc4a3"/><link rel="apple-touch-icon" sizes="512x512" href="../../icons/icon-512x512.png?v=7a2e468321d0881d02a038e839dfc4a3"/><link href="https://fonts.googleapis.com/css?family=Poppins|Inconsolata" rel="stylesheet"/><style type="text/css">
30
- .header-link-class.before {
31
- position: absolute;
32
- top: 0;
33
- left: 0;
34
- transform: translateX(-100%);
35
- padding-right: 4px;
36
- }
37
- .header-link-class.after {
38
- display: inline-block;
39
- padding-left: 4px;
40
- }
41
- h1 .header-link-class svg,
42
- h2 .header-link-class svg,
43
- h3 .header-link-class svg,
44
- h4 .header-link-class svg,
45
- h5 .header-link-class svg,
46
- h6 .header-link-class svg {
47
- visibility: hidden;
48
- }
49
- h1:hover .header-link-class svg,
50
- h2:hover .header-link-class svg,
51
- h3:hover .header-link-class svg,
52
- h4:hover .header-link-class svg,
53
- h5:hover .header-link-class svg,
54
- h6:hover .header-link-class svg,
55
- h1 .header-link-class:focus svg,
56
- h2 .header-link-class:focus svg,
57
- h3 .header-link-class:focus svg,
58
- h4 .header-link-class:focus svg,
59
- h5 .header-link-class:focus svg,
60
- h6 .header-link-class:focus svg {
61
- visibility: visible;
62
- }
63
- </style><script>
64
- document.addEventListener("DOMContentLoaded", function(event) {
65
- var hash = window.decodeURI(location.hash.replace('#', ''))
66
- if (hash !== '') {
67
- var element = document.getElementById(hash)
68
- if (element) {
69
- var offset = element.offsetTop
70
- // Wait for the browser to finish rendering before scrolling.
71
- setTimeout((function() {
72
- window.scrollTo(0, offset - 100)
73
- }), 0)
74
- }
75
- }
76
- })
77
- </script><link as="script" rel="preload" href="../../webpack-runtime-e00205099b1bddfaee91.js"/><link as="script" rel="preload" href="../../styles-de5e304580bcba768a01.js"/><link as="script" rel="preload" href="../../commons-4df35f6dbd2fdc25d817.js"/><link as="script" rel="preload" href="../../app-f19f1d7f30af98d21899.js"/><link as="script" rel="preload" href="../../component---src-templates-page-js-4e7e861bc681ee3dfaa8.js"/><link as="fetch" rel="preload" href="../../page-data/using-npm/semver/page-data.json" crossorigin="anonymous"/></head><body><div id="___gatsby"><div style="outline:none" tabindex="-1" role="group" id="gatsby-focus-wrapper"><style data-emotion-css="4cffwv">.css-4cffwv{box-sizing:border-box;margin:0;min-width:0;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;}</style><div class="navbar__Container-kjuegf-0 UihHA css-4cffwv"><div class="navbar__Inner-kjuegf-1 jAtLxz css-4cffwv"><a href="../../"><style data-emotion-css="26z63x">.css-26z63x{box-sizing:border-box;margin:0;min-width:0;margin-left:4px;margin-right:24px;}</style><div class="navbar__Heart-kjuegf-4 bCnUTx css-26z63x">❤</div><style data-emotion-css="9taffg">.css-9taffg{box-sizing:border-box;margin:0;min-width:0;max-width:100%;height:auto;}</style><img src="data:image/svg+xml;base64,PHN2ZyBpZD0iTGF5ZXJfMSIgZGF0YS1uYW1lPSJMYXllciAxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxMDcgMTciPjxkZWZzPjxzdHlsZT4uY2xzLTF7ZmlsbDojMjMxZjIwO30uY2xzLTJ7ZmlsbDpub25lO308L3N0eWxlPjwvZGVmcz48dGl0bGU+Y2xpLWxvZ288L3RpdGxlPjxwYXRoIGNsYXNzPSJjbHMtMSIgZD0iTS41NCwxMy40aDYuNFYzLjY3aDMuMlYxMy40aDMuMlYuNDJILjU0Wk0zMS4yNi40MnYxM2g2LjRWMy42N2gzLjJWMTMuNGgzLjJWMy42N2gzLjE5VjEzLjRoMy4yVi40MlptLTksMy4yNWgzLjJ2Ni40OUgyMi4zWm0tNi40LDEzaDYuNFYxMy40aDYuNFYuNDJIMTUuOVoiLz48cmVjdCBjbGFzcz0iY2xzLTIiIHg9IjAuNTQiIHk9IjAuNDIiIHdpZHRoPSI0OS45MSIgaGVpZ2h0PSIxNi4yMiIvPjxwb2x5Z29uIGNsYXNzPSJjbHMtMSIgcG9pbnRzPSI2NS41OCAzLjU2IDY1LjU4IDkuODYgNzEuNjYgOS44NiA3MS42NiAxMy4wMiA2NS40NCAxMy4wMiA1OS4yIDEzLjA0IDU5LjIyIDAuNDEgNzEuNjYgMC40MSA3MS42NiAzLjU0IDY1LjU4IDMuNTYiLz48cG9seWdvbiBjbGFzcz0iY2xzLTEiIHBvaW50cz0iODAuNjIgMTAuMjMgODAuNjIgMC4zNiA3NC4yMyAwLjM2IDc0LjIzIDEzLjMgNzYuOTIgMTMuMyA4MC42MiAxMy4zIDg2LjQ3IDEzLjMgODYuNDcgMTAuMjMgODAuNjIgMTAuMjMiLz48cmVjdCBjbGFzcz0iY2xzLTEiIHg9IjEwMS4zMiIgeT0iOC4zNyIgd2lkdGg9IjEuOTkiIGhlaWdodD0iOC4yOSIgdHJhbnNmb3JtPSJ0cmFuc2xhdGUoMTE0LjgzIC04OS43OSkgcm90YXRlKDkwKSIvPjxyZWN0IGNsYXNzPSJjbHMtMSIgeD0iODguMzMiIHk9IjAuMzYiIHdpZHRoPSI2LjM5IiBoZWlnaHQ9IjEyLjk0Ii8+PC9zdmc+" class="navbar__Logo-kjuegf-2 bAGJfc css-9taffg"/></a><ul class="navbar__Links-kjuegf-3 hJcdbU"><a class="links__NavLink-sc-19vgq0o-1 kOyZtC" href="../../cli-commands/npm/index.html">docs</a><a href="https://www.npmjs.com/" class="links__BasicNavLink-sc-19vgq0o-2 eCQAUi">npmjs.org</a></ul><button class="navbar__Hamburger-kjuegf-5 fsnHHg"></button></div></div><style data-emotion-css="4cffwv">.css-4cffwv{box-sizing:border-box;margin:0;min-width:0;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;}</style><div class="css-4cffwv"><nav class="Sidebar__Container-gs0c67-0 bXQeSB sidebar"><div><button class="Accordion__SectionButton-i8yhwx-0 dsecBh">cli-commands</button><div><style data-emotion-css="l3rx45">.css-l3rx45{box-sizing:border-box;margin:0;min-width:0;-webkit-flex-direction:column;-ms-flex-direction:column;flex-direction:column;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;}</style><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm">npm<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">javascript package manager</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-access">npm access<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Set access level on published packages</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-audit">npm audit<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Run a security audit</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-bin">npm bin<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Display npm bin folder</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-bugs">npm bugs<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Bugs for a package in a web browser maybe</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-build">npm build<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Build a package</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-bundle">npm bundle<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">REMOVED</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-cache">npm cache<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Manipulates packages cache</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-ci">npm ci<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Install a project with a clean slate</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-completion">npm completion<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Tab Completion for npm</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-config">npm config<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Manage the npm configuration files</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-dedupe">npm dedupe<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Reduce duplication</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-deprecate">npm deprecate<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Deprecate a version of a package</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-docs">npm docs<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Docs for a package in a web browser maybe</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-doctor">npm doctor<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Check your environments</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-edit">npm edit<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Edit an installed package</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-fund">npm fund<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Retrieve funding information</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-help">npm help<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Get help on npm</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-help-search">npm help-search<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Search npm help documentation</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-hook">npm hook<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Manage registry hooks</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-init">npm init<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">create a package.json file</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-install">npm install<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Install a package</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-install-ci-test">npm install-ci-test<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Install a project with a clean slate and run tests</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-install-test">npm install-test<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Install package(s) and run tests</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-link">npm link<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Symlink a package folder</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-logout">npm logout<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Log out of the registry</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-ls">npm ls<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">List installed packages</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-org">npm org<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Manage orgs</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-outdated">npm outdated<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Check for outdated packages</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-owner">npm owner<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Manage package owners</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-pack">npm pack<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Create a tarball from a package</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-ping">npm ping<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Ping npm registry</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-prefix">npm prefix<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Display prefix</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-profile">npm profile<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Change settings on your registry profile</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-prune">npm prune<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Remove extraneous packages</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-publish">npm publish<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Publish a package</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-rebuild">npm rebuild<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Rebuild a package</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-repo">npm repo<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Open package repository page in the browser</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-restart">npm restart<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Restart a package</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-root">npm root<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Display npm root</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-run-script">npm run-script<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Run arbitrary package scripts</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-search">npm search<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Search for packages</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-shrinkwrap">npm shrinkwrap<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Lock down dependency versions for publication</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-star">npm star<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Mark your favorite packages</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-stars">npm stars<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">View packages marked as favorites</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-start">npm start<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Start a package</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-stop">npm stop<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Stop a package</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-team">npm team<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Manage organization teams and team memberships</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-test">npm test<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Test a package</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-token">npm token<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Manage your authentication tokens</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-uninstall">npm uninstall<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Remove a package</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-unpublish">npm unpublish<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Remove a package from the registry</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-update">npm update<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Update a package</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-version">npm version<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Bump a package version</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-view">npm view<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">View registry info</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../cli-commands/npm-whoami">npm whoami<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Display npm username</span></a></div></div></div><div><button class="Accordion__SectionButton-i8yhwx-0 dsecBh">configuring-npm</button><div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../configuring-npm/folders">folders<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Folder Structures Used by npm</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../configuring-npm/install">install<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Download and install node and npm</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../configuring-npm/npmrc">npmrc<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">The npm config files</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../configuring-npm/package-lock-json">package-lock.json<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">A manifestation of the manifest</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../configuring-npm/package-locks">package-locks<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">An explanation of npm lockfiles</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../configuring-npm/package-json">package.json<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Specifics of npm&#x27;s package.json handling</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../configuring-npm/shrinkwrap-json">shrinkwrap.json<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">A publishable lockfile</span></a></div></div></div><div><button class="Accordion__SectionButton-i8yhwx-0 dsecBh">using-npm</button><div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../using-npm/config">config<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">More than you probably want to know about npm configuration</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../using-npm/developers">developers<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Developer Guide</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../using-npm/disputes">disputes<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Handling Module Name Disputes</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../using-npm/orgs">orgs<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Working with Teams &amp; Orgs</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../using-npm/registry">registry<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">The JavaScript Package Registry</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../using-npm/removal">removal<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Cleaning the Slate</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../using-npm/scope">scope<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">Scoped packages</span></a></div><div class="css-l3rx45"><a class="links__SidebarLink-sc-19vgq0o-3 iPgskl" href="../../using-npm/scripts">scripts<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">How npm handles the &quot;scripts&quot; field</span></a></div><div class="css-l3rx45"><a aria-current="page" class="links__SidebarLink-sc-19vgq0o-3 iPgskl active-sidebar-link" href="../../using-npm/semver">semver<span class="DocLinks__LinkDesc-sc-1vrw6od-0 bNiGAM">The semantic versioner for npm</span></a></div></div></div></nav><style data-emotion-css="16vu25q">.css-16vu25q{box-sizing:border-box;margin:0;min-width:0;width:100%;}</style><div class="css-16vu25q"><div class="Page__Content-sc-4b62ym-0 gJQTGP documentation"><div><h1 id="semver7----the-semantic-versioner-for-npm" style="position:relative;"><a href="#semver7----the-semantic-versioner-for-npm" aria-label="semver7 the semantic versioner for npm permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>semver(7) -- The semantic versioner for npm</h1>
78
- <h2 id="install" style="position:relative;"><a href="#install" aria-label="install permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Install</h2>
79
- <div class="gatsby-highlight" data-language="bash"><pre class="language-bash"><code class="language-bash"><span class="token function">npm</span> <span class="token function">install</span> --save semver</code></pre></div>
80
- <h2 id="usage" style="position:relative;"><a href="#usage" aria-label="usage permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Usage</h2>
81
- <p>As a node module:</p>
82
- <div class="gatsby-highlight" data-language="js"><pre class="language-js"><code class="language-js"><span class="token keyword">const</span> semver <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'semver'</span><span class="token punctuation">)</span>
83
-
84
- semver<span class="token punctuation">.</span><span class="token function">valid</span><span class="token punctuation">(</span><span class="token string">'1.2.3'</span><span class="token punctuation">)</span> <span class="token comment">// '1.2.3'</span>
85
- semver<span class="token punctuation">.</span><span class="token function">valid</span><span class="token punctuation">(</span><span class="token string">'a.b.c'</span><span class="token punctuation">)</span> <span class="token comment">// null</span>
86
- semver<span class="token punctuation">.</span><span class="token function">clean</span><span class="token punctuation">(</span><span class="token string">' =v1.2.3 '</span><span class="token punctuation">)</span> <span class="token comment">// '1.2.3'</span>
87
- semver<span class="token punctuation">.</span><span class="token function">satisfies</span><span class="token punctuation">(</span><span class="token string">'1.2.3'</span><span class="token punctuation">,</span> <span class="token string">'1.x || >=2.5.0 || 5.0.0 - 7.2.3'</span><span class="token punctuation">)</span> <span class="token comment">// true</span>
88
- semver<span class="token punctuation">.</span><span class="token function">gt</span><span class="token punctuation">(</span><span class="token string">'1.2.3'</span><span class="token punctuation">,</span> <span class="token string">'9.8.7'</span><span class="token punctuation">)</span> <span class="token comment">// false</span>
89
- semver<span class="token punctuation">.</span><span class="token function">lt</span><span class="token punctuation">(</span><span class="token string">'1.2.3'</span><span class="token punctuation">,</span> <span class="token string">'9.8.7'</span><span class="token punctuation">)</span> <span class="token comment">// true</span>
90
- semver<span class="token punctuation">.</span><span class="token function">minVersion</span><span class="token punctuation">(</span><span class="token string">'>=1.0.0'</span><span class="token punctuation">)</span> <span class="token comment">// '1.0.0'</span>
91
- semver<span class="token punctuation">.</span><span class="token function">valid</span><span class="token punctuation">(</span>semver<span class="token punctuation">.</span><span class="token function">coerce</span><span class="token punctuation">(</span><span class="token string">'v2'</span><span class="token punctuation">)</span><span class="token punctuation">)</span> <span class="token comment">// '2.0.0'</span>
92
- semver<span class="token punctuation">.</span><span class="token function">valid</span><span class="token punctuation">(</span>semver<span class="token punctuation">.</span><span class="token function">coerce</span><span class="token punctuation">(</span><span class="token string">'42.6.7.9.3-alpha'</span><span class="token punctuation">)</span><span class="token punctuation">)</span> <span class="token comment">// '42.6.7'</span></code></pre></div>
93
- <p>As a command-line utility:</p>
94
- <div class="gatsby-highlight" data-language="text"><pre class="language-text"><code class="language-text">$ semver -h
95
-
96
- A JavaScript implementation of the https://semver.org/ specification
97
- Copyright Isaac Z. Schlueter
98
-
99
- Usage: semver [options] &lt;version&gt; [&lt;version&gt; [...]]
100
- Prints valid versions sorted by SemVer precedence
101
-
102
- Options:
103
- -r --range &lt;range&gt;
104
- Print versions that match the specified range.
105
-
106
- -i --increment [&lt;level&gt;]
107
- Increment a version by the specified level. Level can
108
- be one of: major, minor, patch, premajor, preminor,
109
- prepatch, or prerelease. Default level is &#39;patch&#39;.
110
- Only one version may be specified.
111
-
112
- --preid &lt;identifier&gt;
113
- Identifier to be used to prefix premajor, preminor,
114
- prepatch or prerelease version increments.
115
-
116
- -l --loose
117
- Interpret versions and ranges loosely
118
-
119
- -p --include-prerelease
120
- Always include prerelease versions in range matching
121
-
122
- -c --coerce
123
- Coerce a string into SemVer if possible
124
- (does not imply --loose)
125
-
126
- Program exits successfully if any valid version satisfies
127
- all supplied ranges, and prints all satisfying versions.
128
-
129
- If no satisfying versions are found, then exits failure.
130
-
131
- Versions are printed in ascending order, so supplying
132
- multiple versions to the utility will just sort them.</code></pre></div>
133
- <h2 id="versions" style="position:relative;"><a href="#versions" aria-label="versions permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Versions</h2>
134
- <p>A "version" is described by the <code class="language-text">v2.0.0</code> specification found at
135
- <a href="https://semver.org/">https://semver.org/</a>.</p>
136
- <p>A leading <code class="language-text">&quot;=&quot;</code> or <code class="language-text">&quot;v&quot;</code> character is stripped off and ignored.</p>
137
- <h2 id="ranges" style="position:relative;"><a href="#ranges" aria-label="ranges permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Ranges</h2>
138
- <p>A <code class="language-text">version range</code> is a set of <code class="language-text">comparators</code> which specify versions
139
- that satisfy the range.</p>
140
- <p>A <code class="language-text">comparator</code> is composed of an <code class="language-text">operator</code> and a <code class="language-text">version</code>. The set
141
- of primitive <code class="language-text">operators</code> is:</p>
142
- <ul>
143
- <li><code class="language-text">&lt;</code> Less than</li>
144
- <li><code class="language-text">&lt;=</code> Less than or equal to</li>
145
- <li><code class="language-text">&gt;</code> Greater than</li>
146
- <li><code class="language-text">&gt;=</code> Greater than or equal to</li>
147
- <li><code class="language-text">=</code> Equal. If no operator is specified, then equality is assumed,
148
- so this operator is optional, but MAY be included.</li>
149
- </ul>
150
- <p>For example, the comparator <code class="language-text">&gt;=1.2.7</code> would match the versions
151
- <code class="language-text">1.2.7</code>, <code class="language-text">1.2.8</code>, <code class="language-text">2.5.3</code>, and <code class="language-text">1.3.9</code>, but not the versions <code class="language-text">1.2.6</code>
152
- or <code class="language-text">1.1.0</code>.</p>
153
- <p>Comparators can be joined by whitespace to form a <code class="language-text">comparator set</code>,
154
- which is satisfied by the <strong>intersection</strong> of all of the comparators
155
- it includes.</p>
156
- <p>A range is composed of one or more comparator sets, joined by <code class="language-text">||</code>. A
157
- version matches a range if and only if every comparator in at least
158
- one of the <code class="language-text">||</code>-separated comparator sets is satisfied by the version.</p>
159
- <p>For example, the range <code class="language-text">&gt;=1.2.7 &lt;1.3.0</code> would match the versions
160
- <code class="language-text">1.2.7</code>, <code class="language-text">1.2.8</code>, and <code class="language-text">1.2.99</code>, but not the versions <code class="language-text">1.2.6</code>, <code class="language-text">1.3.0</code>,
161
- or <code class="language-text">1.1.0</code>.</p>
162
- <p>The range <code class="language-text">1.2.7 || &gt;=1.2.9 &lt;2.0.0</code> would match the versions <code class="language-text">1.2.7</code>,
163
- <code class="language-text">1.2.9</code>, and <code class="language-text">1.4.6</code>, but not the versions <code class="language-text">1.2.8</code> or <code class="language-text">2.0.0</code>.</p>
164
- <h3 id="prerelease-tags" style="position:relative;"><a href="#prerelease-tags" aria-label="prerelease tags permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Prerelease Tags</h3>
165
- <p>If a version has a prerelease tag (for example, <code class="language-text">1.2.3-alpha.3</code>) then
166
- it will only be allowed to satisfy comparator sets if at least one
167
- comparator with the same <code class="language-text">[major, minor, patch]</code> tuple also has a
168
- prerelease tag.</p>
169
- <p>For example, the range <code class="language-text">&gt;1.2.3-alpha.3</code> would be allowed to match the
170
- version <code class="language-text">1.2.3-alpha.7</code>, but it would <em>not</em> be satisfied by
171
- <code class="language-text">3.4.5-alpha.9</code>, even though <code class="language-text">3.4.5-alpha.9</code> is technically "greater
172
- than" <code class="language-text">1.2.3-alpha.3</code> according to the SemVer sort rules. The version
173
- range only accepts prerelease tags on the <code class="language-text">1.2.3</code> version. The
174
- version <code class="language-text">3.4.5</code> <em>would</em> satisfy the range, because it does not have a
175
- prerelease flag, and <code class="language-text">3.4.5</code> is greater than <code class="language-text">1.2.3-alpha.7</code>.</p>
176
- <p>The purpose for this behavior is twofold. First, prerelease versions
177
- frequently are updated very quickly, and contain many breaking changes
178
- that are (by the author's design) not yet fit for public consumption.
179
- Therefore, by default, they are excluded from range matching
180
- semantics.</p>
181
- <p>Second, a user who has opted into using a prerelease version has
182
- clearly indicated the intent to use <em>that specific</em> set of
183
- alpha/beta/rc versions. By including a prerelease tag in the range,
184
- the user is indicating that they are aware of the risk. However, it
185
- is still not appropriate to assume that they have opted into taking a
186
- similar risk on the <em>next</em> set of prerelease versions.</p>
187
- <p>Note that this behavior can be suppressed (treating all prerelease
188
- versions as if they were normal versions, for the purpose of range
189
- matching) by setting the <code class="language-text">includePrerelease</code> flag on the options
190
- object to any
191
- <a href="https://github.com/npm/node-semver#functions">functions</a> that do
192
- range matching.</p>
193
- <h4 id="prerelease-identifiers" style="position:relative;"><a href="#prerelease-identifiers" aria-label="prerelease identifiers permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Prerelease Identifiers</h4>
194
- <p>The method <code class="language-text">.inc</code> takes an additional <code class="language-text">identifier</code> string argument that
195
- will append the value of the string as a prerelease identifier:</p>
196
- <div class="gatsby-highlight" data-language="javascript"><pre class="language-javascript"><code class="language-javascript">semver<span class="token punctuation">.</span><span class="token function">inc</span><span class="token punctuation">(</span><span class="token string">'1.2.3'</span><span class="token punctuation">,</span> <span class="token string">'prerelease'</span><span class="token punctuation">,</span> <span class="token string">'beta'</span><span class="token punctuation">)</span>
197
- <span class="token comment">// '1.2.4-beta.0'</span></code></pre></div>
198
- <p>command-line example:</p>
199
- <div class="gatsby-highlight" data-language="bash"><pre class="language-bash"><code class="language-bash">$ semver <span class="token number">1.2</span>.3 -i prerelease --preid beta
200
- <span class="token number">1.2</span>.4-beta.0</code></pre></div>
201
- <p>Which then can be used to increment further:</p>
202
- <div class="gatsby-highlight" data-language="bash"><pre class="language-bash"><code class="language-bash">$ semver <span class="token number">1.2</span>.4-beta.0 -i prerelease
203
- <span class="token number">1.2</span>.4-beta.1</code></pre></div>
204
- <h3 id="advanced-range-syntax" style="position:relative;"><a href="#advanced-range-syntax" aria-label="advanced range syntax permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Advanced Range Syntax</h3>
205
- <p>Advanced range syntax desugars to primitive comparators in
206
- deterministic ways.</p>
207
- <p>Advanced ranges may be combined in the same way as primitive
208
- comparators using white space or <code class="language-text">||</code>.</p>
209
- <h4 id="hyphen-ranges-xyz---abc" style="position:relative;"><a href="#hyphen-ranges-xyz---abc" aria-label="hyphen ranges xyz abc permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Hyphen Ranges <code class="language-text">X.Y.Z - A.B.C</code></h4>
210
- <p>Specifies an inclusive set.</p>
211
- <ul>
212
- <li><code class="language-text">1.2.3 - 2.3.4</code> := <code class="language-text">&gt;=1.2.3 &lt;=2.3.4</code></li>
213
- </ul>
214
- <p>If a partial version is provided as the first version in the inclusive
215
- range, then the missing pieces are replaced with zeroes.</p>
216
- <ul>
217
- <li><code class="language-text">1.2 - 2.3.4</code> := <code class="language-text">&gt;=1.2.0 &lt;=2.3.4</code></li>
218
- </ul>
219
- <p>If a partial version is provided as the second version in the
220
- inclusive range, then all versions that start with the supplied parts
221
- of the tuple are accepted, but nothing that would be greater than the
222
- provided tuple parts.</p>
223
- <ul>
224
- <li><code class="language-text">1.2.3 - 2.3</code> := <code class="language-text">&gt;=1.2.3 &lt;2.4.0</code></li>
225
- <li><code class="language-text">1.2.3 - 2</code> := <code class="language-text">&gt;=1.2.3 &lt;3.0.0</code></li>
226
- </ul>
227
- <h4 id="x-ranges-12x-1x-12-" style="position:relative;"><a href="#x-ranges-12x-1x-12-" aria-label="x ranges 12x 1x 12 permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>X-Ranges <code class="language-text">1.2.x</code> <code class="language-text">1.X</code> <code class="language-text">1.2.*</code> <code class="language-text">*</code></h4>
228
- <p>Any of <code class="language-text">X</code>, <code class="language-text">x</code>, or <code class="language-text">*</code> may be used to "stand in" for one of the
229
- numeric values in the <code class="language-text">[major, minor, patch]</code> tuple.</p>
230
- <ul>
231
- <li><code class="language-text">*</code> := <code class="language-text">&gt;=0.0.0</code> (Any version satisfies)</li>
232
- <li><code class="language-text">1.x</code> := <code class="language-text">&gt;=1.0.0 &lt;2.0.0</code> (Matching major version)</li>
233
- <li><code class="language-text">1.2.x</code> := <code class="language-text">&gt;=1.2.0 &lt;1.3.0</code> (Matching major and minor versions)</li>
234
- </ul>
235
- <p>A partial version range is treated as an X-Range, so the special
236
- character is in fact optional.</p>
237
- <ul>
238
- <li><code class="language-text">&quot;&quot;</code> (empty string) := <code class="language-text">*</code> := <code class="language-text">&gt;=0.0.0</code></li>
239
- <li><code class="language-text">1</code> := <code class="language-text">1.x.x</code> := <code class="language-text">&gt;=1.0.0 &lt;2.0.0</code></li>
240
- <li><code class="language-text">1.2</code> := <code class="language-text">1.2.x</code> := <code class="language-text">&gt;=1.2.0 &lt;1.3.0</code></li>
241
- </ul>
242
- <h4 id="tilde-ranges-123-12-1" style="position:relative;"><a href="#tilde-ranges-123-12-1" aria-label="tilde ranges 123 12 1 permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Tilde Ranges <code class="language-text">~1.2.3</code> <code class="language-text">~1.2</code> <code class="language-text">~1</code></h4>
243
- <p>Allows patch-level changes if a minor version is specified on the
244
- comparator. Allows minor-level changes if not.</p>
245
- <ul>
246
- <li><code class="language-text">~1.2.3</code> := <code class="language-text">&gt;=1.2.3 &lt;1.(2+1).0</code> := <code class="language-text">&gt;=1.2.3 &lt;1.3.0</code></li>
247
- <li><code class="language-text">~1.2</code> := <code class="language-text">&gt;=1.2.0 &lt;1.(2+1).0</code> := <code class="language-text">&gt;=1.2.0 &lt;1.3.0</code> (Same as <code class="language-text">1.2.x</code>)</li>
248
- <li><code class="language-text">~1</code> := <code class="language-text">&gt;=1.0.0 &lt;(1+1).0.0</code> := <code class="language-text">&gt;=1.0.0 &lt;2.0.0</code> (Same as <code class="language-text">1.x</code>)</li>
249
- <li><code class="language-text">~0.2.3</code> := <code class="language-text">&gt;=0.2.3 &lt;0.(2+1).0</code> := <code class="language-text">&gt;=0.2.3 &lt;0.3.0</code></li>
250
- <li><code class="language-text">~0.2</code> := <code class="language-text">&gt;=0.2.0 &lt;0.(2+1).0</code> := <code class="language-text">&gt;=0.2.0 &lt;0.3.0</code> (Same as <code class="language-text">0.2.x</code>)</li>
251
- <li><code class="language-text">~0</code> := <code class="language-text">&gt;=0.0.0 &lt;(0+1).0.0</code> := <code class="language-text">&gt;=0.0.0 &lt;1.0.0</code> (Same as <code class="language-text">0.x</code>)</li>
252
- <li><code class="language-text">~1.2.3-beta.2</code> := <code class="language-text">&gt;=1.2.3-beta.2 &lt;1.3.0</code> Note that prereleases in
253
- the <code class="language-text">1.2.3</code> version will be allowed, if they are greater than or
254
- equal to <code class="language-text">beta.2</code>. So, <code class="language-text">1.2.3-beta.4</code> would be allowed, but
255
- <code class="language-text">1.2.4-beta.2</code> would not, because it is a prerelease of a
256
- different <code class="language-text">[major, minor, patch]</code> tuple.</li>
257
- </ul>
258
- <h4 id="caret-ranges-123-025-004" style="position:relative;"><a href="#caret-ranges-123-025-004" aria-label="caret ranges 123 025 004 permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Caret Ranges <code class="language-text">^1.2.3</code> <code class="language-text">^0.2.5</code> <code class="language-text">^0.0.4</code></h4>
259
- <p>Allows changes that do not modify the left-most non-zero digit in the
260
- <code class="language-text">[major, minor, patch]</code> tuple. In other words, this allows patch and
261
- minor updates for versions <code class="language-text">1.0.0</code> and above, patch updates for
262
- versions <code class="language-text">0.X &gt;=0.1.0</code>, and <em>no</em> updates for versions <code class="language-text">0.0.X</code>.</p>
263
- <p>Many authors treat a <code class="language-text">0.x</code> version as if the <code class="language-text">x</code> were the major
264
- "breaking-change" indicator.</p>
265
- <p>Caret ranges are ideal when an author may make breaking changes
266
- between <code class="language-text">0.2.4</code> and <code class="language-text">0.3.0</code> releases, which is a common practice.
267
- However, it presumes that there will <em>not</em> be breaking changes between
268
- <code class="language-text">0.2.4</code> and <code class="language-text">0.2.5</code>. It allows for changes that are presumed to be
269
- additive (but non-breaking), according to commonly observed practices.</p>
270
- <ul>
271
- <li><code class="language-text">^1.2.3</code> := <code class="language-text">&gt;=1.2.3 &lt;2.0.0</code></li>
272
- <li><code class="language-text">^0.2.3</code> := <code class="language-text">&gt;=0.2.3 &lt;0.3.0</code></li>
273
- <li><code class="language-text">^0.0.3</code> := <code class="language-text">&gt;=0.0.3 &lt;0.0.4</code></li>
274
- <li><code class="language-text">^1.2.3-beta.2</code> := <code class="language-text">&gt;=1.2.3-beta.2 &lt;2.0.0</code> Note that prereleases in
275
- the <code class="language-text">1.2.3</code> version will be allowed, if they are greater than or
276
- equal to <code class="language-text">beta.2</code>. So, <code class="language-text">1.2.3-beta.4</code> would be allowed, but
277
- <code class="language-text">1.2.4-beta.2</code> would not, because it is a prerelease of a
278
- different <code class="language-text">[major, minor, patch]</code> tuple.</li>
279
- <li><code class="language-text">^0.0.3-beta</code> := <code class="language-text">&gt;=0.0.3-beta &lt;0.0.4</code> Note that prereleases in the
280
- <code class="language-text">0.0.3</code> version <em>only</em> will be allowed, if they are greater than or
281
- equal to <code class="language-text">beta</code>. So, <code class="language-text">0.0.3-pr.2</code> would be allowed.</li>
282
- </ul>
283
- <p>When parsing caret ranges, a missing <code class="language-text">patch</code> value desugars to the
284
- number <code class="language-text">0</code>, but will allow flexibility within that value, even if the
285
- major and minor versions are both <code class="language-text">0</code>.</p>
286
- <ul>
287
- <li><code class="language-text">^1.2.x</code> := <code class="language-text">&gt;=1.2.0 &lt;2.0.0</code></li>
288
- <li><code class="language-text">^0.0.x</code> := <code class="language-text">&gt;=0.0.0 &lt;0.1.0</code></li>
289
- <li><code class="language-text">^0.0</code> := <code class="language-text">&gt;=0.0.0 &lt;0.1.0</code></li>
290
- </ul>
291
- <p>A missing <code class="language-text">minor</code> and <code class="language-text">patch</code> values will desugar to zero, but also
292
- allow flexibility within those values, even if the major version is
293
- zero.</p>
294
- <ul>
295
- <li><code class="language-text">^1.x</code> := <code class="language-text">&gt;=1.0.0 &lt;2.0.0</code></li>
296
- <li><code class="language-text">^0.x</code> := <code class="language-text">&gt;=0.0.0 &lt;1.0.0</code></li>
297
- </ul>
298
- <h3 id="range-grammar" style="position:relative;"><a href="#range-grammar" aria-label="range grammar permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Range Grammar</h3>
299
- <p>Putting all this together, here is a Backus-Naur grammar for ranges,
300
- for the benefit of parser authors:</p>
301
- <div class="gatsby-highlight" data-language="bnf"><pre class="language-bnf"><code class="language-bnf">range-set <span class="token operator">::=</span> range <span class="token operator">(</span> logical-or range <span class="token operator">)</span> <span class="token operator">*</span>
302
- logical-or <span class="token operator">::=</span> <span class="token operator">(</span> <span class="token string">' '</span> <span class="token operator">)</span> <span class="token operator">*</span> <span class="token string">'||'</span> <span class="token operator">(</span> <span class="token string">' '</span> <span class="token operator">)</span> <span class="token operator">*</span>
303
- range <span class="token operator">::=</span> hyphen <span class="token operator">|</span> simple <span class="token operator">(</span> <span class="token string">' '</span> simple <span class="token operator">)</span> <span class="token operator">*</span> <span class="token operator">|</span> <span class="token string">''</span>
304
- hyphen <span class="token operator">::=</span> partial <span class="token string">' - '</span> partial
305
- simple <span class="token operator">::=</span> primitive <span class="token operator">|</span> partial <span class="token operator">|</span> tilde <span class="token operator">|</span> caret
306
- primitive <span class="token operator">::=</span> <span class="token operator">(</span> <span class="token string">'&lt;'</span> <span class="token operator">|</span> <span class="token string">'>'</span> <span class="token operator">|</span> <span class="token string">'>='</span> <span class="token operator">|</span> <span class="token string">'&lt;='</span> <span class="token operator">|</span> <span class="token string">'='</span> <span class="token operator">)</span> partial
307
- partial <span class="token operator">::=</span> xr <span class="token operator">(</span> <span class="token string">'.'</span> xr <span class="token operator">(</span> <span class="token string">'.'</span> xr qualifier <span class="token operator">?</span> <span class="token operator">)</span><span class="token operator">?</span> <span class="token operator">)</span><span class="token operator">?</span>
308
- xr <span class="token operator">::=</span> <span class="token string">'x'</span> <span class="token operator">|</span> <span class="token string">'X'</span> <span class="token operator">|</span> <span class="token string">'*'</span> <span class="token operator">|</span> nr
309
- nr <span class="token operator">::=</span> <span class="token string">'0'</span> <span class="token operator">|</span> <span class="token operator">[</span><span class="token string">'1'</span>-<span class="token string">'9'</span><span class="token operator">]</span> <span class="token operator">(</span> <span class="token operator">[</span><span class="token string">'0'</span>-<span class="token string">'9'</span><span class="token operator">]</span> <span class="token operator">)</span> <span class="token operator">*</span>
310
- tilde <span class="token operator">::=</span> <span class="token string">'~'</span> partial
311
- caret <span class="token operator">::=</span> <span class="token string">'^'</span> partial
312
- qualifier <span class="token operator">::=</span> <span class="token operator">(</span> <span class="token string">'-'</span> pre <span class="token operator">)</span><span class="token operator">?</span> <span class="token operator">(</span> <span class="token string">'+'</span> build <span class="token operator">)</span><span class="token operator">?</span>
313
- pre <span class="token operator">::=</span> parts
314
- build <span class="token operator">::=</span> parts
315
- parts <span class="token operator">::=</span> part <span class="token operator">(</span> <span class="token string">'.'</span> part <span class="token operator">)</span> <span class="token operator">*</span>
316
- part <span class="token operator">::=</span> nr <span class="token operator">|</span> <span class="token operator">[</span>-0-9A-Za-z<span class="token operator">]</span><span class="token operator">+</span></code></pre></div>
317
- <h2 id="functions" style="position:relative;"><a href="#functions" aria-label="functions permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Functions</h2>
318
- <p>All methods and classes take a final <code class="language-text">options</code> object argument. All
319
- options in this object are <code class="language-text">false</code> by default. The options supported
320
- are:</p>
321
- <ul>
322
- <li><code class="language-text">loose</code> Be more forgiving about not-quite-valid semver strings.
323
- (Any resulting output will always be 100% strict compliant, of
324
- course.) For backwards compatibility reasons, if the <code class="language-text">options</code>
325
- argument is a boolean value instead of an object, it is interpreted
326
- to be the <code class="language-text">loose</code> param.</li>
327
- <li><code class="language-text">includePrerelease</code> Set to suppress the <a href="https://github.com/npm/node-semver#prerelease-tags">default
328
- behavior</a> of
329
- excluding prerelease tagged versions from ranges unless they are
330
- explicitly opted into.</li>
331
- </ul>
332
- <p>Strict-mode Comparators and Ranges will be strict about the SemVer
333
- strings that they parse.</p>
334
- <ul>
335
- <li><code class="language-text">valid(v)</code>: Return the parsed version, or null if it's not valid.</li>
336
- <li>
337
- <p><code class="language-text">inc(v, release)</code>: Return the version incremented by the release
338
- type (<code class="language-text">major</code>, <code class="language-text">premajor</code>, <code class="language-text">minor</code>, <code class="language-text">preminor</code>, <code class="language-text">patch</code>,
339
- <code class="language-text">prepatch</code>, or <code class="language-text">prerelease</code>), or null if it's not valid</p>
340
- <ul>
341
- <li><code class="language-text">premajor</code> in one call will bump the version up to the next major
342
- version and down to a prerelease of that major version.
343
- <code class="language-text">preminor</code>, and <code class="language-text">prepatch</code> work the same way.</li>
344
- <li>If called from a non-prerelease version, the <code class="language-text">prerelease</code> will work the
345
- same as <code class="language-text">prepatch</code>. It increments the patch version, then makes a
346
- prerelease. If the input version is already a prerelease it simply
347
- increments it.</li>
348
- </ul>
349
- </li>
350
- <li><code class="language-text">prerelease(v)</code>: Returns an array of prerelease components, or null
351
- if none exist. Example: <code class="language-text">prerelease(&#39;1.2.3-alpha.1&#39;) -&gt; [&#39;alpha&#39;, 1]</code></li>
352
- <li><code class="language-text">major(v)</code>: Return the major version number.</li>
353
- <li><code class="language-text">minor(v)</code>: Return the minor version number.</li>
354
- <li><code class="language-text">patch(v)</code>: Return the patch version number.</li>
355
- <li><code class="language-text">intersects(r1, r2, loose)</code>: Return true if the two supplied ranges
356
- or comparators intersect.</li>
357
- <li><code class="language-text">parse(v)</code>: Attempt to parse a string as a semantic version, returning either
358
- a <code class="language-text">SemVer</code> object or <code class="language-text">null</code>.</li>
359
- </ul>
360
- <h3 id="comparison" style="position:relative;"><a href="#comparison" aria-label="comparison permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Comparison</h3>
361
- <ul>
362
- <li><code class="language-text">gt(v1, v2)</code>: <code class="language-text">v1 &gt; v2</code></li>
363
- <li><code class="language-text">gte(v1, v2)</code>: <code class="language-text">v1 &gt;= v2</code></li>
364
- <li><code class="language-text">lt(v1, v2)</code>: <code class="language-text">v1 &lt; v2</code></li>
365
- <li><code class="language-text">lte(v1, v2)</code>: <code class="language-text">v1 &lt;= v2</code></li>
366
- <li><code class="language-text">eq(v1, v2)</code>: <code class="language-text">v1 == v2</code> This is true if they're logically equivalent,
367
- even if they're not the exact same string. You already know how to
368
- compare strings.</li>
369
- <li><code class="language-text">neq(v1, v2)</code>: <code class="language-text">v1 != v2</code> The opposite of <code class="language-text">eq</code>.</li>
370
- <li><code class="language-text">cmp(v1, comparator, v2)</code>: Pass in a comparison string, and it'll call
371
- the corresponding function above. <code class="language-text">&quot;===&quot;</code> and <code class="language-text">&quot;!==&quot;</code> do simple
372
- string comparison, but are included for completeness. Throws if an
373
- invalid comparison string is provided.</li>
374
- <li><code class="language-text">compare(v1, v2)</code>: Return <code class="language-text">0</code> if <code class="language-text">v1 == v2</code>, or <code class="language-text">1</code> if <code class="language-text">v1</code> is greater, or <code class="language-text">-1</code> if
375
- <code class="language-text">v2</code> is greater. Sorts in ascending order if passed to <code class="language-text">Array.sort()</code>.</li>
376
- <li><code class="language-text">rcompare(v1, v2)</code>: The reverse of compare. Sorts an array of versions
377
- in descending order when passed to <code class="language-text">Array.sort()</code>.</li>
378
- <li><code class="language-text">diff(v1, v2)</code>: Returns difference between two versions by the release type
379
- (<code class="language-text">major</code>, <code class="language-text">premajor</code>, <code class="language-text">minor</code>, <code class="language-text">preminor</code>, <code class="language-text">patch</code>, <code class="language-text">prepatch</code>, or <code class="language-text">prerelease</code>),
380
- or null if the versions are the same.</li>
381
- </ul>
382
- <h3 id="comparators" style="position:relative;"><a href="#comparators" aria-label="comparators permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Comparators</h3>
383
- <ul>
384
- <li><code class="language-text">intersects(comparator)</code>: Return true if the comparators intersect</li>
385
- </ul>
386
- <h3 id="ranges-1" style="position:relative;"><a href="#ranges-1" aria-label="ranges 1 permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Ranges</h3>
387
- <ul>
388
- <li><code class="language-text">validRange(range)</code>: Return the valid range or null if it's not valid</li>
389
- <li><code class="language-text">satisfies(version, range)</code>: Return true if the version satisfies the
390
- range.</li>
391
- <li><code class="language-text">maxSatisfying(versions, range)</code>: Return the highest version in the list
392
- that satisfies the range, or <code class="language-text">null</code> if none of them do.</li>
393
- <li><code class="language-text">minSatisfying(versions, range)</code>: Return the lowest version in the list
394
- that satisfies the range, or <code class="language-text">null</code> if none of them do.</li>
395
- <li><code class="language-text">minVersion(range)</code>: Return the lowest version that can possibly match
396
- the given range.</li>
397
- <li><code class="language-text">gtr(version, range)</code>: Return <code class="language-text">true</code> if version is greater than all the
398
- versions possible in the range.</li>
399
- <li><code class="language-text">ltr(version, range)</code>: Return <code class="language-text">true</code> if version is less than all the
400
- versions possible in the range.</li>
401
- <li><code class="language-text">outside(version, range, hilo)</code>: Return true if the version is outside
402
- the bounds of the range in either the high or low direction. The
403
- <code class="language-text">hilo</code> argument must be either the string <code class="language-text">&#39;&gt;&#39;</code> or <code class="language-text">&#39;&lt;&#39;</code>. (This is
404
- the function called by <code class="language-text">gtr</code> and <code class="language-text">ltr</code>.)</li>
405
- <li><code class="language-text">intersects(range)</code>: Return true if any of the ranges comparators intersect</li>
406
- </ul>
407
- <p>Note that, since ranges may be non-contiguous, a version might not be
408
- greater than a range, less than a range, <em>or</em> satisfy a range! For
409
- example, the range <code class="language-text">1.2 &lt;1.2.9 || &gt;2.0.0</code> would have a hole from <code class="language-text">1.2.9</code>
410
- until <code class="language-text">2.0.0</code>, so the version <code class="language-text">1.2.10</code> would not be greater than the
411
- range (because <code class="language-text">2.0.1</code> satisfies, which is higher), nor less than the
412
- range (since <code class="language-text">1.2.8</code> satisfies, which is lower), and it also does not
413
- satisfy the range.</p>
414
- <p>If you want to know if a version satisfies or does not satisfy a
415
- range, use the <code class="language-text">satisfies(version, range)</code> function.</p>
416
- <h3 id="coercion" style="position:relative;"><a href="#coercion" aria-label="coercion permalink" class="header-link-class before"><svg aria-hidden="true" height="20" version="1.1" viewBox="0 0 16 16" width="20"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Coercion</h3>
417
- <ul>
418
- <li><code class="language-text">coerce(version)</code>: Coerces a string to semver if possible</li>
419
- </ul>
420
- <p>This aims to provide a very forgiving translation of a non-semver string to
421
- semver. It looks for the first digit in a string, and consumes all
422
- remaining characters which satisfy at least a partial semver (e.g., <code class="language-text">1</code>,
423
- <code class="language-text">1.2</code>, <code class="language-text">1.2.3</code>) up to the max permitted length (256 characters). Longer
424
- versions are simply truncated (<code class="language-text">4.6.3.9.2-alpha2</code> becomes <code class="language-text">4.6.3</code>). All
425
- surrounding text is simply ignored (<code class="language-text">v3.4 replaces v3.3.1</code> becomes
426
- <code class="language-text">3.4.0</code>). Only text which lacks digits will fail coercion (<code class="language-text">version one</code>
427
- is not valid). The maximum length for any semver component considered for
428
- coercion is 16 characters; longer components will be ignored
429
- (<code class="language-text">10000000000000000.4.7.4</code> becomes <code class="language-text">4.7.4</code>). The maximum value for any
430
- semver component is <code class="language-text">Number.MAX_SAFE_INTEGER || (2**53 - 1)</code>; higher value
431
- components are invalid (<code class="language-text">9999999999999999.4.7.4</code> is likely invalid).</p></div><div class="FoundTypo__Container-sc-1e373sc-0 fMOzaj"><p><span role="img" aria-label="eyes-emoji">👀</span> Found a typo? <a href="https://github.com/npm/cli/">Let us know!</a></p><p>The current stable version of npm is <a href="https://github.com/npm/cli/">here</a>. To upgrade, run: <code class="language-text">npm install npm@latest -g</code></p><p>To report bugs or submit feature requests for the docs, please post <a href="https://github.com/npm/cli/issues">here</a>. Submit npm issues <a href="https://github.com/npm/cli/issues">here.</a></p></div><script>
432
- var anchors = document.querySelectorAll(".sidebar a, .documentation a")
433
- Array.prototype.slice.call(anchors).map(function(el) {
434
- if (el.href.match(/file:\/\//)) {
435
- el.href = el.href + "/index.html"
436
- }
437
- })
438
- </script></div></div></div></div></div><script id="gatsby-script-loader">/*<![CDATA[*/window.pagePath="/using-npm/semver";/*]]>*/</script><script id="gatsby-chunk-mapping">/*<![CDATA[*/window.___chunkMapping={"app":["/app-f19f1d7f30af98d21899.js"],"component---src-templates-page-js":["/component---src-templates-page-js-4e7e861bc681ee3dfaa8.js"],"component---src-pages-404-js":["/component---src-pages-404-js-6c8c4e2e908a7101a231.js"],"component---src-pages-index-js":["/component---src-pages-index-js-6b93f80c513be8d7330c.js"]};/*]]>*/</script><script src="../../component---src-templates-page-js-4e7e861bc681ee3dfaa8.js" async=""></script><script src="../../app-f19f1d7f30af98d21899.js" async=""></script><script src="../../commons-4df35f6dbd2fdc25d817.js" async=""></script><script src="../../styles-de5e304580bcba768a01.js" async=""></script><script src="../../webpack-runtime-e00205099b1bddfaee91.js" async=""></script></body></html>