* </ul>
 *
 * <h3>Format Preservation</h3>
 * <ul>
 *   <li><strong>Whitespace Preservation</strong>: Maintains original formatting when removing elements</li>
 *   <li><strong>Comment Preservation</strong>: Preserves XML comments and processing instructions</li>

 *
 * <p>This class recursively discovers all POM files in a Maven project hierarchy
 * and loads them as domtrip Documents. Individual strategies can create domtrip Editors
 * from these Documents as needed for superior formatting preservation.
 */
public class PomDiscovery {

    private PomDiscovery() {
        // noop
    }

    /**
     * Discovers and loads all POM files starting from the given directory.
     *

/**
 * Strategy interface for different types of upgrade operations.
 * Each strategy handles a specific aspect of the Maven upgrade process.
 *
 * <p>Strategies work with domtrip Documents for perfect formatting preservation.
 * Individual strategies can create domtrip Editors from Documents as needed:
 * <pre>
 * Editor editor = new Editor(document);
 * // ... perform domtrip operations ...
 * // Document is automatically updated

/**
 * domtrip-based orchestrator for executing different upgrade strategies.
 *
 * <p>This class provides the same functionality as StrategyOrchestrator but works
 * with domtrip-based strategies for superior formatting preservation.
 *
 * <p>Determines which strategies to apply based on options and executes them in priority order.
 * The DI container automatically sorts the injected strategies by their @Priority annotations.
 */

/**
 * Abstract base class for upgrade strategies that provides common functionality
 * 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>
 */

/**
 * Utility class for handling Maven model version operations during upgrades.
 *
 * <p>This class uses domtrip internally for superior formatting preservation
 * and simplified API while maintaining the same external interface.
 */
public final class ModelVersionUtils {

    private ModelVersionUtils() {
        // Utility class
    }

    /**

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertNotNull;

/**
 * Comprehensive test suite for Properties behavior in Maven models.
 * Tests order preservation, caching behavior, and WrapperProperties functionality.
 */
class PropertiesTest {

    @Nested
    class OrderPreservationTests {

        @Test
        void testPropertiesOrderPreservedInImmutableModel() {

            assertArrayEquals(secondEncoding, thirdEncoding, "Second and third encoding should be identical");

            // Verify content preservation
            assertArrayEquals(mechs, parsed2.getMechanisms());
            assertEquals(flags, parsed2.getContextFlags());
            assertArrayEquals(mechToken, parsed2.getMechanismToken());

        responseData3.setUrl("file:///local/file.txt");
        Rule matchedRule3 = ruleManager.getRule(responseData3);
        assertNull(matchedRule3); // No match
    }

    /**
     * Test rule order preservation
     */
    public void test_ruleOrderPreservation() {
        TestRule rule1 = new TestRule("rule1", false);
        TestRule rule2 = new TestRule("rule2", true);

         * a clear specification for what annotations should mean on resolved TypeVariables
         * with modified bounds, annotation methods will throw
         * UnsupportedOperationException. Frameworks requiring annotation preservation
         * should use the original TypeVariable when bounds haven't changed.
         */
        if (Types.NativeTypeVariableEquals.NATIVE_TYPE_VARIABLE_ONLY
            && Arrays.equals(bounds, resolvedBounds)) {