Merge branch 'docusaurus' into update-university

# Conflicts:
#	learning/links.md
#	learning/socket.md

Author: Kuzmin

learning/code.md

@@ -6,7 +6,7 @@ sidebar_position: 24
 
 ## Приложения
 * [JetBrains/kotlinconf-app](https://github.com/JetBrains/kotlinconf-app) - official KotlinConf application - backend, android, ios with shared code;
-* [Kotlin/mpp-example](https://github.com/Kotlin/mpp-example) - official Multiplatform (android + ios) sample from JetBrains;
+* [Kotlin/kmp-basic-sample](https://github.com/Kotlin/kmp-basic-sample) - official Multiplatform (android + ios) sample from JetBrains;
 * [JetBrains/KotlinFinder](https://github.com/JetBrains/KotlinFinder) - official KotlinFinder application from JetBrains and IceRock for KotlinConf 2019 (android + ios)
 * [touchlab/DroidconKotlin](https://github.com/touchlab/DroidconKotlin) - DroidCon conference application from TouchLab (android + ios);
 * [SimonSchubert/Newsout](https://github.com/SimonSchubert/Newsout) - News application sample (android + ios) using database;
@@ -34,5 +34,5 @@ sidebar_position: 24
 
 ## Библиотеки
 * <https://libs.kmp.icerock.dev>
-* <https://www.kamp.ml>
+* <https://klibs.io> — каталог KMP библиотек от JetBrains
 * [AAkira/Kotlin-Multiplatform-Libraries](https://github.com/AAkira/Kotlin-Multiplatform-Libraries)

learning/kotlin/compiler-plugins.md

@@ -1,15 +1,15 @@
 # Плагины компилятора
 
-Компилятор Kotlin позволяет делать модификацию логики компиляции за счет подключения компиляторных
-плагинов. На данный момент Kotlin/JVM и Kotlin/JS используют один вариант компиляторных плагинов, а
-Kotlin/Native другой. Для подключения используется специальный gradle плагин, который сообщает
-компилятору откуда и какие плагины компилятора нужно взять.
+Компилятор Kotlin позволяет модифицировать логику компиляции за счёт подключения компиляторных
+плагинов. Начиная с Kotlin 1.9+ / 2.0 JVM, JS и Native используют единую IR-инфраструктуру
+для плагинов. Для подключения используется специальный Gradle-плагин, который сообщает
+компилятору, откуда и какие плагины компилятора нужно взять.
 
 ## Примеры
 
 - https://github.com/Foso/KotlinCompilerPluginExample
-- https://github.com/Foso/MpApt
-- https://github.com/icerockdev/moko-widgets/tree/master/plugin
+- https://github.com/Foso/MpApt (архивирован, вместо него рекомендуется KSP)
+- https://github.com/icerockdev/moko-widgets/tree/master/plugin (архивирован)
 - https://github.com/AhmedMourad0/no-copy
 - https://kotlinlang.org/docs/all-open-plugin.html
 
@@ -33,7 +33,7 @@ kotlin.daemon.jvm.options=-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,
 
 ## Ссылки
 
-- https://bnorm.medium.com/writing-your-second-kotlin-compiler-plugin-part-1-project-setup-7b05c7d93f6c (6 частей у статьи)
+- https://blog.bnorm.dev/writing-your-second-compiler-plugin-part-1 (статья из 6 частей)
 - https://medium.com/@heyitsmohit/writing-kotlin-compiler-plugin-with-arrow-meta-cf7b3689aa3e
-- https://www.youtube.com/watch?v=w-GMlaziIyo
+- https://www.youtube.com/watch?v=w-GMlaziIyo — KotlinConf 2018, Kevin Most «Writing Your First Kotlin Compiler Plugin»
 - https://github.com/ShikaSD/kotlin-compiler-notes

learning/kotlin/kotlin-init-cases.md

@@ -2,7 +2,7 @@
 
 ## Порядок инициализации при создании объекта класса
 
-1. Объявление свойств, указанных в конструкторе класса и присвоение им значений;
+1. Объявление свойств, указанных в конструкторе класса, и присвоение им значений;
 2. Инициализация свойств в теле класса;
 3. Выполнение кода в блоке init
 *если свойств в теле класса и блоков init объявлено несколько, они инициализируются в том же порядке, в каком были объявлены*
@@ -32,7 +32,7 @@ class Person(val name: String) {
 
 ## Порядок инициализации вложенных и внутренних классов
 
-Вложенные классы не имеют доступа к переменным внешнего класса. При создании экземпляра вложенного класса экземпляр внешнего класса (в котором объявлен вложенный), создан не будет.
+Вложенные классы не имеют доступа к переменным внешнего класса. При создании экземпляра вложенного класса экземпляр внешнего класса (в котором объявлен вложенный) создан не будет.
 
 Экземпляр внутреннего класса всегда хранит ссылку на экземпляр внешнего класса. Вначале создается экземпляр внешнего класса, а затем на его основе - экземпляр внутреннего класса
 
@@ -102,7 +102,7 @@ class Person {
 Как и в предыдущем случае, компилятор не подсветит ошибку
 
 ````kotlin
-object {
+val obj = object {
     val string: String
 
     init {
@@ -180,7 +180,7 @@ Bounds(x = 1.0, y = 2.0, width = 0.0, height = 0.0)
 Bounds(x = 1.0, y = 2.0, width = 3.0, height = 4.0)
 ````
 
-При создании класса **Player** вначале происходит инициализация его класса-родителя GameObject, внутри которого создается объект класса **Bounds**. К моменту инициализации класса **Player** свойство **bounds** внутри класса-родителя уже проинициализировано значениями: x=1, y=2, которые были переданы в параметры конструктора **Player** и значениями ширины и высоты из родителя **GameObject** width=0.0, height=0.0
+При создании класса **Player** вначале происходит инициализация его класса-родителя GameObject, внутри которого создается объект класса **Bounds**. К моменту инициализации класса **Player** свойство **bounds** внутри класса-родителя уже проинициализировано значениями: x=1, y=2, которые были переданы в параметры конструктора **Player**, и значениями ширины и высоты из родителя **GameObject** width=0.0, height=0.0
 
 ## Кейс, иллюстрирующий приоритет выполнения блока init перед вторичным конструктором
 
@@ -215,13 +215,13 @@ println(case.result)
 Вернемся к иллюстрации:
 [алгоритм](./init_algorhitm.png)
 
-В процессе инициализации при создании экземпляра класса **ClassWithSecondaryConstructor** после вызова вторичного конструктора будет вызван основной конструктор класса + произойдет выполнение кода в его блоке *init* перед выполнением кода в теле вторичного конструктора. Такми образом, этот код
+В процессе инициализации при создании экземпляра класса **ClassWithSecondaryConstructor** после вызова вторичного конструктора будет вызван основной конструктор класса + произойдет выполнение кода в его блоке *init* перед выполнением кода в теле вторичного конструктора. Таким образом, этот код
 
 ````kotlin
 result += "not "
 ```` 
 
-будет выполнен перед конкатенацией значений, переданных в параметры вторичного констуктора
+будет выполнен перед конкатенацией значений, переданных в параметры вторичного конструктора
 
 ````kotlin
 this.result += secondValue

learning/libraries/moko/moko-units.md learning/legacy/moko-units.mdlearning/libraries/moko/moko-units.md renamed to learning/legacy/moko-units.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 4
+sidebar_position: 6
 ---
 
 # moko-units

learning/libraries/moko/moko-mvvm.md

@@ -4,9 +4,134 @@ sidebar_position: 3
 
 # moko-mvvm
 
-Библиотека [moko-mvvm](https://github.com/icerockdev/moko-mvvm) позволяет реализовывать приложения с паттерном 
-Model - View - ViewModel с ViewModel в общем коде.
+Библиотека [moko-mvvm](https://github.com/icerockdev/moko-mvvm) предоставляет архитектурные компоненты Model-View-ViewModel для Kotlin Multiplatform. ViewModel работает в общем коде, на Android обеспечивается lifecycle-aware поведение через интеграцию с `androidx.lifecycle`.
+
+## Возможности
+
+- **ViewModel** — хранение и управление UI и данными с `viewModelScope` (CoroutineScope, отменяемый в `onCleared`)
+- **LiveData / Flow** — реактивные обёртки с операторами (`map`, `merge`, `combine`, `all`)
+- **EventsDispatcher** — отправка одноразовых событий из ViewModel во View с контролем lifecycle (устаревший подход)
+- **CFlow / CStateFlow / CMutableStateFlow** — обёртки над корутинными Flow, совместимые со Swift
+- **ResourceState** — sealed class для состояний: `Loading`, `Success`, `Empty`, `Failed`
+- **Compose Multiplatform / SwiftUI** — готовая интеграция
+
+## Требования
+
+- Android API 16+
+- iOS 11.0+
+- Gradle 6.8+
+
+## Подключение
+
+```kotlin
+// shared/build.gradle.kts
+dependencies {
+    commonMainApi("dev.icerock.moko:mvvm-core:0.16.1")
+    commonMainApi("dev.icerock.moko:mvvm-flow:0.16.1")
+    commonMainApi("dev.icerock.moko:mvvm-state:0.16.1")
+
+    // Compose Multiplatform
+    commonMainApi("dev.icerock.moko:mvvm-compose:0.16.1")
+    commonMainApi("dev.icerock.moko:mvvm-flow-compose:0.16.1")
+
+    commonTestImplementation("dev.icerock.moko:mvvm-test:0.16.1")
+}
+```
+
+Экспорт в iOS framework:
+
+```kotlin
+kotlin {
+    targets.withType(KotlinNativeTarget::class.java).all {
+        binaries.withType(Framework::class.java).all {
+            export("dev.icerock.moko:mvvm-core:0.16.1")
+            export("dev.icerock.moko:mvvm-flow:0.16.1")
+        }
+    }
+}
+```
+
+## Simple ViewModel — счётчик на CStateFlow
+
+```kotlin
+// commonMain
+class SimpleViewModel : ViewModel() {
+    private val _counter = MutableStateFlow(0)
+    val counter: CStateFlow<String> =
+        _counter.map { it.toString() }
+            .stateIn(viewModelScope, SharingStarted.Lazily, "0")
+            .cStateFlow()
+
+    fun onCounterButtonPressed() {
+        _counter.value++
+    }
+}
+```
+
+**Compose:**
+
+```kotlin
+@Composable
+fun CounterScreen(
+    viewModel: SimpleViewModel = getViewModel(
+        factory = createViewModelFactory { SimpleViewModel() }
+    )
+) {
+    val counter: String by viewModel.counter.collectAsState()
+
+    Column {
+        Text(text = counter)
+        Button(onClick = { viewModel.onCounterButtonPressed() }) {
+            Text("Press me")
+        }
+    }
+}
+```
+
+**SwiftUI:**
+
+```swift
+struct CounterView: View {
+    @ObservedObject var viewModel: SimpleViewModel = SimpleViewModel()
+
+    var body: some View {
+        VStack {
+            Text(viewModel.counter.state(\.counter))
+            Button("Press me") { viewModel.onCounterButtonPressed() }
+        }
+    }
+}
+```
+
+## ResourceState
+
+```kotlin
+sealed class ResourceState<out T, out E> {
+    class Loading<out T, out E> : ResourceState<T, E>()
+    data class Success<out T, out E>(val data: T) : ResourceState<T, E>()
+    class Empty<out T, out E> : ResourceState<T, E>()
+    data class Failed<out T, out E>(val error: E) : ResourceState<T, E>()
+}
+```
+
+```kotlin
+val state: CStateFlow<ResourceState<List<Book>, StringDesc>> = ...
+
+// Compose
+when (val s = state.collectAsState().value) {
+    is ResourceState.Loading -> LoadingState()
+    is ResourceState.Success -> BookList(s.data)
+    is ResourceState.Empty -> EmptyState()
+    is ResourceState.Failed -> ErrorState(s.error)
+}
+```
+
+## Дополнительный материал
 
 <iframe src="//www.youtube.com/embed/qe8FcIQEmyA?list=PL6yFiPOVXVUi90sQ66dtmuXP-1-TeHwl5" frameborder="0" allowfullscreen width="675" height="380"></iframe>
 <br/>
 <br/>
+
+- [Референс библиотеки](https://github.com/icerockdev/moko-mvvm)
+- [Семплы (DataBinding)](https://github.com/icerockdev/moko-mvvm/tree/master/sample)
+- [Семплы (Compose + SwiftUI)](https://github.com/icerockdev/moko-mvvm/tree/master/sample-declarative-ui)