feat: Add GitLab bundle support

- JsonPatchBundle now handles gitlab.com URLs (resolveBranchUrl, extractBranch)
- normalizeRemoteBundleUrl converts gitlab.com/owner/repo to raw URL
- gitlabAvatarUrl via unavatar.io/gitlab/{owner}
- deep link: ?gitlabs=owner/repo parameter in MainActivity
- MorpheAPI.changelogUrlFromBundleEndpoint handles gitlab.com
- strings.xml: mention GitLab in URL examples and error message

Author: MarcaDian

app/src/main/java/app/morphe/manager/MainActivity.kt

@@ -119,7 +119,8 @@ class MainActivity : AppCompatActivity() {
     /**
      * Handles deep links for adding patch sources.
      * Format: https://morphe.software/add-source?github=owner/repo(&name=Display+Name)
-     * Only GitHub URLs are accepted for safety.
+     *         https://morphe.software/add-source?gitlabs=owner/repo(&name=Display+Name)
+     * Only GitHub and GitLab URLs are accepted for safety.
      */
     private fun handleDeepLinkIntent(intent: Intent?, vm: MainViewModel) {
         val data = intent?.data ?: return
@@ -138,10 +139,21 @@ class MainActivity : AppCompatActivity() {
                 data.path?.startsWith("/add-source") == true
         if (!isAddSource) return
 
-        val repo = data.getQueryParameter("github")?.takeIf { it.isNotBlank() } ?: return
-        val url = "https://github.com/$repo"
         val name = data.getQueryParameter("name")?.takeIf { it.isNotBlank() }
-        vm.pendingDeepLinkSource = MainViewModel.DeepLinkSource(url = url, name = name)
+
+        val githubRepo = data.getQueryParameter("github")?.takeIf { it.isNotBlank() }
+        if (githubRepo != null) {
+            val url = "https://github.com/$githubRepo"
+            vm.pendingDeepLinkSource = MainViewModel.DeepLinkSource(url = url, name = name)
+            return
+        }
+
+        val gitlabRepo = data.getQueryParameter("gitlabs")?.takeIf { it.isNotBlank() }
+        if (gitlabRepo != null) {
+            val url = "https://gitlab.com/$gitlabRepo"
+            vm.pendingDeepLinkSource = MainViewModel.DeepLinkSource(url = url, name = name)
+            return
+        }
     }
 }
 

app/src/main/java/app/morphe/manager/domain/bundles/PatchBundleSource.kt

@@ -97,7 +97,8 @@ sealed class PatchBundleSource(
         }
 
         /**
-         * Get GitHub avatar URL if this bundle is from a GitHub repository
+         * Get GitHub avatar URL if this bundle is from a GitHub repository.
+         * Returns null for GitLab bundles (use [gitlabAvatarUrl] instead).
          */
         val PatchBundleSource.githubAvatarUrl: String? get() {
             val remote = this as? RemotePatchBundle ?: return null
@@ -107,7 +108,17 @@ sealed class PatchBundleSource(
         }
 
         /**
-         * Extract GitHub owner/organization name from endpoint URL
+         * Get GitLab avatar URL via unavatar.io if this bundle is from a GitLab repository.
+         */
+        val PatchBundleSource.gitlabAvatarUrl: String? get() {
+            val remote = this as? RemotePatchBundle ?: return null
+            return extractGitLabOwner(remote.endpoint)?.let { owner ->
+                "https://unavatar.io/gitlab/$owner"
+            }
+        }
+
+        /**
+         * Extract GitHub owner/organization name from endpoint URL.
          */
         private fun extractGitHubOwner(endpoint: String): String? {
             return try {
@@ -127,5 +138,23 @@ sealed class PatchBundleSource(
                 null
             }
         }
+
+        /**
+         * Extract GitLab owner/namespace from endpoint URL.
+         * Supports:
+         * - gitlab.com/owner/repo/-/raw/branch/file
+         * - gitlab.com/owner/repo (short form)
+         */
+        private fun extractGitLabOwner(endpoint: String): String? {
+            return try {
+                val uri = java.net.URI(endpoint)
+                val host = uri.host?.lowercase(java.util.Locale.US) ?: return null
+                if (host != "gitlab.com") return null
+                val segments = uri.path?.trim('/')?.split('/')?.filter { it.isNotBlank() } ?: return null
+                segments.firstOrNull()
+            } catch (_: Exception) {
+                null
+            }
+        }
     }
 }

app/src/main/java/app/morphe/manager/domain/bundles/RemotePatchBundle.kt

@@ -191,20 +191,24 @@ sealed class RemotePatchBundle(
         internal val entriesCache = mutableMapOf<String, Pair<Long, List<ChangelogEntry>>>()
 
         /**
-         * Infer GitHub page URL from various endpoint formats
+         * Infer GitHub page URL from various endpoint formats.
          */
         fun inferPageUrlFromEndpoint(endpoint: String): String? {
             return try {
                 val uri = java.net.URI(endpoint)
                 val host = uri.host?.lowercase(java.util.Locale.US)
+                val segments = uri.path?.trim('/')?.split('/')?.filter { it.isNotBlank() }
 
                 when (host) {
                     "raw.githubusercontent.com", "github.com" -> {
-                        uri.path?.trim('/')?.split('/')
-                            ?.filter { it.isNotBlank() }
-                            ?.takeIf { it.size >= 2 }
+                        segments?.takeIf { it.size >= 2 }
                             ?.let { "https://github.com/${it[0]}/${it[1]}" }
                     }
+                    "gitlab.com" -> {
+                        // gitlab.com/owner/repo/-/raw/branch/... or gitlab.com/owner/repo
+                        segments?.takeIf { it.size >= 2 }
+                            ?.let { "https://gitlab.com/${it[0]}/${it[1]}" }
+                    }
                     else -> null
                 }
             } catch (_: Exception) {
@@ -245,16 +249,18 @@ class JsonPatchBundle(
     private val stableBranch: String get() = "main"
 
     /**
-     * Parse GitHub URL and convert to raw.githubusercontent.com format.
-     * If [usePrerelease] is true, uses "dev" branch; otherwise uses "main".
+     * Resolves the effective fetch URL, substituting the target branch when
+     * [supportsPrerelease] is true.
+     *
      * Only called when [supportsPrerelease] is true, i.e. the endpoint already
      * points to "main" or "dev" - so both branches are expected to exist.
+     *
      * Supports:
-     * - https://github.com/owner/repo/tree/branch/path/file.json
-     * - https://github.com/owner/repo/blob/branch/path/file.json
-     * - https://raw.githubusercontent.com/owner/repo/branch/path/file.json (passthrough)
+     * - https://raw.githubusercontent.com/owner/repo/branch/path/file.json
+     * - https://github.com/owner/repo/tree|blob/branch/path/file.json
+     * - https://gitlab.com/owner/repo/-/raw/branch/path/file.json
      */
-    private fun parseGitHubUrl(url: String): String {
+    private fun resolveBranchUrl(url: String): String {
         return try {
             val uri = java.net.URI(url)
             val host = uri.host?.lowercase(java.util.Locale.US)
@@ -272,19 +278,23 @@ class JsonPatchBundle(
                 "github.com" -> {
                     // Parse: /owner/repo/tree|blob/branch/path/to/file.json
                     val pathParts = uri.path?.trim('/')?.split('/') ?: return url
-
                     if (pathParts.size < 5) return url // Need at least: owner, repo, tree/blob, branch, file
-
-                    val owner = pathParts[0]
-                    val repo = pathParts[1]
                     val type = pathParts[2] // "tree" or "blob"
-
                     if (type !in listOf("tree", "blob")) return url
-
+                    val owner = pathParts[0]
+                    val repo = pathParts[1]
                     val filePath = pathParts.drop(4).joinToString("/")
-
                     "https://raw.githubusercontent.com/$owner/$repo/$targetBranch/$filePath"
                 }
+                "gitlab.com" -> {
+                    // Format: owner/repo/-/raw/BRANCH/path/file.json
+                    val parts = uri.path.trim('/').split('/').toMutableList()
+                    val rawIndex = parts.indexOf("raw")
+                    if (rawIndex >= 0 && parts.getOrNull(rawIndex - 1) == "-") {
+                        parts[rawIndex + 1] = targetBranch
+                        "https://gitlab.com/${parts.joinToString("/")}"
+                    } else url
+                }
                 else -> url // Unknown host, return as-is
             }
         } catch (_: Exception) {
@@ -302,24 +312,24 @@ class JsonPatchBundle(
     }
 
     override suspend fun getLatestInfo() = withContext(Dispatchers.IO) {
-        val normalizedEndpoint = parseGitHubUrl(endpoint)
+        val resolvedEndpoint = resolveBranchUrl(endpoint)
 
         val asset = http.request<MorpheAsset> {
-            url(normalizedEndpoint)
+            url(resolvedEndpoint)
         }.getOrThrow()
 
         // If pageUrl is not set, try to infer it from the endpoint and add version tag
         if (asset.pageUrl == null) {
             val repoUrl = inferPageUrlFromEndpoint(endpoint)
             val inferredPageUrl = if (repoUrl != null && asset.version.isNotBlank()) {
                 // Normalize version to ensure it starts with 'v'
-                val normalizedVersion = if (asset.version.startsWith("v")) {
-                    asset.version
-                } else {
-                    "v${asset.version}"
-                }
-                // Create proper release page URL: https://github.com/owner/repo/releases/tag/v1.0.0-dev.1
-                "$repoUrl/releases/tag/$normalizedVersion"
+                val normalizedVersion = if (asset.version.startsWith("v")) asset.version else "v${asset.version}"
+                // Create proper release page URL:
+                // GitHub: https://github.com/owner/repo/releases/tag/v1.0.0-dev.1
+                // GitLab: https://gitlab.com/owner/repo/-/releases/v1.0.0-dev.1
+                val isGitLab = endpoint.contains("gitlab.com", ignoreCase = true)
+                if (isGitLab) "$repoUrl/-/releases/$normalizedVersion"
+                else "$repoUrl/releases/tag/$normalizedVersion"
             } else {
                 // Fallback to repository URL if version is missing
                 repoUrl
@@ -333,7 +343,7 @@ class JsonPatchBundle(
     override suspend fun fetchChangelogEntries(sinceVersion: String?): List<ChangelogEntry> {
         // endpoint stores the original branch - rebuild the URL for the active branch
         val api: MorpheAPI by inject()
-        val activeEndpoint = parseGitHubUrl(endpoint)
+        val activeEndpoint = resolveBranchUrl(endpoint)
         val changelogUrl = api.changelogUrlFromBundleEndpoint(activeEndpoint) ?: return emptyList()
         return fetchAndCacheEntries("$uid|$changelogUrl", sinceVersion) {
             api.fetchChangelogFromUrl(changelogUrl)
@@ -360,7 +370,12 @@ class JsonPatchBundle(
 
     companion object {
         /**
-         * Extracts the branch name from a GitHub URL.
+         * Extracts the branch name from a GitHub or GitLab URL.
+         *
+         * Supported formats:
+         * - raw.githubusercontent.com/owner/repo/BRANCH/path  (returns null for refs/heads/...)
+         * - github.com/owner/repo/tree|blob/BRANCH/path
+         * - gitlab.com/owner/repo/-/raw/BRANCH/path
          */
         internal fun extractBranch(url: String): String? {
             return try {
@@ -377,6 +392,13 @@ class JsonPatchBundle(
                     "github.com" -> {
                         if (parts.size >= 4 && parts[2] in listOf("tree", "blob")) parts[3] else null
                     }
+                    "gitlab.com" -> {
+                        // Format: owner/repo/-/raw/BRANCH/path...
+                        val rawIndex = parts.indexOf("raw")
+                        if (rawIndex >= 0 && parts.getOrNull(rawIndex - 1) == "-")
+                            parts.getOrNull(rawIndex + 1)
+                        else null
+                    }
                     else -> null
                 }
             } catch (_: Exception) {

app/src/main/java/app/morphe/manager/domain/repository/PatchBundleRepository.kt

@@ -1216,6 +1216,44 @@ class PatchBundleRepository(
             return "https://raw.githubusercontent.com$finalPath"
         }
 
+        // Handle GitLab repository URLs
+        // Accepts short form: gitlab.com/owner/repo
+        // Or full raw URL:    gitlab.com/owner/repo/-/raw/branch/patches-bundle.json
+        if (host.equals("gitlab.com", ignoreCase = true)) {
+            if (pathSegments.size < 2) {
+                throw IllegalArgumentException("Invalid GitLab repository URL")
+            }
+
+            val owner = pathSegments[0]
+            val repo = pathSegments[1]
+
+            // Check if this is already a raw URL: owner/repo/-/raw/branch/path
+            val rawIndex = pathSegments.indexOf("raw")
+            if (rawIndex >= 2 && pathSegments.getOrNull(rawIndex - 1) == "-") {
+                // Already a raw URL — normalize it
+                val normalizedPath = "/" + pathSegments.joinToString("/")
+                val pathNoQuery = normalizedPath.substringBefore('?').substringBefore('#')
+                if (!pathNoQuery.endsWith(".json", ignoreCase = true)) {
+                    throw IllegalArgumentException("Patch bundle URL must point to a .json file.")
+                }
+                val query = parsed.encodedQuery.takeIf { it.isNotEmpty() }?.let { "?$it" }.orEmpty()
+                return "https://gitlab.com$normalizedPath$query"
+            }
+
+            // Determine branch from GitLab UI URLs (/-/tree/branch or /-/blob/branch)
+            val treeIndex = pathSegments.indexOf("tree")
+            val blobIndex = pathSegments.indexOf("blob")
+            val branch = when {
+                treeIndex >= 2 && pathSegments.getOrNull(treeIndex - 1) == "-" ->
+                    pathSegments.getOrNull(treeIndex + 1) ?: "main"
+                blobIndex >= 2 && pathSegments.getOrNull(blobIndex - 1) == "-" ->
+                    pathSegments.getOrNull(blobIndex + 1) ?: "main"
+                else -> "main"
+            }
+
+            return "https://gitlab.com/$owner/$repo/-/raw/$branch/patches-bundle.json"
+        }
+
         // Handle raw.githubusercontent.com URLs (legacy support)
         if (host.equals("raw.githubusercontent.com", ignoreCase = true)) {
             if (pathSegments.size < 3) {

app/src/main/java/app/morphe/manager/network/api/MorpheAPI.kt

@@ -494,6 +494,16 @@ class MorpheAPI(
                     "https://raw.githubusercontent.com/${parts[0]}/${parts[1]}/$branch/CHANGELOG.md"
                 }
 
+                "gitlab.com" -> {
+                    // path: owner/repo/-/raw/branch/...
+                    if (parts.size < 2) return null
+                    val rawIndex = parts.indexOf("raw")
+                    val branch = if (rawIndex >= 0 && parts.getOrNull(rawIndex - 1) == "-") {
+                        parts.getOrNull(rawIndex + 1) ?: "main"
+                    } else "main"
+                    "https://gitlab.com/${parts[0]}/${parts[1]}/-/raw/$branch/CHANGELOG.md"
+                }
+
                 else -> null
             }
         } catch (_: Exception) {

app/src/main/java/app/morphe/manager/ui/screen/home/SourceManagementSheet.kt

@@ -55,6 +55,7 @@ import app.morphe.manager.domain.bundles.JsonPatchBundle
 import app.morphe.manager.domain.bundles.PatchBundleSource
 import app.morphe.manager.domain.bundles.PatchBundleSource.Extensions.bundleAvatarUrl
 import app.morphe.manager.domain.bundles.PatchBundleSource.Extensions.githubAvatarUrl
+import app.morphe.manager.domain.bundles.PatchBundleSource.Extensions.gitlabAvatarUrl
 import app.morphe.manager.domain.bundles.PatchBundleSource.Extensions.isDefault
 import app.morphe.manager.domain.bundles.RemotePatchBundle
 import app.morphe.manager.domain.manager.PreferencesManager
@@ -927,6 +928,7 @@ fun BundleIcon(
 ) {
     val bundleAvatarUrl = bundle.bundleAvatarUrl
     val githubAvatarUrl = bundle.githubAvatarUrl
+    val gitlabAvatarUrl = bundle.gitlabAvatarUrl
     val hasMetadataError = metadataFetchError != null
     val hasBundleError = bundle.state is PatchBundleSource.State.Failed
     val isMissing = bundle.state is PatchBundleSource.State.Missing
@@ -987,10 +989,14 @@ fun BundleIcon(
                 )
             }
 
-            bundleAvatarUrl != null || githubAvatarUrl != null -> {
+            bundleAvatarUrl != null || githubAvatarUrl != null || gitlabAvatarUrl != null -> {
                 RemoteAvatar(
-                    url = bundleAvatarUrl ?: githubAvatarUrl!!,
-                    fallbackUrl = if (bundleAvatarUrl != null) githubAvatarUrl else null,
+                    url = bundleAvatarUrl ?: githubAvatarUrl ?: gitlabAvatarUrl!!,
+                    fallbackUrl = when {
+                        bundleAvatarUrl != null -> githubAvatarUrl ?: gitlabAvatarUrl
+                        githubAvatarUrl != null -> gitlabAvatarUrl
+                        else -> null
+                    },
                     modifier = Modifier.fillMaxSize()
                 )
             }

app/src/main/res/values/strings.xml

@@ -86,6 +86,7 @@
     <string name="sources_dialog_remote_url_formats_title">Examples:</string>
     <string name="sources_dialog_remote_url_formats_list" translatable="false">"
 • github.com/owner/repo
+• gitlab.com/owner/repo
 • raw.githubusercontent.com/owner/repo/patches-bundle.json
 • example.com/patches-bundle.json"</string>
     <string name="sources_dialog_local">Local</string>
@@ -94,7 +95,7 @@
     <string name="sources_dialog_local_file_description">Select a .mpp patch source file from storage</string>
     <string name="sources_dialog_local_invalid_extension">File must have a .mpp extension</string>
     <string name="sources_dialog_url_valid">Valid repository or JSON URL</string>
-    <string name="sources_dialog_url_invalid">URL must point to a GitHub repo or .json file</string>
+    <string name="sources_dialog_url_invalid">URL must point to a GitHub/GitLab repo or .json file</string>
     <string name="sources_dialog_local_change_file">Change file</string>
     <string name="sources_dialog_preinstalled">Pre-installed</string>
     <string name="sources_update_success">Update successful</string>