ARMSX2/common/CocoaTools.h

// SPDX-FileCopyrightText: 2002-2026 PCSX2 Dev Team
// SPDX-License-Identifier: GPL-3.0+

#ifdef __APPLE__

#include <string>
#include <optional>

struct WindowInfo;

/// Helper functions for things that need Objective-C
namespace CocoaTools
{
	bool CreateMetalLayer(WindowInfo* wi);
	void DestroyMetalLayer(WindowInfo* wi);
	std::optional<float> GetViewRefreshRate(const WindowInfo& wi);

	/// Mark an NSMenu as the help menu
	void MarkHelpMenu(void* menu);
	/// Returns the bundle path.
	std::optional<std::string> GetBundlePath();
	/// Get the bundle path to the actual application without any translocation fun
	std::optional<std::string> GetNonTranslocatedBundlePath();
	/// Move the given file to the trash, and return the path to its new location
	std::optional<std::string> MoveToTrash(std::string_view file);
	/// Launch the given application once this one quits
	bool DelayedLaunch(std::string_view file);
	/// Open a Finder window to the given URL
	bool ShowInFinder(std::string_view file);
	/// Get the path to the resources directory of the current application
	std::optional<std::string> GetResourcePath();

	/// Create a window
	void* CreateWindow(std::string_view title, uint32_t width, uint32_t height);
	/// Destroy a window
	void DestroyWindow(void* window);
	/// Make a WindowInfo from the given window
	void GetWindowInfoFromWindow(WindowInfo* wi, void* window);
	/// Run cocoa event loop
	void RunCocoaEventLoop(bool wait_forever = false);
	/// Posts an event to the main telling `RunCocoaEventLoop(true)` to exit
	void StopMainThreadEventLoop();
} // namespace CocoaTools

#endif // __APPLE__