[pull] main from renovatebot:main

docs/usage/configuration-options.md

@@ -3375,6 +3375,27 @@ For example to replace the npm package `jade` with version `2.0.0` of the packag
 }
 ```
 
+### replacementVersionTemplate
+
+<!-- prettier-ignore -->
+!!! note
+    `replacementVersion` will take precedence if used within the same package rule.
+
+Use the `replacementVersionTemplate` config option to control the replacement version.
+
+For example, the following package rule can be used to replace version with major-only version (17.0.1 -> 17):
+
+```json
+{
+  "packageRules": [
+    {
+      "matchPackageNames": ["dummy"],
+      "replacementVersionTemplate": "{{ lookup (split currentValue '.') 0 }}"
+    }
+  ]
+}
+```
+
 ### sourceDirectory
 
 Use this field to set the directory in which the package is present at the source of the package.

lib/config/options/index.ts

@@ -1465,6 +1465,16 @@ const options: RenovateOptions[] = [
     cli: false,
     env: false,
   },
+  {
+    name: 'replacementVersionTemplate',
+    description:
+      'Template field for the version of the new dependency that replaces the old deprecated dependency.',
+    type: 'string',
+    stage: 'package',
+    parents: ['packageRules'],
+    cli: false,
+    env: false,
+  },
   {
     name: 'replacementApproach',
     description:

lib/workers/repository/process/lookup/index.spec.ts

@@ -4910,6 +4910,161 @@ describe('workers/repository/process/lookup/index', () => {
       ]);
     });
 
+    it('handles replacements - can template replacement version without a replacement name', async () => {
+      config.packageName = 'mirror_some_org/library/openjdk';
+      config.currentValue = '17.0.0';
+      config.replacementVersionTemplate = `{{ lookup (split currentValue '.') 0 }}`;
+      config.datasource = DockerDatasource.id;
+      getDockerReleases.mockResolvedValueOnce({
+        releases: [
+          {
+            version: '17.0.0',
+          },
+          {
+            version: '18.0.0',
+          },
+        ],
+      });
+
+      const { updates } = await Result.wrap(
+        lookup.lookupUpdates(config),
+      ).unwrapOrThrow();
+
+      expect(updates).toEqual([
+        {
+          bucket: 'major',
+          newMajor: 18,
+          newMinor: 0,
+          newPatch: 0,
+          newValue: '18.0.0',
+          newVersion: '18.0.0',
+          updateType: 'major',
+        },
+        {
+          newName: 'mirror_some_org/library/openjdk',
+          newValue: '17',
+          updateType: 'replacement',
+        },
+      ]);
+    });
+
+    it('handles replacements - can template replacement version with a replacement name', async () => {
+      config.packageName = 'mirror_some_org/library/openjdk';
+      config.currentValue = '17.0.0';
+      config.replacementName = 'eclipse-temurin';
+      config.replacementVersionTemplate = `{{ lookup (split currentValue '.') 0 }}`;
+      config.datasource = DockerDatasource.id;
+      getDockerReleases.mockResolvedValueOnce({
+        releases: [
+          {
+            version: '17.0.0',
+          },
+          {
+            version: '18.0.0',
+          },
+        ],
+      });
+
+      const { updates } = await Result.wrap(
+        lookup.lookupUpdates(config),
+      ).unwrapOrThrow();
+
+      expect(updates).toEqual([
+        {
+          bucket: 'major',
+          newMajor: 18,
+          newMinor: 0,
+          newPatch: 0,
+          newValue: '18.0.0',
+          newVersion: '18.0.0',
+          updateType: 'major',
+        },
+        {
+          newName: 'eclipse-temurin',
+          newValue: '17',
+          updateType: 'replacement',
+        },
+      ]);
+    });
+
+    it('handles replacements - can template replacement version with a template replacement name', async () => {
+      config.packageName = 'mirror_some_org/library/openjdk';
+      config.currentValue = '17.0.0';
+      config.replacementNameTemplate = `{{{replace 'mirror_some_org/' 'new.registry.io/' packageName}}}`;
+      config.replacementVersionTemplate = `{{ lookup (split currentValue '.') 0 }}`;
+      config.datasource = DockerDatasource.id;
+      getDockerReleases.mockResolvedValueOnce({
+        releases: [
+          {
+            version: '17.0.0',
+          },
+          {
+            version: '18.0.0',
+          },
+        ],
+      });
+
+      const { updates } = await Result.wrap(
+        lookup.lookupUpdates(config),
+      ).unwrapOrThrow();
+
+      expect(updates).toEqual([
+        {
+          bucket: 'major',
+          newMajor: 18,
+          newMinor: 0,
+          newPatch: 0,
+          newValue: '18.0.0',
+          newVersion: '18.0.0',
+          updateType: 'major',
+        },
+        {
+          newName: 'new.registry.io/library/openjdk',
+          newValue: '17',
+          updateType: 'replacement',
+        },
+      ]);
+    });
+
+    it('handles replacements - replacementVersion takes precedence over replacementVersionTemplate', async () => {
+      config.packageName = 'mirror_some_org/library/openjdk';
+      config.currentValue = '17.0.0';
+      config.replacementVersionTemplate = `{{ lookup (split currentValue '.') 0 }}`;
+      config.replacementVersion = '18.0.0';
+      config.datasource = DockerDatasource.id;
+      getDockerReleases.mockResolvedValueOnce({
+        releases: [
+          {
+            version: '17.0.0',
+          },
+          {
+            version: '18.0.0',
+          },
+        ],
+      });
+
+      const { updates } = await Result.wrap(
+        lookup.lookupUpdates(config),
+      ).unwrapOrThrow();
+
+      expect(updates).toEqual([
+        {
+          bucket: 'major',
+          newMajor: 18,
+          newMinor: 0,
+          newPatch: 0,
+          newValue: '18.0.0',
+          newVersion: '18.0.0',
+          updateType: 'major',
+        },
+        {
+          newName: 'mirror_some_org/library/openjdk',
+          newValue: '18.0.0',
+          updateType: 'replacement',
+        },
+      ]);
+    });
+
     it('handles replacements - can perform replacement even for invalid versioning', async () => {
       config.packageName = 'adoptopenjdk/openjdk11';
       config.currentValue = 'alpine-jre';

lib/workers/repository/process/lookup/types.ts

@@ -48,6 +48,7 @@ export interface LookupUpdateConfig
   replacementName?: string;
   replacementNameTemplate?: string;
   replacementVersion?: string;
+  replacementVersionTemplate?: string;
   extractVersion?: string;
   vulnerabilityFixVersion?: string;
   vulnerabilityFixStrategy?: string;

lib/workers/repository/process/lookup/utils.ts

@@ -31,7 +31,8 @@ export function isReplacementRulesConfigured(
   return (
     is.nonEmptyString(config.replacementName) ||
     is.nonEmptyString(config.replacementNameTemplate) ||
-    is.nonEmptyString(config.replacementVersion)
+    is.nonEmptyString(config.replacementVersion) ||
+    is.nonEmptyString(config.replacementVersionTemplate)
   );
 }
 
@@ -50,18 +51,29 @@ export function determineNewReplacementName(
 export function determineNewReplacementValue(
   config: LookupUpdateConfig,
 ): string | undefined | null {
+  const newVersion = getNewVersion(config);
+  if (!newVersion) {
+    return config.currentValue;
+  }
+
   const versioningApi = allVersioning.get(config.versioning);
   const rangeStrategy = getRangeStrategy(config);
 
+  return versioningApi.getNewValue({
+    // TODO #22198
+    currentValue: config.currentValue!,
+    newVersion,
+    rangeStrategy: rangeStrategy!,
+    isReplacement: true,
+  });
+}
+
+function getNewVersion(config: LookupUpdateConfig): string | null {
   if (!is.nullOrUndefined(config.replacementVersion)) {
-    return versioningApi.getNewValue({
-      // TODO #22198
-      currentValue: config.currentValue!,
-      newVersion: config.replacementVersion,
-      rangeStrategy: rangeStrategy!,
-      isReplacement: true,
-    });
+    return config.replacementVersion;
   }
-
-  return config.currentValue;
+  if (!is.nullOrUndefined(config.replacementVersionTemplate)) {
+    return template.compile(config.replacementVersionTemplate, config, true);
+  }
+  return null;
 }

package.json

@@ -273,7 +273,7 @@
     "@smithy/util-stream": "3.3.4",
     "@types/auth-header": "1.0.6",
     "@types/aws4": "1.11.6",
-    "@types/better-sqlite3": "7.6.12",
+    "@types/better-sqlite3": "7.6.13",
     "@types/breejs__later": "4.1.5",
     "@types/bunyan": "1.8.11",
     "@types/cacache": "17.0.2",
@@ -348,7 +348,7 @@
     "vite": "6.2.6",
     "vite-tsconfig-paths": "5.1.4",
     "vitest": "3.1.1",
-    "vitest-mock-extended": "3.0.1"
+    "vitest-mock-extended": "3.1.0"
   },
   "packageManager": "pnpm@10.7.1",
   "files": [

tools/schemas/replacements-schema.json

@@ -40,7 +40,8 @@
               "replacementName": { "type": "string" },
               "replacementVersion": { "type": "string" },
               "description": { "type": "string" },
-              "replacementNameTemplate": { "type": "string" }
+              "replacementNameTemplate": { "type": "string" },
+              "replacementVersionTemplate": { "type": "string" }
             },
             "required": ["matchDatasources", "matchPackageNames"]
           },

tools/schemas/schema.ts

@@ -19,6 +19,7 @@ const PackageRuleSchema = z.object({
   replacementVersion: z.string().optional(),
   description: z.string().optional(),
   replacementNameTemplate: z.string().optional(),
+  replacementVersionTemplate: z.string().optional(),
 });
 
 const RuleSetSchema = z.object({