@herca/rn-kit 0.1.7 → 0.1.8

package/lib/module/DropDown/README.md

@@ -1 +1,108 @@
 # Dropdown
+
+**Dropdown** merupakan komponen menu pilihan (select) berbasis **React Native** yang menampilkan daftar opsi di atas modal transparan. Komponen ini otomatis men‐posisikan daftar ke kiri atau ke kanan bergantung pada posisi tombol pemicu agar tidak terpotong layar.
+
+---
+
+## Instalasi
+
+Komponen ini mengandalkan dependensi internal:
+
+* `Color` – sistem warna.
+* `ChipOptionProps` – tipe opsi.
+
+Serta modul standar React Native: `Modal`, `ScrollView`, dll. Tidak memerlukan library eksternal.
+
+---
+
+## API Reference
+
+| Prop           | Tipe                                | Default     | Deskripsi                                                           |
+| -------------- | ----------------------------------- | ----------- | ------------------------------------------------------------------- |
+| `options`      | `ChipOptionProps[]`                 | `[]`        | Daftar objek `{ label, value }` yang akan ditampilkan sebagai opsi. |
+| `maxHeight`    | `number`                            | `200`       | Tinggi maksimum daftar sebelum dapat di‐scroll.                     |
+| `onSelect`     | `(value: string \| number) => void` | `undefined` | Callback saat pengguna memilih opsi.                                |
+| `renderButton` | `React.ReactNode`                   | **(wajib)** | Elemen yang dipakai sebagai tombol pemicu dropdown.                 |
+
+### Struktur `ChipOptionProps`
+
+```ts
+interface ChipOptionProps {
+  label: string;
+  value: string | number;
+}
+```
+
+---
+
+## Cara Kerja Singkat
+
+1. **Posisi & Alignment**
+
+   * Saat tombol ditekan, komponen mengukur posisi tombol (`UIManager.measureInWindow`).
+   * Jika titik tengah tombol berada di sisi kanan layar, daftar disejajarkan ke kanan; sebaliknya ke kiri.
+2. **Modal & Pressable Overlay**
+
+   * Daftar opsi dibungkus `Modal` transparan.
+   * `Pressable` penuh layar di belakang daftar menangani klik di luar untuk menutup menu.
+3. **Scroll & Batas Tinggi**
+
+   * Daftar opsi di dalam `ScrollView` dengan properti `nestedScrollEnabled` agar tetap dapat di‐scroll di dalam modalsheet lain.
+4. **Highlight Opsi Terpilih**
+
+   * Opsi aktif diberi style `optionSelected` – background `Color.primary[50]` & border `Color.primary[300]`.
+
+---
+
+## Contoh Penggunaan
+
+```tsx
+import { useState } from 'react';
+import { View, Text } from 'react-native';
+import Dropdown from '@/components/Dropdown/Dropdown';
+
+const options = [
+  { label: 'Apple', value: 'apple' },
+  { label: 'Banana', value: 'banana' },
+  { label: 'Cherry', value: 'cherry' },
+];
+
+export default function DropdownExample() {
+  const [fruit, setFruit] = useState<string | number>('apple');
+
+  return (
+    <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
+      <Dropdown
+        options={options}
+        maxHeight={150}
+        onSelect={(val) => setFruit(val)}
+        renderButton={
+          <View style={{ padding: 12, borderWidth: 1, borderRadius: 8 }}>
+            <Text>{options.find((o) => o.value === fruit)?.label}</Text>
+          </View>
+        }
+      />
+    </View>
+  );
+}
+```
+
+---
+
+## Kustomisasi Tampilan
+
+| Style Key        | Fungsi                 | Cara Ubah                                         |
+| ---------------- | ---------------------- | ------------------------------------------------- |
+| `dropdownList`   | Container daftar opsi. | Ubah `width`, `borderRadius`, `borderColor`, dll. |
+| `option`         | Setiap baris opsi.     | Ubah `padding` atau `gap` sesuai kebutuhan.       |
+| `optionSelected` | Style opsi terpilih.   | Sesuaikan warna highlight dengan brand.           |
+
+---
+
+## Tips Implementasi
+
+* **Kontrol Render Button**: Anda bebas menggunakan komponen apa pun sebagai `renderButton` (ikon, input field, card, dll.). Dropdown akan menggunakan posisi & ukuran elemen ini.
+* **Close on Scroll Parent**: Jika dropdown dipakai dalam layar yang di‐scroll, pertimbangkan menutup dropdown saat parent di‐scroll untuk mencegah posisi meleset.
+* **Validasi**: Komponen tidak memaksa nilai default. Anda dapat men‐set `selected` manual via `useState` agar kontrol tetap ter‐sinkron.
+
+---

