Project Manager: Add Compact Mode Setting

Adds a compact mode setting which hides the project list sidebar when the
project manager is shrunk.
Adds a compact mode threshold setting that sets the point beyond which the
project list sidebar is hidden.

Co-authored-by: CarrotOfPower <260066004+CarrotOfPower@users.noreply.github.com>

Author: unit-tick

doc/classes/EditorSettings.xml

@@ -1378,6 +1378,12 @@
 			If [code]true[/code], enable TLSv1.3 negotiation.
 			[b]Note:[/b] Only supported when using Mbed TLS 3.0 or later (Linux distribution packages may be compiled against older system Mbed TLS packages), otherwise the maximum supported TLS version is always TLSv1.2.
 		</member>
+		<member name="project_manager/compact_mode" type="bool" setter="" getter="">
+			If [code]true[/code], enables hiding the Project List Sidebar when the Project Manager is shrunk, horizontally, below a threshold, which is set in [member project_manager/compact_mode_threshold].
+		</member>
+		<member name="project_manager/compact_mode_threshold" type="int" setter="" getter="">
+			Sets the threshold, in pixels, beyond which the Project List Sidebar collapses when the Project Manager is resized. If [code]0[/code], the sidebar disappears when there is not enough space for it. This only has an effect if [member project_manager/compact_mode] is [code]true[/code].
+		</member>
 		<member name="project_manager/default_renderer" type="String" setter="" getter="">
 			The renderer type that will be checked off by default when creating a new project. Accepted strings are "forward_plus", "mobile" or "gl_compatibility".
 		</member>

editor/project_manager/project_list.cpp

