Initial commit

kirby/src/Panel/Ui/Stat.php

@@ -0,0 +1,137 @@
+<?php
+
+namespace Kirby\Panel\Ui;
+
+use Kirby\Cms\ModelWithContent;
+use Kirby\Exception\InvalidArgumentException;
+use Kirby\Toolkit\I18n;
+
+/**
+ * @package   Kirby Panel
+ * @author    Bastian Allgeier <bastian@getkirby.com>
+ * @link      https://getkirby.com
+ * @copyright Bastian Allgeier
+ * @license   https://getkirby.com/license
+ * @since     5.1.0
+ */
+class Stat extends Component
+{
+	public function __construct(
+		public array|string $label,
+		public array|string $value,
+		public string $component = 'k-stat',
+		public array|string|null $dialog = null,
+		public array|string|null $drawer = null,
+		public string|null $icon = null,
+		public array|string|null $info = null,
+		public array|string|null $link = null,
+		public ModelWithContent|null $model = null,
+		public string|null $theme = null,
+	) {
+	}
+
+	public function dialog(): string|null
+	{
+		return $this->stringTemplate(
+			$this->i18n($this->dialog)
+		);
+	}
+
+	public function drawer(): string|null
+	{
+		return $this->stringTemplate(
+			$this->i18n($this->drawer)
+		);
+	}
+
+	public static function from(
+		array|string $input,
+		ModelWithContent|null $model = null,
+	): static {
+		if ($model !== null) {
+			if (is_string($input) === true) {
+				$input = $model->query($input);
+
+				if (is_array($input) === false) {
+					throw new InvalidArgumentException(
+						message: 'Invalid data from stat query. The query must return an array.'
+					);
+				}
+			}
+
+			$input['model'] = $model;
+		}
+
+		return new static(...$input);
+	}
+
+	public function icon(): string|null
+	{
+		return $this->stringTemplate($this->icon);
+	}
+
+	public function info(): string|null
+	{
+		return $this->stringTemplate(
+			$this->i18n($this->info)
+		);
+	}
+
+	public function label(): string
+	{
+		return $this->stringTemplate(
+			$this->i18n($this->label)
+		);
+	}
+
+	public function link(): string|null
+	{
+		return $this->stringTemplate(
+			$this->i18n($this->link)
+		);
+	}
+
+	public function props(): array
+	{
+		return [
+			'dialog' => $this->dialog(),
+			'drawer' => $this->drawer(),
+			'icon'   => $this->icon(),
+			'info'   => $this->info(),
+			'label'  => $this->label(),
+			'link'   => $this->link(),
+			'theme'  => $this->theme(),
+			'value'  => $this->value(),
+		];
+	}
+
+	protected function stringTemplate(string|null $string = null): string|null
+	{
+		if ($this->model === null) {
+			return $string;
+		}
+
+		if ($string !== null) {
+			return $this->model->toString($string);
+		}
+
+		return null;
+	}
+
+	public function theme(): string|null
+	{
+		return $this->stringTemplate($this->theme);
+	}
+
+	protected function i18n(string|array|null $param = null): string|null
+	{
+		return empty($param) === false ? I18n::translate($param, $param) : null;
+	}
+
+	public function value(): string
+	{
+		return $this->stringTemplate(
+			$this->i18n($this->value)
+		);
+	}
+}