<?php

/**
 * Interface for plugin API objects.
 * Both CMSAPI (front-end) and AdminPluginAPI (admin) implement this.
 */
interface PluginAPIInterface
{
    public function getConfig(string $key, $default = null);

    /**
     * Get the translations for a plugin in the current context.
     *
     * System plugins resolve against the admin language; content plugins
     * against the current content language. The implementation handles the
     * fallback to the plugin's default_language.
     *
     * @param string $pluginName Plugin directory name
     * @param string|null $lang   Override language (optional)
     * @return array Translations [key => value]
     */
    public function getPluginTranslations(string $pluginName, ?string $lang = null): array;

    /**
     * Translate a single key for a plugin in the current context.
     *
     * @param string $key        Translation key
     * @param string $pluginName Plugin directory name
     * @param string|null $lang   Override language (optional)
     * @return string Translated string, or $key if not found
     */
    public function t(string $key, string $pluginName, ?string $lang = null): string;
}