@farmzone/fz-react-ui 1.0.3 → 1.0.5

package/dist/index.d.cts

@@ -26,7 +26,7 @@ interface BadgeProps {
 }
 declare function Badge(props: BadgeProps): react.JSX.Element;
 
-type ButtonVariant = "outline" | "save" | "delete" | "reset" | "search" | "file" | "carousel" | "accent" | "ghost" | "link";
+type ButtonVariant = "outline" | "save" | "delete" | "reset" | "search" | "file" | "carousel" | "accent" | "ghost" | "link" | "metal";
 type ButtonSize = "default" | "sm" | "lg" | "icon" | "icon-sm" | "icon-lg" | "link";
 interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     ref?: Ref<HTMLButtonElement>;
@@ -571,6 +571,7 @@ interface ModalIconHeaderProps {
 declare function ModalIconHeader(props: ModalIconHeaderProps): react.JSX.Element;
 
 interface ModalOverlayProps {
+    ref?: Ref<HTMLDivElement>;
     isOpen: boolean;
     onClose?: () => void;
     className?: string;
@@ -612,7 +613,16 @@ interface TableFooterProps {
     renderRight?: ReactNode;
 }
 
+interface PageParams {
+    page: number;
+    size: number;
+}
 type SortOrder = "asc" | "desc";
+interface SortParams {
+    sortBy: string;
+    sortOrder: SortOrder;
+}
+type BaseParams = PageParams & SortParams;
 
 type TableFixed = "left" | "right";
 interface SortOption {
@@ -890,6 +900,7 @@ interface FormFieldConfig<TFieldValues extends FieldValues = FieldValues> {
     selectWithInputClassNames?: SelectWithInputFieldClassNames;
     inputWithButton?: InputWithButtonFieldConfig;
     onClickInputWithButton?: () => void;
+    autoComplete?: string;
 }
 interface CustomFieldRenderProps<TFieldValues extends FieldValues = FieldValues> {
     field: ControllerRenderProps<TFieldValues, Path<TFieldValues>>;
@@ -909,6 +920,7 @@ interface SubmitFormProps<TSchema extends z.ZodTypeAny = z.ZodTypeAny> {
      * blur 검증은 FormField가 `trigger`로 수동 실행.
      */
     mode?: "onBlur" | "onChange" | "onSubmit" | "onTouched" | "all";
+    autoComplete?: string;
 }
 
 declare function FormTable<TFieldValues extends FieldValues = FieldValues>(props: FormTableProps<TFieldValues>): react.JSX.Element;
@@ -978,6 +990,7 @@ interface PageFilterProps<P> {
     submitButtonText?: string;
     resetButtonText?: string;
     values: P;
+    primaryColor?: string;
 }
 declare function PageFilter<P extends Record<keyof P, string>>(props: PageFilterProps<P>): react.JSX.Element;
 
@@ -1128,6 +1141,7 @@ type SidebarVariant = "light" | "dark" | "system-dark" | "system-light";
 interface SidebarProps {
     menuSections: Array<MenuSection>;
     header?: ReactNode;
+    footer?: ReactNode;
     className?: string;
     showCollapseButton?: boolean;
     onClose?: () => void;
@@ -1324,6 +1338,18 @@ declare function useFilePreviewViewer<T extends string = string>(files: FilePrev
     viewerProps: FilePreviewViewerProps<T>;
 };
 
+interface UseParams<P extends BaseParams> {
+    localParams: P;
+    params: P;
+    updateParam: (key: keyof P, value: P[keyof P]) => void;
+    updateLocalParam: (key: keyof P, value: P[keyof P]) => void;
+    update: () => void;
+    reset: () => void;
+    handleSortChange: (sortKey: string, sortOrder: SortOrder) => void;
+    sortOption: SortOption | undefined;
+}
+declare function useParams<P extends BaseParams>(initialParams: P): UseParams<P>;
+
 interface ArrowIconProps extends SVGProps<SVGSVGElement> {
     direction?: "up" | "down";
 }
@@ -1331,7 +1357,7 @@ declare function ArrowIcon(props: ArrowIconProps): react.JSX.Element;
 
 declare function cn(...inputs: Array<ClassValue>): string;
 declare const buttonVariants: (props?: ({
-    variant?: "outline" | "save" | "delete" | "reset" | "search" | "file" | "carousel" | "accent" | "ghost" | "link" | null | undefined;
+    variant?: "outline" | "save" | "delete" | "reset" | "search" | "file" | "carousel" | "accent" | "metal" | "ghost" | "link" | null | undefined;
     size?: "link" | "default" | "sm" | "lg" | "icon" | "icon-sm" | "icon-lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const textVariants: (props?: ({
@@ -1368,4 +1394,4 @@ declare const Z_INDEX: {
 };
 type ZIndexKey = keyof typeof Z_INDEX;
 
-export { ArrowIcon, Badge, type BadgeProps, BaseUploader, type BaseUploaderProps, BreadCrumb, type BreadCrumbItem, type BreadCrumbMenuItem, type BreadCrumbProps, type BreadCrumbRoot, Button, type ButtonProps, type ButtonSize, type ButtonVariant, type CalendarYearRange, Carousel, type CarouselProps, type CarouselRef, Checkbox, type CheckboxProps, type Column, type ConfirmOptions, DatePicker, DebouncedButton, type DebouncedButtonProps, DetailContent, type DetailContentProps, type DetailField, type DetailFieldOrSection, DetailModalFrame, type DetailMode, DetailPageFrame, Empty, ExcelUploader, FilePreviewViewer, FileUploader, type FilterRow, type FormFieldConfig, Input, type InputProps, Loading, LoadingOverlay, type LoadingOverlayProps, type LoadingProps, type MenuChild, type MenuGrandchild, type MenuItem, type MenuSection, Modal, ModalBody, ModalContent, ModalFooter, ModalHeader, ModalIconHeader, type ModalIconHeaderProps, ModalOverlay, type ModalProps, type ModalType, MultiTabBar as MultiTab, type MultiTab as MultiTabItem, PageFilter, Pagination, type PaginationProps, Popover, type PopoverAlign, PopoverAnchor, PopoverClose, PopoverContent, type PopoverContentProps, PopoverDescription, PopoverFooter, PopoverHeader, type PopoverPosition, PopoverTitle, PopoverTrigger, Radio, RadioGroup, type RadioGroupProps, type RadioOptionType, type RadioProps, ScrollArea, ScrollBar, SearchAddress, type SearchAddressProps, SearchBar, type SearchBarProps, Select, Select$1 as SelectBase, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOptionType, type SelectProps, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Sidebar, type SidebarProps, SimplePopover, type SimplePopoverProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type SortOption, Spinner, type SpinnerColor, type SpinnerProps, type SpinnerSize, SubmitForm, Switch, type SwitchProps, Tab, type TabItem, type TabProps, Table, Textarea, type TextareaProps, type ToastPosition, type ToastProps, ToastProvider, type ToastType, ToggleSwitch, Tooltip, type TooltipProps, type YmdDateString, type ZIndexKey, Z_INDEX, buildBreadCrumbItems, buttonVariants, cn, confirmModal, findParentMenuItem, findParentMenuName, formatDate, getFileLabel, getPreviewFileType, isCalendarDayAfterMax, isDateInRange, switchTrackSizes, textVariants, toast, useBlockModalConfirm, useBreadCrumbItems, useCustomBlocker, useDetailController, useFilePreviewViewer, useModal, useMultiTabStore, useScrollToTop, useStableImageSrc, useToast, validateAndFormatInput };
+export { ArrowIcon, Badge, type BadgeProps, type BaseParams, BaseUploader, type BaseUploaderProps, BreadCrumb, type BreadCrumbItem, type BreadCrumbMenuItem, type BreadCrumbProps, type BreadCrumbRoot, Button, type ButtonProps, type ButtonSize, type ButtonVariant, type CalendarYearRange, Carousel, type CarouselProps, type CarouselRef, Checkbox, type CheckboxProps, type Column, type ConfirmOptions, DatePicker, DebouncedButton, type DebouncedButtonProps, DetailContent, type DetailContentProps, type DetailField, type DetailFieldOrSection, DetailModalFrame, type DetailMode, DetailPageFrame, Empty, ExcelUploader, FilePreviewViewer, FileUploader, type FilterRow, type FormFieldConfig, Input, type InputProps, Loading, LoadingOverlay, type LoadingOverlayProps, type LoadingProps, type MenuChild, type MenuGrandchild, type MenuItem, type MenuSection, Modal, ModalBody, ModalContent, ModalFooter, ModalHeader, ModalIconHeader, type ModalIconHeaderProps, ModalOverlay, type ModalProps, type ModalType, MultiTabBar as MultiTab, type MultiTab as MultiTabItem, PageFilter, type PageParams, Pagination, type PaginationProps, Popover, type PopoverAlign, PopoverAnchor, PopoverClose, PopoverContent, type PopoverContentProps, PopoverDescription, PopoverFooter, PopoverHeader, type PopoverPosition, PopoverTitle, PopoverTrigger, Radio, RadioGroup, type RadioGroupProps, type RadioOptionType, type RadioProps, ScrollArea, ScrollBar, SearchAddress, type SearchAddressProps, SearchBar, type SearchBarProps, Select, Select$1 as SelectBase, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOptionType, type SelectProps, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Sidebar, type SidebarProps, SimplePopover, type SimplePopoverProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type SortOption, type SortOrder, type SortParams, Spinner, type SpinnerColor, type SpinnerProps, type SpinnerSize, SubmitForm, Switch, type SwitchProps, Tab, type TabItem, type TabProps, Table, Textarea, type TextareaProps, type ToastPosition, type ToastProps, ToastProvider, type ToastType, ToggleSwitch, Tooltip, type TooltipProps, type UseParams, type YmdDateString, type ZIndexKey, Z_INDEX, buildBreadCrumbItems, buttonVariants, cn, confirmModal, findParentMenuItem, findParentMenuName, formatDate, getFileLabel, getPreviewFileType, isCalendarDayAfterMax, isDateInRange, switchTrackSizes, textVariants, toast, useBlockModalConfirm, useBreadCrumbItems, useCustomBlocker, useDetailController, useFilePreviewViewer, useModal, useMultiTabStore, useParams, useScrollToTop, useStableImageSrc, useToast, validateAndFormatInput };

package/dist/index.d.ts

@@ -26,7 +26,7 @@ interface BadgeProps {
 }
 declare function Badge(props: BadgeProps): react.JSX.Element;
 
-type ButtonVariant = "outline" | "save" | "delete" | "reset" | "search" | "file" | "carousel" | "accent" | "ghost" | "link";
+type ButtonVariant = "outline" | "save" | "delete" | "reset" | "search" | "file" | "carousel" | "accent" | "ghost" | "link" | "metal";
 type ButtonSize = "default" | "sm" | "lg" | "icon" | "icon-sm" | "icon-lg" | "link";
 interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     ref?: Ref<HTMLButtonElement>;
@@ -571,6 +571,7 @@ interface ModalIconHeaderProps {
 declare function ModalIconHeader(props: ModalIconHeaderProps): react.JSX.Element;
 
 interface ModalOverlayProps {
+    ref?: Ref<HTMLDivElement>;
     isOpen: boolean;
     onClose?: () => void;
     className?: string;
@@ -612,7 +613,16 @@ interface TableFooterProps {
     renderRight?: ReactNode;
 }
 
+interface PageParams {
+    page: number;
+    size: number;
+}
 type SortOrder = "asc" | "desc";
+interface SortParams {
+    sortBy: string;
+    sortOrder: SortOrder;
+}
+type BaseParams = PageParams & SortParams;
 
 type TableFixed = "left" | "right";
 interface SortOption {
@@ -890,6 +900,7 @@ interface FormFieldConfig<TFieldValues extends FieldValues = FieldValues> {
     selectWithInputClassNames?: SelectWithInputFieldClassNames;
     inputWithButton?: InputWithButtonFieldConfig;
     onClickInputWithButton?: () => void;
+    autoComplete?: string;
 }
 interface CustomFieldRenderProps<TFieldValues extends FieldValues = FieldValues> {
     field: ControllerRenderProps<TFieldValues, Path<TFieldValues>>;
@@ -909,6 +920,7 @@ interface SubmitFormProps<TSchema extends z.ZodTypeAny = z.ZodTypeAny> {
      * blur 검증은 FormField가 `trigger`로 수동 실행.
      */
     mode?: "onBlur" | "onChange" | "onSubmit" | "onTouched" | "all";
+    autoComplete?: string;
 }
 
 declare function FormTable<TFieldValues extends FieldValues = FieldValues>(props: FormTableProps<TFieldValues>): react.JSX.Element;
@@ -978,6 +990,7 @@ interface PageFilterProps<P> {
     submitButtonText?: string;
     resetButtonText?: string;
     values: P;
+    primaryColor?: string;
 }
 declare function PageFilter<P extends Record<keyof P, string>>(props: PageFilterProps<P>): react.JSX.Element;
 
@@ -1128,6 +1141,7 @@ type SidebarVariant = "light" | "dark" | "system-dark" | "system-light";
 interface SidebarProps {
     menuSections: Array<MenuSection>;
     header?: ReactNode;
+    footer?: ReactNode;
     className?: string;
     showCollapseButton?: boolean;
     onClose?: () => void;
@@ -1324,6 +1338,18 @@ declare function useFilePreviewViewer<T extends string = string>(files: FilePrev
     viewerProps: FilePreviewViewerProps<T>;
 };
 
+interface UseParams<P extends BaseParams> {
+    localParams: P;
+    params: P;
+    updateParam: (key: keyof P, value: P[keyof P]) => void;
+    updateLocalParam: (key: keyof P, value: P[keyof P]) => void;
+    update: () => void;
+    reset: () => void;
+    handleSortChange: (sortKey: string, sortOrder: SortOrder) => void;
+    sortOption: SortOption | undefined;
+}
+declare function useParams<P extends BaseParams>(initialParams: P): UseParams<P>;
+
 interface ArrowIconProps extends SVGProps<SVGSVGElement> {
     direction?: "up" | "down";
 }
@@ -1331,7 +1357,7 @@ declare function ArrowIcon(props: ArrowIconProps): react.JSX.Element;
 
 declare function cn(...inputs: Array<ClassValue>): string;
 declare const buttonVariants: (props?: ({
-    variant?: "outline" | "save" | "delete" | "reset" | "search" | "file" | "carousel" | "accent" | "ghost" | "link" | null | undefined;
+    variant?: "outline" | "save" | "delete" | "reset" | "search" | "file" | "carousel" | "accent" | "metal" | "ghost" | "link" | null | undefined;
     size?: "link" | "default" | "sm" | "lg" | "icon" | "icon-sm" | "icon-lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const textVariants: (props?: ({
@@ -1368,4 +1394,4 @@ declare const Z_INDEX: {
 };
 type ZIndexKey = keyof typeof Z_INDEX;
 
-export { ArrowIcon, Badge, type BadgeProps, BaseUploader, type BaseUploaderProps, BreadCrumb, type BreadCrumbItem, type BreadCrumbMenuItem, type BreadCrumbProps, type BreadCrumbRoot, Button, type ButtonProps, type ButtonSize, type ButtonVariant, type CalendarYearRange, Carousel, type CarouselProps, type CarouselRef, Checkbox, type CheckboxProps, type Column, type ConfirmOptions, DatePicker, DebouncedButton, type DebouncedButtonProps, DetailContent, type DetailContentProps, type DetailField, type DetailFieldOrSection, DetailModalFrame, type DetailMode, DetailPageFrame, Empty, ExcelUploader, FilePreviewViewer, FileUploader, type FilterRow, type FormFieldConfig, Input, type InputProps, Loading, LoadingOverlay, type LoadingOverlayProps, type LoadingProps, type MenuChild, type MenuGrandchild, type MenuItem, type MenuSection, Modal, ModalBody, ModalContent, ModalFooter, ModalHeader, ModalIconHeader, type ModalIconHeaderProps, ModalOverlay, type ModalProps, type ModalType, MultiTabBar as MultiTab, type MultiTab as MultiTabItem, PageFilter, Pagination, type PaginationProps, Popover, type PopoverAlign, PopoverAnchor, PopoverClose, PopoverContent, type PopoverContentProps, PopoverDescription, PopoverFooter, PopoverHeader, type PopoverPosition, PopoverTitle, PopoverTrigger, Radio, RadioGroup, type RadioGroupProps, type RadioOptionType, type RadioProps, ScrollArea, ScrollBar, SearchAddress, type SearchAddressProps, SearchBar, type SearchBarProps, Select, Select$1 as SelectBase, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOptionType, type SelectProps, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Sidebar, type SidebarProps, SimplePopover, type SimplePopoverProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type SortOption, Spinner, type SpinnerColor, type SpinnerProps, type SpinnerSize, SubmitForm, Switch, type SwitchProps, Tab, type TabItem, type TabProps, Table, Textarea, type TextareaProps, type ToastPosition, type ToastProps, ToastProvider, type ToastType, ToggleSwitch, Tooltip, type TooltipProps, type YmdDateString, type ZIndexKey, Z_INDEX, buildBreadCrumbItems, buttonVariants, cn, confirmModal, findParentMenuItem, findParentMenuName, formatDate, getFileLabel, getPreviewFileType, isCalendarDayAfterMax, isDateInRange, switchTrackSizes, textVariants, toast, useBlockModalConfirm, useBreadCrumbItems, useCustomBlocker, useDetailController, useFilePreviewViewer, useModal, useMultiTabStore, useScrollToTop, useStableImageSrc, useToast, validateAndFormatInput };
+export { ArrowIcon, Badge, type BadgeProps, type BaseParams, BaseUploader, type BaseUploaderProps, BreadCrumb, type BreadCrumbItem, type BreadCrumbMenuItem, type BreadCrumbProps, type BreadCrumbRoot, Button, type ButtonProps, type ButtonSize, type ButtonVariant, type CalendarYearRange, Carousel, type CarouselProps, type CarouselRef, Checkbox, type CheckboxProps, type Column, type ConfirmOptions, DatePicker, DebouncedButton, type DebouncedButtonProps, DetailContent, type DetailContentProps, type DetailField, type DetailFieldOrSection, DetailModalFrame, type DetailMode, DetailPageFrame, Empty, ExcelUploader, FilePreviewViewer, FileUploader, type FilterRow, type FormFieldConfig, Input, type InputProps, Loading, LoadingOverlay, type LoadingOverlayProps, type LoadingProps, type MenuChild, type MenuGrandchild, type MenuItem, type MenuSection, Modal, ModalBody, ModalContent, ModalFooter, ModalHeader, ModalIconHeader, type ModalIconHeaderProps, ModalOverlay, type ModalProps, type ModalType, MultiTabBar as MultiTab, type MultiTab as MultiTabItem, PageFilter, type PageParams, Pagination, type PaginationProps, Popover, type PopoverAlign, PopoverAnchor, PopoverClose, PopoverContent, type PopoverContentProps, PopoverDescription, PopoverFooter, PopoverHeader, type PopoverPosition, PopoverTitle, PopoverTrigger, Radio, RadioGroup, type RadioGroupProps, type RadioOptionType, type RadioProps, ScrollArea, ScrollBar, SearchAddress, type SearchAddressProps, SearchBar, type SearchBarProps, Select, Select$1 as SelectBase, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOptionType, type SelectProps, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Sidebar, type SidebarProps, SimplePopover, type SimplePopoverProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type SortOption, type SortOrder, type SortParams, Spinner, type SpinnerColor, type SpinnerProps, type SpinnerSize, SubmitForm, Switch, type SwitchProps, Tab, type TabItem, type TabProps, Table, Textarea, type TextareaProps, type ToastPosition, type ToastProps, ToastProvider, type ToastType, ToggleSwitch, Tooltip, type TooltipProps, type UseParams, type YmdDateString, type ZIndexKey, Z_INDEX, buildBreadCrumbItems, buttonVariants, cn, confirmModal, findParentMenuItem, findParentMenuName, formatDate, getFileLabel, getPreviewFileType, isCalendarDayAfterMax, isDateInRange, switchTrackSizes, textVariants, toast, useBlockModalConfirm, useBreadCrumbItems, useCustomBlocker, useDetailController, useFilePreviewViewer, useModal, useMultiTabStore, useParams, useScrollToTop, useStableImageSrc, useToast, validateAndFormatInput };