package/lib/module/Label/README.md

@@ -0,0 +1,65 @@
+# Label
+
+**Label** adalah komponen kecil berbentuk badge untuk menampilkan status, kategori, atau metadata ringkas. Komponen ini mendukung ikon, variasi warna, dan konten kustom.
+
+## API Reference
+
+| Prop       | Tipe                                                                                             | Default     | Deskripsi                                                                      |
+| ---------- | ------------------------------------------------------------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |
+| `label`    | `string`                                                                                         | `''`        | Teks yang ditampilkan jika `children` tidak disediakan.                        |
+| `children` | `React.ReactNode`                                                                                | `undefined` | Menampilkan elemen kustom sebagai isi label. Jika ada, `label` akan diabaikan. |
+| `color`    | `'default' \| 'success' \| 'danger' \| 'primary' \| 'warning' \| 'info' \| 'purple' \| 'orange'` | `'default'` | Variasi warna latar dan teks.                                                  |
+| `icon`     | `IconNameProps`                                                                                  | `undefined` | Menampilkan ikon di sebelah kiri teks.                                         |
+| `size`     | `'small' \| 'medium'`                                                                            | `'medium'`  | (Belum digunakan – untuk ekspansi ukuran ke depan.)                            |
+
+---
+
+## Warna yang Didukung
+
+| Warna     | Background          | Teks                 |
+| --------- | ------------------- | -------------------- |
+| `default` | `Color.gray[50]`    | `Color.gray[900]`    |
+| `success` | `Color.success[50]` | `Color.success[300]` |
+| `danger`  | `Color.danger[50]`  | `Color.danger[300]`  |
+| `primary` | `Color.primary[50]` | `Color.primary[300]` |
+| `warning` | `Color.warning[50]` | `Color.warning[300]` |
+| `info`    | `Color.info[50]`    | `Color.info[300]`    |
+| `purple`  | `Color.purple[50]`  | `Color.purple[300]`  |
+| `orange`  | `Color.orange[50]`  | `Color.orange[300]`  |
+
+---
+
+## Contoh Penggunaan
+
+### Label Sederhana
+
+```tsx
+<Label label="Active" color="success" />
+```
+
+### Label dengan Ikon
+
+```tsx
+<Label label="Error" color="danger" icon="AlertCircle" />
+```
+
+### Kustom Isi (Children)
+
+```tsx
+<Label color="primary">
+  <View style={{ flexDirection: 'row', alignItems: 'center' }}>
+    <Icon name="Check" color={Color.primary[300]} size={12} />
+    <Text style={{ color: Color.primary[300], marginLeft: 4 }}>Custom</Text>
+  </View>
+</Label>
+```
+
+---
+
+## Catatan Tambahan
+
+* Jika Anda memberikan `children`, maka `label` dan `icon` akan diabaikan.
+* Komponen ini menggunakan `alignSelf: 'flex-start'` agar ukuran label tidak penuh.
+* Prop `size` belum aktif, namun sudah disiapkan jika ke depan ingin mendukung skala `small`/`large`.
+
+---

package/lib/module/RadioButton/README.md

@@ -1,7 +1,8 @@
 # 📦 RadioButton – Komponen React Native
 
 Komponen `RadioButton` ini digunakan untuk menampilkan daftar pilihan dalam bentuk radio button di aplikasi React Native.
-![Deskripsi Alt](../../assets/doc/RadioButton/RadioButton.png)
+<img src="../../assets/doc/RadioButton/RadioButton.png" width=200>
+
 
 ## 📄 Import
 

