1mpacto-react-ui 1.0.0 → 1.0.2

package/dist/src/interfaces/components/Calendar/index.d.ts

@@ -3,106 +3,470 @@ import { ReactNode } from 'react';
 import { AriaButtonOptions, DateValue, RangeCalendarProps } from 'react-aria';
 import { CalendarState, CalendarStateOptions, DateRangePickerStateOptions, RangeCalendarState } from 'react-stately';
 
+/**
+ * [ID] : Tipe kalender (tanggal, bulan, tahun).
+ * [EN] : Calendar type (date, month, year).
+ */
 export type TCalendarType = 'date' | 'month' | 'year';
+/**
+ * [ID] : Tipe data tanggal.
+ * [EN] : Date data type.
+ */
 export type TDateType = Date | string | null | undefined;
+/**
+ * [ID] : Kunci lokal yang didukung.
+ * [EN] : Supported locale keys.
+ */
 export type TKeyLocale = 'id-ID' | 'en-US' | 'nl-NL' | 'zh-CN';
+/**
+ * [ID] : Interface untuk ikon navigasi kalender.
+ * [EN] : Interface for calendar navigation icons.
+ */
 export interface ICalendarPrevNextIcon {
+    /**
+     * [ID] : Ikon sebelumnya (opsional).
+     * [EN] : Previous icon (optional).
+     */
     prevIcon?: ReactNode | ReactNode[] | (() => ReactNode) | (() => ReactNode[]);
+    /**
+     * [ID] : Ikon selanjutnya (opsional).
+     * [EN] : Next icon (optional).
+     */
     nextIcon?: ReactNode | ReactNode[] | (() => ReactNode) | (() => ReactNode[]);
 }
+/**
+ * [ID] : Interface untuk tombol konfirmasi kalender.
+ * [EN] : Interface for calendar confirmation buttons.
+ */
 export interface ICalendarButtonConfirm {
+    /**
+     * [ID] : Tombol reset (opsional).
+     * [EN] : Reset button (optional).
+     */
     buttonReset?: (() => ReactNode) | (() => ReactNode[]);
+    /**
+     * [ID] : Tombol submit (opsional).
+     * [EN] : Submit button (optional).
+     */
     buttonSubmit?: (() => ReactNode) | (() => ReactNode[]);
 }
+/**
+ * [ID] : Interface untuk waktu kalender.
+ * [EN] : Interface for calendar time.
+ */
 export interface ITimeCalendar {
+    /**
+     * [ID] : Jam (opsional).
+     * [EN] : Hour (optional).
+     */
     hour?: number;
+    /**
+     * [ID] : Menit (opsional).
+     * [EN] : Minute (optional).
+     */
     minut?: number;
+    /**
+     * [ID] : Detik (opsional).
+     * [EN] : Second (optional).
+     */
     second?: number;
 }
+/**
+ * [ID] : Interface untuk rentang waktu kalender.
+ * [EN] : Interface for calendar time range.
+ */
 export interface ITimeCalendarRange {
+    /**
+     * [ID] : Waktu mulai (opsional).
+     * [EN] : Start time (optional).
+     */
     start?: ITimeCalendar;
+    /**
+     * [ID] : Waktu selesai (opsional).
+     * [EN] : End time (optional).
+     */
     end?: ITimeCalendar;
 }
