Define SelectboxItem entity for safe type check.

Author: janbarasek

src/SelectboxItem.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Baraja\SelectboxTree;
+
+
+final class SelectboxItem
+{
+	/** @var int|string */
+	private $id;
+
+	private string $name;
+
+	/** @var int|string|null */
+	private $parentId;
+
+
+	public function __construct($id, string $name, $parentId = null)
+	{
+		$this->id = $id;
+		$this->name = $name;
+		$this->parentId = $parentId;
+	}
+
+
+	/**
+	 * @return string[]|int[]|null[]
+	 */
+	public function toArray(): array
+	{
+		return [
+			'id' => $this->id,
+			'name' => $this->name,
+			'parent_id' => $this->parentId,
+		];
+	}
+}

src/SelectboxTree.php

@@ -26,18 +26,22 @@ final class SelectboxTree
 	 * |  |  iMac
 	 * |  Windows
 	 *
-	 * @param mixed[][] $data raw database result in format [{"id", "name", "parent_id"}]
+	 * @param mixed[][]|SelectboxItem[] $data raw database result in format [{"id", "name", "parent_id"}]
 	 * @return string[] (id => user haystack)
 	 */
 	public function process(array $data): array
 	{
 		$categories = [];
 		foreach ($data as $item) {
-			$categories[] = [
-				'id' => $item['id'],
-				'name' => $this->nameFormatter === null ? (string) $item['name'] : $this->nameFormatter->format($item['name']),
-				'parent' => $item['parent_id'],
-			];
+			if ($item instanceof SelectboxItem) {
+				$categories[] = $item;
+			} else {
+				$categories[] = [
+					'id' => $item['id'],
+					'name' => $this->nameFormatter === null ? (string) $item['name'] : $this->nameFormatter->format($item['name']),
+					'parent' => $item['parent_id'],
+				];
+			}
 		}
 
 		$return = [];