package/lib/module/Ui/README_DEVIDER.md

@@ -0,0 +1,62 @@
+# Divider
+
+**Divider** adalah komponen garis horizontal sederhana yang digunakan untuk memisahkan konten secara visual dalam antarmuka pengguna.
+
+---
+
+## Instalasi
+
+Komponen ini tidak memerlukan dependensi eksternal. Hanya menggunakan:
+
+* `Color` – untuk warna garis.
+* `View` dan `StyleSheet` dari `react-native`.
+
+---
+
+## API Reference
+
+Tidak memiliki properti (props) khusus. Komponen ini dapat digunakan langsung dan bisa dikustomisasi melalui `style` eksternal jika diperlukan.
+
+---
+
+## Contoh Penggunaan
+
+### Divider Default
+
+```tsx
+import Divider from '@/components/Divider/Divider';
+
+<View>
+  <Text>Bagian Atas</Text>
+  <Divider />
+  <Text>Bagian Bawah</Text>
+</View>
+```
+
+### Divider dengan Margin
+
+```tsx
+<View style={{ marginVertical: 12 }}>
+  <Divider />
+</View>
+```
+
+### Divider yang Dikustomisasi
+
+```tsx
+<Divider style={{ backgroundColor: 'red', height: 2 }} />
+```
+
+> Catatan: Untuk mengubah gaya `Divider`, bungkus komponen dengan `View` tambahan atau tambahkan prop `style` melalui wrapper jika perlu.
+
+---
+
+## Style Default
+
+```ts
+{
+  height: 1,
+  backgroundColor: Color.gray[200],
+}
+```
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herca/rn-kit",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "React Native UI Kit",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/Accordion/README.md

@@ -1,6 +1,7 @@
 # 📂 Accordion
 
 Komponen **Accordion** digunakan untuk menyembunyikan atau menampilkan konten secara dinamis. Biasanya digunakan untuk struktur seperti FAQ atau daftar konten bertingkat.
+
 <img src="../../assets/doc/Accordion/Accordion.gif" alt="Deskripsi Alt" width="200" />
 
 ## 📦 USAGE

package/src/Alert/README.md

@@ -1,6 +1,7 @@
 # 📢 Alert Component
 
 Komponen `Alert` digunakan untuk menampilkan pesan notifikasi dengan ikon, judul, dan pesan yang dapat dikustomisasi warnanya sesuai konteks (seperti *success*, *info*, *warning*, dll).
+
 <img src="../../assets/doc/Alert/Alert.png" alt="Deskripsi Alt" width="200" />
 
 ## ✨ Fitur

package/src/Avatar/README_AVATAR.md

@@ -1,7 +1,7 @@
 # 🧑‍🎨 Avatar Component
 
 Komponen `Avatar` digunakan untuk menampilkan foto pengguna atau inisial nama jika foto tidak tersedia.
-![Deskripsi Alt](../../assets/doc/Avatar/Avatar.png)
+<img src="../../assets/doc/Avatar/Avatar.png" width=200>
 
 ## ✨ Fitur
 

package/src/Avatar/README_AVATARGROUP.md

@@ -2,7 +2,9 @@
 # AvatarGroup Component (React Native)
 
 The `AvatarGroup` component displays a group of user avatars. It supports image avatars, initials-based avatars, and a fallback icon. If there are more avatars than the maximum visible count, it displays a "+X" bubble.
-![Deskripsi Alt](../../assets/doc/Avatar/AvatarGroup.png)
+
+<img src="../../assets/doc/Avatar/AvatarGroup.png" width=200>
+
 ---
 
 ## 📦 Props

package/src/BottomSheet/README.md

@@ -1,8 +1,8 @@
 # ⬆️ BottomSheet Component
 
 Komponen `BottomSheet` adalah modal bawah (slide-up) untuk menampilkan konten dinamis, form, konfirmasi, dll, dengan berbagai fitur interaktif seperti gesture drag, keyboard-aware, dan customizable height.
