<?php
/**
 * Contract for classes that register WordPress hooks.
 *
 * @package Postlinkly
 * @since   1.0.0
 */

declare(strict_types=1);

namespace Postlinkly\Hooks;

/**
 * Contract for classes that declare WordPress hooks.
 *
 * Each implementation returns an array describing the hooks it wishes to
 * register. The HookRegistrar walks the array and calls `add_action` /
 * `add_filter` for each entry.
 *
 * Hook entry shape: `[hook_name, callback, priority, accepted_args, type]`
 * where the last three are optional. `type` defaults to `'action'`; pass
 * `'filter'` to register a filter.
 *
 * @since 1.0.0
 */
interface ServiceProvider {

	/**
	 * Returns the hooks this service registers.
	 *
	 * @since 1.0.0
	 *
	 * @return array<int, array{0: string, 1: callable, 2?: int, 3?: int, 4?: 'action'|'filter'}>
	 */
	public function get_hooks(): array;
}