From 4d8e98f34bc11306ff03f0d1b79c1f15bae0f151 Mon Sep 17 00:00:00 2001
From: peptiderepo <peptiderepo@users.noreply.github.com>
Date: Fri, 24 Apr 2026 10:00:38 +0700
Subject: [PATCH] feat: add PR_Core_Related_Posts_Provider interface

---
 .../interface-related-posts-provider.php      | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 includes/interfaces/interface-related-posts-provider.php

diff --git a/includes/interfaces/interface-related-posts-provider.php b/includes/interfaces/interface-related-posts-provider.php
new file mode 100644
index 0000000..d999c1d
--- /dev/null
+++ b/includes/interfaces/interface-related-posts-provider.php
@@ -0,0 +1,21 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Interface for fetching related posts for a peptide.
+ *
+ * What: Defines the contract for retrieving posts related to a given peptide.
+ * Who calls it: PR_Core_Related_Posts_Section uses implementations to fetch related articles.
+ * Dependencies: None.
+ */
+interface PR_Core_Related_Posts_Provider {
+
+	/**
+	 * Get posts related to a peptide.
+	 *
+	 * @param int $peptide_id The peptide post ID.
+	 * @param int $limit      Maximum number of posts to return.
+	 * @return array<int, \WP_Post> Array of WP_Post objects (may be empty).
+	 */
+	public function get_posts( int $peptide_id, int $limit ): array;
+}