-![Deskripsi Alt](../../assets/doc/BottomSheet/BottomSheet.gif)
 
+<img src="../../assets/doc/BottomSheet/BottomSheet.gif" width=200>
 ---
 
 ## 📦 Props

package/src/Button/README.md

@@ -2,7 +2,9 @@
 # 🔘 Komponen Button (React Native)
 
 Komponen `Button` ini adalah tombol serbaguna untuk aplikasi React Native. Mendukung berbagai ukuran, varian, warna, dan status seperti `disabled` dan `loading`.
-![Deskripsi Alt](../../assets/doc/Button/Button.png)
+
+
+<img src="../../assets/doc/Button/Button.png" width=200>
 
 ---
 

package/src/Calendar/README.md

@@ -1,6 +1,7 @@
 # 📆 Komponen Kalender Kustom (React Native)
 
 Komponen kalender ini dibuat menggunakan React Native dan memungkinkan pengguna untuk memilih tanggal tunggal maupun rentang tanggal, serta mendukung fitur penandaan dan pembatasan tanggal.
+<img src="../../assets/doc/Calendar/Calendar.png" width=200>
 
 ---
 

package/src/Chip/README.md

@@ -1,7 +1,8 @@
 # 📦 Komponen `Chip` – React Native
 
 Komponen `Chip` digunakan untuk menampilkan daftar pilihan seperti tag, filter, atau kategori dalam bentuk tombol kecil (chip). Komponen ini mendukung pilihan tunggal maupun jamak, arah horizontal/vertikal, dan gaya warna yang dapat disesuaikan.
-![Deskripsi Alt](../../assets/doc/Chip/Chip.png)
+
+<img src="../../assets/doc/Chip/Chip.png" width=200>
 
 ---
 

package/src/Color/README.md

@@ -1,54 +1,105 @@
-# 📦 Konstanta: Color
-Konstanta Color berisi daftar token warna yang digunakan untuk styling antarmuka aplikasi menggunakan React Native. Warna-warna ini disusun berdasarkan tema dan gradasi, cocok digunakan bersama desain sistem seperti Design Token.
+# Color Palette
+
+Berikut adalah definisi warna yang digunakan di design system React Native Anda. Palette mencakup warna dasar (*base*), skala abu‐abu (*gray*), kategori semantik (*primary*, *success*, *danger*, *warning*, *info*, *orange*, *purple*), serta utilitas lain seperti `divider` dan `disabled`.
+
+Warna tersimpan dalam objek `Color` dengan struktur hierarkis seperti contoh berikut:
+
+```ts
+Color.primary[500] // -> "#4D46FF"
+Color.gray[200]   // -> "#EBEBEB"
+```
+
+---
+
+## Struktur Objek Color
+
+```ts
+const Color = {
+  base: { ... },
+  gray: { ... },
+  primary: { ... },
+  warning: { ... },
+  danger: { ... },
+  success: { ... },
+  info: { ... },
+  orange: { ... },
+  purple: { ... },
+  divider: { ... },
+  disabled: { ... },
+  shadow: { ... },
+};
+```
+
+### Skema Skala Warna
+
+* **0–1000** (atau 0–950) – Semakin besar angka, semakin gelap warna.
+* **50** – Latar paling terang (sering dipakai untuk *background* highlight).
+* **500** – Warna utama (brand color dan teks link normal).
+* **700/800/900** – Warna paling gelap untuk teks di atas latar berkait.
+
+---
+
+## Tabel Ringkasan
+
+| Kategori   | Contoh Penggunaan     | Keterangan                                  |
+| ---------- | --------------------- | ------------------------------------------- |
+| `base`     | `Color.base.white100` | Warna putih/ hitam utama UI dasar.          |
+| `gray`     | `Color.gray[700]`     | Teks, ikon sekunder, border netral.         |
+| `primary`  | `Color.primary[500]`  | Aksi utama, tombol brand, ikon utama.       |
+| `success`  | `Color.success[500]`  | Status berhasil: label “Success”, badge OK. |
+| `danger`   | `Color.danger[500]`   | Error, status gagal.                        |
+| `warning`  | `Color.warning[500]`  | Peringatan.                                 |
+| `info`     | `Color.info[500]`     | Informasi tambahan.                         |
+| `orange`   | `Color.orange[500]`   | Aksen/ badge khusus.                        |
+| `purple`   | `Color.purple[500]`   | Aksen sekunder/ grafik.                     |
+| `divider`  | `Color.divider[25]`   | Garis pemisah tipis.                        |
+| `disabled` | `Color.disabled[25]`  | Kontrol non‐aktif.                          |
+
+> Anda bisa menambahkan `shadow` palette jika diperlukan gradasi drop shadow.
+
+---
+
+## TypeScript Helper
+
+```ts
+export type ColorVariantType =
+  | 'default'
+  | 'success'
+  | 'danger'
+  | 'primary'
+  | 'warning'
+  | 'info'
+  | 'purple'
+  | 'orange';
+```
+
+Tipe ini dipakai di komponen lain (mis. `Label`) untuk membatasi nama variant.
+
+---
+
+## Contoh Implementasi
 
