bug symfony#2952 Fix package.json files to not use "catalog" feature from PNPM, as it breaks installation from vendor/ PHP packages (Kocal)

This PR was merged into the 2.x branch.

Discussion
----------

Fix package.json files to not use "catalog" feature from PNPM, as it breaks installation from `vendor/` PHP packages

| Q             | A
| ------------- | ---
| Bug fix?      | yes
| New feature?  | no <!-- please update src/**/CHANGELOG.md files -->
| Docs?         | no <!-- required for new features -->
| Issues        | Fix symfony#2951 <!-- prefix each issue number with "Fix #", no need to create an issue if none exist, explain below instead -->
| License       | MIT

<!--
Replace this notice by a description of your feature/bugfix.
This will help reviewers and should be a good start for the documentation.

Additionally (see https://symfony.com/releases):
 - Always add tests and ensure they pass.
 - For new features, provide some code snippets to help understand usage.
 - Features and deprecations must be submitted against branch main.
 - Update/add documentation as required (we can help!)
 - Changelog entry should follow https://symfony.com/doc/current/contributing/code/conventions.html#writing-a-changelog-entry
 - Never break backward compatibility (see https://symfony.com/bc).
-->

Since symfony#2932

Dropping any fancy stuff from our `package.json` since it can breaks when people install JS packages through the PHP packages

I will edit the "test apps" jobs to use `npm` to install dependencies, so we will be sure in the future we are not breaking things again.

Commits
-------

4c24ce6 Fix package.json files to not use "catalog" feature from PNPM, as it breaks installation from `vendor/` PHP packages

Author: Kocal

.github/workflows/app-tests.yaml

@@ -60,35 +60,60 @@ jobs:
             working-directory: test_apps/encore-app
             dependency-versions: highest
 
+        - name: Manually replacing "workspace:*" references
+          run: |
+            for PACKAGE_DATA in $(cd ../..; pnpm ls -r --json --depth -1 | jq 'map(select(.private != true))' | jq -c '.[]'); do
+              PACKAGE=$(echo $PACKAGE_DATA | jq -r '.name')
+              PACKAGE_PATH=$(echo $PACKAGE_DATA | jq -r '.path')
+
+              echo "🔍 Searching for \"workspace:*\" references in $PACKAGE_PATH/package.json"
+
+              # Manually replace "workspace:" constraints with the actual package version, it ensure packages can be installed with npm
+              jq -rc '[(.dependencies // {}) + (.devDependencies // {}) | to_entries[] | select(.value == "workspace:*") | .key][]' "$PACKAGE_PATH/package.json" | while read -r PACKAGE_FROM_WORKSPACE ; do
+                # Extract the resolved version of the package from the workspace, e.g.: "link:../../../../assets"
+                echo "ℹ️ Found \"$PACKAGE_FROM_WORKSPACE\" with \"workspace:*\"
+
+                echo '---'
+                pnpm ls --filter $PACKAGE_FROM_WORKSPACE --json --depth -1
+                echo '---'
+
+                PACKAGE_FROM_WORKSPACE_PATH=$(cd ../..; pnpm ls --filter $PACKAGE_FROM_WORKSPACE --json --depth -1 | jq -r '.[].path')
+                echo "ℹ️ The package \"$PACKAGE_FROM_WORKSPACE\" is located in \"$PACKAGE_FROM_WORKSPACE_PATH\" directory"
+
+                echo "⚒️ Replacing \"$PACKAGE_FROM_WORKSPACE\" with \"file:$PACKAGE_FROM_WORKSPACE_PATH\" in $PACKAGE_PATH/package.json"
+                sed -i "s|\"$PACKAGE_FROM_WORKSPACE\": \"workspace:\*\"|\"$PACKAGE_FROM_WORKSPACE\": \"file:$PACKAGE_FROM_WORKSPACE_PATH\"|g" "$PACKAGE_PATH/package.json"
+              done;
+            done
+
         - working-directory: test_apps/encore-app
-          run: pnpm install --ignore-workspace
+          run: npm install
 
         - if: matrix.ux-packages-source == 'js-packages'
           name: Install UX JS packages with a JS package manager
           working-directory: test_apps/encore-app
           run: |
             PACKAGES_TO_INSTALL=''
-            for PACKAGE in $(cd ../..; pnpm ls -r --json --depth -1 | jq 'map(select(.private != true))' | jq -c '.[]'); do
-              PACKAGE_ABSOLUTE_PATH=$(echo $PACKAGE | jq -r '.path')
-              PACKAGE_RELATIVE_PATH=$(realpath --relative-to=. "$PACKAGE_ABSOLUTE_PATH")
-              PACKAGES_TO_INSTALL="$PACKAGES_TO_INSTALL file:$PACKAGE_RELATIVE_PATH"
+            for PACKAGE_DATA in $(cd ../..; pnpm ls -r --json --depth -1 | jq 'map(select(.private != true))' | jq -c '.[]'); do
+              PACKAGE_PATH=$(echo $PACKAGE_DATA | jq -r '.path')
+              PACKAGES_TO_INSTALL="$PACKAGES_TO_INSTALL file:$(realpath --relative-to=. "$PACKAGE_PATH")"
             done
+
             echo "Installing packages: $PACKAGES_TO_INSTALL"
-            pnpm add --save-dev $PACKAGES_TO_INSTALL
+            npm add --save-dev $PACKAGES_TO_INSTALL
 
         - name: Ensure UX packages are installed from "${{ env.EXPECTED_PATTERN }}"
           working-directory: test_apps/encore-app
           run: |
             for PACKAGE in $(cat package.json | jq -c '(.dependencies // {}) + (.devDependencies // {}) | to_entries[] | select(.key | startswith("@symfony/ux-")) | {name: .key, version: .value}'); do
-              PACKAGE_NAME=$(echo $PACKAGE | jq -r '.name')
+              PACKAGE=$(echo $PACKAGE | jq -r '.name')
               PACKAGE_VERSION=$(echo $PACKAGE | jq -r '.version')
 
-              echo -n "Checking $PACKAGE_NAME@$PACKAGE_VERSION..."
+              echo -n "Checking $PACKAGE@$PACKAGE_VERSION..."
               if [[ $PACKAGE_VERSION == $EXPECTED_PATTERN* ]]; then
                 echo " OK"
               else
                 echo " KO"
-                echo "The package version of $PACKAGE_NAME must starts with the pattern (e.g.: $EXPECTED_PATTERN), got $PACKAGE_VERSION instead."
+                echo "The package version of $PACKAGE must starts with the pattern (e.g.: $EXPECTED_PATTERN), got $PACKAGE_VERSION instead."
                 exit 1
               fi
             done;
@@ -97,8 +122,8 @@ jobs:
 
         - name: Ensure project can be built in dev mode
           working-directory: test_apps/encore-app
-          run: pnpm run dev
+          run: npm run dev
 
         - name: Ensure project can be built in prod mode
           working-directory: test_apps/encore-app
-          run: pnpm run build
+          run: npm run build

.github/workflows/code-quality.yaml

@@ -6,11 +6,13 @@ on:
             - 'src/*/doc/**'
             - 'src/**/*.md'
             - 'ux.symfony.com/**'
+            - '.github/workflows/app-tests.yaml'
     pull_request:
         paths-ignore:
             - 'src/*/doc/**'
             - 'src/**/*.md'
             - 'ux.symfony.com/**'
+            - '.github/workflows/app-tests.yaml'
 
 concurrency:
     group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}

.github/workflows/unit-tests.yaml

@@ -10,11 +10,13 @@ on:
             - 'src/*/doc/**'
             - 'src/**/*.md'
             - 'ux.symfony.com/**'
+            - '.github/workflows/app-tests.yaml'
     pull_request:
         paths-ignore:
             - 'src/*/doc/**'
             - 'src/**/*.md'
             - 'ux.symfony.com/**'
+            - '.github/workflows/app-tests.yaml'
 
 concurrency:
     group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}

.github/workflows/ux.symfony.com.yaml

@@ -8,13 +8,15 @@ on:
             - '!src/*/doc/**'
             - '!src/**/*.md'
             - '.github/**'
+            - '!.github/workflows/app-tests.yaml'
     pull_request:
         paths:
             - 'ux.symfony.com/**'
             - 'src/*/**'
             - '!src/*/doc/**'
             - '!src/**/*.md'
             - '.github/**'
+            - '!.github/workflows/app-tests.yaml'
 
 jobs:
 

package.json

@@ -14,15 +14,15 @@
     },
     "devDependencies": {
         "@biomejs/biome": "^2.0.4",
-        "@testing-library/dom": "catalog:",
-        "@testing-library/jest-dom": "catalog:",
+        "@testing-library/dom": "^10.4.0",
+        "@testing-library/jest-dom": "^6.6.3",
         "@types/node": "^22.6.0",
         "lightningcss": "^1.28.2",
         "pkg-types": "^2.2.0",
         "playwright": "^1.47.0",
         "tinyglobby": "^0.2.14",
         "tsup": "^8.5.0",
-        "vitest": "catalog:"
+        "vitest": "^3.2.4"
     },
     "version": "2.27.0"
 }