@withwiz/toolkit 0.1.0

package/dist/chunk-ZHVUK5OY.js

@@ -0,0 +1,314 @@
+import {
+  getErrorDisplayInfo
+} from "./chunk-POKGHK3L.js";
+
+// src/error/components/ErrorPage.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+function ErrorPage({
+  code,
+  locale = "ko",
+  showHomeButton = true,
+  homeUrl = "/",
+  showRetryButton = false,
+  onRetry,
+  additionalMessage
+}) {
+  const errorInfo = getErrorDisplayInfo(code, locale);
+  return /* @__PURE__ */ jsx("div", { className: "flex min-h-screen items-center justify-center bg-gray-50 px-4 py-12 sm:px-6 lg:px-8", children: /* @__PURE__ */ jsxs("div", { className: "w-full max-w-md space-y-8 text-center", children: [
+    /* @__PURE__ */ jsx("div", { className: "flex justify-center", children: /* @__PURE__ */ jsx("span", { className: "text-6xl", role: "img", "aria-label": "error-icon", children: errorInfo.icon }) }),
+    /* @__PURE__ */ jsxs("div", { className: "text-sm font-medium text-gray-500", children: [
+      locale === "ko" ? "\uC624\uB958 \uCF54\uB4DC" : "Error Code",
+      ": ",
+      code
+    ] }),
+    /* @__PURE__ */ jsx("div", { children: /* @__PURE__ */ jsx("h1", { className: "text-3xl font-bold tracking-tight text-gray-900", children: errorInfo.title }) }),
+    /* @__PURE__ */ jsxs("div", { className: "space-y-2", children: [
+      /* @__PURE__ */ jsx("p", { className: "text-base text-gray-600", children: errorInfo.description }),
+      errorInfo.action && /* @__PURE__ */ jsx("p", { className: "text-sm text-gray-500", children: errorInfo.action }),
+      additionalMessage && /* @__PURE__ */ jsx("p", { className: "text-sm text-gray-500", children: additionalMessage })
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-3 sm:flex-row sm:justify-center", children: [
+      showHomeButton && /* @__PURE__ */ jsx(
+        "a",
+        {
+          href: homeUrl,
+          className: "inline-flex items-center justify-center rounded-md border border-transparent bg-blue-600 px-6 py-3 text-base font-medium text-white shadow-sm hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2",
+          children: locale === "ko" ? "\uD648\uC73C\uB85C \uB3CC\uC544\uAC00\uAE30" : "Go to Home"
+        }
+      ),
+      showRetryButton && onRetry && /* @__PURE__ */ jsx(
+        "button",
+        {
+          onClick: onRetry,
+          className: "inline-flex items-center justify-center rounded-md border border-gray-300 bg-white px-6 py-3 text-base font-medium text-gray-700 shadow-sm hover:bg-gray-50 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2",
+          children: locale === "ko" ? "\uB2E4\uC2DC \uC2DC\uB3C4" : "Retry"
+        }
+      )
+    ] })
+  ] }) });
+}
+
+// src/error/components/ErrorAlert.tsx
+import { useState } from "react";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+var severityColors = {
+  info: {
+    bg: "bg-blue-50",
+    border: "border-blue-200",
+    text: "text-blue-800",
+    icon: "text-blue-400"
+  },
+  warning: {
+    bg: "bg-yellow-50",
+    border: "border-yellow-200",
+    text: "text-yellow-800",
+    icon: "text-yellow-400"
+  },
+  error: {
+    bg: "bg-red-50",
+    border: "border-red-200",
+    text: "text-red-800",
+    icon: "text-red-400"
+  },
+  critical: {
+    bg: "bg-red-100",
+    border: "border-red-300",
+    text: "text-red-900",
+    icon: "text-red-500"
+  }
+};
+function ErrorAlert({
+  code,
+  locale = "ko",
+  dismissible = false,
+  onDismiss,
+  actionText,
+  onAction,
+  additionalMessage,
+  icon: customIcon,
+  variant = "filled"
+}) {
+  const [isVisible, setIsVisible] = useState(true);
+  const errorInfo = getErrorDisplayInfo(code, locale);
+  const colors = severityColors[errorInfo.severity];
+  const handleDismiss = () => {
+    setIsVisible(false);
+    onDismiss == null ? void 0 : onDismiss();
+  };
+  if (!isVisible) {
+    return null;
+  }
+  return /* @__PURE__ */ jsxs2(
+    "div",
+    {
+      className: `rounded-lg ${variant === "filled" ? colors.bg : "bg-white"} border ${colors.border} p-4`,
+      role: "alert",
+      children: [
+        /* @__PURE__ */ jsxs2("div", { className: "flex", children: [
+          /* @__PURE__ */ jsx2("div", { className: "flex-shrink-0", children: /* @__PURE__ */ jsx2(
+            "span",
+            {
+              className: `text-xl ${colors.icon}`,
+              role: "img",
+              "aria-label": "error-icon",
+              children: customIcon || errorInfo.icon
+            }
+          ) }),
+          /* @__PURE__ */ jsxs2("div", { className: "ml-3 flex-1", children: [
+            /* @__PURE__ */ jsx2("h3", { className: `text-sm font-medium ${colors.text}`, children: errorInfo.title }),
+            /* @__PURE__ */ jsxs2("div", { className: `mt-2 text-sm ${colors.text}`, children: [
+              /* @__PURE__ */ jsx2("p", { children: errorInfo.description }),
+              errorInfo.action && /* @__PURE__ */ jsx2("p", { className: "mt-1 text-xs opacity-80", children: errorInfo.action }),
+              additionalMessage && /* @__PURE__ */ jsx2("p", { className: "mt-1 text-xs opacity-80", children: additionalMessage })
+            ] }),
+            actionText && onAction && /* @__PURE__ */ jsx2("div", { className: "mt-3", children: /* @__PURE__ */ jsx2(
+              "button",
+              {
+                onClick: onAction,
+                className: `rounded-md px-3 py-2 text-sm font-medium ${colors.text} hover:bg-opacity-20 focus:outline-none focus:ring-2 focus:ring-offset-2`,
+                children: actionText
+              }
+            ) })
+          ] }),
+          dismissible && /* @__PURE__ */ jsx2("div", { className: "ml-auto flex-shrink-0 pl-3", children: /* @__PURE__ */ jsxs2(
+            "button",
+            {
+              onClick: handleDismiss,
+              className: `inline-flex rounded-md ${colors.text} hover:bg-opacity-20 focus:outline-none focus:ring-2 focus:ring-offset-2`,
+              "aria-label": "Close",
+              children: [
+                /* @__PURE__ */ jsx2("span", { className: "sr-only", children: "Close" }),
+                /* @__PURE__ */ jsx2(
+                  "svg",
+                  {
+                    className: "h-5 w-5",
+                    xmlns: "http://www.w3.org/2000/svg",
+                    viewBox: "0 0 20 20",
+                    fill: "currentColor",
+                    "aria-hidden": "true",
+                    children: /* @__PURE__ */ jsx2(
+                      "path",
+                      {
+                        fillRule: "evenodd",
+                        d: "M4.293 4.293a1 1 0 011.414 0L10 8.586l4.293-4.293a1 1 0 111.414 1.414L11.414 10l4.293 4.293a1 1 0 01-1.414 1.414L10 11.414l-4.293 4.293a1 1 0 01-1.414-1.414L8.586 10 4.293 5.707a1 1 0 010-1.414z",
+                        clipRule: "evenodd"
+                      }
+                    )
+                  }
+                )
+              ]
+            }
+          ) })
+        ] }),
+        /* @__PURE__ */ jsxs2("div", { className: `ml-9 mt-2 text-xs ${colors.text} opacity-60`, children: [
+          "Code: ",
+          code
+        ] })
+      ]
+    }
+  );
+}
+
+// src/error/components/LoadingState.tsx
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+var sizeStyles = {
+  sm: {
+    spinner: "h-4 w-4 border-2",
+    text: "text-sm",
+    dots: "h-2 w-2"
+  },
+  md: {
+    spinner: "h-8 w-8 border-2",
+    text: "text-base",
+    dots: "h-3 w-3"
+  },
+  lg: {
+    spinner: "h-12 w-12 border-4",
+    text: "text-lg",
+    dots: "h-4 w-4"
+  }
+};
+function LoadingState({
+  message,
+  locale = "ko",
+  size = "md",
+  fullScreen = false,
+  variant = "spinner"
+}) {
+  const defaultMessage = locale === "ko" ? "\uB85C\uB529 \uC911..." : "Loading...";
+  const displayMessage = message || defaultMessage;
+  const styles = sizeStyles[size];
+  const renderSpinner = () => /* @__PURE__ */ jsx3(
+    "div",
+    {
+      className: `${styles.spinner} animate-spin rounded-full border-blue-600 border-t-transparent`,
+      role: "status",
+      "aria-label": "loading"
+    }
+  );
+  const renderDots = () => /* @__PURE__ */ jsx3("div", { className: "flex space-x-2", children: [0, 1, 2].map((i) => /* @__PURE__ */ jsx3(
+    "div",
+    {
+      className: `${styles.dots} animate-bounce rounded-full bg-blue-600`,
+      style: { animationDelay: `${i * 0.15}s` }
+    },
+    i
+  )) });
+  const renderPulse = () => /* @__PURE__ */ jsx3("div", { className: "flex space-x-2", children: [0, 1, 2].map((i) => /* @__PURE__ */ jsx3(
+    "div",
+    {
+      className: `${styles.dots} animate-pulse rounded-full bg-blue-600`,
+      style: { animationDelay: `${i * 0.2}s` }
+    },
+    i
+  )) });
+  const renderLoadingAnimation = () => {
+    switch (variant) {
+      case "dots":
+        return renderDots();
+      case "pulse":
+        return renderPulse();
+      case "spinner":
+      default:
+        return renderSpinner();
+    }
+  };
+  const content = /* @__PURE__ */ jsxs3("div", { className: "flex flex-col items-center justify-center space-y-4", children: [
+    renderLoadingAnimation(),
+    /* @__PURE__ */ jsx3("p", { className: `${styles.text} text-gray-600`, children: displayMessage })
+  ] });
+  if (fullScreen) {
+    return /* @__PURE__ */ jsx3("div", { className: "fixed inset-0 z-50 flex items-center justify-center bg-white bg-opacity-75", children: content });
+  }
+  return /* @__PURE__ */ jsx3("div", { className: "flex items-center justify-center py-12", children: content });
+}
+
+// src/error/components/EmptyState.tsx
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+var sizeStyles2 = {
+  sm: {
+    container: "py-8",
+    icon: "text-4xl",
+    title: "text-base",
+    description: "text-sm"
+  },
+  md: {
+    container: "py-12",
+    icon: "text-6xl",
+    title: "text-lg",
+    description: "text-base"
+  },
+  lg: {
+    container: "py-16",
+    icon: "text-8xl",
+    title: "text-xl",
+    description: "text-lg"
+  }
+};
+function EmptyState({
+  title,
+  description,
+  locale = "ko",
+  icon = "\u{1F4E6}",
+  actionText,
+  onAction,
+  size = "md"
+}) {
+  const defaultTitle = locale === "ko" ? "\uB370\uC774\uD130\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4" : "No data available";
+  const defaultDescription = locale === "ko" ? "\uC544\uC9C1 \uB4F1\uB85D\uB41C \uD56D\uBAA9\uC774 \uC5C6\uC2B5\uB2C8\uB2E4." : "No items have been registered yet.";
+  const displayTitle = title || defaultTitle;
+  const displayDescription = description || defaultDescription;
+  const styles = sizeStyles2[size];
+  const renderIcon = () => {
+    if (typeof icon === "string") {
+      return /* @__PURE__ */ jsx4("span", { className: `${styles.icon}`, role: "img", "aria-label": "empty-icon", children: icon });
+    }
+    return icon;
+  };
+  return /* @__PURE__ */ jsxs4(
+    "div",
+    {
+      className: `flex flex-col items-center justify-center text-center ${styles.container}`,
+      children: [
+        /* @__PURE__ */ jsx4("div", { className: "mb-4 text-gray-400", children: renderIcon() }),
+        /* @__PURE__ */ jsx4("h3", { className: `${styles.title} font-semibold text-gray-900`, children: displayTitle }),
+        /* @__PURE__ */ jsx4("p", { className: `${styles.description} mt-2 text-gray-500`, children: displayDescription }),
+        actionText && onAction && /* @__PURE__ */ jsx4(
+          "button",
+          {
+            onClick: onAction,
+            className: "mt-6 inline-flex items-center rounded-md border border-transparent bg-blue-600 px-4 py-2 text-sm font-medium text-white shadow-sm hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2",
+            children: actionText
+          }
+        )
+      ]
+    }
+  );
+}
+
+export {
+  ErrorPage,
+  ErrorAlert,
+  LoadingState,
+  EmptyState
+};