-## 🎨 Struktur Warna
-✅ Base
-Warna dasar utama:
-
-white100: putih solid
-
-white60: putih transparan 60%
-
-black100: hitam solid
-
-black60: hitam transparan 60%
-
-### ⚪ Gray (abu-abu)
-Gradasi abu-abu dari terang (gray.50) hingga gelap (gray.950), cocok untuk teks, latar, border, dsb.
-
-### 🔵 Primary
-Gradasi warna utama (biru), digunakan untuk tombol, highlight, atau elemen penting lainnya.
-
-### 🟠 Warning
-Warna peringatan, digunakan untuk menandai hal-hal seperti alert, notifikasi kuning, dll.
-
-### 🔴 Danger
-Warna untuk kondisi berbahaya atau error (merah).
-
-### 🟢 Success
-Digunakan untuk kondisi berhasil atau sukses (hijau).
-
-### 🔷 Info
-Warna tambahan untuk informasi, notifikasi, atau status sekunder.
-
-### 🟧 Orange
-Warna oranye, alternatif dari primary/warning.
+```tsx
+import Color from '@/components/Color/Color';
 
-### 🟣 Purple
-Warna ungu, bisa digunakan untuk status spesial atau branding.
+const MyButton = () => (
+  <View style={{ backgroundColor: Color.primary[500], padding: 12 }}>
+    <Text style={{ color: Color.base.white100 }}>Click Me</Text>
+  </View>
+);
+```
 
-🧱 Divider
-divider.25: Warna pembatas antar elemen UI.
+---
 
-📴 Disabled
-disabled.25: Warna untuk elemen non-aktif.
+## Tips Penggunaan
 
-## Cara menggunakan 
+* Gunakan warna **50** untuk latar lembut (highlight, badge background).
+* Gunakan warna **500** untuk elemen interaktif utama.
+* Gunakan warna **700+** untuk teks di atas warna **50–300**.
+* Gunakan `rgba(..., 0.x)` jika memerlukan translusi.
 
-```tsx
-import Color from '@herca/rn-kit';
+---
 
-<View style={{ backgroundColor: Color.primary[500] }} />
-<Text style={{ color: Color.gray[900] }}>Teks</Text>
+## Lisensi
 
-```
+Bagian dari library internal Anda; ikuti lisensi proyek.

package/src/DatePicker/{README.md → README_DATEPICKER.md}

@@ -4,6 +4,7 @@ Komponen `DatePicker` adalah antarmuka pemilih tanggal yang dibungkus dalam sebu
 
 Komponen ini extend dari Calendar, jadi kalian bisa menggunakan semua props yang ada di Calendar [Calendar](../Calendar/README.md)
 
+<img src="../../assets/doc/Datepicker/Datepicker.gif" width=200>
 ---
 
 ## ✨ Fitur

package/src/DatePicker/README_MONTHPICKER.md