+/**
+ * [ID] : Interface utama untuk komponen Kalender.
+ * [EN] : Main interface for Calendar component.
+ */
 export interface ICalendar extends CalendarStateOptions<DateValue>, ICalendarPrevNextIcon, ICalendarButtonConfirm {
+    /**
+     * [ID] : Menampilkan tombol konfirmasi (opsional).
+     * [EN] : Show confirm buttons (optional).
+     */
     withConfirm?: boolean;
+    /**
+     * [ID] : Menggunakan waktu kustom (opsional).
+     * [EN] : Use custom time (optional).
+     */
     isCustomTime?: boolean;
+    /**
+     * [ID] : Tanggal minimum (opsional).
+     * [EN] : Minimum date (optional).
+     */
     minDate?: TDateType;
+    /**
+     * [ID] : Tanggal maksimum (opsional).
+     * [EN] : Maximum date (optional).
+     */
     maxDate?: TDateType;
+    /**
+     * [ID] : Rentang waktu (opsional).
+     * [EN] : Time range (optional).
+     */
     time?: ITimeCalendarRange;
+    /**
+     * [ID] : Tipe kalender yang aktif (opsional).
+     * [EN] : Active calendar type (optional).
+     */
     activeType?: TCalendarType;
+    /**
+     * [ID] : Menampilkan pilihan tanggal (opsional).
+     * [EN] : Show date selection (optional).
+     */
     withDateSelect?: boolean;
+    /**
+     * [ID] : Tipe-tipe kalender yang tersedia.
+     * [EN] : Available calendar types.
+     */
     type: TCalendarType[];
+    /**
+     * [ID] : Tipe waktu (SINGLE atau RANGE) (opsional).
+     * [EN] : Time type (SINGLE or RANGE) (optional).
+     */
     typeTime?: 'SINGLE' | 'RANGE';
+    /**
+     * [ID] : Menyembunyikan header (opsional).
+     * [EN] : Hide header (optional).
+     */
     hiddenHeader?: boolean;
+    /**
+     * [ID] : Handler perubahan waktu (opsional).
+     * [EN] : Time change handler (optional).
+     * @param v - [ID] : Rentang waktu baru. [EN] : New time range.
+     */
     handlerChangeTime?: (v: ITimeCalendarRange) => void;
+    /**
+     * [ID] : Handler reset kalender.
+     * [EN] : Calendar reset handler.
+     * @param v - [ID] : State kalender. [EN] : Calendar state.
+     */
     handlerReset: (v: CalendarState) => void;
+    /**
+     * [ID] : Handler submit kalender.
+     * [EN] : Calendar submit handler.
+     */
     handlerSubmit: () => void;
 }
+/**
+ * [ID] : Interface untuk pilihan tanggal kalender.
+ * [EN] : Interface for calendar date selection.
+ */
 export interface ICalendarDateSelect extends CalendarStateOptions<DateValue>, ICalendarPrevNextIcon {
+    /**
+     * [ID] : State kalender.
+     * [EN] : Calendar state.
+     */
     state: CalendarState;
+    /**
+     * [ID] : Menyembunyikan header (opsional).
+     * [EN] : Hide header (optional).
+     */
     hiddenHeader?: boolean;
+    /**
+     * [ID] : Fungsi untuk mengatur tipe kalender aktif.
+     * [EN] : Function to set active calendar type.
+     * @param v - [ID] : Tipe kalender. [EN] : Calendar type.
+     */
     setActiveTypeCalendar: (v: TCalendarType) => void;
 }
+/**
+ * [ID] : Interface untuk waktu kustom kalender.
+ * [EN] : Interface for custom calendar time.
+ */
 export interface ICustomTimeCalendar {
+    /**
+     * [ID] : Waktu (opsional).
+     * [EN] : Time (optional).
+     */
     time?: ITimeCalendar;
+    /**
+     * [ID] : Nilai tanggal (opsional).
+     * [EN] : Date value (optional).
+     */
     value?: DateValue | null | undefined;
+    /**
+     * [ID] : Tanggal minimum (opsional).
+     * [EN] : Minimum date (optional).
+     */
     minDate?: TDateType;
+    /**
+     * [ID] : Tanggal maksimum (opsional).
+     * [EN] : Maximum date (optional).
+     */
     maxDate?: TDateType;
+    /**
+     * [ID] : Label waktu (opsional).
+     * [EN] : Time label (optional).
+     */
     timeLabel?: string;
+    /**
+     * [ID] : Menyembunyikan header (opsional).
+     * [EN] : Hide header (optional).
+     */
     hiddenHeader?: boolean;
+    /**
+     * [ID] : Tipe waktu (mulai atau selesai).
+     * [EN] : Time type (start or end).
+     */
     type: 'start' | 'end';
+    /**
+     * [ID] : Handler perubahan waktu (opsional).
+     * [EN] : Time change handler (optional).
+     * @param v - [ID] : Waktu baru. [EN] : New time.
+     */
     handlerChangeTime?: (v: ITimeCalendar) => void;
 }
