--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/foosdk/sdk/foobar2000/SDK/menu.h	Mon Jan 05 02:15:46 2026 -0500
@@ -0,0 +1,260 @@
+#pragma once
+#include "menu_common.h"
+
+class NOVTABLE mainmenu_group : public service_base {
+	FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(mainmenu_group);
+public:
+	virtual GUID get_guid() = 0;
+	virtual GUID get_parent() = 0;
+	virtual t_uint32 get_sort_priority() = 0;
+};
+
+class NOVTABLE mainmenu_group_popup : public mainmenu_group {
+	FB2K_MAKE_SERVICE_INTERFACE(mainmenu_group_popup, mainmenu_group);
+public:
+	virtual void get_display_string(pfc::string_base & p_out) = 0;
+	void get_name(pfc::string_base & out) {get_display_string(out);}
+};
+
+//! \since 1.4
+//! Allows you to control whether to render the group as a popup or inline.
+class NOVTABLE mainmenu_group_popup_v2 : public mainmenu_group_popup {
+	FB2K_MAKE_SERVICE_INTERFACE(mainmenu_group_popup_v2, mainmenu_group_popup);
+public:
+	virtual bool popup_condition() = 0;
+};
+
+class NOVTABLE mainmenu_commands : public service_base {
+public:
+	static constexpr uint32_t
+		flag_disabled = 1 << 0,
+		flag_checked = 1 << 1,
+		flag_radiochecked = 1 << 2,
+		//! \since 1.0
+		//! Replaces the old return-false-from-get_display() behavior - use this to make your command hidden by default but accessible when holding shift.
+		flag_defaulthidden = 1 << 3,
+		sort_priority_base = 0x10000,
+		sort_priority_dontcare = 0x80000000u,
+		sort_priority_last = UINT32_MAX;
+	
+
+	//! Retrieves number of implemented commands. Index parameter of other methods must be in 0....command_count-1 range.
+	virtual t_uint32 get_command_count() = 0;
+	//! Retrieves GUID of specified command.
+	virtual GUID get_command(t_uint32 p_index) = 0;
+	//! Retrieves name of item, for list of commands to assign keyboard shortcuts to etc.
+	virtual void get_name(t_uint32 p_index,pfc::string_base & p_out) = 0;
+	//! Retrieves item's description for statusbar etc.
+	virtual bool get_description(t_uint32 p_index,pfc::string_base & p_out) = 0;
+	//! Retrieves GUID of owning menu group.
+	virtual GUID get_parent() = 0;
+	//! Retrieves sorting priority of the command; the lower the number, the upper in the menu your commands will appear. Third party components should use sorting_priority_base and up (values below are reserved for internal use). In case of equal priority, order is undefined.
+	virtual t_uint32 get_sort_priority() {return sort_priority_dontcare;}
+	//! Retrieves display string and display flags to use when menu is about to be displayed. If returns false, menu item won't be displayed. You can create keyboard-shortcut-only commands by always returning false from get_display().
+	virtual bool get_display(t_uint32 p_index,pfc::string_base & p_text,t_uint32 & p_flags) {p_flags = 0;get_name(p_index,p_text);return true;}
+
+	typedef service_ptr ctx_t;
+	
+	//! Executes the command. p_callback parameter is reserved for future use and should be ignored / set to null pointer.
+	virtual void execute(t_uint32 p_index,ctx_t p_callback) = 0;
+
+	static bool g_execute(const GUID & p_guid,service_ptr_t<service_base> p_callback = NULL);
+	static bool g_execute_dynamic(const GUID & p_guid, const GUID & p_subGuid,service_ptr_t<service_base> p_callback = NULL);
+	static bool g_find_by_name(const char * p_name,GUID & p_guid);
+
+	FB2K_MAKE_SERVICE_INTERFACE_ENTRYPOINT(mainmenu_commands);
+};
+
+class NOVTABLE mainmenu_manager : public service_base {
+public:
+	enum {
+		flag_show_shortcuts = 1 << 0,
+		flag_show_shortcuts_global = 1 << 1,
+		//! \since 1.0
+		//! To control which commands are shown, you should specify either flag_view_reduced or flag_view_full. If neither is specified, the implementation will decide automatically based on shift key being pressed, for backwards compatibility.
+		flag_view_reduced = 1 << 2,
+		//! \since 1.0
+		//! To control which commands are shown, you should specify either flag_view_reduced or flag_view_full. If neither is specified, the implementation will decide automatically based on shift key being pressed, for backwards compatibility.
+		flag_view_full = 1 << 3,
+	};
+
+	virtual void instantiate(const GUID & p_root) = 0;
+	
+#ifdef _WIN32
+	virtual void generate_menu_win32(fb2k::hmenu_t p_menu,t_uint32 p_id_base,t_uint32 p_id_count,t_uint32 p_flags) = 0;
+#endif // _WIN32
+
+    //@param p_id Identifier of command to execute, relative to p_id_base of generate_menu_*()
+	//@returns true if command was executed successfully, false if not (e.g. command with given identifier not found).
+	virtual bool execute_command(t_uint32 p_id,service_ptr_t<service_base> p_callback = service_ptr_t<service_base>()) = 0;
+
+	virtual bool get_description(t_uint32 p_id,pfc::string_base & p_out) = 0;
+
+	//! Safely prevent destruction from worker threads (some components attempt that).
+	static bool serviceRequiresMainThreadDestructor() { return true; }
+
+	FB2K_MAKE_SERVICE_COREAPI(mainmenu_manager);
+};
+
+//! \since 2.0
+class mainmenu_manager_v2 : public mainmenu_manager {
+	FB2K_MAKE_SERVICE_COREAPI_EXTENSION(mainmenu_manager_v2, mainmenu_manager)
+public:
+	virtual menu_tree_item::ptr generate_menu(uint32_t flags) = 0;
+};
+
+class mainmenu_groups {
+public:
+	static const GUID file,view,edit,playback,library,help;
+	static const GUID file_open,file_add,file_playlist,file_etc;
+	static const GUID playback_controls,playback_etc;
+	static const GUID view_visualisations, view_alwaysontop, view_dsp;
+	static const GUID edit_part1,edit_part2,edit_part3;
+	static const GUID edit_part2_selection,edit_part2_sort,edit_part2_selection_sort;
+	static const GUID file_etc_preferences, file_etc_exit;
+	static const GUID help_about;
+	static const GUID library_refresh;
+
+	enum {priority_edit_part1,priority_edit_part2,priority_edit_part3};
+	enum {priority_edit_part2_commands,priority_edit_part2_selection,priority_edit_part2_sort};
+	enum {priority_edit_part2_selection_commands,priority_edit_part2_selection_sort};
+	enum {priority_file_open,priority_file_add,priority_file_playlist,priority_file_etc = mainmenu_commands::sort_priority_last};
+};
+
+
+class mainmenu_group_impl : public mainmenu_group {
+public:
+	mainmenu_group_impl(const GUID & p_guid,const GUID & p_parent,t_uint32 p_priority) : m_guid(p_guid), m_parent(p_parent), m_priority(p_priority) {}
+	GUID get_guid() {return m_guid;}
+	GUID get_parent() {return m_parent;}
+	t_uint32 get_sort_priority() {return m_priority;}
+private:
+	GUID m_guid,m_parent; t_uint32 m_priority;
+};
+
+class mainmenu_group_popup_impl : public mainmenu_group_popup {
+public:
+	mainmenu_group_popup_impl(const GUID & p_guid,const GUID & p_parent,t_uint32 p_priority,const char * p_name) : m_guid(p_guid), m_parent(p_parent), m_priority(p_priority), m_name(p_name) {}
+	GUID get_guid() {return m_guid;}
+	GUID get_parent() {return m_parent;}
+	t_uint32 get_sort_priority() {return m_priority;}
+	void get_display_string(pfc::string_base & p_out) {p_out = m_name;}
+private:
+	GUID m_guid,m_parent; t_uint32 m_priority; pfc::string8 m_name;
+};
+
+typedef service_factory_single_t<mainmenu_group_impl> _mainmenu_group_factory;
+typedef service_factory_single_t<mainmenu_group_popup_impl> _mainmenu_group_popup_factory;
+
+class mainmenu_group_factory : public _mainmenu_group_factory {
+public:
+	mainmenu_group_factory(const GUID & p_guid,const GUID & p_parent,t_uint32 p_priority) : _mainmenu_group_factory(p_guid,p_parent,p_priority) {}
+};
+
+class mainmenu_group_popup_factory : public _mainmenu_group_popup_factory {
+public:
+	mainmenu_group_popup_factory(const GUID & p_guid,const GUID & p_parent,t_uint32 p_priority,const char * p_name) : _mainmenu_group_popup_factory(p_guid,p_parent,p_priority,p_name) {}
+};
+
+#define FB2K_DECLARE_MAINMENU_GROUP( guid, parent, priority, name ) FB2K_SERVICE_FACTORY_PARAMS(mainmenu_group_impl, guid, parent, priority, name );
+#define FB2K_DECLARE_MAINMENU_GROUP_POPUP( guid, parent, priority, name ) FB2K_SERVICE_FACTORY_PARAMS(mainmenu_group_popup_impl, guid, parent, priority, name );
+
+template<typename T>
+class mainmenu_commands_factory_t : public service_factory_single_t<T> {};
+
+
+
+
+
+
+//! \since 1.0
+class NOVTABLE mainmenu_node : public service_base {
+	FB2K_MAKE_SERVICE_INTERFACE(mainmenu_node, service_base)
+public:
+	enum { //same as contextmenu_item_node::t_type
+		type_group,type_command,type_separator
+	};
+
+	virtual t_uint32 get_type() = 0;
+	virtual void get_display(pfc::string_base & text, t_uint32 & flags) = 0;
+	//! Valid only if type is type_group.
+	virtual t_size get_children_count() = 0;
+	//! Valid only if type is type_group.
+	virtual ptr get_child(t_size index) = 0;
+	//! Valid only if type is type_command.
+	virtual void execute(service_ptr_t<service_base> callback) = 0;
+	//! Valid only if type is type_command.
+	virtual GUID get_guid() = 0;
+	//! Valid only if type is type_command.
+	virtual bool get_description(pfc::string_base& out) { (void)out; return false; }
+
+};
+
+class mainmenu_node_separator : public mainmenu_node {
+public:
+	t_uint32 get_type() override {return type_separator;}
+	void get_display(pfc::string_base & text, t_uint32 & flags) override {text = ""; flags = 0;}
+	t_size get_children_count() override {return 0;}
+	ptr get_child(t_size index) override { (void)index; throw pfc::exception_invalid_params(); }
+	void execute(service_ptr_t<service_base>) override {}
+	GUID get_guid() override {return pfc::guid_null;}
+};
+
+class mainmenu_node_command : public mainmenu_node {
+public:
+	t_uint32 get_type() override {return type_command;}
+	t_size get_children_count() override {return 0;}
+	ptr get_child(t_size index) override { (void)index; throw pfc::exception_invalid_params(); }
+/*
+	void get_display(pfc::string_base & text, t_uint32 & flags);
+	void execute(service_ptr_t<service_base> callback);
+	GUID get_guid();
+	bool get_description(pfc::string_base & out) {return false;}
+*/
+};
+
+class mainmenu_node_group : public mainmenu_node {
+public:
+	t_uint32 get_type() override {return type_group;}
+	void execute(service_ptr_t<service_base> callback) override { (void)callback; }
+	GUID get_guid() override {return pfc::guid_null;}
+/*
+	void get_display(pfc::string_base & text, t_uint32 & flags);
+	t_size get_children_count();
+	ptr get_child(t_size index);
+*/
+};
+
+
+//! \since 1.0
+class NOVTABLE mainmenu_commands_v2 : public mainmenu_commands {
+	FB2K_MAKE_SERVICE_INTERFACE(mainmenu_commands_v2, mainmenu_commands)
+public:
+	virtual bool is_command_dynamic(t_uint32 index);
+	//! Valid only when is_command_dynamic() returns true. Behavior undefined otherwise.
+	virtual mainmenu_node::ptr dynamic_instantiate(t_uint32 index);
+	//! Default fallback implementation provided.
+	virtual bool dynamic_execute(t_uint32 index, const GUID & subID, service_ptr_t<service_base> callback);
+};
+
+//! \since 2.0
+//! Introduces callbacks to monitor menu items that act like check boxes.
+class NOVTABLE mainmenu_commands_v3 : public mainmenu_commands_v2 {
+	FB2K_MAKE_SERVICE_INTERFACE(mainmenu_commands_v3, mainmenu_commands_v2)
+public:
+	class state_callback {
+	public:
+		//! @param main Command ID
+		//! @param sub Reserved for future use.
+		virtual void menu_state_changed(const GUID& main, const GUID& sub) { (void)main; (void)sub; }
+		state_callback() {}
+		state_callback(state_callback const&) = delete;
+		void operator=(state_callback const&) = delete;
+	};
+
+	//! Return POSSIBLE values of display flags for this item, specifically flag_checked and flag_radiochecked if this item ever uses such.
+	//! @param subCmd Subcommand ID reserved for future use. Dynamic commands aren't meant to fire callbacks.
+	virtual uint32_t allowed_check_flags(uint32_t idx, const GUID& subCmd) = 0;
+	virtual void add_state_callback(state_callback*) = 0;
+	virtual void remove_state_callback(state_callback*) = 0;	
+};