@@ -0,0 +1,90 @@
+# MonthPicker
+
+Komponen **MonthPicker** adalah komponen pemilih bulan berbasis **React Native** yang dapat menampilkan pilihan bulan dalam tiga mode berbeda: **single**, **range**, dan **multiple**. Komponen ini dirancang untuk dipakai di dalam komponen **BottomSheet** dengan tampilan yang konsisten terhadap desain sistem.
+
+
+
+---
+
+## API Reference
+
+| Prop       | Tipe                                                                                  | Default     | Deskripsi                                                                                                        |
+| ---------- | ------------------------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------- |
+| `isOpen`   | `boolean`                                                                             | `false`     | Menentukan apakah **BottomSheet** terbuka atau tertutup.                                                         |
+| `onClose`  | `() => void`                                                                          | `undefined` | Callback yang dipanggil saat pengguna menekan tombol **Batal** atau menutup **BottomSheet**.                     |
+| `onChange` | `(value: number[] \| { startDate: number \| null; endDate: number \| null }) => void` | `undefined` | Callback yang dipanggil ketika pengguna menekan tombol **Pilih**. Parameter yang dikirim tergantung pada `mode`. |
+| `mode`     | `'single' \| 'range' \| 'multiple'`                                                   | `'single'`  | Menentukan cara pemilihan bulan.                                                                                 |
+
+### Bentuk *value* yang Dikirim oleh `onChange`
+
+| `mode`     | Bentuk *value*                                                                                                                                     |
+| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `single`   | `number[]` – array yang berisi satu elemen bulan terpilih. Contoh: `[5]` untuk Mei.                                                                |
+| `range`    | `{ startDate: number \| null; endDate: number \| null }` – objek berisi bulan mulai & akhir. Contoh: `{ startDate: 1, endDate: 3 }` untuk Jan–Mar. |
+| `multiple` | `number[]` – array berisi daftar bulan terpilih. Contoh: `[2, 4, 8]` untuk Feb, Apr, Agt.                                                          |
+
+---
+
+## Contoh Penggunaan
+
+```tsx
+import { useState } from 'react';
+import { View, Button } from 'react-native';
+import MonthPicker from '@/components/MonthPicker/MonthPicker';
+
+export default function Example() {
+  const [open, setOpen] = useState(false);
+  const [months, setMonths] = useState<number[]>([]);
+
+  return (
+    <View style={{ flex: 1 }}>
+      <Button title="Pilih Bulan" onPress={() => setOpen(true)} />
+
+      <MonthPicker
+        isOpen={open}
+        mode="multiple"
+        onClose={() => setOpen(false)}
+        onChange={(value) => {
+          if (Array.isArray(value)) {
+            setMonths(value);
+          }
+          setOpen(false);
+        }}
+      />
+    </View>
+  );
+}
+```
+
+---
+
+## Detail 
+
+1. **Single Mode**
+
+   * Klik satu bulan untuk menandai pilihan.
+   * Menekan **Pilih** mengirimkan array dengan satu elemen.
+2. **Range Mode**
+
+   * Klik bulan pertama untuk menentukan `startDate`.
+   * Klik bulan kedua untuk menentukan `endDate`.
+   * Jika `startDate` sudah terisi dan `endDate` belum, tetapi pengguna memilih bulan yang lebih kecil dari `startDate`, maka komponen otomatis menukar posisi dan mengisi `endDate` dengan nilai awal `startDate`.
+3. **Multiple Mode**
+
+   * Klik untuk toggle seleksi pada tiap bulan. Bulan yang dipilih disimpan dalam array `multipleValue`.
+
+---
+
+## Kustomisasi Tampilan
+
+* **Warna**: Warna latar dan border untuk opsi terpilih mengikuti `Color.primary` pada design system. Anda dapat menyesuaikannya dengan mengubah style `optionSelected` di dalam `MonthPicker`.
+* **Jumlah Kolom**: Saat ini komponen menampilkan `numColumns={3}` pada `FlatList`. Ubah nilai ini untuk menyesuaikan grid.
+
+---
+
+## Tips
+
+* Pastikan memanggil `onClose` setelah memproses hasil `onChange` agar **BottomSheet** tertutup.
+* Komponen ini tidak menangani validasi kombinasi bulan secara otomatis (mis. range satu tahun penuh). Tambahkan logika tambahan di tempat Anda memakainya apabila diperlukan.
+
+---

