@herca/rn-kit 0.1.32 → 0.1.34

package/src/Chip/README_CHIP_ITEM.md

@@ -0,0 +1,73 @@
+# 📦 Komponen `ChipItem` – React Native
+
+Komponen `ChipItem` merupakan komponen presentasional dalam bentuk "chip" atau "pill" yang digunakan sebagai bagian dari list filter/select menggunakan UI gaya chip, baik single maupun multiple select.
+
+---
+
+## 🔧 Props
+
+| Prop           | Type                                                                                             | Default      | Description                                                                        |
+| -------------- | ------------------------------------------------------------------------------------------------ | ------------ | ---------------------------------------------------------------------------------- |
+| `item`         | `ChipOptionProps`                                                                                | **Required** | Data item yang akan ditampilkan, berisi label, value, dan optional `disabled`      |
+| `isSelected`   | `(value: boolean) => boolean`                                                                    | **Required** | Fungsi untuk menentukan apakah item saat ini sedang terpilih                       |
+| `color`        | `'default' \| 'success' \| 'danger' \| 'primary' \| 'warning' \| 'info' \| 'purple' \| 'orange'` | `'default'`  | Warna tema chip berdasarkan `CHIP_COLOR_MAP`                                       |
+| `block`        | `boolean`                                                                                        | `false`      | Apakah chip harus mengisi lebar penuh jika ditampilkan secara vertikal             |
+| `size`         | `'small' \| 'medium' \| 'large'`                                                                 | `'medium'`   | Ukuran padding dan font chip                                                       |
+| `renderItem`   | `(item: ChipOptionProps, selected: boolean, disabled: boolean) => ReactNode`                     | `undefined`  | Fungsi untuk mengkustomisasi isi tampilan chip                                     |
+| `isHorizontal` | `boolean`                                                                                        | `false`      | Jika true, maka `block` akan diabaikan agar chip tetap fleksibel secara horizontal |
+| `onPress`      | `(disabled: boolean, val: ChipOptionProps) => void`                                              | `undefined`  | Callback saat chip ditekan                                                         |
+| `onLayout`     | `(event: LayoutChangeEvent) => void`                                                             | `undefined`  | Callback ketika layout chip dihitung oleh React Native                             |
+
+---
+
+## 🎨 Style Behavior
+
+- **Warna Dinamis**: Warna border, background, dan teks akan menyesuaikan status:
+  - Default
+  - Selected
+  - Disabled
+
+- **Ukuran**:
+  - `'small'`: Padding kecil, font size 12
+  - `'medium'`: Default, font size 14
+  - `'large'`: Padding besar, font size 16
+
+- **Block Mode**:
+  - Bila `block: true` dan `isHorizontal: false`, chip akan mengisi lebar penuh kontainer
+
+---
+
+## 💡 Contoh Penggunaan
+
+```tsx
+<ChipItem
+  item={{ label: 'Marketing', value: 'marketing' }}
+  isSelected={() => true}
+  color="primary"
+  size="medium"
+  onPress={(disabled, val) => console.log('Pressed:', val)}
+/>
+```
+
+---
+
+## 🛠️ Tips
+
+- Gunakan `renderItem` untuk mengganti isi chip dengan tampilan kustom.
+- Pastikan `isSelected` di-define dengan benar agar state visual chip sesuai.
+
+---
+
+## 🧱 Dependencies
+
+- `Typography`
+- `CHIP_COLOR_MAP`
+- `Pressable` & `StyleSheet` dari React Native
+
+---
+
+## 🗂️ Related
+
+- `Chip`
+- `Select`
+- `ChipOptionProps`

package/src/Icon/Icon.tsx

@@ -60,6 +60,9 @@ import Bold from './icons/Bold';
 import Italic from './icons/Italic';
 import UnderLine from './icons/UnderLine';
 import SettingsSlider from './icons/SettingsSlider';
+import RotateSquareFill from './icons/RotateSquareFill';
+import LocationPinFill from './icons/LocationPinFill';
+import DiscountFill from './icons/DiscountFill';
 
 const icons: Record<
   IconNameProps,
@@ -124,6 +127,9 @@ const icons: Record<
   'Italic': Italic,
   'UnderLine': UnderLine,
   'settings-slider': SettingsSlider,
