javascript: package yarn v2 (#20540)

Add support for `pants package` using yarn@v2.

Currently when trying to package a yarn@v2 project, the following error
occurs:

```
Engine traceback:
  in `package` goal

ProcessExecutionFailure: Process 'Installing [email protected].' failed with exit code 1.
stdout:
➤ YN0050: The --frozen-lockfile option is deprecated; use --immutable and/or --immutable-cache instead

stderr:
```

Thats because the option `--frozen-lockfile` was replaced with
`--immutable` on yarn >= 2.

This behavior can be reproducible at
https://github.com/kevinobruno/pants-yarn running `pants package
//yarnv2`

Author: kevinobruno

src/python/pants/backend/javascript/nodejs_project.py

@@ -8,6 +8,8 @@
 from pathlib import PurePath
 from typing import Iterable
 
+import nodesemver
+
 from pants.backend.javascript import package_json
 from pants.backend.javascript.package_json import (
     AllPackageJson,
@@ -78,7 +80,13 @@ def generate_lockfile_args(self) -> tuple[str, ...]:
     def immutable_install_args(self) -> tuple[str, ...]:
         if self.package_manager == "npm":
             return ("clean-install",)
-        return ("install", "--frozen-lockfile")
+        if self.package_manager == "pnpm":
+            return ("install", "--frozen-lockfile")
+        if self.package_manager == "yarn":
+            if nodesemver.satisfies(self.package_manager_version, "1.x"):
+                return ("install", "--frozen-lockfile")
+            return ("install", "--immutable")
+        raise ValueError(f"Unsupported package manager: {self.package_manager}")
 
     @property
     def workspace_specifier_arg(self) -> str:

src/python/pants/backend/javascript/nodejs_project_test.py

@@ -71,6 +71,51 @@ def test_parses_projects(rule_runner: RuleRunner) -> None:
     assert {project.root_dir for project in projects} == {"src/js/foo", "src/js/bar"}
 
 
+@pytest.mark.parametrize(
+    ("package_manager", "expected_immutable_install_args"),
+    [
+        (None, ("clean-install",)),
+        ("[email protected]", ("clean-install",)),
+        ("[email protected]", ("install", "--frozen-lockfile")),
+        ("[email protected]", ("install", "--frozen-lockfile")),
+        ("[email protected]", ("install", "--immutable")),
+        ("[email protected]", ("install", "--immutable")),
+    ],
+)
+def test_immutable_install_args_property(
+    package_manager: None | str,
+    expected_immutable_install_args: tuple[str],
+    rule_runner: RuleRunner,
+) -> None:
+    rule_runner.write_files(
+        {
+            "src/js/foo/BUILD": "package_json()",
+            "src/js/foo/package.json": given_package(
+                name="foo",
+                version="0.0.1",
+                package_manager=package_manager,
+            ),
+        }
+    )
+    projects = rule_runner.request(AllNodeJSProjects, [])
+    assert projects[0].immutable_install_args == expected_immutable_install_args
+
+
+def test_immutable_install_args_property_with_unsupported_package_manager(
+    rule_runner: RuleRunner,
+) -> None:
+    rule_runner.write_files(
+        {
+            "src/js/foo/BUILD": "package_json()",
+            "src/js/foo/package.json": given_package("foo", "0.0.1", package_manager="[email protected]"),
+        }
+    )
+    projects = rule_runner.request(AllNodeJSProjects, [])
+    expected_error = "Unsupported package manager: bar"
+    with pytest.raises(ValueError, match=expected_error):
+        {project.immutable_install_args for project in projects}
+
+
 def test_root_package_json_is_supported(rule_runner: RuleRunner) -> None:
     rule_runner.write_files(
         {