package/src/DatePicker/README_TIMEPICKER.md

@@ -0,0 +1,83 @@
+# TimePickerWheel
+
+**TimePickerWheel** adalah komponen pemilih waktu berbentuk *wheel* (picker bergulir) untuk **React Native**. Komponen ini menampilkan dua kolom (jam & menit) yang dapat digulir secara vertikal, dibungkus di dalam komponen **BottomSheet**.
+
+---
+
+## API Reference
+
+| Prop       | Tipe                                                | Default | Deskripsi                                                                                     |
+| ---------- | --------------------------------------------------- | ------- | --------------------------------------------------------------------------------------------- |
+| `isOpen`   | `boolean`                                           | `false` | Menentukan apakah **BottomSheet** terbuka.                                                    |
+| `onClose`  | `() => void`                                        | `-`     | Callback saat pengguna menutup **BottomSheet** atau menekan tombol **Batal**.                 |
+| `onChange` | `(value: { hour: number; minute: number }) => void` | `-`     | Callback saat pengguna menekan tombol **Pilih**. Objek yang dikirim berisi `hour` & `minute`. |
+
+### Bentuk *value* `onChange`
+
+```ts
+{
+  hour: number;   // 0–23
+  minute: number; // 0–59
+}
+```
+
+---
+
+## Cara Kerja Singkat
+
+1. **Wheel Padding** – Komponen menambahkan elemen *dummy* di atas & bawah daftar agar item tengah selalu berada di posisi highlight.
+2. **Highlight** – Baris tengah diberi `backgroundColor` khusus (`Color.primary[50]`) untuk menonjolkan pilihan aktif.
+3. **Snapping** – Properti `snapToInterval={ITEM_HEIGHT}` memastikan scroll *wheel* berhenti tepat di setiap item.
+4. **Sync & Loop** – Setelah scroll selesai, komponen menghitung indeks nyata (0‑23 untuk jam, 0‑59 untuk menit) agar wheel terasa tak terbatas.
+
+---
+
+## Contoh Penggunaan
+
+```tsx
+import { useState } from 'react';
+import { View, Button } from 'react-native';
+import TimePickerWheel from '@/components/TimePickerWheel/TimePickerWheel';
+
+export default function Example() {
+  const [open, setOpen] = useState(false);
+  const [time, setTime] = useState<{ hour: number; minute: number } | null>(
+    null
+  );
+
+  const formatted = time ? `${time.hour.toString().padStart(2, '0')}:${time.minute.toString().padStart(2, '0')}` : '—';
+
+  return (
+    <View style={{ flex: 1 }}>
+      <Button title={`Pilih Waktu (${formatted})`} onPress={() => setOpen(true)} />
+
+      <TimePickerWheel
+        isOpen={open}
+        onClose={() => setOpen(false)}
+        onChange={(value) => {
+          setTime(value);
+          setOpen(false);
+        }}
+      />
+    </View>
+  );
+}
+```
+
+---
+
+## Kustomisasi Tampilan
+
+* **Jumlah Items Terlihat** (`VISIBLE_ITEMS`): Default 5. Ubah nilai konstanta untuk menambah/kurangi tinggi wheel.
+* **Tinggi Item** (`ITEM_HEIGHT`): Default 40. Pengaturan ini mempengaruhi `snapToInterval`.
+* **Warna & Tipografi**: Edit style `selectedItemText`, `itemText`, dan `highlight` untuk menyesuaikan brand guideline.
+
+---
+
+## Tips Implementasi
+
+* Selalu panggil `onClose` setelah menangani hasil `onChange` agar **BottomSheet** menutup.
+* Jika Anda ingin menetapkan waktu awal sebelum picker dibuka, setel `selectedHour` & `selectedMinute` memakai `useState` lalu buka picker.
+* Komponen ini tidak membatasi kombinasi jam‑menit (mis. langkah 5 menit). Tambahkan logika tambahan jika diperlukan.
+
+---