@momo-kits/native-kits 0.157.1-skill.1 → 0.157.1-skill.3-debug

package/.claude/momo-native-kits/references/InputPhoneNumber.md

@@ -1,175 +0,0 @@
----
-name: input-phone-number
-description: Phone number input with automatic +84 prefix. Use when collecting Vietnamese phone numbers.
----
-
-# InputPhoneNumber
-
-Phone number input field with automatic +84 country code prefix and Vietnam flag icon.
-
-## API
-
-```kotlin
-@Composable
-fun InputPhoneNumber(
-    text: MutableState<String> = remember { mutableStateOf("") },
-    placeholder: String = "0123456789",
-    size: InputPhoneNumberSize = InputPhoneNumberSize.SMALL,
-    onChangeText: (String) -> Unit = {},
-    hintText: String = "",
-    error: String = "",
-    errorSpacing: Boolean = false,
-    icon: String = "",
-    iconColor: Color = AppTheme.current.colors.text.default,
-    onRightIconPressed: () -> Unit = {},
-    onFocus: () -> Unit = {},
-    onBlur: () -> Unit = {},
-    loading: Boolean = false,
-    modifier: Modifier = Modifier,
-    inputModifier: Modifier = Modifier,
-)
-```
-
-## Props
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `text` | `MutableState<String>` | `""` | Current text value (required) |
-| `placeholder` | `String` | `"0123456789"` | Placeholder text |
-| `size` | `InputPhoneNumberSize` | `SMALL` | Input height |
-| `onChangeText` | `(String) -> Unit` | `{}` | Text change callback |
-| `hintText` | `String` | `""` | Hint text below input |
-| `error` | `String` | `""` | Error message |
-| `errorSpacing` | `Boolean` | `false` | Show spacing for error |
-| `icon` | `String` | `""` | Right icon name |
-| `iconColor` | `Color` | default color | Right icon color |
-| `onRightIconPressed` | `() -> Unit` | `{}` | Right icon click |
-| `onFocus` | `() -> Unit` | `{}` | Focus callback |
-| `onBlur` | `() -> Unit` | `{}` | Blur callback |
-| `loading` | `Boolean` | `false` | Loading spinner |
-| `modifier` | `Modifier` | `Modifier` | Outer modifier |
-| `inputModifier` | `Modifier` | `Modifier` | Input field modifier |
-
-## InputPhoneNumberSize
-
-| Size | Height | Text Style | Divider Height |
-|------|--------|------------|----------------|
-| `SMALL` | 48dp | headerSSemibold | 24dp |
-| `LARGE` | 56dp | headerMBold | 32dp |
-
-## Features
-
-- **Auto +84 prefix**: Automatically adds "+84" country code prefix
-- **Vietnam flag**: Shows Vietnam flag icon next to country code
-- **Number-only keyboard**: Automatically uses numeric keyboard
-- **Auto-clear**: Shows clear button when focused with text
-
-## Examples
-
-### Basic Usage
-
-```kotlin
-val phone = remember { mutableStateOf("") }
-
-InputPhoneNumber(
-    text = phone,
-    onChangeText = { phone.value = it }
-)
-```
-
-### With Placeholder
-
-```kotlin
-val phone = remember { mutableStateOf("") }
-
-InputPhoneNumber(
-    text = phone,
-    placeholder = "Enter phone number",
-    onChangeText = { phone.value = it }
-)
-```
-
-### With Error
-
-```kotlin
-val phone = remember { mutableStateOf("") }
-
-InputPhoneNumber(
-    text = phone,
-    error = "Invalid phone number",
-    errorSpacing = true,
-    onChangeText = { phone.value = it }
-)
-```
-
-### Sizes
-
-```kotlin
-// Small (default - 48dp)
-InputPhoneNumber(
-    text = phone,
-    size = InputPhoneNumberSize.SMALL,
-    onChangeText = { phone.value = it }
-)
-
-// Large (56dp)
-InputPhoneNumber(
-    text = phone,
-    size = InputPhoneNumberSize.LARGE,
-    onChangeText = { phone.value = it }
-)
-```
-
-### With Right Icon
-
-```kotlin
-InputPhoneNumber(
-    text = phone,
-    icon = "close",
-    onRightIconPressed = { phone.value = "" },
-    onChangeText = { phone.value = it }
-)
-```
-
-### Focus Callbacks
-
-```kotlin
-InputPhoneNumber(
-    text = phone,
-    onFocus = { /* show keyboard */ },
-    onBlur = { /* validate phone */ },
-    onChangeText = { phone.value = it }
-)
-```
-
-### Loading State
-
-```kotlin
-InputPhoneNumber(
-    text = phone,
-    loading = true,
-    onChangeText = { phone.value = it }
-)
-```
-
-### Hint Text
-
-```kotlin
-InputPhoneNumber(
-    text = phone,
-    hintText = "Enter 10-digit phone number",
-    onChangeText = { phone.value = it }
-)
-```
-
-## How It Works
-
-1. User types 9 digits (e.g., "912345678")
-2. Component automatically prepends "+84" (e.g., "+84912345678")
-3. Display shows: "+84 912 345 678" (formatted)
-
-## Auto-Clear Behavior
-
-When focused with text:
-- Clear icon appears on the right
-- Clicking clears the text and triggers `onChangeText("")`

