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

package/templates/app/shared-core/build.gradle.kts

@@ -0,0 +1,37 @@
+import com.android.build.api.dsl.KotlinMultiplatformAndroidLibraryTarget
+
+plugins {
+    alias(libs.plugins.kotlin.multiplatform)
+    alias(libs.plugins.kotlin.serialization)
+    alias(libs.plugins.android.kotlin.multiplatform.library) apply false
+}
+val hasAndroid = rootProject.file("androidApp").isDirectory
+val hasIos = rootProject.file("iosApp").isDirectory
+if (hasAndroid) pluginManager.apply("com.android.kotlin.multiplatform.library")
+
+kotlin {
+    targets.withType<KotlinMultiplatformAndroidLibraryTarget>().configureEach {
+        namespace = "__PACKAGE_NAME__.core"
+        compileSdk = libs.versions.android.compileSdk.get().toInt()
+        minSdk = 24
+        compilerOptions { jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_17) }
+    }
+    if (hasIos) {
+        iosArm64()
+        iosSimulatorArm64()
+    }
+    jvm()
+    js {
+        browser()
+        binaries.library()
+        generateTypeScriptDefinitions()
+    }
+    wasmJs { browser() }
+    sourceSets {
+        commonMain.dependencies { implementation(libs.serialization.json) }
+        commonTest.dependencies {
+            implementation(kotlin("test"))
+            implementation(libs.coroutines.test)
+        }
+    }
+}

package/templates/app/shared-core/src/commonMain/kotlin/io/github/l2hyunwoo/ait/sample/Notes.kt

@@ -0,0 +1,37 @@
+package __PACKAGE_NAME__
+
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.json.Json
+
+@Serializable
+data class Note(val id: String, val title: String, val body: String)
+
+interface NotesRepository {
+    suspend fun list(): List<Note>
+}
+
+// The transport owns HTTPS, authentication and platform-specific networking.
+class NotesApiClient(private val getNotesJson: suspend () -> String) : NotesRepository {
+    override suspend fun list(): List<Note> = parseNotes(getNotesJson())
+}
+
+class DemoNotesRepository : NotesRepository {
+    override suspend fun list() = listOf(
+        Note("welcome", "공유 화면을 만들어요", "이 화면은 앱인토스, 웹, Android, iOS에서 함께 사용해요."),
+        Note("boundary", "필요한 부분만 가져가요", "토스 전용 기능과 디자인은 앱인토스에 남겨요."),
+    )
+}
+
+interface DraftStorage {
+    fun read(id: String): String?
+    fun write(id: String, body: String)
+}
+class MemoryDraftStorage : DraftStorage {
+    private val drafts = mutableMapOf<String, String>()
+    override fun read(id: String) = drafts[id]
+    override fun write(id: String, body: String) {
+        drafts[id] = body
+    }
+}
+
+internal fun parseNotes(json: String): List<Note> = Json.decodeFromString(json)

package/templates/app/shared-core/src/commonTest/kotlin/io/github/l2hyunwoo/ait/sample/NotesApiClientTest.kt

@@ -0,0 +1,17 @@
+package __PACKAGE_NAME__
+
+import kotlin.test.Test
+import kotlin.test.assertEquals
+import kotlin.test.assertFails
+import kotlinx.coroutines.test.runTest
+
+class NotesApiClientTest {
+    @Test fun decodesWithoutUiOrToss() = runTest {
+        val api = NotesApiClient { """[{"id":"1","title":"한글","body":"내용"}]""" }
+        assertEquals("한글", api.list().single().title)
+    }
+
+    @Test fun rejectsInvalidServerData() = runTest {
+        assertFails { NotesApiClient { """[{"id":null}]""" }.list() }
+    }
+}

package/templates/app/shared-core/src/jsMain/kotlin/io/github/l2hyunwoo/ait/sample/BrowserNote.kt

@@ -0,0 +1,12 @@
+@file:OptIn(kotlin.js.ExperimentalJsExport::class)
+
+package __PACKAGE_NAME__
+
+import kotlin.js.JsExport
+
+@JsExport
+class BrowserNote(val id: String, val title: String, val body: String)
+
+/** Supply your own fetch/auth transport; parsing uses the shared service model. */
+@JsExport
+fun decodeNotesResponse(json: String): Array<BrowserNote> = parseNotes(json).map { BrowserNote(it.id, it.title, it.body) }.toTypedArray()

package/templates/app/shared-ui/README.md

