COMPOSE FOUNDATION

Модульный мультиплатформенный архитектурный инструментарий, реактивные хуки, сетевой мониторинг, навигация и UI-компоненты для Compose Multiplatform.

   

---

О проекте

Compose Foundation — высокопроизводительная библиотека общего назначения и архитектурный фундамент приложений организации WHAT Technologies. Создана для стандартизации и ускорения разработки на Kotlin Multiplatform и Compose Multiplatform с поддержкой Android, JVM Desktop (Windows, macOS, Linux), Apple iOS (arm64, simulator, x64) и браузера через WebAssembly (wasmJs).

Библиотека объединяет проверенные практикой архитектурные решения: безопасное хранилище настроек с аппаратным шифрованием (Android Keystore), React-style реактивные хуки состояния (useState, useChange), типобезопасную навигацию с поддержкой полноэкранных диалогов и шторок, инспектор сетевого трафика Ktor, автоматические обновления и мониторинг доступности внешних сервисов.

Ключевые возможности

• Полная мультиплатформенность — единый унифицированный API для Android (AAR), JVM Desktop, iOS и WebAssembly.
• Модульная архитектура — возможность подключать компоненты точечно (core, navigation, state, ui, network, updater, preferences, scraper, healthcheck, delivery) либо использовать umbrella-артефакт compose-foundation.
• DX-ориентированные реактивные хуки — лаконичные примитивы useState, useChange, useInterval, useTimeout, useSave и useRestore для декларативного управления жизненным циклом и состоянием UI.
• Типобезопасная навигация — NavigationHost с регистрацией экранов без рефлексии, динамический RootNavigationContext, навигационные панели (BottomNavBar), модальные шторки и глобальные стековые диалоги.
• Защищенные настройки (Secure Key-Value) — реактивное хранилище на базе AES-GCM с интеграцией аппаратного Android Keystore и JSON-персистентностью на Desktop/Web.
• Инспектор трафика и мониторинг — потокобезопасный перехватчик сетевых вызовов Ktor (NetworkMonitorPlugin) с санитизацией чувствительных заголовков и защитой от OOM.
• Надежные обновления и дистрибуция — клиенты проверки релизов через GitHub Releases и RuStore, параллельное скачивание с поддержкой возобновления и проверка целостности APK.
• Парсинг и проверка работоспособности сервисов — готовые модули веб-скрапинга (foundation-scraper на базе Ksoup) и мониторинга сетевых эндпоинтов (foundation-healthcheck, foundation-delivery).

---

Архитектура и модули

Модульная структура позволяет гибко управлять зависимостями и подключать только необходимый функционал:

