@momo-kits/native-kits 0.158.1-beta.1-debug → 0.158.1-beta.2-debug

package/example/ios/Pods/Pods.xcodeproj/xcuserdata/sonnguyen.xcuserdatad/xcschemes/SDWebImage.xcscheme

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1600"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "3847153A6E5EEFB86565BA840768F429"
+               BuildableName = "SDWebImage.framework"
+               BlueprintName = "SDWebImage"
+               ReferencedContainer = "container:Pods.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

package/example/ios/Pods/Pods.xcodeproj/xcuserdata/sonnguyen.xcuserdatad/xcschemes/SDWebImageSwiftUI.xcscheme

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1600"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "92EBFA3E7005B4C18A9C0B44324EB80F"
+               BuildableName = "SDWebImageSwiftUI.framework"
+               BlueprintName = "SDWebImageSwiftUI"
+               ReferencedContainer = "container:Pods.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

package/example/ios/Pods/Pods.xcodeproj/xcuserdata/sonnguyen.xcuserdatad/xcschemes/SkeletonUI.xcscheme

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1600"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "6510766A9670BFA3B251E2A62446FC5D"
+               BuildableName = "SkeletonUI.framework"
+               BlueprintName = "SkeletonUI"
+               ReferencedContainer = "container:Pods.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

package/example/ios/Pods/Pods.xcodeproj/xcuserdata/sonnguyen.xcuserdatad/xcschemes/lottie-ios-LottiePrivacyInfo.xcscheme

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1600"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "BF2A15FEC3F3424BBC4B9AD5F86F2D54"
+               BuildableName = "LottiePrivacyInfo.bundle"
+               BlueprintName = "lottie-ios-LottiePrivacyInfo"
+               ReferencedContainer = "container:Pods.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

package/example/ios/Pods/Pods.xcodeproj/xcuserdata/sonnguyen.xcuserdatad/xcschemes/lottie-ios.xcscheme

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1600"
+   version = "1.3">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "0B967D7F8561D42493EE289EC8D450D1"
+               BuildableName = "Lottie.framework"
+               BlueprintName = "lottie-ios"
+               ReferencedContainer = "container:Pods.xcodeproj">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES">
+      <Testables>
+      </Testables>
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

package/example/ios/Pods/Pods.xcodeproj/xcuserdata/sonnguyen.xcuserdatad/xcschemes/xcschememanagement.plist

@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>SchemeUserState</key>
+	<dict>
+		<key>MoMoUIKits.xcscheme</key>
+		<dict>
+			<key>isShown</key>
+			<false />
+			<key>orderHint</key>
+			<integer>0</integer>
+		</dict>
+		<key>Pods-Example.xcscheme</key>
+		<dict>
+			<key>isShown</key>
+			<false />
+			<key>orderHint</key>
+			<integer>1</integer>
+		</dict>
+		<key>SDWebImage.xcscheme</key>
+		<dict>
+			<key>isShown</key>
+			<false />
+			<key>orderHint</key>
+			<integer>2</integer>
+		</dict>
+		<key>SDWebImageSwiftUI.xcscheme</key>
+		<dict>
+			<key>isShown</key>
+			<false />
+			<key>orderHint</key>
+			<integer>3</integer>
+		</dict>
+		<key>SkeletonUI.xcscheme</key>
+		<dict>
+			<key>isShown</key>
+			<false />
+			<key>orderHint</key>
+			<integer>4</integer>
+		</dict>
+		<key>lottie-ios-LottiePrivacyInfo.xcscheme</key>
+		<dict>
+			<key>isShown</key>
+			<false />
+			<key>orderHint</key>
+			<integer>5</integer>
+		</dict>
+		<key>lottie-ios.xcscheme</key>
+		<dict>
+			<key>isShown</key>
+			<false />
+			<key>orderHint</key>
+			<integer>6</integer>
+		</dict>
+	</dict>
+	<key>SuppressBuildableAutocreation</key>
+	<dict />
+</dict>
+</plist>

