<?php

/*
 * This file is part of Chevere.
 *
 * (c) Rodolfo Berrios <rodolfo@chevere.org>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

declare(strict_types=1);

namespace Chevere\Writer\Interfaces;

interface WritersInterface
{
    /**
     * Return an instance with the specified $writer for all writers.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the specified $writer for all writers.
     */
    public function with(WriterInterface $writer): self;

    /**
     * Return an instance with the specified output WriterInterface.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the specified output WriterInterface.
     */
    public function withOutput(WriterInterface $writer): self;

    public function output(): WriterInterface;

    /**
     * Return an instance with the specified error WriterInterface.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the specified error WriterInterface.
     */
    public function withError(WriterInterface $writer): self;

    public function error(): WriterInterface;

    /**
     * Return an instance with the specified debug WriterInterface.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the specified debug WriterInterface.
     */
    public function withDebug(WriterInterface $writer): self;

    public function debug(): WriterInterface;

    /**
     * Return an instance with the specified log WriterInterface.
     *
     * This method MUST retain the state of the current instance, and return
     * an instance that contains the specified log WriterInterface.
     */
    public function withLog(WriterInterface $writer): self;

    public function log(): WriterInterface;
}