Add basic macos msgbox support

Author: SerafimArts

src/Api/MessageBox/Driver/MacOS/LibObjectC.php

@@ -0,0 +1,66 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\Api\MessageBox\Driver\MacOS;
+
+use FFI\Env\Runtime;
+
+/**
+ * @mixin \FFI
+ *
+ * @internal this is an internal library class, please do not use it in your code
+ * @psalm-internal Boson\Api\MessageBox\Driver
+ */
+final readonly class LibObjectC
+{
+    private \FFI $ffi;
+
+    public function __construct()
+    {
+        Runtime::assertAvailable();
+
+        $this->ffi = \FFI::cdef(\trim((string) @\file_get_contents(
+            filename: __FILE__,
+            offset: __COMPILER_HALT_OFFSET__,
+        )), 'libobjc.A.dylib');
+    }
+
+    /**
+     * @param non-empty-string ...$types
+     * @return callable(CData,CData,...):mixed
+     */
+    public function getMessageSend(string ...$types): callable
+    {
+        $signature = \sprintf('id(*)(id, SEL, %s)', \implode(',', $types));
+
+        return $this->cast($signature, $this->ffi->objc_msgSend);
+    }
+
+    /**
+     * @param non-empty-string $name
+     * @param array<array-key, mixed> $arguments
+     */
+    public function __call(string $name, array $arguments = []): mixed
+    {
+        try {
+            return $this->ffi->$name(...$arguments);
+        } catch (\Throwable $e) {
+            throw new \BadMethodCallException($e->getMessage(), previous: $e);
+        }
+    }
+
+    public function __get(string $name): mixed
+    {
+        return $this->ffi->$name;
+    }
+}
+
+__halt_compiler();
+
+typedef void* id;
+typedef void* SEL;
+
+id objc_getClass(const char* name);
+SEL sel_registerName(const char* str);
+void* objc_msgSend(...);

src/Api/MessageBox/Driver/MacOSMessageBoxExtension.php

@@ -0,0 +1,88 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Boson\Api\MessageBox\Driver;
+
+use Boson\Api\MessageBox\Driver\MacOS\LibObjectC;
+use Boson\Api\MessageBox\MessageBoxCreateInfo;
+use Boson\Api\MessageBox\MessageBoxExtensionInterface;
+use Boson\Api\MessageBox\MessageBoxIcon;
+use FFI\CData;
+use React\Promise\PromiseInterface;
+
+use function React\Promise\resolve;
+
+final readonly class MacOSMessageBoxExtension implements MessageBoxExtensionInterface
+{
+    private CData $msgSendId;
+    private CData $msgSendString;
+    private CData $msgSendLong;
+
+    public function __construct(
+        private LibObjectC $libobjc = new LibObjectC(),
+    ) {
+        $this->msgSendId = $libobjc->getMessageSend('id');
+        $this->msgSendString = $libobjc->getMessageSend('const char*');
+        $this->msgSendLong = $libobjc->getMessageSend('long');
+    }
+
+    public function create(MessageBoxCreateInfo $info): PromiseInterface
+    {
+        // NSString *titleStr = [NSString stringWithUTF8String:title]
+        $titleStr = ($this->msgSendString)(
+            $this->libobjc->objc_getClass('NSString'),
+            $this->libobjc->sel_registerName('stringWithUTF8String:'),
+            $info->title . "\0",
+        );
+
+        // NSString *textStr = [NSString stringWithUTF8String:text]
+        $textStr = ($this->msgSendString)(
+            $this->libobjc->objc_getClass('NSString'),
+            $this->libobjc->sel_registerName('stringWithUTF8String:'),
+            $info->text . "\0",
+        );
+
+        // NSAlert *alert = [NSAlert new]
+        $alert = $this->libobjc->objc_msgSend(
+            $this->libobjc->objc_getClass('NSAlert'),
+            $this->libobjc->sel_registerName('new'),
+        );
+
+        // [alert setMessageText:textStr];
+        ($this->msgSendId)(
+            $alert,
+            $this->libobjc->sel_registerName('setMessageText:'),
+            $textStr,
+        );
+
+        // [alert setInformativeText:titleStr];
+        ($this->msgSendId)(
+            $alert,
+            $this->libobjc->sel_registerName('setInformativeText:'),
+            $titleStr,
+        );
+
+        // Set alert style based on icon
+        if ($info->icon !== null) {
+            // [alert setAlertStyle:alertStyle];
+            ($this->msgSendLong)(
+                $alert,
+                $this->libobjc->sel_registerName('setAlertStyle:'),
+                match ($info->icon) {
+                    MessageBoxIcon::Error => 0,   // NSAlertStyleCritical
+                    MessageBoxIcon::Warning => 1, // NSAlertStyleWarning
+                    MessageBoxIcon::Info => 2,    // NSAlertStyleInformational
+                },
+            );
+        }
+
+        // [alert runModal];
+        $this->libobjc->objc_msgSend(
+            $alert,
+            $this->libobjc->sel_registerName('runModal'),
+        );
+
+        return resolve(null);
+    }
+}

src/Api/MessageBox/Driver/Windows/User32.php

@@ -10,7 +10,7 @@
  * @mixin \FFI
  *
  * @internal this is an internal library class, please do not use it in your code
- * @psalm-internal Boson\Api\MessageBox\Driver\Windows
+ * @psalm-internal Boson\Api\MessageBox\Driver
  */
 final readonly class User32
 {

src/Api/MessageBox/MessageBoxExtensionProvider.php

@@ -4,6 +4,7 @@
 
 namespace Boson\Api\MessageBox;
 
+use Boson\Api\MessageBox\Driver\MacOSMessageBoxExtension;
 use Boson\Api\MessageBox\Driver\VoidMessageBoxExtension;
 use Boson\Api\MessageBox\Driver\WindowsMessageBoxExtension;
 use Boson\Api\OperatingSystem\OperatingSystemExtensionInterface;
@@ -28,6 +29,7 @@ public function load(IdentifiableInterface $ctx, EventListener $listener): Messa
         $os = $ctx->get(OperatingSystemExtensionInterface::class);
 
         return match (true) {
+            $os->family->is(Family::Darwin) => new MacOSMessageBoxExtension(),
             $os->family->is(Family::Windows) => new WindowsMessageBoxExtension(),
             default => new VoidMessageBoxExtension(),
         };