@@ -0,0 +1,22 @@
+# Shared UI
+
+메모 목록·상세·편집 화면을 Compose Multiplatform으로 제공하는 라이브러리입니다. 앱인토스·Android·iOS·독립 웹에서 같은 화면을 사용할 수 있습니다.
+
+## 화면과 상태
+
+| API | 역할 |
+| --- | --- |
+| `ServiceApp(...)` | 목록·상세 흐름, 데이터 조회, 저장·공유 동작 구성 |
+| `NotesList(notes, onSelect, modifier)` | 메모 목록 화면 |
+| `NoteDetail(note, modifier, storage, onShare)` | 메모 편집·저장·공유 화면 |
+| `ServiceNavigation` | 선택한 메모와 목록 복귀 상태 |
+
+필요한 화면만 사용하거나 `ServiceApp`으로 함께 구성합니다. `NotesRepository`와 `DraftStorage`는 [공통 core](../shared-core/README.md)의 계약입니다. 기본 조회 구현은 데모 데이터를 반환하고 기본 저장은 메모리를 사용합니다.
+
+`onShare`에는 호스트의 공유 동작을, `hostContent`에는 호스트 전용 UI를 전달합니다. `showBackButton`으로 공통 화면의 목록 복귀 버튼을 제어합니다. 저장은 사용자가 `저장해요`를 누를 때 수행합니다.
+
+## 디자인
+
+Compose Material 3 테마와 Noto Sans KR을 사용합니다. 토스·TDS 의존성은 없습니다. 한글 폰트를 리소스에 포함하며 [폰트 라이선스](src/commonMain/composeResources/files/NotoSansKR-OFL.txt)를 함께 배포합니다.
+
+Android·iOS·웹 호스트는 플랫폼의 저장·공유·생명주기를 연결합니다. 화면의 재사용과 계정·인증·서버 동기화는 별도 책임입니다.

package/templates/app/shared-ui/build.gradle.kts

@@ -0,0 +1,49 @@
+import com.android.build.api.dsl.KotlinMultiplatformAndroidLibraryTarget
+
+plugins {
+    alias(libs.plugins.kotlin.multiplatform)
+    alias(libs.plugins.kotlin.compose)
+    alias(libs.plugins.compose)
+    alias(libs.plugins.android.kotlin.multiplatform.library) apply false
+}
+val hasAndroid = rootProject.file("androidApp").isDirectory
+val hasIos = rootProject.file("iosApp").isDirectory
+if (hasAndroid) pluginManager.apply("com.android.kotlin.multiplatform.library")
+
+kotlin {
+    targets.withType<KotlinMultiplatformAndroidLibraryTarget>().configureEach {
+        namespace = "__PACKAGE_NAME__.ui"
+        compileSdk = libs.versions.android.compileSdk.get().toInt()
+        minSdk = 24
+        compilerOptions { jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_17) }
+        androidResources { enable = true }
+    }
+    if (hasIos) {
+        iosArm64()
+        iosSimulatorArm64()
+    }
+    targets.withType<org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget>().configureEach {
+        binaries.framework {
+            baseName = "SharedUi"
+            isStatic = true
+        }
+    }
+    js { browser() }
+    wasmJs { browser() }
+    sourceSets {
+        commonMain.dependencies {
+            api(project(":shared-core"))
+            implementation(libs.compose.resources)
+            implementation(libs.compose.runtime)
+            implementation(libs.compose.foundation)
+            implementation(libs.compose.material3)
+            implementation(libs.compose.ui)
+            implementation(libs.coroutines.core)
+        }
+    }
+}
+
+compose.resources {
+    publicResClass = true
+    packageOfResClass = "__PACKAGE_NAME__.resources"
+}

