@withwiz/toolkit 0.2.0 → 0.2.1

package/dist/components/ui/data-table/DataTableBody.js

@@ -0,0 +1,10 @@
+"use client";
+import {
+  DataTableBody
+} from "../../../chunk-7IY3RQQL.js";
+import "../../../chunk-34WAGUT5.js";
+import "../../../chunk-62FLBG6B.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  DataTableBody
+};

package/dist/components/ui/data-table/DataTableBulkActions.d.ts

@@ -0,0 +1,17 @@
+import type { BulkAction } from "./types";
+export interface DataTableBulkActionsProps {
+    bulkActions: BulkAction[];
+    localSelectedIds: string[];
+    dataLength: number;
+    bulkActionLoading: string | null;
+    onSelectAll: (checked: boolean) => void;
+    onBulkAction: (action: BulkAction) => void;
+    labels: {
+        selectAll: string;
+        selectAllShort: string;
+        selected: string;
+        processing: string;
+        processingItems: string;
+    };
+}
+export declare function DataTableBulkActions({ bulkActions, localSelectedIds, dataLength, bulkActionLoading, onSelectAll, onBulkAction, labels, }: DataTableBulkActionsProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ui/data-table/DataTableBulkActions.js

@@ -0,0 +1,12 @@
+"use client";
+import {
+  DataTableBulkActions
+} from "../../../chunk-MAATEX2R.js";
+import "../../../chunk-NY5QXT33.js";
+import "../../../chunk-34WAGUT5.js";
+import "../../../chunk-L25BNU3E.js";
+import "../../../chunk-62FLBG6B.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  DataTableBulkActions
+};

package/dist/components/ui/data-table/DataTableFilters.d.ts

@@ -0,0 +1,15 @@
+import type { FilterConfig } from "./types";
+export interface DataTableFiltersProps {
+    filters: FilterConfig[];
+    filterValues: Record<string, any>;
+    onFilterChange?: (key: string, value: any) => void;
+    onClearFilters?: () => void;
+    hasActiveFilters: boolean;
+    labels: {
+        all: string;
+        min: string;
+        max: string;
+        clearFilters: string;
+    };
+}
+export declare function DataTableFilters({ filters, filterValues, onFilterChange, onClearFilters, hasActiveFilters, labels, }: DataTableFiltersProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ui/data-table/DataTableFilters.js

@@ -0,0 +1,13 @@
+"use client";
+import {
+  DataTableFilters
+} from "../../../chunk-SEZJN4TC.js";
+import "../../../chunk-RJUVBBZG.js";
+import "../../../chunk-IJEZ7G7S.js";
+import "../../../chunk-WDUFQFDP.js";
+import "../../../chunk-L25BNU3E.js";
+import "../../../chunk-62FLBG6B.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  DataTableFilters
+};

package/dist/components/ui/data-table/DataTablePagination.d.ts

@@ -0,0 +1,10 @@
+import type { PaginationConfig } from "./types";
+export interface DataTablePaginationProps {
+    pagination: PaginationConfig;
+    labels: {
+        showing: string;
+        previous: string;
+        next: string;
+    };
+}
+export declare function DataTablePagination({ pagination, labels, }: DataTablePaginationProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ui/data-table/DataTablePagination.js

@@ -0,0 +1,11 @@
+"use client";
+import {
+  DataTablePagination
+} from "../../../chunk-IPXPCBDO.js";
+import "../../../chunk-NY5QXT33.js";
+import "../../../chunk-YJWLWUFK.js";
+import "../../../chunk-62FLBG6B.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  DataTablePagination
+};

package/dist/components/ui/data-table/DataTableSearch.d.ts