package/.claude/momo-native-kits/references/InputSearch.md

@@ -1,57 +0,0 @@
----
-name: input-search
-description: Search input with built-in search icon and clear button. Use when implementing search functionality.
----
-
-# InputSearch
-
-Search input with built-in search icon and clear button.
-
-## Keywords
-
-search, tìm kiếm, ô tìm kiếm
-
-## API
-
-```kotlin
-@Composable
-fun InputSearch(
-    inputSearchProps: InputSearchProps = InputSearchProps(
-        text = remember { mutableStateOf("") }
-    ),
-)
-
-data class InputSearchProps(
-    val text: MutableState<String>,
-    val placeholder: String = "",
-    val onChangeText: (String) -> Unit = {},
-    val onClearPress: () -> Unit = {},
-    val loading: Boolean = false,
-    val disabled: Boolean = false,
-    val buttonText: String = "",
-    val showButtonText: Boolean = false,
-    // ... more options
-)
-```
-
-## Features
-
-- Built-in search icon
-- Auto clear button when focused with text
-- Loading state support
-- Custom right icon support
-
-## Examples
-
-```kotlin
-val searchText = remember { mutableStateOf("") }
-
-InputSearch(
-    inputSearchProps = InputSearchProps(
-        text = searchText,
-        placeholder = "Search...",
-        onChangeText = { searchText.value = it },
-        onClearPress = { searchText.value = "" }
-    )
-)
-```

package/.claude/momo-native-kits/references/InputTextArea.md

@@ -1,46 +0,0 @@
----
-name: input-text-area
-description: Multi-line text area input. Use when user needs to enter longer text descriptions.
----
-
-# InputTextArea
-
-Multi-line text area input.
-
-## Keywords
-
-textarea, text area, mô tả, description, nhập mô tả
-
-## API
-
-```kotlin
-@Composable
-fun InputTextArea(
-    text: MutableState<String>,
-    floatingValue: String = "",
-    placeholder: String = "",
-    maxLength: Int = 300,
-    onChangeText: (String) -> Unit = {},
-    error: String = "",
-)
-```
-
-## Features
-
-- Multi-line input
-- Character count display (e.g., "50/300")
-- Max length enforcement
-
-## Examples
-
-```kotlin
-val description = remember { mutableStateOf("") }
-
-InputTextArea(
-    text = description,
-    floatingValue = "Description",
-    placeholder = "Enter description...",
-    maxLength = 300,
-    onChangeText = { description.value = it }
-)
-```

package/.claude/momo-native-kits/references/NavigationContainer.md

@@ -1,51 +0,0 @@
----
-name: navigation-container
-description: Entry point for Compose screens. Use when setting up the main container for a Compose-based screen.
----
-
-# NavigationContainer
-
-Entry point for Compose screens.
-
-## Keywords
-
-navigation, container, screen, màn hình
-
-## API
-
-```kotlin
-@Composable
-fun NavigationContainer(
-    initialScreen: @Composable () -> Unit,
-    options: NavigationOptions? = null,
-    initialTheme: Theme = defaultTheme,
-    applicationContext: MiniAppContext? = null,
-    maxApi: IMaxApi? = null,
-    setNavigator: ((Navigator) -> Unit)? = null,
-    statusBarHeight: Dp? = null,
-    config: KitConfig? = null,
-    language: String? = null
-)
-```
-
-## Parameters
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `initialScreen` | `@Composable () -> Unit` | Initial screen |
-| `options` | `NavigationOptions?` | Navigation options |
-| `maxApi` | `IMaxApi?` | Required for native features |
-| `config` | `KitConfig?` | UI configuration |
-| `language` | `String?` | Current language |
-
-## Examples
-
-```kotlin
-NavigationContainer(
-    initialScreen = { HomeScreen() },
-    maxApi = maxApi,
-    config = config,
-    language = language,
-    setNavigator = { navigator = it }
-)
-```

package/.claude/momo-native-kits/references/Navigator.md