package/templates/app/shared-ui/src/commonMain/composeResources/files/NotoSansKR-OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2014-2021 Adobe (http://www.adobe.com/), with Reserved Font Name 'Source'
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/templates/app/shared-ui/src/commonMain/kotlin/io/github/l2hyunwoo/ait/sample/ServiceApp.kt

@@ -0,0 +1,121 @@
+package __PACKAGE_NAME__
+
+import androidx.compose.foundation.clickable
+import androidx.compose.foundation.layout.*
+import androidx.compose.foundation.lazy.LazyColumn
+import androidx.compose.foundation.lazy.items
+import androidx.compose.material3.*
+import androidx.compose.runtime.*
+import androidx.compose.runtime.saveable.rememberSaveable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.text.font.FontFamily
+import androidx.compose.ui.unit.dp
+import __PACKAGE_NAME__.resources.NotoSansKR
+import __PACKAGE_NAME__.resources.Res
+import kotlinx.coroutines.CancellationException
+import org.jetbrains.compose.resources.Font
+
+class ServiceNavigation {
+    var selectedId by mutableStateOf<String?>(null)
+    fun back(): Boolean {
+        if (selectedId == null) return false
+        selectedId = null
+        return true
+    }
+}
+
+@Composable
+fun ServiceApp(
+    state: ServiceNavigation = remember { ServiceNavigation() },
+    storage: DraftStorage = remember { MemoryDraftStorage() },
+    onShare: ((String) -> Unit)? = null,
+    showBackButton: Boolean = true,
+    repository: NotesRepository = remember { DemoNotesRepository() },
+    hostContent: @Composable () -> Unit = {},
+) {
+    var notes by remember { mutableStateOf<List<Note>>(emptyList()) }
+    var error by remember { mutableStateOf<String?>(null) }
+    LaunchedEffect(repository) {
+        try {
+            notes = repository.list()
+        } catch (e: CancellationException) {
+            throw e
+        } catch (_: Exception) {
+            error = "목록을 불러오지 못했어요."
+        }
+    }
+    MaterialTheme(colorScheme = lightColorScheme(), typography = serviceTypography()) {
+        Surface(Modifier.fillMaxSize()) {
+            Column(Modifier.safeDrawingPadding().imePadding().padding(20.dp), verticalArrangement = Arrangement.spacedBy(16.dp)) {
+                Text("__DISPLAY_NAME__", style = MaterialTheme.typography.headlineMedium)
+                Text("데모 데이터예요. 필요한 화면과 API를 함께 사용해요.")
+                val selected = notes.firstOrNull { it.id == state.selectedId }
+                if (selected == null) {
+                    error?.let { Text(it) }
+                    NotesList(notes, { state.selectedId = it }, Modifier.weight(1f))
+                } else {
+                    if (showBackButton) TextButton(onClick = { state.back() }) { Text("목록으로 돌아가요") }
+                    NoteDetail(selected, Modifier.weight(1f), storage, onShare)
+                }
+                hostContent()
+            }
+        }
+    }
+}
+
+@Composable
+fun NotesList(notes: List<Note>, onSelect: (String) -> Unit, modifier: Modifier = Modifier) {
+    LazyColumn(modifier, verticalArrangement = Arrangement.spacedBy(12.dp)) {
+        items(notes, key = { it.id }) { note ->
+            Card(Modifier.fillMaxWidth().clickable(onClickLabel = "상세 보기", onClick = { onSelect(note.id) })) {
+                Text(note.title, Modifier.padding(20.dp))
+            }
+        }
+    }
+}
+
+@Composable
+fun NoteDetail(note: Note, modifier: Modifier = Modifier, storage: DraftStorage = remember { MemoryDraftStorage() }, onShare: ((String) -> Unit)? = null) {
+    val loaded = remember(note.id, storage) { runCatching { storage.read(note.id) } }
+    var draft by rememberSaveable(note.id) { mutableStateOf(loaded.getOrNull() ?: note.body) }
+    var message by remember(note.id) { mutableStateOf<String?>(null) }
+    Column(modifier, verticalArrangement = Arrangement.spacedBy(12.dp)) {
+        Text(note.title, style = MaterialTheme.typography.titleLarge)
+        OutlinedTextField(draft, { draft = it }, label = { Text("내용을 입력해요") }, modifier = Modifier.fillMaxWidth())
+        if (loaded.isFailure) Text("저장된 내용을 불러오지 못했어요. 다시 열어 주세요.")
+        Button(enabled = loaded.isSuccess, onClick = {
+            message = try {
+                storage.write(note.id, draft)
+                "저장했어요."
+            } catch (_: Exception) {
+                "저장하지 못했어요. 다시 시도해 주세요."
+            }
+        }) { Text("저장해요") }
+        message?.let { Text(it) }
+        onShare?.let { share -> TextButton(onClick = { share(draft) }, enabled = draft.isNotBlank()) { Text("내용을 공유해요") } }
+        Text("데모는 기기 안에 저장해요. 민감 정보는 입력하지 마세요.")
+    }
+}
+
+@Composable
+private fun serviceTypography(): Typography {
+    val family = FontFamily(Font(Res.font.NotoSansKR))
+    val base = Typography()
+    return base.copy(
+        displayLarge = base.displayLarge.copy(fontFamily = family),
+        displayMedium = base.displayMedium.copy(fontFamily = family),
+        displaySmall = base.displaySmall.copy(fontFamily = family),
+        headlineLarge = base.headlineLarge.copy(fontFamily = family),
+        headlineMedium = base.headlineMedium.copy(fontFamily = family),
+        headlineSmall = base.headlineSmall.copy(fontFamily = family),
+        titleLarge = base.titleLarge.copy(fontFamily = family),
+        titleMedium = base.titleMedium.copy(fontFamily = family),
+        titleSmall = base.titleSmall.copy(fontFamily = family),
+        bodyLarge = base.bodyLarge.copy(fontFamily = family),
+        bodyMedium = base.bodyMedium.copy(fontFamily = family),
+        bodySmall = base.bodySmall.copy(fontFamily = family),
+        labelLarge = base.labelLarge.copy(fontFamily = family),
+        labelMedium = base.labelMedium.copy(fontFamily = family),
+        labelSmall = base.labelSmall.copy(fontFamily = family),
+    )
+}

package/templates/app/shared-ui/src/iosMain/kotlin/io/github/l2hyunwoo/ait/sample/MainViewController.kt

@@ -0,0 +1,40 @@
+@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class, kotlin.experimental.ExperimentalNativeApi::class)
+
+package __PACKAGE_NAME__
+
+import androidx.compose.runtime.remember
+import androidx.compose.ui.window.ComposeUIViewController
+import kotlin.native.ref.WeakReference
+import platform.Foundation.NSUserDefaults
+import platform.UIKit.UIActivityViewController
+import platform.UIKit.UIViewController
+import platform.UIKit.popoverPresentationController
+
+@Suppress("ktlint:standard:function-naming")
+fun MainViewController(): UIViewController {
+    var host: WeakReference<UIViewController>? = null
+    val controller = ComposeUIViewController {
+        val storage = remember { UserDefaultsDraftStorage(NSUserDefaults.standardUserDefaults) }
+        ServiceApp(storage = storage, onShare = { text ->
+            val presenter = host?.get()
+            if (presenter != null && presenter.presentedViewController == null) {
+                val activity = UIActivityViewController(activityItems = listOf(text), applicationActivities = null)
+                activity.popoverPresentationController?.let { popover ->
+                    popover.sourceView = presenter.view
+                    popover.sourceRect = presenter.view.bounds
+                }
+                presenter.presentViewController(activity, animated = true, completion = null)
+            }
+        })
+    }
+    host = WeakReference(controller)
+    return controller
+}
+
+private class UserDefaultsDraftStorage(private val defaults: NSUserDefaults) : DraftStorage {
+    override fun read(id: String): String? = defaults.stringForKey("draft:$id")
+
+    override fun write(id: String, body: String) {
+        defaults.setObject(body, forKey = "draft:$id")
+    }
+}

