create-ait-cmp-app 0.0.0-stage → 1.0.0-alpha01

package/templates/app/_yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

package/templates/app/androidApp/README.md

@@ -0,0 +1,19 @@
+# Android 메모 앱
+
+[공통 UI](../shared-ui/README.md)의 `ServiceApp()`을 Android Activity에서 실행하는 앱입니다. 토스 SDK·TDS·토스 mock을 설치하지 않습니다.
+
+## Android 연결
+
+메모 초안을 SharedPreferences에 저장하고, 공유 버튼은 Android 공유 선택창을 엽니다. 상세 화면의 시스템 뒤로 가기는 목록으로 돌아가며 목록의 뒤로 가기는 Activity 종료 동작을 따릅니다. Activity 재생성 시 선택한 메모를 복원합니다.
+
+저장은 메모 ID를 기준으로 하며 계정별 분리·암호화·서버 동기화는 포함하지 않습니다. 앱 데이터를 삭제하면 저장한 초안도 삭제됩니다.
+
+## 실행
+
+JDK 17과 Android SDK 37을 준비하고 프로젝트 루트에서 빌드합니다.
+
+```sh
+./gradlew :androidApp:assembleDebug
+```
+
+Android Studio에서 프로젝트 루트를 열고 Android 7.0(API 24) 이상 기기에 실행합니다. 시작점은 [MainActivity](src/main/kotlin/io/github/l2hyunwoo/ait/sample/android/MainActivity.kt)입니다.

package/templates/app/androidApp/build.gradle.kts

@@ -0,0 +1,29 @@
+plugins {
+    alias(libs.plugins.android.application)
+    alias(libs.plugins.kotlin.compose)
+}
+
+android {
+    namespace = "__PACKAGE_NAME__.android"
+    compileSdk = libs.versions.android.compileSdk.get().toInt()
+
+    defaultConfig {
+        applicationId = "__PACKAGE_NAME__"
+        minSdk = 24
+        targetSdk = libs.versions.android.targetSdk.get().toInt()
+        versionCode = 1
+        versionName = "0.1.0"
+    }
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+    }
+    buildFeatures { compose = true }
+}
+
+kotlin { compilerOptions { jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_17) } }
+
+dependencies {
+    implementation(project(":shared-ui"))
+    implementation(libs.androidx.activity.compose)
+}

package/templates/app/androidApp/src/main/AndroidManifest.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <application
+        android:label="__DISPLAY_NAME__"
+        android:theme="@android:style/Theme.Material.Light.NoActionBar">
+        <activity
+            android:name=".MainActivity"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+</manifest>

package/templates/app/androidApp/src/main/kotlin/io/github/l2hyunwoo/ait/sample/android/MainActivity.kt

@@ -0,0 +1,49 @@
+package __PACKAGE_NAME__.android
+
+import android.content.Intent
+import android.content.SharedPreferences
+import android.os.Bundle
+import androidx.activity.ComponentActivity
+import androidx.activity.compose.BackHandler
+import androidx.activity.compose.setContent
+import androidx.activity.enableEdgeToEdge
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.saveable.Saver
+import androidx.compose.runtime.saveable.rememberSaveable
+import __PACKAGE_NAME__.DraftStorage
+import __PACKAGE_NAME__.ServiceApp
+import __PACKAGE_NAME__.ServiceNavigation
+
+class MainActivity : ComponentActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        enableEdgeToEdge()
+        setContent {
+            val state = rememberSaveable(
+                saver = Saver<ServiceNavigation, List<String>>(
+                    save = { listOfNotNull(it.selectedId) },
+                    restore = { ServiceNavigation().apply { selectedId = it.firstOrNull() } },
+                ),
+            ) { ServiceNavigation() }
+            val storage = remember {
+                PreferencesDraftStorage(getSharedPreferences("drafts", MODE_PRIVATE))
+            }
+            BackHandler(enabled = state.selectedId != null) { state.back() }
+            ServiceApp(state = state, storage = storage, onShare = { text ->
+                val send = Intent(Intent.ACTION_SEND).apply {
+                    type = "text/plain"
+                    putExtra(Intent.EXTRA_TEXT, text)
+                }
+                startActivity(Intent.createChooser(send, "공유"))
+            })
+        }
+    }
+}
+
+private class PreferencesDraftStorage(private val preferences: SharedPreferences) : DraftStorage {
+    override fun read(id: String): String? = preferences.getString("draft:$id", null)
+
+    override fun write(id: String, body: String) {
+        preferences.edit().putString("draft:$id", body).apply()
+    }
+}

