From bdd9f12ccf547930225d087919f5f069d2b6c2bb Mon Sep 17 00:00:00 2001 From: y9san9 Date: Sat, 13 Apr 2024 18:44:37 +0300 Subject: [PATCH] initial commit --- .github/workflows/publish-release.yml | 140 ++++++++++ .github/workflows/publish-snapshot.yml | 132 ++++++++++ .gitignore | 9 + README.md | 219 ++++++++++++++++ build-logic/build.gradle.kts | 9 + build-logic/settings.gradle.kts | 12 + build-logic/src/main/kotlin/Version.kt | 26 ++ .../android-library-convention.gradle.kts | 47 ++++ .../kotlin/kmp-library-convention.gradle.kts | 20 ++ .../print-version-convention.gradle.kts | 13 + .../kotlin/publication-convention.gradle.kts | 24 ++ build.gradle.kts | 5 + core/build.gradle.kts | 9 + .../commonMain/kotlin/ksm/StateController.kt | 57 ++++ .../kotlin/ksm/annotation/MutateContext.kt | 7 + .../kotlin/ksm/annotation/StateBuilderDSL.kt | 4 + .../ksm/builder/StateControllerBuilder.kt | 18 ++ .../ksm/builtin/HasBuiltinPluginsPlugin.kt | 12 + .../kotlin/ksm/context/CombinedContext.kt | 22 ++ .../ksm/context/CreateChildStateContext.kt | 23 ++ .../kotlin/ksm/context/FinishStateContext.kt | 14 + .../kotlin/ksm/context/InstallPlugin.kt | 9 + .../kotlin/ksm/context/SetupStateContext.kt | 16 ++ .../ksm/context/SingleElementContext.kt | 25 ++ .../kotlin/ksm/context/StateContext.kt | 57 ++++ .../interceptor/ConfigurationInterceptor.kt | 10 + .../configuration/interceptor/StateContext.kt | 12 + .../plugin/ConfigurationPlugin.kt | 26 ++ .../plugin/ConfigurationStateController.kt | 22 ++ .../ksm/finish/once/plugin/FinishOnceEntry.kt | 20 ++ .../finish/once/plugin/FinishOncePlugin.kt | 31 +++ .../ksm/lifecycle/LifecycleInterceptor.kt | 10 + .../kotlin/ksm/lifecycle/StateContext.kt | 12 + .../ksm/lifecycle/plugin/LifecycleEntry.kt | 37 +++ .../ksm/lifecycle/plugin/LifecyclePlugin.kt | 44 ++++ .../commonMain/kotlin/ksm/plugin/Plugin.kt | 15 ++ .../kotlin/ksm/plugin/StateController.kt | 31 +++ .../serialization/BaseSerializationFormat.kt | 9 + .../serialization/BaseSerializationStore.kt | 16 ++ .../kotlin/ksm/serialization/StateContext.kt | 9 + .../BaseSerializationParametersInterceptor.kt | 24 ++ .../plugin/BaseSerializationPlugin.kt | 48 ++++ .../BaseSerializationStateController.kt | 75 ++++++ .../kotlin/ksm/stack/StateContext.kt | 35 +++ .../kotlin/ksm/stack/StateController.kt | 7 + .../ksm/stack/plugin/StateStackEntry.kt | 31 +++ .../ksm/stack/plugin/StateStackPlugin.kt | 46 ++++ .../kotlin/ksm/state/LaunchState.kt | 40 +++ .../commonMain/kotlin/ksm/state/StateScope.kt | 7 + .../ksm/state/builder/StateBuilderScope.kt | 7 + .../state/builder/StateControllerBuilder.kt | 19 ++ .../ksm/state/builder/StateRouteScope.kt | 26 ++ .../kotlin/ksm/state/data/StateContext.kt | 25 ++ .../kotlin/ksm/state/data/StateController.kt | 7 + .../kotlin/ksm/state/name/StateContext.kt | 20 ++ .../kotlin/ksm/state/name/StateRouteScope.kt | 14 + .../ksm/state/name/plugin/StateNameEntry.kt | 11 + .../ksm/state/name/plugin/StateNamePlugin.kt | 34 +++ .../ksm/state/parameters/StateContext.kt | 33 +++ .../parameters/interceptor/StateContext.kt | 34 +++ .../interceptor/StateParametersInterceptor.kt | 8 + .../MemoryStateParametersInterceptor.kt | 17 ++ .../parameters/plugin/StateParametersEntry.kt | 34 +++ .../plugin/StateParametersPlugin.kt | 52 ++++ .../commonMain/kotlin/ksm/typed/TypedValue.kt | 32 +++ core/src/commonTest/kotlin/Test.kt | 46 ++++ docs/EXPOSING_API.md | 42 +++ docs/PHASES.md | 198 ++++++++++++++ docs/STRUCTURED_NAVIGATION.md | 8 + gradle.properties | 1 + gradle/libs.versions.toml | 35 +++ gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 62076 bytes gradle/wrapper/gradle-wrapper.properties | 6 + gradlew | 245 ++++++++++++++++++ gradlew.bat | 92 +++++++ kotlinx-coroutines/build.gradle.kts | 10 + .../kotlin/ksm/coroutines/StateContext.kt | 29 +++ .../kotlin/ksm/coroutines/StateController.kt | 7 + .../interceptor/AwaitInterceptor.kt | 5 + .../ksm/coroutines/plugin/AwaitEntry.kt | 22 ++ .../ksm/coroutines/plugin/AwaitPlugin.kt | 35 +++ .../ksm/coroutines/plugin/CoroutinesEntry.kt | 33 +++ .../ksm/coroutines/plugin/CoroutinesPlugin.kt | 43 +++ kotlinx-serialization-json/build.gradle.kts | 11 + .../plugin/KotlinxSerializationFormat.kt | 35 +++ .../plugin/KotlinxSerializationPlugin.kt | 28 ++ .../serializer/GenericValueDeserializer.kt | 32 +++ .../plugin/serializer/TypedValueSerializer.kt | 31 +++ ktgbotapi/build.gradle.kts | 27 ++ .../kotlin/ksm/ktgbotapi/StateBuilderScope.kt | 8 + .../kotlin/ksm/ktgbotapi/StateContext.kt | 38 +++ .../kotlin/ksm/ktgbotapi/StateScope.kt | 42 +++ .../kotlin/ksm/ktgbotapi/TelegramBotKSM.kt | 56 ++++ .../kotlin/ksm/ktgbotapi/TelegramPeerKey.kt | 6 + .../kotlin/ksm/ktgbotapi/match/Command.kt | 12 + .../kotlin/ksm/ktgbotapi/match/Exact.kt | 13 + .../kotlin/ksm/ktgbotapi/match/MatchScope.kt | 24 ++ .../ktgbotapi/plugin/TelegramBotApiPlugin.kt | 46 ++++ .../ksm/ktgbotapi/plugin/TelegramBotEntry.kt | 12 + mdi/build.gradle.kts | 10 + .../kotlin/ksm/mdi/StateBuilderScope.kt | 8 + .../commonMain/kotlin/ksm/mdi/StateContext.kt | 10 + .../kotlin/ksm/mdi/StateController.kt | 8 + .../kotlin/ksm/mdi/plugin/DIEntry.kt | 22 ++ .../kotlin/ksm/mdi/plugin/DIPlugin.kt | 50 ++++ .../compose-navigation/build.gradle.kts | 26 ++ .../ksm/compose/RememberStateController.kt | 30 +++ .../kotlin/ksm/compose/StateBuilderScope.kt | 13 + .../main/kotlin/ksm/compose/host/StateHost.kt | 32 +++ .../kotlin/ksm/compose/plugin/ComposeEntry.kt | 13 + .../ksm/compose/plugin/ComposePlugin.kt | 55 ++++ .../plugin/ComposeSerializationStore.kt | 25 ++ settings.gradle.kts | 36 +++ 113 files changed, 3535 insertions(+) create mode 100644 .github/workflows/publish-release.yml create mode 100644 .github/workflows/publish-snapshot.yml create mode 100644 .gitignore create mode 100644 README.md create mode 100644 build-logic/build.gradle.kts create mode 100644 build-logic/settings.gradle.kts create mode 100644 build-logic/src/main/kotlin/Version.kt create mode 100644 build-logic/src/main/kotlin/android-library-convention.gradle.kts create mode 100644 build-logic/src/main/kotlin/kmp-library-convention.gradle.kts create mode 100644 build-logic/src/main/kotlin/print-version-convention.gradle.kts create mode 100644 build-logic/src/main/kotlin/publication-convention.gradle.kts create mode 100644 build.gradle.kts create mode 100644 core/build.gradle.kts create mode 100644 core/src/commonMain/kotlin/ksm/StateController.kt create mode 100644 core/src/commonMain/kotlin/ksm/annotation/MutateContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/annotation/StateBuilderDSL.kt create mode 100644 core/src/commonMain/kotlin/ksm/builder/StateControllerBuilder.kt create mode 100644 core/src/commonMain/kotlin/ksm/builtin/HasBuiltinPluginsPlugin.kt create mode 100644 core/src/commonMain/kotlin/ksm/context/CombinedContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/context/CreateChildStateContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/context/FinishStateContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/context/InstallPlugin.kt create mode 100644 core/src/commonMain/kotlin/ksm/context/SetupStateContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/context/SingleElementContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/context/StateContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/context/configuration/interceptor/ConfigurationInterceptor.kt create mode 100644 core/src/commonMain/kotlin/ksm/context/configuration/interceptor/StateContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/context/configuration/plugin/ConfigurationPlugin.kt create mode 100644 core/src/commonMain/kotlin/ksm/context/configuration/plugin/ConfigurationStateController.kt create mode 100644 core/src/commonMain/kotlin/ksm/finish/once/plugin/FinishOnceEntry.kt create mode 100644 core/src/commonMain/kotlin/ksm/finish/once/plugin/FinishOncePlugin.kt create mode 100644 core/src/commonMain/kotlin/ksm/lifecycle/LifecycleInterceptor.kt create mode 100644 core/src/commonMain/kotlin/ksm/lifecycle/StateContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/lifecycle/plugin/LifecycleEntry.kt create mode 100644 core/src/commonMain/kotlin/ksm/lifecycle/plugin/LifecyclePlugin.kt create mode 100644 core/src/commonMain/kotlin/ksm/plugin/Plugin.kt create mode 100644 core/src/commonMain/kotlin/ksm/plugin/StateController.kt create mode 100644 core/src/commonMain/kotlin/ksm/serialization/BaseSerializationFormat.kt create mode 100644 core/src/commonMain/kotlin/ksm/serialization/BaseSerializationStore.kt create mode 100644 core/src/commonMain/kotlin/ksm/serialization/StateContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/serialization/plugin/BaseSerializationParametersInterceptor.kt create mode 100644 core/src/commonMain/kotlin/ksm/serialization/plugin/BaseSerializationPlugin.kt create mode 100644 core/src/commonMain/kotlin/ksm/serialization/plugin/BaseSerializationStateController.kt create mode 100644 core/src/commonMain/kotlin/ksm/stack/StateContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/stack/StateController.kt create mode 100644 core/src/commonMain/kotlin/ksm/stack/plugin/StateStackEntry.kt create mode 100644 core/src/commonMain/kotlin/ksm/stack/plugin/StateStackPlugin.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/LaunchState.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/StateScope.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/builder/StateBuilderScope.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/builder/StateControllerBuilder.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/builder/StateRouteScope.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/data/StateContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/data/StateController.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/name/StateContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/name/StateRouteScope.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/name/plugin/StateNameEntry.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/name/plugin/StateNamePlugin.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/parameters/StateContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/parameters/interceptor/StateContext.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/parameters/interceptor/StateParametersInterceptor.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/parameters/interceptor/memory/MemoryStateParametersInterceptor.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/parameters/plugin/StateParametersEntry.kt create mode 100644 core/src/commonMain/kotlin/ksm/state/parameters/plugin/StateParametersPlugin.kt create mode 100644 core/src/commonMain/kotlin/ksm/typed/TypedValue.kt create mode 100644 core/src/commonTest/kotlin/Test.kt create mode 100644 docs/EXPOSING_API.md create mode 100644 docs/PHASES.md create mode 100644 docs/STRUCTURED_NAVIGATION.md create mode 100644 gradle.properties create mode 100644 gradle/libs.versions.toml create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100755 gradlew create mode 100644 gradlew.bat create mode 100644 kotlinx-coroutines/build.gradle.kts create mode 100644 kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/StateContext.kt create mode 100644 kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/StateController.kt create mode 100644 kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/interceptor/AwaitInterceptor.kt create mode 100644 kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/AwaitEntry.kt create mode 100644 kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/AwaitPlugin.kt create mode 100644 kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/CoroutinesEntry.kt create mode 100644 kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/CoroutinesPlugin.kt create mode 100644 kotlinx-serialization-json/build.gradle.kts create mode 100644 kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/KotlinxSerializationFormat.kt create mode 100644 kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/KotlinxSerializationPlugin.kt create mode 100644 kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/serializer/GenericValueDeserializer.kt create mode 100644 kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/serializer/TypedValueSerializer.kt create mode 100644 ktgbotapi/build.gradle.kts create mode 100644 ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/StateBuilderScope.kt create mode 100644 ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/StateContext.kt create mode 100644 ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/StateScope.kt create mode 100644 ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/TelegramBotKSM.kt create mode 100644 ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/TelegramPeerKey.kt create mode 100644 ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/match/Command.kt create mode 100644 ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/match/Exact.kt create mode 100644 ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/match/MatchScope.kt create mode 100644 ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/plugin/TelegramBotApiPlugin.kt create mode 100644 ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/plugin/TelegramBotEntry.kt create mode 100644 mdi/build.gradle.kts create mode 100644 mdi/src/commonMain/kotlin/ksm/mdi/StateBuilderScope.kt create mode 100644 mdi/src/commonMain/kotlin/ksm/mdi/StateContext.kt create mode 100644 mdi/src/commonMain/kotlin/ksm/mdi/StateController.kt create mode 100644 mdi/src/commonMain/kotlin/ksm/mdi/plugin/DIEntry.kt create mode 100644 mdi/src/commonMain/kotlin/ksm/mdi/plugin/DIPlugin.kt create mode 100644 navigation/compose-navigation/build.gradle.kts create mode 100644 navigation/compose-navigation/src/main/kotlin/ksm/compose/RememberStateController.kt create mode 100644 navigation/compose-navigation/src/main/kotlin/ksm/compose/StateBuilderScope.kt create mode 100644 navigation/compose-navigation/src/main/kotlin/ksm/compose/host/StateHost.kt create mode 100644 navigation/compose-navigation/src/main/kotlin/ksm/compose/plugin/ComposeEntry.kt create mode 100644 navigation/compose-navigation/src/main/kotlin/ksm/compose/plugin/ComposePlugin.kt create mode 100644 navigation/compose-navigation/src/main/kotlin/ksm/compose/plugin/ComposeSerializationStore.kt create mode 100644 settings.gradle.kts diff --git a/.github/workflows/publish-release.yml b/.github/workflows/publish-release.yml new file mode 100644 index 0000000..feeb1a9 --- /dev/null +++ b/.github/workflows/publish-release.yml @@ -0,0 +1,140 @@ +name: Library Release Deploy + +on: + push: + branches: [ "main" ] + workflow_dispatch: + +env: + GITHUB_USERNAME: "meetacy" + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + +jobs: + + deploy-multiplatform: + runs-on: ubuntu-latest + outputs: + release_version: ${{ steps.output_version.outputs.release_version }} + steps: + - uses: actions/checkout@v3 + - name: Setup Java + uses: actions/setup-java@v3 + with: + distribution: temurin + java-version: 11 + - name: Gradle Cache Setup + uses: gradle/gradle-build-action@v2 + - name: Gradle Sync + run: ./gradlew + - name: Add Version to Env + run: | + release_version=$(./gradlew printVersion -q) + echo "release_version=$release_version" >> $GITHUB_ENV + - name: Publish ${{ env.release_version }} + run: ./gradlew publishKotlinMultiplatformPublicationToGitHubRepository + - name: Add Sdk Version to Output + id: output_version + run: echo "release_version=${{ env.release_version }}" >> $GITHUB_OUTPUT + + deploy-jvm: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v3 + - name: Setup Java + uses: actions/setup-java@v3 + with: + distribution: temurin + java-version: 11 + - name: Gradle Cache Setup + uses: gradle/gradle-build-action@v2 + - name: Gradle Sync + run: ./gradlew + - name: Add Version to Env + run: | + release_version=$(./gradlew printVersion -q) + echo "release_version=$release_version" >> $GITHUB_ENV + - name: Publish ${{ env.release_version }} + run: ./gradlew publishJvmPublicationToGitHubRepository + + deploy-android: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v3 + - name: Setup Java + uses: actions/setup-java@v3 + with: + distribution: temurin + java-version: 11 + - name: Gradle Cache Setup + uses: gradle/gradle-build-action@v2 + - name: Gradle Sync + run: ./gradlew + - name: Add Version to Env + run: | + release_version=$(./gradlew printVersion -q) + echo "release_version=$release_version" >> $GITHUB_ENV + - name: Publish ${{ env.release_version }} + run: ./gradlew publishAndroidPublicationToGitHubRepository + + deploy-js: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v3 + - name: Setup Java + uses: actions/setup-java@v3 + with: + distribution: temurin + java-version: 11 + - name: Gradle Cache Setup + uses: gradle/gradle-build-action@v2 + - name: Gradle Sync + run: ./gradlew + - name: Add Version to Env + run: | + release_version=$(./gradlew printVersion -q) + echo "release_version=$release_version" >> $GITHUB_ENV + - name: Publish ${{ env.release_version }} + run: ./gradlew publishJsPublicationToGitHubRepository + + deploy-konan: + runs-on: macos-latest + steps: + - uses: actions/checkout@v3 + - name: Setup Java + uses: actions/setup-java@v3 + with: + distribution: temurin + java-version: 11 + - name: Gradle Cache Setup + uses: gradle/gradle-build-action@v2 + - name: Konan Cache Setup + uses: actions/cache@v3 + with: + path: ~/.konan + key: konan-cache + - name: Gradle Sync + run: ./gradlew + - name: Add Version to Env + run: | + release_version=$(./gradlew printVersion -q) + echo "release_version=$release_version" >> $GITHUB_ENV + - name: Publish ${{ env.release_version }} + run: | + ./gradlew publishIosX64PublicationToGitHubRepository \ + publishIosSimulatorArm64PublicationToGitHubRepository \ + publishIosArm64PublicationToGitHubRepository + + create-release: + runs-on: ubuntu-latest + needs: + - deploy-multiplatform + - deploy-jvm + - deploy-js + - deploy-konan + - deploy-android + steps: + - name: Create Release + uses: actions/create-release@v1 + with: + tag_name: ${{ needs.deploy-multiplatform.outputs.release_version }} + release_name: Release ${{ needs.deploy-multiplatform.outputs.release_version }} diff --git a/.github/workflows/publish-snapshot.yml b/.github/workflows/publish-snapshot.yml new file mode 100644 index 0000000..3e4f8de --- /dev/null +++ b/.github/workflows/publish-snapshot.yml @@ -0,0 +1,132 @@ +name: Library Snapshot Deploy + +on: + push: + branches-ignore: [ "main" ] + workflow_dispatch: + +env: + GITHUB_USERNAME: "meetacy" + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + BRANCH_NAME: ${{ github.head_ref || github.ref_name }} + ORG_GRADLE_PROJECT_snapshot: true + ORG_GRADLE_PROJECT_commit: ${{ github.sha }} + ORG_GRADLE_PROJECT_attempt: ${{ github.run_attempt }} + +jobs: + + deploy-multiplatform: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v3 + - name: Setup Java + uses: actions/setup-java@v3 + with: + distribution: temurin + java-version: 11 + - name: Gradle Cache Setup + uses: gradle/gradle-build-action@v2 + with: + cache-read-only: ${{ github.ref != 'refs/heads/dev' }} + - name: Gradle Sync + run: ./gradlew + - name: Add Version to Env + run: | + snapshot_version=$(./gradlew printVersion -q) + echo "snapshot_version=$snapshot_version" >> $GITHUB_ENV + - name: Publish ${{ env.snapshot_version }} + run: ./gradlew publishKotlinMultiplatformPublicationToMeetacySdkRepository + + deploy-jvm: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v3 + - name: Setup Java + uses: actions/setup-java@v3 + with: + distribution: temurin + java-version: 11 + - name: Gradle Cache Setup + uses: gradle/gradle-build-action@v2 + with: + cache-read-only: ${{ github.ref != 'refs/heads/dev' }} + - name: Gradle Sync + run: ./gradlew + - name: Add Version to Env + run: | + snapshot_version=$(./gradlew printVersion -q) + echo "snapshot_version=$snapshot_version" >> $GITHUB_ENV + - name: Publish ${{ env.snapshot_version }} + run: ./gradlew publishJvmPublicationToMeetacySdkRepository + + deploy-android: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v3 + - name: Setup Java + uses: actions/setup-java@v3 + with: + distribution: temurin + java-version: 11 + - name: Gradle Cache Setup + uses: gradle/gradle-build-action@v2 + - name: Gradle Sync + run: ./gradlew + - name: Add Version to Env + run: | + release_version=$(./gradlew printVersion -q) + echo "release_version=$release_version" >> $GITHUB_ENV + - name: Publish ${{ env.release_version }} + run: ./gradlew publishAndroidPublicationToGitHubRepository + + deploy-js: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v3 + - name: Setup Java + uses: actions/setup-java@v3 + with: + distribution: temurin + java-version: 11 + - name: Gradle Cache Setup + uses: gradle/gradle-build-action@v2 + with: + cache-read-only: ${{ github.ref != 'refs/heads/dev' }} + - name: Gradle Sync + run: ./gradlew + - name: Add Version to Env + run: | + snapshot_version=$(./gradlew printVersion -q) + echo "snapshot_version=$snapshot_version" >> $GITHUB_ENV + - name: Publish ${{ env.snapshot_version }} + run: ./gradlew publishJsPublicationToMeetacySdkRepository + + deploy-konan: + runs-on: macos-latest + steps: + - uses: actions/checkout@v3 + - name: Setup Java + uses: actions/setup-java@v3 + with: + distribution: temurin + java-version: 11 + - name: Gradle Cache Setup + uses: gradle/gradle-build-action@v2 + with: + cache-read-only: ${{ github.ref != 'refs/heads/dev' }} + - name: Konan Cache Setup + uses: actions/cache@v3 + with: + path: ~/.konan + key: konan-cache + - name: Gradle Sync + run: ./gradlew + - name: Add Version to Env + run: | + snapshot_version=$(./gradlew printVersion -q) + echo "snapshot_version=$snapshot_version" >> $GITHUB_ENV + - name: Publish ${{ env.snapshot_version }} + run: | + ./gradlew publishIosX64PublicationToMeetacySdkRepository \ + publishIosSimulatorArm64PublicationToMeetacySdkRepository \ + publishIosArm64PublicationToMeetacySdkRepository diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..9d14494 --- /dev/null +++ b/.gitignore @@ -0,0 +1,9 @@ +.idea +build +.gradle +.kotlin +kotlin-js-store +local.properties +**/.DS_Store +*/**/xcuserdata +**/*xcworkspace diff --git a/README.md b/README.md new file mode 100644 index 0000000..567c59c --- /dev/null +++ b/README.md @@ -0,0 +1,219 @@ +# Kotlin State Machine + +## Overall Idea + +This library tries to unify approach of different implications of +state machines. For now, considered cases to support are: + +- Multiplatform Navigation (With convenient native wrappers) +- Native Navigation for android/iOS (Without redundant entities needed for multiplatform) +- FSM for telegram bots + +Even though FSM for telegram bots and Navigation seems to be completely +different things they actually do share lots of common things such as: + +- Coroutines Integration (both need to start/cancel scope when start/finish state and structured concurrency when state starts child state) +- Serialization Integration (both need to save entries when state is resumed = +either the state was just created or it's child was finished and the state become top state) +- Stack Integration (both have the same stack idea which is also shared between them) + +## Plugins + +All functionality of StateController is extended using Plugins. Plugin is just a simple interface with +the only method 'install(context: Context): Context' which creates a new context with plugin +installed in it. + +There are some core principles and idioms of writing plugins. + + +// TODO: + +- plugin and it's internal things under 'plugin' folder +- public apis under feature folder +- you should NEVER append elements to context except for context interceptors (otherwise onResume will work incorrect) + +## WIP + +Some WIP docs are under [docs folder](docs). + +## Example + +### Telegram Bots + +
+ Example + +```kotlin +package ksm.ktgbotapi.example + +import dev.inmo.tgbotapi.bot.TelegramBot +import dev.inmo.tgbotapi.extensions.utils.types.buttons.replyKeyboard +import dev.inmo.tgbotapi.types.buttons.SimpleKeyboardButton +import dev.inmo.tgbotapi.types.message.abstracts.PrivateContentMessage +import dev.inmo.tgbotapi.types.update.MessageUpdate +import kotlinx.coroutines.flow.Flow +import ksm.context.finish +import ksm.finish +import ksm.kotlinx.serialization.plugin.KotlinxSerializationPlugin +import ksm.ktgbotapi.* +import ksm.ktgbotapi.match.command +import ksm.ktgbotapi.match.exact +import ksm.state.builder.StateRouteScope +import ksm.state.builder.states +import ksm.state.launch +import ksm.state.name.named + +const val MAIN_STATE = "MainState" +const val MAIN_MENU_STATE = "MainMenuState" +const val STATE_A = "MainMenuState" +const val STATE_B = "MainMenuState" + +val MessageUpdate.peerKey: TelegramPeerKey get() { + val message = data as PrivateContentMessage<*> + val id = message.chat.id + return TelegramPeerKey(id.chatId.long.toString()) +} + +suspend fun start( + bot: TelegramBot, + updates: Flow +) { + val fsm = TelegramBotStateMachine { + install(KotlinxSerializationPlugin()) + + states { + main() + mainMenu() + stateA() + stateB() + } + } + + fsm.start( + startStateName = MAIN_STATE, + telegramBot = bot, + updates = updates, + key = MessageUpdate::peerKey + ) +} + +fun StateRouteScope.main() = named(MAIN_STATE) { + execute { + sendMessage( + text = "Hello, ${user.firstName}! Choose an option using buttons below:", + replyMarkup = replyKeyboard(oneTimeKeyboard = true) { + +SimpleKeyboardButton(text = "Launch StateA") + +SimpleKeyboardButton(text = "Launch StateB") + } + ) + controller.launch(MAIN_MENU_STATE) + } +} + +fun StateRouteScope.mainMenu() = named(MAIN_MENU_STATE) { + execute { + matchMessage { + exact("Launch StateA") { controller.launch(STATE_A) } + exact("Launch StateB") { controller.launch(STATE_B) } + command("cancel") { controller.finish() } + } + } +} + +fun StateRouteScope.stateA() = named(STATE_A) { + execute { sendMessage("StateA!") } +} + +fun StateRouteScope.stateB() = named(STATE_B) { + execute { sendMessage("StateB!") } +} +``` + +
+ +### Compose + +
+ Example + +```kotlin +package ksm.compose.example + +import androidx.compose.runtime.Composable +import androidx.compose.runtime.LaunchedEffect +import app.meetacy.di.DI +import ksm.mdi.di +import ksm.mdi.plugin.DIPlugin +import kotlinx.coroutines.flow.Flow +import kotlinx.coroutines.flow.emptyFlow +import ksm.compose.Content +import ksm.compose.example.MainViewModel.Action +import ksm.compose.host.StateHost +import ksm.compose.rememberStateController +import ksm.kotlinx.serialization.plugin.KotlinxSerializationPlugin +import ksm.state.builder.StateRouteScope +import ksm.state.builder.states +import ksm.state.data.receive +import ksm.state.launch +import ksm.state.name.named + +class MainViewModel { + val actions: Flow = emptyFlow() + + sealed interface Action { + data object RouteDetails : Action + } +} + +data class DetailsParameters(val info: String) + +const val MAIN_STATE = "MainState" +const val DETAILS_STATE = "DetailsState" + +@Composable +fun AppContent(di: DI) { + val controller = rememberStateController { + install(KotlinxSerializationPlugin()) + install(DIPlugin(di)) + + states { + main() + details() + } + } + + StateHost( + controller = controller, + startStateName = MAIN_STATE + ) +} + +fun StateRouteScope.main() = named(MAIN_STATE) { + Content { + val viewModel: MainViewModel = controller.di.viewModel() + + LaunchedEffect(viewModel) { + viewModel.actions.collect { action -> + when (action) { + Action.RouteDetails -> controller.launch( + name = DETAILS_STATE, + data = DetailsParameters(info = "Test") + ) + } + } + } + } +} + +fun StateRouteScope.details() = named(DETAILS_STATE) { + Content { + val parameters: DetailsParameters = controller.receive() + + LaunchedEffect(Unit) { + println(parameters) + } + } +} +``` + +
diff --git a/build-logic/build.gradle.kts b/build-logic/build.gradle.kts new file mode 100644 index 0000000..60a2a2b --- /dev/null +++ b/build-logic/build.gradle.kts @@ -0,0 +1,9 @@ +plugins { + `kotlin-dsl` +} + +dependencies { + api(libs.kotlin.gradle.plugin) + api(libs.kotlinx.serialization.gradle.plugin) + api(libs.android.gradle.plugin) +} diff --git a/build-logic/settings.gradle.kts b/build-logic/settings.gradle.kts new file mode 100644 index 0000000..ae470e1 --- /dev/null +++ b/build-logic/settings.gradle.kts @@ -0,0 +1,12 @@ +dependencyResolutionManagement { + repositories { + mavenCentral() + google() + } + + versionCatalogs { + create("libs") { + from(files("../gradle/libs.versions.toml")) + } + } +} diff --git a/build-logic/src/main/kotlin/Version.kt b/build-logic/src/main/kotlin/Version.kt new file mode 100644 index 0000000..719ec1a --- /dev/null +++ b/build-logic/src/main/kotlin/Version.kt @@ -0,0 +1,26 @@ +import org.gradle.api.Project + +fun Project.versionFromProperties(acceptor: (String) -> Unit) { + afterEvaluate { + acceptor(versionFromProperties()) + } +} + +fun Project.versionFromProperties(): String { + val snapshot = project.findProperty("snapshot")?.toString()?.toBooleanStrict() + if (snapshot == null || !snapshot) return project.version.toString() + + val commit = project.property("commit").toString() + val attempt = project.property("attempt").toString().toInt() + + val version = buildString { + append(project.version) + append("-build") + append(commit.take(n = 7)) + if (attempt > 1) { + append(attempt) + } + } + + return version +} diff --git a/build-logic/src/main/kotlin/android-library-convention.gradle.kts b/build-logic/src/main/kotlin/android-library-convention.gradle.kts new file mode 100644 index 0000000..2081e18 --- /dev/null +++ b/build-logic/src/main/kotlin/android-library-convention.gradle.kts @@ -0,0 +1,47 @@ +plugins { + id("com.android.library") + kotlin("android") + id("publication-convention") +} + +android { + compileSdk = 33 + + defaultConfig { + minSdk = 21 + targetSdk = 33 + } + + buildFeatures { + buildConfig = false + } + + publishing { + singleVariant("release") { + withSourcesJar() + } + } + + compileOptions { + sourceCompatibility = JavaVersion.VERSION_1_8 + targetCompatibility = JavaVersion.VERSION_1_8 + } +} + +publishing { + publications { + register("android") { + groupId = "app.meetacy.ksm" + artifactId = project.name + afterEvaluate { + version = versionFromProperties() + from(components["release"]) + } + } + } +} + +kotlin { + explicitApi() + jvmToolchain(8) +} diff --git a/build-logic/src/main/kotlin/kmp-library-convention.gradle.kts b/build-logic/src/main/kotlin/kmp-library-convention.gradle.kts new file mode 100644 index 0000000..a0bdddc --- /dev/null +++ b/build-logic/src/main/kotlin/kmp-library-convention.gradle.kts @@ -0,0 +1,20 @@ +plugins { + kotlin("multiplatform") + id("publication-convention") +} + +kotlin { + explicitApi() + + jvmToolchain(8) + + jvm() + + js(IR) { + browser() + nodejs() + } + iosArm64() + iosX64() + iosSimulatorArm64() +} diff --git a/build-logic/src/main/kotlin/print-version-convention.gradle.kts b/build-logic/src/main/kotlin/print-version-convention.gradle.kts new file mode 100644 index 0000000..b31e74a --- /dev/null +++ b/build-logic/src/main/kotlin/print-version-convention.gradle.kts @@ -0,0 +1,13 @@ +@file:Suppress("UNUSED_VARIABLE") + +import org.gradle.kotlin.dsl.creating + +tasks { + val printVersion by creating { + group = "CI" + + doFirst { + println(versionFromProperties()) + } + } +} diff --git a/build-logic/src/main/kotlin/publication-convention.gradle.kts b/build-logic/src/main/kotlin/publication-convention.gradle.kts new file mode 100644 index 0000000..b6d92bc --- /dev/null +++ b/build-logic/src/main/kotlin/publication-convention.gradle.kts @@ -0,0 +1,24 @@ +plugins { + id("org.gradle.maven-publish") +} + +group = "app.meetacy.ksm" + +publishing { + repositories { + maven { + name = "GitHub" + url = uri("https://maven.pkg.github.com/meetacy/ksm") + credentials { + username = System.getenv("GITHUB_USERNAME") + password = System.getenv("GITHUB_TOKEN") + } + } + } + + publications.withType { + versionFromProperties { version -> + this.version = version + } + } +} diff --git a/build.gradle.kts b/build.gradle.kts new file mode 100644 index 0000000..6b123e4 --- /dev/null +++ b/build.gradle.kts @@ -0,0 +1,5 @@ +plugins { + id("print-version-convention") +} + +version = libs.versions.ksm.get() diff --git a/core/build.gradle.kts b/core/build.gradle.kts new file mode 100644 index 0000000..a8e5b6f --- /dev/null +++ b/core/build.gradle.kts @@ -0,0 +1,9 @@ +plugins { + id("kmp-library-convention") +} + +version = libs.versions.ksm.get() + +dependencies { + commonTestImplementation(kotlin("test")) +} diff --git a/core/src/commonMain/kotlin/ksm/StateController.kt b/core/src/commonMain/kotlin/ksm/StateController.kt new file mode 100644 index 0000000..7ca2aae --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/StateController.kt @@ -0,0 +1,57 @@ +package ksm + +import ksm.builder.StateControllerBuilder +import ksm.builtin.HasBuiltinPluginsPlugin +import ksm.context.StateContext +import ksm.context.configuration.plugin.ConfigurationPlugin +import ksm.context.finish +import ksm.finish.once.plugin.FinishOncePlugin +import ksm.lifecycle.plugin.LifecyclePlugin +import ksm.stack.plugin.StateStackPlugin +import ksm.state.name.plugin.StateNamePlugin +import ksm.state.parameters.plugin.StateParametersPlugin + +public inline fun createRawStateController( + context: StateContext = StateContext.Empty, + enableStateName: Boolean = true, + enableStateParameters: Boolean = true, + enableConfiguration: Boolean = true, + enableLifecycle: Boolean = true, + enableStateStack: Boolean = true, + enableFinishOnce: Boolean = true, + builder: StateControllerBuilder.() -> Unit = {} +): StateController { + var applied = context + + applied = StateControllerBuilder(applied).apply { + if (HasBuiltinPluginsPlugin in context) return@apply + + // Installing built-in features + if (enableConfiguration) install(ConfigurationPlugin) + if (enableStateName) install(StateNamePlugin) + if (enableStateParameters) install(StateParametersPlugin) + if (enableLifecycle) install(LifecyclePlugin) + if (enableStateStack) install(StateStackPlugin) + if (enableFinishOnce) install(FinishOncePlugin) + + install(HasBuiltinPluginsPlugin) + }.apply(builder).build() + + return object : StateController { + override val context = applied + } +} + +public fun StateController(context: StateContext): StateController { + return object : StateController { + override val context = context + } +} + +public interface StateController { + public val context: StateContext +} + +public fun StateController.finish() { + context.finish() +} diff --git a/core/src/commonMain/kotlin/ksm/annotation/MutateContext.kt b/core/src/commonMain/kotlin/ksm/annotation/MutateContext.kt new file mode 100644 index 0000000..d89c855 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/annotation/MutateContext.kt @@ -0,0 +1,7 @@ +package ksm.annotation + +@RequiresOptIn( + message = "Indicates that the following function creates a copy of context. " + + "Do not opt-in! Only propagate this annotation" +) +public annotation class MutateContext diff --git a/core/src/commonMain/kotlin/ksm/annotation/StateBuilderDSL.kt b/core/src/commonMain/kotlin/ksm/annotation/StateBuilderDSL.kt new file mode 100644 index 0000000..449dfea --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/annotation/StateBuilderDSL.kt @@ -0,0 +1,4 @@ +package ksm.annotation + +@DslMarker +public annotation class StateBuilderDSL diff --git a/core/src/commonMain/kotlin/ksm/builder/StateControllerBuilder.kt b/core/src/commonMain/kotlin/ksm/builder/StateControllerBuilder.kt new file mode 100644 index 0000000..e55a251 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/builder/StateControllerBuilder.kt @@ -0,0 +1,18 @@ +package ksm.builder + +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.install +import ksm.plugin.Plugin + +public class StateControllerBuilder(public var context: StateContext) { + + @OptIn(MutateContext::class) + public fun install(plugin: Plugin) { + context = context.install(plugin) + } + + public fun build(): StateContext { + return context + } +} diff --git a/core/src/commonMain/kotlin/ksm/builtin/HasBuiltinPluginsPlugin.kt b/core/src/commonMain/kotlin/ksm/builtin/HasBuiltinPluginsPlugin.kt new file mode 100644 index 0000000..61030cb --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/builtin/HasBuiltinPluginsPlugin.kt @@ -0,0 +1,12 @@ +package ksm.builtin + +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.plugin.Plugin + +public object HasBuiltinPluginsPlugin : Plugin.Singleton { + + // HasBuiltinPluginsPlugin is installed and added to context automatically + @MutateContext + override fun install(context: StateContext): StateContext = context +} diff --git a/core/src/commonMain/kotlin/ksm/context/CombinedContext.kt b/core/src/commonMain/kotlin/ksm/context/CombinedContext.kt new file mode 100644 index 0000000..1149f54 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/context/CombinedContext.kt @@ -0,0 +1,22 @@ +package ksm.context + +import ksm.annotation.MutateContext + +/** + * [right] elements overwrite [left] elements + */ +internal class CombinedContext( + val left: StateContext, + val right: StateContext +) : StateContext { + override val keys = left.keys + right.keys + + override fun get(key: StateContext.Key): T? { + return right[key] ?: left[key] + } + + @MutateContext + override fun minus(key: StateContext.Key<*>): StateContext { + return CombinedContext(left.minus(key), right.minus(key)) + } +} diff --git a/core/src/commonMain/kotlin/ksm/context/CreateChildStateContext.kt b/core/src/commonMain/kotlin/ksm/context/CreateChildStateContext.kt new file mode 100644 index 0000000..8e55629 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/context/CreateChildStateContext.kt @@ -0,0 +1,23 @@ +package ksm.context + +import ksm.annotation.MutateContext +import ksm.context.configuration.plugin.ConfigurationPlugin +import ksm.lifecycle.plugin.LifecyclePlugin + +@OptIn(MutateContext::class) +public inline fun StateContext.createChildContext( + setup: (StateContext) -> Unit +): StateContext { + this[LifecyclePlugin]?.onPause(context = this) + + val applied = this[ConfigurationPlugin] + ?.onConfigure(context = this) + ?: this + + applied.apply(setup) + + applied[LifecyclePlugin]?.onCreate(applied) + applied[LifecyclePlugin]?.onResume(applied) + + return applied +} diff --git a/core/src/commonMain/kotlin/ksm/context/FinishStateContext.kt b/core/src/commonMain/kotlin/ksm/context/FinishStateContext.kt new file mode 100644 index 0000000..8b5bfdf --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/context/FinishStateContext.kt @@ -0,0 +1,14 @@ +package ksm.context + +import ksm.finish.once.plugin.FinishOncePlugin +import ksm.stack.previousContextOrNull +import ksm.lifecycle.plugin.LifecyclePlugin + +public fun StateContext.finish(): StateContext { + this[FinishOncePlugin]?.finish(context = this) + this[LifecyclePlugin]?.onPause(context = this) + this[LifecyclePlugin]?.onFinish(context = this) + val previousContext = previousContextOrNull ?: return this + previousContext[LifecyclePlugin]?.onResume(context = previousContext) + return this +} diff --git a/core/src/commonMain/kotlin/ksm/context/InstallPlugin.kt b/core/src/commonMain/kotlin/ksm/context/InstallPlugin.kt new file mode 100644 index 0000000..8326e3b --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/context/InstallPlugin.kt @@ -0,0 +1,9 @@ +package ksm.context + +import ksm.annotation.MutateContext +import ksm.plugin.Plugin + +@MutateContext +public fun StateContext.install(plugin: Plugin): StateContext { + return plugin.install(context = this + plugin) +} diff --git a/core/src/commonMain/kotlin/ksm/context/SetupStateContext.kt b/core/src/commonMain/kotlin/ksm/context/SetupStateContext.kt new file mode 100644 index 0000000..13a7da8 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/context/SetupStateContext.kt @@ -0,0 +1,16 @@ +package ksm.context + +import ksm.annotation.MutateContext + +@MutateContext +public inline fun StateContext.plus( + vararg elements: StateContext.Element, + block: StateContext.() -> Unit = {} +): StateContext { + val result = elements.fold( + initial = this, + operation = StateContext::plus + ) + block(result) + return result +} diff --git a/core/src/commonMain/kotlin/ksm/context/SingleElementContext.kt b/core/src/commonMain/kotlin/ksm/context/SingleElementContext.kt new file mode 100644 index 0000000..7805daf --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/context/SingleElementContext.kt @@ -0,0 +1,25 @@ +package ksm.context + +import ksm.annotation.MutateContext + +public fun StateContext.Element.asContext(): StateContext { + return SingleElementContext(element = this) +} + +private class SingleElementContext(val element: StateContext.Element): StateContext { + override val keys = setOf(element.key) + + @Suppress("UNCHECKED_CAST") + override fun get(key: StateContext.Key): T? { + return if (element.key == key) (element as T) else null + } + + @MutateContext + override fun minus(key: StateContext.Key<*>): StateContext { + return if (key == element.key) { + StateContext.Empty + } else { + this + } + } +} diff --git a/core/src/commonMain/kotlin/ksm/context/StateContext.kt b/core/src/commonMain/kotlin/ksm/context/StateContext.kt new file mode 100644 index 0000000..98e5310 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/context/StateContext.kt @@ -0,0 +1,57 @@ +package ksm.context + +import ksm.annotation.MutateContext + +public interface StateContext { + /** + * Contract: Variable should be constant + */ + public val keys: Set> + + public operator fun get(key: Key): T? + public fun require(key: Key): T = get(key) ?: error("Cannot find element with key $key") + + public operator fun contains(key: Key<*>): Boolean = get(key) != null + + @MutateContext + public operator fun plus(other: Element): StateContext { + return plus(other.asContext()) + } + + @MutateContext + public operator fun plus(other: StateContext): StateContext { + if (this === Empty) return other + return CombinedContext(left = this, right = other) + } + + @MutateContext + public operator fun minus(key: Key<*>): StateContext + + public interface Key + + public interface Element { + public val key: Key<*> + + public interface Singleton> : Element, Key { + override val key: Key get() = this + } + } + + public object Empty : StateContext { + override val keys: Set> = emptySet() + override fun get(key: Key): T? = null + @MutateContext + override fun minus(key: Key<*>): StateContext = this + } +} + + +public operator fun StateContext?.get(key: StateContext.Key): T? { + return this?.get(key) +} + +public operator fun StateContext?.contains(key: StateContext.Key<*>): Boolean { + return this?.contains(key) ?: false +} + +public fun StateContext?.orEmpty(): StateContext = this ?: StateContext.Empty diff --git a/core/src/commonMain/kotlin/ksm/context/configuration/interceptor/ConfigurationInterceptor.kt b/core/src/commonMain/kotlin/ksm/context/configuration/interceptor/ConfigurationInterceptor.kt new file mode 100644 index 0000000..0c19ca2 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/context/configuration/interceptor/ConfigurationInterceptor.kt @@ -0,0 +1,10 @@ +package ksm.context.configuration.interceptor + +import ksm.annotation.MutateContext +import ksm.context.StateContext + +public fun interface ConfigurationInterceptor { + + @MutateContext + public fun onConfigure(context: StateContext): StateContext +} diff --git a/core/src/commonMain/kotlin/ksm/context/configuration/interceptor/StateContext.kt b/core/src/commonMain/kotlin/ksm/context/configuration/interceptor/StateContext.kt new file mode 100644 index 0000000..0fb080b --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/context/configuration/interceptor/StateContext.kt @@ -0,0 +1,12 @@ +package ksm.context.configuration.interceptor + +import ksm.context.StateContext +import ksm.context.configuration.plugin.ConfigurationPlugin +import ksm.plugin.plugin + +public fun StateContext.addConfigurationInterceptor(interceptor: ConfigurationInterceptor) { + plugin(ConfigurationPlugin).addConfigurationInterceptor( + context = this, + interceptor = interceptor + ) +} diff --git a/core/src/commonMain/kotlin/ksm/context/configuration/plugin/ConfigurationPlugin.kt b/core/src/commonMain/kotlin/ksm/context/configuration/plugin/ConfigurationPlugin.kt new file mode 100644 index 0000000..9edbabb --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/context/configuration/plugin/ConfigurationPlugin.kt @@ -0,0 +1,26 @@ +package ksm.context.configuration.plugin + +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor +import ksm.plugin.Plugin + +public object ConfigurationPlugin : Plugin.Singleton { + + @MutateContext + override fun install(context: StateContext): StateContext { + return context + ConfigurationStateController() + } + + public fun addConfigurationInterceptor( + context: StateContext, + interceptor: ConfigurationInterceptor + ) { + context.require(ConfigurationStateController).addInterceptor(interceptor) + } + + @MutateContext + public fun onConfigure(context: StateContext): StateContext { + return context.require(ConfigurationStateController).onConfigure(context) + } +} diff --git a/core/src/commonMain/kotlin/ksm/context/configuration/plugin/ConfigurationStateController.kt b/core/src/commonMain/kotlin/ksm/context/configuration/plugin/ConfigurationStateController.kt new file mode 100644 index 0000000..65ee286 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/context/configuration/plugin/ConfigurationStateController.kt @@ -0,0 +1,22 @@ +package ksm.context.configuration.plugin + +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor + +internal class ConfigurationStateController : StateContext.Element { + override val key = ConfigurationStateController + + private val interceptors = mutableListOf() + + fun addInterceptor(interceptor: ConfigurationInterceptor) { + interceptors += interceptor + } + + @MutateContext + fun onConfigure(context: StateContext): StateContext { + return interceptors.fold(context) { acc, interceptor -> interceptor.onConfigure(acc) } + } + + companion object : StateContext.Key +} diff --git a/core/src/commonMain/kotlin/ksm/finish/once/plugin/FinishOnceEntry.kt b/core/src/commonMain/kotlin/ksm/finish/once/plugin/FinishOnceEntry.kt new file mode 100644 index 0000000..f960ac4 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/finish/once/plugin/FinishOnceEntry.kt @@ -0,0 +1,20 @@ +package ksm.finish.once.plugin + +import ksm.context.StateContext + +internal class FinishOnceEntry : StateContext.Element { + override val key = FinishOncePlugin + + private var isFinished: Boolean = false + + fun checkCanCreate() { + if (isFinished) error("Current state was already finished, cannot create a new one") + } + + fun finish() { + if (isFinished) error("Current state was already finished, cannot finish it twice") + isFinished = true + } + + companion object : StateContext.Key +} diff --git a/core/src/commonMain/kotlin/ksm/finish/once/plugin/FinishOncePlugin.kt b/core/src/commonMain/kotlin/ksm/finish/once/plugin/FinishOncePlugin.kt new file mode 100644 index 0000000..e78f9ec --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/finish/once/plugin/FinishOncePlugin.kt @@ -0,0 +1,31 @@ +package ksm.finish.once.plugin + +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor +import ksm.context.configuration.interceptor.addConfigurationInterceptor +import ksm.plugin.Plugin + +public object FinishOncePlugin : Plugin.Singleton { + + @MutateContext + override fun install(context: StateContext): StateContext { + context.addConfigurationInterceptor(Configuration) + return context + } + + private object Configuration : ConfigurationInterceptor { + @MutateContext + override fun onConfigure(context: StateContext): StateContext { + return context + FinishOnceEntry() + } + } + + public fun checkCanCreate(context: StateContext) { + context.require(FinishOnceEntry).checkCanCreate() + } + + public fun finish(context: StateContext) { + context.require(FinishOnceEntry).finish() + } +} diff --git a/core/src/commonMain/kotlin/ksm/lifecycle/LifecycleInterceptor.kt b/core/src/commonMain/kotlin/ksm/lifecycle/LifecycleInterceptor.kt new file mode 100644 index 0000000..0258caf --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/lifecycle/LifecycleInterceptor.kt @@ -0,0 +1,10 @@ +package ksm.lifecycle + +import ksm.context.StateContext + +public interface LifecycleInterceptor { + public fun onCreate(context: StateContext) {} + public fun onResume(context: StateContext) {} + public fun onPause(context: StateContext) {} + public fun onFinish(context: StateContext) {} +} diff --git a/core/src/commonMain/kotlin/ksm/lifecycle/StateContext.kt b/core/src/commonMain/kotlin/ksm/lifecycle/StateContext.kt new file mode 100644 index 0000000..dff3a3c --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/lifecycle/StateContext.kt @@ -0,0 +1,12 @@ +package ksm.lifecycle + +import ksm.context.StateContext +import ksm.lifecycle.plugin.LifecyclePlugin +import ksm.plugin.plugin + +public fun StateContext.addLifecycleInterceptor(interceptor: LifecycleInterceptor) { + plugin(LifecyclePlugin).addLifecycleInterceptor( + context = this, + observer = interceptor + ) +} diff --git a/core/src/commonMain/kotlin/ksm/lifecycle/plugin/LifecycleEntry.kt b/core/src/commonMain/kotlin/ksm/lifecycle/plugin/LifecycleEntry.kt new file mode 100644 index 0000000..72b65c0 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/lifecycle/plugin/LifecycleEntry.kt @@ -0,0 +1,37 @@ +package ksm.lifecycle.plugin + +import ksm.context.StateContext +import ksm.lifecycle.LifecycleInterceptor + +internal class LifecycleEntry : StateContext.Element { + override val key = LifecycleEntry + + private val observers = mutableListOf() + + fun addInterceptor(observer: LifecycleInterceptor) { + observers += observer + } + + fun onCreate(context: StateContext) { + for (observer in observers) { + observer.onCreate(context) + } + } + fun onResume(context: StateContext) { + for (observer in observers) { + observer.onResume(context) + } + } + fun onPause(context: StateContext) { + for (observer in observers) { + observer.onPause(context) + } + } + fun onFinish(context: StateContext) { + for (observer in observers) { + observer.onFinish(context) + } + } + + companion object : StateContext.Key +} diff --git a/core/src/commonMain/kotlin/ksm/lifecycle/plugin/LifecyclePlugin.kt b/core/src/commonMain/kotlin/ksm/lifecycle/plugin/LifecyclePlugin.kt new file mode 100644 index 0000000..a895b9b --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/lifecycle/plugin/LifecyclePlugin.kt @@ -0,0 +1,44 @@ +package ksm.lifecycle.plugin + +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor +import ksm.context.configuration.interceptor.addConfigurationInterceptor +import ksm.lifecycle.LifecycleInterceptor +import ksm.plugin.Plugin + +public object LifecyclePlugin : Plugin.Singleton { + + @MutateContext + override fun install(context: StateContext): StateContext { + context.addConfigurationInterceptor(Configuration) + return context + LifecycleEntry() + } + + private object Configuration : ConfigurationInterceptor { + @MutateContext + override fun onConfigure(context: StateContext): StateContext { + return context + LifecycleEntry() + } + } + + public fun addLifecycleInterceptor( + context: StateContext, + observer: LifecycleInterceptor + ) { + context.require(LifecycleEntry).addInterceptor(observer) + } + + public fun onCreate(context: StateContext) { + context.require(LifecycleEntry).onCreate(context) + } + public fun onResume(context: StateContext) { + context.require(LifecycleEntry).onResume(context) + } + public fun onPause(context: StateContext) { + context.require(LifecycleEntry).onPause(context) + } + public fun onFinish(context: StateContext) { + context.require(LifecycleEntry).onFinish(context) + } +} diff --git a/core/src/commonMain/kotlin/ksm/plugin/Plugin.kt b/core/src/commonMain/kotlin/ksm/plugin/Plugin.kt new file mode 100644 index 0000000..ce6e668 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/plugin/Plugin.kt @@ -0,0 +1,15 @@ +package ksm.plugin + +import ksm.annotation.MutateContext +import ksm.context.StateContext + +public interface Plugin : StateContext.Element { + override val key: StateContext.Key<*> + + @MutateContext + public fun install(context: StateContext): StateContext + + public interface Singleton> : Plugin, StateContext.Element.Singleton { + override val key: StateContext.Key get() = this + } +} diff --git a/core/src/commonMain/kotlin/ksm/plugin/StateController.kt b/core/src/commonMain/kotlin/ksm/plugin/StateController.kt new file mode 100644 index 0000000..0d4c9e4 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/plugin/StateController.kt @@ -0,0 +1,31 @@ +package ksm.plugin + +import ksm.context.StateContext + +@Deprecated( + message = "Use array access syntax instead", + replaceWith = ReplaceWith( + expression = "this[key]" + ) +) +public inline fun StateContext.pluginOrNull(key: StateContext.Key): T? { + return this[key] +} + +public inline fun StateContext.ifPlugin( + key: StateContext.Key, + block: T.() -> Unit +) { + this[key]?.run(block) +} + +public inline fun StateContext.plugin(key: StateContext.Key): T { + return this[key] ?: error("Plugin `${T::class.simpleName}` is not installed") +} + +public inline fun StateContext.withPlugin( + key: StateContext.Key, + block: T.() -> Unit +) { + plugin(key).run(block) +} diff --git a/core/src/commonMain/kotlin/ksm/serialization/BaseSerializationFormat.kt b/core/src/commonMain/kotlin/ksm/serialization/BaseSerializationFormat.kt new file mode 100644 index 0000000..d81fad5 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/serialization/BaseSerializationFormat.kt @@ -0,0 +1,9 @@ +package ksm.serialization + +import ksm.typed.TypedValue +import kotlin.reflect.KType + +public interface BaseSerializationFormat { + public fun encode(value: TypedValue<*>) + public fun decode(type: KType): Any? +} diff --git a/core/src/commonMain/kotlin/ksm/serialization/BaseSerializationStore.kt b/core/src/commonMain/kotlin/ksm/serialization/BaseSerializationStore.kt new file mode 100644 index 0000000..29a2bb2 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/serialization/BaseSerializationStore.kt @@ -0,0 +1,16 @@ +package ksm.serialization + +import ksm.context.StateContext + +public interface BaseSerializationStore { + public suspend fun await() {} + + public interface String : BaseSerializationStore, StateContext.Element { + override val key: Companion get() = String + + public fun get(): kotlin.String? + public fun apply(string: kotlin.String) + + public companion object : StateContext.Key + } +} diff --git a/core/src/commonMain/kotlin/ksm/serialization/StateContext.kt b/core/src/commonMain/kotlin/ksm/serialization/StateContext.kt new file mode 100644 index 0000000..ea4202e --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/serialization/StateContext.kt @@ -0,0 +1,9 @@ +package ksm.serialization + +import ksm.context.StateContext +import ksm.plugin.plugin +import ksm.serialization.plugin.BaseSerializationPlugin + +public fun StateContext.restore() { + plugin(BaseSerializationPlugin).restore(context = this) +} diff --git a/core/src/commonMain/kotlin/ksm/serialization/plugin/BaseSerializationParametersInterceptor.kt b/core/src/commonMain/kotlin/ksm/serialization/plugin/BaseSerializationParametersInterceptor.kt new file mode 100644 index 0000000..8ade552 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/serialization/plugin/BaseSerializationParametersInterceptor.kt @@ -0,0 +1,24 @@ +package ksm.serialization.plugin + +import ksm.state.parameters.interceptor.StateParametersInterceptor +import ksm.typed.TypedValue + +internal class BaseSerializationParametersInterceptor : StateParametersInterceptor { + private val map = mutableMapOf>() + + override fun onPut( + key: String, + value: TypedValue<*> + ) { + map[key] = TypedValue.Generic.of(value) + } + + @Suppress("UNCHECKED_CAST") + override fun onReceive(key: String): TypedValue.Generic? { + return map[key] as TypedValue.Generic? + } + + fun toMap(): Map> { + return map + } +} diff --git a/core/src/commonMain/kotlin/ksm/serialization/plugin/BaseSerializationPlugin.kt b/core/src/commonMain/kotlin/ksm/serialization/plugin/BaseSerializationPlugin.kt new file mode 100644 index 0000000..c2a2e63 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/serialization/plugin/BaseSerializationPlugin.kt @@ -0,0 +1,48 @@ +package ksm.serialization.plugin + +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor +import ksm.context.configuration.interceptor.addConfigurationInterceptor +import ksm.lifecycle.LifecycleInterceptor +import ksm.lifecycle.addLifecycleInterceptor +import ksm.plugin.Plugin +import ksm.serialization.BaseSerializationFormat +import ksm.state.parameters.interceptor.addParametersInterceptor + +public class BaseSerializationPlugin(format: BaseSerializationFormat) : Plugin { + override val key: Companion = BaseSerializationPlugin + private val controller = BaseSerializationStateController(format) + + @MutateContext + override fun install( + context: StateContext + ): StateContext { + context.addConfigurationInterceptor(Configuration()) + return context + } + + private inner class Configuration : ConfigurationInterceptor { + @MutateContext + override fun onConfigure(context: StateContext): StateContext { + val parametersInterceptor = BaseSerializationParametersInterceptor() + context.addParametersInterceptor(parametersInterceptor) + context.addLifecycleInterceptor(Lifecycle(parametersInterceptor)) + return context + } + } + + private inner class Lifecycle( + val interceptor: BaseSerializationParametersInterceptor + ) : LifecycleInterceptor { + override fun onResume(context: StateContext) { + controller.commit(context, interceptor) + } + } + + public fun restore(context: StateContext) { + controller.restore(context) + } + + public companion object : StateContext.Key +} diff --git a/core/src/commonMain/kotlin/ksm/serialization/plugin/BaseSerializationStateController.kt b/core/src/commonMain/kotlin/ksm/serialization/plugin/BaseSerializationStateController.kt new file mode 100644 index 0000000..371f1ac --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/serialization/plugin/BaseSerializationStateController.kt @@ -0,0 +1,75 @@ +package ksm.serialization.plugin + +import ksm.context.StateContext +import ksm.context.createChildContext +import ksm.serialization.BaseSerializationFormat +import ksm.stack.previousContextOrNull +import ksm.state.name.setStateName +import ksm.state.name.stateName +import ksm.state.parameters.setStateParameter +import ksm.typed.TypedValue +import kotlin.reflect.typeOf + +private typealias SerializedStackType = List>>> + +internal class BaseSerializationStateController( + private val format: BaseSerializationFormat +) : StateContext.Element { + override val key = BaseSerializationStateController + + private val serializedStackType = typeOf() + + @Suppress("UNCHECKED_CAST") + fun restore(root: StateContext) { + val serializedStack = format.decode(serializedStackType) as SerializedStackType + var current = root + for (serializedEntry in serializedStack) { + current = decodeEntry(current, serializedEntry.data) + } + } + + private fun decodeEntry( + context: StateContext, + parameters: Map> + ): StateContext = context.createChildContext { child -> + val name = parameters[STATE_NAME_KEY]?.data as String? + if (name != null) { + child.setStateName(name) + } + for ((key, value) in parameters) { + if (key == STATE_NAME_KEY) continue + child.setStateParameter(key, value) + } + } + + fun commit(context: StateContext, entry: BaseSerializationParametersInterceptor) { + var current: StateContext? = context + val serializedStack = mutableListOf>() + + while (current != null) { + val encodedEntry = encodeEntry(current, entry) + serializedStack.add( + // Make sure root context is always on top + index = 0, + element = encodedEntry + ) + current = context.previousContextOrNull + } + + val value = TypedValue.of(serializedStack.toList()) + format.encode(value) + } + + private fun encodeEntry( + context: StateContext, + entry: BaseSerializationParametersInterceptor + ): TypedValue<*> { + val name = STATE_NAME_KEY to TypedValue.Generic.of(context.stateName) + val map = entry.toMap() + name + return TypedValue.of(map) + } + + companion object : StateContext.Key { + const val STATE_NAME_KEY = "ksm.serialization.plugin.STATE_NAME" + } +} diff --git a/core/src/commonMain/kotlin/ksm/stack/StateContext.kt b/core/src/commonMain/kotlin/ksm/stack/StateContext.kt new file mode 100644 index 0000000..8f70257 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/stack/StateContext.kt @@ -0,0 +1,35 @@ +package ksm.stack + +import ksm.context.StateContext +import ksm.plugin.ifPlugin +import ksm.serialization.plugin.BaseSerializationPlugin +import ksm.stack.plugin.StateStackPlugin + +public val StateContext.previousContext: StateContext + get() = previousContextOrNull ?: error("Cannot get previous context") + +public val StateContext.previousContextOrNull: StateContext? + get() = this[StateStackPlugin]?.previousContextOrNull(context = this) + +public val StateContext.nextContext: StateContext + get() = nextContextOrNull ?: error("Cannot get next context") + +public val StateContext.nextContextOrNull: StateContext? + get() = this[StateStackPlugin]?.nextContextOrNull(context = this) + +public val StateContext.hasNextContext: Boolean + get() = nextContextOrNull != null + +public val StateContext.lastContext: StateContext + get() = lastContextOrNull ?: error("There is no child context") + +public val StateContext.lastContextOrNull: StateContext? get() { + var context: StateContext? = null + while (hasNextContext) { + context = nextContext + } + return context +} + +public val StateContext.lastContextOrThis: StateContext + get() = lastContextOrNull ?: this diff --git a/core/src/commonMain/kotlin/ksm/stack/StateController.kt b/core/src/commonMain/kotlin/ksm/stack/StateController.kt new file mode 100644 index 0000000..ca95c53 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/stack/StateController.kt @@ -0,0 +1,7 @@ +package ksm.stack + +import ksm.StateController + +public val StateController.previous: StateController get() { + return StateController(context.previousContext) +} diff --git a/core/src/commonMain/kotlin/ksm/stack/plugin/StateStackEntry.kt b/core/src/commonMain/kotlin/ksm/stack/plugin/StateStackEntry.kt new file mode 100644 index 0000000..66f23f5 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/stack/plugin/StateStackEntry.kt @@ -0,0 +1,31 @@ +package ksm.stack.plugin + +import ksm.context.StateContext +import ksm.context.finish +import ksm.context.get +import ksm.state.name.stateName + +internal class StateStackEntry( + private val previousEntry: StateStackEntry? +) : StateContext.Element { + override val key = StateStackEntry + + val previousContext: StateContext? get() = previousEntry?.context + + private lateinit var context: StateContext + + var nextContext: StateContext? = null + private set + + fun attachContext(context: StateContext) { + this.context = context + previousEntry?.nextContext = context + } + + fun onFinish() { + previousEntry?.nextContext = null + nextContext?.finish() + } + + companion object : StateContext.Key +} diff --git a/core/src/commonMain/kotlin/ksm/stack/plugin/StateStackPlugin.kt b/core/src/commonMain/kotlin/ksm/stack/plugin/StateStackPlugin.kt new file mode 100644 index 0000000..5f61d76 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/stack/plugin/StateStackPlugin.kt @@ -0,0 +1,46 @@ +package ksm.stack.plugin + +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor +import ksm.plugin.Plugin +import ksm.context.configuration.interceptor.addConfigurationInterceptor +import ksm.lifecycle.LifecycleInterceptor +import ksm.lifecycle.addLifecycleInterceptor + +public object StateStackPlugin : Plugin.Singleton { + + @MutateContext + override fun install(context: StateContext): StateContext { + context.addConfigurationInterceptor(Configuration) + return context + } + + private object Configuration : ConfigurationInterceptor { + @MutateContext + override fun onConfigure(context: StateContext): StateContext { + val entry = StateStackEntry(context[StateStackEntry]) + context.addLifecycleInterceptor(Lifecycle(entry)) + return context + entry + } + } + + private class Lifecycle(val entry: StateStackEntry) : LifecycleInterceptor { + override fun onCreate(context: StateContext) { + entry.attachContext(context) + } + override fun onFinish(context: StateContext) { + entry.onFinish() + } + } + + public fun previousContextOrNull(context: StateContext): StateContext? { + return context.require(StateStackEntry).previousContext + } + + public fun nextContextOrNull( + context: StateContext + ): StateContext? { + return context.require(StateStackEntry).nextContext + } +} diff --git a/core/src/commonMain/kotlin/ksm/state/LaunchState.kt b/core/src/commonMain/kotlin/ksm/state/LaunchState.kt new file mode 100644 index 0000000..0ec4560 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/LaunchState.kt @@ -0,0 +1,40 @@ +package ksm.state + +import ksm.StateController +import ksm.context.StateContext +import ksm.context.createChildContext +import ksm.state.data.setStateData +import ksm.state.name.setStateName +import ksm.typed.TypedValue + +public inline fun StateController.launch( + name: String, + data: T +) { + launch(name, TypedValue.of(data)) +} + +public fun StateController.launch( + name: String, + data: TypedValue<*> = TypedValue.of(Unit) +) { + context.launchChildContext(name, data) +} + +public inline fun StateContext.launchChildContext( + name: String, + data: T +) { + launchChildContext(name, TypedValue.of(data)) +} + +public fun StateContext.launchChildContext( + name: String, + data: TypedValue<*> = TypedValue.of(Unit) +) { + createChildContext { child -> + child.setStateName(name) + child.setStateData(data) + } +} + diff --git a/core/src/commonMain/kotlin/ksm/state/StateScope.kt b/core/src/commonMain/kotlin/ksm/state/StateScope.kt new file mode 100644 index 0000000..0425b9b --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/StateScope.kt @@ -0,0 +1,7 @@ +package ksm.state + +import ksm.StateController +import ksm.annotation.StateBuilderDSL + +@StateBuilderDSL +public class StateScope(public val controller: StateController) diff --git a/core/src/commonMain/kotlin/ksm/state/builder/StateBuilderScope.kt b/core/src/commonMain/kotlin/ksm/state/builder/StateBuilderScope.kt new file mode 100644 index 0000000..9283049 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/builder/StateBuilderScope.kt @@ -0,0 +1,7 @@ +package ksm.state.builder + +import ksm.annotation.StateBuilderDSL +import ksm.context.StateContext + +@StateBuilderDSL +public class StateBuilderScope(public val context: StateContext) diff --git a/core/src/commonMain/kotlin/ksm/state/builder/StateControllerBuilder.kt b/core/src/commonMain/kotlin/ksm/state/builder/StateControllerBuilder.kt new file mode 100644 index 0000000..ef12462 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/builder/StateControllerBuilder.kt @@ -0,0 +1,19 @@ +package ksm.state.builder + +import ksm.builder.StateControllerBuilder +import ksm.context.StateContext +import ksm.lifecycle.LifecycleInterceptor +import ksm.lifecycle.addLifecycleInterceptor + +public fun StateControllerBuilder.states(block: StateRouteScope.() -> Unit) { + val interceptor = object : LifecycleInterceptor { + override fun onCreate(context: StateContext) { + val scope = StateRouteScope(context) + block(scope) + if (!scope.intercepted) { + error("Cannot launch state because there is no handlers for this") + } + } + } + context.addLifecycleInterceptor(interceptor) +} diff --git a/core/src/commonMain/kotlin/ksm/state/builder/StateRouteScope.kt b/core/src/commonMain/kotlin/ksm/state/builder/StateRouteScope.kt new file mode 100644 index 0000000..416eeb7 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/builder/StateRouteScope.kt @@ -0,0 +1,26 @@ +package ksm.state.builder + +import ksm.annotation.StateBuilderDSL +import ksm.context.StateContext + +@StateBuilderDSL +public class StateRouteScope( + public val context: StateContext +) { + internal var intercepted = false + + public fun intercept() { + require(!intercepted) { "State was already intercepted" } + intercepted = true + } + + public inline fun intercept( + predicate: () -> Boolean, + block: StateBuilderScope.() -> Unit + ) { + if (predicate()) { + intercept() + block(StateBuilderScope(context)) + } + } +} diff --git a/core/src/commonMain/kotlin/ksm/state/data/StateContext.kt b/core/src/commonMain/kotlin/ksm/state/data/StateContext.kt new file mode 100644 index 0000000..432cbc1 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/data/StateContext.kt @@ -0,0 +1,25 @@ +package ksm.state.data + +import ksm.context.StateContext +import ksm.state.parameters.receiveStateParameter +import ksm.state.parameters.setStateParameter +import ksm.typed.TypedValue +import kotlin.reflect.KType + +public const val STATE_DATA_KEY: String = "ksm.state.data.STATE_DATA" + +public inline fun StateContext.setStateData(value: T) { + setStateData(TypedValue.of(value)) +} + +public fun StateContext.setStateData(value: TypedValue<*>) { + setStateParameter(STATE_DATA_KEY, value) +} + +public inline fun StateContext.receive(): T { + return receiveStateParameter(STATE_DATA_KEY) ?: error("Data is not provided") +} + +public fun StateContext.receive(type: KType): Any? { + return receiveStateParameter(STATE_DATA_KEY, type) +} diff --git a/core/src/commonMain/kotlin/ksm/state/data/StateController.kt b/core/src/commonMain/kotlin/ksm/state/data/StateController.kt new file mode 100644 index 0000000..f117a75 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/data/StateController.kt @@ -0,0 +1,7 @@ +package ksm.state.data + +import ksm.StateController + +public inline fun StateController.receive(): T { + return context.receive() +} diff --git a/core/src/commonMain/kotlin/ksm/state/name/StateContext.kt b/core/src/commonMain/kotlin/ksm/state/name/StateContext.kt new file mode 100644 index 0000000..91c9075 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/name/StateContext.kt @@ -0,0 +1,20 @@ +package ksm.state.name + +import ksm.context.StateContext +import ksm.plugin.plugin +import ksm.state.name.plugin.StateNamePlugin + +public fun StateContext.setStateName(name: String) { + plugin(StateNamePlugin).setName( + context = this, + name = name + ) +} + +public val StateContext.stateName: String get() { + return stateNameOrNull ?: error("Current state has no name") +} + +public val StateContext.stateNameOrNull: String? get() { + return plugin(StateNamePlugin).stateName(context = this) +} diff --git a/core/src/commonMain/kotlin/ksm/state/name/StateRouteScope.kt b/core/src/commonMain/kotlin/ksm/state/name/StateRouteScope.kt new file mode 100644 index 0000000..5c170d7 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/name/StateRouteScope.kt @@ -0,0 +1,14 @@ +package ksm.state.name + +import ksm.state.builder.StateBuilderScope +import ksm.state.builder.StateRouteScope + +public inline fun StateRouteScope.named( + string: String, + block: StateBuilderScope.() -> Unit +) { + intercept( + predicate = { context.stateNameOrNull == string }, + block = block + ) +} diff --git a/core/src/commonMain/kotlin/ksm/state/name/plugin/StateNameEntry.kt b/core/src/commonMain/kotlin/ksm/state/name/plugin/StateNameEntry.kt new file mode 100644 index 0000000..8c389cc --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/name/plugin/StateNameEntry.kt @@ -0,0 +1,11 @@ +package ksm.state.name.plugin + +import ksm.context.StateContext + +internal class StateNameEntry : StateContext.Element { + override val key = StateNameEntry + + var name: String? = null + + companion object : StateContext.Key +} diff --git a/core/src/commonMain/kotlin/ksm/state/name/plugin/StateNamePlugin.kt b/core/src/commonMain/kotlin/ksm/state/name/plugin/StateNamePlugin.kt new file mode 100644 index 0000000..728413f --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/name/plugin/StateNamePlugin.kt @@ -0,0 +1,34 @@ +package ksm.state.name.plugin + +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor +import ksm.context.configuration.interceptor.addConfigurationInterceptor +import ksm.plugin.Plugin + +public object StateNamePlugin : Plugin.Singleton { + + @MutateContext + override fun install(context: StateContext): StateContext { + context.addConfigurationInterceptor(Configuration) + return context + } + + private object Configuration : ConfigurationInterceptor { + @MutateContext + override fun onConfigure(context: StateContext): StateContext { + return context + StateNameEntry() + } + } + + public fun setName( + context: StateContext, + name: String + ) { + context.require(StateNameEntry).name = name + } + + public fun stateName(context: StateContext): String? { + return context.require(StateNameEntry).name + } +} diff --git a/core/src/commonMain/kotlin/ksm/state/parameters/StateContext.kt b/core/src/commonMain/kotlin/ksm/state/parameters/StateContext.kt new file mode 100644 index 0000000..60dcb7e --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/parameters/StateContext.kt @@ -0,0 +1,33 @@ +package ksm.state.parameters + +import ksm.context.StateContext +import ksm.plugin.plugin +import ksm.state.parameters.plugin.StateParametersPlugin +import ksm.typed.TypedValue +import kotlin.reflect.KType +import kotlin.reflect.typeOf + +public fun StateContext.setStateParameter( + key: String, + value: TypedValue +) { + plugin(StateParametersPlugin).put( + context = this, + key = key, + value = value + ) +} + +public inline fun StateContext.receiveStateParameter(key: String): T? { + return receiveStateParameter(key, typeOf()) +} + +public fun StateContext.receiveStateParameter( + key: String, + type: KType +): T? { + return plugin(StateParametersPlugin).receive( + context = this, + key = key + )?.get(type) +} diff --git a/core/src/commonMain/kotlin/ksm/state/parameters/interceptor/StateContext.kt b/core/src/commonMain/kotlin/ksm/state/parameters/interceptor/StateContext.kt new file mode 100644 index 0000000..9e30c22 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/parameters/interceptor/StateContext.kt @@ -0,0 +1,34 @@ +package ksm.state.parameters.interceptor + +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.plugin.plugin +import ksm.state.parameters.plugin.StateParametersPlugin +import ksm.typed.TypedValue + +@MutateContext +public fun StateContext.addParametersInterceptor( + onPut: (key: String, value: TypedValue<*>) -> Unit = { _, _ -> }, + onReceive: (String) -> TypedValue.Generic<*>? = { null } +) { + val interceptor = object : StateParametersInterceptor { + override fun onPut(key: String, value: TypedValue<*>) { + onPut(key, value) + } + override fun onReceive(key: String): TypedValue.Generic? { + @Suppress("UNCHECKED_CAST") + return onReceive(key) as TypedValue.Generic? + } + } + addParametersInterceptor(interceptor) +} + +@MutateContext +public fun StateContext.addParametersInterceptor( + interceptor: StateParametersInterceptor +) { + plugin(StateParametersPlugin).addParametersInterceptor( + context = this, + interceptor = interceptor + ) +} diff --git a/core/src/commonMain/kotlin/ksm/state/parameters/interceptor/StateParametersInterceptor.kt b/core/src/commonMain/kotlin/ksm/state/parameters/interceptor/StateParametersInterceptor.kt new file mode 100644 index 0000000..d5df1e9 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/parameters/interceptor/StateParametersInterceptor.kt @@ -0,0 +1,8 @@ +package ksm.state.parameters.interceptor + +import ksm.typed.TypedValue + +public interface StateParametersInterceptor { + public fun onPut(key: String, value: TypedValue<*>) {} + public fun onReceive(key: String): TypedValue.Generic? = null +} diff --git a/core/src/commonMain/kotlin/ksm/state/parameters/interceptor/memory/MemoryStateParametersInterceptor.kt b/core/src/commonMain/kotlin/ksm/state/parameters/interceptor/memory/MemoryStateParametersInterceptor.kt new file mode 100644 index 0000000..0936ec5 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/parameters/interceptor/memory/MemoryStateParametersInterceptor.kt @@ -0,0 +1,17 @@ +package ksm.state.parameters.interceptor.memory + +import ksm.state.parameters.interceptor.StateParametersInterceptor +import ksm.typed.TypedValue + +internal class MemoryStateParametersInterceptor : StateParametersInterceptor { + private val map = mutableMapOf>() + + override fun onPut(key: String, value: TypedValue<*>) { + map[key] = TypedValue.Generic.of(value) + } + + @Suppress("UNCHECKED_CAST") + override fun onReceive(key: String): TypedValue.Generic? { + return map[key] as TypedValue.Generic? + } +} diff --git a/core/src/commonMain/kotlin/ksm/state/parameters/plugin/StateParametersEntry.kt b/core/src/commonMain/kotlin/ksm/state/parameters/plugin/StateParametersEntry.kt new file mode 100644 index 0000000..17be924 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/parameters/plugin/StateParametersEntry.kt @@ -0,0 +1,34 @@ +package ksm.state.parameters.plugin + +import ksm.context.StateContext +import ksm.state.parameters.interceptor.StateParametersInterceptor +import ksm.typed.TypedValue + +internal class StateParametersEntry : StateContext.Element { + override val key = StateParametersEntry + + private val interceptors = mutableListOf() + + fun addInterceptor(interceptor: StateParametersInterceptor) { + interceptors += interceptor + } + + fun onPut( + key: String, + value: TypedValue<*> + ) { + for (interceptor in interceptors) { + interceptor.onPut(key, value) + } + } + + fun onReceive(key: String): TypedValue.Generic? { + for (interceptor in interceptors.asReversed()) { + val value = interceptor.onReceive(key) + if (value != null) return value + } + return null + } + + companion object : StateContext.Key +} diff --git a/core/src/commonMain/kotlin/ksm/state/parameters/plugin/StateParametersPlugin.kt b/core/src/commonMain/kotlin/ksm/state/parameters/plugin/StateParametersPlugin.kt new file mode 100644 index 0000000..d62d139 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/state/parameters/plugin/StateParametersPlugin.kt @@ -0,0 +1,52 @@ +package ksm.state.parameters.plugin + +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor +import ksm.context.configuration.interceptor.addConfigurationInterceptor +import ksm.plugin.Plugin +import ksm.state.parameters.interceptor.StateParametersInterceptor +import ksm.state.parameters.interceptor.memory.MemoryStateParametersInterceptor +import ksm.typed.TypedValue + +public object StateParametersPlugin : Plugin.Singleton { + + @MutateContext + override fun install( + context: StateContext + ): StateContext { + context.addConfigurationInterceptor(Configuration) + return context + } + + private object Configuration : ConfigurationInterceptor { + @MutateContext + override fun onConfigure(context: StateContext): StateContext { + val entry = StateParametersEntry() + entry.addInterceptor(MemoryStateParametersInterceptor()) + return context + entry + } + } + + public fun put( + context: StateContext, + key: String, + value: TypedValue + ) { + context.require(StateParametersEntry).onPut(key, value) + } + + public fun receive( + context: StateContext, + key: String + ): TypedValue.Generic? { + return context.require(StateParametersEntry).onReceive(key) + } + + public fun addParametersInterceptor( + context: StateContext, + interceptor: StateParametersInterceptor + ) { + context.require(StateParametersEntry).addInterceptor(interceptor) + } +} diff --git a/core/src/commonMain/kotlin/ksm/typed/TypedValue.kt b/core/src/commonMain/kotlin/ksm/typed/TypedValue.kt new file mode 100644 index 0000000..151b7b2 --- /dev/null +++ b/core/src/commonMain/kotlin/ksm/typed/TypedValue.kt @@ -0,0 +1,32 @@ +package ksm.typed + +import kotlin.reflect.KType +import kotlin.reflect.typeOf + +public class TypedValue( + public val data: T, + public val type: KType +) { + public fun interface Generic { + public fun get(type: KType): T + + public companion object { + public inline fun of(value: T): Generic { + return of(TypedValue.of(value)) + } + + public fun of(value: TypedValue): Generic { + return Generic { type -> + require(type == value.type) + value.data + } + } + } + } + + public companion object { + public inline fun of(value: T): TypedValue { + return TypedValue(value, typeOf()) + } + } +} diff --git a/core/src/commonTest/kotlin/Test.kt b/core/src/commonTest/kotlin/Test.kt new file mode 100644 index 0000000..ef7ebfd --- /dev/null +++ b/core/src/commonTest/kotlin/Test.kt @@ -0,0 +1,46 @@ +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor +import ksm.context.configuration.interceptor.addConfigurationInterceptor +import ksm.createRawStateController +import ksm.lifecycle.LifecycleInterceptor +import ksm.lifecycle.addLifecycleInterceptor +import ksm.plugin.Plugin +import ksm.state.launch +import ksm.state.name.stateName +import kotlin.test.Test + +class KsmTest { + + @Test + fun ksmTest() { + val controller = createRawStateController { + install(PrintPlugin) + } + controller.launch("Start") + } +} + +object PrintPlugin : Plugin.Singleton { + + @MutateContext + override fun install(context: StateContext): StateContext { + context.addConfigurationInterceptor(Configuration) + return context + } + + private object Configuration : ConfigurationInterceptor { + @MutateContext + override fun onConfigure(context: StateContext): StateContext { + context.addLifecycleInterceptor(Lifecycle) + return context + } + } + + private object Lifecycle : LifecycleInterceptor { + + override fun onCreate(context: StateContext) { + println("Hello, current state = ${context.stateName}") + } + } +} diff --git a/docs/EXPOSING_API.md b/docs/EXPOSING_API.md new file mode 100644 index 0000000..5a47e87 --- /dev/null +++ b/docs/EXPOSING_API.md @@ -0,0 +1,42 @@ +# Exposing Plugin API + +Class or object implementing `Plugin` interface must have all public methods +required to interact with the feature. A good example of such plugin is +`CoroutinesPlugin`: + +```kotlin +object CoroutinesPlugin : Plugin { + override fun install(context: StateContext): StateContext { ... } + + fun coroutineContext(context: StateContext): CoroutineContext { + return context.require(CoroutineContextKey).coroutineContext + } +} +``` + +All the keys of the plugin should be internal or even private, you should not share +keys directly but rather provide convenient extensions on top of StateContext. + +Continuing with `CoroutinesPlugin`, the extension to get coroutineContext looks like +this: + +```kotlin +val StateContext.coroutineContext: CoroutineContext get() { + return plugin(CoroutinesPlugin).coroutineContext(context = this) +} +``` + +Here you can see why you should not share Key: + +If there is no plugin +installed the Key will be absent and any operation will fail saying +'Cannot find element with key $key'. And the name of the key can +be literally anything and user of the plugin probably knows +no more than the plugin name. + +When you get plugin using `plugin` function, it first checks if the +plugin itself is installed. And if it isn't, it throws an exception +saying 'Plugin $name is not installed' which is ultimately more clear. + +Additionally, that way we know that when 'Cannot find element with key $key' +exception in thrown, it's due to the bug in the plugin and not user's fault. diff --git a/docs/PHASES.md b/docs/PHASES.md new file mode 100644 index 0000000..30ba752 --- /dev/null +++ b/docs/PHASES.md @@ -0,0 +1,198 @@ +# Phases + +KSM is based on different callbacks and interceptors and therefore, +there are some phases you should be aware about. + +Note: There is no `Phase` in the library as an interface or something +similar, it's just a good mental model. + +## Visual Scheme + +```mermaid +stateDiagram-v2 + [*] --> StateController + StateController --> Plugins + Plugins: Apply Plugins + state Plugins { + [*] --> install + install: // Installing interceptors
Plugin.install(context#58; StateContext)#58; StateContext + install --> [*] + } + Plugins --> RootStateController + RootStateController: Root StateController is configured + RootStateController --> ChildStateContext + ChildStateContext: Create Child State + state ChildStateContext { + [*] --> onConfigure + onConfigure: onConfigure + onConfigure --> onConfigureDescription + onConfigureDescription: // Registering entries
StateContextInterceptor.onConfigure(context)#58; Context + onConfigureDescription --> fillEntries + fillEntries: Entries set up#59; usually done by extension functions + fillEntries --> onCreate + onCreate --> onCreateDescription + onCreateDescription: // Plugins can handle filled data
StateContextInterceptor.onCreate(childContext) + onCreateDescription --> onResume + onResume --> onResumeDescription + onResumeDescription: // Invoked right after onCreate or after child finish
StateContextInterceptor.onResume(childContext) + onResumeDescription --> stateLives + stateLives: -- Child state lives -- + stateLives --> onFinish + onFinish --> onFinishDescription + onFinish --> onResume + onFinishDescription: // Invoked after StateContext.finish() invoked
StateContextInterceptor.onFinish(childContext) + onFinishDescription --> [*] + } + ChildStateContext --> [*] +``` + +## Plugin Installation + +First phase is a plugin installation. This is where a life of the +root `StateController` begins. This is where all plugins install +their interceptors and store configuration: + +```kotlin +class CoroutinesPlugin( + // Configuration is just plugin properties + val context: CoroutineContext +) : Plugin { + + override fun install(context: StateContext) { + return context + StateContextInterceptor(context) + } +} +``` + +Plugins can be installed using `createRawStateController` function. +It is called 'Raw' because there is no plugins except builtins and +the end user probably should not use this function. The function +is used by creators of libraries that integrates ksm into some ecosystems. +For example: + +```kotlin +fun createTelegramKSM(): StateController { + return createRawStateController { + install(TelegramKSM) + } +} +``` + +### Restrictions + +- **Do not read properties from `context`, only write them** + + Current context is incomplete and will be modified at + later point of time by another plugins, so you should + not save it or read any properties from it + +## State Phases + +The following phases relate to creation of child states, and they +are being invoked at `StateContext.createChildContext`. And +all the following methods are methods of `StateContextInterceptor` + +### onConfigure + +When creating a new `StateContext`, the first method that is being +invoked is `onConfigure`. Let's look at the signature: + +```kotlin +fun onConfigure(context: StateContext): StateContext +``` + +It takes context and returns context and this is the place where +you can register entries scoped to child context. Continuing with +the example with coroutines: + +```kotlin +class CoroutinesContextInterceptor( + val initialContext: CoroutineContext +) : StateContextInterceptor { + override fun onConfigure(context: StateContext): StateContext { + val previousEntry = context[CoroutinesEntry] + // Support for structured concurrency + return context + CoroutinesEntry(previousEntry) + } +} +``` + +#### Restrictions + +- **Do not set any interceptors** + + There is a chance that interceptor that you try to set was already + invoked earlier by another plugin and if you set interceptor at that phase, + it will lead to inconsistent behaviour in different cases + + +- **Do not read from context except for entries under plugin control** + + Even though it is guaranteed that interceptors of plugins are called in + the order that plugins were registered, it's you should not access other + plugins in `onConfigure` method. _This is to be discussed, but there is + no seemed reason for this to be allowed._ + +### onCreate + +Continuing with `StateContext.createChildContext`: + +```kotlin +fun StateContext.createChildContext(apply: (StateContext) -> Unit) { + // All plugins register their entries + val childContext = this.onConfigure(applied) + // This is where all the setup of entries happens + apply(childContext) + childContext.onCreate() +} +``` + +As we can clearly see from the current code snippet, onCreate is called +when all context entries were set up. What does set up mean? Let's consider +the following simplified example: + +We have `NavigationPlugin`, which registers `NavigationEntry` in +`NavigationInterceptor` in `onConfigure` method, similarly to the +previous example: + +```kotlin +class NavigationInterceptor { + override fun onConfigure(context: StateContext): StateContext { + return context + NavigationEntry() + } +} +``` + +And the `NavigationEntry` itself looks like this: + +```kotlin +class NavigationEntry { + var route: String? = null +} +``` + +It is expected that `route` will be set in `apply` lambda of +`createChildContext` function. And `onCreate` is a perfect place to receive it: + +```kotlin +class NavigationInterceptor( + private val controller: NavController +) { + override fun onConfigure(context: StateContext): StateContext { + return context + NavigationEntry() + } + + override fun onCreate(context: StateContext) { + val entry = context.require(NavigationEntry) + val route = entry.route ?: return + controller.navigate(route) + } +} +``` + +### Other Lifecycle Events + +Also, there are other lifecycle events: + +- `StateContextInterceptor.onResume` – when context after this was finished +- `StateContextInterceptor.onFinish` – when context was finished diff --git a/docs/STRUCTURED_NAVIGATION.md b/docs/STRUCTURED_NAVIGATION.md new file mode 100644 index 0000000..ef02718 --- /dev/null +++ b/docs/STRUCTURED_NAVIGATION.md @@ -0,0 +1,8 @@ +# Structured Navigation + +Structured navigation is like a structured concurrency when +entries can have children and their children can have children. +Finishing one entry will cause its child to finish. And +starting new child from entry also finishes its previous child. + + diff --git a/gradle.properties b/gradle.properties new file mode 100644 index 0000000..2d8d1e4 --- /dev/null +++ b/gradle.properties @@ -0,0 +1 @@ +android.useAndroidX=true \ No newline at end of file diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml new file mode 100644 index 0000000..b004aa0 --- /dev/null +++ b/gradle/libs.versions.toml @@ -0,0 +1,35 @@ +[versions] + +kotlin = "1.9.23" +kotlinx-coroutines = "1.8.0" +kotlinx-serialization = "1.6.3" +android-gradle = "7.3.1" +compose-runtime = "1.6.5" +compose-compiler = "1.5.11" +androidx-navigation = "2.7.7" +androidx-lifecycle = "2.7.0" +ktgbotapi = "11.0.0" +mdi = "0.0.37" + +ksm = "0.0.3" + +[libraries] + +kotlinx-coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "kotlinx-coroutines" } +kotlinx-serialization = { module = "org.jetbrains.kotlinx:kotlinx-serialization-json", version.ref = "kotlinx-serialization" } + +compose-foundation = { module = "androidx.compose.foundation:foundation", version.ref = "compose-runtime" } +compose-runtime = { module = "androidx.compose.runtime:runtime", version.ref = "compose-runtime" } +compose-runtime-saveable = { module = "androidx.compose.runtime:runtime-saveable", version.ref = "compose-runtime" } +androidx-navigation-ui = { module = "androidx.navigation:navigation-ui-ktx", version.ref = "androidx-navigation" } +androidx-navigation-compose = { module = "androidx.navigation:navigation-compose", version.ref = "androidx-navigation" } +androidx-lifecycle = { module = "androidx.lifecycle:lifecycle-viewmodel-compose", version.ref = "androidx-lifecycle" } + +ktgbotapi = { module = "dev.inmo:tgbotapi", version.ref = "ktgbotapi" } + +mdi = { module = "app.meetacy.di:core", version.ref = "mdi" } + +# gradle plugins +kotlin-gradle-plugin = { module = "org.jetbrains.kotlin:kotlin-gradle-plugin", version.ref = "kotlin" } +kotlinx-serialization-gradle-plugin = { module = "org.jetbrains.kotlin:kotlin-serialization", version.ref = "kotlin" } +android-gradle-plugin = { module = "com.android.tools.build:gradle", version.ref = "android-gradle" } diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..c1962a79e29d3e0ab67b14947c167a862655af9b GIT binary patch literal 62076 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 literal 0 HcmV?d00001 diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..37aef8d --- /dev/null +++ b/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,6 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-8.1.1-bin.zip +networkTimeout=10000 +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists diff --git a/gradlew b/gradlew new file mode 100755 index 0000000..aeb74cb --- /dev/null +++ b/gradlew @@ -0,0 +1,245 @@ +#!/bin/sh + +# +# Copyright © 2015-2021 the original authors. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# + +############################################################################## +# +# Gradle start up script for POSIX generated by Gradle. +# +# Important for running: +# +# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is +# noncompliant, but you have some other compliant shell such as ksh or +# bash, then to run this script, type that shell name before the whole +# command line, like: +# +# ksh Gradle +# +# Busybox and similar reduced shells will NOT work, because this script +# requires all of these POSIX shell features: +# * functions; +# * expansions «$var», «${var}», «${var:-default}», «${var+SET}», +# «${var#prefix}», «${var%suffix}», and «$( cmd )»; +# * compound commands having a testable exit status, especially «case»; +# * various built-in commands including «command», «set», and «ulimit». +# +# Important for patching: +# +# (2) This script targets any POSIX shell, so it avoids extensions provided +# by Bash, Ksh, etc; in particular arrays are avoided. +# +# The "traditional" practice of packing multiple parameters into a +# space-separated string is a well documented source of bugs and security +# problems, so this is (mostly) avoided, by progressively accumulating +# options in "$@", and eventually passing that to Java. +# +# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS, +# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly; +# see the in-line comments for details. +# +# There are tweaks for specific operating systems such as AIX, CygWin, +# Darwin, MinGW, and NonStop. +# +# (3) This script is generated from the Groovy template +# https://github.com/gradle/gradle/blob/HEAD/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt +# within the Gradle project. +# +# You can find Gradle at https://github.com/gradle/gradle/. +# +############################################################################## + +# Attempt to set APP_HOME + +# Resolve links: $0 may be a link +app_path=$0 + +# Need this for daisy-chained symlinks. +while + APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path + [ -h "$app_path" ] +do + ls=$( ls -ld "$app_path" ) + link=${ls#*' -> '} + case $link in #( + /*) app_path=$link ;; #( + *) app_path=$APP_HOME$link ;; + esac +done + +# This is normally unused +# shellcheck disable=SC2034 +APP_BASE_NAME=${0##*/} +APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC3045 + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC3045 + ulimit -n "$MAX_FD" || + warn "Could not set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, stacking in reverse order: +# * args from the command line +# * the main class name +# * -classpath +# * -D...appname settings +# * --module-path (only if needed) +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables. + +# For Cygwin or MSYS, switch paths to Windows format before running java +if "$cygwin" || "$msys" ; then + APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) + CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" ) + + JAVACMD=$( cygpath --unix "$JAVACMD" ) + + # Now convert the arguments - kludge to limit ourselves to /bin/sh + for arg do + if + case $arg in #( + -*) false ;; # don't mess with options #( + /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath + [ -e "$t" ] ;; #( + *) false ;; + esac + then + arg=$( cygpath --path --ignore --mixed "$arg" ) + fi + # Roll the args list around exactly as many times as the number of + # args, so each arg winds up back in the position where it started, but + # possibly modified. + # + # NB: a `for` loop captures its iteration list before it begins, so + # changing the positional parameters here affects neither the number of + # iterations, nor the values presented in `arg`. + shift # remove old arg + set -- "$@" "$arg" # push replacement arg + done +fi + + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' + +# Collect all arguments for the java command; +# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of +# shell script including quotes and variable substitutions, so put them in +# double quotes to make sure that they get re-expanded; and +# * put everything else in single quotes, so that it's not re-expanded. + +set -- \ + "-Dorg.gradle.appname=$APP_BASE_NAME" \ + -classpath "$CLASSPATH" \ + org.gradle.wrapper.GradleWrapperMain \ + "$@" + +# Stop when "xargs" is not available. +if ! command -v xargs >/dev/null 2>&1 +then + die "xargs is not available" +fi + +# Use "xargs" to parse quoted args. +# +# With -n1 it outputs one arg per line, with the quotes and backslashes removed. +# +# In Bash we could simply go: +# +# readarray ARGS < <( xargs -n1 <<<"$var" ) && +# set -- "${ARGS[@]}" "$@" +# +# but POSIX shell has neither arrays nor command substitution, so instead we +# post-process each arg (as a line of input to sed) to backslash-escape any +# character that might be a shell metacharacter, then use eval to reverse +# that process (while maintaining the separation between arguments), and wrap +# the whole thing up as a single "set" statement. +# +# This will of course break if any of these variables contains a newline or +# an unmatched quote. +# + +eval "set -- $( + printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" | + xargs -n1 | + sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' | + tr '\n' ' ' + )" '"$@"' + +exec "$JAVACMD" "$@" diff --git a/gradlew.bat b/gradlew.bat new file mode 100644 index 0000000..93e3f59 --- /dev/null +++ b/gradlew.bat @@ -0,0 +1,92 @@ +@rem +@rem Copyright 2015 the original author or authors. +@rem +@rem Licensed under the Apache License, Version 2.0 (the "License"); +@rem you may not use this file except in compliance with the License. +@rem You may obtain a copy of the License at +@rem +@rem https://www.apache.org/licenses/LICENSE-2.0 +@rem +@rem Unless required by applicable law or agreed to in writing, software +@rem distributed under the License is distributed on an "AS IS" BASIS, +@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +@rem See the License for the specific language governing permissions and +@rem limitations under the License. +@rem + +@if "%DEBUG%"=="" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%"=="" set DIRNAME=. +@rem This is normally unused +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if %ERRORLEVEL% equ 0 goto execute + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* + +:end +@rem End local scope for the variables with windows NT shell +if %ERRORLEVEL% equ 0 goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +set EXIT_CODE=%ERRORLEVEL% +if %EXIT_CODE% equ 0 set EXIT_CODE=1 +if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE% +exit /b %EXIT_CODE% + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/kotlinx-coroutines/build.gradle.kts b/kotlinx-coroutines/build.gradle.kts new file mode 100644 index 0000000..dc0fcb7 --- /dev/null +++ b/kotlinx-coroutines/build.gradle.kts @@ -0,0 +1,10 @@ +plugins { + id("kmp-library-convention") +} + +version = libs.versions.ksm.get() + +dependencies { + commonMainApi(projects.core) + commonMainImplementation(libs.kotlinx.coroutines.core) +} diff --git a/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/StateContext.kt b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/StateContext.kt new file mode 100644 index 0000000..1c98f98 --- /dev/null +++ b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/StateContext.kt @@ -0,0 +1,29 @@ +package ksm.coroutines + +import kotlinx.coroutines.CoroutineScope +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.coroutines.interceptor.AwaitInterceptor +import ksm.coroutines.plugin.AwaitPlugin +import ksm.coroutines.plugin.CoroutinesPlugin +import ksm.plugin.plugin +import kotlin.coroutines.CoroutineContext + +public val StateContext.coroutineScope: CoroutineScope get() { + return CoroutineScope(coroutineContext) +} + +public val StateContext.coroutineContext: CoroutineContext get() { + return plugin(CoroutinesPlugin).coroutineContext(context = this) +} + +public fun StateContext.addAwaitInterceptor(interceptor: AwaitInterceptor) { + plugin(AwaitPlugin).addAwaitInterceptor( + context = this, + interceptor = interceptor + ) +} + +public suspend fun StateContext.await() { + plugin(AwaitPlugin).await(context = this) +} diff --git a/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/StateController.kt b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/StateController.kt new file mode 100644 index 0000000..37718f5 --- /dev/null +++ b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/StateController.kt @@ -0,0 +1,7 @@ +package ksm.coroutines + +import kotlinx.coroutines.CoroutineScope +import ksm.StateController + +public val StateController.coroutineScope: CoroutineScope + get() = context.coroutineScope diff --git a/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/interceptor/AwaitInterceptor.kt b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/interceptor/AwaitInterceptor.kt new file mode 100644 index 0000000..0dccd69 --- /dev/null +++ b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/interceptor/AwaitInterceptor.kt @@ -0,0 +1,5 @@ +package ksm.coroutines.interceptor + +public fun interface AwaitInterceptor { + public suspend fun await() +} diff --git a/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/AwaitEntry.kt b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/AwaitEntry.kt new file mode 100644 index 0000000..51dcc03 --- /dev/null +++ b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/AwaitEntry.kt @@ -0,0 +1,22 @@ +package ksm.coroutines.plugin + +import ksm.context.StateContext +import ksm.coroutines.interceptor.AwaitInterceptor + +internal class AwaitEntry : StateContext.Element { + override val key = AwaitEntry + + private val awaitInterceptors = mutableListOf() + + suspend fun await() { + for (interceptor in awaitInterceptors) { + interceptor.await() + } + } + + fun addAwaitInterceptor(interceptor: AwaitInterceptor) { + awaitInterceptors += interceptor + } + + companion object : StateContext.Key +} diff --git a/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/AwaitPlugin.kt b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/AwaitPlugin.kt new file mode 100644 index 0000000..ebf7781 --- /dev/null +++ b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/AwaitPlugin.kt @@ -0,0 +1,35 @@ +package ksm.coroutines.plugin + +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor +import ksm.context.configuration.interceptor.addConfigurationInterceptor +import ksm.coroutines.interceptor.AwaitInterceptor +import ksm.plugin.Plugin + +public object AwaitPlugin : Plugin.Singleton { + + @MutateContext + override fun install(context: StateContext): StateContext { + context.addConfigurationInterceptor(Configuration) + return context + } + + private object Configuration : ConfigurationInterceptor { + @MutateContext + override fun onConfigure(context: StateContext): StateContext { + return context + AwaitEntry() + } + } + + public suspend fun await(context: StateContext) { + context.require(AwaitEntry).await() + } + + public fun addAwaitInterceptor( + context: StateContext, + interceptor: AwaitInterceptor + ) { + context.require(AwaitEntry).addAwaitInterceptor(interceptor) + } +} diff --git a/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/CoroutinesEntry.kt b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/CoroutinesEntry.kt new file mode 100644 index 0000000..a1927d3 --- /dev/null +++ b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/CoroutinesEntry.kt @@ -0,0 +1,33 @@ +package ksm.coroutines.plugin + +import kotlinx.coroutines.CoroutineScope +import kotlinx.coroutines.Job +import kotlinx.coroutines.cancel +import kotlinx.coroutines.newCoroutineContext +import ksm.context.StateContext +import ksm.coroutines.interceptor.AwaitInterceptor +import kotlin.coroutines.CoroutineContext + +internal class CoroutinesEntry( + context: StateContext, + initialCoroutineContext: CoroutineContext +) : StateContext.Element { + override val key = CoroutinesEntry + + val coroutineContext: CoroutineContext + + init { + val parentCoroutineContext = context[CoroutinesEntry] + ?.coroutineContext + ?: initialCoroutineContext + + val parentJob = parentCoroutineContext[Job] + val job = Job(parentJob) + + coroutineContext = CoroutineScope(parentCoroutineContext).newCoroutineContext(job) + } + + fun cancel() = coroutineContext.cancel() + + companion object : StateContext.Key +} diff --git a/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/CoroutinesPlugin.kt b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/CoroutinesPlugin.kt new file mode 100644 index 0000000..961b4d6 --- /dev/null +++ b/kotlinx-coroutines/src/commonMain/kotlin/ksm/coroutines/plugin/CoroutinesPlugin.kt @@ -0,0 +1,43 @@ +package ksm.coroutines.plugin + +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor +import ksm.plugin.Plugin +import ksm.context.configuration.interceptor.addConfigurationInterceptor +import ksm.coroutines.interceptor.AwaitInterceptor +import ksm.lifecycle.LifecycleInterceptor +import ksm.lifecycle.addLifecycleInterceptor +import kotlin.coroutines.CoroutineContext +import kotlin.coroutines.EmptyCoroutineContext + +public class CoroutinesPlugin( + private val coroutineContext: CoroutineContext +) : Plugin { + override val key: Companion = CoroutinesPlugin + + @MutateContext + override fun install(context: StateContext): StateContext { + context.addConfigurationInterceptor(Configuration()) + return context + } + + private inner class Configuration : ConfigurationInterceptor { + @MutateContext + override fun onConfigure(context: StateContext): StateContext { + val entry = CoroutinesEntry(context, coroutineContext) + context.addLifecycleInterceptor(Lifecycle(entry)) + return context + entry + } + } + + private inner class Lifecycle(val entry: CoroutinesEntry) : LifecycleInterceptor { + override fun onFinish(context: StateContext) { entry.cancel() } + } + + public fun coroutineContext(context: StateContext): CoroutineContext { + return context.require(CoroutinesEntry).coroutineContext + } + + public companion object : StateContext.Key, Plugin by CoroutinesPlugin(EmptyCoroutineContext) +} diff --git a/kotlinx-serialization-json/build.gradle.kts b/kotlinx-serialization-json/build.gradle.kts new file mode 100644 index 0000000..98b6457 --- /dev/null +++ b/kotlinx-serialization-json/build.gradle.kts @@ -0,0 +1,11 @@ +plugins { + id("kmp-library-convention") + kotlin("plugin.serialization") +} + +version = libs.versions.ksm.get() + +dependencies { + commonMainApi(projects.core) + commonMainImplementation(libs.kotlinx.serialization) +} diff --git a/kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/KotlinxSerializationFormat.kt b/kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/KotlinxSerializationFormat.kt new file mode 100644 index 0000000..8c2a43a --- /dev/null +++ b/kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/KotlinxSerializationFormat.kt @@ -0,0 +1,35 @@ +package ksm.kotlinx.serialization.plugin + +import kotlinx.serialization.json.Json +import kotlinx.serialization.modules.SerializersModule +import kotlinx.serialization.serializer +import ksm.kotlinx.serialization.plugin.serializer.GenericValueDeserializer +import ksm.kotlinx.serialization.plugin.serializer.TypedValueSerializer +import ksm.serialization.BaseSerializationFormat +import ksm.serialization.BaseSerializationStore +import ksm.typed.TypedValue +import kotlin.reflect.KType + +internal class KotlinxSerializationFormat( + private val store: BaseSerializationStore.String, + json: Json +) : BaseSerializationFormat { + private val json = Json(json) { + serializersModule = SerializersModule { + include(serializersModule) + contextual(TypedValue::class, TypedValueSerializer) + contextual(TypedValue.Generic::class, GenericValueDeserializer) + } + } + + override fun encode(value: TypedValue<*>) { + val serializer = json.serializersModule.serializer(value.type) + store.apply(json.encodeToString(serializer, value)) + } + + override fun decode(type: KType): Any? { + val string = store.get() ?: return null + val deserializer = json.serializersModule.serializer(type) + return json.decodeFromString(deserializer, string) + } +} diff --git a/kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/KotlinxSerializationPlugin.kt b/kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/KotlinxSerializationPlugin.kt new file mode 100644 index 0000000..a4eaf61 --- /dev/null +++ b/kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/KotlinxSerializationPlugin.kt @@ -0,0 +1,28 @@ +package ksm.kotlinx.serialization.plugin + +import kotlinx.serialization.json.Json +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.install +import ksm.plugin.Plugin +import ksm.serialization.BaseSerializationStore +import ksm.serialization.plugin.BaseSerializationPlugin + +public class KotlinxSerializationPlugin( + private val json: Json = Json, + private val store: BaseSerializationStore.String? = null +) : Plugin { + override val key: Companion = KotlinxSerializationPlugin + + @MutateContext + override fun install(context: StateContext): StateContext { + val store = this.store + ?: context[BaseSerializationStore.String] + ?: error("Please either provide BaseSerializationStore using constructor or install the plugin that will provide it") + val format = KotlinxSerializationFormat(store, json) + val basePlugin = BaseSerializationPlugin(format) + return context.install(basePlugin) + } + + public companion object : StateContext.Key +} diff --git a/kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/serializer/GenericValueDeserializer.kt b/kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/serializer/GenericValueDeserializer.kt new file mode 100644 index 0000000..fdf664d --- /dev/null +++ b/kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/serializer/GenericValueDeserializer.kt @@ -0,0 +1,32 @@ +package ksm.kotlinx.serialization.plugin.serializer + +import kotlinx.serialization.ExperimentalSerializationApi +import kotlinx.serialization.KSerializer +import kotlinx.serialization.descriptors.SerialDescriptor +import kotlinx.serialization.encoding.Decoder +import kotlinx.serialization.encoding.Encoder +import kotlinx.serialization.json.JsonElement +import kotlinx.serialization.serializer +import ksm.typed.TypedValue + +public object GenericValueDeserializer : KSerializer> { + @OptIn(ExperimentalSerializationApi::class) + override val descriptor: SerialDescriptor = SerialDescriptor( + serialName = "TypedValueSerializer", + original = JsonElement.serializer().descriptor + ) + + override fun serialize( + encoder: Encoder, + value: TypedValue.Generic<*> + ) { + error("TypedValue.Generic cannot be serialized, only deserialized") + } + + override fun deserialize(decoder: Decoder): TypedValue.Generic<*> { + return TypedValue.Generic { type -> + val deserializer = decoder.serializersModule.serializer(type) + deserializer.deserialize(decoder) + } + } +} diff --git a/kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/serializer/TypedValueSerializer.kt b/kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/serializer/TypedValueSerializer.kt new file mode 100644 index 0000000..42f3891 --- /dev/null +++ b/kotlinx-serialization-json/src/commonMain/kotlin/ksm/kotlinx/serialization/plugin/serializer/TypedValueSerializer.kt @@ -0,0 +1,31 @@ +package ksm.kotlinx.serialization.plugin.serializer + +import kotlinx.serialization.ExperimentalSerializationApi +import kotlinx.serialization.KSerializer +import kotlinx.serialization.SerializationStrategy +import kotlinx.serialization.descriptors.SerialDescriptor +import kotlinx.serialization.encoding.Decoder +import kotlinx.serialization.encoding.Encoder +import kotlinx.serialization.json.JsonElement +import kotlinx.serialization.serializer +import ksm.typed.TypedValue + +public object TypedValueSerializer : KSerializer> { + @OptIn(ExperimentalSerializationApi::class) + override val descriptor: SerialDescriptor = SerialDescriptor( + serialName = "TypedValueSerializer", + original = JsonElement.serializer().descriptor + ) + + override fun serialize( + encoder: Encoder, + value: TypedValue<*> + ) { + val baseSerializer = encoder.serializersModule.serializer(value.type) + baseSerializer.serialize(encoder, value.data) + } + + override fun deserialize(decoder: Decoder): TypedValue<*> { + error("This type cannot be deserialized, use TypedValue.Generic instead") + } +} diff --git a/ktgbotapi/build.gradle.kts b/ktgbotapi/build.gradle.kts new file mode 100644 index 0000000..81ff887 --- /dev/null +++ b/ktgbotapi/build.gradle.kts @@ -0,0 +1,27 @@ +plugins { + kotlin("multiplatform") + id("publication-convention") +} + +kotlin { + explicitApi() + + jvmToolchain(17) + + jvm() + + js(IR) { + browser() + nodejs() + } +} + +version = libs.versions.ksm.get() + +dependencies { + commonMainApi(projects.core) + commonMainApi(projects.kotlinxCoroutines) + commonMainApi(projects.kotlinxSerializationJson) + commonMainImplementation(libs.kotlinx.coroutines.core) + commonMainImplementation(libs.ktgbotapi) +} diff --git a/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/StateBuilderScope.kt b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/StateBuilderScope.kt new file mode 100644 index 0000000..565ea6f --- /dev/null +++ b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/StateBuilderScope.kt @@ -0,0 +1,8 @@ +package ksm.ktgbotapi + +import ksm.state.StateScope +import ksm.state.builder.StateBuilderScope + +public fun StateBuilderScope.execute(block: suspend StateScope.() -> Unit) { + context.setExecuteBlock(block) +} diff --git a/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/StateContext.kt b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/StateContext.kt new file mode 100644 index 0000000..7c2367f --- /dev/null +++ b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/StateContext.kt @@ -0,0 +1,38 @@ +package ksm.ktgbotapi + +import dev.inmo.tgbotapi.bot.TelegramBot +import dev.inmo.tgbotapi.types.message.abstracts.Message +import dev.inmo.tgbotapi.types.update.MessageUpdate +import dev.inmo.tgbotapi.types.update.abstracts.Update +import ksm.StateController +import ksm.context.StateContext +import ksm.ktgbotapi.plugin.TelegramBotApiPlugin +import ksm.plugin.plugin +import ksm.state.StateScope + +public val StateContext.update: Update get() { + return plugin(TelegramBotApiPlugin).update +} + +public val StateContext.messageUpdate: MessageUpdate get() { + return update as? MessageUpdate ?: error("Received update is not MessageUpdate") +} + +public val StateContext.message: Message get() { + return messageUpdate.data +} + +public val StateContext.telegramBot: TelegramBot get() { + return plugin(TelegramBotApiPlugin).telegramBot +} + +internal val StateContext.executeBlock: suspend StateScope.() -> Unit get() { + return plugin(TelegramBotApiPlugin).executeBlock(context = this) +} + +public fun StateContext.setExecuteBlock(block: suspend StateScope.() -> Unit) { + plugin(TelegramBotApiPlugin).setExecuteBlock( + context = this, + block = block + ) +} diff --git a/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/StateScope.kt b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/StateScope.kt new file mode 100644 index 0000000..0822519 --- /dev/null +++ b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/StateScope.kt @@ -0,0 +1,42 @@ +package ksm.ktgbotapi + +import dev.inmo.tgbotapi.bot.TelegramBot +import dev.inmo.tgbotapi.extensions.api.send.sendMessage +import dev.inmo.tgbotapi.extensions.utils.extensions.sourceChat +import dev.inmo.tgbotapi.extensions.utils.extensions.sourceUser +import dev.inmo.tgbotapi.types.IdChatIdentifier +import dev.inmo.tgbotapi.types.buttons.KeyboardMarkup +import dev.inmo.tgbotapi.types.chat.User +import dev.inmo.tgbotapi.types.update.abstracts.Update +import dev.inmo.tgbotapi.utils.PreviewFeature +import ksm.ktgbotapi.match.MatchScope +import ksm.state.StateScope + +public val StateScope.update: Update get() { + return controller.context.update +} + +@OptIn(PreviewFeature::class) +public val StateScope.user: User get() { + return update.sourceUser() ?: error("Cannot get user from $update") +} + +@OptIn(PreviewFeature::class) +public val StateScope.chatId: IdChatIdentifier get() { + return update.sourceChat()?.id ?: error("Cannot get chatId from $update") +} + +public val StateScope.telegramBot: TelegramBot get() { + return controller.context.telegramBot +} + +public suspend fun StateScope.sendMessage( + text: String, + replyMarkup: KeyboardMarkup? = null +) { + telegramBot.sendMessage(chatId, text, replyMarkup = replyMarkup) +} + +public inline fun StateScope.matchMessage(block: MatchScope.() -> Unit) { + MatchScope(controller.context).apply(block) +} diff --git a/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/TelegramBotKSM.kt b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/TelegramBotKSM.kt new file mode 100644 index 0000000..cc56382 --- /dev/null +++ b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/TelegramBotKSM.kt @@ -0,0 +1,56 @@ +package ksm.ktgbotapi + +import dev.inmo.tgbotapi.bot.TelegramBot +import dev.inmo.tgbotapi.types.update.abstracts.Update +import kotlinx.coroutines.flow.Flow +import ksm.StateController +import ksm.builder.StateControllerBuilder +import ksm.createRawStateController +import ksm.ktgbotapi.plugin.TelegramBotApiPlugin +import ksm.serialization.restore +import ksm.stack.lastContext +import ksm.stack.lastContextOrNull +import ksm.stack.nextContext +import ksm.stack.nextContextOrNull +import ksm.state.StateScope +import ksm.state.launch + +public class TelegramBotStateMachine( + private val builder: StateControllerBuilder.() -> Unit +) { + public suspend fun start( + startStateName: String, + telegramBot: TelegramBot, + updates: Flow, + key: (T) -> TelegramPeerKey + ) { + updates.collect { update -> + val controller = createStateController(key(update), update, telegramBot) + if (controller.context.lastContextOrNull == null) { + controller.launch(startStateName) + } + // todo: это дефолтный интерцептор, надо дать возможность + // добавлять свои интерцепторы на апдейты после восстановления состояния + // - + // Новых абстракций можно не придумывать, а в случае, когда необходимо блокировать + // выполнение цепочки, можно сделать декоратор + val lastContext = controller.context.lastContext + val lastController = StateController(lastContext) + val stateScope = StateScope(lastController) + lastContext.executeBlock.invoke(stateScope) + } + } + + private fun createStateController( + key: TelegramPeerKey, + update: Update, + telegramBot: TelegramBot + ): StateController { + return createRawStateController { + install(TelegramBotApiPlugin(key, update, telegramBot)) + builder() + }.apply { + context.restore() + } + } +} diff --git a/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/TelegramPeerKey.kt b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/TelegramPeerKey.kt new file mode 100644 index 0000000..21096db --- /dev/null +++ b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/TelegramPeerKey.kt @@ -0,0 +1,6 @@ +package ksm.ktgbotapi + +import kotlin.jvm.JvmInline + +@JvmInline +public value class TelegramPeerKey(public val string: String) diff --git a/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/match/Command.kt b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/match/Command.kt new file mode 100644 index 0000000..58baa07 --- /dev/null +++ b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/match/Command.kt @@ -0,0 +1,12 @@ +package ksm.ktgbotapi.match + +public fun MatchScope.command( + text: String, + args: Int? = null, + prefix: String = "/", + block: (List) -> Unit +) { + // todo: сделать реализацию, которая будет учитывать количество аргументов и т.п. + // возможно стоит тут задействовать интерцепторы и через них прокидывать дефолтное сообщение, + // когда команда неизвестна +} diff --git a/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/match/Exact.kt b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/match/Exact.kt new file mode 100644 index 0000000..9c81eb5 --- /dev/null +++ b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/match/Exact.kt @@ -0,0 +1,13 @@ +package ksm.ktgbotapi.match + +import dev.inmo.tgbotapi.extensions.utils.extensions.raw.text +import dev.inmo.tgbotapi.utils.RiskFeature +import ksm.ktgbotapi.message + +@OptIn(RiskFeature::class) +public inline fun MatchScope.exact( + text: String, + block: () -> Unit +) { + if (context.message.text == text) block() +} diff --git a/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/match/MatchScope.kt b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/match/MatchScope.kt new file mode 100644 index 0000000..b5fa8fa --- /dev/null +++ b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/match/MatchScope.kt @@ -0,0 +1,24 @@ +package ksm.ktgbotapi.match + +import ksm.context.StateContext + +public class MatchScope( + public val context: StateContext +) { + private var default: () -> Unit = { } + + public fun default(block: () -> Unit) { + default = block + } + + private var intercepted: Boolean = false + + public fun intercept() { + require(!intercepted) + intercepted = true + } + + public fun runDefault() { + if (!intercepted) default() + } +} diff --git a/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/plugin/TelegramBotApiPlugin.kt b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/plugin/TelegramBotApiPlugin.kt new file mode 100644 index 0000000..cef2631 --- /dev/null +++ b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/plugin/TelegramBotApiPlugin.kt @@ -0,0 +1,46 @@ +package ksm.ktgbotapi.plugin + +import dev.inmo.tgbotapi.bot.TelegramBot +import dev.inmo.tgbotapi.types.update.abstracts.Update +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor +import ksm.context.configuration.interceptor.addConfigurationInterceptor +import ksm.ktgbotapi.TelegramPeerKey +import ksm.plugin.Plugin +import ksm.state.StateScope + +public class TelegramBotApiPlugin( + public val peerKey: TelegramPeerKey, + public val update: Update, + public val telegramBot: TelegramBot +) : Plugin { + override val key: Companion = TelegramBotApiPlugin + + @MutateContext + override fun install(context: StateContext): StateContext { + context.addConfigurationInterceptor(Configuration) + return context + } + + private object Configuration : ConfigurationInterceptor { + @MutateContext + override fun onConfigure(context: StateContext): StateContext { + return context + TelegramBotEntry() + } + } + + public fun setExecuteBlock( + context: StateContext, + block: suspend StateScope.() -> Unit + ) { + context.require(TelegramBotEntry).execute = block + } + + public fun executeBlock(context: StateContext): suspend StateScope.() -> Unit { + return context.require(TelegramBotEntry).execute + ?: error("Please invoke `execute` in StateBuilder") + } + + public companion object : StateContext.Key +} diff --git a/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/plugin/TelegramBotEntry.kt b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/plugin/TelegramBotEntry.kt new file mode 100644 index 0000000..97032a7 --- /dev/null +++ b/ktgbotapi/src/commonMain/kotlin/ksm/ktgbotapi/plugin/TelegramBotEntry.kt @@ -0,0 +1,12 @@ +package ksm.ktgbotapi.plugin + +import ksm.context.StateContext +import ksm.state.StateScope + +internal class TelegramBotEntry : StateContext.Element { + override val key = TelegramBotEntry + + var execute: (suspend StateScope.() -> Unit)? = null + + companion object : StateContext.Key +} diff --git a/mdi/build.gradle.kts b/mdi/build.gradle.kts new file mode 100644 index 0000000..a712582 --- /dev/null +++ b/mdi/build.gradle.kts @@ -0,0 +1,10 @@ +plugins { + id("kmp-library-convention") +} + +version = libs.versions.ksm.get() + +dependencies { + commonMainApi(projects.core) + commonMainImplementation(libs.mdi) +} diff --git a/mdi/src/commonMain/kotlin/ksm/mdi/StateBuilderScope.kt b/mdi/src/commonMain/kotlin/ksm/mdi/StateBuilderScope.kt new file mode 100644 index 0000000..f4ae7f0 --- /dev/null +++ b/mdi/src/commonMain/kotlin/ksm/mdi/StateBuilderScope.kt @@ -0,0 +1,8 @@ +package ksm.mdi + +import app.meetacy.di.DI +import ksm.state.builder.StateBuilderScope + +public var StateBuilderScope.di: DI + get() = context.di + set(value) { context.di = value } diff --git a/mdi/src/commonMain/kotlin/ksm/mdi/StateContext.kt b/mdi/src/commonMain/kotlin/ksm/mdi/StateContext.kt new file mode 100644 index 0000000..85f90d3 --- /dev/null +++ b/mdi/src/commonMain/kotlin/ksm/mdi/StateContext.kt @@ -0,0 +1,10 @@ +package ksm.mdi + +import app.meetacy.di.DI +import ksm.mdi.plugin.DIPlugin +import ksm.context.StateContext +import ksm.plugin.plugin + +public var StateContext.di: DI + get() = plugin(DIPlugin).di(context = this) + set(value) = plugin(DIPlugin).setDI(context = this, di = value) diff --git a/mdi/src/commonMain/kotlin/ksm/mdi/StateController.kt b/mdi/src/commonMain/kotlin/ksm/mdi/StateController.kt new file mode 100644 index 0000000..ee15871 --- /dev/null +++ b/mdi/src/commonMain/kotlin/ksm/mdi/StateController.kt @@ -0,0 +1,8 @@ +package ksm.mdi + +import app.meetacy.di.DI +import ksm.StateController + +public val StateController.di: DI get() { + return context.di +} diff --git a/mdi/src/commonMain/kotlin/ksm/mdi/plugin/DIEntry.kt b/mdi/src/commonMain/kotlin/ksm/mdi/plugin/DIEntry.kt new file mode 100644 index 0000000..2d5484a --- /dev/null +++ b/mdi/src/commonMain/kotlin/ksm/mdi/plugin/DIEntry.kt @@ -0,0 +1,22 @@ +package ksm.mdi.plugin + +import app.meetacy.di.DI +import ksm.context.StateContext + +internal class DIEntry(private val root: DI) : StateContext.Element { + override val key = DIEntry + + private var di: DI? = root + + fun setDI(di: DI?) { + if (di == null) { + this.di = null + return + } + this.di = root + di + } + + fun getDI() = di + + companion object : StateContext.Key +} diff --git a/mdi/src/commonMain/kotlin/ksm/mdi/plugin/DIPlugin.kt b/mdi/src/commonMain/kotlin/ksm/mdi/plugin/DIPlugin.kt new file mode 100644 index 0000000..4f3b4ff --- /dev/null +++ b/mdi/src/commonMain/kotlin/ksm/mdi/plugin/DIPlugin.kt @@ -0,0 +1,50 @@ +package ksm.mdi.plugin + +import app.meetacy.di.DI +import app.meetacy.di.builder.di +import ksm.StateController +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor +import ksm.plugin.Plugin +import ksm.context.configuration.interceptor.addConfigurationInterceptor +import ksm.lifecycle.LifecycleInterceptor +import ksm.lifecycle.addLifecycleInterceptor + +public class DIPlugin(private val root: DI) : Plugin { + override val key: Companion = DIPlugin + + @MutateContext + override fun install(context: StateContext): StateContext { + context.addConfigurationInterceptor(Configuration()) + return context + DIEntry(root) + } + + private inner class Configuration : ConfigurationInterceptor { + @MutateContext + override fun onConfigure(context: StateContext): StateContext { + val entry = DIEntry(root) + context.addLifecycleInterceptor(Lifecycle(entry)) + return context + entry + } + } + + private inner class Lifecycle(val entry: DIEntry) : LifecycleInterceptor { + override fun onFinish(context: StateContext) { + entry.setDI(null) + } + } + + public fun di(context: StateContext): DI { + val base = context.require(DIEntry).getDI() ?: error("DI is not initialized") + return base + di { + val stateController by constant(StateController(context)) + } + } + + public fun setDI(context: StateContext, di: DI) { + context.require(DIEntry).setDI(di) + } + + public companion object : StateContext.Key +} diff --git a/navigation/compose-navigation/build.gradle.kts b/navigation/compose-navigation/build.gradle.kts new file mode 100644 index 0000000..a9fffbd --- /dev/null +++ b/navigation/compose-navigation/build.gradle.kts @@ -0,0 +1,26 @@ +plugins { + id("android-library-convention") +} + +version = libs.versions.ksm.get() + +android { + namespace = "app.meetacy.ksm.androidx" + + buildFeatures { + compose = true + } + composeOptions { + kotlinCompilerExtensionVersion = libs.versions.compose.compiler.get() + } +} + +dependencies { + api(projects.mdi) + api(projects.kotlinxSerializationJson) // todo: remove; needed for example only + implementation(libs.kotlinx.serialization) + implementation(libs.mdi) + implementation(libs.compose.runtime) + implementation(libs.compose.foundation) + implementation(libs.compose.runtime.saveable) +} diff --git a/navigation/compose-navigation/src/main/kotlin/ksm/compose/RememberStateController.kt b/navigation/compose-navigation/src/main/kotlin/ksm/compose/RememberStateController.kt new file mode 100644 index 0000000..cdee51a --- /dev/null +++ b/navigation/compose-navigation/src/main/kotlin/ksm/compose/RememberStateController.kt @@ -0,0 +1,30 @@ +package ksm.compose + +import androidx.compose.runtime.Composable +import androidx.compose.runtime.remember +import androidx.compose.runtime.saveable.rememberSaveable +import ksm.StateController +import ksm.builder.StateControllerBuilder +import ksm.compose.plugin.ComposePlugin +import ksm.compose.plugin.ComposeSerializationStore +import ksm.createRawStateController +import ksm.serialization.restore + +@Composable +public fun rememberStateController( + builder: StateControllerBuilder.() -> Unit +): StateController { + val store = rememberSaveable( + builder, + saver = ComposeSerializationStore.Saver, + init = { ComposeSerializationStore() } + ) + return remember(store) { + createRawStateController { + install(ComposePlugin(store)) + builder() + }.apply { + context.restore() + } + } +} diff --git a/navigation/compose-navigation/src/main/kotlin/ksm/compose/StateBuilderScope.kt b/navigation/compose-navigation/src/main/kotlin/ksm/compose/StateBuilderScope.kt new file mode 100644 index 0000000..e16ce0a --- /dev/null +++ b/navigation/compose-navigation/src/main/kotlin/ksm/compose/StateBuilderScope.kt @@ -0,0 +1,13 @@ +package ksm.compose + +import androidx.compose.runtime.Composable +import ksm.compose.plugin.ComposePlugin +import ksm.plugin.plugin +import ksm.state.StateScope +import ksm.state.builder.StateBuilderScope + +public fun StateBuilderScope.Content( + block: @Composable StateScope.() -> Unit +) { + context.plugin(ComposePlugin).setContent(context, block) +} diff --git a/navigation/compose-navigation/src/main/kotlin/ksm/compose/host/StateHost.kt b/navigation/compose-navigation/src/main/kotlin/ksm/compose/host/StateHost.kt new file mode 100644 index 0000000..1c40b5b --- /dev/null +++ b/navigation/compose-navigation/src/main/kotlin/ksm/compose/host/StateHost.kt @@ -0,0 +1,32 @@ +package ksm.compose.host + +import androidx.compose.foundation.layout.Box +import androidx.compose.runtime.Composable +import androidx.compose.runtime.key +import androidx.compose.runtime.remember +import ksm.StateController +import ksm.compose.plugin.ComposePlugin +import ksm.plugin.plugin +import ksm.state.StateScope +import ksm.state.launch + +@Composable +public fun StateHost( + controller: StateController, + startStateName: String +) { + Box { + val currentContext = remember(controller) { + controller.launch(startStateName) + controller.context.plugin(ComposePlugin).currentContext + }.value + + key(currentContext) { + currentContext ?: return + val childController = StateController(currentContext) + val contentScope = StateScope(childController) + val content = currentContext.plugin(ComposePlugin).content(currentContext) + content?.invoke(contentScope) + } + } +} diff --git a/navigation/compose-navigation/src/main/kotlin/ksm/compose/plugin/ComposeEntry.kt b/navigation/compose-navigation/src/main/kotlin/ksm/compose/plugin/ComposeEntry.kt new file mode 100644 index 0000000..f897d45 --- /dev/null +++ b/navigation/compose-navigation/src/main/kotlin/ksm/compose/plugin/ComposeEntry.kt @@ -0,0 +1,13 @@ +package ksm.compose.plugin + +import androidx.compose.runtime.Composable +import ksm.context.StateContext +import ksm.state.StateScope + +internal class ComposeEntry : StateContext.Element { + override val key = ComposeEntry + + var content: (@Composable StateScope.() -> Unit)? = null + + companion object : StateContext.Key +} diff --git a/navigation/compose-navigation/src/main/kotlin/ksm/compose/plugin/ComposePlugin.kt b/navigation/compose-navigation/src/main/kotlin/ksm/compose/plugin/ComposePlugin.kt new file mode 100644 index 0000000..44b281e --- /dev/null +++ b/navigation/compose-navigation/src/main/kotlin/ksm/compose/plugin/ComposePlugin.kt @@ -0,0 +1,55 @@ +package ksm.compose.plugin + +import androidx.compose.runtime.Composable +import androidx.compose.runtime.mutableStateOf +import ksm.annotation.MutateContext +import ksm.context.StateContext +import ksm.context.configuration.interceptor.ConfigurationInterceptor +import ksm.context.configuration.interceptor.addConfigurationInterceptor +import ksm.lifecycle.LifecycleInterceptor +import ksm.lifecycle.addLifecycleInterceptor +import ksm.plugin.Plugin +import ksm.serialization.BaseSerializationStore +import ksm.state.StateScope + +public class ComposePlugin( + private val store: BaseSerializationStore.String +) : Plugin { + override val key: Companion = ComposePlugin + + internal val currentContext = mutableStateOf(value = null) + + @MutateContext + override fun install(context: StateContext): StateContext { + context.addConfigurationInterceptor(Configuration()) + return context + store + } + + private inner class Configuration : ConfigurationInterceptor { + + @MutateContext + override fun onConfigure(context: StateContext): StateContext { + context.addLifecycleInterceptor(Lifecycle()) + return context + ComposeEntry() + } + } + + private inner class Lifecycle : LifecycleInterceptor { + override fun onResume(context: StateContext) { + currentContext.value = context + } + } + + internal fun setContent( + context: StateContext, + content: @Composable StateScope.() -> Unit + ) { + context.require(ComposeEntry).content = content + } + + internal fun content(context: StateContext): (@Composable StateScope.() -> Unit)? { + return context.require(ComposeEntry).content + } + + public companion object : StateContext.Key +} diff --git a/navigation/compose-navigation/src/main/kotlin/ksm/compose/plugin/ComposeSerializationStore.kt b/navigation/compose-navigation/src/main/kotlin/ksm/compose/plugin/ComposeSerializationStore.kt new file mode 100644 index 0000000..bd58129 --- /dev/null +++ b/navigation/compose-navigation/src/main/kotlin/ksm/compose/plugin/ComposeSerializationStore.kt @@ -0,0 +1,25 @@ +package ksm.compose.plugin + +import androidx.compose.runtime.saveable.SaverScope +import ksm.serialization.BaseSerializationStore +import androidx.compose.runtime.saveable.Saver as ComposeSaver + +public class ComposeSerializationStore( + internal var string: String? = null +) : BaseSerializationStore.String { + + override fun apply(string: String) { + this.string = string + } + + override fun get(): String? = string + + public object Saver : ComposeSaver { + override fun restore(value: String): ComposeSerializationStore { + return ComposeSerializationStore(value) + } + override fun SaverScope.save(value: ComposeSerializationStore): String? { + return value.string + } + } +} diff --git a/settings.gradle.kts b/settings.gradle.kts new file mode 100644 index 0000000..a2c5ece --- /dev/null +++ b/settings.gradle.kts @@ -0,0 +1,36 @@ +enableFeaturePreview("TYPESAFE_PROJECT_ACCESSORS") + +rootProject.name = "ksm" + +pluginManagement { + repositories { + gradlePluginPortal() + mavenCentral() + google() + } +} + +dependencyResolutionManagement { + repositories { + mavenCentral() + google() + maven { + url = uri("https://maven.pkg.github.com/meetacy/di") + credentials { + username = System.getenv("GITHUB_USERNAME") + password = System.getenv("GITHUB_TOKEN") + } + } + } +} + +includeBuild("build-logic") + +include( + "core", + "kotlinx-coroutines", + "kotlinx-serialization-json", + "navigation:compose-navigation", + "ktgbotapi", + "mdi" +)