Menu builder

cms-api/src/main/java/com/condation/cms/api/Constants.java

@@ -142,6 +142,7 @@ public static class CacheNames {
 		public static final String TEMPLATE = "template";
         public static final String CONTENT = "content";
         public static final String MEDIA = "media";
+        public static final String MENU = "menu";
         public static final String RESPONSE = "response";
 	}
 

cms-api/src/main/java/com/condation/cms/api/eventbus/events/MenuChangedEvent.java

@@ -0,0 +1,30 @@
+package com.condation.cms.api.eventbus.events;
+
+/*-
+ * #%L
+ * CMS Api
+ * %%
+ * Copyright (C) 2023 - 2026 CondationCMS
+ * %%
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ * #L%
+ */
+
+import com.condation.cms.api.eventbus.Event;
+
+/**
+ * Signals that the persisted representation of a site menu has changed.
+ */
+public record MenuChangedEvent(String menuId) implements Event {
+}

cms-api/src/main/java/com/condation/cms/api/hooks/Hooks.java

@@ -31,6 +31,8 @@ public enum Hooks {
 	/* navigation */
 	NAVIGATION_PATH("system/navigation/%s/path"),
 	NAVIGATION_LIST("system/navigation/%s/list"),
+    /* menu */
+    MENU_FILTER("system/menu/%s/items"),
 	/* content */
 	CONTENT_SHORTCODES("system/content/shortcode"),
 	CONTENT_FILTER("system/content/filter"),

cms-api/src/main/java/com/condation/cms/api/menu/Menu.java

@@ -0,0 +1,34 @@
+package com.condation.cms.api.menu;
+
+/*-
+ * #%L
+ * CMS Api
+ * %%
+ * Copyright (C) 2023 - 2026 CondationCMS
+ * %%
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ * #L%
+ */
+
+import java.util.List;
+
+/**
+ * A named navigation menu. The id is also used as the YAML file name.
+ */
+public record Menu(String id, String name, List<MenuItem> items) {
+
+	public Menu {
+		items = items == null ? List.of() : List.copyOf(items);
+	}
+}

cms-api/src/main/java/com/condation/cms/api/menu/MenuItem.java

@@ -0,0 +1,54 @@
+package com.condation.cms.api.menu;
+
+/*-
+ * #%L
+ * CMS Api
+ * %%
+ * Copyright (C) 2023 - 2026 CondationCMS
+ * %%
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ * #L%
+ */
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * A single, potentially nested entry in a navigation menu.
+ */
+public record MenuItem(
+		String id,
+		String type,
+		String label,
+		String url,
+		String target,
+		boolean enabled,
+		List<MenuItem> children,
+		boolean current) {
+
+	public MenuItem {
+		children = children == null ? new ArrayList<>() : new ArrayList<>(children);
+	}
+
+	public MenuItem(
+			String id,
+			String type,
+			String label,
+			String url,
+			String target,
+			boolean enabled,
+			List<MenuItem> children) {
+		this(id, type, label, url, target, enabled, children, false);
+	}
+}

cms-api/src/main/java/com/condation/cms/api/menu/MenuService.java

@@ -0,0 +1,42 @@
+package com.condation.cms.api.menu;
+
+/*-
+ * #%L
+ * CMS Api
+ * %%
+ * Copyright (C) 2023 - 2026 CondationCMS
+ * %%
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ * #L%
+ */
+
+import java.io.IOException;
+import java.util.List;
+import java.util.Optional;
+
+/**
+ * Storage abstraction for site navigation menus.
+ */
+public interface MenuService {
+
+	List<Menu> list() throws IOException;
+
+	Optional<Menu> get(String id) throws IOException;
+
+	Menu create(Menu menu) throws IOException;
+
+	Menu update(Menu menu) throws IOException;
+
+	boolean delete(String id) throws IOException;
+}

cms-api/src/main/java/com/condation/cms/api/ui/apps/App.java

@@ -0,0 +1,62 @@
+package com.condation.cms.api.ui.apps;
+
+/*-
+ * #%L
+ * CMS Api
+ * %%
+ * Copyright (C) 2023 - 2026 CondationCMS
+ * %%
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ * #L%
+ */
+
+import com.condation.cms.api.ui.action.UIAction;
+import java.util.List;
+import java.util.Objects;
+
+/**
+ * An application available from the manager app launcher.
+ *
+ * @param id stable app identifier
+ * @param title title displayed in the app launcher
+ * @param icon URL of the app icon
+ * @param action action executed when the app is opened
+ * @param permissions permissions required to see the app
+ */
+public record App(
+		String id,
+		String title,
+		String icon,
+		UIAction action,
+		List<String> permissions) {
+
+	public App {
+		id = requireText(id, "App id");
+		title = requireText(title, "App title");
+		icon = requireText(icon, "App icon");
+		action = Objects.requireNonNull(action, "App action is required");
+		permissions = permissions == null ? List.of() : List.copyOf(permissions);
+	}
+
+	public App(String id, String title, String icon, UIAction action) {
+		this(id, title, icon, action, List.of());
+	}
+
+	private static String requireText(String value, String name) {
+		if (value == null || value.isBlank()) {
+			throw new IllegalArgumentException(name + " is required");
+		}
+		return value.trim();
+	}
+}

cms-api/src/main/java/com/condation/cms/api/ui/apps/AppExtensionPoint.java

@@ -0,0 +1,33 @@
+package com.condation.cms.api.ui.apps;
+
+/*-
+ * #%L
+ * CMS Api
+ * %%
+ * Copyright (C) 2023 - 2026 CondationCMS
+ * %%
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ * #L%
+ */
+
+import com.condation.cms.api.ui.extensions.UIExtensionPoint;
+import java.util.List;
+
+/**
+ * Extension point for contributing applications to the manager app launcher.
+ */
+public interface AppExtensionPoint extends UIExtensionPoint {
+
+	List<App> getApps();
+}