// Default constructor
    }

    /**
     * Installs a theme from the given artifact.
     * Extracts theme files from the JAR and deploys them to appropriate directories.
     *
     * @param artifact the theme artifact to install
     * @throws ThemeException if installation fails
     */
    public void install(final Artifact artifact) {
        final Path jarPath = getJarFile(artifact);

 * This class is immutable and thread-safe, suitable for use in concurrent operations.
 *
 * @param <REQ> The type of the request
 * @param <REP> The type of the response, which must extend {@code Result<REQ>}
 * @param request The original request that was processed
 * @param result The result of the request, if successful; may be null if an error occurred
 * @param error Any error that occurred during processing; null if the request was successful
 * @since 4.0.0

     * Select all toolchains available in user settings matching the type and requirements,
     * independently from <code>maven-toolchains-plugin</code>.
     *
     * @param session the Maven session, must not be {@code null}
     * @param type the type, must not be {@code null}
     * @param requirements the requirements, may be {@code null}
     * @return the matching toolchains, never {@code null}
     * @since 3.3.0
     */

     * Checks if the request path matches any configured encoding rule and
     * performs URL redirection with proper parameter encoding.
     *
     * @param request the servlet request to process
     * @param response the servlet response to use for redirection
     * @param chain the filter chain to continue processing
     * @throws IOException if an I/O error occurs during processing
     * @throws ServletException if a servlet error occurs

     * @param ip the IP address to block
     * @param durationMs the duration in milliseconds (ignored, uses configured value)
     */
    public void blockIp(final String ip, final long durationMs) {
        blockedIps.put(ip, Boolean.TRUE);
        logger.info("IP manually blocked: ip={}", ip);
    }

    /**
     * Unblock an IP address.
     * @param ip the IP address to unblock
     */

    /**
     * Constructor with component name.
     * @param componentName The name of the component that is not available.
     */
    public ContainerNotAvailableException(final String componentName) {
        super(componentName + " is not available.");
        this.componentName = componentName;
    }

    /**
     * Constructor with component name and cause.
     * @param componentName The name of the component that is not available.

     *
     * @param <E> the element type
     * @param value the single value returned by the iterator
     * @return an {@link Iterable} wrapping a {@link SingleValueIterator}
     */
    public static <E> Iterable<E> iterable(final E value) {
        return () -> new SingleValueIterator<>(value);
    }

    /**
     * Constructs an instance.
     *
     * @param value the single value returned by the iterator

     *
     * @param message the detail message
     * @param cause the cause of the exception
     */
    public SMBProtocolDecodingException(final String message, final Throwable cause) {
        super(message, cause);
    }

    /**
     * Constructs a new SMBProtocolDecodingException with the specified detail message.
     *
     * @param message the detail message
     */

    /**
     * Constructs a new PAC decoding exception with the specified detail message.
     * @param message the detail message
     */
    public PACDecodingException(final String message) {
        this(message, null);
    }

    /**
     * Constructs a new PAC decoding exception with the specified cause.
     * @param cause the cause of the exception
     */
    public PACDecodingException(final Throwable cause) {

    /**
     * Constructs a new SuggestSettingsException with the specified detail message.
     * @param msg The detail message.
     */
    public SuggestSettingsException(final String msg) {
        super(msg);
    }

    /**
     * Constructs a new SuggestSettingsException with the specified cause.
     * @param cause The cause.
     */
    public SuggestSettingsException(final Throwable cause) {
        super(cause);