@pnpm/cli.parse-cli-args 1100.1.4 → 1100.1.6

package/CHANGELOG.md

@@ -0,0 +1,426 @@
+# @pnpm/parse-cli-args
+
+## 1100.1.6
+
+### Patch Changes
+
+- Options that follow `create`, `exec`, or `test` appearing as a subcommand of another command are now parsed instead of being silently treated as positional parameters. For example, `pnpm team create @org:team --registry <url>` previously ignored the `--registry` option and sent the request to the default registry.
+
+## 1100.1.5
+
+### Patch Changes
+
+- Updated dependencies [852d537]
+  - @pnpm/error@1100.0.1
+  - @pnpm/workspace.root-finder@1100.0.3
+
+## 1100.1.4
+
+### Patch Changes
+
+- Updated dependencies [293921a]
+  - @pnpm/workspace.root-finder@1100.0.2
+
+## 1100.1.3
+
+### Patch Changes
+
+- 43d5456: Fixed `pnpm --prefix=<dir> install` overwriting the existing `pnpm-workspace.yaml` in `<dir>` with `set this to true or false` placeholders. The renamed `--prefix` option (which maps to `dir`) was not honored when locating the workspace root, so the workspace manifest's `allowBuilds` settings were not loaded into config and got clobbered when ignored builds were auto-populated [#11535](https://github.com/pnpm/pnpm/issues/11535).
+
+## 1100.1.2
+
+### Patch Changes
+
+- 81161d5: `--pm-on-fail=ignore` (and other universal options like `--loglevel`, `--reporter`) is now honored when combined with `--help` or `--version`. Previously the CLI argument parser short-circuited those flags before universal options were preserved, so `pnpm audit --pm-on-fail=ignore --help` and `pnpm --pm-on-fail=ignore --version` reported the strict packageManager mismatch instead of running the requested action [#11487](https://github.com/pnpm/pnpm/issues/11487).
+
+## 1100.1.1
+
+### Patch Changes
+
+- 184ce26: Fix the package name in README.md.
+- Updated dependencies [184ce26]
+  - @pnpm/workspace.root-finder@1100.0.1
+
+## 1100.1.0
+
+### Minor Changes
+
+- 9af708a: Add `pnpm with <version|current> <args...>` command. Runs pnpm at a specific version (or the currently active one) for a single invocation, bypassing the project's `packageManager` and `devEngines.packageManager` pins. Uses the same install mechanism as `pnpm self-update`, caching the downloaded pnpm in the global virtual store for reuse.
+
+  Examples:
+
+  ```
+  pnpm with current install           # ignore the pinned version, use the running pnpm
+  pnpm with 11.0.0-rc.1 install       # install using pnpm 11.0.0-rc.1
+  pnpm with next install              # install using the "next" dist-tag
+  ```
+
+  Also adds a new `pmOnFail` setting that overrides the `onFail` behavior of `packageManager` and `devEngines.packageManager`. Accepted values: `download`, `error`, `warn`, `ignore`. Can be set via CLI flag, env var, `pnpm-workspace.yaml`, or `.npmrc` — useful when version management is handled by an external tool (asdf, mise, Volta, etc.) and the project wants pnpm itself to skip the check.
+
+  ```
+  pnpm install --pm-on-fail=ignore            # direct CLI flag
+  pnpm_config_pm_on_fail=ignore pnpm install  # env var
+  # or in pnpm-workspace.yaml:
+  #   pmOnFail: ignore
+  ```
+
+## 1001.0.0
+
+### Major Changes
+
+- 491a84f: This package is now pure ESM.
+- 7d2fd48: Node.js v18, 19, 20, and 21 support discontinued.
+- b51bb42: Support lowercase options in `pnpm add`: `-d`, `-p`, `-o`, `-e` [#9197](https://github.com/pnpm/pnpm/issues/9197).
+
+  When using `pnpm add` command only:
+
+  - `-p` is now an alias for `--save-prod` instead of `--parseable`
+  - `-d` is now an alias for `--save-dev` instead of `--loglevel=info`
+
+### Patch Changes
+
+- Updated dependencies [491a84f]
+- Updated dependencies [e119c4e]
+- Updated dependencies [7d2fd48]
+- Updated dependencies [831f574]
+  - @pnpm/workspace.root-finder@1001.0.0
+  - @pnpm/error@1001.0.0
+
+## 1000.1.4
+
+### Patch Changes
+
+- @pnpm/error@1000.0.5
+- @pnpm/find-workspace-dir@1000.1.3
+
+## 1000.1.3
+
+### Patch Changes
+
+- 7e89138: Fix deprecation warning printed when executing pnpm with Node.js 24 [#9529](https://github.com/pnpm/pnpm/issues/9529).
+
+## 1000.1.2
+
+### Patch Changes
+
+- 778ba1e: Fix a regression in which `pnpm dlx pkg --help` doesn't pass `--help` to `pkg` [#9823](https://github.com/pnpm/pnpm/issues/9823).
+
+## 1000.1.1
+
+### Patch Changes
+
+- @pnpm/error@1000.0.4
+- @pnpm/find-workspace-dir@1000.1.2
+
+## 1000.1.0
+
+### Minor Changes
+
+- 6bcfa69: Allow `dlx` to parse CLI flags and options between the `dlx` command and the command to run or between the `dlx` command and `--` [#9719](https://github.com/pnpm/pnpm/issues/9719).
+
+### Patch Changes
+
+- @pnpm/error@1000.0.3
+- @pnpm/find-workspace-dir@1000.1.1
+
+## 1000.0.4
+
+### Patch Changes
+
+- Updated dependencies [69f922a]
+  - @pnpm/find-workspace-dir@1000.1.0
+
+## 1000.0.3
+
+### Patch Changes
+
+- 48b4871: Allow scope registry CLI option without `--config.` prefix such as `--@scope:registry=https://scope.example.com/npm` [#9089](https://github.com/pnpm/pnpm/pull/9089).
+
+## 1000.0.2
+
+### Patch Changes
+
+- @pnpm/error@1000.0.2
+- @pnpm/find-workspace-dir@1000.0.2
+
+## 1000.0.1
+
+### Patch Changes
+
+- @pnpm/error@1000.0.1
+- @pnpm/find-workspace-dir@1000.0.1
+
+## 8.0.4
+
+### Patch Changes
+
+- @pnpm/error@6.0.3
+- @pnpm/find-workspace-dir@7.0.3
+
+## 8.0.3
+
+### Patch Changes
+
+- f066efc: All commands should read settings from the `package.json` at the root of the workspace [#8667](https://github.com/pnpm/pnpm/issues/8667).
+
+## 8.0.2
+
+### Patch Changes
+
+- @pnpm/error@6.0.2
+- @pnpm/find-workspace-dir@7.0.2
+
+## 8.0.1
+
+### Patch Changes
+
+- Updated dependencies [a7aef51]
+  - @pnpm/error@6.0.1
+  - @pnpm/find-workspace-dir@7.0.1
+
+## 8.0.0
+
+### Major Changes
+
+- 43cdd87: Node.js v16 support dropped. Use at least Node.js v18.12.
+
+### Patch Changes
+
+- Updated dependencies [3ded840]
+- Updated dependencies [43cdd87]
+  - @pnpm/error@6.0.0
+  - @pnpm/find-workspace-dir@7.0.0
+
+## 7.0.4
+
+### Patch Changes
+
+- 1ce2dd13a: Update didyoumean2 to v6.
+
+## 7.0.3
+
+### Patch Changes
+
+- 32679f0ad: Don't ignore empty strings in params [#6594](https://github.com/pnpm/pnpm/issues/6594).
+
+## 7.0.2
+
+### Patch Changes
+
+- @pnpm/error@5.0.2
+- @pnpm/find-workspace-dir@6.0.2
+
+## 7.0.1
+
+### Patch Changes
+
+- @pnpm/error@5.0.1
+- @pnpm/find-workspace-dir@6.0.1
+
+## 7.0.0
+
+### Major Changes
+
+- eceaa8b8b: Node.js 14 support dropped.
+
+### Patch Changes
+
+- Updated dependencies [eceaa8b8b]
+  - @pnpm/find-workspace-dir@6.0.0
+  - @pnpm/error@5.0.0
+
+## 6.0.1
+
+### Patch Changes
+
+- @pnpm/error@4.0.1
+- @pnpm/find-workspace-dir@5.0.1
+
+## 6.0.0
+
+### Major Changes
+
+- f884689e0: Require `@pnpm/logger` v5.
+
+### Patch Changes
+
+- Updated dependencies [043d988fc]
+- Updated dependencies [f884689e0]
+  - @pnpm/error@4.0.0
+  - @pnpm/find-workspace-dir@5.0.0
+
+## 5.0.3
+
+### Patch Changes
+
+- Updated dependencies [e8a631bf0]
+  - @pnpm/error@3.1.0
+  - @pnpm/find-workspace-dir@4.0.3
+
+## 5.0.2
+
+### Patch Changes
+
+- Updated dependencies [6434a8291]
+  - @pnpm/find-workspace-dir@4.0.2
+
+## 5.0.1
+
+### Patch Changes
+
+- @pnpm/error@3.0.1
+- @pnpm/find-workspace-dir@4.0.1
+
+## 5.0.0
+
+### Major Changes
+
+- c35ac786b: When using `pnpm run <script>`, all command line arguments after the script name are now passed to the script's argv, even `--`. For example, `pnpm run echo --hello -- world` will now pass `--hello -- world` to the `echo` script's argv. Previously flagged arguments (e.g. `--silent`) were interpreted as pnpm arguments unless `--` came before it.
+- 542014839: Node.js 12 is not supported.
+
+### Patch Changes
+
+- Updated dependencies [542014839]
+  - @pnpm/error@3.0.0
+  - @pnpm/find-workspace-dir@4.0.0
+
+## 4.4.1
+
+### Patch Changes
+
+- Updated dependencies [70ba51da9]
+  - @pnpm/error@2.1.0
+  - @pnpm/find-workspace-dir@3.0.2
+
+## 4.4.0
+
+### Minor Changes
+
+- 8fe8f5e55: New CLI option: `--ignore-workspace`. When used, pnpm ignores any workspace configuration found in the current or parent directories.
+
+## 4.3.0
+
+### Minor Changes
+
+- 06f127503: A new option added: `escapeArgs`. `escapeArgs` is an array of arguments that stop arguments parsing.
+  By default, everything after `--` is not parsed as key-value. This option allows to add new keywords to stop parsing.
+
+## 4.2.2
+
+### Patch Changes
+
+- 05ed9ea63: Update didyoumean2 to v5.
+
+## 4.2.1
+
+### Patch Changes
+
+- 22f841039: The `--help` option should not convert the command to `help` if the command is unknown. So `pnpm eslint -h` is not parsed as `pnpm help eslint`.
+
+## 4.2.0
+
+### Minor Changes
+
+- 209c14235: A new property is returned in the result: fallbackCommandUsed. It is true when an unknown command was used, so the fallback command had to be used instead.
+
+## 4.1.1
+
+### Patch Changes
+
+- Updated dependencies [6e8cedb79]
+  - @pnpm/find-workspace-dir@3.0.1
+
+## 4.1.0
+
+### Minor Changes
+
+- dfdf669e6: Add new cli arg --filter-prod. --filter-prod acts the same as --filter, but it omits devDependencies when building dependencies
+
+## 4.0.0
+
+### Major Changes
+
+- 97b986fbc: Node.js 10 support is dropped. At least Node.js 12.17 is required for the package to work.
+
+### Patch Changes
+
+- Updated dependencies [97b986fbc]
+  - @pnpm/error@2.0.0
+  - @pnpm/find-workspace-dir@3.0.0
+
+## 3.2.2
+
+### Patch Changes
+
+- Updated dependencies [ec37069f2]
+  - @pnpm/find-workspace-dir@2.0.0
+
+## 3.2.1
+
+### Patch Changes
+
+- Updated dependencies [0c5f1bcc9]
+  - @pnpm/error@1.4.0
+
+## 3.2.0
+
+### Minor Changes
+
+- 092f8dd83: When --workspace-root is used, the working directory is changed to the root of the workspace.
+
+## 3.1.2
+
+### Patch Changes
+
+- 9f5803187: Update nopt to v5.
+
+## 3.1.1
+
+### Patch Changes
+
+- Updated dependencies [999f81305]
+  - @pnpm/find-workspace-dir@1.0.1
+
+## 3.1.0
+
+### Minor Changes
+
+- be0a3db9b: Allow unknown options that are prefixed with "config."
+
+## 3.0.1
+
+### Patch Changes
+
+- a2ef8084f: Use the same versions of dependencies across the pnpm monorepo.
+
+## 3.0.0
+
+### Major Changes
+
+- 65b4d07ca: move recursive for workspace check to pnpm main
+
+## 2.1.0
+
+### Minor Changes
+
+- 09b777f8d: New option added: `fallbackCommand`. If set, this command is added to the beginning of any unknown query.
+
+## 2.0.0
+
+### Major Changes
+
+- 561f38955: `unknownOptions` in the result object is a `Map` instead of an `Array`.
+
+  `unknownOptions` is a map of unknown options to options that are similar to the unknown options.
+
+## 1.1.0
+
+### Minor Changes
+
+- 0e8daafe4: The mapping of CLI option shorthands may use arrays of string.
+
+## 1.0.1
+
+### Patch Changes
+
+- @pnpm/find-workspace-dir@1.0.1

package/lib/index.js

@@ -93,7 +93,12 @@ export async function parseCliArgs(opts, inputArgv) {
     }
     function getEscapeArgsWithSpecialCases() {
         if (!SPECIALLY_ESCAPED_CMDS.has(cmd)) {
-            return opts.escapeArgs;
+            // An escape word only escapes when it is the command itself: nopt
+            // stops parsing options at the first occurrence of an escape word
+            // anywhere in argv, so escaping under another command would silently
+            // turn that command's trailing options into parameters (e.g. the
+            // --registry in `pnpm team create @org:x --registry <url>`).
+            return opts.escapeArgs?.includes(commandName) ? opts.escapeArgs : undefined;
         }
         // We'd like everything after the run script's name to be passed to the
         // script's argv itself. For example, "pnpm run echo --test" should pass

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnpm/cli.parse-cli-args",
-  "version": "1100.1.4",
+  "version": "1100.1.6",
   "description": "Parses the CLI args passed to pnpm",
   "keywords": [
     "pnpm",
@@ -10,9 +10,9 @@
   "funding": "https://opencollective.com/pnpm",
   "repository": {
     "type": "git",
-    "url": "https://github.com/pnpm/pnpm/tree/main/cli/parse-cli-args"
+    "url": "https://github.com/pnpm/pnpm/tree/main/pnpm11/cli/parse-cli-args"
   },
-  "homepage": "https://github.com/pnpm/pnpm/tree/main/cli/parse-cli-args#readme",
+  "homepage": "https://github.com/pnpm/pnpm/tree/main/pnpm11/cli/parse-cli-args#readme",
   "bugs": {
     "url": "https://github.com/pnpm/pnpm/issues"
   },
@@ -27,15 +27,15 @@
     "!*.map"
   ],
   "dependencies": {
+    "@pnpm/error": "1100.0.1",
     "@pnpm/nopt": "^0.3.1",
-    "didyoumean2": "^7.0.4",
-    "@pnpm/workspace.root-finder": "1100.0.2",
-    "@pnpm/error": "1100.0.0"
+    "@pnpm/workspace.root-finder": "1100.0.3",
+    "didyoumean2": "^7.0.4"
   },
   "devDependencies": {
     "@jest/globals": "30.4.1",
-    "tempy": "3.0.0",
-    "@pnpm/cli.parse-cli-args": "1100.1.4"
+    "@pnpm/cli.parse-cli-args": "1100.1.6",
+    "tempy": "3.0.0"
   },
   "engines": {
     "node": ">=22.13"