@@ -1,287 +0,0 @@
----
-name: navigator
-description: Class for managing navigation between screens. Use when navigating between screens, showing modals, bottom sheets, or snackbars.
----
-
-# Navigator
-
-Class for managing navigation between screens, modals, bottom sheets, and snackbars.
-
-## API
-
-```kotlin
-class Navigator(
-    private val navController: NavController,
-    private val maxApi: IMaxApi?
-)
-```
-
-## Methods
-
-### Screen Navigation
-
-| Method | Parameters | Description |
-|--------|------------|-------------|
-| `push` | `content: @Composable () -> Unit, options: NavigationOptions? = null` | Push new screen to stack |
-| `replace` | `content: @Composable () -> Unit, options: NavigationOptions? = null` | Replace current screen |
-| `pop` | `count: Int = 1, callBack: (() -> Unit)? = null` | Pop N screens from stack |
-| `present` | `content: @Composable () -> Unit, options: NavigationOptions? = null` | Present as dialog |
-| `reset` | `content: @Composable () -> Unit, options: NavigationOptions? = null` | Reset to new screen (clear stack) |
-| `onBackSafe` | `callBack: (() -> Unit)? = null` | Handle back with optional callback |
-
-### Overlay Components
-
-| Method | Parameters | Description |
-|--------|------------|-------------|
-| `showModal` | `content, barrierDismissible = true, onDismiss = null` | Show modal overlay |
-| `showBottomSheet` | `content, isSurface, barrierDismissible, onDismiss, bottomSheetHeader` | Show bottom sheet |
-| `showSnackBar` | `snackBar: SnackBar, onDismiss = null` | Show snackbar notification |
-| `hideSnackBar` | - | Hide current snackbar |
-
-## NavigationOptions
-
-```kotlin
-data class NavigationOptions(
-    val headerBackProps: HeaderBackProps? = null,
-    val onBackHandler: (() -> Unit)? = null,
-    // ... other options
-)
-```
-
-## Usage
-
-### Get Navigator Instance
-
-```kotlin
-// From NavigationContainer
-NavigationContainer(
-    initialScreen = { MyScreen() },
-    setNavigator = { navigator = it }
-)
-
-// Or use composition local
-val navigator = Navigator.current
-```
-
-### Push Screen
-
-```kotlin
-// Simple push
-navigator.push { MyScreen() }
-
-// With options
-navigator.push(
-    content = { DetailScreen(productId) },
-    options = NavigationOptions(
-        headerBackProps = HeaderBackProps(
-            title = "Product Details",
-            preventBack = PreventBackConfirm(
-                primary = PopupAction(title = "Leave", onPress = { })
-            )
-        )
-    )
-)
-```
-
-### Replace Screen
-
-```kotlin
-// Replace current screen (pops then pushes)
-navigator.replace { NewScreen() }
-```
-
-### Pop Screen
-
-```kotlin
-// Pop 1 screen
-navigator.pop()
-
-// Pop 2 screens
-navigator.pop(2)
-
-// Pop with callback
-navigator.pop(1) {
-    // Called after pop completes
-}
-```
-
-### Present Dialog
-
-```kotlin
-navigator.present {
-    DialogContent()
-}
-```
-
-### Reset Stack
-
-```kotlin
-// Clear all screens and navigate to new screen
-navigator.reset { HomeScreen() }
-```
-
-### Safe Back Handler
-
-```kotlin
-// Handle back with confirmation if needed
-navigator.onBackSafe {
-    // Callback after back completes
-}
-```
-
-## BottomSheet
-
-```kotlin
-// Simple bottom sheet
-navigator.showBottomSheet(
-    content = { MyContent() }
-)
-
-// With header
-navigator.showBottomSheet(
-    content = { MyContent() },
-    bottomSheetHeader = BottomHeader.Title("Select Option")
-)
-
-// Surface style (different background)
-navigator.showBottomSheet(
-    content = { MyContent() },
-    isSurface = true
-)
-
-// Not dismissible
-navigator.showBottomSheet(
-    content = { MyContent() },
-    barrierDismissible = false,
-    onDismiss = { /* handle dismiss */ }
-)
-```
-
-## BottomHeader
-
-```kotlin
-// Title header
-BottomHeader.Title("Title")
-
-// Custom header
-BottomHeader.Custom {
-    MyHeaderContent()
-}
-```
-
-## Modal
-
-```kotlin
-// Simple modal
-navigator.showModal(
-    content = { MyModalContent() }
-)
-
-// Not dismissible
-navigator.showModal(
-    content = { MyModalContent() },
-    barrierDismissible = false,
-    onDismiss = { /* handle dismiss */ }
-)
-```
-
-## SnackBar
-
-```kotlin
-// Success snackbar
-navigator.showSnackBar(
-    snackBar = SnackBar(
-        message = "Saved successfully",
-        type = SnackBar.Type.SUCCESS
-    )
-)
-
-// Error snackbar
-navigator.showSnackBar(
-    snackBar = SnackBar(
-        message = "Something went wrong",
-        type = SnackBar.Type.ERROR
-    )
-)
-
-// Info snackbar
-navigator.showSnackBar(
-    snackBar = SnackBar(
-        message = "Processing...",
-        type = SnackBar.Type.INFO
-    )
-)
-
-// With action button
-navigator.showSnackBar(
-    snackBar = SnackBar(
-        message = "Item deleted",
-        action = SnackBar.Action(
-            title = "UNDO",
-            onPress = { /* undo */ }
-        )
-    )
-)
-
-// Hide snackbar
-navigator.hideSnackBar()
-```
-
-## SnackBar Type
-
-| Type | Description |
-|------|-------------|
-| `SUCCESS` | Green color, success messages |
-| `ERROR` | Red color, error messages |
-| `INFO` | Default color, informational |
-| `WARNING` | Warning messages |
-
-## Common Patterns
-
-### Navigate with Result
-
-```kotlin
-// Push screen and handle result
-navigator.push {
-    SelectScreen(
-        onResult = { selected ->
-            // Handle result
-            navigator.pop()
-        }
-    )
-}
-```
-
-### Confirm Before Back
-
-```kotlin
-navigator.push(
-    content = { EditScreen() },
-    options = NavigationOptions(
-        onBackHandler = {
-            showUnsavedChangesDialog()
-        },
-        headerBackProps = HeaderBackProps(
-            preventBack = PreventBackConfirm(
-                primary = PopupAction(
-                    title = "Discard",
-                    onPress = { navigator.pop() }
-                )
-            )
-        )
-    )
-)
-```
-
-### Nested Navigation
-
-```kotlin
-// Present login as modal
-navigator.present {
-    LoginScreen(
-        onSuccess = {
-            navigator.pop()
-        }
-    )
-}
-```