package/templates/app/apps-in-toss.config.ts

@@ -0,0 +1,2 @@
+import { defineConfig } from '@apps-in-toss/web-framework/config';
+export default defineConfig({appName:"__APP_NAME__",brand:{primaryColor:"#3469D9"},permissions:[],navigationBar:{withBackButton:true,withHomeButton:true,theme:"light"},webBundleDir:"dist/apps-in-toss"});

package/templates/app/appsInTossApp/README.md

@@ -0,0 +1,23 @@
+# 앱인토스 메모 앱
+
+공통 메모 화면에 토스 로그인·공유·호스트 이벤트·안전 영역을 연결한 Compose 웹앱 예제입니다. 앱인토스 전용 UI와 기능을 이 호스트에 둡니다.
+
+## 구성과 동작
+
+[공통 UI](../shared-ui/README.md)와 [공통 core](../shared-core/README.md)를 사용합니다. 초안은 브라우저 localStorage에 메모 ID별로 저장하며 출처(origin)별로 구분합니다. 로그인 결과는 화면 상태로 전달하며 서버의 인가 코드 교환은 구현하지 않았습니다.
+
+뒤로 가기 이벤트는 상세 화면에서 목록으로 이동하고 목록에서는 호스트 화면을 닫습니다. 홈 이벤트는 선택한 메모를 해제합니다. 클라이언트는 Compose 호스트가 해제될 때 닫습니다.
+
+## 실행
+
+프로젝트 루트에서 실행합니다. Node 24 이상·Corepack·JDK 17과 Yarn 의존성이 필요합니다.
+
+```sh
+yarn dev
+yarn dev:toss
+yarn build
+```
+
+`dev`는 mock, `dev:toss`는 실제 브리지로 실행합니다. `build`는 실제 브리지를 포함한 `.ait`를 만듭니다. `apps-in-toss.config.ts`의 appName·브랜드·권한 등 서비스 설정을 콘솔과 맞춰야 합니다. 자동 업로드는 하지 않습니다.
+
+예제 데이터와 mock 인증 결과는 운영 데이터·인증 증명이 아닙니다. TDS는 포함하지 않습니다.

package/templates/app/appsInTossApp/build.gradle.kts

@@ -0,0 +1,34 @@
+plugins {
+    alias(libs.plugins.kotlin.multiplatform)
+    alias(libs.plugins.kotlin.compose)
+    alias(libs.plugins.compose)
+}
+kotlin {
+    js {
+        browser()
+        binaries.executable()
+    }
+    wasmJs {
+        browser()
+        binaries.executable()
+    }
+    sourceSets {
+        commonMain.dependencies {
+            implementation(project(":shared-ui"))
+            implementation(libs.compose.ui)
+            implementation(libs.compose.material3)
+            implementation(libs.coroutines.core)
+            implementation("io.github.l2hyunwoo:apps-in-toss-sdk:1.0.0-alpha01")
+        }
+    }
+}
+
+val sdkWebResources = configurations.create("sdkWebResources")
+dependencies {
+    add(sdkWebResources.name, "io.github.l2hyunwoo:apps-in-toss-sdk:1.0.0-alpha01:web-resources@jar")
+}
+tasks.register<Sync>("prepareAppsInTossBridge") {
+    dependsOn(sdkWebResources)
+    from({ sdkWebResources.map { zipTree(it) } })
+    into(layout.buildDirectory.dir("ait-cmp-sdk"))
+}

package/templates/app/appsInTossApp/src/webMain/kotlin/BrowserDraftStorage.kt

@@ -0,0 +1,9 @@
+import __PACKAGE_NAME__.DraftStorage
+import kotlinx.browser.window
+
+class BrowserDraftStorage : DraftStorage {
+    override fun read(id: String): String? = window.localStorage.getItem("cmp-note-$id")
+    override fun write(id: String, body: String) {
+        window.localStorage.setItem("cmp-note-$id", body)
+    }
+}

