@hua-labs/ui 1.0.0 → 1.1.0-alpha.0.1

package/dist/components/Table.d.ts

@@ -0,0 +1,206 @@
+import React from "react";
+/**
+ * Table 컴포넌트의 props / Table component props
+ * @typedef {Object} TableProps
+ * @property {React.ReactNode} children - TableHeader, TableBody, TableFooter 등 / TableHeader, TableBody, TableFooter, etc.
+ * @property {"default" | "bordered" | "striped"} [variant="default"] - Table 스타일 변형 / Table style variant
+ * @property {"sm" | "md" | "lg"} [size="md"] - Table 크기 / Table size
+ * @extends {React.HTMLAttributes<HTMLTableElement>}
+ */
+export interface TableProps extends React.HTMLAttributes<HTMLTableElement> {
+    children: React.ReactNode;
+    variant?: "default" | "bordered" | "striped";
+    size?: "sm" | "md" | "lg";
+}
+/**
+ * TableHeader 컴포넌트의 props / TableHeader component props
+ * @typedef {Object} TableHeaderProps
+ * @property {React.ReactNode} children - TableHead 컴포넌트들 / TableHead components
+ * @extends {React.HTMLAttributes<HTMLTableSectionElement>}
+ */
+export interface TableHeaderProps extends React.HTMLAttributes<HTMLTableSectionElement> {
+    children: React.ReactNode;
+}
+/**
+ * TableBody 컴포넌트의 props / TableBody component props
+ * @typedef {Object} TableBodyProps
+ * @property {React.ReactNode} children - TableRow 컴포넌트들 / TableRow components
+ * @extends {React.HTMLAttributes<HTMLTableSectionElement>}
+ */
+export interface TableBodyProps extends React.HTMLAttributes<HTMLTableSectionElement> {
+    children: React.ReactNode;
+}
+/**
+ * TableFooter 컴포넌트의 props / TableFooter component props
+ * @typedef {Object} TableFooterProps
+ * @property {React.ReactNode} children - TableRow 컴포넌트들 / TableRow components
+ * @extends {React.HTMLAttributes<HTMLTableSectionElement>}
+ */
+export interface TableFooterProps extends React.HTMLAttributes<HTMLTableSectionElement> {
+    children: React.ReactNode;
+}
+/**
+ * TableRow 컴포넌트의 props / TableRow component props
+ * @typedef {Object} TableRowProps
+ * @property {React.ReactNode} children - TableHead 또는 TableCell 컴포넌트들 / TableHead or TableCell components
+ * @property {"default" | "hover"} [variant="default"] - Row 스타일 변형 / Row style variant
+ * @extends {React.HTMLAttributes<HTMLTableRowElement>}
+ */
+export interface TableRowProps extends React.HTMLAttributes<HTMLTableRowElement> {
+    children: React.ReactNode;
+    variant?: "default" | "hover";
+}
+/**
+ * TableHead 컴포넌트의 props / TableHead component props
+ * @typedef {Object} TableHeadProps
+ * @property {React.ReactNode} children - 헤더 셀 내용 / Header cell content
+ * @extends {React.ThHTMLAttributes<HTMLTableCellElement>}
+ */
+export interface TableHeadProps extends React.ThHTMLAttributes<HTMLTableCellElement> {
+    children: React.ReactNode;
+}
+/**
+ * TableCell 컴포넌트의 props / TableCell component props
+ * @typedef {Object} TableCellProps
+ * @property {React.ReactNode} children - 셀 내용 / Cell content
+ * @extends {React.TdHTMLAttributes<HTMLTableCellElement>}
+ */
+export interface TableCellProps extends React.TdHTMLAttributes<HTMLTableCellElement> {
+    children: React.ReactNode;
+}
+/**
+ * Table 컴포넌트 / Table component
+ *
+ * 데이터를 표 형태로 표시하는 테이블 컴포넌트입니다.
+ * TableHeader, TableBody, TableFooter, TableRow, TableHead, TableCell과 함께 사용합니다.
+ *
+ * Table component that displays data in tabular format.
+ * Used with TableHeader, TableBody, TableFooter, TableRow, TableHead, and TableCell.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <Table>
+ *   <TableHeader>
+ *     <TableRow>
+ *       <TableHead>이름</TableHead>
+ *       <TableHead>나이</TableHead>
+ *     </TableRow>
+ *   </TableHeader>
+ *   <TableBody>
+ *     <TableRow>
+ *       <TableCell>홍길동</TableCell>
+ *       <TableCell>30</TableCell>
+ *     </TableRow>
+ *   </TableBody>
+ * </Table>
+ *
+ * @example
+ * // Bordered 스타일 / Bordered style
+ * <Table variant="bordered">
+ *   <TableHeader>
+ *     <TableRow>
+ *       <TableHead>항목</TableHead>
+ *     </TableRow>
+ *   </TableHeader>
+ *   <TableBody>
+ *     <TableRow>
+ *       <TableCell>값</TableCell>
+ *     </TableRow>
+ *   </TableBody>
+ * </Table>
+ *
+ * @example
+ * // Striped 스타일, 호버 효과 / Striped style with hover effect
+ * <Table variant="striped">
+ *   <TableBody>
+ *     <TableRow variant="hover">
+ *       <TableCell>데이터</TableCell>
+ *     </TableRow>
+ *   </TableBody>
+ * </Table>
+ *
+ * @param {TableProps} props - Table 컴포넌트의 props / Table component props
+ * @param {React.Ref<HTMLTableElement>} ref - table 요소 ref / table element ref
+ * @returns {JSX.Element} Table 컴포넌트 / Table component
+ */
+declare const Table: React.ForwardRefExoticComponent<TableProps & React.RefAttributes<HTMLTableElement>>;
+/**
+ * TableHeader 컴포넌트 / TableHeader component
+ * 테이블의 헤더 영역을 표시합니다.
+ * Displays the header area of a table.
+ *
+ * @component
+ * @param {TableHeaderProps} props - TableHeader 컴포넌트의 props / TableHeader component props
+ * @param {React.Ref<HTMLTableSectionElement>} ref - thead 요소 ref / thead element ref
+ * @returns {JSX.Element} TableHeader 컴포넌트 / TableHeader component
+ */
+declare const TableHeader: React.ForwardRefExoticComponent<TableHeaderProps & React.RefAttributes<HTMLTableSectionElement>>;
+/**
+ * TableBody 컴포넌트 / TableBody component
+ * 테이블의 본문 영역을 표시합니다.
+ * Displays the body area of a table.
+ *
+ * @component
+ * @param {TableBodyProps} props - TableBody 컴포넌트의 props / TableBody component props
+ * @param {React.Ref<HTMLTableSectionElement>} ref - tbody 요소 ref / tbody element ref
+ * @returns {JSX.Element} TableBody 컴포넌트 / TableBody component
+ */
+declare const TableBody: React.ForwardRefExoticComponent<TableBodyProps & React.RefAttributes<HTMLTableSectionElement>>;
+/**
+ * TableFooter 컴포넌트 / TableFooter component
+ * 테이블의 푸터 영역을 표시합니다.
+ * Displays the footer area of a table.
+ *
+ * @component
+ * @param {TableFooterProps} props - TableFooter 컴포넌트의 props / TableFooter component props
+ * @param {React.Ref<HTMLTableSectionElement>} ref - tfoot 요소 ref / tfoot element ref
+ * @returns {JSX.Element} TableFooter 컴포넌트 / TableFooter component
+ */
+declare const TableFooter: React.ForwardRefExoticComponent<TableFooterProps & React.RefAttributes<HTMLTableSectionElement>>;
+/**
+ * TableRow 컴포넌트 / TableRow component
+ * 테이블의 행을 표시합니다.
+ * Displays a table row.
+ *
+ * @component
+ * @param {TableRowProps} props - TableRow 컴포넌트의 props / TableRow component props
+ * @param {React.Ref<HTMLTableRowElement>} ref - tr 요소 ref / tr element ref
+ * @returns {JSX.Element} TableRow 컴포넌트 / TableRow component
+ */
+declare const TableRow: React.ForwardRefExoticComponent<TableRowProps & React.RefAttributes<HTMLTableRowElement>>;
+/**
+ * TableHead 컴포넌트 / TableHead component
+ * 테이블의 헤더 셀을 표시합니다.
+ * Displays a table header cell.
+ *
+ * @component
+ * @param {TableHeadProps} props - TableHead 컴포넌트의 props / TableHead component props
+ * @param {React.Ref<HTMLTableCellElement>} ref - th 요소 ref / th element ref
+ * @returns {JSX.Element} TableHead 컴포넌트 / TableHead component
+ */
+declare const TableHead: React.ForwardRefExoticComponent<TableHeadProps & React.RefAttributes<HTMLTableCellElement>>;
+/**
+ * TableCell 컴포넌트 / TableCell component
+ * 테이블의 데이터 셀을 표시합니다.
+ * Displays a table data cell.
+ *
+ * @component
+ * @param {TableCellProps} props - TableCell 컴포넌트의 props / TableCell component props
+ * @param {React.Ref<HTMLTableCellElement>} ref - td 요소 ref / td element ref
+ * @returns {JSX.Element} TableCell 컴포넌트 / TableCell component
+ */
+declare const TableCell: React.ForwardRefExoticComponent<TableCellProps & React.RefAttributes<HTMLTableCellElement>>;
+/**
+ * TableCaption 컴포넌트 / TableCaption component
+ * 테이블의 캡션을 표시합니다.
+ * Displays a table caption.
+ *
+ * @component
+ * @param {React.HTMLAttributes<HTMLTableCaptionElement>} props - TableCaption 컴포넌트의 props / TableCaption component props
+ * @param {React.Ref<HTMLTableCaptionElement>} ref - caption 요소 ref / caption element ref
+ * @returns {JSX.Element} TableCaption 컴포넌트 / TableCaption component
+ */
+declare const TableCaption: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableCaptionElement> & React.RefAttributes<HTMLTableCaptionElement>>;
+export { Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption, };
+//# sourceMappingURL=Table.d.ts.map