package/gradle.properties

@@ -18,7 +18,7 @@ kotlin.apple.xcodeCompatibility.nowarn=true
 name="ComposeKits"
 group=vn.momo.kits
 artifact.id=kits
-version=0.158.1-beta.1
+version=0.158.1-beta.2
 
 repo=GitLab
 url=https://gitlab.mservice.com.vn/api/v4/projects/5400/packages/maven

package/local.properties

@@ -4,5 +4,5 @@
 # Location of the SDK. This is only used by Gradle.
 # For customization when using a Version Control System, please read the
 # header note.
-#Mon Dec 22 10:07:29 ICT 2025
-sdk.dir=/Users/phuc/Library/Android/sdk
+#Tue Apr 08 11:13:31 ICT 2025
+sdk.dir=/Users/sonnguyen/Library/Android/sdk

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@momo-kits/native-kits",
-  "version": "0.158.1-beta.1-debug",
+  "version": "0.158.1-beta.2-debug",
   "private": false,
   "dependencies": {},
   "devDependencies": {},

package/.claude/settings.local.json

@@ -1,11 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(yarn react-native:*)",
-      "Read(//Users/phuc/.claude/skills/ai-skill-generator/**)",
-      "Bash(python3 scripts/install_skill.py --update)",
-      "Bash(cd /Users/phuc/momo-kits/.claude/skills/design-system-kits && mkdir -p .claude/skills/design-system-kits && mv SKILL.md README.md references .claude/skills/design-system-kits/)",
-      "Bash(mv .claude/skills/design-system-kits/* . && rmdir .claude/skills/design-system-kits && rmdir .claude/skills)"
-    ]
-  }
-}

package/.claude/skills/design-system/SKILL.md