package/templates/app/appsInTossApp/src/webMain/kotlin/Main.kt

@@ -0,0 +1,68 @@
+import androidx.compose.foundation.layout.*
+import androidx.compose.material3.*
+import androidx.compose.runtime.*
+import androidx.compose.ui.ExperimentalComposeUiApi
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.unit.dp
+import androidx.compose.ui.window.ComposeViewport
+import io.github.l2hyunwoo.ait.*
+import __PACKAGE_NAME__.*
+import kotlinx.coroutines.CancellationException
+import kotlinx.coroutines.launch
+
+@OptIn(ExperimentalComposeUiApi::class)
+fun main() {
+    ComposeViewport(viewportContainerId = "compose-root") {
+        val client = remember { createAppsInTossClient() }
+        val scope = rememberCoroutineScope()
+        val navigation = remember { ServiceNavigation() }
+        val storage = remember { BrowserDraftStorage() }
+        var status by remember { mutableStateOf("앱인토스 전용 영역이에요. 현재 환경: ${client.host}") }
+        var insets by remember { mutableStateOf(SafeAreaInsets(0.0, 0.0, 0.0, 0.0)) }
+        DisposableEffect(client) { onDispose { client.close() } }
+        LaunchedEffect(client) {
+            if (client.host != RuntimeHost.BROWSER) {
+                try {
+                    client.events.collect { event ->
+                        when (event) {
+                            is HostEvent.SafeArea -> insets = event.insets
+                            HostEvent.Back -> if (!navigation.back()) client.closeScreen()
+                            HostEvent.Home -> navigation.selectedId = null
+                        }
+                    }
+                } catch (e: CancellationException) {
+                    throw e
+                } catch (_: Exception) {
+                    status = "호스트 이벤트를 연결하지 못했어요."
+                }
+            }
+        }
+        Box(Modifier.padding(top = insets.top.dp, bottom = insets.bottom.dp, start = insets.left.dp, end = insets.right.dp)) {
+            ServiceApp(state = navigation, storage = storage, showBackButton = client.host == RuntimeHost.MOCK, onShare = { text ->
+                scope.launch {
+                    try {
+                        client.shareText(text)
+                    } catch (e: CancellationException) {
+                        throw e
+                    } catch (_: Exception) {
+                        status = "공유하지 못했어요."
+                    }
+                }
+            }, hostContent = {
+                Text(status)
+                Button(enabled = client.supports(Capability.TOSS_LOGIN), onClick = {
+                    scope.launch {
+                        status = try {
+                            client.requestTossLogin()
+                            "인가 결과를 받았어요. 실제 서비스는 서버에서 교환해야 해요."
+                        } catch (e: CancellationException) {
+                            throw e
+                        } catch (e: AppsInTossException) {
+                            "로그인을 완료하지 못했어요: ${e.code}"
+                        }
+                    }
+                }) { Text("토스로 로그인해요") }
+            })
+        }
+    }
+}

package/templates/app/appsInTossApp/src/webMain/resources/index.html

@@ -0,0 +1,4 @@
+<!doctype html>
+<html lang="ko"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>__DISPLAY_NAME__</title><style>html,body,#compose-root{margin:0;width:100%;height:100%;overflow:hidden}#error{padding:24px}</style></head>
+<body><div id="compose-root"></div><div id="error" role="alert" hidden></div><script>window.addEventListener('error',()=>{const e=document.getElementById('error');e.hidden=false;e.textContent='화면을 불러오지 못했어요. 다시 열어 주세요.';});</script>
+<script src="appsInTossApp.js"></script></body></html>

package/templates/app/build.gradle.kts