package/dist/components/Table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Table.d.ts","sourceRoot":"","sources":["../../src/components/Table.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;GAOG;AACH,MAAM,WAAW,UAAW,SAAQ,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC;IACxE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAA;IAC5C,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,uBAAuB,CAAC;IACrF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,uBAAuB,CAAC;IACnF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,uBAAuB,CAAC;IACrF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,cAAc,CAAC,mBAAmB,CAAC;IAC9E,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,gBAAgB,CAAC,oBAAoB,CAAC;IAClF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,gBAAgB,CAAC,oBAAoB,CAAC;IAClF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,QAAA,MAAM,KAAK,qFAuCV,CAAA;AAGD;;;;;;;;;GASG;AACH,QAAA,MAAM,WAAW,kGAIhB,CAAA;AAGD;;;;;;;;;GASG;AACH,QAAA,MAAM,SAAS,gGAQd,CAAA;AAGD;;;;;;;;;GASG;AACH,QAAA,MAAM,WAAW,kGAWhB,CAAA;AAGD;;;;;;;;;GASG;AACH,QAAA,MAAM,QAAQ,2FAuBb,CAAA;AAGD;;;;;;;;;GASG;AACH,QAAA,MAAM,SAAS,6FAWd,CAAA;AAGD;;;;;;;;;GASG;AACH,QAAA,MAAM,SAAS,6FAQd,CAAA;AAGD;;;;;;;;;GASG;AACH,QAAA,MAAM,YAAY,+HAQjB,CAAA;AAGD,OAAO,EACL,KAAK,EACL,WAAW,EACX,SAAS,EACT,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,GACb,CAAA"}

