Update iOS navigation guides and Kotlin/Swift interop notes

Author: Dorofeev

learning/ios/navigation.md learning/ios/navigation-swiftui.mdlearning/ios/navigation.md renamed to learning/ios/navigation-swiftui.md

@@ -96,8 +96,30 @@ router.pop()              // вернуться назад
 router.replace(.signIn)   // очистить стек и перейти на авторизацию
 
 ```
-Роутер удобно получать через @EnvironmentObject, так его не нужно передавать вручную во все экраны.
+Как router передается между экранами:
+Роутер удобно получать через `@EnvironmentObject`, так его не нужно вручную передавать во все экраны.
+- AppRouterHost создаёт и хранит объект `AppRouter`.
+- Все экраны внутри этого хоста получают роутер через `environmentObject(router)`.
+- SwiftUI автоматически вкладывает объект в иерархию view, так что любой экран, который находится внутри `AppRouterHost`, может использовать его через @`EnvironmentObject`.
 
+В AppRouterHost:
+
+```swift
+@ObservedObject private var router = AppRouter<T>()
+
+var body: some View {
+    NavigationStack(path: $navigationPath) {
+        routeView(router, rootRoute)
+        .navigationDestination(
+            or: T.self,
+            destination: { routeView(router, $0) }
+        )
+    }.environmentObject(router) // роутер передается всем дочерним экранам
+}
+
+```
+
+В любом дочернем экране:
 ```swift
 struct AuthScreen: View {
     @EnvironmentObject var router: AppRouter<AppRoute>
@@ -108,7 +130,6 @@ struct AuthScreen: View {
         }
     }
 }
-
 ```
 
 ## AppRouterHost
@@ -173,6 +194,68 @@ struct RootScreenView: View {
 В этот момент RootScreenView переключает показ на `MainNavigationView`.
 Если пользователь нажимает "Выйти", то срабатывает `LogoutNavigationHookView`, и всё сбрасывается на SignIn.
 
+## LogoutNavigationHookView
+
+В приложениях часто нужно сбросить навигацию при выходе пользователя. Для этого используется LogoutNavigationHookView.
+Он оборачивает контент и отслеживает события логаута через logoutHandler. Когда происходит событие логаута, вызывается onLogout(), и можно, например, сбросить стек навигации на экран авторизации.
+
+```swift 
+import Combine
+import MultiPlatformLibrary
+import SwiftUI
+
+struct LogoutNavigationHookView<Content: View>: View {
+
+    // LogoutNavigationHookView слушает события логаута через logoutHandler.
+    private var logoutHandler: LogoutHandler = Koin.instance.getLogoutHandler()
+
+    let onLogout: () -> Void
+    let content: () -> Content
+
+    init(onLogout: @escaping () -> Void, @ViewBuilder content: @escaping () -> Content) {
+        self.onLogout = onLogout
+        self.content = content
+    }
+
+    var body: some View {
+        content()
+            .onReceive(
+                logoutHandler.logoutEvents.toPublisher()
+                    .catch { _ in Empty<KotlinUnit, Never>() }
+                    .assertNoFailure()
+            ) { _ in
+
+                // При логауте вызывается onLogout(), которое сбрасывает root.
+                onLogout()
+            }
+    }
+}
+
+```
+
+В этом примере вызов `onLogout` приводит к сбросу значения root на .mainFlow(.signIn).
+`RootScreenView` реагирует на изменение root и показывает экран авторизации.
+
+```swift
+struct RootScreenView: View {
+    @State private var root: RootScreen = .splash
 
+    var body: some View {
+        LogoutNavigationHookView(onLogout: {
+
+            // Сбрасываем стек навигации на экран авторизации
+            root = .mainFlow(route: .signIn)
+        }) {
+            switch root {
+            case .splash:
+                SplashScreen(root: $root)
+            case let .mainFlow(route):
+                MainNavigationView(initialRoute: route)
+            }
+        }
+    }
+}
+```
+Если мы получаем событие logout на любом экране, весь стек навигации автоматически сбрасывается.
 
-- [Навигяция для UIKit через координаторы (Архив)](./navigation-old.md)
+- [Навигация для UIKit через координаторы (Архив)](./navigation-uikit.md)

learning/ios/navigation-old.md learning/ios/navigation-uikit.mdlearning/ios/navigation-old.md renamed to learning/ios/navigation-uikit.md

@@ -1,4 +1,4 @@
-# Навигация
+# Навигация UIKit
 
 В основе навигации лежат координаторы. Каждый координатор покрывает логически связанный блок
 функционала, который чаще всего состоит из нескольких экранов. При этом между собой они независимы и

learning/kotlin-native/swift-interop.md

@@ -21,6 +21,15 @@ LoggerKt.log("Hello from iOS")
 ```
 То есть доступ к функции осуществляется не напрямую, а через сгенерированный класс LoggerKt.
 
+Однако при использовании [SKIE](https://skie.touchlab.co/intro) всё работает так, как ожидается - глобальные функции становятся настоящими глобальными функциями в Swift.
+
+И тогда на swift мы сможем писать так:
+```swift
+log("Hello from iOS")
+```
+
+Подробнее: https://skie.touchlab.co/features/global-functions
+
 ## Полезные ссылки:
 
 - [Interoperability with Swift/Objective-C](https://kotlinlang.org/docs/native-objc-interop.html)