* and reduces code duplication across strategy implementations.
 *
 * <p>Strategies work with domtrip Documents for perfect formatting preservation.
 * Subclasses can create domtrip Editors from Documents as needed:
 * <pre>
 * Editor editor = new Editor(document);
 * // ... perform domtrip operations ...
 * // Document is automatically updated
 * </pre>
 */
public abstract class AbstractUpgradeStrategy implements UpgradeStrategy {

                    <version>1.0.0</version>
                </project>
                """;

            Document document = Document.of(pomXml);
            ModelVersionUtils.updateModelVersion(document, targetVersion);
            Element root = document.root();
            Element modelVersionElement = root.child("modelVersion").orElse(null);
            assertNotNull(modelVersionElement);

    private final Document document;
    private final JavadocLinkConverter linkConverter;

    public JavadocConverter(Document document, JavadocLinkConverter linkConverter) {
        this.document = document;
        this.linkConverter = linkConverter;
    }

                    <artifactId>child-project</artifactId>
                </project>
                """;

            Document parentDoc = Document.of(parentPomXml);
            Document childDoc = Document.of(childPomXml);

            Map<Path, Document> pomMap = new HashMap<>();
            pomMap.put(Paths.get("/project/pom.xml"), parentDoc);

    private final String javaVersion;

    public LinkRenderer(Document document, DslDocModel model, String groovyVersion, String javaVersion) {
        this.document = document;
        this.model = model;
        this.groovyVersion = groovyVersion;
        this.javaVersion = javaVersion;
        primitiveTypes.add("boolean");
        primitiveTypes.add("byte");
        primitiveTypes.add("short");
        primitiveTypes.add("int");

                </project>
                """;

            Document document = Document.of(pomXml);
            Map<Path, Document> pomMap = Map.of(Paths.get("pom.xml"), document);

            UpgradeContext context = createMockContext();
            strategy.doApply(context, pomMap);

            // Verify the structure
            Editor editor = new Editor(document);
            Element root = editor.root();

                    </dependencies>
                </project>
                """;

            Document parentDoc = Document.of(parentPomXml);
            Document moduleADoc = Document.of(moduleAPomXml);
            Document moduleBDoc = Document.of(moduleBPomXml);

            Map<Path, Document> pomMap = new HashMap<>();
            pomMap.put(Paths.get("project", "pom.xml"), parentDoc);

            UpgradeContext context = createMockContext();
            Map<Path, Document> pomMap = Map.of(
                    Paths.get("pom.xml"), mock(Document.class),
                    Paths.get("module/pom.xml"), mock(Document.class));

            // Mock strategies with different results
            when(mockStrategies.get(0).isApplicable(context)).thenReturn(true);

        use(BuildableDOMCategory) {
            addVersionInfo(provider.document)
            transformApiLinks(provider.document)
            transformWebsiteLinks(provider.document)
            fixProgramListings(provider.document)
        }

        provider.write(destFile.get().asFile)
    }

    def addVersionInfo(Document doc) {
        Element releaseInfo = doc.createElement('releaseinfo')

     * This is used during inference when the model version can be inferred.
     *
     * @param document the XML document
     * @return true if the element was removed, false if it didn't exist
     */
    public static boolean removeModelVersion(Document document) {
        Element root = document.root();
        if (root == null) {
            return false;
        }