package/dist/chunk-ZTN4X5FN.js

@@ -0,0 +1,29 @@
+// src/hooks/useDebounce.ts
+import { useEffect, useState, useRef } from "react";
+function useDebounce(value, delay) {
+  const [debouncedValue, setDebouncedValue] = useState(value);
+  const timeoutRef = useRef(null);
+  const lastValueRef = useRef(value);
+  useEffect(() => {
+    if (value === lastValueRef.current) {
+      return;
+    }
+    lastValueRef.current = value;
+    if (timeoutRef.current) {
+      clearTimeout(timeoutRef.current);
+    }
+    timeoutRef.current = setTimeout(() => {
+      setDebouncedValue(value);
+    }, delay);
+    return () => {
+      if (timeoutRef.current) {
+        clearTimeout(timeoutRef.current);
+      }
+    };
+  }, [value, delay]);
+  return debouncedValue;
+}
+
+export {
+  useDebounce
+};

package/dist/chunk-ZZIKRBJU.js

@@ -0,0 +1,96 @@
+import {
+  BaseTransport
+} from "./chunk-HGC4CCKB.js";
+
+// src/error/logging/transports/sentry.ts
+var SENTRY_SEVERITY_MAP = {
+  ["debug" /* DEBUG */]: "debug",
+  ["info" /* INFO */]: "info",
+  ["warn" /* WARN */]: "warning",
+  ["error" /* ERROR */]: "error",
+  ["critical" /* CRITICAL */]: "fatal"
+};
+var SentryTransport = class extends BaseTransport {
+  constructor(options = {}) {
+    const dsn = options.dsn || process.env.SENTRY_DSN || process.env.NEXT_PUBLIC_SENTRY_DSN;
+    super("sentry", Boolean(dsn) && options.enabled !== false);
+    this.Sentry = null;
+    this.dsn = dsn;
+    this.environment = options.environment || process.env.NODE_ENV || "development";
+    this.minLevel = options.minLevel || "error" /* ERROR */;
+    if (this.isEnabled()) {
+      this.initSentry();
+    }
+  }
+  /**
+   * Sentry 초기화
+   */
+  async initSentry() {
+    try {
+      const isServer = typeof window === "undefined";
+      if (isServer) {
+        const Sentry = await import("@sentry/node");
+        this.Sentry = Sentry;
+      } else {
+        const Sentry = await import("@sentry/browser");
+        this.Sentry = Sentry;
+      }
+      this.Sentry.init({
+        dsn: this.dsn,
+        environment: this.environment,
+        // 성능 모니터링 비활성화 (에러 로깅만)
+        tracesSampleRate: 0
+      });
+    } catch (error) {
+      console.error("[SentryTransport] Failed to initialize Sentry:", error);
+      this.disable();
+    }
+  }
+  async log(entry) {
+    if (!this.Sentry) {
+      return;
+    }
+    if (!this.shouldLog(entry.level)) {
+      return;
+    }
+    try {
+      this.Sentry.withScope((scope) => {
+        scope.setLevel(SENTRY_SEVERITY_MAP[entry.level]);
+        if (entry.context.requestId) {
+          scope.setTag("requestId", entry.context.requestId);
+        }
+        if (entry.context.userId) {
+          scope.setUser({ id: entry.context.userId });
+        }
+        if (entry.context.errorCode) {
+          scope.setTag("errorCode", entry.context.errorCode);
+        }
+        scope.setContext("error_context", entry.context);
+        if (entry.error) {
+          this.Sentry.captureException(entry.error);
+        } else {
+          this.Sentry.captureMessage(entry.message);
+        }
+      });
+    } catch (error) {
+      console.error("[SentryTransport] Failed to send to Sentry:", error);
+    }
+  }
+  /**
+   * 로그 레벨 체크
+   */
+  shouldLog(level) {
+    const LOG_LEVEL_PRIORITY = {
+      ["debug" /* DEBUG */]: 0,
+      ["info" /* INFO */]: 1,
+      ["warn" /* WARN */]: 2,
+      ["error" /* ERROR */]: 3,
+      ["critical" /* CRITICAL */]: 4
+    };
+    return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[this.minLevel];
+  }
+};
+
+export {
+  SentryTransport
+};

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

