From 68609805195c1fdefc2d0f56efbc7e668d10f44b Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Fri, 13 Jun 2025 12:27:39 +0200
Subject: [PATCH] Add an attribute to mark menu builder methods

This attribute has no effect in the library itself. It is expected to be
used by framework integrations to perform the wiring (if they can).
---
 src/Knp/Menu/Attribute/AsMenuBuilder.php | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 src/Knp/Menu/Attribute/AsMenuBuilder.php

diff --git a/src/Knp/Menu/Attribute/AsMenuBuilder.php b/src/Knp/Menu/Attribute/AsMenuBuilder.php
new file mode 100644
index 00000000..048a9c5d
--- /dev/null
+++ b/src/Knp/Menu/Attribute/AsMenuBuilder.php
@@ -0,0 +1,20 @@
+<?php
+
+namespace Knp\Menu\Attribute;
+
+/**
+ * A reusable attribute to help configure a class method as being a menu builder.
+ *
+ * Using it offers no guarantee: it needs to be leveraged by a KnpMenu third-party consumer.
+ *
+ * Using it with the KnpMenu library only has no effect at all: wiring the menu builder into
+ * the menu provider is expected to be handled by framework integrations.
+ */
+#[\Attribute(\Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
+final class AsMenuBuilder
+{
+    public function __construct(
+        public readonly string $name,
+    ) {
+    }
+}