package/dist/components/Tabs.d.ts

@@ -1,4 +1,37 @@
-import * as React from "react";
+import React from 'react';
+/**
+ * TabsContent 컴포넌트의 props / TabsContent component props
+ * @typedef {Object} TabsContentProps
+ * @property {string} value - 탭 패널의 고유 값 (TabsTrigger의 value와 일치해야 함) / Unique value for tab panel (must match TabsTrigger value)
+ * @property {boolean} [active] - 탭 패널 활성화 상태 (자동 설정됨) / Tab panel active state (auto-set)
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
+export interface TabsContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    value: string;
+    active?: boolean;
+}
+/**
+ * TabsContent 컴포넌트 / TabsContent component
+ * 탭의 콘텐츠 패널을 표시합니다. Tabs 컴포넌트 내부에서 사용됩니다.
+ * Displays the tab content panel. Used inside Tabs component.
+ *
+ * @component
+ * @param {TabsContentProps} props - TabsContent 컴포넌트의 props / TabsContent component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} TabsContent 컴포넌트 / TabsContent component
+ */
+declare const TabsContent: React.ForwardRefExoticComponent<TabsContentProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Tabs 컴포넌트의 props / Tabs component props
+ * @typedef {Object} TabsProps
+ * @property {string} [value] - 현재 활성화된 탭 값 (제어 컴포넌트) / Currently active tab value (controlled component)
+ * @property {string} [defaultValue] - 초기 활성화된 탭 값 (비제어 컴포넌트) / Initial active tab value (uncontrolled component)
+ * @property {(value: string) => void} [onValueChange] - 탭 변경 시 호출되는 콜백 / Callback when tab changes
+ * @property {"horizontal" | "vertical"} [orientation="horizontal"] - 탭 방향 / Tab orientation
+ * @property {"default" | "pills" | "underline" | "cards"} [variant="default"] - 탭 스타일 변형 / Tab style variant
+ * @property {"sm" | "md" | "lg"} [size="md"] - 탭 크기 / Tab size
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
 export interface TabsProps extends React.HTMLAttributes<HTMLDivElement> {
     value?: string;
     defaultValue?: string;
@@ -7,7 +40,60 @@ export interface TabsProps extends React.HTMLAttributes<HTMLDivElement> {
     variant?: "default" | "pills" | "underline" | "cards";
     size?: "sm" | "md" | "lg";
 }
+/**
+ * Tabs 컴포넌트 / Tabs component
+ *
+ * 탭 네비게이션을 제공하는 컴포넌트입니다.
+ * 키보드 네비게이션(Arrow keys, Home/End)을 지원하며, ARIA 속성을 자동으로 설정합니다.
+ *
+ * Component that provides tab navigation.
+ * Supports keyboard navigation (Arrow keys, Home/End) and automatically sets ARIA attributes.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <Tabs defaultValue="tab1">
+ *   <TabsList>
+ *     <TabsTrigger value="tab1">탭 1</TabsTrigger>
+ *     <TabsTrigger value="tab2">탭 2</TabsTrigger>
+ *   </TabsList>
+ *   <TabsContent value="tab1">탭 1 내용</TabsContent>
+ *   <TabsContent value="tab2">탭 2 내용</TabsContent>
+ * </Tabs>
+ *
+ * @example
+ * // 제어 컴포넌트 / Controlled component
+ * const [activeTab, setActiveTab] = useState("tab1")
+ * <Tabs value={activeTab} onValueChange={setActiveTab}>
+ *   <TabsList>
+ *     <TabsTrigger value="tab1">탭 1</TabsTrigger>
+ *   </TabsList>
+ *   <TabsContent value="tab1">내용</TabsContent>
+ * </Tabs>
+ *
+ * @example
+ * // 다양한 변형 / Various variants
+ * <Tabs variant="pills" size="lg">
+ *   <TabsList>
+ *     <TabsTrigger value="tab1">Pills 스타일</TabsTrigger>
+ *   </TabsList>
+ * </Tabs>
+ *
+ * @param {TabsProps} props - Tabs 컴포넌트의 props / Tabs component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} Tabs 컴포넌트 / Tabs component
+ */
 declare const Tabs: React.ForwardRefExoticComponent<TabsProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * TabsList 컴포넌트의 props / TabsList component props
+ * @typedef {Object} TabsListProps
+ * @property {string} [value] - 현재 활성화된 탭 값 (Tabs에서 자동 전달) / Currently active tab value (auto-passed from Tabs)
+ * @property {(value: string) => void} [onValueChange] - 탭 변경 콜백 (Tabs에서 자동 전달) / Tab change callback (auto-passed from Tabs)
+ * @property {"horizontal" | "vertical"} [orientation] - 탭 방향 (Tabs에서 자동 전달) / Tab orientation (auto-passed from Tabs)
+ * @property {"default" | "pills" | "underline" | "cards"} [variant] - 탭 스타일 (Tabs에서 자동 전달) / Tab style (auto-passed from Tabs)
+ * @property {"sm" | "md" | "lg"} [size] - 탭 크기 (Tabs에서 자동 전달) / Tab size (auto-passed from Tabs)
+ * @extends {React.HTMLAttributes<HTMLDivElement>}
+ */
 export interface TabsListProps extends React.HTMLAttributes<HTMLDivElement> {
     value?: string;
     onValueChange?: (value: string) => void;
@@ -15,22 +101,49 @@ export interface TabsListProps extends React.HTMLAttributes<HTMLDivElement> {
     variant?: "default" | "pills" | "underline" | "cards";
     size?: "sm" | "md" | "lg";
 }
+/**
+ * TabsList 컴포넌트 / TabsList component
+ * 탭 트리거 목록을 표시합니다. Tabs 컴포넌트 내부에서 사용됩니다.
+ * Displays the list of tab triggers. Used inside Tabs component.
+ *
+ * @component
+ * @param {TabsListProps} props - TabsList 컴포넌트의 props / TabsList component props
+ * @param {React.Ref<HTMLDivElement>} ref - div 요소 ref / div element ref
+ * @returns {JSX.Element} TabsList 컴포넌트 / TabsList component
+ */
 declare const TabsList: React.ForwardRefExoticComponent<TabsListProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * TabsTrigger 컴포넌트의 props
+ * @typedef {Object} TabsTriggerProps
+ * @property {string} value - 탭 트리거의 고유 값 (TabsContent의 value와 일치해야 함)
+ * @property {(value: string) => void} [onValueChange] - 탭 변경 콜백 (TabsList에서 자동 전달)
+ * @property {"horizontal" | "vertical"} [orientation] - 탭 방향 (TabsList에서 자동 전달)
+ * @property {"default" | "pills" | "underline" | "cards"} [variant] - 탭 스타일 (TabsList에서 자동 전달)
+ * @property {"sm" | "md" | "lg"} [size] - 탭 크기 (TabsList에서 자동 전달)
+ * @property {boolean} [active] - 탭 활성화 상태 (자동 설정됨)
+ * @extends {React.ButtonHTMLAttributes<HTMLButtonElement>}
+ */
 export interface TabsTriggerProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     value: string;
+    onValueChange?: (value: string) => void;
     orientation?: "horizontal" | "vertical";
     variant?: "default" | "pills" | "underline" | "cards";
     size?: "sm" | "md" | "lg";
     active?: boolean;
 }
+/**
+ * TabsTrigger 컴포넌트 / TabsTrigger component
+ * 탭을 활성화하는 버튼입니다. TabsList 컴포넌트 내부에서 사용됩니다.
+ * Button that activates a tab. Used inside TabsList component.
+ *
+ * @component
+ * @param {TabsTriggerProps} props - TabsTrigger 컴포넌트의 props / TabsTrigger component props
+ * @param {React.Ref<HTMLButtonElement>} ref - button 요소 ref / button element ref
+ * @returns {JSX.Element} TabsTrigger 컴포넌트 / TabsTrigger component
+ */
 declare const TabsTrigger: React.ForwardRefExoticComponent<TabsTriggerProps & React.RefAttributes<HTMLButtonElement>>;
-export interface TabsContentProps extends React.HTMLAttributes<HTMLDivElement> {
-    value: string;
-    active?: boolean;
-}
-declare const TabsContent: React.ForwardRefExoticComponent<TabsContentProps & React.RefAttributes<HTMLDivElement>>;
-export declare const TabsPills: React.ForwardRefExoticComponent<Omit<TabsProps, "variant"> & React.RefAttributes<HTMLDivElement>>;
-export declare const TabsUnderline: React.ForwardRefExoticComponent<Omit<TabsProps, "variant"> & React.RefAttributes<HTMLDivElement>>;
-export declare const TabsCards: React.ForwardRefExoticComponent<Omit<TabsProps, "variant"> & React.RefAttributes<HTMLDivElement>>;
-export { Tabs, TabsList, TabsTrigger, TabsContent };
+declare const TabsPills: React.ForwardRefExoticComponent<TabsProps & React.RefAttributes<HTMLDivElement>>;
+declare const TabsUnderline: React.ForwardRefExoticComponent<TabsProps & React.RefAttributes<HTMLDivElement>>;
+declare const TabsCards: React.ForwardRefExoticComponent<TabsProps & React.RefAttributes<HTMLDivElement>>;
+export { Tabs, TabsList, TabsTrigger, TabsContent, TabsPills, TabsUnderline, TabsCards };
 //# sourceMappingURL=Tabs.d.ts.map

package/dist/components/Tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../src/components/Tabs.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAA;IACrD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAC1B;AAED,QAAA,MAAM,IAAI,kFAsDT,CAAA;AAGD,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACzE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAA;IACrD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAC1B;AAED,QAAA,MAAM,QAAQ,sFA0Db,CAAA;AAGD,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACrF,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAA;IACrD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,QAAA,MAAM,WAAW,4FAqEhB,CAAA;AAGD,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC5E,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,QAAA,MAAM,WAAW,yFAuBhB,CAAA;AAID,eAAO,MAAM,SAAS,mGAIrB,CAAA;AAGD,eAAO,MAAM,aAAa,mGAIzB,CAAA;AAGD,eAAO,MAAM,SAAS,mGAIrB,CAAA;AAGD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../src/components/Tabs.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;GAMG;AACH,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IAC5E,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,WAAW,yFAsBhB,CAAA;AAGD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAA;IACrD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,QAAA,MAAM,IAAI,kFAmET,CAAA;AAGD;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACzE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAA;IACrD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,QAAQ,sFAiIb,CAAA;AAGD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAiB,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACrF,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAA;IACrD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,WAAW,4FAqFhB,CAAA;AAID,QAAA,MAAM,SAAS,kFAEd,CAAA;AAGD,QAAA,MAAM,aAAa,kFAElB,CAAA;AAGD,QAAA,MAAM,SAAS,kFAEd,CAAA;AAGD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAA"}

package/dist/components/Textarea.d.ts

@@ -1,11 +1,57 @@
-import * as React from "react";
+import React from "react";
+/**
+ * Textarea 컴포넌트의 props / Textarea component props
+ * @typedef {Object} TextareaProps
+ * @property {"default" | "outline" | "filled" | "ghost" | "glass"} [variant="default"] - Textarea 스타일 변형 / Textarea style variant
+ * @property {"sm" | "md" | "lg"} [size="md"] - Textarea 크기 / Textarea size
+ * @property {boolean} [error=false] - 에러 상태 표시 / Error state
+ * @property {boolean} [success=false] - 성공 상태 표시 / Success state
+ * @property {"none" | "vertical" | "horizontal" | "both"} [resize="vertical"] - 크기 조절 방향 / Resize direction
+ * @extends {React.TextareaHTMLAttributes<HTMLTextAreaElement>}
+ */
 export interface TextareaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement> {
-    variant?: "default" | "outline" | "filled" | "ghost";
+    variant?: "default" | "outline" | "filled" | "ghost" | "glass";
     size?: "sm" | "md" | "lg";
     error?: boolean;
     success?: boolean;
     resize?: "none" | "vertical" | "horizontal" | "both";
 }
+/**
+ * Textarea 컴포넌트 / Textarea component
+ *
+ * 여러 줄 텍스트 입력을 위한 텍스트 영역 컴포넌트입니다.
+ * 다양한 스타일 변형과 크기를 지원하며, 접근성 속성을 포함합니다.
+ *
+ * Text area component for multi-line text input.
+ * Supports various style variants and sizes, includes accessibility attributes.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <Textarea placeholder="내용을 입력하세요" />
+ *
+ * @example
+ * // 에러 상태 / Error state
+ * <Textarea
+ *   error
+ *   placeholder="에러가 발생했습니다"
+ *   aria-label="설명 입력"
+ * />
+ *
+ * @example
+ * // 크기 조절 비활성화 / Disable resize
+ * <Textarea
+ *   resize="none"
+ *   rows={5}
+ *   placeholder="고정 크기 텍스트 영역"
+ * />
+ *
+ * @param {TextareaProps} props - Textarea 컴포넌트의 props / Textarea component props
+ * @param {React.Ref<HTMLTextAreaElement>} ref - textarea 요소 ref / textarea element ref
+ * @returns {JSX.Element} Textarea 컴포넌트 / Textarea component
+ *
+ * @todo 접근성 개선: aria-invalid 속성 자동 추가 필요 / Accessibility improvement: auto-add aria-invalid attribute
+ */
 declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
 export { Textarea };
 //# sourceMappingURL=Textarea.d.ts.map

package/dist/components/Textarea.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Textarea.d.ts","sourceRoot":"","sources":["../../src/components/Textarea.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,sBAAsB,CAAC,mBAAmB,CAAC;IACtF,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;IACpD,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAA;CACrD;AAED,QAAA,MAAM,QAAQ,2FAmDb,CAAA;AAGD,OAAO,EAAE,QAAQ,EAAE,CAAA"}
+{"version":3,"file":"Textarea.d.ts","sourceRoot":"","sources":["../../src/components/Textarea.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,sBAAsB,CAAC,mBAAmB,CAAC;IACtF,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;IAC9D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAA;CACrD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,QAAA,MAAM,QAAQ,2FA0Db,CAAA;AAGD,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/dist/components/ThemeProvider.d.ts

@@ -1,5 +1,14 @@
-import * as React from "react";
+import React from "react";
 type Theme = "light" | "dark" | "system";
+/**
+ * ThemeProvider 컴포넌트의 props / ThemeProvider component props
+ * @typedef {Object} ThemeProviderProps
+ * @property {React.ReactNode} children - 자식 컴포넌트 / Child components
+ * @property {"light" | "dark" | "system"} [defaultTheme="light"] - 기본 테마 / Default theme
+ * @property {string} [storageKey="hua-ui-theme"] - localStorage 키 / localStorage key
+ * @property {boolean} [enableSystem=true] - 시스템 테마 감지 활성화 / Enable system theme detection
+ * @property {boolean} [enableTransition=true] - 테마 전환 애니메이션 활성화 / Enable theme transition animation
+ */
 interface ThemeProviderProps {
     children: React.ReactNode;
     defaultTheme?: Theme;
@@ -7,13 +16,69 @@ interface ThemeProviderProps {
     enableSystem?: boolean;
     enableTransition?: boolean;
 }
+/**
+ * ThemeProvider의 상태 타입 / ThemeProvider state type
+ * @typedef {Object} ThemeProviderState
+ * @property {"light" | "dark" | "system"} theme - 현재 테마 / Current theme
+ * @property {(theme: "light" | "dark" | "system") => void} setTheme - 테마 설정 함수 / Theme setter function
+ * @property {"light" | "dark"} resolvedTheme - 실제 적용된 테마 (system일 경우 시스템 테마) / Actually applied theme (system theme when system is selected)
+ * @property {() => void} toggleTheme - 테마 토글 함수 / Theme toggle function
+ */
 interface ThemeProviderState {
     theme: Theme;
     setTheme: (theme: Theme) => void;
     resolvedTheme: "light" | "dark";
     toggleTheme: () => void;
 }
-export declare function ThemeProvider({ children, defaultTheme, storageKey, enableSystem, enableTransition, ...props }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * ThemeProvider 컴포넌트 / ThemeProvider component
+ *
+ * 테마 관리를 위한 Context Provider 컴포넌트입니다.
+ * localStorage에 테마를 저장하고, 시스템 테마를 감지할 수 있습니다.
+ * useTheme 훅을 통해 테마 상태에 접근할 수 있습니다.
+ *
+ * Context Provider component for theme management.
+ * Saves theme to localStorage and can detect system theme.
+ * Access theme state through useTheme hook.
+ *
+ * @component
+ * @example
+ * // 기본 사용 / Basic usage
+ * <ThemeProvider>
+ *   <App />
+ * </ThemeProvider>
+ *
+ * @example
+ * // 커스텀 설정 / Custom settings
+ * <ThemeProvider
+ *   defaultTheme="dark"
+ *   storageKey="my-app-theme"
+ *   enableSystem={true}
+ *   enableTransition={true}
+ * >
+ *   <App />
+ * </ThemeProvider>
+ *
+ * @param {ThemeProviderProps} props - ThemeProvider 컴포넌트의 props / ThemeProvider component props
+ * @returns {JSX.Element} ThemeProvider 컴포넌트 / ThemeProvider component
+ */
+export declare function ThemeProvider({ children, defaultTheme, // system에서 light로 변경
+storageKey, enableSystem, enableTransition, ...props }: ThemeProviderProps): React.ReactElement;
+/**
+ * useTheme 훅 / useTheme hook
+ *
+ * ThemeProvider의 테마 상태에 접근하는 훅입니다.
+ * ThemeProvider 내부에서만 사용할 수 있습니다.
+ *
+ * Hook to access ThemeProvider's theme state.
+ * Can only be used inside ThemeProvider.
+ *
+ * @example
+ * const { theme, setTheme, resolvedTheme, toggleTheme } = useTheme()
+ *
+ * @returns {ThemeProviderState} 테마 상태와 함수들 / Theme state and functions
+ * @throws {Error} ThemeProvider 외부에서 사용 시 에러 발생 / Error when used outside ThemeProvider
+ */
 export declare const useTheme: () => ThemeProviderState;
 export {};
 //# sourceMappingURL=ThemeProvider.d.ts.map

package/dist/components/ThemeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/components/ThemeProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,KAAK,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAExC,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,YAAY,CAAC,EAAE,KAAK,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,KAAK,CAAA;IACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,aAAa,EAAE,OAAO,GAAG,MAAM,CAAA;IAC/B,WAAW,EAAE,MAAM,IAAI,CAAA;CACxB;AAWD,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,YAAuB,EACvB,UAA2B,EAC3B,YAAmB,EACnB,gBAAuB,EACvB,GAAG,KAAK,EACT,EAAE,kBAAkB,2CAyEpB;AAED,eAAO,MAAM,QAAQ,0BAOpB,CAAA"}
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/components/ThemeProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAyD,MAAM,OAAO,CAAA;AAE7E,KAAK,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAExC;;;;;;;;GAQG;AACH,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,YAAY,CAAC,EAAE,KAAK,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,UAAU,kBAAkB;IAC1B,KAAK,EAAE,KAAK,CAAA;IACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,aAAa,EAAE,OAAO,GAAG,MAAM,CAAA;IAC/B,WAAW,EAAE,MAAM,IAAI,CAAA;CACxB;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,YAAsB,EAAG,qBAAqB;AAC9C,UAA2B,EAC3B,YAAmB,EACnB,gBAAuB,EACvB,GAAG,KAAK,EACT,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAyEzC;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,0BAOpB,CAAA"}

package/dist/components/ThemeToggle.d.ts

@@ -1,3 +1,15 @@
+/**
+ * ThemeToggle 컴포넌트의 props / ThemeToggle component props
+ * @typedef {Object} ThemeToggleProps
+ * @property {string} [className] - 추가 CSS 클래스 / Additional CSS class
+ * @property {"sm" | "md" | "lg"} [size="md"] - Toggle 크기 / Toggle size
+ * @property {"button" | "icon" | "switch"} [variant="button"] - Toggle 스타일 변형 / Toggle style variant
+ * @property {boolean} [showLabel=false] - 라벨 표시 여부 / Show label
+ * @property {Object} [label] - 커스텀 라벨 텍스트 / Custom label text
+ * @property {string} [label.light="라이트"] - 라이트 모드 라벨 / Light mode label
+ * @property {string} [label.dark="다크"] - 다크 모드 라벨 / Dark mode label
+ * @property {string} [label.system="시스템"] - 시스템 모드 라벨 / System mode label
+ */
 interface ThemeToggleProps {
     className?: string;
     size?: "sm" | "md" | "lg";
@@ -9,6 +21,38 @@ interface ThemeToggleProps {
         system?: string;
     };
 }
+/**
+ * ThemeToggle 컴포넌트 / ThemeToggle component
+ *
+ * 테마를 전환하는 토글 컴포넌트입니다.
+ * ThemeProvider와 함께 사용하며, light/dark/system 테마를 지원합니다.
+ *
+ * Toggle component for switching themes.
+ * Used with ThemeProvider, supports light/dark/system themes.
+ *
+ * @component
+ * @example
+ * // 기본 사용 (버튼 스타일) / Basic usage (button style)
+ * <ThemeToggle />
+ *
+ * @example
+ * // 아이콘만 표시 / Icon only
+ * <ThemeToggle variant="icon" size="lg" />
+ *
+ * @example
+ * // Switch 스타일 / Switch style
+ * <ThemeToggle variant="switch" />
+ *
+ * @example
+ * // 라벨과 함께 / With label
+ * <ThemeToggle
+ *   showLabel
+ *   label={{ light: "밝게", dark: "어둡게" }}
+ * />
+ *
+ * @param {ThemeToggleProps} props - ThemeToggle 컴포넌트의 props / ThemeToggle component props
+ * @returns {JSX.Element} ThemeToggle 컴포넌트 / ThemeToggle component
+ */
 export declare function ThemeToggle({ className, size, variant, showLabel, label, ...props }: ThemeToggleProps): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=ThemeToggle.d.ts.map

package/dist/components/ThemeToggle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeToggle.d.ts","sourceRoot":"","sources":["../../src/components/ThemeToggle.tsx"],"names":[],"mappings":"AAOA,UAAU,gBAAgB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;IACtC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,IAAW,EACX,OAAkB,EAClB,SAAiB,EACjB,KAIC,EACD,GAAG,KAAK,EACT,EAAE,gBAAgB,2CAiHlB"}
+{"version":3,"file":"ThemeToggle.d.ts","sourceRoot":"","sources":["../../src/components/ThemeToggle.tsx"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AACH,UAAU,gBAAgB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;IACtC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,IAAW,EACX,OAAkB,EAClB,SAAiB,EACjB,KAIC,EACD,GAAG,KAAK,EACT,EAAE,gBAAgB,2CAiHlB"}