@@ -0,0 +1,37 @@
+plugins {
+    base
+    alias(libs.plugins.kotlin.multiplatform) apply false
+    alias(libs.plugins.kotlin.compose) apply false
+    alias(libs.plugins.kotlin.serialization) apply false
+    alias(libs.plugins.compose) apply false
+    alias(libs.plugins.android.kotlin.multiplatform.library) apply false
+    alias(libs.plugins.android.application) apply false
+}
+
+val ktlint = configurations.create("ktlint") {
+    attributes {
+        attribute(Usage.USAGE_ATTRIBUTE, objects.named(Usage.JAVA_RUNTIME))
+        attribute(Bundling.BUNDLING_ATTRIBUTE, objects.named(Bundling.SHADOWED))
+    }
+}
+repositories { mavenCentral() }
+dependencies { ktlint(libs.ktlint.cli) }
+
+val kotlinSources = fileTree(rootDir) {
+    include("**/*.kt", "**/*.kts")
+    exclude("**/build/**", "**/node_modules/**", "**/.gradle/**", "**/.kotlin/**", "**/.yarn/**", "**/vendor/**", "packages/create-ait-cmp-app/templates/**")
+}
+
+for ((taskName, format) in listOf("ktlintCheck" to false, "ktlintFormat" to true)) {
+    tasks.register<JavaExec>(taskName) {
+        group = "verification"
+        description = if (format) "Format Kotlin sources and Gradle scripts" else "Lint Kotlin sources and Gradle scripts"
+        classpath = ktlint
+        mainClass.set("com.pinterest.ktlint.Main")
+        if (format) args("--format")
+        args(kotlinSources.files.sorted().map { it.absolutePath })
+        inputs.files(kotlinSources)
+        inputs.file(".editorconfig")
+    }
+}
+tasks.named("check") { dependsOn("ktlintCheck") }

package/templates/app/docs/development.md

@@ -0,0 +1,56 @@
+# 개발 가이드
+
+## 환경 준비
+
+Node 24 이상·Corepack·JDK 17이 필요합니다. `packageManager`에 지정한 Yarn 4를 사용합니다. 프로젝트 루트에서 실행합니다.
+
+```sh
+corepack enable
+yarn install --immutable
+```
+
+Android에는 Android SDK 37이, iOS에는 macOS와 Xcode가 추가로 필요합니다. 앱인토스 전용 프로젝트에는 네이티브 개발 도구가 필요하지 않습니다.
+
+## 앱인토스 실행과 배포물 생성
+
+```sh
+yarn dev
+yarn dev:toss
+yarn build
+```
+
+`dev`는 명시적인 mock, `dev:toss`는 실제 브리지를 로컬 네트워크에 제공합니다. 자동 갱신은 없어 소스를 바꾸면 서버를 다시 시작해야 합니다. mock 인가 코드는 서버 인증에 사용하지 않습니다.
+
+`build`는 실제 브리지를 포함한 `__APP_NAME__.ait`를 만듭니다. 업로드 전에 `apps-in-toss.config.ts`의 appName·브랜드·권한 등 필수 정보를 콘솔과 맞춥니다. 콘솔 등록·업로드는 자동으로 수행하지 않습니다.
+
+생성 앱의 직접 npm 런타임 의존성은 `@apps-in-toss/web-framework` 하나입니다. JS 브리지는 Kotlin SDK와 같은 버전의 Maven 리소스에 포함되며 웹 빌드가 자동으로 추출합니다. 별도 npm 브리지 설치는 필요하지 않습니다. 정식 CLI 배포물은 같은 버전의 SDK를 Maven Central에서 가져오고, 로컬 개발용 CLI는 `vendor/maven`에 SDK를 포함합니다. TDS는 기본 포함하지 않으며, 사용하려면 앱인토스 호스트에 React/DOM 화면과 관련 의존성을 연결해야 합니다.
+
+## 선택한 플랫폼 실행
+
+선택한 타깃의 디렉터리가 있을 때만 다음 명령을 사용합니다.
+
+```sh
+yarn dev:web
+yarn build:web
+./gradlew :androidApp:assembleDebug
+```
+
+iOS는 Xcode에서 `iosApp/ServiceSample.xcodeproj`를 열고 서명 팀을 설정합니다. 독립 웹에는 토스 브리지·mock을 포함하지 않습니다. 초안은 기기·브라우저 출처별로 저장하며 계정별 분리·동기화·암호화는 포함하지 않습니다.
+
+## 검사와 GitHub Actions
+
+```sh
+yarn lint
+yarn lint:fix
+./gradlew :shared-core:jvmTest
+```
+
+Kotlin 검사에는 JDK 17이 필요합니다. 기본 CI는 `.github/workflows/ci.yml`에 포함됩니다. GitHub 저장소에 커밋하고 main에 푸시하면 실행되며, main 대상 PR에서도 실행됩니다. 별도의 secret 설정은 필요하지 않습니다.
+
+JS·TS 린트, Kotlin·Gradle 린트, 공통 core JVM 테스트를 실행합니다. 서비스별 JS 테스트·Android·iOS 빌드·기기 실행 검사는 기본 CI에 포함하지 않으며 필요한 시점에 추가합니다.
+
+## 플랫폼 확장
+
+공통 화면과 API 계약은 `shared-ui`·`shared-core`에 유지하고 토스 전용 기능은 `appsInTossApp`에 둡니다. 나중에 플랫폼을 추가하려면 같은 CLI 버전의 템플릿에서 해당 호스트 디렉터리를 가져와 식별자를 바꾸고 Gradle 모듈을 등록합니다. 공통 모듈은 호스트 디렉터리에 따라 Android KMP 플러그인과 iOS 타깃을 활성화합니다.
+
+CLI는 기존 프로젝트를 덮어쓰거나 호스트 추가를 자동으로 처리하지 않습니다. 호스트를 추가한 뒤 해당 플랫폼에서 빌드·실행을 확인해야 합니다.

