<?php
/**
 * Agentmatica plugin module contract.
 *
 * @package Agentmatica
 */

declare(strict_types=1);

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

interface Agentmatica_Module_Interface {
	/** Stable module id, e.g. content, woocommerce. */
	public function get_id(): string;

	/** Human-readable module label for admin UI. */
	public function get_label(): string;

	/** Short description shown in admin. */
	public function get_description(): string;

	/** Whether dependencies for this module are present (e.g. WooCommerce installed). */
	public function is_available(): bool;

	/** Whether admins can enable or disable this module in settings. */
	public function is_configurable(): bool;

	/** Whether the module is enabled in plugin settings. */
	public function is_enabled(): bool;

	/** Whether the module should boot and expose abilities right now. */
	public function is_active(): bool;

	/** Register hooks (REST routes, etc.) when the module is active. */
	public function boot(): void;

	/**
	 * Ability definitions keyed by ability name.
	 *
	 * @return array<string, array<string, mixed>>
	 */
	public function get_abilities(): array;
}