Add Conditionable traits & phpdoc

src/Alert.php

@@ -2,10 +2,13 @@
 
 namespace Native\Desktop;
 
+use Illuminate\Support\Traits\Conditionable;
 use Native\Desktop\Client\Client;
 
 class Alert
 {
+    use Conditionable;
+
     protected ?string $type = null;
 
     protected ?string $title = null;

src/App.php

@@ -2,11 +2,14 @@
 
 namespace Native\Desktop;
 
+use Illuminate\Support\Traits\Conditionable;
 use Native\Desktop\Client\Client;
 use Phar;
 
 class App
 {
+    use Conditionable;
+
     public function __construct(protected Client $client) {}
 
     public function quit(): void

src/AutoUpdater.php

@@ -2,10 +2,13 @@
 
 namespace Native\Desktop;
 
+use Illuminate\Support\Traits\Conditionable;
 use Native\Desktop\Client\Client;
 
 class AutoUpdater
 {
+    use Conditionable;
+
     public function __construct(protected Client $client) {}
 
     public function checkForUpdates(): void

src/ChildProcess.php

@@ -2,11 +2,14 @@
 
 namespace Native\Desktop;
 
+use Illuminate\Support\Traits\Conditionable;
 use Native\Desktop\Client\Client;
 use Native\Desktop\Contracts\ChildProcess as ChildProcessContract;
 
 class ChildProcess implements ChildProcessContract
 {
+    use Conditionable;
+
     public readonly int $pid;
 
     public readonly string $alias;

src/Clipboard.php

@@ -2,10 +2,13 @@
 
 namespace Native\Desktop;
 
+use Illuminate\Support\Traits\Conditionable;
 use Native\Desktop\Client\Client;
 
 class Clipboard
 {
+    use Conditionable;
+
     public function __construct(protected Client $client) {}
 
     public function clear()

src/Dock.php

@@ -2,11 +2,14 @@
 
 namespace Native\Desktop;
 
+use Illuminate\Support\Traits\Conditionable;
 use Native\Desktop\Client\Client;
 use Native\Desktop\Menu\Menu;
 
 class Dock
 {
+    use Conditionable;
+
     public function __construct(protected Client $client) {}
 
     public function menu(Menu $menu)

src/Facades/Alert.php

@@ -14,6 +14,8 @@
  * @method static static cancelId(int $cancelId)
  * @method static int show(string $message)
  * @method static bool error(string $title, string $message)
+ * @method static static when($value = null, ?callable $callback = null, ?callable $default = null)
+ * @method static static unless($value = null, ?callable $callback = null, ?callable $default = null)
  */
 class Alert extends Facade
 {

src/Facades/App.php

@@ -22,6 +22,8 @@
  * @method static bool openAtLogin(?bool $open = null)
  * @method static bool isEmojiPanelSupported()
  * @method static void showEmojiPanel()
+ * @method static static when($value = null, ?callable $callback = null, ?callable $default = null)
+ * @method static static unless($value = null, ?callable $callback = null, ?callable $default = null)
  */
 class App extends Facade
 {

src/Facades/AutoUpdater.php

@@ -8,6 +8,8 @@
  * @method static void checkForUpdates()
  * @method static void quitAndInstall()
  * @method static void downloadUpdate()
+ * @method static static when($value = null, ?callable $callback = null, ?callable $default = null)
+ * @method static static unless($value = null, ?callable $callback = null, ?callable $default = null)
  */
 class AutoUpdater extends Facade
 {

src/Facades/ChildProcess.php

@@ -16,6 +16,8 @@
  * @method static \Native\Desktop\ChildProcess php(string|array $cmd, string $alias, array $env = null, bool $persistent = false, ?array $iniSettings = null)
  * @method static \Native\Desktop\ChildProcess artisan(string|array $cmd, string $alias, array $env = null, bool $persistent = false, ?array $iniSettings = null)
  * @method static void stop(string $alias = null)
+ * @method static static when($value = null, ?callable $callback = null, ?callable $default = null)
+ * @method static static unless($value = null, ?callable $callback = null, ?callable $default = null)
  */
 class ChildProcess extends Facade
 {

src/Facades/Clipboard.php

@@ -9,6 +9,8 @@
  * @method static string text($text = null)
  * @method static string html($html = null)
  * @method static string|null image($image = null)
+ * @method static static when($value = null, ?callable $callback = null, ?callable $default = null)
+ * @method static static unless($value = null, ?callable $callback = null, ?callable $default = null)
  */
 class Clipboard extends Facade
 {

src/Facades/Dock.php

@@ -13,6 +13,8 @@
  * @method static void icon(string $Path)
  * @method static void menu(Menu $menu)
  * @method static void show()
+ * @method static static when($value = null, ?callable $callback = null, ?callable $default = null)
+ * @method static static unless($value = null, ?callable $callback = null, ?callable $default = null)
  */
 class Dock extends Facade
 {

src/Facades/Menu.php

@@ -41,6 +41,8 @@
  * @method static Role hide(?string $label = null)
  * @method static void create(MenuItem ...$items)
  * @method static void default()
+ * @method static static when($value = null, ?callable $callback = null, ?callable $default = null)
+ * @method static static unless($value = null, ?callable $callback = null, ?callable $default = null)
  */
 class Menu extends Facade
 {

src/Facades/Notification.php

@@ -12,6 +12,8 @@
  * @method static static hasReply(string $placeholder = '')
  * @method static static addAction(string $label)
  * @method static void show()
+ * @method static static when($value = null, ?callable $callback = null, ?callable $default = null)
+ * @method static static unless($value = null, ?callable $callback = null, ?callable $default = null)
  */
 class Notification extends Facade
 {

src/Fakes/ChildProcessFake.php

@@ -3,11 +3,14 @@
 namespace Native\Desktop\Fakes;
 
 use Closure;
+use Illuminate\Support\Traits\Conditionable;
 use Native\Desktop\Contracts\ChildProcess as ChildProcessContract;
 use PHPUnit\Framework\Assert as PHPUnit;
 
 class ChildProcessFake implements ChildProcessContract
 {
+    use Conditionable;
+
     /**
      * @var array<int, string|null>
      */

src/Fakes/WindowManagerFake.php

@@ -4,6 +4,7 @@
 
 use Closure;
 use Illuminate\Support\Arr;
+use Illuminate\Support\Traits\Conditionable;
 use Native\Desktop\Client\Client;
 use Native\Desktop\Contracts\WindowManager as WindowManagerContract;
 use Native\Desktop\Windows\Window;
@@ -12,6 +13,8 @@
 
 class WindowManagerFake implements WindowManagerContract
 {
+    use Conditionable;
+
     public array $opened = [];
 
     public array $closed = [];

src/Notification.php

@@ -2,10 +2,13 @@
 
 namespace Native\Desktop;
 
+use Illuminate\Support\Traits\Conditionable;
 use Native\Desktop\Client\Client;
 
 class Notification
 {
+    use Conditionable;
+
     public ?string $reference = null;
 
     protected string $title;

src/Windows/Window.php

@@ -2,6 +2,7 @@
 
 namespace Native\Desktop\Windows;
 
+use Illuminate\Support\Traits\Conditionable;
 use Native\Desktop\Client\Client;
 use Native\Desktop\Concerns\HasDimensions;
 use Native\Desktop\Concerns\HasUrl;
@@ -10,6 +11,7 @@
 
 class Window
 {
+    use Conditionable;
     use HasDimensions;
     use HasUrl {
         HasUrl::url as defaultUrl;

src/Windows/WindowManager.php

@@ -2,12 +2,14 @@
 
 namespace Native\Desktop\Windows;
 
+use Illuminate\Support\Traits\Conditionable;
 use Native\Desktop\Client\Client;
 use Native\Desktop\Concerns\DetectsWindowId;
 use Native\Desktop\Contracts\WindowManager as WindowManagerContract;
 
 class WindowManager implements WindowManagerContract
 {
+    use Conditionable;
     use DetectsWindowId;
 
     public function __construct(protected Client $client) {}

tests/Architecture/ConditionableTest.php

@@ -0,0 +1,30 @@
+<?php
+
+use Illuminate\Support\Traits\Conditionable;
+use Native\Desktop;
+
+use function Pest\version;
+
+describe('architecture', function () {
+
+    arch('ensure api is conditionable')
+        ->expect([
+            Desktop\App::class,
+            Desktop\Dock::class,
+            Desktop\Alert::class,
+            Desktop\Clipboard::class,
+            Desktop\AutoUpdater::class,
+            Desktop\ChildProcess::class,
+            Desktop\Notification::class,
+            Desktop\Menu\Menu::class,
+            Desktop\Windows\Window::class,
+            Desktop\Windows\WindowManager::class,
+
+            Desktop\Fakes\ChildProcessFake::class,
+            Desktop\Fakes\WindowManagerFake::class,
+        ])->each->toUseTrait(Conditionable::class);
+
+})->skip(function () {
+    // Only run test when pest version is at least 3
+    return version_compare(version(), '3.0.0', '<');
+}, 'Test not supporten on Pest < v3');