@herca/rn-kit 0.1.6 → 0.1.8

package/src/DropDown/README.md

@@ -0,0 +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/src/DropDown/type.tsx

@@ -5,5 +5,5 @@ export interface DropDownProps {
   options: ChipOptionProps[];
   maxHeight?: number;
   onSelect?: (value: string | number) => void;
-  renderButton?: React.ReactNode;
+  renderButton: React.ReactNode;
 }

package/src/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/src/Provider/Provider.tsx

@@ -5,6 +5,7 @@ import LayoutWithFooter from './LayoutWithFooter';
 import RequiredUpdateAppsProvider from './RequiredUpdateAppsProvider';
 import { type ReactNode } from 'react';
 import type { RequiredUpdateAppsProviderProps } from './type';
+import Color from '../Color/Color';
 
 interface FooterContextType {
   footer: any | null;
@@ -13,8 +14,8 @@ interface FooterContextType {
 
 interface ProviderProps {
   children: ReactNode;
-  requiredUpdated: boolean;
-  updateConfig: RequiredUpdateAppsProviderProps;
+  requiredUpdated?: boolean;
+  updateConfig?: RequiredUpdateAppsProviderProps;
 }
 
 const FooterContext = createContext<FooterContextType | undefined>(undefined);
@@ -48,6 +49,7 @@ export const useFooter = () => {
 
 const styles = StyleSheet.create({
   container: {
+    backgroundColor: Color.base.white100,
     flex: 1,
   },
 });

package/src/Provider/type.tsx

@@ -1,6 +1,6 @@
 export interface RequiredUpdateAppsProviderProps {
-  title: string;
-  description: string;
+  title?: string;
+  description?: string;
   buttonText?: string;
   onUpdate?: (value: boolean) => void;
 }

package/src/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/src/Timeline/Timeline.tsx

@@ -1,9 +1,15 @@
-import { View } from 'react-native';
+import { StyleSheet, View } from 'react-native';
 
 interface Timeline {
   children: React.ReactNode;
 }
 
 export default function Timeline({ children }: Timeline) {
-  return <View>{children}</View>;
+  return <View style={styles.gap14}>{children}</View>;
 }
+
+const styles = StyleSheet.create({
+  gap14: {
+    gap: 14,
+  },
+});

package/src/Timeline/TimelineItem.tsx

@@ -14,7 +14,7 @@ type ColorKey = keyof typeof COLOR_MAP;
 
 interface TimelineItemProps {
   children: React.ReactNode;
-  color: ColorKey;
+  color?: ColorKey;
 }
 
 export default function TimelineItem({
@@ -22,12 +22,25 @@ export default function TimelineItem({
   color = 'primary',
 }: TimelineItemProps) {
   const [contentHeight, setContentHeight] = useState(0);
+  const renderDashes = (count: number) => {
+    return Array.from({ length: count }).map((_, index) => (
+      <View
+        key={index}
+        style={{
+          width: 1,
+          height: 4,
+          backgroundColor: Color.gray[400],
+          marginVertical: 2,
+        }}
+      />
+    ));
+  };
 
   return (
     <View style={styles.container}>
       <View style={styles.contentLeft}>
         <Icon name="RadioButton" color={COLOR_MAP[color]} />
-        <View style={[styles.border, { height: contentHeight - 20 }]} />
+        <View>{renderDashes(Math.floor((contentHeight - 20) / 6))}</View>
       </View>
       <View
         style={styles.flex}
@@ -52,10 +65,10 @@ const styles = StyleSheet.create({
   },
   border: {
     width: 1,
+    borderWidth: 1,
     borderLeftWidth: 1,
     borderLeftColor: Color.gray[400],
     borderStyle: 'dashed',
-    marginTop: 4,
   },
   flex: {
     flex: 1,

package/src/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],
+}
+```
+