@@ -0,0 +1,12 @@
+import React from 'react';
+export interface IAlertProps {
+    variant?: 'default' | 'destructive';
+    children: React.ReactNode;
+    className?: string;
+}
+export interface IAlertDescriptionProps {
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function Alert({ variant, children, className }: IAlertProps): import("react/jsx-runtime").JSX.Element;
+export declare function AlertDescription({ children, className }: IAlertDescriptionProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ui/Alert.js

@@ -0,0 +1,10 @@
+import {
+  Alert,
+  AlertDescription
+} from "../../chunk-F6LCSFSU.js";
+import "../../chunk-62FLBG6B.js";
+import "../../chunk-ORMEWXMH.js";
+export {
+  Alert,
+  AlertDescription
+};

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

@@ -0,0 +1,7 @@
+import React from 'react';
+export interface IBadgeProps {
+    children: React.ReactNode;
+    variant?: 'default' | 'secondary' | 'destructive' | 'outline';
+    className?: string;
+}
+export declare function Badge({ children, variant, className }: IBadgeProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ui/Badge.js

@@ -0,0 +1,8 @@
+import {
+  Badge
+} from "../../chunk-UCYQNHST.js";
+import "../../chunk-62FLBG6B.js";
+import "../../chunk-ORMEWXMH.js";
+export {
+  Badge
+};

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

@@ -0,0 +1,7 @@
+import React from 'react';
+export interface IButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: 'default' | 'destructive' | 'outline' | 'secondary' | 'ghost' | 'link';
+    size?: 'default' | 'sm' | 'lg' | 'icon';
+    children: React.ReactNode;
+}
+export declare function Button({ className, variant, size, children, ...props }: IButtonProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/ui/Button.js

@@ -0,0 +1,8 @@
+import {
+  Button
+} from "../../chunk-L25BNU3E.js";
+import "../../chunk-62FLBG6B.js";
+import "../../chunk-ORMEWXMH.js";
+export {
+  Button
+};

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

@@ -0,0 +1,103 @@
+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 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;
+}
+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>;
+}
+export declare function DataTable<T>({ data, columns, loading, error, pagination, sort, bulkActions, filters, filterValues, onFilterChange, onClearFilters, selectable, onSelectionChange, selectedIds, getRowId, className, emptyMessage, searchPlaceholder, onSearch, onSearchValueChange, searchValue, showFilters, onToggleFilters, createButton, labels: customLabels, }: DataTableProps<T>): import("react/jsx-runtime").JSX.Element;