<?php
/**
 * Ability provider contract.
 *
 * @package Adminkeep
 */

namespace Adminkeep;

defined( 'ABSPATH' ) || exit;

/**
 * A feature that offers one or more of its actions to the Abilities API.
 *
 * Deliberately shaped like SurfaceAware: the feature says what it offers, and something else
 * decides how — and whether — to expose it. A feature never calls wp_register_ability() itself,
 * so a core without the Abilities API needs no guard inside any feature.
 */
interface AbilityProvider {

	/**
	 * The abilities this feature offers, keyed by unprefixed name.
	 *
	 * The name is prefixed and the category filled in by the registrar, so a feature cannot
	 * register into someone else's namespace. Every other key is passed to wp_register_ability()
	 * as given: label, description, input_schema, output_schema, meta, and the two callbacks.
	 *
	 * Called only when the feature is enabled and booted, so implementations may rely on the
	 * settings handed to boot().
	 *
	 * @return array<string, array<string, mixed>>
	 */
	public function abilities();
}