feat(patch): add npm patch update to rebase a patch onto a new version

Author: manzoorwanijk

lib/commands/patch.js

@@ -12,6 +12,7 @@
         "@npmcli/arborist",
         "@npmcli/config",
         "@npmcli/fs",
+        "@npmcli/git",
         "@npmcli/map-workspaces",
         "@npmcli/metavuln-calculator",
         "@npmcli/package-json",
@@ -88,6 +89,7 @@
         "@npmcli/arborist": "^10.0.0-pre.0",
         "@npmcli/config": "^11.0.0-pre.0",
         "@npmcli/fs": "^5.0.0",
+        "@npmcli/git": "^7.0.2",
         "@npmcli/map-workspaces": "^5.0.3",
         "@npmcli/metavuln-calculator": "^9.0.3",
         "@npmcli/package-json": "^7.0.5",
@@ -158,7 +160,6 @@
       "devDependencies": {
         "@npmcli/docs": "^1.0.0",
         "@npmcli/eslint-config": "^5.1.0",
-        "@npmcli/git": "^7.0.2",
         "@npmcli/mock-globals": "^1.0.0",
         "@npmcli/mock-registry": "^1.0.0",
         "@npmcli/template-oss": "4.29.0",

package-lock.json

@@ -51,6 +51,7 @@
     "@npmcli/arborist": "^10.0.0-pre.0",
     "@npmcli/config": "^11.0.0-pre.0",
     "@npmcli/fs": "^5.0.0",
+    "@npmcli/git": "^7.0.2",
     "@npmcli/map-workspaces": "^5.0.3",
     "@npmcli/metavuln-calculator": "^9.0.3",
     "@npmcli/package-json": "^7.0.5",
@@ -119,6 +120,7 @@
     "@npmcli/arborist",
     "@npmcli/config",
     "@npmcli/fs",
+    "@npmcli/git",
     "@npmcli/map-workspaces",
     "@npmcli/metavuln-calculator",
     "@npmcli/package-json",
@@ -185,7 +187,6 @@
   "devDependencies": {
     "@npmcli/docs": "^1.0.0",
     "@npmcli/eslint-config": "^5.1.0",
-    "@npmcli/git": "^7.0.2",
     "@npmcli/mock-globals": "^1.0.0",
     "@npmcli/mock-registry": "^1.0.0",
     "@npmcli/template-oss": "4.29.0",

package.json

@@ -181,6 +181,7 @@ exports[`test/lib/commands/config.js TAP config list --json > output matches sna
   "strict-ssl": true,
   "tag-version-prefix": "v",
   "timing": false,
+  "to": null,
   "umask": 0,
   "unicode": false,
   "update-notifier": true,
@@ -374,6 +375,7 @@ strict-ssl = true
 ; tag = "latest" ; overridden by project
 tag-version-prefix = "v"
 timing = false
+to = null
 token-description = null
 umask = 0
 unicode = false

tap-snapshots/test/lib/commands/config.js.test.cjs

@@ -2074,6 +2074,17 @@ while still writing the timing file, use \`--silent\`.
 
 
 
+#### \`to\`
+
+* Default: null
+* Type: null or String
+
+Used by \`npm patch update\` to set the version to rebase a patch onto when it
+cannot be read from \`package-lock.json\` — for example an exact-version
+selector, or a version that has not been installed yet.
+
+
+
 #### \`token-description\`
 
 * Default: null
@@ -2650,6 +2661,7 @@ Array [
   "tag",
   "tag-version-prefix",
   "timing",
+  "to",
   "umask",
   "unicode",
   "update-notifier",
@@ -2852,6 +2864,7 @@ Array [
   "keep-edit-dir",
   "prefix",
   "timing",
+  "to",
   "update-notifier",
   "usage",
   "userconfig",
@@ -5336,12 +5349,13 @@ Usage:
 npm patch <pkg>[@<version>]
 npm patch add <pkg>[@<version>] [--edit-dir <path>] [--ignore-existing]
 npm patch commit <edit-dir> [--patches-dir <dir>] [--keep-edit-dir]
+npm patch update <pkg>[@<old-version>] [--to <new-version>] [--patches-dir <dir>]
 npm patch ls
 npm patch rm <pkg>[@<version>]
 
 Options:
 [--patches-dir <patches-dir>] [--allow-unused-patches] [--ignore-patch-failures]
-[--edit-dir <edit-dir>] [--ignore-existing] [--keep-edit-dir]
+[--edit-dir <edit-dir>] [--ignore-existing] [--keep-edit-dir] [--to <version>]
 [--registry <registry>]
 
   --patches-dir
@@ -5362,6 +5376,9 @@ Options:
   --keep-edit-dir
     With \`npm patch commit\`, do not remove the edit directory after
 
+  --to
+    Used by \`npm patch update\` to set the version to rebase a patch onto
+
   --registry
     The base URL of the npm registry.
 
@@ -5372,6 +5389,7 @@ Run "npm help patch" for more info
 npm patch <pkg>[@<version>]
 npm patch add <pkg>[@<version>] [--edit-dir <path>] [--ignore-existing]
 npm patch commit <edit-dir> [--patches-dir <dir>] [--keep-edit-dir]
+npm patch update <pkg>[@<old-version>] [--to <new-version>] [--patches-dir <dir>]
 npm patch ls
 npm patch rm <pkg>[@<version>]
 \`\`\`
@@ -5384,6 +5402,7 @@ Note: This command is unaware of workspaces.
 #### \`edit-dir\`
 #### \`ignore-existing\`
 #### \`keep-edit-dir\`
+#### \`to\`
 #### \`registry\`
 `