feat: implement endpoints

Author: xepozz

src/main/kotlin/com/github/xepozz/spiral/router/endpoints/SpiralEndpoint.kt

@@ -0,0 +1,8 @@
+package com.github.xepozz.spiral.router.endpoints
+
+data class SpiralEndpoint(
+    val url: String,
+    val method: String,
+    val fqn: String,
+    val group: String,
+)

src/main/kotlin/com/github/xepozz/spiral/router/endpoints/SpiralEndpointsProvider.kt

@@ -0,0 +1,60 @@
+package com.github.xepozz.spiral.router.endpoints
+
+import com.github.xepozz.spiral.SpiralIcons
+import com.github.xepozz.spiral.router.index.RouterIndexUtil
+import com.intellij.microservices.endpoints.EndpointType
+import com.intellij.microservices.endpoints.EndpointsFilter
+import com.intellij.microservices.endpoints.EndpointsProvider
+import com.intellij.microservices.endpoints.FrameworkPresentation
+import com.intellij.microservices.endpoints.HTTP_SERVER_TYPE
+import com.intellij.microservices.endpoints.ModuleEndpointsFilter
+import com.intellij.microservices.endpoints.presentation.HttpMethodPresentation
+import com.intellij.navigation.ItemPresentation
+import com.intellij.openapi.project.Project
+import com.intellij.psi.PsiElement
+import com.intellij.psi.util.PsiModificationTracker
+import com.jetbrains.php.lang.PhpLangUtil
+import com.jetbrains.php.lang.PhpLanguage
+
+class SpiralEndpointsProvider : EndpointsProvider<SpiralGroup, SpiralEndpoint> {
+    override val endpointType: EndpointType = HTTP_SERVER_TYPE
+    override val presentation = FrameworkPresentation("Spiral", "Spiral Framework", SpiralIcons.SPIRAL)
+
+    override fun getStatus(project: Project) = EndpointsProvider.Status.AVAILABLE
+
+    override fun getModificationTracker(project: Project) =
+        PsiModificationTracker.getInstance(project).forLanguage(PhpLanguage.INSTANCE)
+
+    override fun getEndpointGroups(project: Project, filter: EndpointsFilter): Iterable<SpiralGroup> {
+        if (filter !is ModuleEndpointsFilter) return emptyList()
+
+        return RouterIndexUtil
+            .getAllRoutes(project)
+            .flatMap { route -> route.methods.map { SpiralEndpoint(route.uri, it, route.fqn, route.group ?: "Root") } }
+            .sortedBy { it.url }
+            .groupBy { it.group }
+            .map { (group, routes) -> SpiralGroup(project, group, routes) }
+            .apply { println("groups $this ${this.map { it.group to it.routes.size }}") }
+    }
+
+    override fun getEndpoints(group: SpiralGroup) = group.routes
+
+    override fun isValidEndpoint(group: SpiralGroup, endpoint: SpiralEndpoint) = true//group.isValid()
+
+    override fun getDocumentationElement(group: SpiralGroup, endpoint: SpiralEndpoint): PsiElement? {
+        return RouterIndexUtil.getControllerMethodByFqn(group.project, endpoint.fqn).firstOrNull()
+    }
+
+    override fun getEndpointPresentation(group: SpiralGroup, endpoint: SpiralEndpoint): ItemPresentation {
+        return HttpMethodPresentation(
+            endpoint.url,
+            endpoint.method,
+            PhpLangUtil.toPresentableFQN(endpoint.fqn.replace(".", "::")),
+            SpiralIcons.SPIRAL,
+        )
+    }
+
+    override fun getNavigationElement(group: SpiralGroup, endpoint: SpiralEndpoint): PsiElement? {
+        return RouterIndexUtil.getControllerMethodByFqn(group.project, endpoint.fqn).firstOrNull()
+    }
+}

src/main/kotlin/com/github/xepozz/spiral/router/endpoints/SpiralGroup.kt

@@ -0,0 +1,9 @@
+package com.github.xepozz.spiral.router.endpoints
+
+import com.intellij.openapi.project.Project
+
+data class SpiralGroup(
+    val project: Project,
+    val group: String,
+    val routes: Collection<SpiralEndpoint>
+)

src/main/kotlin/com/github/xepozz/spiral/router/index/RouterIndexUtil.kt

@@ -5,7 +5,9 @@ import com.intellij.openapi.util.text.StringUtil
 import com.intellij.psi.PsiElement
 import com.intellij.psi.search.GlobalSearchScope
 import com.intellij.util.indexing.FileBasedIndex
+import com.jetbrains.php.PhpIndexImpl
 import com.jetbrains.php.lang.psi.elements.ArrayCreationExpression
+import com.jetbrains.php.lang.psi.elements.Method
 import com.jetbrains.php.lang.psi.elements.StringLiteralExpression
 
 object RouterIndexUtil {
@@ -36,4 +38,13 @@ object RouterIndexUtil {
                     .getValues(RouterUrlsIndex.key, it, allScope)
             }
     }
+
+    fun getControllerMethodByFqn(project: Project, fqn: String): Collection<Method> {
+        val (className, methodName) = fqn.split('.').apply { if (size != 2) return emptyList() }
+        val phpIndex = PhpIndexImpl.getInstance(project)
+
+        return phpIndex
+            .getAnyByFQN(className)
+            .mapNotNull { it.findMethodByName(methodName) }
+    }
 }

src/main/resources/META-INF/plugin.xml

@@ -76,9 +76,12 @@
                 implementationClass="com.github.xepozz.spiral.cqrs.CqrsHandlersLineMarkerProvider"/>
 
         <directoryProjectGenerator
-                implementation="com.github.xepozz.spiral.scaffolder.project.SpiralProjectGenerator" />
+                implementation="com.github.xepozz.spiral.scaffolder.project.SpiralProjectGenerator"/>
         <moduleBuilder
-                builderClass="com.github.xepozz.spiral.scaffolder.project.SpiralModuleBuilder" />
+                builderClass="com.github.xepozz.spiral.scaffolder.project.SpiralModuleBuilder"/>
+
+        <microservices.endpointsProvider
+                implementation="com.github.xepozz.spiral.router.endpoints.SpiralEndpointsProvider"/>
     </extensions>
     <extensions defaultExtensionNs="com.jetbrains.php">
         <typeProvider4