package/templates/app/webApp/README.md

@@ -0,0 +1,18 @@
+# 독립 웹 메모 앱
+
+토스 런타임 없이 공통 메모 화면과 서비스 로직을 사용하는 Compose 웹앱 예제입니다. [공통 UI](../shared-ui/README.md)와 [공통 core](../shared-core/README.md)를 사용합니다.
+
+## 동작
+
+메모 목록·상세·편집·저장을 제공합니다. 초안은 localStorage에 메모 ID별로 저장하며 출처(origin)별로 구분합니다. 토스 로그인, 브리지, mock은 배포물에 포함하지 않습니다. URL·히스토리 기반 화면 이동과 서비스 인증은 별도 구현이 필요합니다.
+
+## 실행
+
+Node 24 이상·Corepack·JDK 17과 Yarn 의존성을 준비하고 프로젝트 루트에서 실행합니다.
+
+```sh
+yarn dev:web
+yarn build:web
+```
+
+배포물은 `dist/web`에 생성됩니다. 저장소 예제의 조회 데이터는 로컬 데모 데이터입니다.

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

@@ -0,0 +1,23 @@
+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)
+        }
+    }
+}

package/templates/app/webApp/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/webApp/src/webMain/kotlin/Main.kt

@@ -0,0 +1,8 @@
+import androidx.compose.ui.ExperimentalComposeUiApi
+import androidx.compose.ui.window.ComposeViewport
+import __PACKAGE_NAME__.ServiceApp
+
+@OptIn(ExperimentalComposeUiApi::class)
+fun main() {
+    ComposeViewport(viewportContainerId = "compose-root") { ServiceApp(storage = androidx.compose.runtime.remember { BrowserDraftStorage() }) }
+}

package/templates/app/webApp/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="webApp.js"></script></body></html>