feat: use the right LWC/Dev server version for the org

.husky/check-versions.js

@@ -1,24 +1,66 @@
 import fs from 'node:fs';
 import semver from 'semver';
 
+/**
+ * This script ensures that the aliased dependencies in package.json stay in sync
+ * with the versions defined in apiVersionMetadata.
+ */
+
 // Read package.json
 const packageJson = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+const apiVersionMetadata = packageJson.apiVersionMetadata;
+
+if (!apiVersionMetadata) {
+  console.error('Error: missing apiVersionMetadata in package.json');
+  process.exit(1);
+}
+
+let hasError = false;
+
+// Iterate through each API version defined in metadata
+for (const [apiVersion, metadata] of Object.entries(apiVersionMetadata)) {
+  const expectedDeps = metadata.dependencies;
+  if (!expectedDeps) continue;
 
-// Extract versions
-const devServerDependencyVersion = packageJson.dependencies['@lwc/lwc-dev-server'];
-const devServerTargetVersionRange = packageJson.apiVersionMetadata?.target?.matchingDevServerVersion;
+  for (const [depName, expectedRange] of Object.entries(expectedDeps)) {
+    // For each dependency in metadata, find its aliased counterpart in package.json dependencies
+    // e.g. @lwc/lwc-dev-server -> @lwc/lwc-dev-server-65.0
+    const aliasName = `${depName}-${apiVersion}`;
+    const actualAliasValue = packageJson.dependencies[aliasName];
 
-if (!devServerDependencyVersion || !devServerTargetVersionRange) {
-  console.error('Error: missing @lwc/lwc-dev-server or matchingDevServerVersion');
-  process.exit(1); // Fail the check
+    if (!actualAliasValue) {
+      console.error(`Error: Missing aliased dependency '${aliasName}' in package.json for API version ${apiVersion}`);
+      hasError = true;
+      continue;
+    }
+
+    // actualAliasValue looks like "npm:@lwc/lwc-dev-server@~13.2.x" or "npm:lwc@~8.23.x"
+    // We want to extract the version range after the last @
+    const match = actualAliasValue.match(/@([^@]+)$/);
+    if (!match) {
+      console.error(`Error: Could not parse version range from aliased dependency '${aliasName}': ${actualAliasValue}`);
+      hasError = true;
+      continue;
+    }
+
+    const actualRange = match[1];
+
+    // Compare the range in metadata with the range in the aliased dependency
+    if (!semver.intersects(expectedRange, actualRange)) {
+      console.error(
+        `Error: Version mismatch for '${aliasName}'. ` +
+          `Expected ${expectedRange} in apiVersionMetadata, but found ${actualRange} in dependencies.`,
+      );
+      hasError = true;
+    }
+  }
 }
 
-// Compare versions
-if (semver.intersects(devServerTargetVersionRange, devServerDependencyVersion)) {
-  process.exit(0); // Pass the check
-} else {
+if (hasError) {
   console.error(
-    `Error: @lwc/lwc-dev-server versions do not match between 'dependencies' and 'apiVersionMetadata' in package.json. Expected ${devServerDependencyVersion} in apiVersionMetadata > target > matchingDevServerVersion. Got ${devServerTargetVersionRange} instead. When updating the @lwc/lwc-dev-server dependency, you must ensure that it is compatible with the supported API version in this branch, then update apiVersionMetadata > target > matchingDevServerVersion to match, in order to "sign off" on this dependency change.`
+    '\nWhen updating LWC dependencies, you must ensure that the versions in apiVersionMetadata match the aliased dependencies in package.json.',
   );
-  process.exit(1); // Fail the check
+  process.exit(1);
 }
+
+process.exit(0);