@@ -1,88 +0,0 @@
----
-name: design-system
-description: Use this skill when designers need to create design specifications, usage guidelines, rules, or documentation for the MoMo KitX design system. Helps define visual specs, component usage rules, design patterns, and accessibility guidelines. Maps 1:1 with design-system-kits.
-
----
-
-## Prereqs
-- Read [references/spec-convention.md](references/spec-convention.md) before generating design specs
-
-## How to Use
-
-1. **Identify the task**: spec, guideline, rule, or pattern documentation
-2. **Find reference** in catalog tables below
-3. **Load reference file** for visual specs, usage rules, and guidelines
-4. **Generate documentation** with correct token names and component mapping
-
-## References
-
-### Design Tokens
-| File | Load when... |
-|------|-------------|
-| `references/tokens/colors.md` | Color usage rules, palette, accessibility |
-| `references/tokens/theme.md` | Light/dark theme specs, semantic colors |
-| `references/tokens/typography.md` | Type scale, hierarchy, pairing rules |
-| `references/tokens/spacing-radius.md` | Spacing system, radius, layout grid |
-
-### Components
-| File | Component | RN | Compose |
-|------|-----------|:--:|:------:|
-| `references/components/button.md` | Button | ✅ | ✅ |
-| `references/components/text.md` | Text | ✅ | ✅ |
-| `references/components/input.md` | Input | ✅ | ✅ |
-| `references/components/input-search.md` | InputSearch | ✅ | ✅ |
-| `references/components/input-text-area.md` | InputTextArea | ✅ | ✅ |
-| `references/components/input-dropdown.md` | InputDropDown | ✅ | ✅ |
-| `references/components/input-phone-number.md` | InputPhoneNumber | ✅ | ✅ |
-| `references/components/input-money.md` | InputMoney | ✅ | ✅ |
-| `references/components/input-otp.md` | InputOTP | ✅ | ✅ |
-| `references/components/checkbox.md` | CheckBox | ✅ | ✅ |
-| `references/components/radio.md` | Radio | ✅ | ✅ |
-| `references/components/switch.md` | Switch | ✅ | ✅ |
-| `references/components/icon.md` | Icon | ✅ | ✅ |
-| `references/components/image.md` | Image | ✅ | ✅ |
-| `references/components/badge.md` | Badge, BadgeDot | ✅ | ✅ |
-| `references/components/tag.md` | Tag | ✅ | ✅ |
-| `references/components/chip.md` | Chip | ✅ | ✅ |
-| `references/components/popup-notify.md` | PopupNotify | ✅ | ✅ |
-| `references/components/toast.md` | Toast | ✅ | ❌ |
-| `references/components/snackbar.md` | SnackBar | ✅ | ✅ |
-| `references/components/skeleton.md` | Skeleton | ✅ | ✅ |
-| `references/components/loader.md` | Loader | ✅ | ❌ |
-| `references/components/tooltip.md` | Tooltip | ✅ | ✅ |
-| `references/components/avatar.md` | Avatar | ✅ | ❌ |
-| `references/components/carousel.md` | Carousel | ✅ | ❌ |
-| `references/components/tab-view.md` | TabView | ✅ | ❌ |
-| `references/components/divider.md` | Divider | ✅ | ✅ |
-| `references/components/pagination.md` | Pagination | ✅ | ✅ |
-| `references/components/progress-info.md` | ProgressInfo | ✅ | ❌ |
-| `references/components/rating.md` | Rating | ✅ | ❌ |
-| `references/components/slider.md` | Slider | ✅ | ❌ |
-| `references/components/stepper.md` | Stepper | ✅ | ❌ |
-| `references/components/steps.md` | Steps | ✅ | ❌ |
-| `references/components/collapse.md` | Collapse | ✅ | ❌ |
-| `references/components/swipe.md` | Swipe | ✅ | ❌ |
-| `references/components/suggest-action.md` | SuggestAction | ✅ | ❌ |
-| `references/components/uploader.md` | Uploader | ✅ | ❌ |
-| `references/components/date-picker.md` | DatePicker | ✅ | ✅ |
-| `references/components/information.md` | Information | ✅ | ✅ |
-
-### Navigation
-| File | Load when... |
-|------|------------------------------------------------|
-| `references/navigation/setup.md` | Screen layout structure, containers |
-| `references/navigation/stack.md` | Screen header, scroll behavior |
-| `references/navigation/navigation-options.md` | Header title, background, right buttons |
-| `references/navigation/navigator.md` | Screen transitions, push/pop patterns |
-| `references/navigation/bottom-tab.md` | Bottom tab bar specs |
-| `references/navigation/modal.md` | Modal overlay patterns |
-| `references/navigation/bottomsheet.md` | Bottom sheet patterns |
-
-## Important Rules
-
-1. **Always use design tokens** — Never reference raw hex/px values without mapping to a token name
-2. **Component mapping** — Every visual element must map to a KitX component
-3. **State coverage** — Specs must define all states: default, pressed, disabled, error, loading
-4. **Accessibility** — Include contrast ratios (WCAG AA min), touch targets (44pt min), screen reader notes
-5. **Platform parity** — Note when specs differ between React Native and Compose Multiplatform
-6. **Bilingual** — Use English for specs, add Vietnamese labels (tieng Viet) where relevant for MoMo team

package/.claude/skills/design-system/references/components/avatar.md