+/**
+ * [ID] : Interface untuk tombol kalender.
+ * [EN] : Interface for calendar button.
+ */
 export interface ICalendarButton extends AriaButtonOptions<'button'> {
+    /**
+     * [ID] : Konten anak tombol.
+     * [EN] : Button child content.
+     */
     children: ReactNode | ReactNode[];
 }
+/**
+ * [ID] : Interface untuk sel kalender.
+ * [EN] : Interface for calendar cell.
+ */
 export interface ICalendarCell {
+    /**
+     * [ID] : State kalender.
+     * [EN] : Calendar state.
+     */
     state: RangeCalendarState | CalendarState;
+    /**
+     * [ID] : Tanggal sel.
+     * [EN] : Cell date.
+     */
     date: CalendarDate;
 }
+/**
+ * [ID] : Interface untuk tampilan bulan kalender.
+ * [EN] : Interface for calendar month view.
+ */
 export interface ICalendarMonth extends ICalendarPrevNextIcon {
+    /**
+     * [ID] : State kalender.
+     * [EN] : Calendar state.
+     */
     state: CalendarState | RangeCalendarState;
+    /**
+     * [ID] : Tipe-tipe kalender yang tersedia.
+     * [EN] : Available calendar types.
+     */
     type: TCalendarType[];
+    /**
+     * [ID] : Fungsi untuk mengatur tipe kalender aktif.
+     * [EN] : Function to set active calendar type.
+     * @param v - [ID] : Tipe kalender. [EN] : Calendar type.
+     */
     setActiveTypeCalendar: (v: TCalendarType) => void;
+    /**
+     * [ID] : Menampilkan pilihan tanggal (opsional).
+     * [EN] : Show date selection (optional).
+     */
     withDateSelect?: boolean;
+    /**
+     * [ID] : Handler perubahan bulan (opsional).
+     * [EN] : Month change handler (optional).
+     * @param v - [ID] : Tanggal baru. [EN] : New date.
+     */
     onChangeMonth?: (v: CalendarDate) => void;
+    /**
+     * [ID] : Menyembunyikan header (opsional).
+     * [EN] : Hide header (optional).
+     */
     hiddenHeader?: boolean;
 }
+/**
+ * [ID] : Interface untuk pengaturan tahun.
+ * [EN] : Interface for year setup.
+ */
 export interface ISetUpYear {
+    /**
+     * [ID] : Tahun mulai.
+     * [EN] : Start year.
+     */
     startYear: number;
+    /**
+     * [ID] : Akhir setelah tahun ini.
+     * [EN] : End after this year.
+     */
     endAfterThisYear: number;
 }
+/**
+ * [ID] : Interface untuk tampilan tahun kalender.
+ * [EN] : Interface for calendar year view.
+ */
 export interface ICalendarYear {
+    /**
+     * [ID] : Judul tampilan tahun.
+     * [EN] : Year view title.
+     */
     title: string;
+    /**
+     * [ID] : State kalender.
+     * [EN] : Calendar state.
+     */
     state: CalendarState | RangeCalendarState;
+    /**
+     * [ID] : Pengaturan tahun (opsional).
+     * [EN] : Year setup (optional).
+     */
     setUpYear?: ISetUpYear;
+    /**
+     * [ID] : Tipe-tipe kalender yang tersedia.
+     * [EN] : Available calendar types.
+     */
     type: TCalendarType[];
+    /**
+     * [ID] : Fungsi untuk mengatur tipe kalender aktif.
+     * [EN] : Function to set active calendar type.
+     * @param v - [ID] : Tipe kalender. [EN] : Calendar type.
+     */
     setActiveTypeCalendar: (v: TCalendarType) => void;
+    /**
+     * [ID] : Handler perubahan tahun (opsional).
+     * [EN] : Year change handler (optional).
+     * @param v - [ID] : Tanggal baru. [EN] : New date.
+     */
     onChangeYear?: (v: CalendarDate) => void;
+    /**
+     * [ID] : Menyembunyikan header (opsional).
+     * [EN] : Hide header (optional).
+     */
     hiddenHeader?: boolean;
 }