graph TD
    subgraph Meta["Мета-пакет"]
        ALL["compose-foundation<br/><i>Включает все модули транзитивно</i>"]
    end

    subgraph CoreLayer["Базовый слой"]
        CORE["foundation-core<br/><i>UIController, Logging, Auditor, Platform, Coroutines</i>"]
    end

    subgraph StateAndDataLayer["Состояние и Хранилище"]
        STATE["foundation-state<br/><i>useState, useChange, useInterval, Controllers</i>"]
        PREF["foundation-preferences<br/><i>PreferenceStorage, Android Keystore AES-GCM</i>"]
    end

    subgraph UiAndNavigationLayer["Интерфейс и Навигация"]
        UI["foundation-ui<br/><i>Icons, Themes, Base Components, LiquidBackground</i>"]
        NAV["foundation-navigation<br/><i>NavigationHost, BottomNavBar, Sheets, Dialogs</i>"]
    end

    subgraph NetworkAndServicesLayer["Сетевой стек и Сервисы"]
        NET["foundation-network<br/><i>NetworkMonitor, Ktor NetworkMonitorPlugin</i>"]
        SCRAPER["foundation-scraper<br/><i>Ksoup HTML Scraper, Multiplatform Document Parser</i>"]
        HEALTH["foundation-healthcheck<br/><i>Healthcheck Service, UI Ping & Latency Monitors</i>"]
        DELIVERY["foundation-delivery<br/><i>Delivery Engine, Remote Sync & Cache</i>"]
        UPDATER["foundation-updater<br/><i>GitHubUpdateService, APK Manager, Downloader</i>"]
        RUSTORE["foundation-updater-rustore<br/><i>RuStoreUpdateManager</i>"]
        FIREBASE["foundation-firebase<br/><i>FirebaseCrashReporter, FirebaseAnalytics</i>"]
        CRASH["foundation-crash<br/><i>CrashHandler, Bootloop Guard, CrashScreen</i>"]
    end

    ALL --> CORE
    ALL --> STATE
    ALL --> PREF
    ALL --> UI
    ALL --> NAV
    ALL --> NET
    ALL --> SCRAPER
    ALL --> HEALTH
    ALL --> DELIVERY
    ALL --> UPDATER
    ALL --> RUSTORE
    ALL --> FIREBASE
    ALL --> CRASH

    STATE --> CORE
    PREF --> CORE
    PREF --> STATE
    UI --> CORE
    UI --> STATE
    UI --> PREF
    NAV --> CORE
    NAV --> UI
    NET --> CORE
    SCRAPER --> CORE
    SCRAPER --> NET
    HEALTH --> CORE
    HEALTH --> UI
    HEALTH --> NET
    DELIVERY --> CORE
    DELIVERY --> UI
    DELIVERY --> NET
    DELIVERY --> PREF
    DELIVERY --> UPDATER
    UPDATER --> CORE
    UPDATER --> UI
    RUSTORE --> UPDATER
    FIREBASE --> CORE
    CRASH --> CORE
    CRASH --> UI

Loading

Спецификация модулей

Модуль	Артефакт	Описание	Ключевые классы и API
:foundation-core	app.what.foundation:foundation-core	Архитектурное ядро, MVI-контроллеры, платформенные утилиты и аудит логов	UIController, AppLogger, Auditor, TimeUtils, Platform
:foundation-state	app.what.foundation:foundation-state	Реактивные хуки состояния и контроллеры модальных окон	useState, useChange, useInterval, useSave, DialogController, SheetController
:foundation-preferences	app.what.foundation:foundation-preferences	Реактивное хранилище настроек с аппаратным шифрованием Keystore	PreferenceStorage, AndroidPreferenceEncryptor, KeyValueStorage
:foundation-ui	app.what.foundation:foundation-ui	UI-примитивы, набор векторных иконок, темы оформления и эффекты	SearchBox, StyledTextField, LiquidBackground, WHATIcons
:foundation-navigation	app.what.foundation:foundation-navigation	Модульная навигация для Compose Multiplatform, шторки, панели и диалоги	Navigator, NavigationHost, BottomNavBar, ProvideGlobalDialog, ProvideGlobalSheet
:foundation-network	app.what.foundation:foundation-network	Потокобезопасный инспектор сетевых запросов и Ktor плагин	NetworkMonitor, NetworkRequest, NetworkMonitorPlugin
:foundation-scraper	app.what.foundation:foundation-scraper	KMP-парсер веб-страниц на базе легковесного Ksoup-lite	HtmlDocument, Element, KsoupParser
:foundation-healthcheck	app.what.foundation:foundation-healthcheck	Мониторинг доступности и времени отклика внешних серверов и эндпоинтов	HealthcheckClient, ServiceHealth, HealthIndicator
:foundation-delivery	app.what.foundation:foundation-delivery	Механизм фоновой доставки и синхронизации локального кэша	DeliveryEngine, SyncCoordinator, RemoteCacheManager
:foundation-updater	app.what.foundation:foundation-updater	Автообновление приложений через GitHub Releases	GitHubUpdateService, GitHubUpdateManager, DownloadState
:foundation-updater-rustore	app.what.foundation:foundation-updater-rustore	Адаптер автообновлений через официальный RuStore SDK	RuStoreUpdateManager
:foundation-firebase	app.what.foundation:foundation-firebase	Мультиплатформенный фасад для Firebase Analytics и Crashlytics	FirebaseAnalyticsTracker, FirebaseCrashReporter
:foundation-crash	app.what.foundation:foundation-crash	Перехватчик сбоев, защита от bootloop и экран отчета об ошибке	CrashHandler, CurrentActivityHolder, CrashScreen
:compose-foundation	app.what.foundation:compose-foundation	Мета-пакет (Umbrella), включающий все модули библиотеки	Транзитивный доступ ко всем модулям экосистемы

