fix(navigation): Allow apps to hide registered navigation entries

Signed-off-by: Joas Schilling <coding@schilljs.com>

Author: nickvergessen

lib/public/INavigationManager.php

@@ -27,7 +27,7 @@
  *     icon?: string,
  *     color?: string,
  *     classes?: string,
- *     type?: 'link'|'action'|'settings',
+ *     type?: 'link'|'action'|'settings'|'hidden',
  * }
  * @psalm-type NavigationEntryOutput = array{
  *     id: string,
@@ -77,6 +77,19 @@ interface INavigationManager {
 	 */
 	public const string TYPE_GUEST = 'guest';
 
+	/**
+	 * Navigation entries that are hidden
+	 *
+	 * Usually an entry like this should not be registered at all, but sometimes
+	 * it can be costly to check if an entry should be shown because group
+	 * memberships and other things have to be considered. As an easy way apps
+	 * can register the closure straight away and then set the type to hidden
+	 * when the closure is resolved.
+	 *
+	 * @since 35.0.0
+	 */
+	public const string TYPE_HIDDEN = 'hidden';
+
 	/**
 	 * Creates a new navigation entry
 	 *