Feature/mig 386 support accessibility tagging

.gitignore

@@ -41,4 +41,7 @@ bin/
 .DS_Store
 
 ### postgres dev container data ###
-.pgdata/
+.pgdata/
+
+### AI
+.claude/

CHANGELOG.md

@@ -11,6 +11,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 - Added sample input files for DocBook example to the resources folder
 - deployStyles now creates wfd as well as jld style definition for interactive
 - A warning will now be printed if an unsupported GA version of IPS is detected
+- PDF tagging support and alternate text option for tables 
+- PDF tagging support for paragraph styles including support in export/import mapping scripts
+- Alternate text option for images including support in export/import mapping scripts
+- New Hyperlink text content 
 
 ### Changed
 

migration-examples/src/main/groovy/com/quadient/migration/example/common/mapping/ImagesExport.groovy

@@ -27,7 +27,7 @@ static void run(Migration migration, Path imagesDstPath) {
     imagesDstPath.toFile().createParentDirectories()
 
     imagesDstPath.toFile().withWriter { writer ->
-        def headers = ["id", "name", "sourcePath", "imageType", "targetFolder", "status", "skip", "skipPlaceholder", "skipReason", Mapping.displayHeader("originalName", true), Mapping.displayHeader("originLocations", true)]
+        def headers = ["id", "name", "sourcePath", "imageType", "targetFolder", "alternateText", "status", "skip", "skipPlaceholder", "skipReason", Mapping.displayHeader("originalName", true), Mapping.displayHeader("originLocations", true)]
         writer.writeLine(headers.join(","))
         images.each { obj ->
             def status = migration.statusTrackingRepository.findLastEventRelevantToOutput(obj.id,
@@ -40,6 +40,7 @@ static void run(Migration migration, Path imagesDstPath) {
             builder.append("," + Csv.serialize(obj.sourcePath))
             builder.append("," + Csv.serialize(obj.imageType))
             builder.append("," + Csv.serialize(obj.targetFolder))
+            builder.append("," + Csv.serialize(obj.alternateText))
             builder.append("," + Csv.serialize(status.class.simpleName))
             builder.append("," + Csv.serialize(obj.skip.skipped))
             builder.append("," + Csv.serialize(obj.skip.placeholder))

migration-examples/src/main/groovy/com/quadient/migration/example/common/mapping/ImagesImport.groovy

@@ -55,6 +55,9 @@ static void run(Migration migration, Path imagesFilePath) {
         def newTargetFolder = Csv.deserialize(values.get("targetFolder"), String.class)
         Mapping.mapProp(existingMapping, existingImage, "targetFolder", newTargetFolder)
 
+        def newAlternateText = Csv.deserialize(values.get("alternateText"), String.class)
+        Mapping.mapProp(existingMapping, existingImage, "alternateText", newAlternateText)
+
         def csvStatus = values.get("status")
         if (status != null && csvStatus == "Active" && status.class.simpleName != "Active") {
             migration.statusTrackingRepository.active(existingImage.id, ResourceType.Image, [reason: "Manual"])

migration-examples/src/main/groovy/com/quadient/migration/example/common/mapping/ParagraphStylesExport.groovy

@@ -27,7 +27,7 @@ static void run(Migration migration, Path exportFilePath) {
 
     def styles = migration.paragraphStyleRepository.listAll()
     file.withWriter { writer ->
-        def headers = ["id","name","targetId","leftIndent","rightIndent","defaultTabSize","spaceBefore","spaceAfter","alignment","firstLineIndent","keepWithNextParagraph","lineSpacingType","lineSpacingValue", Mapping.displayHeader("originLocations", true)]
+        def headers = ["id", "name", "targetId", "leftIndent", "rightIndent", "defaultTabSize", "spaceBefore", "spaceAfter", "alignment", "firstLineIndent", "keepWithNextParagraph", "lineSpacingType", "lineSpacingValue", "pdfTaggingRule", Mapping.displayHeader("originLocations", true)]
         writer.writeLine(headers.join(","))
 
         styles.each { style ->
@@ -64,7 +64,8 @@ static StringBuilder serializeDefinition(ParagraphStyleDefinition definition) {
     builder << "${Csv.serialize(definition?.firstLineIndent)},"
     builder << "${Csv.serialize(definition?.keepWithNextParagraph)},"
     // Linespacing serializes as two columns
-    builder << "${Csv.serialize(definition?.lineSpacing)}"
+    builder << "${Csv.serialize(definition?.lineSpacing)},"
+    builder << "${Csv.serialize(definition?.pdfTaggingRule)}"
 
     return builder
 }

migration-examples/src/main/groovy/com/quadient/migration/example/common/mapping/ParagraphStylesImport.groovy

@@ -58,7 +58,7 @@ static void mapStyle(Migration migration, ParagraphStyle existingStyle, String s
     if (styleRefId.empty) {
         MappingItem.ParagraphStyle.Def mappingDefinition
         if (!(mapping.definition instanceof MappingItem.ParagraphStyle.Def)) {
-            mappingDefinition = new MappingItem.ParagraphStyle.Def(null, null, null, null, null, null, null, null, null, null)
+            mappingDefinition = new MappingItem.ParagraphStyle.Def(null, null, null, null, null, null, null, null, null, null, null)
         } else {
             mappingDefinition = mapping.definition as MappingItem.ParagraphStyle.Def
         }

migration-examples/src/main/groovy/com/quadient/migration/example/example/Import.groovy

@@ -23,6 +23,8 @@ import com.quadient.migration.shared.GroupOp
 import com.quadient.migration.shared.ImageOptions
 import com.quadient.migration.shared.ImageType
 import com.quadient.migration.shared.PageOptions
+import com.quadient.migration.shared.ParagraphPdfTaggingRule
+import com.quadient.migration.shared.TablePdfTaggingRule
 import com.quadient.migration.shared.Size
 
 import java.time.Instant
@@ -119,6 +121,13 @@ def headingStyle = new TextStyleBuilder("headingStyle")
     }
     .build()
 
+def headingParaStyle = new ParagraphStyleBuilder("headingParagraphStyle")
+        .definition {
+            it.spaceAfter(Size.ofMillimeters(3))
+            it.pdfTaggingRule(ParagraphPdfTaggingRule.Heading1)
+        }
+        .build()
+
 def paragraphStyle = new ParagraphStyleBuilder("paragraphStyle")
     .definition {
         it.firstLineIndent(Size.ofMillimeters(10))
@@ -137,12 +146,15 @@ def logo = new ImageBuilder("logo")
     .sourcePath(logoImageName)
     .imageType(ImageType.Png)
     .subject("Example logo")
+    .alternateText("Example logo image")
     .build()
 
 // Table containing some data with the first address row being optionally hidden
 // by using displayRuleRef to the display displayHeaderRule defined above.
 // The table also contains some merged cells and custom column widths.
 def table = table {
+    it.pdfTaggingRule(TablePdfTaggingRule.Table)
+    it.pdfAlternateText("Example key value table")
     it.addColumnWidth(Size.ofMillimeters(10), 10)
     it.addColumnWidth(Size.ofMillimeters(20), 20)
     it.addColumnWidth(Size.ofMillimeters(98), 70)
@@ -229,6 +241,7 @@ def paragraph1 = new DocumentObjectBuilder("paragraph1", DocumentObjectType.Bloc
             it.styleRef(headingStyle.id)
             it.string("Lorem ipsum dolor sit amet\n")
         }
+        it.styleRef(headingParaStyle.id)
     }
     .paragraph {
         it.styleRef(paragraphStyle.id)
@@ -365,6 +378,13 @@ def page = new DocumentObjectBuilder("page1", DocumentObjectType.Page)
             .documentObjectRef(conditionalParagraph.id)
             .documentObjectRef(firstMatchBlock.id)
             .documentObjectRef(selectByLanguageBlock.id)
+            .paragraph {
+                it.styleRef(paragraphStyle.id).text {
+                    it.styleRef(normalStyle.id)
+                            .string("For more information visit ")
+                            .hyperlink("https://github.com/quadient/migration-stack", "Migration Stack GitHub", "Migration Stack GitHub URL link")
+                }
+            }
     }
     .area {
         it.position {
@@ -397,7 +417,7 @@ for (item in [displayHeaderVariable, displayParagraphVariable, displayLastSenten
 for (item in [displayAddressRule, displayHeaderRule, displayParagraphRule, displayLastSentenceRule, displayRuleStateCzechia, displayRuleStateFrance]) {
     migration.displayRuleRepository.upsert(item)
 }
-for (item in [paragraphStyle]) {
+for (item in [paragraphStyle, headingParaStyle]) {
     migration.paragraphStyleRepository.upsert(item)
 }
 

migration-examples/src/test/groovy/ImagesMappingExportTest.groovy

@@ -25,22 +25,22 @@ class ImagesMappingExportTest {
         def migration = Utils.mockMigration()
 
         when(migration.imageRepository.listAll()).thenReturn([
-                new Image("empty", null, [], new CustomFieldMap([:]), null, null, null, null, [:], emptySkipOptions()),
-                new Image("full", "full", ["foo", "bar"], new CustomFieldMap([:]), "sourcePath", null, ImageType.Jpeg, "targetDir", [:], new SkipOptions(true, "placeholder", "reason")),
-                new Image("overridden empty", null, [], new CustomFieldMap([:]), null, null, null, null, [:], emptySkipOptions()),
-                new Image("overridden full", "full", ["foo", "bar"], new CustomFieldMap(["originalName": "originalFull"]), "sourcePath", null, ImageType.Gif, "targetDir", [:], emptySkipOptions()),
+                new Image("empty", null, [], new CustomFieldMap([:]), null, null, null, null, [:], emptySkipOptions(), null),
+                new Image("full", "full", ["foo", "bar"], new CustomFieldMap([:]), "sourcePath", null, ImageType.Jpeg, "targetDir", [:], new SkipOptions(true, "placeholder", "reason"), "Alt text for full"),
+                new Image("overridden empty", null, [], new CustomFieldMap([:]), null, null, null, null, [:], emptySkipOptions(), null),
+                new Image("overridden full", "full", ["foo", "bar"], new CustomFieldMap(["originalName": "originalFull"]), "sourcePath", null, ImageType.Gif, "targetDir", [:], emptySkipOptions(), "Alt text for overridden"),
         ])
 
         when(migration.statusTrackingRepository.findLastEventRelevantToOutput(any(), any(), any())).thenReturn(new Active())
 
         ImagesExport.run(migration, mappingFile)
 
         def expected = """\
-            id,name,sourcePath,imageType,targetFolder,status,skip,skipPlaceholder,skipReason,originalName (read-only),originLocations (read-only)
-            empty,,,,,Active,false,,,,[]
-            full,full,sourcePath,Jpeg,targetDir,Active,true,placeholder,reason,,[foo; bar]
-            overridden empty,,,,,Active,false,,,,[]
-            overridden full,full,sourcePath,Gif,targetDir,Active,false,,,originalFull,[foo; bar]
+            id,name,sourcePath,imageType,targetFolder,alternateText,status,skip,skipPlaceholder,skipReason,originalName (read-only),originLocations (read-only)
+            empty,,,,,,Active,false,,,,[]
+            full,full,sourcePath,Jpeg,targetDir,Alt text for full,Active,true,placeholder,reason,,[foo; bar]
+            overridden empty,,,,,,Active,false,,,,[]
+            overridden full,full,sourcePath,Gif,targetDir,Alt text for overridden,Active,false,,,originalFull,[foo; bar]
             """.stripIndent()
         Assertions.assertEquals(expected, mappingFile.toFile().text.replaceAll("\\r\\n|\\r", "\n"))
     }

migration-examples/src/test/groovy/ImagesMappingImportTest.groovy

@@ -35,11 +35,11 @@ class ImagesMappingImportTest {
 
         ImagesImport.run(migration, mappingFile)
 
-        verify(migration.mappingRepository, times(1)).upsert("unchanged", new MappingItem.Image(null, null, null, null, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("unchanged", new MappingItem.Image(null, null, null, null, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("unchanged")
-        verify(migration.mappingRepository, times(1)).upsert("kept", new MappingItem.Image("keptName", null, null, null, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("kept", new MappingItem.Image("keptName", null, null, null, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("kept")
-        verify(migration.mappingRepository, times(1)).upsert("overridden", new MappingItem.Image("someName", null, null, null, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("overridden", new MappingItem.Image("someName", null, null, null, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("overridden")
     }
 
@@ -63,11 +63,11 @@ class ImagesMappingImportTest {
 
         ImagesImport.run(migration, mappingFile)
 
-        verify(migration.mappingRepository, times(1)).upsert("unchanged", new MappingItem.Image(null, null, null, null, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("unchanged", new MappingItem.Image(null, null, null, null, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("unchanged")
-        verify(migration.mappingRepository, times(1)).upsert("kept", new MappingItem.Image(null, "keptFolder", null, null, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("kept", new MappingItem.Image(null, "keptFolder", null, null, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("kept")
-        verify(migration.mappingRepository, times(1)).upsert("overridden", new MappingItem.Image(null, "overrideFolder", null, null, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("overridden", new MappingItem.Image(null, "overrideFolder", null, null, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("overridden")
     }
 
@@ -91,11 +91,11 @@ class ImagesMappingImportTest {
 
         ImagesImport.run(migration, mappingFile)
 
-        verify(migration.mappingRepository, times(1)).upsert("unchanged", new MappingItem.Image(null, null, null, null, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("unchanged", new MappingItem.Image(null, null, null, null, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("unchanged")
-        verify(migration.mappingRepository, times(1)).upsert("kept", new MappingItem.Image(null, null, "keptPath", null, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("kept", new MappingItem.Image(null, null, "keptPath", null, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("kept")
-        verify(migration.mappingRepository, times(1)).upsert("overridden", new MappingItem.Image(null, null, "overridePath", null, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("overridden", new MappingItem.Image(null, null, "overridePath", null, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("overridden")
     }
 
@@ -119,11 +119,11 @@ class ImagesMappingImportTest {
 
         ImagesImport.run(migration, mappingFile)
 
-        verify(migration.mappingRepository, times(1)).upsert("unchanged", new MappingItem.Image(null, null, null, null, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("unchanged", new MappingItem.Image(null, null, null, null, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("unchanged")
-        verify(migration.mappingRepository, times(1)).upsert("kept", new MappingItem.Image(null, null, null, ImageType.Jpeg, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("kept", new MappingItem.Image(null, null, null, ImageType.Jpeg, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("kept")
-        verify(migration.mappingRepository, times(1)).upsert("overridden", new MappingItem.Image(null, null, null, ImageType.Gif, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("overridden", new MappingItem.Image(null, null, null, ImageType.Gif, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("overridden")
     }
 
@@ -147,16 +147,44 @@ class ImagesMappingImportTest {
 
         ImagesImport.run(migration, mappingFile)
 
-        verify(migration.mappingRepository, times(1)).upsert("unchanged", new MappingItem.Image(null, null, null, null, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("unchanged", new MappingItem.Image(null, null, null, null, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("unchanged")
-        verify(migration.mappingRepository, times(1)).upsert("kept", new MappingItem.Image(null, null, null, ImageType.Jpeg, new SkipOptions(false, null, null)))
+        verify(migration.mappingRepository, times(1)).upsert("kept", new MappingItem.Image(null, null, null, ImageType.Jpeg, new SkipOptions(false, null, null), null))
         verify(migration.mappingRepository, times(1)).applyImageMapping("kept")
-        verify(migration.mappingRepository, times(1)).upsert("overridden", new MappingItem.Image(null, null, null, ImageType.Gif, new SkipOptions(true, "placeholder", "reason")))
+        verify(migration.mappingRepository, times(1)).upsert("overridden", new MappingItem.Image(null, null, null, ImageType.Gif, new SkipOptions(true, "placeholder", "reason"), null))
+        verify(migration.mappingRepository, times(1)).applyImageMapping("overridden")
+    }
+
+    @Test
+    void overridesAlternateText() {
+        def migration = Utils.mockMigration()
+        Path mappingFile = Paths.get(dir.path, "testProject.csv")
+        def input = """\
+            id,name,sourcePath,imageType,targetFolder,alternateText,status,originLocations
+            unchanged,,,,,,Active,[]
+            kept,,,,,keptAltText,Active,[]
+            overridden,,,,,overriddenAltText,Active,[]
+            """.stripIndent()
+        mappingFile.toFile().write(input)
+        givenExistingImage(migration, "unchanged", null, null, null, null)
+        givenExistingImageMapping(migration, "unchanged", null, null, null, null)
+        givenExistingImage(migration, "kept", null, null, null, null)
+        givenExistingImageMapping(migration, "kept", null, null, null, null)
+        givenExistingImage(migration, "overridden", null, null, null, null)
+        givenExistingImageMapping(migration, "overridden", null, null, null, null)
+
+        ImagesImport.run(migration, mappingFile)
+
+        verify(migration.mappingRepository, times(1)).upsert("unchanged", new MappingItem.Image(null, null, null, null, new SkipOptions(false, null, null), null))
+        verify(migration.mappingRepository, times(1)).applyImageMapping("unchanged")
+        verify(migration.mappingRepository, times(1)).upsert("kept", new MappingItem.Image(null, null, null, null, new SkipOptions(false, null, null), "keptAltText"))
+        verify(migration.mappingRepository, times(1)).applyImageMapping("kept")
+        verify(migration.mappingRepository, times(1)).upsert("overridden", new MappingItem.Image(null, null, null, null, new SkipOptions(false, null, null), "overriddenAltText"))
         verify(migration.mappingRepository, times(1)).applyImageMapping("overridden")
     }
 
     static void givenExistingImage(Migration mig, String id, String name, String targetFolder, String sourcePath, ImageType imageType) {
-        when(mig.imageRepository.find(id)).thenReturn(new Image(id, name, [], new CustomFieldMap([:]), sourcePath, null, imageType, targetFolder, [:], new SkipOptions(false, null, null)))
+        when(mig.imageRepository.find(id)).thenReturn(new Image(id, name, [], new CustomFieldMap([:]), sourcePath, null, imageType, targetFolder, [:], new SkipOptions(false, null, null), null))
     }
 
     static void givenExistingImageMapping(Migration mig,
@@ -166,6 +194,6 @@ class ImagesMappingImportTest {
                                           String sourcePath,
                                           ImageType imageType) {
         when(mig.mappingRepository.getImageMapping(id))
-                .thenReturn(new MappingItem.Image(name, targetFolder, sourcePath, imageType, null))
+                .thenReturn(new MappingItem.Image(name, targetFolder, sourcePath, imageType, null, null))
     }
 }