+/**
+ * [ID] : Interface untuk rentang tanggal.
+ * [EN] : Interface for date range.
+ */
 export interface IDateRange {
+    /**
+     * [ID] : Tanggal mulai.
+     * [EN] : Start date.
+     */
     startDate: TDateType;
+    /**
+     * [ID] : Tanggal selesai.
+     * [EN] : End date.
+     */
     endDate: TDateType;
+    /**
+     * [ID] : Label rentang (opsional).
+     * [EN] : Range label (optional).
+     */
     label?: string;
 }
+/**
+ * [ID] : Interface untuk kalender rentang tanggal.
+ * [EN] : Interface for date range calendar.
+ */
 export interface ICalendarDateRange extends RangeCalendarProps<DateValue>, ICalendarPrevNextIcon, ICalendarButtonConfirm {
+    /**
+     * [ID] : Menampilkan tombol konfirmasi (opsional).
+     * [EN] : Show confirm buttons (optional).
+     */
     withConfirm?: boolean;
+    /**
+     * [ID] : Menggunakan waktu kustom (opsional).
+     * [EN] : Use custom time (optional).
+     */
     isCustomTime?: boolean;
+    /**
+     * [ID] : Tanggal minimum (opsional).
+     * [EN] : Minimum date (optional).
+     */
     minDate?: TDateType;
+    /**
+     * [ID] : Tanggal maksimum (opsional).
+     * [EN] : Maximum date (optional).
+     */
     maxDate?: TDateType;
+    /**
+     * [ID] : Rentang waktu (opsional).
+     * [EN] : Time range (optional).
+     */
     time?: ITimeCalendarRange;
+    /**
+     * [ID] : Handler perubahan rentang waktu (opsional).
+     * [EN] : Time range change handler (optional).
+     * @param v - [ID] : Rentang waktu baru. [EN] : New time range.
+     */
     handlerChangeTimeRange?: (v: ITimeCalendarRange) => void;
+    /**
+     * [ID] : Handler submit.
+     * [EN] : Submit handler.
+     */
     handlerSubmit: () => void;
+    /**
+     * [ID] : Handler reset.
+     * [EN] : Reset handler.
+     * @param v - [ID] : State kalender rentang. [EN] : Range calendar state.
+     */
     handlerReset: (v: RangeCalendarState) => void;
 }
+/**
+ * [ID] : Interface untuk kalender rentang.
+ * [EN] : Interface for range calendar.
+ */
 export interface ICalendarRange extends DateRangePickerStateOptions, ICalendarPrevNextIcon, ICalendarButtonConfirm {
+    /**
+     * [ID] : Menampilkan tombol konfirmasi (opsional).
+     * [EN] : Show confirm buttons (optional).
+     */
     withConfirm?: boolean;
+    /**
+     * [ID] : Menggunakan waktu kustom (opsional).
+     * [EN] : Use custom time (optional).
+     */
     isCustomTime?: boolean;
+    /**
+     * [ID] : Tanggal minimum (opsional).
+     * [EN] : Minimum date (optional).
+     */
     minDate?: TDateType;
+    /**
+     * [ID] : Tanggal maksimum (opsional).
+     * [EN] : Maximum date (optional).
+     */
     maxDate?: TDateType;
+    /**
+     * [ID] : Rentang waktu (opsional).
+     * [EN] : Time range (optional).
+     */
     time?: ITimeCalendarRange;
+    /**
+     * [ID] : Handler perubahan rentang waktu (opsional).
+     * [EN] : Time range change handler (optional).
+     * @param v - [ID] : Rentang waktu baru. [EN] : New time range.
+     */
     handlerChangeTimeRange?: (v: ITimeCalendarRange) => void;
+    /**
+     * [ID] : Handler submit.
+     * [EN] : Submit handler.
+     */
     handlerSubmit: () => void;
+    /**
+     * [ID] : Handler reset.
+     * [EN] : Reset handler.
+     * @param v - [ID] : State kalender rentang. [EN] : Range calendar state.
+     */
     handlerReset: (v: RangeCalendarState) => void;
 }