Map deprecated version macro to target versions

workPackageValue:X:version now renders all target versions of the work
package, single-line by default so legacy macros keep their inline
shape within existing content. Applies to both the web and export
render paths.

Author: akabiru

app/models/work_package/exports/macros/attributes.rb

@@ -175,12 +175,25 @@ def self.resolve_value(obj, attribute, disabled_rich_text_fields, layout: nil)
         custom_field = find_custom_field(obj, attribute)
 
         attribute_name = convert_to_attribute_name(custom_field, attribute, obj)
+        attribute_name, layout = map_legacy_version(attribute_name, layout, obj)
         return " " unless can_view_attribute?(custom_field, obj, attribute_name)
 
         is_rich_text = custom_field&.formattable? || disabled_rich_text_fields.include?(attribute_name.to_sym)
         [format_attribute_value(attribute_name, obj.class, obj, is_rich_text, layout), is_rich_text]
       end
 
+      ##
+      # The deprecated version attribute renders the work package's target
+      # versions, on a single line by default so legacy macros keep their
+      # inline shape within existing content.
+      def self.map_legacy_version(attribute_name, layout, obj)
+        if obj.is_a?(WorkPackage) && attribute_name == "version"
+          ["target_versions", layout || "singleline"]
+        else
+          [attribute_name, layout]
+        end
+      end
+
       def self.can_view_attribute?(custom_field, obj, attribute_name)
         custom_field || allowed_to_view_attribute?(obj, attribute_name)
       end

frontend/src/app/shared/components/fields/macros/attribute-value-macro.component.ts

@@ -127,7 +127,15 @@ export class AttributeValueMacroComponent implements OnInit {
 
     const schema = await this.schemaCache.ensureLoaded(resource);
     const proxied = this.schemaCache.proxied(resource, schema);
-    const attribute = schema.attributeFromLocalizedName(attributeName) ?? this.dateAttribute(resource, proxied, attributeName);
+    let attribute = schema.attributeFromLocalizedName(attributeName) ?? this.dateAttribute(resource, proxied, attributeName);
+
+    // The deprecated version attribute renders the work package's target
+    // versions, single-line by default so legacy macros keep their inline shape.
+    if (resource._type === 'WorkPackage' && attribute === 'version') {
+      attribute = 'targetVersions';
+      this.layout = this.layout ?? 'singleline';
+    }
+
     const fieldSchema = proxied.ofProperty(attribute) as IFieldSchema|undefined;
 
     if (fieldSchema) {

spec/models/exports/pdf/common/macro_spec.rb

@@ -369,6 +369,41 @@
       end
     end
 
+    describe "with target versions" do
+      shared_let(:version_one) { create(:version, project:, name: "1.0") }
+      shared_let(:version_two) { create(:version, project:, name: "2.0") }
+
+      before do
+        create(:work_package_version, work_package:, version: version_one)
+        create(:work_package_version, work_package:, version: version_two)
+      end
+
+      describe "with targetVersions attribute" do
+        let(:markdown) { "workPackageValue:#{work_package.id}:targetVersions" }
+
+        it "outputs one version per line" do
+          # the association carries no order, so compare the lines as a set
+          expect(formatted.split("  \n")).to match_array(%w[1.0 2.0])
+        end
+      end
+
+      describe "with legacy version attribute" do
+        let(:markdown) { "workPackageValue:#{work_package.id}:version" }
+
+        it "outputs all target versions on a single line" do
+          expect(formatted.split(", ")).to match_array(%w[1.0 2.0])
+        end
+      end
+
+      describe "with legacy version attribute and multiline layout" do
+        let(:markdown) { "workPackageValue:#{work_package.id}:version:multiline" }
+
+        it "outputs one version per line" do
+          expect(formatted.split("  \n")).to match_array(%w[1.0 2.0])
+        end
+      end
+    end
+
     describe "with specific work package ID and attribute" do
       let(:markdown) { "workPackageValue:#{work_package.id}:subject" }