From a205391e0af4d1d9e7cdc907904c8f785a809dbe Mon Sep 17 00:00:00 2001
From: Nebojsa Vuksic <nebojsa.vuksic@jetbrains.com>
Date: Wed, 6 Aug 2025 18:37:13 +0200
Subject: [PATCH] Add `CoroutineScopeHolder` service for project-wide coroutine
 management

---
 .../plugins/template/CoroutineScopeHolder.kt  | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 src/main/kotlin/org/jetbrains/plugins/template/CoroutineScopeHolder.kt

diff --git a/src/main/kotlin/org/jetbrains/plugins/template/CoroutineScopeHolder.kt b/src/main/kotlin/org/jetbrains/plugins/template/CoroutineScopeHolder.kt
new file mode 100644
index 0000000..d178e89
--- /dev/null
+++ b/src/main/kotlin/org/jetbrains/plugins/template/CoroutineScopeHolder.kt
@@ -0,0 +1,31 @@
+package org.jetbrains.plugins.template
+
+import com.intellij.openapi.components.Service
+import com.intellij.openapi.components.Service.Level
+import com.intellij.platform.util.coroutines.childScope
+import kotlinx.coroutines.CoroutineScope
+
+
+/**
+ * A service-level class that provides and manages coroutine scopes for a given project.
+ *
+ * @constructor Initializes the [CoroutineScopeHolder] with a project-wide coroutine scope.
+ * @param projectWideCoroutineScope A [CoroutineScope] defining the lifecycle of project-wide coroutines.
+ */
+@Service(Level.PROJECT)
+class CoroutineScopeHolder(private val projectWideCoroutineScope: CoroutineScope) {
+    /**
+     * Creates a new coroutine scope as a child of the project-wide coroutine scope with the specified name.
+     *
+     * @param name The name for the newly created coroutine scope.
+     * @return a scope with a [Job] which parent is the [Job] of [projectWideCoroutineScope] scope.
+     *
+     * The returned scope can be completed only by cancellation.
+     * [projectWideCoroutineScope] scope will cancel the returned scope when canceled.
+     * If the child scope has a narrower lifecycle than [projectWideCoroutineScope] scope,
+     * then it should be canceled explicitly when not needed,
+     * otherwise, it will continue to live in the Job hierarchy until termination of the [CoroutineScopeHolder] service.
+     */
+    @Suppress("UnstableApiUsage")
+    fun createScope(name: String): CoroutineScope = projectWideCoroutineScope.childScope(name)
+}