package/.claude/momo-native-kits/references/PaginationDot.md

@@ -1,28 +0,0 @@
----
-name: pagination-dot
-description: Pagination component showing dots. Use when implementing carousel-style pagination.
----
-
-# PaginationDot
-
-Pagination component showing dots.
-
-## Keywords
-
-pagination dots, dot pagination
-
-## API
-
-```kotlin
-@Composable
-fun PaginationDot(
-    activeIndex: Int = 0,
-    dataLength: Int = 3
-)
-```
-
-## Examples
-
-```kotlin
-PaginationDot(activeIndex = currentPage, dataLength = totalPages)
-```

package/.claude/momo-native-kits/references/PaginationNumber.md

@@ -1,28 +0,0 @@
----
-name: pagination-number
-description: Pagination component showing page numbers. Use when displaying current page position (e.g., "1/5").
----
-
-# PaginationNumber
-
-Pagination component showing page numbers.
-
-## Keywords
-
-pagination, page, trang
-
-## API
-
-```kotlin
-@Composable
-fun PaginationNumber(
-    activeIndex: Int = 0,
-    dataLength: Int = 2
-)
-```
-
-## Examples
-
-```kotlin
-PaginationNumber(activeIndex = 0, dataLength = 5) // Shows "1/5"
-```

package/.claude/momo-native-kits/references/PopupNotify.md

@@ -1,47 +0,0 @@
----
-name: popup-notify
-description: Confirm popup component. Use when showing confirmation dialogs, warnings, or alert popups.
----
-
-# PopupNotify
-
-Confirm popup component.
-
-## Keywords
-
-popup, confirm, xác nhận, thông báo
-
-## API
-
-```kotlin
-@Composable
-fun PopupNotify(
-    title: String = "",
-    content: String = "",
-    primary: PopupAction? = null,
-    secondary: PopupAction? = null,
-    type: PopupNotifyType = PopupNotifyType.DEFAULT
-)
-
-data class PopupAction(
-    val title: String,
-    val onPress: (() -> Unit)? = null,
-    val type: PopupActionType = PopupActionType.PRIMARY
-)
-
-enum class PopupNotifyType { DEFAULT, WARNING, ERROR }
-enum class PopupActionType { PRIMARY, SECONDARY }
-```
-
-## Examples
-
-```kotlin
-navigator.showModal {
-    PopupNotify(
-        title = "Confirm",
-        content = "Are you sure?",
-        primary = PopupAction(title = "Confirm", onClick = { }),
-        secondary = PopupAction(title = "Cancel", type = PopupActionType.SECONDARY)
-    )
-}
-```