package/templates/app/eslint.config.mjs

@@ -0,0 +1,19 @@
+import js from '@eslint/js';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+export default [
+  { ignores: ['**/build/**', '**/dist/**', '**/node_modules/**', '**/.gradle/**', '**/.kotlin/**', '**/.yarn/**', '**/vendor/**', 'packages/create-ait-cmp-app/templates/**'] },
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    files: ['**/*.{js,mjs,ts}'],
+    languageOptions: { globals: { ...globals.node, ...globals.browser } },
+    rules: {
+      'no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_', caughtErrors: 'none' }],
+      'no-empty': ['error', { allowEmptyCatch: true }],
+      'eqeqeq': ['error', 'always', { null: 'ignore' }],
+    },
+  },
+];

package/templates/app/gradle/libs.versions.toml

@@ -0,0 +1,31 @@
+[versions]
+kotlin = "2.4.21"
+compose = "1.12.1"
+agp = "9.4.1"
+coroutines = "1.11.0"
+serialization = "1.11.0"
+android-compileSdk = "37"
+android-targetSdk = "37"
+activity = "1.13.0"
+material3 = "1.9.0"
+ktlint = "1.8.0"
+maven-publish = "0.37.0"
+[libraries]
+ktlint-cli = { module = "com.pinterest.ktlint:ktlint-cli", version.ref = "ktlint" }
+coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "coroutines" }
+coroutines-test = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-test", version.ref = "coroutines" }
+serialization-json = { module = "org.jetbrains.kotlinx:kotlinx-serialization-json", version.ref = "serialization" }
+androidx-activity-compose = { module = "androidx.activity:activity-compose", version.ref = "activity" }
+compose-runtime = { module = "org.jetbrains.compose.runtime:runtime", version.ref = "compose" }
+compose-foundation = { module = "org.jetbrains.compose.foundation:foundation", version.ref = "compose" }
+compose-ui = { module = "org.jetbrains.compose.ui:ui", version.ref = "compose" }
+compose-resources = { module = "org.jetbrains.compose.components:components-resources", version.ref = "compose" }
+compose-material3 = { module = "org.jetbrains.compose.material3:material3", version.ref = "material3" }
+[plugins]
+kotlin-multiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }
+kotlin-compose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
+kotlin-serialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlin" }
+compose = { id = "org.jetbrains.compose", version.ref = "compose" }
+android-kotlin-multiplatform-library = { id = "com.android.kotlin.multiplatform.library", version.ref = "agp" }
+android-application = { id = "com.android.application", version.ref = "agp" }
+maven-publish = { id = "com.vanniktech.maven.publish", version.ref = "maven-publish" }

package/templates/app/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,10 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionSha256Sum=dce76f55f8e251a3a1f130eb120f30b3d271de2b76c9b0729d316b5a1b6dc01f
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.8.1-bin.zip
+networkTimeout=10000
+retries=0
+retryBackOffMs=500
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

package/templates/app/gradle.properties

@@ -0,0 +1,3 @@
+org.gradle.jvmargs=-Xmx4g -Dfile.encoding=UTF-8
+kotlin.code.style=official
+android.useAndroidX=true