+  'rotate-square-fill': RotateSquareFill,
+  'location-pin-fill': LocationPinFill,
+  'discount-fill': DiscountFill,
 };
 
 const Icon: React.FC<IconProps> = ({

package/src/Icon/README.md

@@ -106,3 +106,7 @@ export default function App() {
 - Bold
 - UnderLine
 - Italic
+- settings-slider
+- rotate-square-fill
+- discount-fill
+- location-pin-fill

package/src/Icon/icons/DiscountFill.tsx

@@ -0,0 +1,26 @@
+import Svg, { Path } from 'react-native-svg';
+
+interface Props {
+  size?: number;
+  color?: string;
+  style?: object;
+}
+
+const DiscountFill: React.FC<Props> = ({ size = 24, color, style }: Props) => (
+  <Svg
+    width={size + 1}
+    height={size}
+    viewBox="0 0 24 25"
+    fill="none"
+    style={style}
+  >
+    <Path
+      fill-rule="evenodd"
+      clip-rule="evenodd"
+      d="M20.5589 11.3975L19.243 10.0815C18.962 9.80047 18.8039 9.41847 18.8039 9.02047V7.16247C18.8039 6.33147 18.1299 5.65749 17.2989 5.65749H15.441C15.043 5.65749 14.662 5.49947 14.38 5.21847L13.0639 3.90249C12.4759 3.31449 11.524 3.31449 10.936 3.90249L9.61996 5.21847C9.33895 5.49947 8.95692 5.65749 8.55892 5.65749H6.70101C5.87001 5.65749 5.196 6.33147 5.196 7.16247V9.02047C5.196 9.41847 5.03792 9.79947 4.75692 10.0815L3.441 11.3975C2.853 11.9855 2.853 12.9375 3.441 13.5255L4.75692 14.8415C5.03792 15.1225 5.196 15.5045 5.196 15.9025V17.7605C5.196 18.5915 5.87001 19.2655 6.70101 19.2655H8.55892C8.95692 19.2655 9.33795 19.4235 9.61996 19.7045L10.936 21.0205C11.524 21.6085 12.4759 21.6085 13.0639 21.0205L14.38 19.7045C14.661 19.4235 15.043 19.2655 15.441 19.2655H17.2989C18.1299 19.2655 18.8039 18.5915 18.8039 17.7605V15.9025C18.8039 15.5045 18.962 15.1235 19.243 14.8415L20.5589 13.5255C21.1469 12.9375 21.1469 11.9855 20.5589 11.3975ZM8.51497 9.96148C8.51497 9.40948 8.95797 8.96148 9.50997 8.96148H9.51998C10.073 8.96148 10.52 9.40948 10.52 9.96148C10.52 10.5135 10.073 10.9615 9.51998 10.9615C8.96798 10.9615 8.51497 10.5135 8.51497 9.96148ZM10.03 15.4915C9.88399 15.6375 9.69196 15.7115 9.49996 15.7115C9.30796 15.7115 9.11593 15.6385 8.96993 15.4915C8.67693 15.1985 8.67693 14.7235 8.96993 14.4305L13.9699 9.43047C14.2629 9.13747 14.738 9.13747 15.031 9.43047C15.324 9.72347 15.324 10.1985 15.031 10.4915L10.03 15.4915ZM14.52 15.9615C13.968 15.9615 13.515 15.5135 13.515 14.9615C13.515 14.4095 13.958 13.9615 14.51 13.9615H14.52C15.073 13.9615 15.52 14.4095 15.52 14.9615C15.52 15.5135 15.072 15.9615 14.52 15.9615Z"
+      fill={color}
+    />
+  </Svg>
+);
+
+export default DiscountFill;

package/src/Icon/icons/LocationPinFill.tsx

@@ -0,0 +1,28 @@
+import Svg, { Path } from 'react-native-svg';
+
+interface Props {
+  size?: number;
+  color?: string;
+  style?: object;
+}
+
+const LocationPinFill: React.FC<Props> = ({
+  size = 24,
+  color,
+  style,
+}: Props) => (
+  <Svg
+    width={size}
+    height={size + 1}
+    viewBox="0 0 24 25"
+    fill="none"
+    style={style}
+  >
+    <Path
+      d="M12 2.96149C7.313 2.96149 3.5 6.77449 3.5 11.4615C3.5 16.4445 8.129 19.5025 11.192 21.5255L11.722 21.8775C11.806 21.9335 11.903 21.9615 11.999 21.9615C12.095 21.9615 12.192 21.9335 12.276 21.8775L12.806 21.5255C15.869 19.5025 20.498 16.4445 20.498 11.4615C20.5 6.77449 16.687 2.96149 12 2.96149ZM12 13.9615C10.619 13.9615 9.5 12.8425 9.5 11.4615C9.5 10.0805 10.619 8.96149 12 8.96149C13.381 8.96149 14.5 10.0805 14.5 11.4615C14.5 12.8425 13.381 13.9615 12 13.9615Z"
+      fill={color}
+    />
+  </Svg>
+);
+
+export default LocationPinFill;

package/src/Icon/icons/RotateSquareFill.tsx

@@ -0,0 +1,22 @@
+import Svg, { Path } from 'react-native-svg';
+
+interface Props {
+  size?: number;
+  color?: string;
+  style?: object;
+}
+
+const RotateSquareFill: React.FC<Props> = ({
+  size = 24,
+  color,
+  style,
+}: Props) => (
+  <Svg width={size} height={size} viewBox="0 0 20 20" fill="none" style={style}>
+    <Path
+      d="M14.6875 2.5H5.3125C3.4375 2.5 2.5 3.4375 2.5 5.3125V14.6875C2.5 16.5625 3.4375 17.5 5.3125 17.5H14.6875C16.5625 17.5 17.5 16.5625 17.5 14.6875V5.3125C17.5 3.4375 16.5625 2.5 14.6875 2.5ZM14.2251 11.0891C13.7409 13.0232 12.0033 14.375 10 14.375C8.79667 14.375 7.68167 13.8733 6.875 13.0467V13.3333C6.875 13.6783 6.595 13.9583 6.25 13.9583C5.905 13.9583 5.625 13.6783 5.625 13.3333V11.25C5.625 10.905 5.905 10.625 6.25 10.625H6.4858C6.49413 10.625 6.5033 10.6242 6.51164 10.625H8.33333C8.67833 10.625 8.95833 10.905 8.95833 11.25C8.95833 11.595 8.67833 11.875 8.33333 11.875H7.50407C8.08407 12.6467 9.00167 13.125 10 13.125C11.4292 13.125 12.6675 12.1634 13.0125 10.7859C13.0967 10.4509 13.4424 10.25 13.7699 10.3316C14.1058 10.415 14.3092 10.7541 14.2251 11.0891ZM14.375 8.75C14.375 9.095 14.095 9.375 13.75 9.375H13.5067C13.5017 9.375 13.4966 9.375 13.4908 9.375H11.6667C11.3217 9.375 11.0417 9.095 11.0417 8.75C11.0417 8.405 11.3217 8.125 11.6667 8.125H12.4959C11.9159 7.35333 10.9983 6.875 10 6.875C8.57083 6.875 7.33251 7.83657 6.98751 9.21407C6.91667 9.49824 6.66163 9.6875 6.38163 9.6875C6.3308 9.6875 6.28008 9.68169 6.22925 9.66919C5.89425 9.58502 5.6908 9.24593 5.77413 8.91093C6.2583 6.97676 7.99585 5.625 9.99919 5.625C11.2025 5.625 12.3175 6.12666 13.1242 6.95333V6.66667C13.1242 6.32167 13.4042 6.04167 13.7492 6.04167C14.0942 6.04167 14.3742 6.32167 14.3742 6.66667V8.75H14.375Z"
+      fill={color}
+    />
+  </Svg>
+);
+
+export default RotateSquareFill;

package/src/Icon/type.tsx

@@ -61,6 +61,9 @@ export type IconNameProps =
   | 'Italic'
   | 'UnderLine'
   | 'settings-slider'
+  | 'location-pin-fill'
+  | 'discount-fill'
+  | 'rotate-square-fill'
   | 'whatsapp-fill';
 
 export interface IconProps {

package/src/Select/README.md

@@ -14,22 +14,23 @@ Komponen `Select` adalah komponen pemilihan data berbasis bottom sheet dengan du
 
 ## 📦 Props
 
-| Prop         | Tipe                                            | Default       | Keterangan |
-|--------------|--------------------------------------------------|---------------|------------|
-| `isOpen`     | `boolean`                                       | `false`       | Menentukan apakah bottom sheet terbuka |
-| `data`       | `ChipOptionProps[]`                             | -             | Data pilihan untuk ditampilkan |
-| `multiple`   | `boolean`                                       | `false`       | Mengizinkan multiple selection |
-| `renderItem` | `(item, selected, disabled) => React.ReactNode` | -             | Kustom tampilan item |
-| `onSubmit`   | `(selected: ChipSelectedProps) => void`         | -             | Callback saat tombol submit ditekan |
-| `onClose`    | `(val: boolean) => void`                        | -             | Callback saat bottom sheet ditutup |
-| `onSearch`   | `(val: string) => void`                         | -             | Callback saat input pencarian berubah |
-| `required`   | `boolean`                                       | `false`       | Jika `true`, validasi input saat submit |
-| `loading`    | `boolean`                                       | `false`       | Menampilkan loading saat data di-fetch |
-| `delaySearch`| `number`                                        | `300`         | Delay pencarian dalam milidetik |
-| `height`     | `BottomSheetHeighProps`                         | -             | Ukuran tinggi BottomSheet |
-| `onRefresh`  | `() => void`                                    | -             | Callback saat pull-to-refresh dilakukan |
-| `header`     | ReactElement| –              | Jika ingin chip mempunyai header.                          |
-| `footer`     | ReactElement| –              | Jika ingin chip mempunyai footer.                          |
+| Prop          | Tipe                                            | Default | Keterangan                                                                                                                                                    |
+| ------------- | ----------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `isOpen`      | `boolean`                                       | `false` | Menentukan apakah bottom sheet terbuka                                                                                                                        |
+| `data`        | `ChipOptionProps[]`                             | -       | Data pilihan untuk ditampilkan                                                                                                                                |
+| `multiple`    | `boolean`                                       | `false` | Mengizinkan multiple selection                                                                                                                                |
+| `renderItem`  | `(item, selected, disabled) => React.ReactNode` | -       | Kustom tampilan item                                                                                                                                          |
+| `onSubmit`    | `(selected: ChipSelectedProps) => void`         | -       | Callback saat tombol submit ditekan                                                                                                                           |
+| `onClose`     | `(val: boolean) => void`                        | -       | Callback saat bottom sheet ditutup                                                                                                                            |
+| `onSearch`    | `(val: string) => void`                         | -       | Callback saat input pencarian berubah                                                                                                                         |
+| `required`    | `boolean`                                       | `false` | Jika `true`, validasi input saat submit                                                                                                                       |
+| `loading`     | `boolean`                                       | `false` | Menampilkan loading saat data di-fetch                                                                                                                        |
+| `delaySearch` | `number`                                        | `300`   | Delay pencarian dalam milidetik                                                                                                                               |
+| `height`      | `BottomSheetHeighProps`                         | -       | Ukuran tinggi BottomSheet                                                                                                                                     |
+| `onRefresh`   | `() => void`                                    | -       | Callback saat pull-to-refresh dilakukan                                                                                                                       |
+| `header`      | ReactElement                                    | –       | Jika ingin chip mempunyai header.                                                                                                                             |
+| `footer`      | ReactElement                                    | –       | Jika ingin chip mempunyai footer.                                                                                                                             |
+| `value`       | ChipSelectedProps                               | –       | Nilai pilihan yang dikontrol dari luar. Cocok untuk membuat komponen controlled. Akan mensinkronkan state internal selected dengan value setiap kali berubah. |
 
 ## 📌 Contoh Penggunaan
 
@@ -53,6 +54,7 @@ const MyScreen = () => {
       <Button title="Pilih Data" onPress={() => setOpen(true)} />
       <Select
         isOpen={open}
+        value={selected}
         data={data}
         multiple={true}
         onClose={() => setOpen(false)}
@@ -77,4 +79,11 @@ const MyScreen = () => {
   - `Loading`
   - `Toast` (untuk validasi/error)
 
-- Jika ingin menambahkan animasi shimmer saat loading, bisa modifikasi komponen `Loading`.
+- Jika ingin menambahkan animasi shimmer saat loading, bisa modifikasi komponen `Loading`.
+
+## ⚠️ Behavior Penting
+
+- Jika `multiple={false}` dan `required={true}`, maka:
+  - Item yang dipilih akan langsung dikirim ke `onSubmit`.
+  - BottomSheet akan langsung tertutup tanpa menekan tombol submit.
+- Jika `required={false}`, user bisa membatalkan pilihan (deselect), dan mengirim data kosong.

package/src/Select/Select.tsx

@@ -1,4 +1,4 @@
-import { useCallback, useState } from 'react';
+import { useCallback, useState, useEffect } from 'react';
 import {
   Keyboard,
   StyleSheet,
@@ -32,6 +32,7 @@ export default function Select({
   header,
   onEndReached,
   submitBtnLabel,
+  value,
 }: SelectProps) {
   // const [isOpenSelect, setIsOpenSelect] = useState<boolean | undefined>(false);
   const [selected, setSelected] = useState<ChipSelectedProps>();
@@ -75,6 +76,12 @@ export default function Select({
     }, delaySearch);
   };
 
+  useEffect(() => {
+    if (value !== undefined) {
+      setSelected(value);
+    }
+  }, [value]);
+
   return (
     <BottomSheet
       onClose={(val: boolean) => handleOnCloseBottom(val)}

package/src/Select/type.tsx

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { ChipOnSelectProps, ChipOptionProps } from '../Chip/type';
 import type { BottomSheetHeighProps } from '../BottomSheet/type';
+import type { ChipSelectedProps } from '../Chip/type';
 
 export interface SelectDataProps {
   value: string | number;
@@ -29,6 +30,7 @@ export interface SelectProps {
   onEndReached?: () => void;
   refreshing?: boolean;
   submitBtnLabel?: string;
+  value?: ChipSelectedProps;
   footer?: React.ComponentType<any> | React.ReactElement | null | undefined;
   header?: React.ComponentType<any> | React.ReactElement | null | undefined;
 }

package/src/Skeleton/README.md

@@ -0,0 +1,79 @@
+# 🦴 Skeleton Loader Component
+
+Komponen `Skeleton` adalah placeholder UI yang menampilkan efek shimmer animasi, berguna untuk memberikan feedback loading saat data belum tersedia.
+
+---
+
+## 📦 Props
+
+| Prop              | Tipe             | Default                      | Deskripsi                                                                          |
+| ----------------- | ---------------- | ---------------------------- | ---------------------------------------------------------------------------------- |
+| `width`           | `DimensionValue` | `"100%"`                     | Lebar dari skeleton block. Bisa berupa angka atau string (`'100%'`, `'50%'`, dsb). |
+| `height`          | `DimensionValue` | `50`                         | Tinggi dari skeleton block.                                                        |
+| `rounded`         | `number`         | `8`                          | Radius border untuk membuat sudut membulat.                                        |
+| `backgroundColor` | `string`         | `"#F0F0F0"`                  | Warna latar belakang dari blok skeleton.                                           |
+| `shimmerColor`    | `string`         | `"rgba(255, 255, 255, 0.7)"` | Warna efek shimmer yang bergerak.                                                  |
+| `duration`        | `number`         | `1500`                       | Durasi animasi shimmer (dalam milidetik).                                          |
+
+---
+
+## 🧠 Cara Kerja
+
+- Komponen menggunakan `Animated.Value` untuk menggerakkan efek shimmer dari kiri ke kanan secara loop.
+- Lebar shimmer dihitung berdasarkan lebar aktual komponen yang didapat dari event `onLayout`.
+- Shimmer bergerak dengan `translateX` menggunakan `interpolate()` untuk efek linear mulus.
+
+---
+
+## 📌 Contoh Penggunaan
+
+```tsx
+import React from 'react';
+import { View } from 'react-native';
+import Skeleton from './components/Skeleton';
+
+const MyLoadingScreen = () => {
+  return (
+    <View style={{ padding: 16 }}>
+      <Skeleton height={20} width="60%" />
+      <View style={{ height: 16 }} />
+      <Skeleton height={20} width="80%" />
+      <View style={{ height: 16 }} />
+      <Skeleton height={100} width="100%" rounded={12} />
+    </View>
+  );
+};
+```
+
+---
+
+## 🧱 Struktur Rendered
+
+```tsx
+<View>
+  {' '}
+  // container
+  <Animated.View /> // shimmer yang bergerak horizontal
+</View>
+```
+
+---
+
+## ⚠️ Catatan
+
+- Komponen ini **tidak menerima children**, hanya untuk placeholder visual.
+- Efek shimmer akan selalu berjalan secara loop selama komponen hidup.
+- Perhatikan performa jika digunakan secara masif di satu halaman.
+
+---
+
+## 🛠 Tips
+
+- Gunakan `Skeleton` dalam daftar (list, table, card) untuk meningkatkan UX saat loading.
+- Dapat digabungkan dengan kondisi seperti:
+
+```tsx
+{
+  isLoading ? <Skeleton height={50} /> : <ActualComponent data={data} />;
+}
+```

package/src/Skeleton/Skeleton.tsx

@@ -0,0 +1,99 @@
+import React, { useEffect, useRef } from 'react';
+import {
+  Animated,
+  Easing,
+  StyleSheet,
+  View,
+  type LayoutChangeEvent,
+  type StyleProp,
+  type ViewStyle,
+} from 'react-native';
+import type { SkeletonProps } from './type';
+
+const Skeleton: React.FC<SkeletonProps> = ({
+  width = '100%',
+  height = 50,
+  rounded = 8,
+  backgroundColor = '#F0F0F0',
+  shimmerColor = 'rgba(255, 255, 255, 0.7)',
+  duration = 1500,
+}) => {
+  const shimmerAnimation = useRef(new Animated.Value(0)).current;
+  const skeletonWidth = useRef(0);
+
+  const handleLayout = (event: LayoutChangeEvent) => {
+    skeletonWidth.current = event.nativeEvent.layout.width;
+  };
+
+  useEffect(() => {
+    const animateShimmer = () => {
+      Animated.loop(
+        Animated.sequence([
+          Animated.timing(shimmerAnimation, {
+            toValue: 1,
+            duration: duration,
+            easing: Easing.linear,
+            useNativeDriver: true,
+          }),
+          Animated.timing(shimmerAnimation, {
+            toValue: 0,
+            duration: 0,
+            useNativeDriver: true,
+          }),
+        ])
+      ).start();
+    };
+
+    animateShimmer();
+
+    return () => {
+      shimmerAnimation.stopAnimation();
+    };
+  }, [shimmerAnimation, duration]);
+
+  const shimmerTranslate = shimmerAnimation.interpolate({
+    inputRange: [0, 1],
+    // Gunakan lebar skeleton untuk perhitungan yang presisi
+    outputRange: [-200, skeletonWidth.current + 200],
+  });
+
+  return (
+    <View
+      onLayout={handleLayout}
+      style={[
+        styles.skeletonCard,
+        {
+          width,
+          height,
+          backgroundColor,
+          borderRadius: rounded,
+        } as StyleProp<ViewStyle>,
+      ]}
+    >
+      <Animated.View
+        style={[
+          styles.shimmer,
+          {
+            backgroundColor: shimmerColor,
+            transform: [{ translateX: shimmerTranslate }],
+            borderRadius: rounded,
+          },
+        ]}
+      />
+    </View>
+  );
+};
+
+export default Skeleton;
+
+const styles = StyleSheet.create({
+  skeletonCard: {
+    overflow: 'hidden',
+  },
+  shimmer: {
+    ...StyleSheet.absoluteFillObject,
+    width: '90%',
+    height: '100%',
+    opacity: 0.3,
+  },
+});

package/src/Skeleton/type.ts

@@ -0,0 +1,10 @@
+import type { DimensionValue } from 'react-native';
+
+export interface SkeletonProps {
+  width?: DimensionValue;
+  height?: DimensionValue;
+  rounded?: number;
+  backgroundColor?: string;
+  shimmerColor?: string;
+  duration?: number;
+}

package/src/Tab/README.md

@@ -2,13 +2,56 @@
 
 Komponen tab ringan dan fleksibel untuk React Native yang mendukung:
 
-* ✅ Swipe kiri/kanan antar tab
-* ✅ Scroll vertikal di dalam konten tiap tab
-* ✅ Tampilan tab yang bisa disesuaikan
-* ✅ Tanpa dependensi eksternal (tidak butuh react-navigation)
+- ✅ Swipe kiri/kanan antar tab
+- ✅ Scroll vertikal di dalam konten tiap tab
+- ✅ Tampilan tab yang bisa disesuaikan
+- ✅ Tanpa dependensi eksternal (tidak butuh react-navigation)
 
 ---
 
+## ⚙️ Instalasi
+
+Komponen tab ini dibangun menggunakan [react-native-pager-view](https://github.com/callstack/react-native-pager-view) untuk mengatur perpindahan tab secara swipe kiri/kanan.
+Pastikan Anda menginstal dependensi ini sebelum menggunakan komponen.
+
+### 1. Install Dependensi
+
+```sh
+# Menggunakan npm
+npm install react-native-pager-view
+
+# Menggunakan yarn
+yarn add react-native-pager-view
+```
+
+### 2. Konfigurasi Platform
+
+#### iOS
+
+Setelah instalasi, jalankan perintah berikut untuk meng-install pod:
+
+```sh
+cd ios && pod install && cd ..
+```
+
+Tidak ada konfigurasi tambahan untuk iOS, namun pastikan proyek Anda sudah menggunakan **minimum iOS 11** atau sesuai rekomendasi React Native agar kompatibel.
+
+#### Android
+
+`react-native-pager-view` akan otomatis ter-link di Android tanpa perlu langkah tambahan.
+Namun, Anda perlu memastikan bahwa **minimum SDK version** Anda adalah 21 atau lebih tinggi.
+Periksa file `android/app/build.gradle`:
+
+```gradle
+android {
+  defaultConfig {
+    minSdkVersion = 21
+  }
+}
+```
+
+Jika nilai `minSdkVersion` di bawah 21, tingkatkan agar komponen dapat berjalan dengan baik.
+
 ## 💡 Contoh Penggunaan
 
 ```tsx
@@ -33,8 +76,8 @@ export default function App() {
 
 ### 1. Navigasi Tab
 
-* Tap pada header tab untuk berpindah
-* Swipe kiri/kanan untuk berpindah antar tab
+- Tap pada header tab untuk berpindah
+- Swipe kiri/kanan untuk berpindah antar tab
 
 ### 2. Konten Scrollable
 

package/src/Tab/Tab.tsx

@@ -76,10 +76,9 @@ const Tab: React.FC<TabProps> = ({ children, current = 0, onChangeTab }) => {
         onPageSelected={(e) => updateActive(e.nativeEvent.position)}
       >
         {items.map((item, index) => {
-          const Comp = item.props.component;
           return (
             <View key={index} collapsable={false} style={{ flex: 1 }}>
-              {Comp ? <Comp /> : null}
+              {item.props.children}
             </View>
           );
         })}
@@ -108,5 +107,5 @@ const styles = StyleSheet.create({
   },
   tabActive: { backgroundColor: Color.primary[1000] },
   tabInactive: { backgroundColor: Color.gray[100] },
-  pager: { flex: 1 },
+  pager: { flex: 1, backgroundColor: Color.base.white100 },
 });

package/src/Tab/TabItem.tsx

@@ -1,5 +1,5 @@
 import type { TabItemProps } from './type';
 import React from 'react';
 
-const TabItem: React.FC<TabItemProps> = (_props) => null;
+const TabItem: React.FC<TabItemProps> = (_props: TabItemProps) => null;
 export default TabItem;

package/src/Tab/type.tsx

@@ -2,7 +2,7 @@ import React, { type ReactElement } from 'react';
 
 export interface TabItemProps {
   name: string | number;
-  component: React.ComponentType<any>;
+  children: React.ReactNode;
 }
 export interface TabProps {
   children: ReactElement<TabItemProps> | ReactElement<TabItemProps>[];