4 structural design design system

.gitignore

@@ -77,6 +77,9 @@ proguard/
 *~
 *.swp
 
+# macOS
+.DS_Store
+
 ### AndroidStudio Patch ###
 !/gradle/wrapper/gradle-wrapper.jar
 

build-logic/convention/src/main/java/dev/love/winter/convention/AndroidCompose.kt

@@ -2,25 +2,24 @@ package dev.love.winter.convention
 
 // reference : https://github.com/android/nowinandroid/blob/main/build-logic/convention/src/main/kotlin/com/google/samples/apps/nowinandroid/AndroidCompose.kt
 
-import com.android.build.gradle.internal.dsl.BaseAppModuleExtension
+import dev.love.winter.convention.extension.AndroidExtension
 import dev.love.winter.convention.extension.api
 import dev.love.winter.convention.extension.debugImplementation
 import dev.love.winter.convention.extension.implementation
 import dev.love.winter.convention.extension.libs
 import org.gradle.api.Project
 import org.gradle.kotlin.dsl.dependencies
-import org.gradle.kotlin.dsl.getByType
 import org.gradle.kotlin.dsl.withType
 import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
 
-internal fun Project.configureComposeAndroid() {
+internal fun Project.configureComposeAndroid(
+    commonExtension: AndroidExtension,
+) {
     with(pluginManager) {
         apply("org.jetbrains.kotlin.plugin.compose")
     }
 
-    val extension = extensions.getByType<BaseAppModuleExtension>()
-
-    extension.apply {
+    commonExtension.apply {
         buildFeatures.compose = true
     }
 

build-logic/convention/src/main/java/dev/love/winter/convention/extension/AppNameExtension.kt

@@ -4,6 +4,6 @@ import org.gradle.api.Project
 
 fun Project.setNamespace(name: String) {
     androidExtension.apply {
-        namespace = "dev.love.winter.ls.$name"
+        namespace = "dev.love.winter.$name"
     }
 }

build-logic/convention/src/main/java/winter.compose.gradle.kts

@@ -1,9 +1,12 @@
+import com.android.build.gradle.internal.dsl.BaseAppModuleExtension
 import dev.love.winter.convention.configureComposeAndroid
 import dev.love.winter.convention.extension.implementation
 import dev.love.winter.convention.extension.libs
+import org.gradle.kotlin.dsl.getByType
 
-
-configureComposeAndroid()
+configureComposeAndroid(
+    commonExtension = extensions.getByType<BaseAppModuleExtension>(),
+)
 
 dependencies {
     implementation(libs.findLibrary("androidX-activityCompose"))

build-logic/convention/src/main/java/winter.compose.library.gradle.kts

@@ -1,3 +1,7 @@
+import com.android.build.gradle.LibraryExtension
 import dev.love.winter.convention.configureComposeAndroid
+import org.gradle.kotlin.dsl.getByType
 
-configureComposeAndroid()
+configureComposeAndroid(
+    commonExtension = extensions.getByType<LibraryExtension>(),
+)

config/detekt/detekt.yml

@@ -304,6 +304,8 @@ style:
     active: false
   BracesOnIfStatements:
     active: true
+  BracesOnWhenStatements:
+    active: true
   MandatoryBracesLoops:
     active: true
   MaxLineLength:

core-android/design-system/README.md

@@ -0,0 +1,76 @@
+# Design System
+
+## Overview
+
+This module provides the design system foundation for the LanguageStudy application, implementing a scalable and maintainable design token system. 
+It establishes a consistent visual language across the app through systematically organized design tokens and reusable components.
+
+## Responsibilities
+
+- Define design tokens (colors, typography, spacing, etc.) as code following industry best practices
+- Compose and maintain app themes with support for light and dark modes
+- Implement and maintain UI components built on top of design tokens
+- Provide foundation utilities for common design system needs
+
+# Design Tokens
+
+Design tokens are essential in creating and maintaining a consistent design language in our projects.
+They contain the values you'll use to construct Ul elements, such as colors, typography, spacing, border radius, and icons.
+
+## Primitive tokens
+
+> name-variant
+> primary-900
+
+The primitive tokens have a simple name structure with two levels: name and variation.
+
+## Component tokens
+
+> type-category-variant
+> color-background-band-subtle-...
+
+The component tokens are the ones applied in the interface and always inherit a primitive token. 
+The names of component tokens explain how they are used, 
+so they are composed of three levels: type, category, and variation. 
+It's possible to have more than one variation in the same token, like "brand-subtle".
+
+## Tokens
+
+- Colors
+- Typography
+- Spacing
+- BorderRadius
+- Icon
+
+# Module Structure
+
+```
+design-system/
+├── tokens/              # Design token definitions (primitive & component values)
+│   ├── ColorToken.kt
+│   ├── TypographyToken.kt
+│   └── IconToken.kt ...
+│
+├── theme/               # Theme aggregation (composing tokens into themes)
+│   ├── Theme.kt
+│   ├── Colors.kt
+│   ├── Typography.kt
+│   └── Icon.kt ...
+│
+├── foundation/           # Foundation utilities
+│   └── ModifierExtensions, Ripple 
+│
+└── component/           # UI components
+    ├── Button.kt
+    └── TextField.kt
+```
+
+## Package Descriptions
+
+- **tokens**: Raw design token values (colors, typography scales, spacing units)
+- **theme**: Aggregated theme objects accessible via `WinterTheme`
+- **foundation**: Core utilities and helpers for the design system
+- **component**: Reusable UI components built with design tokens
+
+# Usage
+

core-android/design-system/build.gradle.kts

@@ -0,0 +1,10 @@
+import dev.love.winter.convention.extension.setNamespace
+
+plugins {
+    id("winter.android.library")
+    id("winter.compose.library")
+}
+
+android {
+    setNamespace("designsystem")
+}

core-android/design-system/src/main/AndroidManifest.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+</manifest>

core-android/design-system/src/main/java/dev/love/winter/designsystem/theme/BorderRadius.kt

@@ -0,0 +1,34 @@
+package dev.love.winter.designsystem.theme
+
+import androidx.compose.runtime.Immutable
+import androidx.compose.runtime.staticCompositionLocalOf
+import androidx.compose.ui.graphics.Shape
+import dev.love.winter.designsystem.tokens.BorderRadiusExtraLarge
+import dev.love.winter.designsystem.tokens.BorderRadiusExtraSmall
+import dev.love.winter.designsystem.tokens.BorderRadiusLarge
+import dev.love.winter.designsystem.tokens.BorderRadiusMedium
+import dev.love.winter.designsystem.tokens.BorderRadiusPill
+import dev.love.winter.designsystem.tokens.BorderRadiusSmall
+
+@Immutable
+data class BorderRadius(
+    val extraSmall: Shape,
+    val small: Shape,
+    val medium: Shape,
+    val large: Shape,
+    val extraLarge: Shape,
+    val pill: Shape,
+)
+
+internal val BorderRadiusTheme = BorderRadius(
+    extraSmall = BorderRadiusExtraSmall,
+    small = BorderRadiusSmall,
+    medium = BorderRadiusMedium,
+    large = BorderRadiusLarge,
+    extraLarge = BorderRadiusExtraLarge,
+    pill = BorderRadiusPill,
+)
+
+internal val LocalBorderRadius = staticCompositionLocalOf {
+    BorderRadiusTheme
+}