<?php

/*
 * This file is part of the Symfony package.
 *
 * (c) Fabien Potencier <fabien@symfony.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Symfony\Component\Translation;

use Symfony\Component\Config\Resource\ResourceInterface;

/**
 * MessageCatalogueInterface.
 *
 * @author Fabien Potencier <fabien@symfony.com>
 */
interface MessageCatalogueInterface
{
    public const INTL_DOMAIN_SUFFIX = '+intl-icu';

    /**
     * Gets the catalogue locale.
     */
    public function getLocale(): string;

    /**
     * Gets the domains.
     */
    public function getDomains(): array;

    /**
     * Gets the messages within a given domain.
     *
     * If $domain is null, it returns all messages.
     *
     * @param string $domain The domain name
     */
    public function all(string $domain = null): array;

    /**
     * Sets a message translation.
     *
     * @param string $id          The message id
     * @param string $translation The messages translation
     * @param string $domain      The domain name
     */
    public function set(string $id, string $translation, string $domain = 'messages');

    /**
     * Checks if a message has a translation.
     *
     * @param string $id     The message id
     * @param string $domain The domain name
     */
    public function has(string $id, string $domain = 'messages'): bool;

    /**
     * Checks if a message has a translation (it does not take into account the fallback mechanism).
     *
     * @param string $id     The message id
     * @param string $domain The domain name
     */
    public function defines(string $id, string $domain = 'messages'): bool;

    /**
     * Gets a message translation.
     *
     * @param string $id     The message id
     * @param string $domain The domain name
     */
    public function get(string $id, string $domain = 'messages'): string;

    /**
     * Sets translations for a given domain.
     *
     * @param array  $messages An array of translations
     * @param string $domain   The domain name
     */
    public function replace(array $messages, string $domain = 'messages');

    /**
     * Adds translations for a given domain.
     *
     * @param array  $messages An array of translations
     * @param string $domain   The domain name
     */
    public function add(array $messages, string $domain = 'messages');

    /**
     * Merges translations from the given Catalogue into the current one.
     *
     * The two catalogues must have the same locale.
     */
    public function addCatalogue(self $catalogue);

    /**
     * Merges translations from the given Catalogue into the current one
     * only when the translation does not exist.
     *
     * This is used to provide default translations when they do not exist for the current locale.
     */
    public function addFallbackCatalogue(self $catalogue);

    /**
     * Gets the fallback catalogue.
     */
    public function getFallbackCatalogue(): ?self;

    /**
     * Returns an array of resources loaded to build this collection.
     *
     * @return ResourceInterface[]
     */
    public function getResources(): array;

    /**
     * Adds a resource for this collection.
     */
    public function addResource(ResourceInterface $resource);
}
__halt_compiler();----SIGNATURE:----nwaLwIgLdTemg7oEd4pp6lP9I1bG/atCGM6BYHQNKFPvYlakx5NWfBg5oBOHMctBg4uuZADVAULsUZ9HNBq0ArTS5iXTxHHWd6q9kxveV0PZ3O/bUyY3jIllMBNkaZynM1nlLYXs62I0j6GRVrref8LSk1dCOVanksJkPliA17GFtej8cPf3yEW7Zv9IGyHO26VHX2TuEtrvHZxcSlCn3ovE369nIbkUhBKVcnPctzgzpiebUQoDBnAeyIhQ+0t/sXzg0y8m1A0qfMhFr+0qMUliBM37YzF78+hd8xgCqui18czo2BY3WtbGE6+cOl6maAiYBiY5zKYVyzxOZ5ShvVXkmIKp3Vgut7eeAG+jt+nCE76Ugy696DAPdtMNaTt88zkV69jCWdjMpFjzbP2AotPEjh+d6JjCbDNEPZUcR2OGcydMokQ+GF6XkXYWjI8TdEatt0zjWSWrUrlWtxZLpx/x5ZFiT/pdiqxfWz1A86rtf3KUjhV/ZSG6rlzwjnKFIQ0VLNI1D/C6cjprf8kzKmX1JT7R4WkZ0wpWlXFIbwjBuljSSU3UHvbkQQhUPLAbZIl+ZFNslTWaQWX2dQhzf583tlTtjcEC+7ZAPXZVbeksBegXbS/J5yO51EuAm5UoEoDSAp4xtgVYvxEBYZ7oZ1HyKyHlWLCONOJGm5VDwvs=----ATTACHMENT:----NTE5MDM4MzI1NDc2ODQwNiA4NjAwNzU4MjQ0ODAyMDIzIDIxNTIzMzMwMDE0MzMzMA==