<?php
/**
 * The WordPress Core connector.
 *
 * @package Transtrix
 */

namespace Transtrix\Modules\Core;

use Transtrix\Contracts\Module;

defined( 'ABSPATH' ) || exit;

/**
 * Posts, pages, media and the core taxonomies.
 *
 * Data, not code (invariant A1). Everything this class does is answer questions
 * about which objects belong to it; the engine does the moving.
 */
class Core_Module extends Module {

	/**
	 * Module id.
	 *
	 * @return string
	 */
	public function id(): string {
		return 'wp-core';
	}

	/**
	 * Human label.
	 *
	 * @return string
	 */
	public function label(): string {
		return __( 'WordPress Core', 'transtrix' );
	}

	/**
	 * Core is always there.
	 *
	 * @return bool
	 */
	public function is_available(): bool {
		return true;
	}

	/**
	 * Card subtitle.
	 *
	 * @return string
	 */
	public function source(): string {
		return __( 'Built into WordPress', 'transtrix' );
	}

	/**
	 * Card description.
	 *
	 * @return string
	 */
	public function description(): string {
		return __( 'Posts, pages and media, with their categories and tags.', 'transtrix' );
	}

	/**
	 * Post types this module owns.
	 *
	 * Attachments are listed because media travels with content; they are
	 * collected through the media path rather than as plain post records.
	 *
	 * @return string[]
	 */
	public function post_types(): array {
		return array( 'post', 'page', 'attachment' );
	}

	/**
	 * Taxonomies this module owns.
	 *
	 * @return string[]
	 */
	public function taxonomies(): array {
		return array( 'category', 'post_tag' );
	}

	/**
	 * Meta keys that hold references to other objects.
	 *
	 * @return array<string,string>
	 */
	public function reference_hints(): array {
		return array(
			'_thumbnail_id' => 'attachment',
		);
	}

	/**
	 * Counts for the module card.
	 *
	 * @return array<string,int>
	 */
	public function counts(): array {
		$counts = array();

		foreach ( $this->post_types() as $post_type ) {
			$per_status = wp_count_posts( $post_type );

			// Attachments are never 'publish' — they inherit their parent's status.
			$status = 'attachment' === $post_type ? 'inherit' : 'publish';

			$counts[ $post_type ] = isset( $per_status->$status ) ? (int) $per_status->$status : 0;
		}

		foreach ( $this->taxonomies() as $taxonomy ) {
			$total = wp_count_terms(
				array(
					'taxonomy'   => $taxonomy,
					'hide_empty' => false,
				)
			);

			$counts[ $taxonomy ] = is_wp_error( $total ) ? 0 : (int) $total;
		}

		return $counts;
	}
}