@sonamu-kit/react-components 0.1.6 → 0.1.8

package/dist/components/index.d.ts

@@ -46,7 +46,8 @@ export { Progress } from './ui/progress';
 export { RadioGroup, RadioGroupItem } from './ui/radio-group';
 export { ResizableHandle, ResizablePanel, ResizablePanelGroup, } from './ui/resizable';
 export { ScrollArea, ScrollBar } from './ui/scroll-area';
-export { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, } from './ui/select';
+export type { SelectItemDef, SelectProps } from './ui/select';
+export { Select } from './ui/select';
 export { Separator } from './ui/separator';
 export { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, } from './ui/sheet';
 export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, useSidebar, } from './ui/sidebar';

package/dist/components/ui/checkbox.d.ts

@@ -1,7 +1,8 @@
 import * as CheckboxPrimitive from "@radix-ui/react-checkbox";
 import * as React from "react";
-declare const Checkbox: React.ForwardRefExoticComponent<Omit<Omit<CheckboxPrimitive.CheckboxProps & React.RefAttributes<HTMLButtonElement>, "ref">, "label" | "onBlur" | "name" | "onValueChange" | "labelClassName"> & {
+declare const Checkbox: React.ForwardRefExoticComponent<Omit<Omit<CheckboxPrimitive.CheckboxProps & React.RefAttributes<HTMLButtonElement>, "ref">, "label" | "onBlur" | "value" | "name" | "onValueChange" | "labelClassName"> & {
     name?: string;
+    value?: boolean;
     onValueChange?: (checked: boolean) => void;
     onBlur?: React.FocusEventHandler<HTMLInputElement>;
     label?: React.ReactNode;

package/dist/components/ui/date-selector-multiple.d.ts

@@ -20,9 +20,7 @@ interface DateSelectorMultipleProps {
     /** Current value */
     value?: DateSelectorValue;
     /** Callback when value changes */
-    onChange?: (event: null, data: {
-        value: DateSelectorValue | undefined;
-    }) => void;
+    onValueChange?: (value: DateSelectorValue | undefined) => void;
     /** Placeholder text when no value */
     placeholder?: string;
     /** Date format string for display */
@@ -34,5 +32,5 @@ interface DateSelectorMultipleProps {
     /** Default to range mode when opening */
     defaultRangeMode?: boolean;
 }
-export declare function DateSelectorMultiple({ CalendarIcon, ChevronDownIcon, value, onChange, placeholder, dateFormat, className, numberOfMonths, defaultRangeMode, }: DateSelectorMultipleProps): import("react/jsx-runtime").JSX.Element;
+export declare function DateSelectorMultiple({ CalendarIcon, ChevronDownIcon, value, onValueChange, placeholder, dateFormat, className, numberOfMonths, defaultRangeMode, }: DateSelectorMultipleProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ui/month-picker-multiple.d.ts

@@ -20,9 +20,7 @@ interface MonthPickerMultipleProps {
     /** Current value */
     value?: MonthPickerValue;
     /** Callback when value changes */
-    onChange?: (event: null, data: {
-        value: MonthPickerValue | undefined;
-    }) => void;
+    onValueChange?: (value: MonthPickerValue | undefined) => void;
     /** Placeholder text when no value */
     placeholder?: string;
     /** Date format string for display */
@@ -37,5 +35,5 @@ interface MonthPickerMultipleProps {
     /** Default to range mode when opening */
     defaultRangeMode?: boolean;
 }
-export declare function MonthPickerMultiple({ CalendarIcon, ChevronDownIcon, value, onChange, placeholder, dateFormat, className, yearRange, defaultRangeMode, }: MonthPickerMultipleProps): import("react/jsx-runtime").JSX.Element;
+export declare function MonthPickerMultiple({ CalendarIcon, ChevronDownIcon, value, onValueChange, placeholder, dateFormat, className, yearRange, defaultRangeMode, }: MonthPickerMultipleProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/ui/multi-select.d.ts

@@ -69,8 +69,10 @@ interface MultiSelectProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonEle
      * Receives an array of the new selected values.
      */
     onValueChange: (value: string[]) => void;
-    /** The default selected values when the component mounts. */
-    defaultValue?: string[];
+    /**
+     * The current selected values.
+     */
+    value: string[];
     /**
      * Placeholder text to be displayed when no values are selected.
      * Optional, defaults to "Select options".
@@ -187,12 +189,6 @@ interface MultiSelectProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonEle
      * Optional, defaults to false (shows warning in dev mode instead).
      */
     deduplicateOptions?: boolean;
-    /**
-     * If true, the component will reset its internal state when defaultValue changes.
-     * Useful for React Hook Form integration and form reset functionality.
-     * Optional, defaults to true.
-     */
-    resetOnDefaultValueChange?: boolean;
     /**
      * If true, automatically closes the popover after selecting an option.
      * Useful for single-selection-like behavior or mobile UX.
@@ -215,7 +211,7 @@ export interface MultiSelectRef {
     /**
      * Set selected values programmatically
      */
-    setSelectedValues: (values: string[]) => void;
+    handleValueChange: (values: string[]) => void;
     /**
      * Clear all selected values
      */

package/dist/components/ui/select.d.ts

@@ -1,20 +1,32 @@
 import { Override } from '../../lib/types';
 import * as SelectPrimitive from "@radix-ui/react-select";
 import * as React from "react";
-type SelectProps = Override<React.ComponentProps<typeof SelectPrimitive.Root>, {
+type ExtractValue<Item> = Item extends {
+    value: infer V;
+} ? V : Item;
+type SelectItemDef<V> = V | {
+    value: V;
+    label?: React.ReactNode;
+    disabled?: boolean;
+};
+type SelectPropsBase<Item> = Override<Omit<React.ComponentProps<typeof SelectPrimitive.Root>, "value" | "defaultValue" | "onValueChange" | "children">, {
     name?: string;
-    onValueChange?: (value: string | undefined | null) => void;
+    value?: ExtractValue<Item>;
+    defaultValue?: ExtractValue<Item>;
+    onValueChange?: (value: ExtractValue<Item> | undefined) => void;
     onBlur?: React.FocusEventHandler<HTMLSelectElement>;
+    items: Item[];
+    placeholder?: string;
     clearable?: boolean;
+    className?: string;
+    contentClassName?: string;
+    renderItem?: (value: ExtractValue<Item>) => React.ReactNode;
 }>;
-declare const Select: React.ForwardRefExoticComponent<SelectProps & React.RefAttributes<HTMLSelectElement>>;
-declare const SelectGroup: React.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & React.RefAttributes<HTMLDivElement>>;
-declare const SelectValue: React.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & React.RefAttributes<HTMLSpanElement>>;
-declare const SelectTrigger: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectTriggerProps & React.RefAttributes<HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
-declare const SelectScrollUpButton: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollUpButtonProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SelectScrollDownButton: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollDownButtonProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SelectContent: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SelectLabel: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectLabelProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SelectItem: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-declare const SelectSeparator: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectSeparatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export { Select, SelectGroup, SelectValue, SelectTrigger, SelectContent, SelectLabel, SelectItem, SelectSeparator, SelectScrollUpButton, SelectScrollDownButton, };
+type SelectProps<Item> = ExtractValue<Item> extends string | number ? SelectPropsBase<Item> & {
+    valueKey?: (value: ExtractValue<Item>) => string;
+} : SelectPropsBase<Item> & {
+    valueKey: (value: ExtractValue<Item>) => string;
+};
+declare const Select: <Item>(props: SelectProps<Item> & React.RefAttributes<HTMLSelectElement>) => React.ReactElement;
+export { Select };
+export type { SelectProps, SelectItemDef, ExtractValue };

package/dist/components/ui/switch.d.ts

@@ -1,7 +1,8 @@
 import * as SwitchPrimitives from "@radix-ui/react-switch";
 import * as React from "react";
-declare const Switch: React.ForwardRefExoticComponent<Omit<Omit<SwitchPrimitives.SwitchProps & React.RefAttributes<HTMLButtonElement>, "ref">, "onBlur" | "name" | "onValueChange"> & {
+declare const Switch: React.ForwardRefExoticComponent<Omit<Omit<SwitchPrimitives.SwitchProps & React.RefAttributes<HTMLButtonElement>, "ref">, "onBlur" | "value" | "name" | "onValueChange"> & {
     name?: string;
+    value?: boolean;
     onValueChange?: (checked: boolean) => void;
     onBlur?: React.FocusEventHandler<HTMLInputElement>;
 } & React.RefAttributes<HTMLInputElement>>;

package/dist/components/ui/toggle.d.ts

@@ -5,8 +5,11 @@ declare const toggleVariants: (props?: ({
     variant?: "default" | "outline" | null | undefined;
     size?: "default" | "sm" | "lg" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
-declare const Toggle: React.ForwardRefExoticComponent<Omit<TogglePrimitive.ToggleProps & React.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: ({
+declare const Toggle: React.ForwardRefExoticComponent<Omit<Omit<TogglePrimitive.ToggleProps & React.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: ({
     variant?: "default" | "outline" | null | undefined;
     size?: "default" | "sm" | "lg" | null | undefined;
-} & import('class-variance-authority/types').ClassProp) | undefined) => string> & React.RefAttributes<HTMLButtonElement>>;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string>, "value" | "onValueChange"> & {
+    value?: boolean;
+    onValueChange?: (pressed: boolean) => void;
+} & React.RefAttributes<HTMLButtonElement>>;
 export { Toggle, toggleVariants };

package/dist/contexts/index.d.ts

@@ -1,2 +1,2 @@
-export { type SonamuContextValue, SonamuProvider, useSonamuContext, } from './sonamu-context';
-export type { SonamuAuth, SonamuFile } from './types';
+export { type SonamuContextValue, SonamuProvider, useSonamuBaseContext, } from './sonamu-context';
+export type { Dictionary, SDReturnType, SonamuAuth, SonamuFile } from './types';

package/dist/contexts/sonamu-context.d.ts

@@ -1,12 +1,21 @@
 import { ReactNode } from 'react';
 import { Dictionary, SDReturnType, SonamuAuth, SonamuFile } from './types';
-export interface SonamuContextValue<D extends Dictionary = Dictionary> {
+export interface SonamuContextValue<D extends Dictionary = Dictionary, TUser = any, TLoginParams = any> {
     uploader?: (files: File[]) => Promise<SonamuFile[]>;
-    auth?: SonamuAuth;
-    SD: <K extends keyof D>(key: K) => SDReturnType<D, K>;
+    auth?: SonamuAuth<TUser, TLoginParams>;
+    SD?: <K extends keyof D>(key: K) => SDReturnType<D, K>;
 }
-export interface SonamuProviderProps<D extends Dictionary = Dictionary> extends SonamuContextValue<D> {
+export interface SonamuProviderProps<D extends Dictionary = Dictionary, TUser = any, TLoginParams = any> extends SonamuContextValue<D, TUser, TLoginParams> {
     children: ReactNode;
 }
-export declare function SonamuProvider<D extends Dictionary = Dictionary>({ children, ...value }: SonamuProviderProps<D>): import("react/jsx-runtime").JSX.Element;
-export declare function useSonamuContext<D extends Dictionary = Dictionary>(): Required<SonamuContextValue<D>>;
+export declare function SonamuProvider<D extends Dictionary = Dictionary, TUser = any, TLoginParams = any>({ children, ...value }: SonamuProviderProps<D, TUser, TLoginParams>): import("react/jsx-runtime").JSX.Element;
+/**
+ * 타입이 지정된 useSonamuContext를 만들기 위한 베이스 훅
+ *
+ * @example
+ * // contexts/sonamu-provider.tsx
+ * export function useSonamuContext() {
+ *   return useSonamuBaseContext<MergedDictionary, UserSubsetSS, UserLoginParams>();
+ * }
+ */
+export declare function useSonamuBaseContext<D extends Dictionary = Dictionary, TUser = any, TLoginParams = any>(): Required<SonamuContextValue<D, TUser, TLoginParams>>;

package/dist/i18n/rc-keys.d.ts

@@ -0,0 +1,120 @@
+/**
+ * React Components i18n Keys
+ *
+ * react-components의 i18n 키를 관리하는 Single Source of Truth
+ *
+ */
+export declare const rcKeysKo: {
+    "rc.asyncSelect.loading": string;
+    "rc.asyncSelect.noOptions": string;
+    "rc.asyncSelect.noResults": string;
+    "rc.asyncSelect.selectPlaceholder": string;
+    "rc.combobox.noResults": string;
+    "rc.combobox.selectPlaceholder": string;
+    "rc.datePicker.pickDate": string;
+    "rc.datePicker.placeholder": string;
+    "rc.datePicker.selectDate": string;
+    "rc.dateSelectorMultiple.addDate": string;
+    "rc.dateSelectorMultiple.dateRange": string;
+    "rc.dateSelectorMultiple.placeholder": string;
+    "rc.dateSelectorMultiple.singleDate": string;
+    "rc.fileInput.browseFiles": string;
+    "rc.fileInput.dropZone": string;
+    "rc.fileInput.filePlaceholder": string;
+    "rc.fileInput.imagePlaceholder": string;
+    "rc.fileInput.maxFilesExceeded": (maxFiles: number) => string;
+    "rc.fileInput.pending": string;
+    "rc.fileInput.remove": string;
+    "rc.fileInput.uploadFailed": string;
+    "rc.fileInput.uploading": string;
+    "rc.monthPickerMultiple.addMonth": string;
+    "rc.monthPickerMultiple.dateRange": string;
+    "rc.monthPickerMultiple.endDate": string;
+    "rc.monthPickerMultiple.placeholder": string;
+    "rc.monthPickerMultiple.singleDate": string;
+    "rc.monthPickerMultiple.startDate": string;
+    "rc.multiSelect.clear": string;
+    "rc.multiSelect.close": string;
+    "rc.multiSelect.moreItems": (count: number) => string;
+    "rc.multiSelect.noOptions": string;
+    "rc.multiSelect.noOptionsSelected": string;
+    "rc.multiSelect.noResults": string;
+    "rc.multiSelect.optionsCount": (count: number) => string;
+    "rc.multiSelect.selectAll": string;
+    "rc.multiSelect.selectPlaceholder": string;
+    "rc.pagination.next": string;
+    "rc.pagination.previous": string;
+    "rc.pagination.showing": (start: number, end: number, total: number) => string;
+    "rc.calendar.month.0": string;
+    "rc.calendar.month.1": string;
+    "rc.calendar.month.2": string;
+    "rc.calendar.month.3": string;
+    "rc.calendar.month.4": string;
+    "rc.calendar.month.5": string;
+    "rc.calendar.month.6": string;
+    "rc.calendar.month.7": string;
+    "rc.calendar.month.8": string;
+    "rc.calendar.month.9": string;
+    "rc.calendar.month.10": string;
+    "rc.calendar.month.11": string;
+    "rc.common.cancel": string;
+    "rc.common.save": string;
+};
+export type RCKeys = typeof rcKeysKo;
+export type RCKeyName = keyof RCKeys;
+export declare const rcKeysEn: {
+    "rc.asyncSelect.loading": string;
+    "rc.asyncSelect.noOptions": string;
+    "rc.asyncSelect.noResults": string;
+    "rc.asyncSelect.selectPlaceholder": string;
+    "rc.combobox.noResults": string;
+    "rc.combobox.selectPlaceholder": string;
+    "rc.datePicker.pickDate": string;
+    "rc.datePicker.placeholder": string;
+    "rc.datePicker.selectDate": string;
+    "rc.dateSelectorMultiple.addDate": string;
+    "rc.dateSelectorMultiple.dateRange": string;
+    "rc.dateSelectorMultiple.placeholder": string;
+    "rc.dateSelectorMultiple.singleDate": string;
+    "rc.fileInput.browseFiles": string;
+    "rc.fileInput.dropZone": string;
+    "rc.fileInput.filePlaceholder": string;
+    "rc.fileInput.imagePlaceholder": string;
+    "rc.fileInput.maxFilesExceeded": (maxFiles: number) => string;
+    "rc.fileInput.pending": string;
+    "rc.fileInput.remove": string;
+    "rc.fileInput.uploadFailed": string;
+    "rc.fileInput.uploading": string;
+    "rc.monthPickerMultiple.addMonth": string;
+    "rc.monthPickerMultiple.dateRange": string;
+    "rc.monthPickerMultiple.endDate": string;
+    "rc.monthPickerMultiple.placeholder": string;
+    "rc.monthPickerMultiple.singleDate": string;
+    "rc.monthPickerMultiple.startDate": string;
+    "rc.multiSelect.clear": string;
+    "rc.multiSelect.close": string;
+    "rc.multiSelect.moreItems": (count: number) => string;
+    "rc.multiSelect.noOptions": string;
+    "rc.multiSelect.noOptionsSelected": string;
+    "rc.multiSelect.noResults": string;
+    "rc.multiSelect.optionsCount": (count: number) => string;
+    "rc.multiSelect.selectAll": string;
+    "rc.multiSelect.selectPlaceholder": string;
+    "rc.pagination.next": string;
+    "rc.pagination.previous": string;
+    "rc.pagination.showing": (start: number, end: number, total: number) => string;
+    "rc.calendar.month.0": string;
+    "rc.calendar.month.1": string;
+    "rc.calendar.month.2": string;
+    "rc.calendar.month.3": string;
+    "rc.calendar.month.4": string;
+    "rc.calendar.month.5": string;
+    "rc.calendar.month.6": string;
+    "rc.calendar.month.7": string;
+    "rc.calendar.month.8": string;
+    "rc.calendar.month.9": string;
+    "rc.calendar.month.10": string;
+    "rc.calendar.month.11": string;
+    "rc.common.cancel": string;
+    "rc.common.save": string;
+};

package/dist/lib/utils.d.ts

@@ -1,5 +1,18 @@
 import { ClassValue } from 'clsx';
 export declare function cn(...inputs: ClassValue[]): string;
+/**
+ * 값을 배열로 정규화합니다.
+ * 이미 배열이면 그대로 반환하고, 단일 값이면 배열로 감싸서 반환합니다.
+ *
+ * @param value - 정규화할 값 (단일 값 또는 배열)
+ * @returns 배열로 정규화된 값 (undefined면 undefined 반환)
+ *
+ * @example
+ * normalizeToArray(50) // [50]
+ * normalizeToArray([20, 80]) // [20, 80]
+ * normalizeToArray(undefined) // undefined
+ */
+export declare function normalizeToArray<T>(value: T | T[] | undefined): T[] | undefined;
 /**
  * useObjectUrls 훅
  *