initial commit v 0.2.0

docs/SOURCES.md

@@ -0,0 +1,60 @@
+# Primary technical references
+
+Consulted for design/tooling verification on 2026-09-23. These references explain platform APIs and
+upstream architecture; they do not verify this project's Android/iOS runtime behaviour.
+
+- Android Storage Access Framework: user-selected provider files, grants, metadata, byte streams,
+  and special handling required for virtual documents.
+  https://developer.android.com/training/data-storage/shared/documents-files
+- Android PdfRenderer: seekable descriptors, lifecycle and recommendation to use an isolated process
+  for untrusted input.
+  https://developer.android.com/reference/android/graphics/pdf/PdfRenderer
+- Kotlin Multiplatform overview and platform-independent source sets.
+  https://kotlinlang.org/docs/multiplatform/get-started.html
+  https://kotlinlang.org/docs/multiplatform/multiplatform-discover-project.html
+- Kotlin Multiplatform compatibility table: Kotlin 2.2.21, Gradle, AGP and Xcode ranges.
+  https://kotlinlang.org/docs/multiplatform/multiplatform-compatibility-guide.html
+- Android Gradle Plugin 8.11 release notes: Gradle 8.13, JDK 17, API 36 and Build Tools 35 baseline.
+  https://developer.android.com/build/releases/agp-8-11-0-release-notes
+- Compose BOM / compiler configuration.
+  https://developer.android.com/develop/ui/compose/bom
+  https://developer.android.com/jetpack/androidx/releases/compose
+  https://developer.android.com/jetpack/androidx/releases/compose-kotlin
+- Gradle official distribution and wrapper checksums (8.13 entries).
+  https://gradle.org/release-checksums/
+- LibreOffice Android architecture and bootstrapping notes: real native engine, LOK thread and tiles.
+  https://raw.githubusercontent.com/LibreOffice/core/master/android/README.md
+
+Versions in this project are pinned development choices, not “latest” recommendations. Check current
+compatibility/security information before upgrading or distributing. The new preview parsers were
+written for this project; they are neither upstream LibreOffice components nor standards-certified
+implementations.
+
+## Browser and picker implementation references (reviewed 2026-09-23)
+
+- Android SAF folder access and persistable grants: https://developer.android.com/training/data-storage/shared/documents-files
+- Android 11 directory restrictions: https://developer.android.com/about/versions/11/privacy/storage
+- Intent categories / GET_CONTENT / LOCAL_ONLY / multi-result contracts: https://developer.android.com/reference/android/content/Intent
+- System-owned OPEN_DOCUMENT: https://developer.android.com/guide/components/intents-common#Storage
+- FileProvider sharing and temporary URI grants: https://developer.android.com/training/secure-file-sharing/share-file
+- Provider metadata / thumbnails: https://developer.android.com/reference/android/provider/DocumentsContract
+- Root capabilities / LOCAL_ONLY: https://developer.android.com/reference/android/provider/DocumentsContract.Root
+- AndroidX ComponentActivity lifecycle / ViewModel default arguments (inspect the pinned dependency version): https://developer.android.com/reference/androidx/activity/ComponentActivity
+
+These references establish API contracts, not proof that this source has passed a real Android build.
+
+## 0.2.3 tooling update (verified 2026-09-24)
+
+The current project changes the previous Gradle 8.13 baseline to the user's requested
+8.14.5 while retaining JDK 17, Kotlin 2.2.21 and AGP 8.11.1.
+
+- Official 8.14.5 binary distribution and wrapper JAR SHA-256 hashes:
+  https://gradle.org/release-checksums/
+- Gradle 8.14.5 release:
+  https://docs.gradle.org/8.14.5/release-notes.html
+- Daemon JVM criteria (`toolchainVersion=17`), local detection and precedence:
+  https://docs.gradle.org/current/userguide/gradle_daemon.html
+
+Official documentation and published hashes were accessible through web retrieval;
+the local build runtime could not resolve the download host. These references do
+not establish that the project has compiled or that the folder issue is fixed.