/*
    * Licensed to the Apache Software Foundation (ASF) under one
    * or more contributor license agreements.  See the NOTICE file
    * distributed with this work for additional information
    * regarding copyright ownership.  The ASF licenses this file
    * to you under the Apache License, Version 2.0 (the
    * "License"); you may not use this file except in compliance
    * with the License.  You may obtain a copy of the License at
    *
   *   http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing,
   * software distributed under the License is distributed on an
   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   * KIND, either express or implied.  See the License for the
   * specific language governing permissions and limitations
   * under the License.
   */
  package org.apache.maven.message;
  
  /**
   * Message builder that supports configurable styling.
   *
   * @since 3.10.0
   * @see MessageBuilderFactory
   */
  public interface MessageBuilder extends Appendable {
  
      /**
       * Append message content in trace style.
       * By default, bold magenta
       *
       * @param message the message to append
       * @return the current builder
       */
      default MessageBuilder trace(Object message) {
          return style("." + Constants.MAVEN_STYLE_TRACE_NAME + ":-" + Constants.MAVEN_STYLE_TRACE_DEFAULT, message);
      }
  
      /**
       * Append message content in debug style.
       * By default, bold cyan
       *
       * @param message the message to append
       * @return the current builder
       */
      default MessageBuilder debug(Object message) {
          return style("." + Constants.MAVEN_STYLE_DEBUG_NAME + ":-" + Constants.MAVEN_STYLE_DEBUG_DEFAULT, message);
      }
  
      /**
       * Append message content in info style.
       * By default, bold blue
       *
       * @param message the message to append
       * @return the current builder
       */
      default MessageBuilder info(Object message) {
          return style("." + Constants.MAVEN_STYLE_INFO_NAME + ":-" + Constants.MAVEN_STYLE_INFO_DEFAULT, message);
      }
  
      /**
       * Append message content in warning style.
       * By default, bold yellow
       *
       * @param message the message to append
       * @return the current builder
       */
      default MessageBuilder warning(Object message) {
          return style("." + Constants.MAVEN_STYLE_WARNING_NAME + ":-" + Constants.MAVEN_STYLE_WARNING_DEFAULT, message);
      }
  
      /**
       * Append message content in error style.
       * By default, bold red
       *
       * @param message the message to append
       * @return the current builder
       */
      default MessageBuilder error(Object message) {
          return style("." + Constants.MAVEN_STYLE_ERROR_NAME + ":-" + Constants.MAVEN_STYLE_ERROR_DEFAULT, message);
      }
  
      /**
       * Append message content in success style.
       * By default, bold green
       *
       * @param message the message to append
       * @return the current builder
       */
      default MessageBuilder success(Object message) {
          return style("." + Constants.MAVEN_STYLE_SUCCESS_NAME + ":-" + Constants.MAVEN_STYLE_SUCCESS_DEFAULT, message);
      }
  
      /**
       * Append message content in failure style.
       * By default, bold red
       *
       * @param message the message to append
      * @return the current builder
      */
     default MessageBuilder failure(Object message) {
         return style("." + Constants.MAVEN_STYLE_FAILURE_NAME + ":-" + Constants.MAVEN_STYLE_FAILURE_DEFAULT, message);
     }
 
     /**
      * Append message content in strong style.
      * By default, bold
      *
      * @param message the message to append
      * @return the current builder
      */
     default MessageBuilder strong(Object message) {
         return style("." + Constants.MAVEN_STYLE_STRONG_NAME + ":-" + Constants.MAVEN_STYLE_STRONG_DEFAULT, message);
     }
 
     /**
      * Append message content in mojo style.
      * By default, green
      *
      * @param message the message to append
      * @return the current builder
      */
     default MessageBuilder mojo(Object message) {
         return style("." + Constants.MAVEN_STYLE_MOJO_NAME + ":-" + Constants.MAVEN_STYLE_MOJO_DEFAULT, message);
     }
 
     /**
      * Append message content in project style.
      * By default, cyan
      *
      * @param message the message to append
      * @return the current builder
      */
     default MessageBuilder project(Object message) {
         return style("." + Constants.MAVEN_STYLE_PROJECT_NAME + ":-" + Constants.MAVEN_STYLE_PROJECT_DEFAULT, message);
     }
 
     default MessageBuilder style(String style, Object message) {
         return style(style).a(message).resetStyle();
     }
 
     MessageBuilder style(String style);
 
     MessageBuilder resetStyle();
 
     //
     // message building methods modelled after Ansi methods
     //
 
     @Override
     MessageBuilder append(CharSequence cs);
 
     @Override
     MessageBuilder append(CharSequence cs, int start, int end);
 
     @Override
     MessageBuilder append(char c);
 
     /**
      * Append content to the message buffer.
      *
      * @param value the content to append
      * @param offset the index of the first {@code char} to append
      * @param len the number of {@code char}s to append
      * @return the current builder
      */
     default MessageBuilder a(char[] value, int offset, int len) {
         return append(String.valueOf(value, offset, len));
     }
 
     /**
      * Append content to the message buffer.
      *
      * @param value the content to append
      * @return the current builder
      */
     default MessageBuilder a(char[] value) {
         return append(String.valueOf(value));
     }
 
     /**
      * Append content to the message buffer.
      *
      * @param value the content to append
      * @param start the starting index of the subsequence to be appended
      * @param end the end index of the subsequence to be appended
      * @return the current builder
      */
     default MessageBuilder a(CharSequence value, int start, int end) {
         return append(value, start, end);
     }
 
     /**
      * Append content to the message buffer.
      *
      * @param value the content to append
      * @return the current builder
      */
     default MessageBuilder a(CharSequence value) {
         return append(value);
     }
 
     /**
      * Append content to the message buffer.
      *
      * @param value the content to append
      * @return the current builder
      */
     default MessageBuilder a(Object value) {
         return append(String.valueOf(value));
     }
 
     /**
      * Append newline to the message buffer.
      *
      * @return the current builder
      */
     default MessageBuilder newline() {
         return append(System.lineSeparator());
     }
 
     /**
      * Append formatted content to the buffer.
      * @see String#format(String, Object...)
      *
      * @param pattern a <a href="../util/Formatter.html#syntax">format string</a>
      * @param args arguments referenced by the format specifiers in the format string
      * @return the current builder
      */
     default MessageBuilder format(String pattern, Object... args) {
         return append(String.format(pattern, args));
     }
 
     /**
      * Set the buffer length.
      *
      * @param length the new length
      * @return the current builder
      */
     MessageBuilder setLength(int length);
 
     /**
      * Return the built message.
      *
      * @return the message
      */
     String build();
 
     class Constants {
         // Style Names
         public static final String MAVEN_STYLE_TRANSFER_NAME = "transfer";
         public static final String MAVEN_STYLE_TRACE_NAME = "trace";
         public static final String MAVEN_STYLE_DEBUG_NAME = "debug";
         public static final String MAVEN_STYLE_INFO_NAME = "info";
         public static final String MAVEN_STYLE_WARNING_NAME = "warning";
         public static final String MAVEN_STYLE_ERROR_NAME = "error";
         public static final String MAVEN_STYLE_SUCCESS_NAME = "success";
         public static final String MAVEN_STYLE_FAILURE_NAME = "failure";
         public static final String MAVEN_STYLE_STRONG_NAME = "strong";
         public static final String MAVEN_STYLE_MOJO_NAME = "mojo";
         public static final String MAVEN_STYLE_PROJECT_NAME = "project";
 
         // Default Values
         public static final String MAVEN_STYLE_TRANSFER_DEFAULT = "f:bright-black";
         public static final String MAVEN_STYLE_TRACE_DEFAULT = "bold,f:magenta";
         public static final String MAVEN_STYLE_DEBUG_DEFAULT = "bold,f:cyan";
         public static final String MAVEN_STYLE_INFO_DEFAULT = "bold,f:blue";
         public static final String MAVEN_STYLE_WARNING_DEFAULT = "bold,f:yellow";
         public static final String MAVEN_STYLE_ERROR_DEFAULT = "bold,f:red";
         public static final String MAVEN_STYLE_SUCCESS_DEFAULT = "bold,f:green";
         public static final String MAVEN_STYLE_FAILURE_DEFAULT = "bold,f:red";
         public static final String MAVEN_STYLE_STRONG_DEFAULT = "bold";
         public static final String MAVEN_STYLE_MOJO_DEFAULT = "f:green";
         public static final String MAVEN_STYLE_PROJECT_DEFAULT = "f:cyan";
     }
 }