@@ -1,134 +0,0 @@
-# Avatar
-
-> User/entity representation — profile photo, initials fallback, hoặc placeholder icon. Supports grouping.
-
-**Package:** `@momo-kits/avatar`
-**Platform:** RN ✅ | Compose ❌ (build with Image + Text)
-**Completeness:** need_update — thiếu Figma
-**Figma node:** [VERIFY]
-
----
-
-## Props
-
-| Prop | Type | Values | Default | Description |
-|------|------|--------|---------|-------------|
-| `source` | object | `{ uri: string }` | — | Image source. Khi `null`/error → fallback to initials hoặc placeholder |
-| `name` | string | — | — | Full name — dùng để generate initials fallback (first letter of first + last word) |
-| `size` | string | `"xxs"` \| `"xs"` \| `"s"` \| `"m"` \| `"l"` \| `"xl"` \| `"xxl"` | `"m"` | Avatar size. xxs=24dp, xs=28dp, s=32dp, m=40dp, l=48dp, xl=56dp, xxl=72dp [VERIFY] |
-| `shape` | string | `"circle"` \| `"square"` | `"circle"` | Avatar shape [VERIFY] |
-| `badge` | element | — | — | Optional Badge overlay (e.g., online indicator, verification) [VERIFY] |
-| `onPress` | function | — | — | Callback khi tap avatar. `"onPress": "navigate://Profile"` |
-
----
-
-## Variants
-
-| Variant | Display | Fallback Priority |
-|---------|---------|-------------------|
-| **Image** | Photo from `source.uri` | — |
-| **Initials** | 1-2 letter initials from `name` on colored background | When `source` is null or fails to load |
-| **Placeholder** | Generic person icon | When both `source` and `name` are absent |
-
-### Initials Background Colors
-
-Background color derived from `name` string hash — consistent color per user. Colors from predefined palette [VERIFY].
-
----
-
-## States
-
-| State | Appearance | Interactive |
-|-------|-----------|-------------|
-| **Image loaded** | Photo displayed, clipped to shape | per onPress |
-| **Loading** | Placeholder/shimmer while image loads | false |
-| **Error / No image** | Initials (if `name` provided) or generic icon | per onPress |
-
----
-
-## Avatar Group
-
-`AvatarGroup` renders multiple avatars overlapping horizontally.
-
-| Prop | Type | Values | Default | Description |
-|------|------|--------|---------|-------------|
-| `avatars` | array | `[{ source, name }]` | required | List of avatar data |
-| `max` | number | — | `3` | Maximum visible avatars. Overflow shown as `+N` circle [VERIFY] |
-| `size` | string | Same as Avatar | `"s"` | Size for all avatars in group |
-| `overlap` | number | dp value | `8` | Horizontal overlap between avatars [VERIFY] |
-
----
-
-## Variant-to-Context Map
-
-| Context | Khi nào dùng | Tránh khi | Ví dụ trong MoMo |
-|---------|-------------|-----------|-------------------|
-| **Profile display** | Show user identity in header, list, card | Decorative/non-user images | Avatar trên profile screen, chat list |
-| **Group display** | Show multiple participants | >5 visible → dùng list | Nhóm chia bill, nhóm chat |
-| **Placeholder** | User chưa upload ảnh | — | New user onboarding |
-
----
-
-## SSR Pattern
-
-### User Profile Row
-```json
-{
-  "id": "user_profile",
-  "type": "row",
-  "children": [
-    {
-      "component": "Avatar",
-      "props": {
-        "source": { "uri": "{{data.user.avatarUrl}}" },
-        "name": "{{data.user.fullName}}",
-        "size": "l"
-      },
-      "onPress": "navigate://Profile"
-    },
-    {
-      "component": "Text",
-      "props": {
-        "content": "{{data.user.fullName}}",
-        "typography": "body_default_bold"
-      }
-    }
-  ]
-}
-```
-
-### Avatar Group
-```json
-{
-  "component": "AvatarGroup",
-  "props": {
-    "avatars": "{{data.participants}}",
-    "max": 3,
-    "size": "s"
-  }
-}
-```
-
----
-
-## Accessibility
-
-- Announce avatar as: "Avatar of [name]" hoặc "Profile photo".
-- Initials fallback announce full name, not just letters.
-- onPress → announce as button with label.
-
----
-
-## Usage Guidelines
-
-### Do
-- Dùng cho user/entity representation.
-- Always provide `name` — ensures initials fallback khi image fails.
-- Consistent sizing within same list/context.
-- AvatarGroup cho participant previews.
-
-### Don't
-- Không dùng cho product/brand images → dùng **Image** component.
-- Không dùng square shape cho user profiles — circle là standard.
-- Không dùng xxl trong lists — only for profile screens.
-- Không show >5 avatars inline → dùng AvatarGroup with `max`.