[TASK] Handle replaced packages properly

Composer allows to define a package to replace
others. This may be used also for extensions.

Therefore, we now regonize packages replacing
other packages and store that information.
We also try to determne the replaced extension
key, albeit we do not properly check for this
during extension symlinking into test instances.

Releases: main, 7

Classes/Composer/ComposerPackageManager.php

@@ -304,6 +304,12 @@ private function processPackages(): void
     {
         foreach (InstalledVersions::getAllRawData() as $loader) {
             foreach ($loader['versions'] as $packageName => $version) {
+                // We ignore replaced packages. The replacing package adds them with the final package info directly.
+                if (($version['replaced'] ?? false)
+                    && $version['replaced'] !== []
+                ) {
+                    continue;
+                }
                 $packagePath = $this->getPackageInstallPath($packageName);
                 $packageRealPath = $this->realPath($packagePath);
                 $info = $this->getPackageComposerJson($packagePath);
@@ -339,6 +345,17 @@ private function addPackageInfo(PackageInfo $packageInfo): void
         if ($packageInfo->getExtensionKey() !== '') {
             self::$extensionKeyToPackageNameMap[$packageInfo->getExtensionKey()] = $packageInfo->getName();
         }
+        foreach ($packageInfo->getReplacesPackageNames() as $replacedPackageName) {
+            self::$packages[$replacedPackageName] = $packageInfo;
+            if ($packageInfo->isExtension() || $packageInfo->isSystemExtension()) {
+                $extensionKey = basename($replacedPackageName);
+                if (str_starts_with($extensionKey, 'cms-')) {
+                    $extensionKey = substr($extensionKey, 4);
+                }
+                $extensionKey = $this->normalizeExtensionKey($extensionKey);
+                self::$extensionKeyToPackageNameMap[$extensionKey] = $replacedPackageName;
+            }
+        }
     }
 
     private function rootPackage(): ?PackageInfo

Classes/Composer/PackageInfo.php

@@ -120,4 +120,18 @@ public function getWebDir(): string
     {
         return (string)($this->info['extra']['typo3/cms']['web-dir'] ?? '');
     }
+
+    /**
+     * @return string[]
+     */
+    public function getReplacesPackageNames(): array
+    {
+        $keys = array_keys($this->info['replace'] ?? []);
+        if ($this->isMonoRepository()) {
+            // Monorepo root composer.json replaces core system extension. We do not want that happen, so
+            // ignore only replaced core extensions.
+            $keys = array_filter($keys, static fn ($value) => !str_starts_with($value, 'typo3/cms-'));
+        }
+        return $keys;
+    }
 }