---

Подключение в проект

1. Настройка репозитория GitHub Packages

Добавьте репозиторий GitHub Packages организации whatrushki в ваш settings.gradle.kts:

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("https://maven.pkg.github.com/whatrushki/compose-foundation")
            credentials {
                username = providers.gradleProperty("gpr.user").orNull 
                    ?: System.getenv("GITHUB_ACTOR")
                password = providers.gradleProperty("gpr.key").orNull 
                    ?: System.getenv("GITHUB_TOKEN")
            }
        }
    }
}

2. Подключение модулей

Подключите полный комплект или отдельные модули в вашем build.gradle.kts (в блоке commonMain.dependencies):

// Полный комплект всех компонентов:
implementation("app.what.foundation:compose-foundation:1.1.6")

// Или точечно по модулям:
implementation("app.what.foundation:foundation-core:1.1.6")
implementation("app.what.foundation:foundation-navigation:1.1.6")
implementation("app.what.foundation:foundation-state:1.1.6")
implementation("app.what.foundation:foundation-preferences:1.1.6")
implementation("app.what.foundation:foundation-ui:1.1.6")
implementation("app.what.foundation:foundation-network:1.1.6")
implementation("app.what.foundation:foundation-scraper:1.1.6")
implementation("app.what.foundation:foundation-healthcheck:1.1.6")
implementation("app.what.foundation:foundation-delivery:1.1.6")
implementation("app.what.foundation:foundation-updater:1.1.6")

---

Примеры использования

1. Реактивные хуки состояния (foundation-state)

Упрощают декларативное управление локальным состоянием без лишнего boilerplate-кода:

@Composable
fun SearchBar() {
    var query by useState("")

    // Автоматическая реакция на изменение состояния
    useChange(query) {
        println("Поисковый запрос изменился: $query")
    }

    StyledTextField(
        value = query,
        onValueChange = { query = it },
        placeholder = "Поиск..."
    )
}

2. Модульная навигация (foundation-navigation)

Типобезопасная навигация с регистрацией экранов и поддержкой глобальных диалогов и шторок:

@Serializable
data object MainRoute : NavProvider()

val appRegistry: Registry = {
    register(MainScreen::class) { MainScreen(it) }
}

@Composable
fun App() {
    ProvideGlobalDialog {
        ProvideGlobalSheet {
            NavigationHost(
                start = MainRoute,
                registry = appRegistry
            )
        }
    }
}

3. Безопасное хранилище настроек (foundation-preferences)

Поддержка шифрования AES-GCM (Android Keystore), сериализации моделей и реактивности в Compose:

@Serializable
data class UserProfile(val name: String, val role: String)

object AppSettings : PreferenceStorage(KeyValueStorageProvider.create()) {
    var isDarkTheme by boolean("dark_theme", defaultValue = false)
    var profile by model("user_profile", defaultValue = UserProfile("Гость", "Пользователь"))
}

@Composable
fun ThemeToggle() {
    val isDark by AppSettings::isDarkTheme.collect()
    Switch(checked = isDark, onCheckedChange = { AppSettings.isDarkTheme = it })
}

4. Инспектор трафика Ktor (foundation-network)

Подключение мониторинга к сетевому клиенту Ktor:

val client = HttpClient {
    install(NetworkMonitor.Plugin) {
        maxMemoryLogs = 200
        sanitizeHeaders = listOf("Authorization", "Cookie")
    }
}

---

Сборка и публикация

Сборка всех таргетов локально:

./gradlew assemble

Публикация в локальный кэш Maven:

./gradlew publishToMavenLocal

Публикация в GitHub Packages:

./gradlew publishAllPublicationsToGitHubPackagesRepository

---

Обратная связь и участие

• Баг-трекер и предложения: GitHub Issues.
• Официальные каналы коммуникации: Telegram @whatrushki.

_{© WHAT Technologies. Все права защищены. Лицензия MIT.}