*
 * <p>
 * It provides methods to set and retrieve the server address, port, username,
 * password, and domain. Additionally, it offers a method to construct a path
 * prefix for SMB1 URLs based on the configured server and port.
 * </p>
 *
 * <p>
 * The path prefix is in the format "smb1://server:port/", where the port is
 * included only if it's greater than 0. If the server is not set, the path

     * Each type represents a major browser family that can be detected
     * from the User-Agent header string.
     */
    public enum UserAgentType {
        /** Internet Explorer and Trident-based browsers */
        IE,
        /** Mozilla Firefox browser */
        FIREFOX,
        /** Google Chrome browser */
        CHROME,
        /** Apple Safari browser */
        SAFARI,
        /** Opera browser */

  }

  @Override
  public void write(byte[] bytes, int off, int len) throws IOException {
    hasher.putBytes(bytes, off, len);
    out.write(bytes, off, len);
  }

  /**
   * Returns the {@link HashCode} based on the data written to this stream. The result is
   * unspecified if this method is called more than once on the same instance.
   */
  public HashCode hash() {
    return hasher.hash();
  }

in a fashion requiring copyright permission, other than the making of an
exact copy.  The resulting work is called a "modified version" of the
earlier work or a work "based on" the earlier work.

  A "covered work" means either the unmodified Program or a work based
on the Program.

  To "propagate" a work means to do anything with it that, without
permission, would make you directly or secondarily liable for

     */
    public static final String DEFAULT_SELF_COMBINATION_MODE = SELF_COMBINATION_MERGE;

    /** Attribute name for ID-based combination mode */
    public static final String ID_COMBINATION_MODE_ATTRIBUTE = "combine.id";
    /**
     * Attribute name for key-based combination mode.
     * Value should be a comma-separated list of attribute names.
     */

public final class JvmUtil {
    private static final Pattern VERSION_PREFIX_PATTERN = Pattern.compile("([0-9]+)(\\-?):(.*)");

    private JvmUtil() {
        // nothing
    }

    /**
     * Filters JVM options based on the current Java version.
     * Options can be prefixed with version numbers to specify compatibility.
     * Format: "version:option" or "version-:option" (for version and above).
     *

public interface Invoker extends AutoCloseable {
    /**
     * Invokes the Maven application using the provided {@link InvokerRequest}.
     * This method is responsible for executing the Maven command or build
     * process based on the information contained in the request.
     *
     * @param invokerRequest the request containing all necessary information for the invocation

import org.jline.terminal.Terminal;

/**
 * Console icons for Maven upgrade tool output.
 * Each icon has a Unicode character and an ASCII fallback.
 * The appropriate representation is chosen based on the terminal's charset capabilities.
 */
public enum ConsoleIcon {
    /**
     * Success/completion icon.
     */
    SUCCESS('✓', "[OK]"),

    /**
     * Error/failure icon.
     */

        assertEquals(SmbException.getMessageByCode(errCode), ex.getMessage(), "message should reflect error code mapping");
        assertEquals(expectedStatus, ex.getNtStatus(), "status should map based on code");
        assertNull(ex.getCause(), "cause must be null for int constructor");
        assertNull(ex.getRootCause(), "rootCause must be null for int constructor");
    }

    /**

        // TODO: in a moment Maven stop pushing user properties to system properties (and maybe something more)
        // and allow multiple instances per JVM, this may become a pool? derive key based in invokerRequest?
        MavenContext result = residentContext.computeIfAbsent(
                "resident",
                k -> new MavenContext(invokerRequest, false, (MavenOptions)