@@ -1581,6 +1581,20 @@ void ProjectList::resize_project_titles() {
 	window_size_cache = window_size;
 	title_and_tags_size_cache += difference;
 
+	if (compact_mode) {
+		const bool sb_visible = ProjectManager::get_singleton()->is_project_list_sidebar_visible();
+		if (sb_visible && !sb_visible_cache) {
+			title_and_tags_size_cache -= sidebar_size_cache;
+		} else if (!sb_visible && sb_visible_cache) {
+			title_and_tags_size_cache += sidebar_size_cache;
+		}
+		sb_visible_cache = sb_visible;
+	} else if (compact_mode_cache && !sb_visible_cache) {
+		title_and_tags_size_cache -= sidebar_size_cache;
+		sb_visible_cache = true;
+	}
+	compact_mode_cache = compact_mode;
+
 	for (Item &item : _projects) {
 		item.control->resize_project_title(title_and_tags_size_cache, abs_title_and_tags_minsize_cache);
 	}

editor/project_manager/project_list.h

@@ -309,6 +309,9 @@ class ProjectList : public ScrollContainer {
 	// Compact mode.
 
 	bool compact_mode = false;
+	bool compact_mode_cache = false;
+	bool sb_visible_cache = false;
+	int sidebar_size_cache = 0;
 
 	// Initialization & loading.
 

editor/project_manager/project_manager.cpp

@@ -112,9 +112,14 @@ void ProjectManager::_notification(int p_what) {
 			_select_main_view(MAIN_VIEW_PROJECTS);
 			_update_list_placeholder();
 			_titlebar_resized();
-			_update_compact_mode(true);
 
+			compact_mode_default_threshold = root_container->get_combined_minimum_size().width - project_list->largest_project_title_and_tags_fullsize + project_list->abs_title_and_tags_minsize_cache;
+			_reset_compact_mode_threshold();
+
+			project_list->sb_visible_cache = is_project_list_sidebar_visible();
 			const int sidebar_size = project_list_sidebar->get_size().x;
+			project_list->sidebar_size_cache = sidebar_size;
+
 			Ref<StyleBox> root_sb = root_container->get_theme_stylebox(SNAME("panel"), SNAME("PanelContainer"));
 			const int root_padding = root_sb.is_valid() ? root_sb->get_margin(SIDE_LEFT) + root_sb->get_margin(SIDE_RIGHT) : 0.0f;
 			const int pl_width = project_list->get_size().x;
@@ -153,11 +158,15 @@ void ProjectManager::_notification(int p_what) {
 			if (EditorThemeManager::is_generated_theme_outdated()) {
 				_update_theme();
 			}
+			_update_project_manager_settings();
 			_update_list_placeholder();
 		} break;
+
 		case NOTIFICATION_RESIZED: {
+			if (compact_mode) {
+				_update_compact_mode();
+			}
 			project_list->resize_project_titles();
-			_update_compact_mode();
 		} break;
 	}
 }
@@ -193,21 +202,26 @@ void ProjectManager::_build_icon_type_cache(Ref<Theme> p_theme) {
 
 // Main layout.
 
+void ProjectManager::_reset_compact_mode_threshold() {
+	const int threshold = EDITOR_GET("project_manager/compact_mode_threshold");
+	compact_mode_threshold = threshold > 0 ? threshold : compact_mode_default_threshold;
+	_update_compact_mode();
+}
+
 // Hides certain parts of the Project Manager when window width gets smaller than combined_minimum_size.
-void ProjectManager::_update_compact_mode(bool p_reset_threshold) {
-	if (p_reset_threshold) {
+void ProjectManager::_update_compact_mode() {
+	if (!compact_mode) {
 		project_list_sidebar->show();
-		compact_mode_threshold = root_container->get_combined_minimum_size().width;
+	} else {
+		const bool compact = get_size().width < compact_mode_threshold;
+		project_list_sidebar->set_visible(!compact);
 	}
-
-	bool compact_mode = get_size().width < compact_mode_threshold;
-	project_list_sidebar->set_visible(!compact_mode);
 }
 
 void ProjectManager::_update_size_limits() {
 	const Size2 default_minimum_size = Size2(720, 450) * EDSCALE;
 	const Size2 display_size = DisplayServer::get_singleton()->screen_get_usable_rect(DisplayServerEnums::SCREEN_OF_MAIN_WINDOW).size;
-	const real_t smallest_display_dimension = display_size.width < display_size.height ? display_size.width : display_size.height;
+	const real_t smallest_display_dimension = MIN(display_size.width, display_size.height);
 	const Size2 minimum_size = default_minimum_size.minf(smallest_display_dimension);
 
 	// Define a minimum window size to prevent UI elements from overlapping or being cut off.
@@ -1367,6 +1381,25 @@ void ProjectManager::_titlebar_resized() {
 	}
 }
 
+bool ProjectManager::is_project_list_sidebar_visible() {
+	return project_list_sidebar->is_visible();
+}
+
+Vector2 ProjectManager::get_project_list_sidebar_size() {
+	return project_list_sidebar->get_size();
+}
+
+void ProjectManager::_update_project_manager_settings() {
+	// Compact Mode setting
+	{
+		compact_mode = EDITOR_GET("project_manager/compact_mode");
+
+		_reset_compact_mode_threshold();
+		project_list->compact_mode = compact_mode;
+		project_list->resize_project_titles();
+	}
+}
+
 void ProjectManager::_open_donate_page() {
 	OS::get_singleton()->shell_open("https://fund.godotengine.org/?ref=project_manager");
 }
@@ -1650,7 +1683,6 @@ ProjectManager::ProjectManager() {
 			project_list->connect(ProjectList::SIGNAL_SELECTION_CHANGED, callable_mp(this, &ProjectManager::_update_project_buttons));
 			project_list->connect(ProjectList::SIGNAL_PROJECT_ASK_OPEN, callable_mp(this, &ProjectManager::_open_selected_projects_check_recovery_mode));
 			project_list->connect(ProjectList::SIGNAL_MENU_OPTION_SELECTED, callable_mp(this, &ProjectManager::_project_list_menu_option));
-			project_list->connect(SceneStringName(minimum_size_changed), callable_mp(this, &ProjectManager::_update_compact_mode).bind(true));
 
 			// Empty project list placeholder.
 			{
@@ -2035,6 +2067,9 @@ ProjectManager::ProjectManager() {
 		title_bar->connect(SceneStringName(item_rect_changed), callable_mp(this, &ProjectManager::_titlebar_resized));
 	}
 
+	compact_mode = EDITOR_GET("project_manager/compact_mode");
+	project_list->compact_mode = compact_mode;
+
 	_update_size_limits();
 }
 

editor/project_manager/project_manager.h

@@ -75,6 +75,12 @@ class ProjectManager : public Control {
 
 	// Main layout.
 
+	bool compact_mode = false;
+	int compact_mode_default_threshold = 0;
+	int compact_mode_threshold = 0;
+	void _reset_compact_mode_threshold();
+	void _update_compact_mode();
+
 	Ref<Theme> theme;
 
 	void _update_size_limits();
@@ -95,9 +101,6 @@ class ProjectManager : public Control {
 	Button *quick_settings_button = nullptr;
 	VBoxContainer *project_list_sidebar = nullptr;
 
-	int compact_mode_threshold = 0;
-	void _update_compact_mode(bool p_reset_threshold = false);
-
 	enum MainViewTab {
 		MAIN_VIEW_PROJECTS,
 		MAIN_VIEW_ASSETLIB,
@@ -272,6 +275,9 @@ class ProjectManager : public Control {
 
 	void _files_dropped(PackedStringArray p_files);
 
+	// Editor Settings.
+	void _update_project_manager_settings();
+
 protected:
 	void _notification(int p_what);
 
@@ -290,6 +296,11 @@ class ProjectManager : public Control {
 
 	void add_new_tag(const String &p_tag);
 
+	// Compact mode.
+
+	bool is_project_list_sidebar_visible();
+	Vector2 get_project_list_sidebar_size();
+
 	// Theme.
 	Ref<Theme> get_theme() const { return theme; }
 

editor/settings/editor_settings.cpp

@@ -1200,6 +1200,13 @@ void EditorSettings::_load_defaults(Ref<ConfigFile> p_extra_config) {
 	EDITOR_SETTING(Variant::INT, PROPERTY_HINT_ENUM, "project_manager/sorting_order", 0, "Last Edited,Name,Path")
 	EDITOR_SETTING_BASIC(Variant::INT, PROPERTY_HINT_ENUM, "project_manager/directory_naming_convention", 1, "No Convention,kebab-case,snake_case,camelCase,PascalCase,Title Case")
 
+#if defined(WINDOWS_ENABLED) || defined(LINUXBSD_ENABLED) || defined(MACOS_ENABLED)
+	_initial_set("project_manager/compact_mode", false, true);
+	_initial_set("project_manager/compact_mode_threshold", 0, true);
+#elif defined(ANDROID_ENABLED)
+	_initial_set("project_manager/compact_mode", true, true);
+#endif
+
 #if defined(WEB_ENABLED)
 	// Web platform only supports `gl_compatibility`.
 	const String default_renderer = "gl_compatibility";