feat: Complete ViewModel extraction and update documentation (#4817)

core/common/src/androidMain/kotlin/org/meshtastic/core/common/util/MeshtasticUriExt.kt

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2026 Meshtastic LLC
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU 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 General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package org.meshtastic.core.common.util
+
+import android.net.Uri
+
+/** Converts a multiplatform [MeshtasticUri] into an Android [Uri]. */
+fun MeshtasticUri.toAndroidUri(): Uri = Uri.parse(this.uriString)
+
+/** Converts an Android [Uri] into a multiplatform [MeshtasticUri]. */
+fun Uri.toMeshtasticUri(): MeshtasticUri = MeshtasticUri(this.toString())

core/common/src/commonMain/kotlin/org/meshtastic/core/common/util/MeshtasticUri.kt

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026 Meshtastic LLC
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU 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 General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package org.meshtastic.core.common.util
+
+/**
+ * A multiplatform representation of a URI, primarily used to safely pass Android Uri references through commonMain
+ * modules without coupling them to the android.net.Uri class.
+ */
+data class MeshtasticUri(val uriString: String) {
+    override fun toString(): String = uriString
+
+    companion object {
+        fun parse(uriString: String): MeshtasticUri = MeshtasticUri(uriString)
+    }
+}

core/common/src/commonTest/kotlin/org/meshtastic/core/common/util/MeshtasticUriTest.kt

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026 Meshtastic LLC
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU 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 General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+package org.meshtastic.core.common.util
+
+import kotlin.test.Test
+import kotlin.test.assertEquals
+
+class MeshtasticUriTest {
+    @Test
+    fun testParseAndToString() {
+        val uriString = "content://com.example.provider/file.txt"
+        val uri = MeshtasticUri.parse(uriString)
+        assertEquals(uriString, uri.toString())
+    }
+}