feat(mac-os): build and run successfully

docs/engine_developers/build_from_source.md

@@ -9,6 +9,23 @@ Below are instructions on how to build the editor from source
 ## Prerequisites
 To start, make sure you have the [Vulkan SDK](https://vulkan.lunarg.com/sdk/home) installed for your system.
 
+## macOS Development
+- Install Xcode Command Line Tools:
+  - Run `xcode-select --install` in Terminal
+- Install the [Vulkan SDK](https://vulkan.lunarg.com/sdk/home#mac) for macOS
+  - After installation, add the Vulkan library path to your environment:
+    ```sh
+    export DYLD_LIBRARY_PATH=$HOME/Library/VulkanSDK/1.4.XXX.X/macOS/lib  # Replace with your version and your sdk path
+    ```
+- Pull the repository
+- Go into src: `cd src`
+- To build the editor in debug mode, run:
+  - `CGO_ENABLED=1 go build -tags="debug,editor" -o ../bin/kaiju`
+- To build the editor, run:
+  - `CGO_ENABLED=1 go build -ldflags="-s -w" -tags="editor" -o ../bin/kaiju`
+
+**Note:** On macOS, the engine uses Cocoa/AppKit for windowing and MoltenVK for Vulkan support. Keyboard shortcuts use the Cmd key (not Ctrl) for operations like copy/paste (Cmd+C/Cmd+V).
+
 ## Windows Development
 - Download mingw into `C:/`
   - I use [x86_64-15.2.0-release-win32-seh-msvcrt-rt_v13-rev0.7z](https://github.com/niXman/mingw-builds-binaries/releases)
@@ -56,6 +73,18 @@ cmake .. -G "Unix Makefiles" -DSOLOUD_BACKEND_SDL2=OFF -DSOLOUD_BACKEND_ALSA=ON
 cmake --build . --config Release
 ```
 
+### Soloud macOS
+```sh
+git clone https://github.com/jarikomppa/soloud.git
+cd soloud/contrib
+mkdir build
+cd build
+cmake .. -G "Unix Makefiles" -DSOLOUD_BACKEND_SDL2=OFF -DSOLOUD_BACKEND_COREAUDIO=ON -DSOLOUD_C_API=ON -DSOLOUD_STATIC=ON
+cmake --build . --config Release
+# Copy the library to kaiju
+cp build/libsoloud.a /path/to/kaiju/src/libs/libsoloud_darwin.a
+```
+
 ### Soloud Android (on Windows)
 ```sh
 git clone https://github.com/jarikomppa/soloud.git

src/editor/editor_overlay/file_browser/file_browser_overlay.go

@@ -104,6 +104,12 @@ func Show(host *engine.Host, config Config) (*FileBrowser, error) {
 			} else {
 				startPath = "/home"
 			}
+		case "darwin":
+			if userHome, err := os.UserHomeDir(); err == nil && userHome != "" {
+				startPath = userHome
+			} else {
+				startPath = "/"
+			}
 		default:
 			slog.Error("unknown platform")
 			return nil, fmt.Errorf("unknown platform: %s", runtime.GOOS)

src/platform/filesystem/directory_darwin.go

@@ -40,15 +40,13 @@ package filesystem
 
 import (
 	"kaiju/build"
-	"kaiju/klib"
 	"os"
 	"os/exec"
 	"path/filepath"
+	"strings"
 	"unsafe"
 )
 
-const macOSSupportIssueID = 485
-
 func knownPaths() map[string]string {
 	out := map[string]string{
 		"Root": "/",
@@ -93,15 +91,63 @@ func openFileBrowserCommand(path string) *exec.Cmd {
 }
 
 func openFileDialogWindow(startPath string, extensions []DialogExtension, ok func(path string), cancel func(), windowHandle unsafe.Pointer) error {
-	// TODO: implement via NSOpenPanel (CGO / Cocoa). For now, don't hang UI.
-	klib.NotYetImplemented(macOSSupportIssueID)
-	cancel()
+	// Use osascript (AppleScript) to show native macOS file picker
+	script := `POSIX path of (choose file`
+
+	if startPath != "" {
+		script += ` default location "` + startPath + `"`
+	}
+
+	script += `)`
+
+	cmd := exec.Command("osascript", "-e", script)
+	output, err := cmd.Output()
+
+	if err != nil {
+		if cancel != nil {
+			cancel()
+		}
+		return nil
+	}
+
+	path := strings.TrimSpace(string(output))
+	if path != "" {
+		ok(path)
+	} else if cancel != nil {
+		cancel()
+	}
 	return nil
 }
 
 func openSaveFileDialogWindow(startPath string, fileName string, extensions []DialogExtension, ok func(path string), cancel func(), windowHandle unsafe.Pointer) error {
-	// TODO: implement via NSSavePanel (CGO / Cocoa). For now, don't hang UI.
-	klib.NotYetImplemented(macOSSupportIssueID)
-	cancel()
+	// Use osascript (AppleScript) to show native macOS save dialog
+	script := `POSIX path of (choose file name`
+
+	if fileName != "" {
+		script += ` default name "` + fileName + `"`
+	}
+
+	if startPath != "" {
+		script += ` default location "` + startPath + `"`
+	}
+
+	script += `)`
+
+	cmd := exec.Command("osascript", "-e", script)
+	output, err := cmd.Output()
+
+	if err != nil {
+		if cancel != nil {
+			cancel()
+		}
+		return nil
+	}
+
+	path := strings.TrimSpace(string(output))
+	if path != "" {
+		ok(path)
+	} else if cancel != nil {
+		cancel()
+	}
 	return nil
 }

src/platform/hid/keyboard.darwin.go

@@ -1,7 +1,7 @@
 //go:build darwin && !ios
 
 /******************************************************************************/
-/* keyboard.win32.go                                                          */
+/* keyboard.darwin.go                                                         */
 /******************************************************************************/
 /*                            This file is part of                            */
 /*                                KAIJU ENGINE                                */
@@ -38,11 +38,237 @@
 
 package hid
 
-import "kaiju/klib"
+// ToKeyboardKey converts macOS virtual key codes to engine KeyboardKey values.
+// macOS key codes are defined in HIToolbox/Events.h (kVK_* constants).
+func ToKeyboardKey(nativeKey int) KeyboardKey {
+	switch nativeKey {
+	// Letters (QWERTY layout)
+	case 0x00:
+		return KeyboardKeyA
+	case 0x0B:
+		return KeyboardKeyB
+	case 0x08:
+		return KeyboardKeyC
+	case 0x02:
+		return KeyboardKeyD
+	case 0x0E:
+		return KeyboardKeyE
+	case 0x03:
+		return KeyboardKeyF
+	case 0x05:
+		return KeyboardKeyG
+	case 0x04:
+		return KeyboardKeyH
+	case 0x22:
+		return KeyboardKeyI
+	case 0x26:
+		return KeyboardKeyJ
+	case 0x28:
+		return KeyboardKeyK
+	case 0x25:
+		return KeyboardKeyL
+	case 0x2E:
+		return KeyboardKeyM
+	case 0x2D:
+		return KeyboardKeyN
+	case 0x1F:
+		return KeyboardKeyO
+	case 0x23:
+		return KeyboardKeyP
+	case 0x0C:
+		return KeyboardKeyQ
+	case 0x0F:
+		return KeyboardKeyR
+	case 0x01:
+		return KeyboardKeyS
+	case 0x11:
+		return KeyboardKeyT
+	case 0x20:
+		return KeyboardKeyU
+	case 0x09:
+		return KeyboardKeyV
+	case 0x0D:
+		return KeyboardKeyW
+	case 0x07:
+		return KeyboardKeyX
+	case 0x10:
+		return KeyboardKeyY
+	case 0x06:
+		return KeyboardKeyZ
 
-const macOSSupportIssueID = 485
+	// Numbers (top row)
+	case 0x1D:
+		return KeyboardKey0
+	case 0x12:
+		return KeyboardKey1
+	case 0x13:
+		return KeyboardKey2
+	case 0x14:
+		return KeyboardKey3
+	case 0x15:
+		return KeyboardKey4
+	case 0x17:
+		return KeyboardKey5
+	case 0x16:
+		return KeyboardKey6
+	case 0x1A:
+		return KeyboardKey7
+	case 0x1C:
+		return KeyboardKey8
+	case 0x19:
+		return KeyboardKey9
 
-func ToKeyboardKey(nativeKey int) KeyboardKey {
-	klib.NotYetImplemented(macOSSupportIssueID)
-	return KeyBoardKeyInvalid
+	// Keypad
+	case 0x52:
+		return KeyboardNumKey0
+	case 0x53:
+		return KeyboardNumKey1
+	case 0x54:
+		return KeyboardNumKey2
+	case 0x55:
+		return KeyboardNumKey3
+	case 0x56:
+		return KeyboardNumKey4
+	case 0x57:
+		return KeyboardNumKey5
+	case 0x58:
+		return KeyboardNumKey6
+	case 0x59:
+		return KeyboardNumKey7
+	case 0x5B:
+		return KeyboardNumKey8
+	case 0x5C:
+		return KeyboardNumKey9
+	case 0x43:
+		return KeyboardNumKeyMultiply
+	case 0x45:
+		return KeyboardNumKeyAdd
+	case 0x4E:
+		return KeyboardNumKeySubtract
+	case 0x41:
+		return KeyboardNumKeyPeriod
+	case 0x4B:
+		return KeyboardNumKeyDivide
+
+	// Function keys
+	case 0x7A:
+		return KeyboardKeyF1
+	case 0x78:
+		return KeyboardKeyF2
+	case 0x63:
+		return KeyboardKeyF3
+	case 0x76:
+		return KeyboardKeyF4
+	case 0x60:
+		return KeyboardKeyF5
+	case 0x61:
+		return KeyboardKeyF6
+	case 0x62:
+		return KeyboardKeyF7
+	case 0x64:
+		return KeyboardKeyF8
+	case 0x65:
+		return KeyboardKeyF9
+	case 0x6D:
+		return KeyboardKeyF10
+	case 0x67:
+		return KeyboardKeyF11
+	case 0x6F:
+		return KeyboardKeyF12
+
+	// Arrow keys
+	case 0x7B:
+		return KeyboardKeyLeft
+	case 0x7C:
+		return KeyboardKeyRight
+	case 0x7D:
+		return KeyboardKeyDown
+	case 0x7E:
+		return KeyboardKeyUp
+
+	// Control keys
+	case 0x35:
+		return KeyboardKeyEscape
+	case 0x30:
+		return KeyboardKeyTab
+	case 0x31:
+		return KeyboardKeySpace
+	case 0x24:
+		return KeyboardKeyReturn
+	case 0x4C:
+		return KeyboardKeyEnter // Keypad enter
+	case 0x33:
+		return KeyboardKeyBackspace
+	case 0x75:
+		return KeyboardKeyDelete
+	case 0x73:
+		return KeyboardKeyHome
+	case 0x77:
+		return KeyboardKeyEnd
+	case 0x74:
+		return KeyboardKeyPageUp
+	case 0x79:
+		return KeyboardKeyPageDown
+
+	// Modifiers
+	case 0x38:
+		return KeyboardKeyLeftShift
+	case 0x3C:
+		return KeyboardKeyRightShift
+	case 0x3B:
+		return KeyboardKeyLeftCtrl
+	case 0x3E:
+		return KeyboardKeyRightCtrl
+	case 0x3A:
+		return KeyboardKeyLeftAlt
+	case 0x3D:
+		return KeyboardKeyRightAlt
+	// macOS Command keys map to Ctrl for shortcuts (Cmd+C, Cmd+V, etc.)
+	// This allows engine's Ctrl+C/V/X clipboard shortcuts to work with Cmd key
+	case 0x37:
+		return KeyboardKeyLeftCtrl // Left Command → Left Ctrl
+	case 0x36:
+		return KeyboardKeyRightCtrl // Right Command → Right Ctrl
+
+	// Special keys
+	case 0x39:
+		return KeyboardKeyCapsLock
+	case 0x47:
+		return KeyboardKeyNumLock
+	case 0x6B:
+		return KeyboardKeyScrollLock
+	case 0x71:
+		return KeyboardKeyPrintScreen
+	case 0x72:
+		return KeyboardKeyInsert
+	case 0x7F:
+		return KeyboardKeyPause
+
+	// Punctuation
+	case 0x32:
+		return KeyboardKeyBackQuote
+	case 0x2B:
+		return KeyboardKeyComma
+	case 0x2F:
+		return KeyboardKeyPeriod
+	case 0x2C:
+		return KeyboardKeyForwardSlash
+	case 0x2A:
+		return KeyboardKeyBackSlash
+	case 0x21:
+		return KeyboardKeyOpenBracket
+	case 0x1E:
+		return KeyboardKeyCloseBracket
+	case 0x29:
+		return KeyboardKeySemicolon
+	case 0x27:
+		return KeyboardKeyQuote
+	case 0x18:
+		return KeyboardKeyEqual
+	case 0x1B:
+		return KeyboardKeyMinus
+
+	default:
+		return KeyBoardKeyInvalid
+	}
 }