@@ -0,0 +1,24 @@
+import { ReactNode } from "react";
+import type { PaginationConfig, FilterConfig } from "./types";
+export interface DataTableSearchProps {
+    onSearch?: (search: string) => void;
+    onSearchValueChange?: (searchValue: string) => void;
+    searchValue: string;
+    searchPlaceholder: string;
+    labels: {
+        search: string;
+        filter: string;
+        filterActive: string;
+        perPage: string;
+    };
+    filters: FilterConfig[];
+    onToggleFilters?: (show: boolean) => void;
+    showFilters: boolean;
+    hasActiveFilters: boolean;
+    pagination?: PaginationConfig;
+    createButton?: ReactNode | {
+        label: string;
+        onClick: () => void;
+    };
+}
+export declare function DataTableSearch({ onSearch, onSearchValueChange, searchValue, searchPlaceholder, labels, filters, onToggleFilters, showFilters, hasActiveFilters, pagination, createButton, }: DataTableSearchProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ui/data-table/DataTableSearch.js

@@ -0,0 +1,12 @@
+"use client";
+import {
+  DataTableSearch
+} from "../../../chunk-KHYY4KCV.js";
+import "../../../chunk-NY5QXT33.js";
+import "../../../chunk-RJUVBBZG.js";
+import "../../../chunk-L25BNU3E.js";
+import "../../../chunk-62FLBG6B.js";
+import "../../../chunk-ORMEWXMH.js";
+export {
+  DataTableSearch
+};

package/dist/components/ui/data-table/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * DataTable
+ *
+ * Public API - 모든 DataTable 관련 타입과 컴포넌트 export
+ */
+export { DataTable } from "./DataTable";
+export { DataTableSearch } from "./DataTableSearch";
+export { DataTableFilters } from "./DataTableFilters";
+export { DataTableBulkActions } from "./DataTableBulkActions";
+export { DataTableBody } from "./DataTableBody";
+export { DataTablePagination } from "./DataTablePagination";
+export type { DataTableLabels, ColumnDef, BulkAction, FilterConfig, PaginationConfig, SortConfig, DataTableProps, } from "./types";
+export { DEFAULT_LABELS, formatLabel } from "./types";

package/dist/components/ui/data-table/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * DataTable Types
+ *
+ * DataTable 컴포넌트의 모든 타입 정의
+ */
+import { ReactNode } from "react";
+export interface DataTableLabels {
+    search?: string;
+    filter?: string;
+    filterActive?: string;
+    clearFilters?: string;
+    selectAll?: string;
+    selectAllShort?: string;
+    selected?: string;
+    processing?: string;
+    processingItems?: string;
+    loading?: string;
+    perPage?: string;
+    all?: string;
+    min?: string;
+    max?: string;
+    previous?: string;
+    next?: string;
+    showing?: string;
+}
+export declare const DEFAULT_LABELS: Required<DataTableLabels>;
+export declare function formatLabel(template: string, values: Record<string, string | number>): string;
+export interface ColumnDef<T> {
+    key: string;
+    header: string;
+    accessorKey?: keyof T;
+    cell?: (item: T) => React.ReactNode;
+    sortable?: boolean;
+    width?: string;
+    className?: string;
+    hidden?: boolean;
+    responsive?: {
+        sm?: boolean;
+        md?: boolean;
+        lg?: boolean;
+        xl?: boolean;
+    };
+}
+export interface BulkAction {
+    key: string;
+    label: string;
+    icon?: React.ReactNode;
+    variant?: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
+    onClick: (selectedIds: string[]) => Promise<void>;
+    disabled?: (selectedIds: string[]) => boolean;
+}
+export interface FilterConfig {
+    key: string;
+    label: string;
+    type: 'text' | 'select' | 'date' | 'number' | 'switch' | 'range';
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    placeholder?: string;
+    className?: string;
+    inputType?: 'text' | 'number' | 'date';
+    minPlaceholder?: string;
+    maxPlaceholder?: string;
+    /** 필터 모드: 'server'(기본값)는 서버 사이드, 'client'는 클라이언트 사이드 필터링 */
+    filterMode?: 'server' | 'client';
+    /** 클라이언트 사이드 필터링 함수 (filterMode === 'client'일 때 사용) */
+    filterFn?: (item: any, value: any) => boolean;
+}
+export interface PaginationConfig {
+    page: number;
+    pageSize: number;
+    total: number;
+    pageSizeOptions?: number[];
+    onPageChange: (page: number) => void;
+    onPageSizeChange: (pageSize: number) => void;
+}
+export interface SortConfig {
+    sort: string;
+    order: 'asc' | 'desc';
+    onSortChange: (sort: string, order: 'asc' | 'desc') => void;
+}
+export interface DataTableProps<T> {
+    data: T[];
+    columns: ColumnDef<T>[];
+    loading?: boolean;
+    error?: string | null;
+    pagination?: PaginationConfig;
+    sort?: SortConfig;
+    bulkActions?: BulkAction[];
+    filters?: FilterConfig[];
+    filterValues?: Record<string, any>;
+    onFilterChange?: (key: string, value: any) => void;
+    onClearFilters?: () => void;
+    selectable?: boolean;
+    onSelectionChange?: (selectedIds: string[]) => void;
+    selectedIds?: string[];
+    getRowId: (item: T) => string;
+    className?: string;
+    emptyMessage?: string;
+    searchPlaceholder?: string;
+    onSearch?: (search: string) => void;
+    onSearchValueChange?: (searchValue: string) => void;
+    searchValue?: string;
+    showFilters?: boolean;
+    onToggleFilters?: (show: boolean) => void;
+    createButton?: ReactNode | {
+        label: string;
+        onClick: () => void;
+    };
+    /** i18n labels - 미제공 시 영어 기본값 사용 */
+    labels?: Partial<DataTableLabels>;
+    /** URL 쿼리 파라미터와 상태 동기화 (기본값: false) */
+    syncWithUrl?: boolean;
+}

package/dist/constants/index.js

@@ -1,3 +1,16 @@
+import {
+  ERROR_CODES,
+  HTTP_STATUS,
+  formatErrorMessage,
+  getAllErrorCodes,
+  getDefaultErrorMessage,
+  getErrorByCode,
+  getErrorCategory,
+  getErrorCodesByCategory,
+  getErrorInfo,
+  getHttpStatus,
+  getLogLevel
+} from "../chunk-Y3OTJH2S.js";
 import {
   GENERIC_CONFIRM_MESSAGES,
   GENERIC_ERROR_MESSAGES,
@@ -31,19 +44,6 @@ import {
   URL,
   USER_INPUT
 } from "../chunk-LNV2E4I6.js";
-import {
-  ERROR_CODES,
-  HTTP_STATUS,
-  formatErrorMessage,
-  getAllErrorCodes,
-  getDefaultErrorMessage,
-  getErrorByCode,
-  getErrorCategory,
-  getErrorCodesByCategory,
-  getErrorInfo,
-  getHttpStatus,
-  getLogLevel
-} from "../chunk-Y3OTJH2S.js";
 import "../chunk-ORMEWXMH.js";
 export {
   API_KEY,

package/dist/error/hooks/index.js

@@ -1,12 +1,12 @@
 import "../../chunk-Y2TUZFCP.js";
 import {
   useErrorHandler
-} from "../../chunk-IAJNC34M.js";
+} from "../../chunk-6UAYU5NU.js";
+import "../../chunk-MLGO3HLS.js";
 import "../../chunk-POKGHK3L.js";
 import "../../chunk-EEUBKZV4.js";
 import "../../chunk-N4YGR5WH.js";
 import "../../chunk-KXAWBFJN.js";
-import "../../chunk-MLGO3HLS.js";
 import "../../chunk-Y3OTJH2S.js";
 import "../../chunk-ORMEWXMH.js";
 export {

package/dist/error/hooks/useErrorHandler.js

@@ -1,12 +1,12 @@
 "use client";
 import {
   useErrorHandler
-} from "../../chunk-IAJNC34M.js";
+} from "../../chunk-6UAYU5NU.js";
+import "../../chunk-MLGO3HLS.js";
 import "../../chunk-POKGHK3L.js";
 import "../../chunk-EEUBKZV4.js";
 import "../../chunk-N4YGR5WH.js";
 import "../../chunk-KXAWBFJN.js";
-import "../../chunk-MLGO3HLS.js";
 import "../../chunk-Y3OTJH2S.js";
 import "../../chunk-ORMEWXMH.js";
 export {

package/dist/error/index.js

@@ -1,29 +1,16 @@
 import "../chunk-ULF5RDDX.js";
-import {
-  withRetry
-} from "../chunk-A6EAAWMK.js";
-import {
-  CircuitBreaker,
-  ECircuitState
-} from "../chunk-7VJNLGAS.js";
-import {
-  FeatureDegradation
-} from "../chunk-TEIYA7U4.js";
 import {
   withFallback,
   withFallbackChain,
   withFallbackFn
 } from "../chunk-MYLGYX4K.js";
+import {
+  withRetry
+} from "../chunk-A6EAAWMK.js";
 import "../chunk-Y2TUZFCP.js";
 import {
   useErrorHandler
-} from "../chunk-IAJNC34M.js";
-import {
-  EmptyState,
-  ErrorAlert,
-  ErrorPage,
-  LoadingState
-} from "../chunk-ZHVUK5OY.js";
+} from "../chunk-6UAYU5NU.js";
 import "../chunk-7XFHGAJP.js";
 import "../chunk-COK4ZXNG.js";
 import {
@@ -47,15 +34,39 @@ import {
 import {
   ELogLevel
 } from "../chunk-6C7HQIX4.js";
+import {
+  CircuitBreaker,
+  ECircuitState
+} from "../chunk-7VJNLGAS.js";
+import {
+  FeatureDegradation
+} from "../chunk-TEIYA7U4.js";
+import {
+  EmptyState,
+  ErrorAlert,
+  ErrorPage,
+  LoadingState
+} from "../chunk-ZHVUK5OY.js";
 import {
   LocaleDetector
 } from "../chunk-XHZ5L4FO.js";
+import {
+  extractErrorInfo,
+  formatInlineError,
+  getDefaultErrorCode,
+  getErrorIcon,
+  handleApiResponse,
+  showFriendlyError
+} from "../chunk-3DZA6AGS.js";
 import {
   ErrorResponse,
   errorToResponse,
   processError,
   withErrorHandler
 } from "../chunk-GPBOMJSZ.js";
+import {
+  AppError
+} from "../chunk-MLGO3HLS.js";
 import {
   formatFriendlyError,
   getErrorDisplayInfo as getErrorDisplayInfo2,
@@ -70,17 +81,6 @@ import {
 } from "../chunk-EEUBKZV4.js";
 import "../chunk-N4YGR5WH.js";
 import "../chunk-KXAWBFJN.js";
-import {
-  AppError
-} from "../chunk-MLGO3HLS.js";
-import {
-  extractErrorInfo,
-  formatInlineError,
-  getDefaultErrorCode,
-  getErrorIcon,
-  handleApiResponse,
-  showFriendlyError
-} from "../chunk-3DZA6AGS.js";
 import {
   getErrorDisplayInfo
 } from "../chunk-2DVWSDST.js";

package/dist/error/recovery/index.js

@@ -1,4 +1,9 @@
 import "../../chunk-ULF5RDDX.js";
+import {
+  withFallback,
+  withFallbackChain,
+  withFallbackFn
+} from "../../chunk-MYLGYX4K.js";
 import {
   withRetry
 } from "../../chunk-A6EAAWMK.js";
@@ -9,11 +14,6 @@ import {
 import {
   FeatureDegradation
 } from "../../chunk-TEIYA7U4.js";
-import {
-  withFallback,
-  withFallbackChain,
-  withFallbackFn
-} from "../../chunk-MYLGYX4K.js";
 import "../../chunk-ORMEWXMH.js";
 export {
   CircuitBreaker,

package/dist/hooks/useDataTable.d.ts

@@ -22,6 +22,44 @@ export interface UseDataTableOptions<T> {
         pagination: DataTablePagination;
     }) => Promise<void>;
 }
+export interface UseDataTableState<T> {
+    data: T[];
+    loading: boolean;
+    error: string | null;
+    total: number;
+    filters: DataTableFilters;
+    sort: DataTableSort;
+    pagination: DataTablePagination;
+    selectedIds: string[];
+}
+export interface UseDataTableDataActions<T> {
+    setData: (data: T[]) => void;
+    setLoading: (loading: boolean) => void;
+    setError: (error: string | null) => void;
+    setTotal: (total: number) => void;
+}
+export interface UseDataTableFilterActions {
+    setFilters: (filters: DataTableFilters) => void;
+    updateFilter: (key: string, value: any) => void;
+    clearFilters: () => void;
+}
+export interface UseDataTableSortActions {
+    setSort: (sort: string, order?: 'asc' | 'desc') => void;
+}
+export interface UseDataTablePaginationActions {
+    setPage: (page: number) => void;
+    setPageSize: (pageSize: number) => void;
+}
+export interface UseDataTableSelectionActions {
+    setSelectedIds: (ids: string[]) => void;
+    toggleSelection: (id: string) => void;
+    selectAll: () => void;
+    clearSelection: () => void;
+}
+export interface UseDataTableActions {
+    refresh: () => Promise<void>;
+    bulkAction: (action: (ids: string[]) => Promise<void>) => Promise<void>;
+}
 export interface UseDataTableReturn<T> {
     data: T[];
     loading: boolean;
@@ -47,5 +85,12 @@ export interface UseDataTableReturn<T> {
     clearSelection: () => void;
     refresh: () => Promise<void>;
     bulkAction: (action: (ids: string[]) => Promise<void>) => Promise<void>;
+    state: UseDataTableState<T>;
+    dataActions: UseDataTableDataActions<T>;
+    filterActions: UseDataTableFilterActions;
+    sortActions: UseDataTableSortActions;
+    paginationActions: UseDataTablePaginationActions;
+    selectionActions: UseDataTableSelectionActions;
+    actions: UseDataTableActions;
 }
 export declare function useDataTable<T>({ initialFilters, initialSort, initialPagination, debounceMs, onDataChange, }: UseDataTableOptions<T>): UseDataTableReturn<T>;

package/dist/hooks/useDataTable.js

@@ -8,7 +8,7 @@ import {
 } from "../chunk-ORMEWXMH.js";
 
 // src/hooks/useDataTable.ts
-import { useState, useCallback, useMemo } from "react";
+import { useState, useCallback, useEffect } from "react";
 function useDataTable({
   initialFilters = {},
   initialSort = { sort: "createdAt", order: "desc" },
@@ -102,16 +102,16 @@ function useDataTable({
       setLoading(false);
     }
   }, [selectedIds, refresh]);
-  useMemo(() => {
+  useEffect(() => {
     if (debouncedSearch !== filters.search) {
       setPaginationState((prev) => __spreadProps(__spreadValues({}, prev), { page: 1 }));
     }
   }, [debouncedSearch, filters.search]);
-  useMemo(() => {
+  useEffect(() => {
     refresh();
   }, [debouncedSearch, sort.sort, sort.order, pagination.page, pagination.pageSize]);
   return {
-    // 상태
+    // 기존 flat 리턴 (하위 호환)
     data,
     loading,
     error,
@@ -120,28 +120,30 @@ function useDataTable({
     sort,
     pagination,
     selectedIds,
-    // 데이터 관리
     setData,
     setLoading,
     setError,
     setTotal,
-    // 필터 관리
     setFilters,
     updateFilter,
     clearFilters,
-    // 정렬 관리
     setSort,
-    // 페이지네이션 관리
     setPage,
     setPageSize,
-    // 선택 관리
     setSelectedIds,
     toggleSelection,
     selectAll,
     clearSelection,
-    // 액션
     refresh,
-    bulkAction
+    bulkAction,
+    // 새 그룹화 리턴
+    state: { data, loading, error, total, filters, sort, pagination, selectedIds },
+    dataActions: { setData, setLoading, setError, setTotal },
+    filterActions: { setFilters, updateFilter, clearFilters },
+    sortActions: { setSort },
+    paginationActions: { setPage, setPageSize },
+    selectionActions: { setSelectedIds, toggleSelection, selectAll, clearSelection },
+    actions: { refresh, bulkAction }
   };
 }
 export {

package/dist/middleware/error-handler.js

@@ -1,10 +1,10 @@
 import {
   errorHandlerMiddleware
-} from "../chunk-TMVS4F7E.js";
+} from "../chunk-5OWZKYWQ.js";
+import "../chunk-MLGO3HLS.js";
 import "../chunk-EEUBKZV4.js";
 import "../chunk-N4YGR5WH.js";
 import "../chunk-KXAWBFJN.js";
-import "../chunk-MLGO3HLS.js";
 import "../chunk-Y3OTJH2S.js";
 import "../chunk-EZR55KV2.js";
 import "../chunk-ORMEWXMH.js";

package/dist/middleware/index.js

@@ -4,7 +4,7 @@ import {
   withCustomApi,
   withOptionalAuthApi,
   withPublicApi
-} from "../chunk-SLG26KHZ.js";
+} from "../chunk-FH6E36YZ.js";
 import {
   MiddlewareChain
 } from "../chunk-4ODT3Q4A.js";
@@ -33,15 +33,15 @@ import {
 } from "../chunk-FOKAATUQ.js";
 import {
   errorHandlerMiddleware
-} from "../chunk-TMVS4F7E.js";
+} from "../chunk-5OWZKYWQ.js";
 import {
   initRequestMiddleware
 } from "../chunk-62Q7DN5G.js";
 import "../chunk-XHZ5L4FO.js";
+import "../chunk-MLGO3HLS.js";
 import "../chunk-EEUBKZV4.js";
 import "../chunk-N4YGR5WH.js";
 import "../chunk-KXAWBFJN.js";
-import "../chunk-MLGO3HLS.js";
 import "../chunk-Y3OTJH2S.js";
 import "../chunk-T3LJYAMO.js";
 import "../chunk-AIH3F7JV.js";

package/dist/middleware/wrappers.js

@@ -4,20 +4,20 @@ import {
   withCustomApi,
   withOptionalAuthApi,
   withPublicApi
-} from "../chunk-SLG26KHZ.js";
+} from "../chunk-FH6E36YZ.js";
 import "../chunk-4ODT3Q4A.js";
 import "../chunk-H5I5GWAA.js";
 import "../chunk-KAWVMIRJ.js";
 import "../chunk-WSQMXMTL.js";
 import "../chunk-UXQRU3EM.js";
 import "../chunk-FOKAATUQ.js";
-import "../chunk-TMVS4F7E.js";
+import "../chunk-5OWZKYWQ.js";
 import "../chunk-62Q7DN5G.js";
 import "../chunk-XHZ5L4FO.js";
+import "../chunk-MLGO3HLS.js";
 import "../chunk-EEUBKZV4.js";
 import "../chunk-N4YGR5WH.js";
 import "../chunk-KXAWBFJN.js";
-import "../chunk-MLGO3HLS.js";
 import "../chunk-Y3OTJH2S.js";
 import "../chunk-T3LJYAMO.js";
 import "../chunk-AIH3F7JV.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@withwiz/toolkit",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Shared utility library for withwiz projects",
   "license": "MIT",
   "private": false,
@@ -30,6 +30,8 @@
     "./cache/cache-env": "./dist/cache/cache-env.js",
     "./cache/hybrid-cache-manager": "./dist/cache/hybrid-cache-manager.js",
     "./components/ui/*": "./dist/components/ui/*.js",
+    "./components/ui/data-table": "./dist/components/ui/data-table/index.js",
+    "./components/ui/data-table/*": "./dist/components/ui/data-table/*.js",
     "./constants": "./dist/constants/index.js",
     "./constants/error-codes": "./dist/constants/error-codes.js",
     "./constants/messages": "./dist/constants/messages.js",

package/dist/{chunk-TMVS4F7E.js → chunk-5OWZKYWQ.js}

@@ -1,9 +1,9 @@
-import {
-  getErrorMessage
-} from "./chunk-EEUBKZV4.js";
 import {
   AppError
 } from "./chunk-MLGO3HLS.js";
+import {
+  getErrorMessage
+} from "./chunk-EEUBKZV4.js";
 import {
   ERROR_CODES
 } from "./chunk-Y3OTJH2S.js";