diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
index 4708568325cabe..48691479c44e7c 100644
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -108,7 +108,7 @@
/benchmark/misc/startup.js @nodejs/startup
/src/node.cc @nodejs/startup
/src/node_code_cache_stub.cc @nodejs/startup
-/src/node_native_module* @nodejs/startup
+/src/node_builtins* @nodejs/startup
/src/node_snapshot* @nodejs/startup
/lib/internal/bootstrap/* @nodejs/startup
/tools/code_cache/* @nodejs/startup
diff --git a/.github/workflows/authors.yml b/.github/workflows/authors.yml
index e33089ea252cdb..ee5e814ce7671a 100644
--- a/.github/workflows/authors.yml
+++ b/.github/workflows/authors.yml
@@ -19,7 +19,7 @@ jobs:
fetch-depth: '0' # This is required to actually get all the authors
persist-credentials: false
- run: tools/update-authors.mjs # Run the AUTHORS tool
- - uses: gr2m/create-or-update-pull-request-action@6720400cad8e74d7adc64640e4e6ea6748b83d8f
+ - uses: gr2m/create-or-update-pull-request-action@dc1726cbf4dd3ce766af4ec29cfb660e0125e8ee
# Creates a PR or update the Action's existing PR, or
# no-op if the base branch is already up-to-date.
env:
diff --git a/.github/workflows/build-tarball.yml b/.github/workflows/build-tarball.yml
index 2ced884f35c539..85eb9130d530a2 100644
--- a/.github/workflows/build-tarball.yml
+++ b/.github/workflows/build-tarball.yml
@@ -28,7 +28,7 @@ concurrency:
cancel-in-progress: true
env:
- PYTHON_VERSION: '3.10'
+ PYTHON_VERSION: '3.11'
FLAKY_TESTS: keep_retrying
permissions:
diff --git a/.github/workflows/build-windows.yml b/.github/workflows/build-windows.yml
index 9b5f81a816e2d0..d503d11c096e46 100644
--- a/.github/workflows/build-windows.yml
+++ b/.github/workflows/build-windows.yml
@@ -23,7 +23,7 @@ concurrency:
cancel-in-progress: true
env:
- PYTHON_VERSION: '3.10'
+ PYTHON_VERSION: '3.11'
FLAKY_TESTS: keep_retrying
permissions:
diff --git a/.github/workflows/coverage-linux.yml b/.github/workflows/coverage-linux.yml
index db0a82c9e21d73..2ec75ca7b7286f 100644
--- a/.github/workflows/coverage-linux.yml
+++ b/.github/workflows/coverage-linux.yml
@@ -26,7 +26,7 @@ concurrency:
cancel-in-progress: true
env:
- PYTHON_VERSION: '3.10'
+ PYTHON_VERSION: '3.11'
FLAKY_TESTS: keep_retrying
permissions:
diff --git a/.github/workflows/coverage-windows.yml b/.github/workflows/coverage-windows.yml
index 78465acb17566d..daecafcc034181 100644
--- a/.github/workflows/coverage-windows.yml
+++ b/.github/workflows/coverage-windows.yml
@@ -28,7 +28,7 @@ concurrency:
cancel-in-progress: true
env:
- PYTHON_VERSION: '3.10'
+ PYTHON_VERSION: '3.11'
FLAKY_TESTS: keep_retrying
permissions:
diff --git a/.github/workflows/find-inactive-collaborators.yml b/.github/workflows/find-inactive-collaborators.yml
index ce47c0a1ddedb2..8fa954fd0f8128 100644
--- a/.github/workflows/find-inactive-collaborators.yml
+++ b/.github/workflows/find-inactive-collaborators.yml
@@ -33,7 +33,7 @@ jobs:
run: tools/find-inactive-collaborators.mjs
- name: Open pull request
- uses: gr2m/create-or-update-pull-request-action@6720400cad8e74d7adc64640e4e6ea6748b83d8f
+ uses: gr2m/create-or-update-pull-request-action@dc1726cbf4dd3ce766af4ec29cfb660e0125e8ee
# Creates a PR or update the Action's existing PR, or
# no-op if the base branch is already up-to-date.
env:
diff --git a/.github/workflows/find-inactive-tsc.yml b/.github/workflows/find-inactive-tsc.yml
index 2f6afec42277bb..b4af0876fbdb97 100644
--- a/.github/workflows/find-inactive-tsc.yml
+++ b/.github/workflows/find-inactive-tsc.yml
@@ -42,7 +42,7 @@ jobs:
run: tools/find-inactive-tsc.mjs >> $GITHUB_ENV
- name: Open pull request
- uses: gr2m/create-or-update-pull-request-action@6720400cad8e74d7adc64640e4e6ea6748b83d8f
+ uses: gr2m/create-or-update-pull-request-action@dc1726cbf4dd3ce766af4ec29cfb660e0125e8ee
# Creates a PR or update the Action's existing PR, or
# no-op if the base branch is already up-to-date.
env:
diff --git a/.github/workflows/license-builder.yml b/.github/workflows/license-builder.yml
index 3c966da1d5b4f0..a58e0bf8bbbe0a 100644
--- a/.github/workflows/license-builder.yml
+++ b/.github/workflows/license-builder.yml
@@ -21,7 +21,7 @@ jobs:
with:
persist-credentials: false
- run: ./tools/license-builder.sh # Run the license builder tool
- - uses: gr2m/create-or-update-pull-request-action@6720400cad8e74d7adc64640e4e6ea6748b83d8f
+ - uses: gr2m/create-or-update-pull-request-action@dc1726cbf4dd3ce766af4ec29cfb660e0125e8ee
# Creates a PR or update the Action's existing PR, or
# no-op if the base branch is already up-to-date.
env:
diff --git a/.github/workflows/linters.yml b/.github/workflows/linters.yml
index 1b5c9e8f9ba421..65895c786adf9f 100644
--- a/.github/workflows/linters.yml
+++ b/.github/workflows/linters.yml
@@ -14,7 +14,7 @@ concurrency:
cancel-in-progress: true
env:
- PYTHON_VERSION: '3.10'
+ PYTHON_VERSION: '3.11'
NODE_VERSION: lts/*
permissions:
diff --git a/.github/workflows/test-asan.yml b/.github/workflows/test-asan.yml
index c8e7a09e2e4efd..53dacd80675aff 100644
--- a/.github/workflows/test-asan.yml
+++ b/.github/workflows/test-asan.yml
@@ -30,7 +30,7 @@ concurrency:
env:
ASAN_OPTIONS: intercept_tls_get_addr=0
- PYTHON_VERSION: '3.10'
+ PYTHON_VERSION: '3.11'
FLAKY_TESTS: keep_retrying
permissions:
@@ -39,7 +39,7 @@ permissions:
jobs:
test-asan:
if: github.event.pull_request.draft == false
- runs-on: ubuntu-latest
+ runs-on: ubuntu-20.04
env:
CC: clang
CXX: clang++
diff --git a/.github/workflows/test-internet.yml b/.github/workflows/test-internet.yml
index 1e968652896f1e..ced20cf0814de6 100644
--- a/.github/workflows/test-internet.yml
+++ b/.github/workflows/test-internet.yml
@@ -21,7 +21,7 @@ concurrency:
cancel-in-progress: true
env:
- PYTHON_VERSION: '3.10'
+ PYTHON_VERSION: '3.11'
FLAKY_TESTS: keep_retrying
permissions:
diff --git a/.github/workflows/test-linux.yml b/.github/workflows/test-linux.yml
index 24196849d1bac8..81c0d709005c28 100644
--- a/.github/workflows/test-linux.yml
+++ b/.github/workflows/test-linux.yml
@@ -23,7 +23,7 @@ concurrency:
cancel-in-progress: true
env:
- PYTHON_VERSION: '3.10'
+ PYTHON_VERSION: '3.11'
FLAKY_TESTS: keep_retrying
permissions:
diff --git a/.github/workflows/test-macos.yml b/.github/workflows/test-macos.yml
index 7faddc8eaedaec..c5be401871e353 100644
--- a/.github/workflows/test-macos.yml
+++ b/.github/workflows/test-macos.yml
@@ -29,7 +29,7 @@ concurrency:
cancel-in-progress: true
env:
- PYTHON_VERSION: '3.10'
+ PYTHON_VERSION: '3.11'
FLAKY_TESTS: keep_retrying
permissions:
diff --git a/.github/workflows/timezone-update.yml b/.github/workflows/timezone-update.yml
index d7c9305325f82b..27cbfd2946a1d2 100644
--- a/.github/workflows/timezone-update.yml
+++ b/.github/workflows/timezone-update.yml
@@ -31,10 +31,16 @@ jobs:
persist-credentials: false
repository: unicode-org/icu-data
+ - name: Record new version
+ run: echo "new_version=$(ls icu-data/tzdata/icunew | tail -1)" >> $GITHUB_ENV
+
- run: ./tools/update-timezone.mjs
+ - name: Update the expected timezone version in test
+ run: echo "${{ env.new_version }}" > test/fixtures/tz-version.txt
+
- name: Open Pull Request
- uses: gr2m/create-or-update-pull-request-action@6720400cad8e74d7adc64640e4e6ea6748b83d8f # Create a PR or update the Action's existing PR
+ uses: gr2m/create-or-update-pull-request-action@dc1726cbf4dd3ce766af4ec29cfb660e0125e8ee # Create a PR or update the Action's existing PR
env:
GITHUB_TOKEN: ${{ secrets.GH_USER_TOKEN }}
with:
@@ -49,7 +55,7 @@ jobs:
console.log(process.versions.tz)
```
branch: actions/timezone-update
- commit-message: 'deps: update timezone'
+ commit-message: 'deps: update timezone to ${{ env.new_version }}'
labels: dependencies
- title: 'deps: update timezone'
+ title: 'deps: update timezone to ${{ env.new_version }}'
reviewers: \@nodejs/i18n-api
diff --git a/.github/workflows/tools.yml b/.github/workflows/tools.yml
index e58f59ef78a301..ee3c2bd1c0b622 100644
--- a/.github/workflows/tools.yml
+++ b/.github/workflows/tools.yml
@@ -65,7 +65,7 @@ jobs:
with:
persist-credentials: false
- run: ${{ matrix.run }}
- - uses: gr2m/create-or-update-pull-request-action@6720400cad8e74d7adc64640e4e6ea6748b83d8f
+ - uses: gr2m/create-or-update-pull-request-action@dc1726cbf4dd3ce766af4ec29cfb660e0125e8ee
# Creates a PR or update the Action's existing PR, or
# no-op if the base branch is already up-to-date.
env:
diff --git a/BUILDING.md b/BUILDING.md
index d41b55024e897d..8ddd996e9fcfb0 100644
--- a/BUILDING.md
+++ b/BUILDING.md
@@ -237,7 +237,7 @@ The Node.js project supports Python >= 3 for building and testing.
* `gcc` and `g++` >= 8.3 or newer
* GNU Make 3.81 or newer
-* Python 3.6, 3.7, 3.8, 3.9, or 3.10 (see note above)
+* Python >=3.6 <=3.11 (see note above)
* For test coverage, your Python installation must include pip.
Installation via Linux package manager can be achieved with:
@@ -253,7 +253,7 @@ FreeBSD and OpenBSD users may also need to install `libexecinfo`.
#### macOS prerequisites
* Xcode Command Line Tools >= 11 for macOS
-* Python 3.6, 3.7, 3.8, 3.9, or 3.10 (see note above)
+* Python >=3.6 <=3.11 (see note above)
* For test coverage, your Python installation must include pip.
macOS users can install the `Xcode Command Line Tools` by running
@@ -577,7 +577,7 @@ to run it again before invoking `make -j4`.
##### Option 1: Manual install
-* [Python 3.10](https://www.microsoft.com/en-us/p/python-310/9pjpw5ldxlz5)
+* [Python 3.11](https://apps.microsoft.com/store/detail/python-311/9NRWMJP3717K)
* The "Desktop development with C++" workload from
[Visual Studio 2019](https://visualstudio.microsoft.com/vs/older-downloads/#visual-studio-2019-and-other-products) or
the "C++ build tools" workload from the
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e20fc7fcb391a8..8ae0355bf8120c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -32,7 +32,8 @@ release.
-16.18.1
+16.19.0
+16.18.1
16.18.0
16.17.1
16.17.0
diff --git a/LICENSE b/LICENSE
index 0c2b522e27313f..3b52080cb6b9ac 100644
--- a/LICENSE
+++ b/LICENSE
@@ -763,56 +763,129 @@ The externally maintained libraries used by Node.js are:
- OpenSSL, located at deps/openssl, is licensed as follows:
"""
- Copyright (c) 1998-2019 The OpenSSL Project. All rights reserved.
-
- Redistribution and use in source and binary forms, with or without
- modification, are permitted provided that the following conditions
- are met:
-
- 1. Redistributions of source code must retain the above copyright
- notice, this list of conditions and the following disclaimer.
-
- 2. Redistributions in binary form must reproduce the above copyright
- notice, this list of conditions and the following disclaimer in
- the documentation and/or other materials provided with the
- distribution.
-
- 3. All advertising materials mentioning features or use of this
- software must display the following acknowledgment:
- "This product includes software developed by the OpenSSL Project
- for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
-
- 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
- endorse or promote products derived from this software without
- prior written permission. For written permission, please contact
- openssl-core@openssl.org.
-
- 5. Products derived from this software may not be called "OpenSSL"
- nor may "OpenSSL" appear in their names without prior written
- permission of the OpenSSL Project.
-
- 6. Redistributions of any form whatsoever must retain the following
- acknowledgment:
- "This product includes software developed by the OpenSSL Project
- for use in the OpenSSL Toolkit (http://www.openssl.org/)"
-
- THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
- EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
- PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
- ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
- NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
- LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
- STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
- ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
- OF THE POSSIBILITY OF SUCH DAMAGE.
- ====================================================================
-
- This product includes cryptographic software written by Eric Young
- (eay@cryptsoft.com). This product includes software written by Tim
- Hudson (tjh@cryptsoft.com).
+ LICENSE ISSUES
+ ==============
+
+ The OpenSSL toolkit stays under a double license, i.e. both the conditions of
+ the OpenSSL License and the original SSLeay license apply to the toolkit.
+ See below for the actual license texts.
+
+ OpenSSL License
+ ---------------
+
+ /* ====================================================================
+ * Copyright (c) 1998-2019 The OpenSSL Project. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * 3. All advertising materials mentioning features or use of this
+ * software must display the following acknowledgment:
+ * "This product includes software developed by the OpenSSL Project
+ * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
+ *
+ * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
+ * endorse or promote products derived from this software without
+ * prior written permission. For written permission, please contact
+ * openssl-core@openssl.org.
+ *
+ * 5. Products derived from this software may not be called "OpenSSL"
+ * nor may "OpenSSL" appear in their names without prior written
+ * permission of the OpenSSL Project.
+ *
+ * 6. Redistributions of any form whatsoever must retain the following
+ * acknowledgment:
+ * "This product includes software developed by the OpenSSL Project
+ * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
+ * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
+ * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ * OF THE POSSIBILITY OF SUCH DAMAGE.
+ * ====================================================================
+ *
+ * This product includes cryptographic software written by Eric Young
+ * (eay@cryptsoft.com). This product includes software written by Tim
+ * Hudson (tjh@cryptsoft.com).
+ *
+ */
+
+ Original SSLeay License
+ -----------------------
+
+ /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
+ * All rights reserved.
+ *
+ * This package is an SSL implementation written
+ * by Eric Young (eay@cryptsoft.com).
+ * The implementation was written so as to conform with Netscapes SSL.
+ *
+ * This library is free for commercial and non-commercial use as long as
+ * the following conditions are aheared to. The following conditions
+ * apply to all code found in this distribution, be it the RC4, RSA,
+ * lhash, DES, etc., code; not just the SSL code. The SSL documentation
+ * included with this distribution is covered by the same copyright terms
+ * except that the holder is Tim Hudson (tjh@cryptsoft.com).
+ *
+ * Copyright remains Eric Young's, and as such any Copyright notices in
+ * the code are not to be removed.
+ * If this package is used in a product, Eric Young should be given attribution
+ * as the author of the parts of the library used.
+ * This can be in the form of a textual message at program startup or
+ * in documentation (online or textual) provided with the package.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ * 3. All advertising materials mentioning features or use of this software
+ * must display the following acknowledgement:
+ * "This product includes cryptographic software written by
+ * Eric Young (eay@cryptsoft.com)"
+ * The word 'cryptographic' can be left out if the rouines from the library
+ * being used are not cryptographic related :-).
+ * 4. If you include any Windows specific code (or a derivative thereof) from
+ * the apps directory (application code) you must include an acknowledgement:
+ * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
+ *
+ * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ *
+ * The licence and distribution terms for any publically available version or
+ * derivative of this code cannot be changed. i.e. this code cannot simply be
+ * copied and put under another distribution licence
+ * [including the GNU Public Licence.]
+ */
"""
- Punycode.js, located at lib/punycode.js, is licensed as follows:
@@ -1340,7 +1413,7 @@ The externally maintained libraries used by Node.js are:
- ESLint, located at tools/node_modules/eslint, is licensed as follows:
"""
- Copyright JS Foundation and other contributors, https://js.foundation
+ Copyright OpenJS Foundation and other contributors,
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
diff --git a/common.gypi b/common.gypi
index d68a4c9eafacfa..cbf9c3810d7400 100644
--- a/common.gypi
+++ b/common.gypi
@@ -29,6 +29,7 @@
'error_on_warn%': 'false',
'openssl_fips%': '',
+ 'openssl_product': '<(STATIC_LIB_PREFIX)openssl<(STATIC_LIB_SUFFIX)',
'openssl_no_asm%': 0,
# Don't use ICU data file (icudtl.dat) from V8, we use our own.
@@ -36,7 +37,7 @@
# Reset this number to 0 on major V8 upgrades.
# Increment by one for each non-official patch applied to deps/v8.
- 'v8_embedder_string': '-node.22',
+ 'v8_embedder_string': '-node.24',
##### V8 defaults for Node.js #####
@@ -101,11 +102,6 @@
'obj_dir%': '<(PRODUCT_DIR)/obj.target',
'v8_base': '<(PRODUCT_DIR)/obj.target/tools/v8_gypfiles/libv8_snapshot.a',
}],
- ['openssl_fips != ""', {
- 'openssl_product': '<(STATIC_LIB_PREFIX)openssl<(STATIC_LIB_SUFFIX)',
- }, {
- 'openssl_product': '<(STATIC_LIB_PREFIX)openssl<(STATIC_LIB_SUFFIX)',
- }],
['OS=="mac"', {
'clang%': 1,
'obj_dir%': '<(PRODUCT_DIR)/obj.target',
diff --git a/configure b/configure
index 6ef2da2e631e6e..fefb313c9cd13c 100755
--- a/configure
+++ b/configure
@@ -4,6 +4,7 @@
# Note that the mix of single and double quotes is intentional,
# as is the fact that the ] goes on a new line.
_=[ 'exec' '/bin/sh' '-c' '''
+command -v python3.11 >/dev/null && exec python3.11 "$0" "$@"
command -v python3.10 >/dev/null && exec python3.10 "$0" "$@"
command -v python3.9 >/dev/null && exec python3.9 "$0" "$@"
command -v python3.8 >/dev/null && exec python3.8 "$0" "$@"
@@ -22,7 +23,7 @@ except ImportError:
from distutils.spawn import find_executable as which
print('Node.js configure: Found Python {}.{}.{}...'.format(*sys.version_info))
-acceptable_pythons = ((3, 10), (3, 9), (3, 8), (3, 7), (3, 6))
+acceptable_pythons = ((3, 11), (3, 10), (3, 9), (3, 8), (3, 7), (3, 6))
if sys.version_info[:2] in acceptable_pythons:
import configure
else:
diff --git a/deps/corepack/CHANGELOG.md b/deps/corepack/CHANGELOG.md
index 8bfc7c0f5142d6..b66e53f806d035 100644
--- a/deps/corepack/CHANGELOG.md
+++ b/deps/corepack/CHANGELOG.md
@@ -1,5 +1,33 @@
# Changelog
+## [0.15.1](https://github.com/nodejs/corepack/compare/v0.15.0...v0.15.1) (2022-11-04)
+
+
+### Features
+
+* update package manager versions ([#205](https://github.com/nodejs/corepack/issues/205)) ([5bfac11](https://github.com/nodejs/corepack/commit/5bfac11715474a4318c67fc806fd1ff4252c683a))
+
+## [0.15.0](https://github.com/nodejs/corepack/compare/v0.14.2...v0.15.0) (2022-10-28)
+
+
+### Features
+
+* add support for configurable registries and applicable auth options ([#186](https://github.com/nodejs/corepack/issues/186)) ([662ae90](https://github.com/nodejs/corepack/commit/662ae9057c7360cb05e9476914e611a9bf0074db))
+* update package manager versions ([#193](https://github.com/nodejs/corepack/issues/193)) ([0ec3a73](https://github.com/nodejs/corepack/commit/0ec3a7384729c5cf4ac566d91f1a4bb74e08a64f))
+* when strict checking is off, treat like transparent ([#197](https://github.com/nodejs/corepack/issues/197)) ([5eadc50](https://github.com/nodejs/corepack/commit/5eadc50192e205c60bfb1cad91854e9014a747b8))
+
+
+### Bug Fixes
+
+* **doc:** add package configuration instruction to readme ([#188](https://github.com/nodejs/corepack/issues/188)) ([0b7abb9](https://github.com/nodejs/corepack/commit/0b7abb9833d332bad97902260d31652482c274a0))
+* recreate cache folder if necessary ([#200](https://github.com/nodejs/corepack/issues/200)) ([7b5f2f9](https://github.com/nodejs/corepack/commit/7b5f2f9fcb24fe3fe517a96deaac7f32854f3124))
+
+## [0.14.2](https://github.com/nodejs/corepack/compare/v0.14.1...v0.14.2) (2022-09-24)
+
+### Features
+
+* update package manager versions ([#184](https://github.com/nodejs/corepack/issues/184)) ([84ae313](https://github.com/nodejs/corepack/commit/84ae3139e4b9a86d97465e36b50beb9201fda732))
+
## [0.14.1](https://github.com/nodejs/corepack/compare/v0.14.0...v0.14.1) (2022-09-16)
diff --git a/deps/corepack/README.md b/deps/corepack/README.md
index 8ba03a760f2906..8d76baea4bbf8d 100644
--- a/deps/corepack/README.md
+++ b/deps/corepack/README.md
@@ -36,6 +36,8 @@ We do acknowledge the irony and overhead of using npm to install Corepack, which
## Usage
+### When Building Packages
+
Just use your package managers as you usually would. Run `yarn install` in Yarn projects, `pnpm install` in pnpm projects, and `npm` in npm projects. Corepack will catch these calls, and depending on the situation:
- **If the local project is configured for the package manager you're using**, Corepack will silently download and cache the latest compatible version.
@@ -44,6 +46,18 @@ Just use your package managers as you usually would. Run `yarn install` in Yarn
- **If the local project isn't configured for any package manager**, Corepack will assume that you know what you're doing, and will use whatever package manager version has been pinned as "known good release". Check the relevant section for more details.
+### When Authoring Packages
+
+Set your package's manager with the `packageManager` field in `package.json`:
+
+```json
+{
+ "packageManager": "yarn@3.2.3+sha224.953c8233f7a92884eee2de69a1b92d1f2ec1655e66d08071ba9a02fa"
+}
+```
+
+Here, `yarn` is the name of the package manager, specified at version `3.2.3`, along with the SHA-224 hash of this version for validation. `packageManager@x.y.z` is required. The hash is optional but strongly recommended as a security practice. Permitted values for the package manager are `yarn`, `npm`, and `pnpm`.
+
## Known Good Releases
When running Corepack within projects that don't list a supported package
@@ -120,8 +134,17 @@ This command will retrieve the given package manager from the specified archive
manager versions that will be required for the projects you'll run, using
`corepack hydrate`).
-- `COREPACK_ENABLE_STRICT` can be set to `0` to prevent Corepack from checking
+- `COREPACK_ENABLE_STRICT` can be set to `0` to prevent Corepack from throwing error
+ if the package manager does not correspond to the one defined for the current project.
+ This means that if a user is using the package manager specified in the current project,
+ it will use the version specified by the project's `packageManager` field.
+ But if the user is using other package manager different from the one specified
+ for the current project, it will use the system-wide package manager version.
+
+- `COREPACK_ENABLE_PROJECT_SPEC` can be set to `0` to prevent Corepack from checking
if the package manager corresponds to the one defined for the current project.
+ This means that it will always use the system-wide package manager regardless of
+ what is being specified in the project's `packageManager` field.
- `COREPACK_HOME` can be set in order to define where Corepack should install
the package managers. By default it is set to `%LOCALAPPDATA%\node\corepack`
@@ -129,29 +152,22 @@ This command will retrieve the given package manager from the specified archive
- `COREPACK_ROOT` has no functional impact on Corepack itself; it's automatically being set in your environment by Corepack when it shells out to the underlying package managers, so that they can feature-detect its presence (useful for commands like `yarn init`).
-- `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` are supported through [`node-proxy-agent`](https://github.com/TooTallNate/node-proxy-agent).
+- `COREPACK_NPM_REGISTRY` sets the registry base url used when retrieving package managers from npm. Default value is `https://registry.npmjs.org`
-## Contributing
+- `COREPACK_NPM_TOKEN` sets a Bearer token authorization header when connecting to a npm type registry.
-If you want to build corepack yourself, you can build the project like this:
+- `COREPACK_NPM_USERNAME` and `COREPACK_NPM_PASSWORD` to set a Basic authorization header when connecting to a npm type registry. Note that both environment variables are required and as plain text. If you want to send an empty password, explicitly set `COREPACK_NPM_PASSWORD` to an empty string.
-1. Clone this repository
-2. Run `yarn build` (no need for `yarn install`)
-3. The `dist/` directory now contains the corepack build and the shims
-4. Call `node ./dist/corepack --help` and behold
+- `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` are supported through [`node-proxy-agent`](https://github.com/TooTallNate/node-proxy-agent).
+
+## Contributing
-You can also run the tests with `yarn jest` (still no install needed).
+See [`CONTRIBUTING.md`](./CONTRIBUTING.md).
## Design
-Various tidbits about Corepack's design are explained in more details in [DESIGN.md](/DESIGN.md).
+See [`DESIGN.md`](/DESIGN.md).
## License (MIT)
-> **Copyright © Corepack contributors**
->
-> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
->
-> The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
->
-> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+See [`LICENSE.md`](./LICENSE.md).
diff --git a/deps/corepack/dist/corepack.js b/deps/corepack/dist/corepack.js
index 923b26744f498c..122b79d491c37f 100755
--- a/deps/corepack/dist/corepack.js
+++ b/deps/corepack/dist/corepack.js
@@ -15471,7 +15471,7 @@ EnableCommand.usage = clipanion__WEBPACK_IMPORTED_MODULE_6__.Command.Usage({
By default it will locate the install directory by running the equivalent of \`which corepack\`, but this can be tweaked by explicitly passing the install directory via the \`--install-directory\` flag.
`,
examples: [[
- `Enable all shims, putting them next to the \`corepath\` binary`,
+ `Enable all shims, putting them next to the \`corepack\` binary`,
`$0 enable`,
], [
`Enable all shims, putting them in the specified directory`,
@@ -15496,26 +15496,29 @@ __webpack_require__.r(__webpack_exports__);
/* harmony export */ __webpack_require__.d(__webpack_exports__, {
/* harmony export */ "HydrateCommand": () => (/* binding */ HydrateCommand)
/* harmony export */ });
-/* harmony import */ var clipanion__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! clipanion */ "./.yarn/__virtual__/clipanion-virtual-72ec1bc418/4/.yarn/berry/cache/clipanion-npm-3.1.0-ced87dbbea-9.zip/node_modules/clipanion/lib/advanced/index.js");
-/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! path */ "path");
-/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(path__WEBPACK_IMPORTED_MODULE_0__);
-/* harmony import */ var _folderUtils__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../folderUtils */ "./sources/folderUtils.ts");
-/* harmony import */ var _types__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../types */ "./sources/types.ts");
+/* harmony import */ var clipanion__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! clipanion */ "./.yarn/__virtual__/clipanion-virtual-72ec1bc418/4/.yarn/berry/cache/clipanion-npm-3.1.0-ced87dbbea-9.zip/node_modules/clipanion/lib/advanced/index.js");
+/* harmony import */ var fs_promises__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! fs/promises */ "fs/promises");
+/* harmony import */ var fs_promises__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(fs_promises__WEBPACK_IMPORTED_MODULE_0__);
+/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! path */ "path");
+/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__webpack_require__.n(path__WEBPACK_IMPORTED_MODULE_1__);
+/* harmony import */ var _folderUtils__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../folderUtils */ "./sources/folderUtils.ts");
+/* harmony import */ var _types__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ../types */ "./sources/types.ts");
-class HydrateCommand extends clipanion__WEBPACK_IMPORTED_MODULE_3__.Command {
+
+class HydrateCommand extends clipanion__WEBPACK_IMPORTED_MODULE_4__.Command {
constructor() {
super(...arguments);
- this.activate = clipanion__WEBPACK_IMPORTED_MODULE_3__.Option.Boolean(`--activate`, false, {
+ this.activate = clipanion__WEBPACK_IMPORTED_MODULE_4__.Option.Boolean(`--activate`, false, {
description: `If true, this release will become the default one for this package manager`,
});
- this.fileName = clipanion__WEBPACK_IMPORTED_MODULE_3__.Option.String();
+ this.fileName = clipanion__WEBPACK_IMPORTED_MODULE_4__.Option.String();
}
async execute() {
- const installFolder = _folderUtils__WEBPACK_IMPORTED_MODULE_1__.getInstallFolder();
- const fileName = path__WEBPACK_IMPORTED_MODULE_0___default().resolve(this.context.cwd, this.fileName);
+ const installFolder = _folderUtils__WEBPACK_IMPORTED_MODULE_2__.getInstallFolder();
+ const fileName = path__WEBPACK_IMPORTED_MODULE_1___default().resolve(this.context.cwd, this.fileName);
const archiveEntries = new Map();
let hasShortEntries = false;
const { default: tar } = await Promise.resolve(/*! import() eager */).then(__webpack_require__.t.bind(__webpack_require__, /*! tar */ "../../../.yarn/berry/cache/tar-npm-6.1.11-e6ac3cba9c-9.zip/node_modules/tar/index.js", 19));
@@ -15532,15 +15535,17 @@ class HydrateCommand extends clipanion__WEBPACK_IMPORTED_MODULE_3__.Command {
}
} });
if (hasShortEntries || archiveEntries.size < 1)
- throw new clipanion__WEBPACK_IMPORTED_MODULE_3__.UsageError(`Invalid archive format; did it get generated by 'corepack prepare'?`);
+ throw new clipanion__WEBPACK_IMPORTED_MODULE_4__.UsageError(`Invalid archive format; did it get generated by 'corepack prepare'?`);
for (const [name, references] of archiveEntries) {
for (const reference of references) {
- if (!(0,_types__WEBPACK_IMPORTED_MODULE_2__.isSupportedPackageManager)(name))
- throw new clipanion__WEBPACK_IMPORTED_MODULE_3__.UsageError(`Unsupported package manager '${name}'`);
+ if (!(0,_types__WEBPACK_IMPORTED_MODULE_3__.isSupportedPackageManager)(name))
+ throw new clipanion__WEBPACK_IMPORTED_MODULE_4__.UsageError(`Unsupported package manager '${name}'`);
if (this.activate)
this.context.stdout.write(`Hydrating ${name}@${reference} for immediate activation...\n`);
else
this.context.stdout.write(`Hydrating ${name}@${reference}...\n`);
+ // Recreate the folder in case it was deleted somewhere else:
+ await (0,fs_promises__WEBPACK_IMPORTED_MODULE_0__.mkdir)(installFolder, { recursive: true });
await tar.x({ file: fileName, cwd: installFolder }, [`${name}/${reference}`]);
if (this.activate) {
await this.context.engine.activatePackageManager({ name, reference });
@@ -15553,7 +15558,7 @@ class HydrateCommand extends clipanion__WEBPACK_IMPORTED_MODULE_3__.Command {
HydrateCommand.paths = [
[`hydrate`],
];
-HydrateCommand.usage = clipanion__WEBPACK_IMPORTED_MODULE_3__.Command.Usage({
+HydrateCommand.usage = clipanion__WEBPACK_IMPORTED_MODULE_4__.Command.Usage({
description: `Import a package manager into the cache`,
details: `
This command unpacks a package manager archive into the cache. The archive must have been generated by the \`corepack prepare\` command - no other will work.
@@ -15578,47 +15583,50 @@ __webpack_require__.r(__webpack_exports__);
/* harmony export */ __webpack_require__.d(__webpack_exports__, {
/* harmony export */ "PrepareCommand": () => (/* binding */ PrepareCommand)
/* harmony export */ });
-/* harmony import */ var clipanion__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! clipanion */ "./.yarn/__virtual__/clipanion-virtual-72ec1bc418/4/.yarn/berry/cache/clipanion-npm-3.1.0-ced87dbbea-9.zip/node_modules/clipanion/lib/advanced/index.js");
-/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! path */ "path");
-/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(path__WEBPACK_IMPORTED_MODULE_0__);
-/* harmony import */ var _folderUtils__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../folderUtils */ "./sources/folderUtils.ts");
-/* harmony import */ var _specUtils__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../specUtils */ "./sources/specUtils.ts");
+/* harmony import */ var clipanion__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! clipanion */ "./.yarn/__virtual__/clipanion-virtual-72ec1bc418/4/.yarn/berry/cache/clipanion-npm-3.1.0-ced87dbbea-9.zip/node_modules/clipanion/lib/advanced/index.js");
+/* harmony import */ var fs_promises__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! fs/promises */ "fs/promises");
+/* harmony import */ var fs_promises__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(fs_promises__WEBPACK_IMPORTED_MODULE_0__);
+/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! path */ "path");
+/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__webpack_require__.n(path__WEBPACK_IMPORTED_MODULE_1__);
+/* harmony import */ var _folderUtils__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../folderUtils */ "./sources/folderUtils.ts");
+/* harmony import */ var _specUtils__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ../specUtils */ "./sources/specUtils.ts");
+
-class PrepareCommand extends clipanion__WEBPACK_IMPORTED_MODULE_3__.Command {
+class PrepareCommand extends clipanion__WEBPACK_IMPORTED_MODULE_4__.Command {
constructor() {
super(...arguments);
- this.activate = clipanion__WEBPACK_IMPORTED_MODULE_3__.Option.Boolean(`--activate`, false, {
+ this.activate = clipanion__WEBPACK_IMPORTED_MODULE_4__.Option.Boolean(`--activate`, false, {
description: `If true, this release will become the default one for this package manager`,
});
- this.all = clipanion__WEBPACK_IMPORTED_MODULE_3__.Option.Boolean(`--all`, false, {
+ this.all = clipanion__WEBPACK_IMPORTED_MODULE_4__.Option.Boolean(`--all`, false, {
description: `If true, all available default package managers will be installed`,
});
- this.json = clipanion__WEBPACK_IMPORTED_MODULE_3__.Option.Boolean(`--json`, false, {
+ this.json = clipanion__WEBPACK_IMPORTED_MODULE_4__.Option.Boolean(`--json`, false, {
description: `If true, the output will be the path of the generated tarball`,
});
- this.output = clipanion__WEBPACK_IMPORTED_MODULE_3__.Option.String(`-o,--output`, {
+ this.output = clipanion__WEBPACK_IMPORTED_MODULE_4__.Option.String(`-o,--output`, {
description: `If true, the installed package managers will also be stored in a tarball`,
tolerateBoolean: true,
});
- this.specs = clipanion__WEBPACK_IMPORTED_MODULE_3__.Option.Rest();
+ this.specs = clipanion__WEBPACK_IMPORTED_MODULE_4__.Option.Rest();
}
async execute() {
if (this.all && this.specs.length > 0)
- throw new clipanion__WEBPACK_IMPORTED_MODULE_3__.UsageError(`The --all option cannot be used along with an explicit package manager specification`);
+ throw new clipanion__WEBPACK_IMPORTED_MODULE_4__.UsageError(`The --all option cannot be used along with an explicit package manager specification`);
const specs = this.all
? await this.context.engine.getDefaultDescriptors()
: this.specs;
const installLocations = [];
if (specs.length === 0) {
- const lookup = await _specUtils__WEBPACK_IMPORTED_MODULE_2__.loadSpec(this.context.cwd);
+ const lookup = await _specUtils__WEBPACK_IMPORTED_MODULE_3__.loadSpec(this.context.cwd);
switch (lookup.type) {
case `NoProject`:
- throw new clipanion__WEBPACK_IMPORTED_MODULE_3__.UsageError(`Couldn't find a project in the local directory - please explicit the package manager to pack, or run this command from a valid project`);
+ throw new clipanion__WEBPACK_IMPORTED_MODULE_4__.UsageError(`Couldn't find a project in the local directory - please explicit the package manager to pack, or run this command from a valid project`);
case `NoSpec`:
- throw new clipanion__WEBPACK_IMPORTED_MODULE_3__.UsageError(`The local project doesn't feature a 'packageManager' field - please explicit the package manager to pack, or update the manifest to reference it`);
+ throw new clipanion__WEBPACK_IMPORTED_MODULE_4__.UsageError(`The local project doesn't feature a 'packageManager' field - please explicit the package manager to pack, or update the manifest to reference it`);
default: {
specs.push(lookup.spec);
}
@@ -15626,11 +15634,11 @@ class PrepareCommand extends clipanion__WEBPACK_IMPORTED_MODULE_3__.Command {
}
for (const request of specs) {
const spec = typeof request === `string`
- ? _specUtils__WEBPACK_IMPORTED_MODULE_2__.parseSpec(request, `CLI arguments`, { enforceExactVersion: false })
+ ? _specUtils__WEBPACK_IMPORTED_MODULE_3__.parseSpec(request, `CLI arguments`, { enforceExactVersion: false })
: request;
const resolved = await this.context.engine.resolveDescriptor(spec, { allowTags: true });
if (resolved === null)
- throw new clipanion__WEBPACK_IMPORTED_MODULE_3__.UsageError(`Failed to successfully resolve '${spec.range}' to a valid ${spec.name} release`);
+ throw new clipanion__WEBPACK_IMPORTED_MODULE_4__.UsageError(`Failed to successfully resolve '${spec.range}' to a valid ${spec.name} release`);
if (!this.json) {
if (this.activate) {
this.context.stdout.write(`Preparing ${spec.name}@${spec.range} for immediate activation...\n`);
@@ -15649,13 +15657,15 @@ class PrepareCommand extends clipanion__WEBPACK_IMPORTED_MODULE_3__.Command {
const outputName = typeof this.output === `string`
? this.output
: `corepack.tgz`;
- const baseInstallFolder = _folderUtils__WEBPACK_IMPORTED_MODULE_1__.getInstallFolder();
- const outputPath = path__WEBPACK_IMPORTED_MODULE_0___default().resolve(this.context.cwd, outputName);
+ const baseInstallFolder = _folderUtils__WEBPACK_IMPORTED_MODULE_2__.getInstallFolder();
+ const outputPath = path__WEBPACK_IMPORTED_MODULE_1___default().resolve(this.context.cwd, outputName);
if (!this.json)
- this.context.stdout.write(`Packing the selected tools in ${path__WEBPACK_IMPORTED_MODULE_0___default().basename(outputPath)}...\n`);
+ this.context.stdout.write(`Packing the selected tools in ${path__WEBPACK_IMPORTED_MODULE_1___default().basename(outputPath)}...\n`);
const { default: tar } = await Promise.resolve(/*! import() eager */).then(__webpack_require__.t.bind(__webpack_require__, /*! tar */ "../../../.yarn/berry/cache/tar-npm-6.1.11-e6ac3cba9c-9.zip/node_modules/tar/index.js", 19));
- await tar.c({ gzip: true, cwd: baseInstallFolder, file: path__WEBPACK_IMPORTED_MODULE_0___default().resolve(outputPath) }, installLocations.map(location => {
- return path__WEBPACK_IMPORTED_MODULE_0___default().relative(baseInstallFolder, location);
+ // Recreate the folder in case it was deleted somewhere else:
+ await (0,fs_promises__WEBPACK_IMPORTED_MODULE_0__.mkdir)(baseInstallFolder, { recursive: true });
+ await tar.c({ gzip: true, cwd: baseInstallFolder, file: path__WEBPACK_IMPORTED_MODULE_1___default().resolve(outputPath) }, installLocations.map(location => {
+ return path__WEBPACK_IMPORTED_MODULE_1___default().relative(baseInstallFolder, location);
}));
if (this.json) {
this.context.stdout.write(`${JSON.stringify(outputPath)}\n`);
@@ -15669,7 +15679,7 @@ class PrepareCommand extends clipanion__WEBPACK_IMPORTED_MODULE_3__.Command {
PrepareCommand.paths = [
[`prepare`],
];
-PrepareCommand.usage = clipanion__WEBPACK_IMPORTED_MODULE_3__.Command.Usage({
+PrepareCommand.usage = clipanion__WEBPACK_IMPORTED_MODULE_4__.Command.Usage({
description: `Generate a package manager archive`,
details: `
This command makes sure that the specified package managers are installed in the local cache. Calling this command explicitly unless you operate in an environment without network access (in which case you'd have to call \`prepare\` while building your image, to make sure all tools are available for later use).
@@ -15728,6 +15738,7 @@ __webpack_require__.r(__webpack_exports__);
/* harmony import */ var _fsUtils__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ./fsUtils */ "./sources/fsUtils.ts");
/* harmony import */ var _httpUtils__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ./httpUtils */ "./sources/httpUtils.ts");
/* harmony import */ var _nodeUtils__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! ./nodeUtils */ "./sources/nodeUtils.ts");
+/* harmony import */ var _npmRegistryUtils__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(/*! ./npmRegistryUtils */ "./sources/npmRegistryUtils.ts");
var __asyncValues = (undefined && undefined.__asyncValues) || function (o) {
if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
var m = o[Symbol.asyncIterator], i;
@@ -15745,11 +15756,11 @@ var __asyncValues = (undefined && undefined.__asyncValues) || function (o) {
+
async function fetchLatestStableVersion(spec) {
switch (spec.type) {
case `npm`: {
- const { [`dist-tags`]: { latest }, versions: { [latest]: { dist: { shasum } } } } = await _httpUtils__WEBPACK_IMPORTED_MODULE_8__.fetchAsJson(`https://registry.npmjs.org/${spec.package}`);
- return `${latest}+sha1.${shasum}`;
+ return await _npmRegistryUtils__WEBPACK_IMPORTED_MODULE_10__.fetchLatestStableVersion(spec.package);
}
case `url`: {
const data = await _httpUtils__WEBPACK_IMPORTED_MODULE_8__.fetchAsJson(spec.url);
@@ -15763,8 +15774,7 @@ async function fetchLatestStableVersion(spec) {
async function fetchAvailableTags(spec) {
switch (spec.type) {
case `npm`: {
- const data = await _httpUtils__WEBPACK_IMPORTED_MODULE_8__.fetchAsJson(`https://registry.npmjs.org/${spec.package}`, { headers: { [`Accept`]: `application/vnd.npm.install-v1+json` } });
- return data[`dist-tags`];
+ return await _npmRegistryUtils__WEBPACK_IMPORTED_MODULE_10__.fetchAvailableTags(spec.package);
}
case `url`: {
const data = await _httpUtils__WEBPACK_IMPORTED_MODULE_8__.fetchAsJson(spec.url);
@@ -15778,8 +15788,7 @@ async function fetchAvailableTags(spec) {
async function fetchAvailableVersions(spec) {
switch (spec.type) {
case `npm`: {
- const data = await _httpUtils__WEBPACK_IMPORTED_MODULE_8__.fetchAsJson(`https://registry.npmjs.org/${spec.package}`, { headers: { [`Accept`]: `application/vnd.npm.install-v1+json` } });
- return Object.keys(data.versions);
+ return await _npmRegistryUtils__WEBPACK_IMPORTED_MODULE_10__.fetchAvailableVersions(spec.package);
}
case `url`: {
const data = await _httpUtils__WEBPACK_IMPORTED_MODULE_8__.fetchAsJson(spec.url);
@@ -16309,6 +16318,67 @@ function loadMainModule(id) {
}
+/***/ }),
+
+/***/ "./sources/npmRegistryUtils.ts":
+/*!*************************************!*\
+ !*** ./sources/npmRegistryUtils.ts ***!
+ \*************************************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */ "DEFAULT_HEADERS": () => (/* binding */ DEFAULT_HEADERS),
+/* harmony export */ "DEFAULT_NPM_REGISTRY_URL": () => (/* binding */ DEFAULT_NPM_REGISTRY_URL),
+/* harmony export */ "fetchAsJson": () => (/* binding */ fetchAsJson),
+/* harmony export */ "fetchAvailableTags": () => (/* binding */ fetchAvailableTags),
+/* harmony export */ "fetchAvailableVersions": () => (/* binding */ fetchAvailableVersions),
+/* harmony export */ "fetchLatestStableVersion": () => (/* binding */ fetchLatestStableVersion)
+/* harmony export */ });
+/* harmony import */ var clipanion__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! clipanion */ "./.yarn/__virtual__/clipanion-virtual-72ec1bc418/4/.yarn/berry/cache/clipanion-npm-3.1.0-ced87dbbea-9.zip/node_modules/clipanion/lib/advanced/index.js");
+/* harmony import */ var _httpUtils__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./httpUtils */ "./sources/httpUtils.ts");
+
+
+// load abbreviated metadata as that's all we need for these calls
+// see: https://github.com/npm/registry/blob/cfe04736f34db9274a780184d1cdb2fb3e4ead2a/docs/responses/package-metadata.md
+const DEFAULT_HEADERS = {
+ [`Accept`]: `application/vnd.npm.install-v1+json`,
+};
+const DEFAULT_NPM_REGISTRY_URL = `https://registry.npmjs.org`;
+async function fetchAsJson(packageName) {
+ const npmRegistryUrl = process.env.COREPACK_NPM_REGISTRY || DEFAULT_NPM_REGISTRY_URL;
+ if (process.env.COREPACK_ENABLE_NETWORK === `0`)
+ throw new clipanion__WEBPACK_IMPORTED_MODULE_1__.UsageError(`Network access disabled by the environment; can't reach npm repository ${npmRegistryUrl}`);
+ const headers = Object.assign({}, DEFAULT_HEADERS);
+ if (`COREPACK_NPM_TOKEN` in process.env) {
+ headers.authorization = `Bearer ${process.env.COREPACK_NPM_TOKEN}`;
+ }
+ else if (`COREPACK_NPM_USERNAME` in process.env
+ && `COREPACK_NPM_PASSWORD` in process.env) {
+ const encodedCreds = Buffer.from(`${process.env.COREPACK_NPM_USERNAME}:${process.env.COREPACK_NPM_PASSWORD}`, `utf8`).toString(`base64`);
+ headers.authorization = `Basic ${encodedCreds}`;
+ }
+ return _httpUtils__WEBPACK_IMPORTED_MODULE_0__.fetchAsJson(`${npmRegistryUrl}/${packageName}`, { headers });
+}
+async function fetchLatestStableVersion(packageName) {
+ const metadata = await fetchAsJson(packageName);
+ const { latest } = metadata[`dist-tags`];
+ if (latest === undefined)
+ throw new Error(`${packageName} does not have a "latest" tag.`);
+ const { shasum } = metadata.versions[latest].dist;
+ return `${latest}+sha1.${shasum}`;
+}
+async function fetchAvailableTags(packageName) {
+ const metadata = await fetchAsJson(packageName);
+ return metadata[`dist-tags`];
+}
+async function fetchAvailableVersions(packageName) {
+ const metadata = await fetchAsJson(packageName);
+ return Object.keys(metadata.versions);
+}
+
+
/***/ }),
/***/ "./sources/semverUtils.ts":
@@ -16432,8 +16502,10 @@ function parseSpec(raw, source, { enforceExactVersion = true } = {}) {
async function findProjectSpec(initialCwd, locator, { transparent = false } = {}) {
// A locator is a valid descriptor (but not the other way around)
const fallbackLocator = { name: locator.name, range: locator.reference };
- if (process.env.COREPACK_ENABLE_STRICT === `0`)
+ if (process.env.COREPACK_ENABLE_PROJECT_SPEC === `0`)
return fallbackLocator;
+ if (process.env.COREPACK_ENABLE_STRICT === `0`)
+ transparent = true;
while (true) {
const result = await loadSpec(initialCwd);
switch (result.type) {
@@ -17027,7 +17099,7 @@ const supportsColor = {
/***/ ((module) => {
"use strict";
-module.exports = JSON.parse('{"definitions":{"npm":{"default":"8.19.2+sha1.db90e88584d065f51b069ab46b4f02f5cf4898b7","fetchLatestFrom":{"type":"npm","package":"npm"},"transparent":{"commands":[["npm","init"],["npx"]]},"ranges":{"*":{"url":"https://registry.npmjs.org/npm/-/npm-{}.tgz","bin":{"npm":"./bin/npm-cli.js","npx":"./bin/npx-cli.js"},"registry":{"type":"npm","package":"npm"}}}},"pnpm":{"default":"7.11.0+sha1.ae48bcb805080989f94fe5dca372013c9ae517e7","fetchLatestFrom":{"type":"npm","package":"pnpm"},"transparent":{"commands":[["pnpm","init"],["pnpx"],["pnpm","dlx"]]},"ranges":{"<6.0.0":{"url":"https://registry.npmjs.org/pnpm/-/pnpm-{}.tgz","bin":{"pnpm":"./bin/pnpm.js","pnpx":"./bin/pnpx.js"},"registry":{"type":"npm","package":"pnpm"}},">=6.0.0":{"url":"https://registry.npmjs.org/pnpm/-/pnpm-{}.tgz","bin":{"pnpm":"./bin/pnpm.cjs","pnpx":"./bin/pnpx.cjs"},"registry":{"type":"npm","package":"pnpm"}}}},"yarn":{"default":"1.22.19+sha1.4ba7fc5c6e704fce2066ecbfb0b0d8976fe62447","fetchLatestFrom":{"type":"npm","package":"yarn"},"transparent":{"default":"3.2.3+sha224.953c8233f7a92884eee2de69a1b92d1f2ec1655e66d08071ba9a02fa","commands":[["yarn","dlx"]]},"ranges":{"<2.0.0":{"url":"https://registry.yarnpkg.com/yarn/-/yarn-{}.tgz","bin":{"yarn":"./bin/yarn.js","yarnpkg":"./bin/yarn.js"},"registry":{"type":"npm","package":"yarn"}},">=2.0.0":{"name":"yarn","url":"https://repo.yarnpkg.com/{}/packages/yarnpkg-cli/bin/yarn.js","bin":["yarn","yarnpkg"],"registry":{"type":"url","url":"https://repo.yarnpkg.com/tags","fields":{"tags":"latest","versions":"tags"}}}}}}}');
+module.exports = JSON.parse('{"definitions":{"npm":{"default":"8.19.3+sha1.adb51bf8886d519dd4df162726d0ad157ecfa272","fetchLatestFrom":{"type":"npm","package":"npm"},"transparent":{"commands":[["npm","init"],["npx"]]},"ranges":{"*":{"url":"https://registry.npmjs.org/npm/-/npm-{}.tgz","bin":{"npm":"./bin/npm-cli.js","npx":"./bin/npx-cli.js"},"registry":{"type":"npm","package":"npm"}}}},"pnpm":{"default":"7.14.2+sha1.73bf8dbd968bf782db5bbc627d2facc645c6bc4a","fetchLatestFrom":{"type":"npm","package":"pnpm"},"transparent":{"commands":[["pnpm","init"],["pnpx"],["pnpm","dlx"]]},"ranges":{"<6.0.0":{"url":"https://registry.npmjs.org/pnpm/-/pnpm-{}.tgz","bin":{"pnpm":"./bin/pnpm.js","pnpx":"./bin/pnpx.js"},"registry":{"type":"npm","package":"pnpm"}},">=6.0.0":{"url":"https://registry.npmjs.org/pnpm/-/pnpm-{}.tgz","bin":{"pnpm":"./bin/pnpm.cjs","pnpx":"./bin/pnpx.cjs"},"registry":{"type":"npm","package":"pnpm"}}}},"yarn":{"default":"1.22.19+sha1.4ba7fc5c6e704fce2066ecbfb0b0d8976fe62447","fetchLatestFrom":{"type":"npm","package":"yarn"},"transparent":{"default":"3.2.4+sha224.e61785c1cff5bae29570238b7718845a9d00788f5b6f32e472c908dc","commands":[["yarn","dlx"]]},"ranges":{"<2.0.0":{"url":"https://registry.yarnpkg.com/yarn/-/yarn-{}.tgz","bin":{"yarn":"./bin/yarn.js","yarnpkg":"./bin/yarn.js"},"registry":{"type":"npm","package":"yarn"}},">=2.0.0":{"name":"yarn","url":"https://repo.yarnpkg.com/{}/packages/yarnpkg-cli/bin/yarn.js","bin":["yarn","yarnpkg"],"registry":{"type":"url","url":"https://repo.yarnpkg.com/tags","fields":{"tags":"latest","versions":"tags"}}}}}}}');
/***/ }),
@@ -17038,7 +17110,7 @@ module.exports = JSON.parse('{"definitions":{"npm":{"default":"8.19.2+sha1.db90e
/***/ ((module) => {
"use strict";
-module.exports = JSON.parse('{"name":"corepack","version":"0.14.1","homepage":"https://github.com/nodejs/corepack#readme","bugs":{"url":"https://github.com/nodejs/corepack/issues"},"repository":{"type":"git","url":"https://github.com/nodejs/corepack.git"},"license":"MIT","packageManager":"yarn@4.0.0-rc.15+sha224.7fa5c1d1875b041cea8fcbf9a364667e398825364bf5c5c8cd5f6601","devDependencies":{"@babel/core":"^7.14.3","@babel/plugin-transform-modules-commonjs":"^7.14.0","@babel/preset-typescript":"^7.13.0","@types/debug":"^4.1.5","@types/jest":"^29.0.0","@types/node":"^18.0.0","@types/semver":"^7.1.0","@types/tar":"^6.0.0","@types/which":"^2.0.0","@typescript-eslint/eslint-plugin":"^5.0.0","@typescript-eslint/parser":"^5.0.0","@yarnpkg/eslint-config":"^1.0.0-rc.5","@yarnpkg/fslib":"^2.1.0","@zkochan/cmd-shim":"^5.0.0","babel-plugin-dynamic-import-node":"^2.3.3","clipanion":"^3.0.1","debug":"^4.1.1","eslint":"^8.0.0","eslint-plugin-arca":"^0.15.0","jest":"^29.0.0","nock":"^13.0.4","proxy-agent":"^5.0.0","semver":"^7.1.3","supports-color":"^9.0.0","tar":"^6.0.1","terser-webpack-plugin":"^5.1.2","ts-loader":"^9.0.0","ts-node":"^10.0.0","typescript":"^4.3.2","v8-compile-cache":"^2.3.0","webpack":"^5.38.1","webpack-cli":"^4.0.0","which":"^2.0.2"},"scripts":{"build":"rm -rf dist shims && webpack && ts-node ./mkshims.ts","corepack":"ts-node ./sources/_entryPoint.ts","lint":"yarn eslint","prepack":"yarn build","postpack":"rm -rf dist shims","typecheck":"tsc --noEmit","test":"yarn jest"},"files":["dist","shims","LICENSE.md"],"publishConfig":{"bin":{"corepack":"./dist/corepack.js","pnpm":"./dist/pnpm.js","pnpx":"./dist/pnpx.js","yarn":"./dist/yarn.js","yarnpkg":"./dist/yarnpkg.js"},"executableFiles":["./dist/npm.js","./dist/npx.js","./dist/pnpm.js","./dist/pnpx.js","./dist/yarn.js","./dist/yarnpkg.js","./dist/corepack.js","./shims/npm","./shims/npm.ps1","./shims/npx","./shims/npx.ps1","./shims/pnpm","./shims/pnpm.ps1","./shims/pnpx","./shims/pnpx.ps1","./shims/yarn","./shims/yarn.ps1","./shims/yarnpkg","./shims/yarnpkg.ps1"]},"resolutions":{"vm2":"patch:vm2@npm:3.9.9#.yarn/patches/vm2-npm-3.9.9-03fd1f4dc5.patch"}}');
+module.exports = JSON.parse('{"name":"corepack","version":"0.15.1","homepage":"https://github.com/nodejs/corepack#readme","bugs":{"url":"https://github.com/nodejs/corepack/issues"},"repository":{"type":"git","url":"https://github.com/nodejs/corepack.git"},"license":"MIT","packageManager":"yarn@4.0.0-rc.15+sha224.7fa5c1d1875b041cea8fcbf9a364667e398825364bf5c5c8cd5f6601","devDependencies":{"@babel/core":"^7.14.3","@babel/plugin-transform-modules-commonjs":"^7.14.0","@babel/preset-typescript":"^7.13.0","@types/debug":"^4.1.5","@types/jest":"^29.0.0","@types/node":"^18.0.0","@types/semver":"^7.1.0","@types/tar":"^6.0.0","@types/which":"^2.0.0","@typescript-eslint/eslint-plugin":"^5.0.0","@typescript-eslint/parser":"^5.0.0","@yarnpkg/eslint-config":"^1.0.0-rc.5","@yarnpkg/fslib":"^2.1.0","@zkochan/cmd-shim":"^5.0.0","babel-plugin-dynamic-import-node":"^2.3.3","clipanion":"^3.0.1","debug":"^4.1.1","eslint":"^8.0.0","eslint-plugin-arca":"^0.15.0","jest":"^29.0.0","nock":"^13.0.4","proxy-agent":"^5.0.0","semver":"^7.1.3","supports-color":"^9.0.0","tar":"^6.0.1","terser-webpack-plugin":"^5.1.2","ts-loader":"^9.0.0","ts-node":"^10.0.0","typescript":"^4.3.2","v8-compile-cache":"^2.3.0","webpack":"^5.38.1","webpack-cli":"^4.0.0","which":"^2.0.2"},"scripts":{"build":"rm -rf dist shims && webpack && ts-node ./mkshims.ts","corepack":"ts-node ./sources/_entryPoint.ts","lint":"yarn eslint","prepack":"yarn build","postpack":"rm -rf dist shims","typecheck":"tsc --noEmit","test":"yarn jest"},"files":["dist","shims","LICENSE.md"],"publishConfig":{"bin":{"corepack":"./dist/corepack.js","pnpm":"./dist/pnpm.js","pnpx":"./dist/pnpx.js","yarn":"./dist/yarn.js","yarnpkg":"./dist/yarnpkg.js"},"executableFiles":["./dist/npm.js","./dist/npx.js","./dist/pnpm.js","./dist/pnpx.js","./dist/yarn.js","./dist/yarnpkg.js","./dist/corepack.js","./shims/npm","./shims/npm.ps1","./shims/npx","./shims/npx.ps1","./shims/pnpm","./shims/pnpm.ps1","./shims/pnpx","./shims/pnpx.ps1","./shims/yarn","./shims/yarn.ps1","./shims/yarnpkg","./shims/yarnpkg.ps1"]},"resolutions":{"vm2":"patch:vm2@npm:3.9.9#.yarn/patches/vm2-npm-3.9.9-03fd1f4dc5.patch"}}');
/***/ })
diff --git a/deps/corepack/package.json b/deps/corepack/package.json
index 323996f93b7de8..774c5f88d4d845 100644
--- a/deps/corepack/package.json
+++ b/deps/corepack/package.json
@@ -1,6 +1,6 @@
{
"name": "corepack",
- "version": "0.14.1",
+ "version": "0.15.1",
"homepage": "https://github.com/nodejs/corepack#readme",
"bugs": {
"url": "https://github.com/nodejs/corepack/issues"
diff --git a/deps/icu-small/source/data/in/icudt71l.dat.bz2 b/deps/icu-small/source/data/in/icudt71l.dat.bz2
index b08a91229ae4a0..7a32860488f0c5 100644
Binary files a/deps/icu-small/source/data/in/icudt71l.dat.bz2 and b/deps/icu-small/source/data/in/icudt71l.dat.bz2 differ
diff --git a/deps/npm/docs/content/commands/npm-access.md b/deps/npm/docs/content/commands/npm-access.md
index f7a98af6547142..e707eb6f5e212d 100644
--- a/deps/npm/docs/content/commands/npm-access.md
+++ b/deps/npm/docs/content/commands/npm-access.md
@@ -6,10 +6,6 @@ description: Set access level on published packages
### Synopsis
-
-
-
-
```bash
npm access public []
npm access restricted []
@@ -22,11 +18,6 @@ npm access ls-collaborators [ []]
npm access edit []
```
-
-
-
-
-
### Description
Used to set access controls on private packages.
@@ -88,9 +79,6 @@ Management of teams and team memberships is done with the `npm team` command.
### Configuration
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -98,9 +86,6 @@ Management of teams and team memberships is done with the `npm team` command.
The base URL of the npm registry.
-
-
-
#### `otp`
* Default: null
@@ -112,11 +97,6 @@ when publishing or changing package permissions with `npm access`.
If not set, and a registry response fails with a challenge for a one-time
password, npm will prompt on the command line for one.
-
-
-
-
-
### See Also
* [`libnpmaccess`](https://npm.im/libnpmaccess)
diff --git a/deps/npm/docs/content/commands/npm-adduser.md b/deps/npm/docs/content/commands/npm-adduser.md
index 700aecb2255b27..2d040c6a4a5792 100644
--- a/deps/npm/docs/content/commands/npm-adduser.md
+++ b/deps/npm/docs/content/commands/npm-adduser.md
@@ -6,21 +6,12 @@ description: Add a registry user account
### Synopsis
-
-
-
-
```bash
npm adduser
aliases: login, add-user
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -44,9 +35,6 @@ your existing record.
### Configuration
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -54,9 +42,6 @@ your existing record.
The base URL of the npm registry.
-
-
-
#### `scope`
* Default: the scope of the current project, if any, or ""
@@ -87,9 +72,6 @@ npm init --scope=@foo --yes
```
-
-
-
#### `auth-type`
* Default: "legacy"
@@ -100,11 +82,6 @@ removed in a future version.
What authentication strategy to use with `login`.
-
-
-
-
-
### See Also
* [npm registry](/using-npm/registry)
diff --git a/deps/npm/docs/content/commands/npm-audit.md b/deps/npm/docs/content/commands/npm-audit.md
index 48e0a3161e8f2c..ab6395502328ea 100644
--- a/deps/npm/docs/content/commands/npm-audit.md
+++ b/deps/npm/docs/content/commands/npm-audit.md
@@ -6,19 +6,10 @@ description: Run a security audit
### Synopsis
-
-
-
-
```bash
npm audit [fix|signatures]
```
-
-
-
-
-
### Description
The audit command submits a description of the dependencies configured in
@@ -247,9 +238,6 @@ $ npm audit --audit-level=moderate
### Configuration
-
-
-
#### `audit-level`
* Default: null
@@ -258,9 +246,6 @@ $ npm audit --audit-level=moderate
The minimum level of vulnerability for `npm audit` to exit with a non-zero
exit code.
-
-
-
#### `dry-run`
* Default: false
@@ -274,9 +259,6 @@ commands that modify your local installation, eg, `install`, `update`,
Note: This is NOT honored by other network related commands, eg `dist-tags`,
`owner`, etc.
-
-
-
#### `force`
* Default: false
@@ -303,9 +285,6 @@ mistakes, unnecessary performance degradation, and malicious input.
If you don't have a clear idea of what you want to do, it is strongly
recommended that you do not use this option!
-
-
-
#### `json`
* Default: false
@@ -318,9 +297,6 @@ Whether or not to output JSON data, rather than the normal output.
Not supported by all npm commands.
-
-
-
#### `package-lock-only`
* Default: false
@@ -335,9 +311,6 @@ instead of checking `node_modules` and downloading dependencies.
For `list` this means the output will be based on the tree described by the
`package-lock.json`, rather than the contents of `node_modules`.
-
-
-
#### `omit`
* Default: 'dev' if the `NODE_ENV` environment variable is set to
@@ -356,9 +329,6 @@ it will be included.
If the resulting omit list includes `'dev'`, then the `NODE_ENV` environment
variable will be set to `'production'` for all lifecycle scripts.
-
-
-
#### `foreground-scripts`
* Default: false
@@ -371,9 +341,6 @@ input, output, and error with the main npm process.
Note that this will generally make installs run slower, and be much noisier,
but can be useful for debugging.
-
-
-
#### `ignore-scripts`
* Default: false
@@ -386,9 +353,6 @@ Note that commands explicitly intended to run a particular script, such as
will still run their intended script if `ignore-scripts` is set, but they
will *not* run any pre- or post-scripts.
-
-
-
#### `workspace`
* Default:
@@ -411,9 +375,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -432,9 +393,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -448,9 +406,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
#### `install-links`
* Default: false
@@ -460,11 +415,6 @@ When set file: protocol dependencies that exist outside of the project root
will be packed and installed as regular dependencies instead of creating a
symlink. This option has no effect on workspaces.
-
-
-
-
-
### See Also
* [npm install](/commands/npm-install)
diff --git a/deps/npm/docs/content/commands/npm-bin.md b/deps/npm/docs/content/commands/npm-bin.md
index 94b72cfd5c81ce..16a28a8e1c3ace 100644
--- a/deps/npm/docs/content/commands/npm-bin.md
+++ b/deps/npm/docs/content/commands/npm-bin.md
@@ -6,19 +6,10 @@ description: Display npm bin folder
### Synopsis
-
-
-
-
```bash
npm bin
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -27,9 +18,6 @@ Print the folder where npm will install executables.
### Configuration
-
-
-
#### `global`
* Default: false
@@ -44,11 +32,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
-
-
### See Also
* [npm prefix](/commands/npm-prefix)
diff --git a/deps/npm/docs/content/commands/npm-bugs.md b/deps/npm/docs/content/commands/npm-bugs.md
index 6b45f1f18ac660..153355fc694f7e 100644
--- a/deps/npm/docs/content/commands/npm-bugs.md
+++ b/deps/npm/docs/content/commands/npm-bugs.md
@@ -6,21 +6,12 @@ description: Report bugs for a package in a web browser
### Synopsis
-
-
-
-
```bash
npm bugs [ [ ...]]
alias: issues
```
-
-
-
-
-
### Description
This command tries to guess at the likely location of a package's bug
@@ -30,9 +21,6 @@ will search for a `package.json` in the current folder and use the `name` proper
### Configuration
-
-
-
#### `browser`
* Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
@@ -45,9 +33,6 @@ terminal.
Set to `true` to use default system URL opener.
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -55,9 +40,6 @@ Set to `true` to use default system URL opener.
The base URL of the npm registry.
-
-
-
#### `workspace`
* Default:
@@ -80,9 +62,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -101,9 +80,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -117,11 +93,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
-
-
### See Also
* [npm docs](/commands/npm-docs)
diff --git a/deps/npm/docs/content/commands/npm-cache.md b/deps/npm/docs/content/commands/npm-cache.md
index b5eddd46c05a7d..a6ef86dd22501f 100644
--- a/deps/npm/docs/content/commands/npm-cache.md
+++ b/deps/npm/docs/content/commands/npm-cache.md
@@ -6,10 +6,6 @@ description: Manipulates packages cache
### Synopsis
-
-
-
-
```bash
npm cache add
npm cache clean []
@@ -17,11 +13,6 @@ npm cache ls [@]
npm cache verify
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -79,9 +70,6 @@ verify`.
### Configuration
-
-
-
#### `cache`
* Default: Windows: `%LocalAppData%\npm-cache`, Posix: `~/.npm`
@@ -90,11 +78,6 @@ verify`.
The location of npm's cache directory. See [`npm
cache`](/commands/npm-cache)
-
-
-
-
-
### See Also
* [package spec](/using-npm/package-spec)
diff --git a/deps/npm/docs/content/commands/npm-ci.md b/deps/npm/docs/content/commands/npm-ci.md
index 3ecd7c6efb0957..474e27cdd0d967 100644
--- a/deps/npm/docs/content/commands/npm-ci.md
+++ b/deps/npm/docs/content/commands/npm-ci.md
@@ -6,21 +6,12 @@ description: Clean install a project
### Synopsis
-
-
-
-
```bash
npm ci
aliases: clean-install, ic, install-clean, isntall-clean
```
-
-
-
-
-
### Description
This command is similar to [`npm install`](/commands/npm-install), except
@@ -81,9 +72,6 @@ cache:
### Configuration
-
-
-
#### `save`
* Default: `true` unless when using `npm update` where it defaults to `false`
@@ -96,9 +84,6 @@ When used with the `npm rm` command, removes the dependency from
Will also prevent writing to `package-lock.json` if set to `false`.
-
-
-
#### `save-exact`
* Default: false
@@ -107,9 +92,6 @@ Will also prevent writing to `package-lock.json` if set to `false`.
Dependencies saved to package.json will be configured with an exact version
rather than using npm's default semver range operator.
-
-
-
#### `global`
* Default: false
@@ -124,9 +106,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
#### `global-style`
* Default: false
@@ -139,9 +118,6 @@ on will be flattened in their `node_modules` folders. This obviously will
eliminate some deduping. If used with `legacy-bundling`, `legacy-bundling`
will be preferred.
-
-
-
#### `legacy-bundling`
* Default: false
@@ -152,9 +128,6 @@ such as the one included with node 0.8, can install the package. This
eliminates all automatic deduping. If used with `global-style` this option
will be preferred.
-
-
-
#### `omit`
* Default: 'dev' if the `NODE_ENV` environment variable is set to
@@ -173,9 +146,6 @@ it will be included.
If the resulting omit list includes `'dev'`, then the `NODE_ENV` environment
variable will be set to `'production'` for all lifecycle scripts.
-
-
-
#### `strict-peer-deps`
* Default: false
@@ -195,9 +165,6 @@ When such and override is performed, a warning is printed, explaining the
conflict and the packages involved. If `--strict-peer-deps` is set, then
this warning is treated as a failure.
-
-
-
#### `package-lock`
* Default: true
@@ -208,9 +175,6 @@ will also prevent _writing_ `package-lock.json` if `save` is true.
This configuration does not affect `npm ci`.
-
-
-
#### `foreground-scripts`
* Default: false
@@ -223,9 +187,6 @@ input, output, and error with the main npm process.
Note that this will generally make installs run slower, and be much noisier,
but can be useful for debugging.
-
-
-
#### `ignore-scripts`
* Default: false
@@ -238,9 +199,6 @@ Note that commands explicitly intended to run a particular script, such as
will still run their intended script if `ignore-scripts` is set, but they
will *not* run any pre- or post-scripts.
-
-
-
#### `audit`
* Default: true
@@ -251,9 +209,6 @@ default registry and all registries configured for scopes. See the
documentation for [`npm audit`](/commands/npm-audit) for details on what is
submitted.
-
-
-
#### `bin-links`
* Default: true
@@ -266,9 +221,6 @@ Set to false to have it not do this. This can be used to work around the
fact that some file systems don't support symlinks, even on ostensibly Unix
systems.
-
-
-
#### `fund`
* Default: true
@@ -278,9 +230,6 @@ When "true" displays the message at the end of each `npm install`
acknowledging the number of dependencies looking for funding. See [`npm
fund`](/commands/npm-fund) for details.
-
-
-
#### `dry-run`
* Default: false
@@ -294,9 +243,6 @@ commands that modify your local installation, eg, `install`, `update`,
Note: This is NOT honored by other network related commands, eg `dist-tags`,
`owner`, etc.
-
-
-
#### `workspace`
* Default:
@@ -319,9 +265,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -340,9 +283,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -356,9 +296,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
#### `install-links`
* Default: false
@@ -368,11 +305,6 @@ When set file: protocol dependencies that exist outside of the project root
will be packed and installed as regular dependencies instead of creating a
symlink. This option has no effect on workspaces.
-
-
-
-
-
### See Also
* [npm install](/commands/npm-install)
diff --git a/deps/npm/docs/content/commands/npm-completion.md b/deps/npm/docs/content/commands/npm-completion.md
index d73a98f2e50f78..8cbc71306c851a 100644
--- a/deps/npm/docs/content/commands/npm-completion.md
+++ b/deps/npm/docs/content/commands/npm-completion.md
@@ -6,19 +6,10 @@ description: Tab Completion for npm
### Synopsis
-
-
-
-
```bash
npm completion
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
diff --git a/deps/npm/docs/content/commands/npm-config.md b/deps/npm/docs/content/commands/npm-config.md
index 28c6003571de5f..311183b9170101 100644
--- a/deps/npm/docs/content/commands/npm-config.md
+++ b/deps/npm/docs/content/commands/npm-config.md
@@ -6,10 +6,6 @@ description: Manage the npm configuration files
### Synopsis
-
-
-
-
```bash
npm config set = [= ...]
npm config get [ [ ...]]
@@ -20,11 +16,6 @@ npm config edit
alias: c
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -102,9 +93,6 @@ global config.
### Configuration
-
-
-
#### `json`
* Default: false
@@ -117,9 +105,6 @@ Whether or not to output JSON data, rather than the normal output.
Not supported by all npm commands.
-
-
-
#### `global`
* Default: false
@@ -134,9 +119,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
#### `editor`
* Default: The EDITOR or VISUAL environment variables, or 'notepad.exe' on
@@ -145,9 +127,6 @@ folder instead of the current working directory. See
The command to run for `npm edit` and `npm config edit`.
-
-
-
#### `location`
* Default: "user" unless `--global` is passed, which will also set this value
@@ -165,9 +144,6 @@ instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
#### `long`
* Default: false
@@ -175,11 +151,6 @@ instead of the current working directory. See
Show extended information in `ls`, `search`, and `help-search`.
-
-
-
-
-
### See Also
* [npm folders](/configuring-npm/folders)
diff --git a/deps/npm/docs/content/commands/npm-dedupe.md b/deps/npm/docs/content/commands/npm-dedupe.md
index 570e018342f276..f7fff73dc1786e 100644
--- a/deps/npm/docs/content/commands/npm-dedupe.md
+++ b/deps/npm/docs/content/commands/npm-dedupe.md
@@ -6,21 +6,12 @@ description: Reduce duplication in the package tree
### Synopsis
-
-
-
-
```bash
npm dedupe
alias: ddp
```
-
-
-
-
-
### Description
Searches the local package tree and attempts to simplify the overall
@@ -86,9 +77,6 @@ values in `package.json` you can run: `npm update --save` instead.
### Configuration
-
-
-
#### `global-style`
* Default: false
@@ -101,9 +89,6 @@ on will be flattened in their `node_modules` folders. This obviously will
eliminate some deduping. If used with `legacy-bundling`, `legacy-bundling`
will be preferred.
-
-
-
#### `legacy-bundling`
* Default: false
@@ -114,9 +99,6 @@ such as the one included with node 0.8, can install the package. This
eliminates all automatic deduping. If used with `global-style` this option
will be preferred.
-
-
-
#### `strict-peer-deps`
* Default: false
@@ -136,9 +118,6 @@ When such and override is performed, a warning is printed, explaining the
conflict and the packages involved. If `--strict-peer-deps` is set, then
this warning is treated as a failure.
-
-
-
#### `package-lock`
* Default: true
@@ -149,9 +128,6 @@ will also prevent _writing_ `package-lock.json` if `save` is true.
This configuration does not affect `npm ci`.
-
-
-
#### `omit`
* Default: 'dev' if the `NODE_ENV` environment variable is set to
@@ -170,9 +146,6 @@ it will be included.
If the resulting omit list includes `'dev'`, then the `NODE_ENV` environment
variable will be set to `'production'` for all lifecycle scripts.
-
-
-
#### `ignore-scripts`
* Default: false
@@ -185,9 +158,6 @@ Note that commands explicitly intended to run a particular script, such as
will still run their intended script if `ignore-scripts` is set, but they
will *not* run any pre- or post-scripts.
-
-
-
#### `audit`
* Default: true
@@ -198,9 +168,6 @@ default registry and all registries configured for scopes. See the
documentation for [`npm audit`](/commands/npm-audit) for details on what is
submitted.
-
-
-
#### `bin-links`
* Default: true
@@ -213,9 +180,6 @@ Set to false to have it not do this. This can be used to work around the
fact that some file systems don't support symlinks, even on ostensibly Unix
systems.
-
-
-
#### `fund`
* Default: true
@@ -225,9 +189,6 @@ When "true" displays the message at the end of each `npm install`
acknowledging the number of dependencies looking for funding. See [`npm
fund`](/commands/npm-fund) for details.
-
-
-
#### `dry-run`
* Default: false
@@ -241,9 +202,6 @@ commands that modify your local installation, eg, `install`, `update`,
Note: This is NOT honored by other network related commands, eg `dist-tags`,
`owner`, etc.
-
-
-
#### `workspace`
* Default:
@@ -266,9 +224,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -287,9 +242,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -303,9 +255,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
#### `install-links`
* Default: false
@@ -315,11 +264,6 @@ When set file: protocol dependencies that exist outside of the project root
will be packed and installed as regular dependencies instead of creating a
symlink. This option has no effect on workspaces.
-
-
-
-
-
### See Also
* [npm find-dupes](/commands/npm-find-dupes)
diff --git a/deps/npm/docs/content/commands/npm-deprecate.md b/deps/npm/docs/content/commands/npm-deprecate.md
index 20f65140fc735f..146aab88c5bf74 100644
--- a/deps/npm/docs/content/commands/npm-deprecate.md
+++ b/deps/npm/docs/content/commands/npm-deprecate.md
@@ -6,19 +6,10 @@ description: Deprecate a version of a package
### Synopsis
-
-
-
-
```bash
npm deprecate
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -51,9 +42,6 @@ format an empty string.
### Configuration
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -61,9 +49,6 @@ format an empty string.
The base URL of the npm registry.
-
-
-
#### `otp`
* Default: null
@@ -75,11 +60,6 @@ when publishing or changing package permissions with `npm access`.
If not set, and a registry response fails with a challenge for a one-time
password, npm will prompt on the command line for one.
-
-
-
-
-
### See Also
* [package spec](/using-npm/package-spec)
diff --git a/deps/npm/docs/content/commands/npm-diff.md b/deps/npm/docs/content/commands/npm-diff.md
index 7dcc8af7c3b4c7..852fcf3d066148 100644
--- a/deps/npm/docs/content/commands/npm-diff.md
+++ b/deps/npm/docs/content/commands/npm-diff.md
@@ -6,19 +6,10 @@ description: The registry diff command
### Synopsis
-
-
-
-
```bash
npm diff [...]
```
-
-
-
-
-
### Description
Similar to its `git diff` counterpart, this command will print diff patches
@@ -158,9 +149,6 @@ located within the folder `./lib/` and changed lines of code within the
### Configuration
-
-
-
#### `diff`
* Default:
@@ -168,9 +156,6 @@ located within the folder `./lib/` and changed lines of code within the
Define arguments to compare in `npm diff`.
-
-
-
#### `diff-name-only`
* Default: false
@@ -178,9 +163,6 @@ Define arguments to compare in `npm diff`.
Prints only filenames when using `npm diff`.
-
-
-
#### `diff-unified`
* Default: 3
@@ -188,9 +170,6 @@ Prints only filenames when using `npm diff`.
The number of lines of context to print in `npm diff`.
-
-
-
#### `diff-ignore-all-space`
* Default: false
@@ -198,9 +177,6 @@ The number of lines of context to print in `npm diff`.
Ignore whitespace when comparing lines in `npm diff`.
-
-
-
#### `diff-no-prefix`
* Default: false
@@ -211,9 +187,6 @@ Do not show any source or destination prefix in `npm diff` output.
Note: this causes `npm diff` to ignore the `--diff-src-prefix` and
`--diff-dst-prefix` configs.
-
-
-
#### `diff-src-prefix`
* Default: "a/"
@@ -221,9 +194,6 @@ Note: this causes `npm diff` to ignore the `--diff-src-prefix` and
Source prefix to be used in `npm diff` output.
-
-
-
#### `diff-dst-prefix`
* Default: "b/"
@@ -231,9 +201,6 @@ Source prefix to be used in `npm diff` output.
Destination prefix to be used in `npm diff` output.
-
-
-
#### `diff-text`
* Default: false
@@ -241,9 +208,6 @@ Destination prefix to be used in `npm diff` output.
Treat all files as text in `npm diff`.
-
-
-
#### `global`
* Default: false
@@ -258,9 +222,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
#### `tag`
* Default: "latest"
@@ -275,9 +236,6 @@ command, if no explicit tag is given.
When used by the `npm diff` command, this is the tag used to fetch the
tarball that will be compared with the local files by default.
-
-
-
#### `workspace`
* Default:
@@ -300,9 +258,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -321,9 +276,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -336,11 +288,6 @@ all workspaces via the `workspaces` flag, will cause npm to operate only on
the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
-
-
## See Also
* [npm outdated](/commands/npm-outdated)
diff --git a/deps/npm/docs/content/commands/npm-dist-tag.md b/deps/npm/docs/content/commands/npm-dist-tag.md
index 123e67dbf3b235..d22831d2ce823e 100644
--- a/deps/npm/docs/content/commands/npm-dist-tag.md
+++ b/deps/npm/docs/content/commands/npm-dist-tag.md
@@ -6,10 +6,6 @@ description: Modify package distribution tags
### Synopsis
-
-
-
-
```bash
npm dist-tag add []
npm dist-tag rm
@@ -18,11 +14,6 @@ npm dist-tag ls []
alias: dist-tags
```
-
-
-
-
-
### Description
Add, remove, and enumerate distribution tags on a package:
@@ -99,9 +90,6 @@ not begin with a number or the letter `v`.
### Configuration
-
-
-
#### `workspace`
* Default:
@@ -124,9 +112,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -145,9 +130,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -161,11 +143,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
-
-
### See Also
* [package spec](/using-npm/package-spec)
diff --git a/deps/npm/docs/content/commands/npm-docs.md b/deps/npm/docs/content/commands/npm-docs.md
index 790d563bdb1fb7..e4c88dc19d337c 100644
--- a/deps/npm/docs/content/commands/npm-docs.md
+++ b/deps/npm/docs/content/commands/npm-docs.md
@@ -6,21 +6,12 @@ description: Open documentation for a package in a web browser
### Synopsis
-
-
-
-
```bash
npm docs [ [ ...]]
alias: home
```
-
-
-
-
-
### Description
This command tries to guess at the likely location of a package's
@@ -31,9 +22,6 @@ the `name` property.
### Configuration
-
-
-
#### `browser`
* Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
@@ -46,9 +34,6 @@ terminal.
Set to `true` to use default system URL opener.
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -56,9 +41,6 @@ Set to `true` to use default system URL opener.
The base URL of the npm registry.
-
-
-
#### `workspace`
* Default:
@@ -81,9 +63,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -102,9 +81,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -118,11 +94,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
-
-
### See Also
* [npm view](/commands/npm-view)
diff --git a/deps/npm/docs/content/commands/npm-doctor.md b/deps/npm/docs/content/commands/npm-doctor.md
index 7fb63bab16e835..34d925bce91019 100644
--- a/deps/npm/docs/content/commands/npm-doctor.md
+++ b/deps/npm/docs/content/commands/npm-doctor.md
@@ -6,19 +6,10 @@ description: Check your npm environment
### Synopsis
-
-
-
-
```bash
npm doctor
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -113,9 +104,6 @@ reset the cache.
### Configuration
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -123,11 +111,6 @@ reset the cache.
The base URL of the npm registry.
-
-
-
-
-
### See Also
* [npm bugs](/commands/npm-bugs)
diff --git a/deps/npm/docs/content/commands/npm-edit.md b/deps/npm/docs/content/commands/npm-edit.md
index 39fc49592c571c..9f6750ff175415 100644
--- a/deps/npm/docs/content/commands/npm-edit.md
+++ b/deps/npm/docs/content/commands/npm-edit.md
@@ -6,19 +6,10 @@ description: Edit an installed package
### Synopsis
-
-
-
-
```bash
npm edit [/...]
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -36,9 +27,6 @@ changes to your locally installed copy.
### Configuration
-
-
-
#### `editor`
* Default: The EDITOR or VISUAL environment variables, or 'notepad.exe' on
@@ -47,11 +35,6 @@ changes to your locally installed copy.
The command to run for `npm edit` and `npm config edit`.
-
-
-
-
-
### See Also
* [npm folders](/configuring-npm/folders)
diff --git a/deps/npm/docs/content/commands/npm-exec.md b/deps/npm/docs/content/commands/npm-exec.md
index 3d8de1ea54ad6f..b968671ed84670 100644
--- a/deps/npm/docs/content/commands/npm-exec.md
+++ b/deps/npm/docs/content/commands/npm-exec.md
@@ -6,10 +6,6 @@ description: Run a command from a local or remote npm package
### Synopsis
-
-
-
-
```bash
npm exec -- [@] [args...]
npm exec --package=[@] -- [args...]
@@ -19,11 +15,6 @@ npm exec --package=foo -c ' [args...]'
alias: x
```
-
-
-
-
-
### Description
This command allows you to run an arbitrary command from an npm package
@@ -119,9 +110,6 @@ $ npm exec -- foo@latest bar --package=@npmcli/foo
### Configuration
-
-
-
#### `package`
* Default:
@@ -129,9 +117,6 @@ $ npm exec -- foo@latest bar --package=@npmcli/foo
The package or packages to install for [`npm exec`](/commands/npm-exec)
-
-
-
#### `call`
* Default: ""
@@ -145,9 +130,6 @@ npm exec --package yo --package generator-node --call "yo node"
```
-
-
-
#### `workspace`
* Default:
@@ -170,9 +152,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -191,9 +170,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -207,11 +183,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
-
-
### Examples
Run the version of `tap` in the local dependencies, with the provided
diff --git a/deps/npm/docs/content/commands/npm-explain.md b/deps/npm/docs/content/commands/npm-explain.md
index 5ba2fe8206ba16..382429ad7e978f 100644
--- a/deps/npm/docs/content/commands/npm-explain.md
+++ b/deps/npm/docs/content/commands/npm-explain.md
@@ -6,21 +6,12 @@ description: Explain installed packages
### Synopsis
-
-
-
-
```bash
npm explain
alias: why
```
-
-
-
-
-
### Description
This command will print the chain of dependencies causing a given package
@@ -64,9 +55,6 @@ node_modules/nyc/node_modules/find-up
```
### Configuration
-
-
-
#### `json`
* Default: false
@@ -79,9 +67,6 @@ Whether or not to output JSON data, rather than the normal output.
Not supported by all npm commands.
-
-
-
#### `workspace`
* Default:
@@ -104,11 +89,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
-
-
### See Also
* [package spec](/using-npm/package-spec)
diff --git a/deps/npm/docs/content/commands/npm-explore.md b/deps/npm/docs/content/commands/npm-explore.md
index 90753c7e09199f..cc312a0d28c67a 100644
--- a/deps/npm/docs/content/commands/npm-explore.md
+++ b/deps/npm/docs/content/commands/npm-explore.md
@@ -6,19 +6,10 @@ description: Browse an installed package
### Synopsis
-
-
-
-
```bash
npm explore [ -- ]
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -40,9 +31,6 @@ sure to use `npm rebuild ` if you make any changes.
### Configuration
-
-
-
#### `shell`
* Default: SHELL environment variable, or "bash" on Posix, or "cmd.exe" on
@@ -51,11 +39,6 @@ sure to use `npm rebuild ` if you make any changes.
The shell to run for the `npm explore` command.
-
-
-
-
-
### See Also
* [npm folders](/configuring-npm/folders)
diff --git a/deps/npm/docs/content/commands/npm-find-dupes.md b/deps/npm/docs/content/commands/npm-find-dupes.md
index 4da6c296c6bf6d..723f04cfb11887 100644
--- a/deps/npm/docs/content/commands/npm-find-dupes.md
+++ b/deps/npm/docs/content/commands/npm-find-dupes.md
@@ -6,19 +6,10 @@ description: Find duplication in the package tree
### Synopsis
-
-
-
-
```bash
npm find-dupes
```
-
-
-
-
-
### Description
Runs `npm dedupe` in `--dry-run` mode, making npm only output the
@@ -26,9 +17,6 @@ duplications, without actually changing the package tree.
### Configuration
-
-
-
#### `global-style`
* Default: false
@@ -41,9 +29,6 @@ on will be flattened in their `node_modules` folders. This obviously will
eliminate some deduping. If used with `legacy-bundling`, `legacy-bundling`
will be preferred.
-
-
-
#### `legacy-bundling`
* Default: false
@@ -54,9 +39,6 @@ such as the one included with node 0.8, can install the package. This
eliminates all automatic deduping. If used with `global-style` this option
will be preferred.
-
-
-
#### `strict-peer-deps`
* Default: false
@@ -76,9 +58,6 @@ When such and override is performed, a warning is printed, explaining the
conflict and the packages involved. If `--strict-peer-deps` is set, then
this warning is treated as a failure.
-
-
-
#### `package-lock`
* Default: true
@@ -89,9 +68,6 @@ will also prevent _writing_ `package-lock.json` if `save` is true.
This configuration does not affect `npm ci`.
-
-
-
#### `omit`
* Default: 'dev' if the `NODE_ENV` environment variable is set to
@@ -110,9 +86,6 @@ it will be included.
If the resulting omit list includes `'dev'`, then the `NODE_ENV` environment
variable will be set to `'production'` for all lifecycle scripts.
-
-
-
#### `ignore-scripts`
* Default: false
@@ -125,9 +98,6 @@ Note that commands explicitly intended to run a particular script, such as
will still run their intended script if `ignore-scripts` is set, but they
will *not* run any pre- or post-scripts.
-
-
-
#### `audit`
* Default: true
@@ -138,9 +108,6 @@ default registry and all registries configured for scopes. See the
documentation for [`npm audit`](/commands/npm-audit) for details on what is
submitted.
-
-
-
#### `bin-links`
* Default: true
@@ -153,9 +120,6 @@ Set to false to have it not do this. This can be used to work around the
fact that some file systems don't support symlinks, even on ostensibly Unix
systems.
-
-
-
#### `fund`
* Default: true
@@ -165,9 +129,6 @@ When "true" displays the message at the end of each `npm install`
acknowledging the number of dependencies looking for funding. See [`npm
fund`](/commands/npm-fund) for details.
-
-
-
#### `workspace`
* Default:
@@ -190,9 +151,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -211,9 +169,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -227,9 +182,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
#### `install-links`
* Default: false
@@ -239,11 +191,6 @@ When set file: protocol dependencies that exist outside of the project root
will be packed and installed as regular dependencies instead of creating a
symlink. This option has no effect on workspaces.
-
-
-
-
-
### See Also
* [npm dedupe](/commands/npm-dedupe)
diff --git a/deps/npm/docs/content/commands/npm-fund.md b/deps/npm/docs/content/commands/npm-fund.md
index 8db0ce910de967..25a6735ec75473 100644
--- a/deps/npm/docs/content/commands/npm-fund.md
+++ b/deps/npm/docs/content/commands/npm-fund.md
@@ -6,19 +6,10 @@ description: Retrieve funding information
### Synopsis
-
-
-
-
```bash
npm fund []
```
-
-
-
-
-
### Description
This command retrieves information on how to fund the dependencies of a
@@ -72,9 +63,6 @@ test-workspaces-fund@1.0.0
### Configuration
-
-
-
#### `json`
* Default: false
@@ -87,9 +75,6 @@ Whether or not to output JSON data, rather than the normal output.
Not supported by all npm commands.
-
-
-
#### `browser`
* Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
@@ -102,9 +87,6 @@ terminal.
Set to `true` to use default system URL opener.
-
-
-
#### `unicode`
* Default: false on windows, true on mac/unix systems with a unicode locale,
@@ -114,9 +96,6 @@ Set to `true` to use default system URL opener.
When set to true, npm uses unicode characters in the tree output. When
false, it uses ascii characters instead of unicode glyphs.
-
-
-
#### `workspace`
* Default:
@@ -139,9 +118,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `which`
* Default: null
@@ -149,11 +125,6 @@ This value is not exported to the environment for child processes.
If there are multiple funding sources, which 1-indexed source URL to open.
-
-
-
-
-
## See Also
* [package spec](/using-npm/package-spec)
diff --git a/deps/npm/docs/content/commands/npm-help-search.md b/deps/npm/docs/content/commands/npm-help-search.md
index 152f9f6bec16f1..d92ea03aefb1dd 100644
--- a/deps/npm/docs/content/commands/npm-help-search.md
+++ b/deps/npm/docs/content/commands/npm-help-search.md
@@ -6,19 +6,10 @@ description: Search npm help documentation
### Synopsis
-
-
-
-
```bash
npm help-search
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -34,9 +25,6 @@ directly.
### Configuration
-
-
-
#### `long`
* Default: false
@@ -44,11 +32,6 @@ directly.
Show extended information in `ls`, `search`, and `help-search`.
-
-
-
-
-
### See Also
* [npm](/commands/npm)
diff --git a/deps/npm/docs/content/commands/npm-help.md b/deps/npm/docs/content/commands/npm-help.md
index 83c595db696b9c..48af6da7fa08d2 100644
--- a/deps/npm/docs/content/commands/npm-help.md
+++ b/deps/npm/docs/content/commands/npm-help.md
@@ -6,21 +6,12 @@ description: Get help on npm
### Synopsis
-
-
-
-
```bash
npm help []
alias: hlep
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -34,9 +25,6 @@ topic, so unique matches are equivalent to specifying a topic name.
### Configuration
-
-
-
#### `viewer`
* Default: "man" on Posix, "browser" on Windows
@@ -46,11 +34,6 @@ The program to use to view help content.
Set to `"browser"` to view html help content in the default web browser.
-
-
-
-
-
### See Also
* [npm](/commands/npm)
diff --git a/deps/npm/docs/content/commands/npm-hook.md b/deps/npm/docs/content/commands/npm-hook.md
index 4a9805d02f9d43..1304512e33a674 100644
--- a/deps/npm/docs/content/commands/npm-hook.md
+++ b/deps/npm/docs/content/commands/npm-hook.md
@@ -6,10 +6,6 @@ description: Manage registry hooks
### Synopsis
-
-
-
-
```bash
npm hook add [--type=]
npm hook ls [pkg]
@@ -17,11 +13,6 @@ npm hook rm
npm hook update
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -94,9 +85,6 @@ $ npm hook rm id-deadbeef
### Configuration
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -104,9 +92,6 @@ $ npm hook rm id-deadbeef
The base URL of the npm registry.
-
-
-
#### `otp`
* Default: null
@@ -118,11 +103,6 @@ when publishing or changing package permissions with `npm access`.
If not set, and a registry response fails with a challenge for a one-time
password, npm will prompt on the command line for one.
-
-
-
-
-
### See Also
* ["Introducing Hooks" blog post](https://blog.npmjs.org/post/145260155635/introducing-hooks-get-notifications-of-npm)
diff --git a/deps/npm/docs/content/commands/npm-init.md b/deps/npm/docs/content/commands/npm-init.md
index f3124a7768dfce..cf8bb3936acea5 100644
--- a/deps/npm/docs/content/commands/npm-init.md
+++ b/deps/npm/docs/content/commands/npm-init.md
@@ -6,10 +6,6 @@ description: Create a package.json file
### Synopsis
-
-
-
-
```bash
npm init (same as `npx )
npm init <@scope> (same as `npx <@scope>/create`)
@@ -17,11 +13,6 @@ npm init <@scope> (same as `npx <@scope>/create`)
aliases: create, innit
```
-
-
-
-
-
### Description
`npm init ` can be used to set up a new or existing npm
@@ -165,9 +156,6 @@ dot to represent the current directory in that context, e.g: `react-app .`:
### Configuration
-
-
-
#### `yes`
* Default: null
@@ -176,9 +164,6 @@ dot to represent the current directory in that context, e.g: `react-app .`:
Automatically answer "yes" to any prompts that npm might print on the
command line.
-
-
-
#### `force`
* Default: false
@@ -205,9 +190,6 @@ mistakes, unnecessary performance degradation, and malicious input.
If you don't have a clear idea of what you want to do, it is strongly
recommended that you do not use this option!
-
-
-
#### `scope`
* Default: the scope of the current project, if any, or ""
@@ -238,9 +220,6 @@ npm init --scope=@foo --yes
```
-
-
-
#### `workspace`
* Default:
@@ -263,9 +242,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -284,9 +260,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces-update`
* Default: true
@@ -295,9 +268,6 @@ This value is not exported to the environment for child processes.
If set to true, the npm cli will run an update after operations that may
possibly change the workspaces installed to the `node_modules` folder.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -311,11 +281,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
-
-
### See Also
* [package spec](/using-npm/package-spec)
diff --git a/deps/npm/docs/content/commands/npm-install-ci-test.md b/deps/npm/docs/content/commands/npm-install-ci-test.md
index b886f8ab9599ad..c6c7f2196da2e5 100644
--- a/deps/npm/docs/content/commands/npm-install-ci-test.md
+++ b/deps/npm/docs/content/commands/npm-install-ci-test.md
@@ -6,30 +6,18 @@ description: Install a project with a clean slate and run tests
### Synopsis
-
-
-
-
```bash
npm install-ci-test
alias: cit
```
-
-
-
-
-
### Description
This command runs `npm ci` followed immediately by `npm test`.
### Configuration
-
-
-
#### `save`
* Default: `true` unless when using `npm update` where it defaults to `false`
@@ -42,9 +30,6 @@ When used with the `npm rm` command, removes the dependency from
Will also prevent writing to `package-lock.json` if set to `false`.
-
-
-
#### `save-exact`
* Default: false
@@ -53,9 +38,6 @@ Will also prevent writing to `package-lock.json` if set to `false`.
Dependencies saved to package.json will be configured with an exact version
rather than using npm's default semver range operator.
-
-
-
#### `global`
* Default: false
@@ -70,9 +52,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
#### `global-style`
* Default: false
@@ -85,9 +64,6 @@ on will be flattened in their `node_modules` folders. This obviously will
eliminate some deduping. If used with `legacy-bundling`, `legacy-bundling`
will be preferred.
-
-
-
#### `legacy-bundling`
* Default: false
@@ -98,9 +74,6 @@ such as the one included with node 0.8, can install the package. This
eliminates all automatic deduping. If used with `global-style` this option
will be preferred.
-
-
-
#### `omit`
* Default: 'dev' if the `NODE_ENV` environment variable is set to
@@ -119,9 +92,6 @@ it will be included.
If the resulting omit list includes `'dev'`, then the `NODE_ENV` environment
variable will be set to `'production'` for all lifecycle scripts.
-
-
-
#### `strict-peer-deps`
* Default: false
@@ -141,9 +111,6 @@ When such and override is performed, a warning is printed, explaining the
conflict and the packages involved. If `--strict-peer-deps` is set, then
this warning is treated as a failure.
-
-
-
#### `package-lock`
* Default: true
@@ -154,9 +121,6 @@ will also prevent _writing_ `package-lock.json` if `save` is true.
This configuration does not affect `npm ci`.
-
-
-
#### `foreground-scripts`
* Default: false
@@ -169,9 +133,6 @@ input, output, and error with the main npm process.
Note that this will generally make installs run slower, and be much noisier,
but can be useful for debugging.
-
-
-
#### `ignore-scripts`
* Default: false
@@ -184,9 +145,6 @@ Note that commands explicitly intended to run a particular script, such as
will still run their intended script if `ignore-scripts` is set, but they
will *not* run any pre- or post-scripts.
-
-
-
#### `audit`
* Default: true
@@ -197,9 +155,6 @@ default registry and all registries configured for scopes. See the
documentation for [`npm audit`](/commands/npm-audit) for details on what is
submitted.
-
-
-
#### `bin-links`
* Default: true
@@ -212,9 +167,6 @@ Set to false to have it not do this. This can be used to work around the
fact that some file systems don't support symlinks, even on ostensibly Unix
systems.
-
-
-
#### `fund`
* Default: true
@@ -224,9 +176,6 @@ When "true" displays the message at the end of each `npm install`
acknowledging the number of dependencies looking for funding. See [`npm
fund`](/commands/npm-fund) for details.
-
-
-
#### `dry-run`
* Default: false
@@ -240,9 +189,6 @@ commands that modify your local installation, eg, `install`, `update`,
Note: This is NOT honored by other network related commands, eg `dist-tags`,
`owner`, etc.
-
-
-
#### `workspace`
* Default:
@@ -265,9 +211,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -286,9 +229,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -302,9 +242,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
#### `install-links`
* Default: false
@@ -314,11 +251,6 @@ When set file: protocol dependencies that exist outside of the project root
will be packed and installed as regular dependencies instead of creating a
symlink. This option has no effect on workspaces.
-
-
-
-
-
### See Also
* [npm install-test](/commands/npm-install-test)
diff --git a/deps/npm/docs/content/commands/npm-install-test.md b/deps/npm/docs/content/commands/npm-install-test.md
index d27686e731ce16..aa1ff35bc45892 100644
--- a/deps/npm/docs/content/commands/npm-install-test.md
+++ b/deps/npm/docs/content/commands/npm-install-test.md
@@ -6,21 +6,12 @@ description: Install package(s) and run tests
### Synopsis
-
-
-
-
```bash
npm install-test [ ...]
alias: it
```
-
-
-
-
-
### Description
This command runs an `npm install` followed immediately by an `npm test`. It
@@ -28,9 +19,6 @@ takes exactly the same arguments as `npm install`.
### Configuration
-
-
-
#### `save`
* Default: `true` unless when using `npm update` where it defaults to `false`
@@ -43,9 +31,6 @@ When used with the `npm rm` command, removes the dependency from
Will also prevent writing to `package-lock.json` if set to `false`.
-
-
-
#### `save-exact`
* Default: false
@@ -54,9 +39,6 @@ Will also prevent writing to `package-lock.json` if set to `false`.
Dependencies saved to package.json will be configured with an exact version
rather than using npm's default semver range operator.
-
-
-
#### `global`
* Default: false
@@ -71,9 +53,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
#### `global-style`
* Default: false
@@ -86,9 +65,6 @@ on will be flattened in their `node_modules` folders. This obviously will
eliminate some deduping. If used with `legacy-bundling`, `legacy-bundling`
will be preferred.
-
-
-
#### `legacy-bundling`
* Default: false
@@ -99,9 +75,6 @@ such as the one included with node 0.8, can install the package. This
eliminates all automatic deduping. If used with `global-style` this option
will be preferred.
-
-
-
#### `omit`
* Default: 'dev' if the `NODE_ENV` environment variable is set to
@@ -120,9 +93,6 @@ it will be included.
If the resulting omit list includes `'dev'`, then the `NODE_ENV` environment
variable will be set to `'production'` for all lifecycle scripts.
-
-
-
#### `strict-peer-deps`
* Default: false
@@ -142,9 +112,6 @@ When such and override is performed, a warning is printed, explaining the
conflict and the packages involved. If `--strict-peer-deps` is set, then
this warning is treated as a failure.
-
-
-
#### `package-lock`
* Default: true
@@ -155,9 +122,6 @@ will also prevent _writing_ `package-lock.json` if `save` is true.
This configuration does not affect `npm ci`.
-
-
-
#### `foreground-scripts`
* Default: false
@@ -170,9 +134,6 @@ input, output, and error with the main npm process.
Note that this will generally make installs run slower, and be much noisier,
but can be useful for debugging.
-
-
-
#### `ignore-scripts`
* Default: false
@@ -185,9 +146,6 @@ Note that commands explicitly intended to run a particular script, such as
will still run their intended script if `ignore-scripts` is set, but they
will *not* run any pre- or post-scripts.
-
-
-
#### `audit`
* Default: true
@@ -198,9 +156,6 @@ default registry and all registries configured for scopes. See the
documentation for [`npm audit`](/commands/npm-audit) for details on what is
submitted.
-
-
-
#### `bin-links`
* Default: true
@@ -213,9 +168,6 @@ Set to false to have it not do this. This can be used to work around the
fact that some file systems don't support symlinks, even on ostensibly Unix
systems.
-
-
-
#### `fund`
* Default: true
@@ -225,9 +177,6 @@ When "true" displays the message at the end of each `npm install`
acknowledging the number of dependencies looking for funding. See [`npm
fund`](/commands/npm-fund) for details.
-
-
-
#### `dry-run`
* Default: false
@@ -241,9 +190,6 @@ commands that modify your local installation, eg, `install`, `update`,
Note: This is NOT honored by other network related commands, eg `dist-tags`,
`owner`, etc.
-
-
-
#### `workspace`
* Default:
@@ -266,9 +212,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -287,9 +230,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -303,9 +243,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
#### `install-links`
* Default: false
@@ -315,11 +252,6 @@ When set file: protocol dependencies that exist outside of the project root
will be packed and installed as regular dependencies instead of creating a
symlink. This option has no effect on workspaces.
-
-
-
-
-
### See Also
* [npm install](/commands/npm-install)
diff --git a/deps/npm/docs/content/commands/npm-install.md b/deps/npm/docs/content/commands/npm-install.md
index 35e0df22777336..dc935de70aaf0f 100644
--- a/deps/npm/docs/content/commands/npm-install.md
+++ b/deps/npm/docs/content/commands/npm-install.md
@@ -6,21 +6,12 @@ description: Install a package
### Synopsis
-
-
-
-
```bash
npm install [ ...]
aliases: add, i, in, ins, inst, insta, instal, isnt, isnta, isntal, isntall
```
-
-
-
-
-
### Description
This command installs a package and any packages that it depends on. If the
@@ -418,9 +409,6 @@ does.
These are some of the most common options related to installation.
-
-
-
#### `save`
* Default: `true` unless when using `npm update` where it defaults to `false`
@@ -433,9 +421,6 @@ When used with the `npm rm` command, removes the dependency from
Will also prevent writing to `package-lock.json` if set to `false`.
-
-
-
#### `save-exact`
* Default: false
@@ -444,9 +429,6 @@ Will also prevent writing to `package-lock.json` if set to `false`.
Dependencies saved to package.json will be configured with an exact version
rather than using npm's default semver range operator.
-
-
-
#### `global`
* Default: false
@@ -461,9 +443,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
#### `global-style`
* Default: false
@@ -476,9 +455,6 @@ on will be flattened in their `node_modules` folders. This obviously will
eliminate some deduping. If used with `legacy-bundling`, `legacy-bundling`
will be preferred.
-
-
-
#### `legacy-bundling`
* Default: false
@@ -489,9 +465,6 @@ such as the one included with node 0.8, can install the package. This
eliminates all automatic deduping. If used with `global-style` this option
will be preferred.
-
-
-
#### `omit`
* Default: 'dev' if the `NODE_ENV` environment variable is set to
@@ -510,9 +483,6 @@ it will be included.
If the resulting omit list includes `'dev'`, then the `NODE_ENV` environment
variable will be set to `'production'` for all lifecycle scripts.
-
-
-
#### `strict-peer-deps`
* Default: false
@@ -532,9 +502,6 @@ When such and override is performed, a warning is printed, explaining the
conflict and the packages involved. If `--strict-peer-deps` is set, then
this warning is treated as a failure.
-
-
-
#### `package-lock`
* Default: true
@@ -545,9 +512,6 @@ will also prevent _writing_ `package-lock.json` if `save` is true.
This configuration does not affect `npm ci`.
-
-
-
#### `foreground-scripts`
* Default: false
@@ -560,9 +524,6 @@ input, output, and error with the main npm process.
Note that this will generally make installs run slower, and be much noisier,
but can be useful for debugging.
-
-
-
#### `ignore-scripts`
* Default: false
@@ -575,9 +536,6 @@ Note that commands explicitly intended to run a particular script, such as
will still run their intended script if `ignore-scripts` is set, but they
will *not* run any pre- or post-scripts.
-
-
-
#### `audit`
* Default: true
@@ -588,9 +546,6 @@ default registry and all registries configured for scopes. See the
documentation for [`npm audit`](/commands/npm-audit) for details on what is
submitted.
-
-
-
#### `bin-links`
* Default: true
@@ -603,9 +558,6 @@ Set to false to have it not do this. This can be used to work around the
fact that some file systems don't support symlinks, even on ostensibly Unix
systems.
-
-
-
#### `fund`
* Default: true
@@ -615,9 +567,6 @@ When "true" displays the message at the end of each `npm install`
acknowledging the number of dependencies looking for funding. See [`npm
fund`](/commands/npm-fund) for details.
-
-
-
#### `dry-run`
* Default: false
@@ -631,9 +580,6 @@ commands that modify your local installation, eg, `install`, `update`,
Note: This is NOT honored by other network related commands, eg `dist-tags`,
`owner`, etc.
-
-
-
#### `workspace`
* Default:
@@ -656,9 +602,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -677,9 +620,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -693,9 +633,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
#### `install-links`
* Default: false
@@ -705,11 +642,6 @@ When set file: protocol dependencies that exist outside of the project root
will be packed and installed as regular dependencies instead of creating a
symlink. This option has no effect on workspaces.
-
-
-
-
-
### Algorithm
Given a `package{dep}` structure: `A{B,C}, B{C}, C{D}`,
diff --git a/deps/npm/docs/content/commands/npm-link.md b/deps/npm/docs/content/commands/npm-link.md
index 8c1b422493bd57..07917bc833003b 100644
--- a/deps/npm/docs/content/commands/npm-link.md
+++ b/deps/npm/docs/content/commands/npm-link.md
@@ -6,21 +6,12 @@ description: Symlink a package folder
### Synopsis
-
-
-
-
```bash
npm link []
alias: ln
```
-
-
-
-
-
### Description
This is handy for installing your own stuff, so that you can work on it and
@@ -119,9 +110,6 @@ workspace(s).
### Configuration
-
-
-
#### `save`
* Default: `true` unless when using `npm update` where it defaults to `false`
@@ -134,9 +122,6 @@ When used with the `npm rm` command, removes the dependency from
Will also prevent writing to `package-lock.json` if set to `false`.
-
-
-
#### `save-exact`
* Default: false
@@ -145,9 +130,6 @@ Will also prevent writing to `package-lock.json` if set to `false`.
Dependencies saved to package.json will be configured with an exact version
rather than using npm's default semver range operator.
-
-
-
#### `global`
* Default: false
@@ -162,9 +144,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
#### `global-style`
* Default: false
@@ -177,9 +156,6 @@ on will be flattened in their `node_modules` folders. This obviously will
eliminate some deduping. If used with `legacy-bundling`, `legacy-bundling`
will be preferred.
-
-
-
#### `legacy-bundling`
* Default: false
@@ -190,9 +166,6 @@ such as the one included with node 0.8, can install the package. This
eliminates all automatic deduping. If used with `global-style` this option
will be preferred.
-
-
-
#### `strict-peer-deps`
* Default: false
@@ -212,9 +185,6 @@ When such and override is performed, a warning is printed, explaining the
conflict and the packages involved. If `--strict-peer-deps` is set, then
this warning is treated as a failure.
-
-
-
#### `package-lock`
* Default: true
@@ -225,9 +195,6 @@ will also prevent _writing_ `package-lock.json` if `save` is true.
This configuration does not affect `npm ci`.
-
-
-
#### `omit`
* Default: 'dev' if the `NODE_ENV` environment variable is set to
@@ -246,9 +213,6 @@ it will be included.
If the resulting omit list includes `'dev'`, then the `NODE_ENV` environment
variable will be set to `'production'` for all lifecycle scripts.
-
-
-
#### `ignore-scripts`
* Default: false
@@ -261,9 +225,6 @@ Note that commands explicitly intended to run a particular script, such as
will still run their intended script if `ignore-scripts` is set, but they
will *not* run any pre- or post-scripts.
-
-
-
#### `audit`
* Default: true
@@ -274,9 +235,6 @@ default registry and all registries configured for scopes. See the
documentation for [`npm audit`](/commands/npm-audit) for details on what is
submitted.
-
-
-
#### `bin-links`
* Default: true
@@ -289,9 +247,6 @@ Set to false to have it not do this. This can be used to work around the
fact that some file systems don't support symlinks, even on ostensibly Unix
systems.
-
-
-
#### `fund`
* Default: true
@@ -301,9 +256,6 @@ When "true" displays the message at the end of each `npm install`
acknowledging the number of dependencies looking for funding. See [`npm
fund`](/commands/npm-fund) for details.
-
-
-
#### `dry-run`
* Default: false
@@ -317,9 +269,6 @@ commands that modify your local installation, eg, `install`, `update`,
Note: This is NOT honored by other network related commands, eg `dist-tags`,
`owner`, etc.
-
-
-
#### `workspace`
* Default:
@@ -342,9 +291,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -363,9 +309,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -379,9 +322,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
#### `install-links`
* Default: false
@@ -391,11 +331,6 @@ When set file: protocol dependencies that exist outside of the project root
will be packed and installed as regular dependencies instead of creating a
symlink. This option has no effect on workspaces.
-
-
-
-
-
### See Also
* [package spec](/using-npm/package-spec)
diff --git a/deps/npm/docs/content/commands/npm-logout.md b/deps/npm/docs/content/commands/npm-logout.md
index f0dd5cb856eaee..8ac3948f116d8a 100644
--- a/deps/npm/docs/content/commands/npm-logout.md
+++ b/deps/npm/docs/content/commands/npm-logout.md
@@ -6,19 +6,10 @@ description: Log out of the registry
### Synopsis
-
-
-
-
```bash
npm logout
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -36,9 +27,6 @@ connected to that scope, if set.
### Configuration
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -46,9 +34,6 @@ connected to that scope, if set.
The base URL of the npm registry.
-
-
-
#### `scope`
* Default: the scope of the current project, if any, or ""
@@ -79,11 +64,6 @@ npm init --scope=@foo --yes
```
-
-
-
-
-
### See Also
* [npm adduser](/commands/npm-adduser)
diff --git a/deps/npm/docs/content/commands/npm-ls.md b/deps/npm/docs/content/commands/npm-ls.md
index a7936fafc72a2c..43d4eb7d6791cb 100644
--- a/deps/npm/docs/content/commands/npm-ls.md
+++ b/deps/npm/docs/content/commands/npm-ls.md
@@ -6,21 +6,12 @@ description: List installed packages
### Synopsis
-
-
-
-
```bash
npm ls
alias: list
```
-
-
-
-
-
### Description
This command will print to stdout all the versions of packages that are
@@ -36,7 +27,7 @@ packages will *also* show the paths to the specified packages. For
example, running `npm ls promzard` in npm's source tree will show:
```bash
-npm@@VERSION@ /path/to/npm
+npm@8.19.3 /path/to/npm
└─┬ init-package-json@0.0.4
└── promzard@0.1.5
```
@@ -82,9 +73,6 @@ least the default human-readable `npm ls` output in npm v8.
### Configuration
-
-
-
#### `all`
* Default: false
@@ -94,9 +82,6 @@ When running `npm outdated` and `npm ls`, setting `--all` will show all
outdated or installed packages, rather than only those directly depended
upon by the current project.
-
-
-
#### `json`
* Default: false
@@ -109,9 +94,6 @@ Whether or not to output JSON data, rather than the normal output.
Not supported by all npm commands.
-
-
-
#### `long`
* Default: false
@@ -119,9 +101,6 @@ Not supported by all npm commands.
Show extended information in `ls`, `search`, and `help-search`.
-
-
-
#### `parseable`
* Default: false
@@ -130,9 +109,6 @@ Show extended information in `ls`, `search`, and `help-search`.
Output parseable results from commands that write to standard output. For
`npm search`, this will be tab-separated table format.
-
-
-
#### `global`
* Default: false
@@ -147,9 +123,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
#### `depth`
* Default: `Infinity` if `--all` is set, otherwise `1`
@@ -160,9 +133,6 @@ The depth to go when recursing packages for `npm ls`.
If not set, `npm ls` will show only the immediate dependencies of the root
project. If `--all` is set, then npm will show all dependencies by default.
-
-
-
#### `omit`
* Default: 'dev' if the `NODE_ENV` environment variable is set to
@@ -181,9 +151,6 @@ it will be included.
If the resulting omit list includes `'dev'`, then the `NODE_ENV` environment
variable will be set to `'production'` for all lifecycle scripts.
-
-
-
#### `link`
* Default: false
@@ -191,9 +158,6 @@ variable will be set to `'production'` for all lifecycle scripts.
Used with `npm ls`, limiting output to only those packages that are linked.
-
-
-
#### `package-lock-only`
* Default: false
@@ -208,9 +172,6 @@ instead of checking `node_modules` and downloading dependencies.
For `list` this means the output will be based on the tree described by the
`package-lock.json`, rather than the contents of `node_modules`.
-
-
-
#### `unicode`
* Default: false on windows, true on mac/unix systems with a unicode locale,
@@ -220,9 +181,6 @@ For `list` this means the output will be based on the tree described by the
When set to true, npm uses unicode characters in the tree output. When
false, it uses ascii characters instead of unicode glyphs.
-
-
-
#### `workspace`
* Default:
@@ -245,9 +203,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -266,9 +221,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -282,9 +234,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
#### `install-links`
* Default: false
@@ -294,11 +243,6 @@ When set file: protocol dependencies that exist outside of the project root
will be packed and installed as regular dependencies instead of creating a
symlink. This option has no effect on workspaces.
-
-
-
-
-
### See Also
* [package spec](/using-npm/package-spec)
diff --git a/deps/npm/docs/content/commands/npm-org.md b/deps/npm/docs/content/commands/npm-org.md
index 975581c860df64..ca788b01fcb966 100644
--- a/deps/npm/docs/content/commands/npm-org.md
+++ b/deps/npm/docs/content/commands/npm-org.md
@@ -6,10 +6,6 @@ description: Manage orgs
### Synopsis
-
-
-
-
```bash
npm org set orgname username [developer | admin | owner]
npm org rm orgname username
@@ -18,11 +14,6 @@ npm org ls orgname []
alias: ogr
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Example
@@ -71,9 +62,6 @@ listing them, and finding specific ones and their roles.
### Configuration
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -81,9 +69,6 @@ listing them, and finding specific ones and their roles.
The base URL of the npm registry.
-
-
-
#### `otp`
* Default: null
@@ -95,9 +80,6 @@ when publishing or changing package permissions with `npm access`.
If not set, and a registry response fails with a challenge for a one-time
password, npm will prompt on the command line for one.
-
-
-
#### `json`
* Default: false
@@ -110,9 +92,6 @@ Whether or not to output JSON data, rather than the normal output.
Not supported by all npm commands.
-
-
-
#### `parseable`
* Default: false
@@ -121,11 +100,6 @@ Not supported by all npm commands.
Output parseable results from commands that write to standard output. For
`npm search`, this will be tab-separated table format.
-
-
-
-
-
### See Also
* [using orgs](/using-npm/orgs)
diff --git a/deps/npm/docs/content/commands/npm-outdated.md b/deps/npm/docs/content/commands/npm-outdated.md
index c4e07a0cd36f02..0e1061ab168aea 100644
--- a/deps/npm/docs/content/commands/npm-outdated.md
+++ b/deps/npm/docs/content/commands/npm-outdated.md
@@ -6,19 +6,10 @@ description: Check for outdated packages
### Synopsis
-
-
-
-
```bash
npm outdated [ ...]
```
-
-
-
-
-
### Description
This command will check the registry to see if any (or, specific) installed
@@ -95,9 +86,6 @@ A few things to note:
### Configuration
-
-
-
#### `all`
* Default: false
@@ -107,9 +95,6 @@ When running `npm outdated` and `npm ls`, setting `--all` will show all
outdated or installed packages, rather than only those directly depended
upon by the current project.
-
-
-
#### `json`
* Default: false
@@ -122,9 +107,6 @@ Whether or not to output JSON data, rather than the normal output.
Not supported by all npm commands.
-
-
-
#### `long`
* Default: false
@@ -132,9 +114,6 @@ Not supported by all npm commands.
Show extended information in `ls`, `search`, and `help-search`.
-
-
-
#### `parseable`
* Default: false
@@ -143,9 +122,6 @@ Show extended information in `ls`, `search`, and `help-search`.
Output parseable results from commands that write to standard output. For
`npm search`, this will be tab-separated table format.
-
-
-
#### `global`
* Default: false
@@ -160,9 +136,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
#### `workspace`
* Default:
@@ -185,11 +158,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
-
-
### See Also
* [package spec](/using-npm/package-spec)
diff --git a/deps/npm/docs/content/commands/npm-owner.md b/deps/npm/docs/content/commands/npm-owner.md
index ebc29ef6939392..c5bace6b2bcc94 100644
--- a/deps/npm/docs/content/commands/npm-owner.md
+++ b/deps/npm/docs/content/commands/npm-owner.md
@@ -6,10 +6,6 @@ description: Manage package owners
### Synopsis
-
-
-
-
```bash
npm owner add
npm owner rm
@@ -18,11 +14,6 @@ npm owner ls
alias: author
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -46,9 +37,6 @@ on the command line when changing ownership with `--otp`.
### Configuration
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -56,9 +44,6 @@ on the command line when changing ownership with `--otp`.
The base URL of the npm registry.
-
-
-
#### `otp`
* Default: null
@@ -70,9 +55,6 @@ when publishing or changing package permissions with `npm access`.
If not set, and a registry response fails with a challenge for a one-time
password, npm will prompt on the command line for one.
-
-
-
#### `workspace`
* Default:
@@ -95,9 +77,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -116,11 +95,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
-
-
### See Also
* [package spec](/using-npm/package-spec)
diff --git a/deps/npm/docs/content/commands/npm-pack.md b/deps/npm/docs/content/commands/npm-pack.md
index 7921042eae8fe0..a39f0554391991 100644
--- a/deps/npm/docs/content/commands/npm-pack.md
+++ b/deps/npm/docs/content/commands/npm-pack.md
@@ -6,24 +6,12 @@ description: Create a tarball from a package
### Synopsis
-
-
-
-
```bash
npm pack
```
-
-
-
-
-
### Configuration
-
-
-
#### `dry-run`
* Default: false
@@ -37,9 +25,6 @@ commands that modify your local installation, eg, `install`, `update`,
Note: This is NOT honored by other network related commands, eg `dist-tags`,
`owner`, etc.
-
-
-
#### `json`
* Default: false
@@ -52,9 +37,6 @@ Whether or not to output JSON data, rather than the normal output.
Not supported by all npm commands.
-
-
-
#### `pack-destination`
* Default: "."
@@ -62,9 +44,6 @@ Not supported by all npm commands.
Directory in which `npm pack` will save tarballs.
-
-
-
#### `workspace`
* Default:
@@ -87,9 +66,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -108,9 +84,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -124,11 +97,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
-
-
### Description
For anything that's installable (that is, a package folder, tarball,
diff --git a/deps/npm/docs/content/commands/npm-ping.md b/deps/npm/docs/content/commands/npm-ping.md
index 161d7292f8c977..812be9f002deb8 100644
--- a/deps/npm/docs/content/commands/npm-ping.md
+++ b/deps/npm/docs/content/commands/npm-ping.md
@@ -6,19 +6,10 @@ description: Ping npm registry
### Synopsis
-
-
-
-
```bash
npm ping
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -39,9 +30,6 @@ npm ERR! 404 Not Found - GET http://www.foo.com/-/ping?write=true
### Configuration
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -49,11 +37,6 @@ npm ERR! 404 Not Found - GET http://www.foo.com/-/ping?write=true
The base URL of the npm registry.
-
-
-
-
-
### See Also
* [npm doctor](/commands/npm-doctor)
diff --git a/deps/npm/docs/content/commands/npm-pkg.md b/deps/npm/docs/content/commands/npm-pkg.md
index deff7e82c694dd..519104457df79e 100644
--- a/deps/npm/docs/content/commands/npm-pkg.md
+++ b/deps/npm/docs/content/commands/npm-pkg.md
@@ -6,10 +6,6 @@ description: Manages your package.json
### Synopsis
-
-
-
-
```bash
npm pkg set = [= ...]
npm pkg get [ [ ...]]
@@ -18,11 +14,6 @@ npm pkg set [[].= ...]
npm pkg set [[].= ...]
```
-
-
-
-
-
### Description
A command that automates the management of `package.json` files.
@@ -183,9 +174,6 @@ npm pkg get name version --ws
### Configuration
-
-
-
#### `force`
* Default: false
@@ -212,9 +200,6 @@ mistakes, unnecessary performance degradation, and malicious input.
If you don't have a clear idea of what you want to do, it is strongly
recommended that you do not use this option!
-
-
-
#### `json`
* Default: false
@@ -227,9 +212,6 @@ Whether or not to output JSON data, rather than the normal output.
Not supported by all npm commands.
-
-
-
#### `workspace`
* Default:
@@ -252,9 +234,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -272,11 +251,6 @@ other things (test, exec, publish, etc.) will operate on the root project,
_unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
-
-
## See Also
* [npm install](/commands/npm-install)
diff --git a/deps/npm/docs/content/commands/npm-prefix.md b/deps/npm/docs/content/commands/npm-prefix.md
index 39328bcc88a143..2711501625db0b 100644
--- a/deps/npm/docs/content/commands/npm-prefix.md
+++ b/deps/npm/docs/content/commands/npm-prefix.md
@@ -6,19 +6,10 @@ description: Display prefix
### Synopsis
-
-
-
-
```bash
npm prefix [-g]
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -44,9 +35,6 @@ npm prefix -g
### Configuration
-
-
-
#### `global`
* Default: false
@@ -61,11 +49,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
-
-
### See Also
* [npm root](/commands/npm-root)
diff --git a/deps/npm/docs/content/commands/npm-profile.md b/deps/npm/docs/content/commands/npm-profile.md
index af1f9d8aa10633..b8cdde7e151a63 100644
--- a/deps/npm/docs/content/commands/npm-profile.md
+++ b/deps/npm/docs/content/commands/npm-profile.md
@@ -6,10 +6,6 @@ description: Change settings on your registry profile
### Synopsis
-
-
-
-
```bash
npm profile enable-2fa [auth-only|auth-and-writes]
npm profile disable-2fa
@@ -17,11 +13,6 @@ npm profile get []
npm profile set
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -83,9 +74,6 @@ Some of these commands may not be available on non npmjs.com registries.
### Configuration
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -93,9 +81,6 @@ Some of these commands may not be available on non npmjs.com registries.
The base URL of the npm registry.
-
-
-
#### `json`
* Default: false
@@ -108,9 +93,6 @@ Whether or not to output JSON data, rather than the normal output.
Not supported by all npm commands.
-
-
-
#### `parseable`
* Default: false
@@ -119,9 +101,6 @@ Not supported by all npm commands.
Output parseable results from commands that write to standard output. For
`npm search`, this will be tab-separated table format.
-
-
-
#### `otp`
* Default: null
@@ -133,11 +112,6 @@ when publishing or changing package permissions with `npm access`.
If not set, and a registry response fails with a challenge for a one-time
password, npm will prompt on the command line for one.
-
-
-
-
-
### See Also
* [npm adduser](/commands/npm-adduser)
diff --git a/deps/npm/docs/content/commands/npm-prune.md b/deps/npm/docs/content/commands/npm-prune.md
index 28f02f6add1908..95946d9dc969ca 100644
--- a/deps/npm/docs/content/commands/npm-prune.md
+++ b/deps/npm/docs/content/commands/npm-prune.md
@@ -6,19 +6,10 @@ description: Remove extraneous packages
### Synopsis
-
-
-
-
```bash
npm prune [[<@scope>/]...]
```
-
-
-
-
-
### Description
This command removes "extraneous" packages. If a package name is provided,
@@ -44,9 +35,6 @@ this command can help clean up any resulting garbage.
### Configuration
-
-
-
#### `omit`
* Default: 'dev' if the `NODE_ENV` environment variable is set to
@@ -65,9 +53,6 @@ it will be included.
If the resulting omit list includes `'dev'`, then the `NODE_ENV` environment
variable will be set to `'production'` for all lifecycle scripts.
-
-
-
#### `dry-run`
* Default: false
@@ -81,9 +66,6 @@ commands that modify your local installation, eg, `install`, `update`,
Note: This is NOT honored by other network related commands, eg `dist-tags`,
`owner`, etc.
-
-
-
#### `json`
* Default: false
@@ -96,9 +78,6 @@ Whether or not to output JSON data, rather than the normal output.
Not supported by all npm commands.
-
-
-
#### `foreground-scripts`
* Default: false
@@ -111,9 +90,6 @@ input, output, and error with the main npm process.
Note that this will generally make installs run slower, and be much noisier,
but can be useful for debugging.
-
-
-
#### `ignore-scripts`
* Default: false
@@ -126,9 +102,6 @@ Note that commands explicitly intended to run a particular script, such as
will still run their intended script if `ignore-scripts` is set, but they
will *not* run any pre- or post-scripts.
-
-
-
#### `workspace`
* Default:
@@ -151,9 +124,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -172,9 +142,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -188,9 +155,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
#### `install-links`
* Default: false
@@ -200,11 +164,6 @@ When set file: protocol dependencies that exist outside of the project root
will be packed and installed as regular dependencies instead of creating a
symlink. This option has no effect on workspaces.
-
-
-
-
-
### See Also
* [npm uninstall](/commands/npm-uninstall)
diff --git a/deps/npm/docs/content/commands/npm-publish.md b/deps/npm/docs/content/commands/npm-publish.md
index 536d04988e6849..4963cf158a660d 100644
--- a/deps/npm/docs/content/commands/npm-publish.md
+++ b/deps/npm/docs/content/commands/npm-publish.md
@@ -6,19 +6,10 @@ description: Publish a package
### Synopsis
-
-
-
-
```bash
npm publish
```
-
-
-
-
-
### Description
Publishes a package to the registry so that it can be installed by name.
@@ -96,9 +87,6 @@ built.
### Configuration
-
-
-
#### `tag`
* Default: "latest"
@@ -113,9 +101,6 @@ command, if no explicit tag is given.
When used by the `npm diff` command, this is the tag used to fetch the
tarball that will be compared with the local files by default.
-
-
-
#### `access`
* Default: 'restricted' for scoped packages, 'public' for unscoped packages
@@ -132,9 +117,6 @@ subsequent `npm publish` commands using the `--access` flag will not have an
effect to the access level. To make changes to the access level after the
initial publish use `npm access`.
-
-
-
#### `dry-run`
* Default: false
@@ -148,9 +130,6 @@ commands that modify your local installation, eg, `install`, `update`,
Note: This is NOT honored by other network related commands, eg `dist-tags`,
`owner`, etc.
-
-
-
#### `otp`
* Default: null
@@ -162,9 +141,6 @@ when publishing or changing package permissions with `npm access`.
If not set, and a registry response fails with a challenge for a one-time
password, npm will prompt on the command line for one.
-
-
-
#### `workspace`
* Default:
@@ -187,9 +163,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -208,9 +181,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -224,11 +194,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
-
-
### See Also
* [package spec](/using-npm/package-spec)
diff --git a/deps/npm/docs/content/commands/npm-query.md b/deps/npm/docs/content/commands/npm-query.md
index 3c35e9ab4271cf..5a6bfb79cee331 100644
--- a/deps/npm/docs/content/commands/npm-query.md
+++ b/deps/npm/docs/content/commands/npm-query.md
@@ -6,19 +6,10 @@ description: Dependency selector query
### Synopsis
-
-
-
-
```bash
npm query
```
-
-
-
-
-
### Description
The `npm query` command allows for usage of css selectors in order to retrieve
@@ -147,9 +138,6 @@ npm query ":type(git)" | jq 'map(.name)' | xargs -I {} npm why {}
### Configuration
-
-
-
#### `global`
* Default: false
@@ -164,9 +152,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
#### `workspace`
* Default:
@@ -189,9 +174,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -210,9 +192,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -225,11 +204,6 @@ all workspaces via the `workspaces` flag, will cause npm to operate only on
the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
-
-
## See Also
* [dependency selectors](/using-npm/dependency-selectors)
diff --git a/deps/npm/docs/content/commands/npm-rebuild.md b/deps/npm/docs/content/commands/npm-rebuild.md
index 6a396421213d3d..75f1efe1b69641 100644
--- a/deps/npm/docs/content/commands/npm-rebuild.md
+++ b/deps/npm/docs/content/commands/npm-rebuild.md
@@ -6,21 +6,12 @@ description: Rebuild a package
### Synopsis
-
-
-
-
```bash
npm rebuild [] ...]
alias: rb
```
-
-
-
-
-
### Description
This command runs the `npm build` command on the matched folders. This is
@@ -34,9 +25,6 @@ name and version matching one of the specifiers will be rebuilt.
### Configuration
-
-
-
#### `global`
* Default: false
@@ -51,9 +39,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
#### `bin-links`
* Default: true
@@ -66,9 +51,6 @@ Set to false to have it not do this. This can be used to work around the
fact that some file systems don't support symlinks, even on ostensibly Unix
systems.
-
-
-
#### `foreground-scripts`
* Default: false
@@ -81,9 +63,6 @@ input, output, and error with the main npm process.
Note that this will generally make installs run slower, and be much noisier,
but can be useful for debugging.
-
-
-
#### `ignore-scripts`
* Default: false
@@ -96,9 +75,6 @@ Note that commands explicitly intended to run a particular script, such as
will still run their intended script if `ignore-scripts` is set, but they
will *not* run any pre- or post-scripts.
-
-
-
#### `workspace`
* Default:
@@ -121,9 +97,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -142,9 +115,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -158,9 +128,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
#### `install-links`
* Default: false
@@ -170,11 +137,6 @@ When set file: protocol dependencies that exist outside of the project root
will be packed and installed as regular dependencies instead of creating a
symlink. This option has no effect on workspaces.
-
-
-
-
-
### See Also
* [package spec](/using-npm/package-spec)
diff --git a/deps/npm/docs/content/commands/npm-repo.md b/deps/npm/docs/content/commands/npm-repo.md
index fc540a9382b235..eb55780de907aa 100644
--- a/deps/npm/docs/content/commands/npm-repo.md
+++ b/deps/npm/docs/content/commands/npm-repo.md
@@ -6,19 +6,10 @@ description: Open package repository page in the browser
### Synopsis
-
-
-
-
```bash
npm repo [ [ ...]]
```
-
-
-
-
-
### Description
This command tries to guess at the likely location of a package's
@@ -28,9 +19,6 @@ in the current folder and use the `repository` property.
### Configuration
-
-
-
#### `browser`
* Default: OS X: `"open"`, Windows: `"start"`, Others: `"xdg-open"`
@@ -43,9 +31,6 @@ terminal.
Set to `true` to use default system URL opener.
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -53,9 +38,6 @@ Set to `true` to use default system URL opener.
The base URL of the npm registry.
-
-
-
#### `workspace`
* Default:
@@ -78,9 +60,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -99,9 +78,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -115,11 +91,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
-
-
### See Also
* [npm docs](/commands/npm-docs)
diff --git a/deps/npm/docs/content/commands/npm-restart.md b/deps/npm/docs/content/commands/npm-restart.md
index 048bebb1659bd3..6c31cfceb51189 100644
--- a/deps/npm/docs/content/commands/npm-restart.md
+++ b/deps/npm/docs/content/commands/npm-restart.md
@@ -6,19 +6,10 @@ description: Restart a package
### Synopsis
-
-
-
-
```bash
npm restart [-- ]
```
-
-
-
-
-
### Description
This restarts a project. It is equivalent to running `npm run-script
@@ -45,9 +36,6 @@ If it does _not_ have a `"restart"` script specified, but it does have
### Configuration
-
-
-
#### `ignore-scripts`
* Default: false
@@ -60,9 +48,6 @@ Note that commands explicitly intended to run a particular script, such as
will still run their intended script if `ignore-scripts` is set, but they
will *not* run any pre- or post-scripts.
-
-
-
#### `script-shell`
* Default: '/bin/sh' on POSIX systems, 'cmd.exe' on Windows
@@ -71,11 +56,6 @@ will *not* run any pre- or post-scripts.
The shell to use for scripts run with the `npm exec`, `npm run` and `npm
init ` commands.
-
-
-
-
-
### See Also
* [npm run-script](/commands/npm-run-script)
diff --git a/deps/npm/docs/content/commands/npm-root.md b/deps/npm/docs/content/commands/npm-root.md
index 40b58e4b33d0b2..89195744c9d18d 100644
--- a/deps/npm/docs/content/commands/npm-root.md
+++ b/deps/npm/docs/content/commands/npm-root.md
@@ -6,19 +6,10 @@ description: Display npm root
### Synopsis
-
-
-
-
```bash
npm root
```
-
-
-
-
-
### Description
Print the effective `node_modules` folder to standard out.
@@ -34,9 +25,6 @@ echo "Global packages installed in: ${global_node_modules}"
### Configuration
-
-
-
#### `global`
* Default: false
@@ -51,11 +39,6 @@ folder instead of the current working directory. See
* bin files are linked to `{prefix}/bin`
* man pages are linked to `{prefix}/share/man`
-
-
-
-
-
### See Also
* [npm prefix](/commands/npm-prefix)
diff --git a/deps/npm/docs/content/commands/npm-run-script.md b/deps/npm/docs/content/commands/npm-run-script.md
index f606ec6bf59e5e..16a5c693f9ba25 100644
--- a/deps/npm/docs/content/commands/npm-run-script.md
+++ b/deps/npm/docs/content/commands/npm-run-script.md
@@ -6,21 +6,12 @@ description: Run arbitrary package scripts
### Synopsis
-
-
-
-
```bash
npm run-script [-- ]
aliases: run, rum, urn
```
-
-
-
-
-
### Description
This runs an arbitrary command from a package's `"scripts"` object. If no
@@ -143,9 +134,6 @@ packages.
### Configuration
-
-
-
#### `workspace`
* Default:
@@ -168,9 +156,6 @@ brand new workspace within the project.
This value is not exported to the environment for child processes.
-
-
-
#### `workspaces`
* Default: null
@@ -189,9 +174,6 @@ _unless_ one or more workspaces are specified in the `workspace` config.
This value is not exported to the environment for child processes.
-
-
-
#### `include-workspace-root`
* Default: false
@@ -205,9 +187,6 @@ the specified workspaces, and not on the root project.
This value is not exported to the environment for child processes.
-
-
-
#### `if-present`
* Default: false
@@ -222,9 +201,6 @@ CI setup.
This value is not exported to the environment for child processes.
-
-
-
#### `ignore-scripts`
* Default: false
@@ -237,9 +213,6 @@ Note that commands explicitly intended to run a particular script, such as
will still run their intended script if `ignore-scripts` is set, but they
will *not* run any pre- or post-scripts.
-
-
-
#### `foreground-scripts`
* Default: false
@@ -252,9 +225,6 @@ input, output, and error with the main npm process.
Note that this will generally make installs run slower, and be much noisier,
but can be useful for debugging.
-
-
-
#### `script-shell`
* Default: '/bin/sh' on POSIX systems, 'cmd.exe' on Windows
@@ -263,11 +233,6 @@ but can be useful for debugging.
The shell to use for scripts run with the `npm exec`, `npm run` and `npm
init ` commands.
-
-
-
-
-
### See Also
* [npm scripts](/using-npm/scripts)
diff --git a/deps/npm/docs/content/commands/npm-search.md b/deps/npm/docs/content/commands/npm-search.md
index 340dea9684d005..3e4fa4553957a7 100644
--- a/deps/npm/docs/content/commands/npm-search.md
+++ b/deps/npm/docs/content/commands/npm-search.md
@@ -6,21 +6,12 @@ description: Search for packages
### Synopsis
-
-
-
-
```bash
npm search [search terms ...]
aliases: find, s, se
```
-
-
-
-
-
Note: This command is unaware of workspaces.
### Description
@@ -48,9 +39,6 @@ expression characters in most shells.)
### Configuration
-
-
-
#### `long`
* Default: false
@@ -58,9 +46,6 @@ expression characters in most shells.)
Show extended information in `ls`, `search`, and `help-search`.
-
-
-
#### `json`
* Default: false
@@ -73,9 +58,6 @@ Whether or not to output JSON data, rather than the normal output.
Not supported by all npm commands.
-
-
-
#### `color`
* Default: true unless the NO_COLOR environ is set to something other than '0'
@@ -84,9 +66,6 @@ Not supported by all npm commands.
If false, never shows colors. If `"always"` then always shows colors. If
true, then only prints color codes for tty file descriptors.
-
-
-
#### `parseable`
* Default: false
@@ -95,9 +74,6 @@ true, then only prints color codes for tty file descriptors.
Output parseable results from commands that write to standard output. For
`npm search`, this will be tab-separated table format.
-
-
-
#### `description`
* Default: true
@@ -105,9 +81,6 @@ Output parseable results from commands that write to standard output. For
Show the description in `npm search`
-
-
-
#### `searchopts`
* Default: ""
@@ -115,9 +88,6 @@ Show the description in `npm search`
Space-separated options that are always passed to search.
-
-
-
#### `searchexclude`
* Default: ""
@@ -125,9 +95,6 @@ Space-separated options that are always passed to search.
Space-separated options that limit the results from search.
-
-
-
#### `registry`
* Default: "https://registry.npmjs.org/"
@@ -135,9 +102,6 @@ Space-separated options that limit the results from search.
The base URL of the npm registry.
-
-
-
#### `prefer-online`
* Default: false
@@ -146,9 +110,6 @@ The base URL of the npm registry.
If true, staleness checks for cached data will be forced, making the CLI
look for updates immediately even for fresh package data.
-
-
-
#### `prefer-offline`
* Default: false
@@ -158,9 +119,6 @@ If true, staleness checks for cached data will be bypassed, but missing data
will be requested from the server. To force full offline mode, use
`--offline`.
-
-
-
#### `offline`
* Default: false
@@ -169,11 +127,6 @@ will be requested from the server. To force full offline mode, use
Force offline mode: no network requests will be done during install. To
allow the CLI to fill in missing cache data, see `--prefer-offline`.
-
-
-
-
-
### See Also
* [npm registry](/using-npm/registry)
diff --git a/deps/npm/docs/content/commands/npm-set-script.md b/deps/npm/docs/content/commands/npm-set-script.md
index 8695b43f14423e..9bbf09ea9076ad 100644
--- a/deps/npm/docs/content/commands/npm-set-script.md
+++ b/deps/npm/docs/content/commands/npm-set-script.md
@@ -9,19 +9,10 @@ An npm command that lets you create a task in the `scripts` section of the `pack
Deprecated.
-
-
-
-
```bash
npm set-script [ |