@wipco/sdui 0.30.0 → 0.31.0

package/dist/chunk-RRMKCZYQ.js

@@ -0,0 +1,67 @@
+import { Spinner, EmptyState } from './chunk-WIDDHR7L.js';
+import { useState, useEffect } from 'react';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+function useOptionalModule(load) {
+  const [state, setState] = useState({ status: "loading" });
+  useEffect(() => {
+    let alive = true;
+    load().then(
+      (module) => {
+        if (alive) setState({ status: "ready", module });
+      },
+      (error) => {
+        if (!alive) return;
+        console.warn("[sdui] \uC120\uD0DD \uC758\uC874\uC131 \uB85C\uB4DC \uC2E4\uD328 \u2014 \uD50C\uB808\uC774\uC2A4\uD640\uB354\uB85C \uB300\uCCB4\uD569\uB2C8\uB2E4", error);
+        setState({ status: "missing" });
+      }
+    );
+    return () => {
+      alive = false;
+    };
+  }, [load]);
+  return state;
+}
+var optionalModuleCache = /* @__PURE__ */ new WeakMap();
+function loadOptionalModule(load, packageName) {
+  const cached = optionalModuleCache.get(load);
+  if (cached) return cached;
+  const pending = load().catch((error) => {
+    console.warn(`[sdui] \uC120\uD0DD \uC758\uC874\uC131 '${packageName}' \uB85C\uB4DC \uC2E4\uD328`, error);
+    optionalModuleCache.delete(load);
+    throw new Error(`${packageName} \uD328\uD0A4\uC9C0\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4 \u2014 \uD504\uB85C\uC81D\uD2B8\uC5D0 \uC124\uCE58\uD574 \uC8FC\uC138\uC694`);
+  });
+  optionalModuleCache.set(load, pending);
+  return pending;
+}
+function DependencyPlaceholder({
+  packageName,
+  purpose,
+  height,
+  loading = false
+}) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      style: {
+        minHeight: height,
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        border: "1px solid var(--wp-border-subtle)",
+        borderRadius: "var(--wp-radius-md)",
+        background: "var(--wp-surface-sunken)"
+      },
+      children: loading ? /* @__PURE__ */ jsx(Spinner, { label: `${purpose} \uC900\uBE44 \uC911` }) : /* @__PURE__ */ jsxs(EmptyState, { tight: true, icon: "box", title: `${purpose}\uB97C \uADF8\uB9AC\uB824\uBA74 ${packageName} \uD328\uD0A4\uC9C0\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4`, children: [
+        "\uC120\uD0DD \uC758\uC874\uC131\uC774\uB77C \uAE30\uBCF8 \uC124\uCE58\uC5D0\uB294 \uD3EC\uD568\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2014 ",
+        /* @__PURE__ */ jsxs("code", { children: [
+          "pnpm add ",
+          packageName
+        ] }),
+        " \uD6C4 \uB2E4\uC2DC \uC5F4\uC5B4 \uC8FC\uC138\uC694."
+      ] })
+    }
+  );
+}
+
+export { DependencyPlaceholder, loadOptionalModule, useOptionalModule };

package/dist/{chunk-WXOU7QTN.js → chunk-SNRKPEWT.js}

@@ -1,5 +1,5 @@
 import { useDismiss, usePopoverAnchor, usePortalTo, HoistedStyle, AnchoredPopoverStyles, anchorStyle, focusStaysInside } from './chunk-EFMKWPZ3.js';
-import { Icon, Spinner, EmptyState } from './chunk-WIDDHR7L.js';
+import { Icon } from './chunk-WIDDHR7L.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { useState, useRef, useEffect, useMemo, useCallback } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
@@ -194,66 +194,5 @@ var TP_CSS = `
 .wp-tp-opt--on{background:var(--wp-action-primary-bg);color:var(--wp-action-primary-fg);font-weight:500}
 `;
 var TimePicker = boxed(TimePickerImpl, "TimePicker");
-function useOptionalModule(load) {
-  const [state, setState] = useState({ status: "loading" });
-  useEffect(() => {
-    let alive = true;
-    load().then(
-      (module) => {
-        if (alive) setState({ status: "ready", module });
-      },
-      (error) => {
-        if (!alive) return;
-        console.warn("[sdui] \uC120\uD0DD \uC758\uC874\uC131 \uB85C\uB4DC \uC2E4\uD328 \u2014 \uD50C\uB808\uC774\uC2A4\uD640\uB354\uB85C \uB300\uCCB4\uD569\uB2C8\uB2E4", error);
-        setState({ status: "missing" });
-      }
-    );
-    return () => {
-      alive = false;
-    };
-  }, [load]);
-  return state;
-}
-var optionalModuleCache = /* @__PURE__ */ new WeakMap();
-function loadOptionalModule(load, packageName) {
-  const cached = optionalModuleCache.get(load);
-  if (cached) return cached;
-  const pending = load().catch((error) => {
-    console.warn(`[sdui] \uC120\uD0DD \uC758\uC874\uC131 '${packageName}' \uB85C\uB4DC \uC2E4\uD328`, error);
-    optionalModuleCache.delete(load);
-    throw new Error(`${packageName} \uD328\uD0A4\uC9C0\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4 \u2014 \uD504\uB85C\uC81D\uD2B8\uC5D0 \uC124\uCE58\uD574 \uC8FC\uC138\uC694`);
-  });
-  optionalModuleCache.set(load, pending);
-  return pending;
-}
-function DependencyPlaceholder({
-  packageName,
-  purpose,
-  height,
-  loading = false
-}) {
-  return /* @__PURE__ */ jsx(
-    "div",
-    {
-      style: {
-        minHeight: height,
-        display: "flex",
-        alignItems: "center",
-        justifyContent: "center",
-        border: "1px solid var(--wp-border-subtle)",
-        borderRadius: "var(--wp-radius-md)",
-        background: "var(--wp-surface-sunken)"
-      },
-      children: loading ? /* @__PURE__ */ jsx(Spinner, { label: `${purpose} \uC900\uBE44 \uC911` }) : /* @__PURE__ */ jsxs(EmptyState, { tight: true, icon: "box", title: `${purpose}\uB97C \uADF8\uB9AC\uB824\uBA74 ${packageName} \uD328\uD0A4\uC9C0\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4`, children: [
-        "\uC120\uD0DD \uC758\uC874\uC131\uC774\uB77C \uAE30\uBCF8 \uC124\uCE58\uC5D0\uB294 \uD3EC\uD568\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2014 ",
-        /* @__PURE__ */ jsxs("code", { children: [
-          "pnpm add ",
-          packageName
-        ] }),
-        " \uD6C4 \uB2E4\uC2DC \uC5F4\uC5B4 \uC8FC\uC138\uC694."
-      ] })
-    }
-  );
-}
 
-export { DependencyPlaceholder, TimePicker, loadOptionalModule, useOptionalModule };
+export { TimePicker };

package/dist/index.js

@@ -1,5 +1,6 @@
-import { TimePicker } from './chunk-WXOU7QTN.js';
-export { TimePicker, loadOptionalModule } from './chunk-WXOU7QTN.js';
+import { TimePicker } from './chunk-SNRKPEWT.js';
+export { TimePicker } from './chunk-SNRKPEWT.js';
+export { loadOptionalModule } from './chunk-RRMKCZYQ.js';
 import { useSduiDispatch, SduiDialog, useSduiCan, SduiDispatchContext, SduiPermissionProvider } from './chunk-QU7YVMFA.js';
 export { SduiDialog, SduiPermissionProvider, useSduiCan, useSduiDispatch } from './chunk-QU7YVMFA.js';
 import { ImageViewer } from './chunk-THEP3VWY.js';

package/dist/meta.d.ts

@@ -431,6 +431,7 @@ declare const OrgChartBoardMeta: SduiComponentMeta;
 declare const PermissionMatrixEditorMeta: SduiComponentMeta;
 declare const RoleMemberPickerMeta: SduiComponentMeta;
 declare const FileDropzoneMeta: SduiComponentMeta;
+declare const ExcelUploadCardMeta: SduiComponentMeta;
 declare const AutocompleteFieldMeta: SduiComponentMeta;
 declare const InlineEditMeta: SduiComponentMeta;
 declare const JsonFieldMeta: SduiComponentMeta;
@@ -456,7 +457,7 @@ declare const StripMeta: SduiComponentMeta;
 /**
  * 위젯 어휘의 메타데이터.
  *
- * 키 타입이 `SduiWidgetComponentName | 'AutocompleteField' | 'FileDropzone'`인 이유:
+ * 키 타입이 `SduiWidgetComponentName | 'AutocompleteField' | 'FileDropzone' | 'ExcelUploadCard'`인 이유:
  * 앞의 20종은 `widgetComponents`와 키가 어긋나면 컴파일 에러가 나야 하고(core·rich와 같다),
  * `AutocompleteField`는 그 묶음에 **일부러 빠져 있는** 이름이라 union에 직접 적어야 한다.
  * 표시 계층만 라이브러리에 있고 조회는 앱 어댑터가 얹는 구조인데(widgets/index.ts 참고),
@@ -467,6 +468,7 @@ declare const widgetComponentMeta: {
     ApprovalLineEditor: SduiComponentMeta;
     ApprovalOverridesEditor: SduiComponentMeta;
     ApprovalStepper: SduiComponentMeta;
+    ExcelUploadCard: SduiComponentMeta;
     FileDropzone: SduiComponentMeta;
     PermissionMatrixEditor: SduiComponentMeta;
     RoleMemberPicker: SduiComponentMeta;
@@ -604,4 +606,4 @@ declare function paletteGroups(catalog?: Record<string, SduiComponentMeta>): Arr
     items: SduiComponentMeta[];
 }>;
 
-export { ActionsMeta, AlertMeta, ApprovalLineEditorMeta, ApprovalOverridesEditorMeta, ApprovalStepperMeta, AutocompleteFieldMeta, AvatarMeta, BadgeMeta, BreadcrumbMeta, ButtonMeta, CanMeta, CardMeta, ChartMeta, CheckboxMeta, ColMeta, ColumnBoardMeta, DatePickerMeta, DateRangePickerMeta, DialogMeta, DiffViewMeta, DisclosureMeta, DividerMeta, EmptyStateMeta, EventCalendarMeta, FieldMeta, FileDropzoneMeta, ForEachMeta, FormMeta, FragmentMeta, GridMeta, IconButtonMeta, IconMeta, ImageLightboxMeta, InlineEditMeta, InputMeta, JsonFieldMeta, KeyValueListMeta, LiveClockMeta, MapPreviewMeta, OrgChartBoardMeta, OrgChartMeta, PageHeadMeta, PaginationMeta, PeriodFilterMeta, PermissionMatrixEditorMeta, PrintSheetMeta, ProgressBarMeta, RadioMeta, RankBoardMeta, RecordSheetMeta, RemoteSearchResultsMeta, RoleMemberPickerMeta, RowMeta, SDUI_CATEGORIES, SELF_AXIS_PROPS, type SduiCategory, type SduiChildrenMeta, type SduiComponentMeta, type SduiDomMeta, type SduiEnumOption, type SduiPropGroup, type SduiPropKind, type SduiPropMeta, type SduiResizeMeta, type SduiSlotMeta, SearchResultsMeta, SearchableMultiPickerMeta, SectionMeta, SecureScreenMeta, SegmentedControlMeta, SelectMeta, ShowMeta, SidebarNavMeta, SortHandleMeta, SortableListMeta, SpacerMeta, SpinnerMeta, StackedMeterMeta, StatCardMeta, StripMeta, SummaryTableMeta, SwitchMeta, TableMeta, TabsMeta, TagMeta, TagMultiSelectMeta, TextMeta, TextareaMeta, TimePickerMeta, TimelineMeta, ToastMeta, TooltipMeta, TreePickerMeta, TreeViewMeta, allComponentMeta, builtinComponentMeta, coreComponentMeta, dsComponentMeta, getComponentMeta, paletteGroups, richComponentMeta, slotNamesOf, widgetComponentMeta, withSelfAxis, withSelfAxisAll };
+export { ActionsMeta, AlertMeta, ApprovalLineEditorMeta, ApprovalOverridesEditorMeta, ApprovalStepperMeta, AutocompleteFieldMeta, AvatarMeta, BadgeMeta, BreadcrumbMeta, ButtonMeta, CanMeta, CardMeta, ChartMeta, CheckboxMeta, ColMeta, ColumnBoardMeta, DatePickerMeta, DateRangePickerMeta, DialogMeta, DiffViewMeta, DisclosureMeta, DividerMeta, EmptyStateMeta, EventCalendarMeta, ExcelUploadCardMeta, FieldMeta, FileDropzoneMeta, ForEachMeta, FormMeta, FragmentMeta, GridMeta, IconButtonMeta, IconMeta, ImageLightboxMeta, InlineEditMeta, InputMeta, JsonFieldMeta, KeyValueListMeta, LiveClockMeta, MapPreviewMeta, OrgChartBoardMeta, OrgChartMeta, PageHeadMeta, PaginationMeta, PeriodFilterMeta, PermissionMatrixEditorMeta, PrintSheetMeta, ProgressBarMeta, RadioMeta, RankBoardMeta, RecordSheetMeta, RemoteSearchResultsMeta, RoleMemberPickerMeta, RowMeta, SDUI_CATEGORIES, SELF_AXIS_PROPS, type SduiCategory, type SduiChildrenMeta, type SduiComponentMeta, type SduiDomMeta, type SduiEnumOption, type SduiPropGroup, type SduiPropKind, type SduiPropMeta, type SduiResizeMeta, type SduiSlotMeta, SearchResultsMeta, SearchableMultiPickerMeta, SectionMeta, SecureScreenMeta, SegmentedControlMeta, SelectMeta, ShowMeta, SidebarNavMeta, SortHandleMeta, SortableListMeta, SpacerMeta, SpinnerMeta, StackedMeterMeta, StatCardMeta, StripMeta, SummaryTableMeta, SwitchMeta, TableMeta, TabsMeta, TagMeta, TagMultiSelectMeta, TextMeta, TextareaMeta, TimePickerMeta, TimelineMeta, ToastMeta, TooltipMeta, TreePickerMeta, TreeViewMeta, allComponentMeta, builtinComponentMeta, coreComponentMeta, dsComponentMeta, getComponentMeta, paletteGroups, richComponentMeta, slotNamesOf, widgetComponentMeta, withSelfAxis, withSelfAxisAll };

package/dist/meta.js

@@ -3949,6 +3949,117 @@ var FileDropzoneMeta = {
   },
   resize: { kind: "none" }
 };
+var ExcelUploadCardMeta = {
+  name: "ExcelUploadCard",
+  label: "\uC5D1\uC140 \uC77C\uAD04 \uC5C5\uB85C\uB4DC",
+  category: "data",
+  icon: "cloud-upload",
+  description: "\uC5D1\uC140 \uC77C\uAD04 \uC5C5\uB85C\uB4DC \uCE74\uB4DC. server\uB294 \uD30C\uC77C\uC744 \uADF8\uB300\uB85C \uC62C\uB824 \uCC98\uB9AC \uC694\uC57D\uC744 \uBC1B\uACE0, preview\uB294 \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uD30C\uC2F1\xB7\uAC80\uC99D\uD558\uACE0 \uC624\uB958 \uC140\uC744 \uACE0\uCE5C \uB4A4 \uC720\uD6A8 \uD589\uB9CC \uBCF4\uB0B8\uB2E4.",
+  props: [
+    {
+      name: "mode",
+      kind: "enum",
+      label: "\uB3D9\uC791 \uBC29\uC2DD",
+      default: "server",
+      options: [
+        { value: "server", label: "\uC11C\uBC84 \uC5C5\uB85C\uB4DC", description: "\uD30C\uC77C\uC744 multipart\uB85C \uC62C\uB9AC\uACE0 \uCC98\uB9AC \uC694\uC57D\xB7\uD589 \uC624\uB958\uB97C \uBC1B\uB294\uB2E4" },
+        { value: "preview", label: "\uBBF8\uB9AC\uBCF4\uAE30 \uAC80\uC99D", description: "\uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uD30C\uC2F1\xB7\uAC80\uC99D\uD558\uACE0 \uC624\uB958 \uC140\uC744 \uC778\uB77C\uC778 \uC218\uC815\uD55C \uB4A4 \uC720\uD6A8 \uD589\uB9CC \uBCF4\uB0B8\uB2E4" }
+      ],
+      group: "behavior"
+    },
+    // 실측 8/8 (preview×5, server×3)
+    {
+      name: "endpoint",
+      kind: "string",
+      label: "\uC5C5\uB85C\uB4DC \uACBD\uB85C",
+      description: "server\uBA74 \uD30C\uC77C multipart POST \uB300\uC0C1, preview\uBA74 \uAC80\uC99D\uB41C { rows } JSON POST \uB300\uC0C1.",
+      group: "data"
+    },
+    // 실측 7/8
+    {
+      name: "templateColumns",
+      kind: "array",
+      label: "\uD15C\uD50C\uB9BF \uCEEC\uB7FC",
+      description: "\uC788\uC73C\uBA74 \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uD15C\uD50C\uB9BF xlsx\uB97C \uB9CC\uB4E0\uB2E4(\uBC31\uC5D4\uB4DC \uBD88\uD544\uC694). 2\uD589\uC5D0 \uC608\uC2DC\uAC12\uC774 \uB4E4\uC5B4\uAC04\uB2E4.",
+      group: "data",
+      // 실측 8/8, 원소 54개 — key·header·example 세 키가 모두 54/54로 항상 채워져 있다.
+      item: [
+        { name: "key", kind: "string", label: "\uD0A4", required: true },
+        { name: "header", kind: "string", label: "\uD5E4\uB354", required: true },
+        { name: "example", kind: "string", label: "\uC608\uC2DC\uAC12", description: "\uD15C\uD50C\uB9BF 2\uD589\uC5D0 \uB4E4\uC5B4\uAC04\uB2E4." }
+      ]
+    },
+    {
+      name: "columns",
+      kind: "array",
+      label: "\uAC80\uC99D \uC2A4\uD0A4\uB9C8",
+      description: "preview \uBAA8\uB4DC\uC758 \uD30C\uC2F1\xB7\uAC80\uC99D \uAE30\uC900. \uC2E4\uCE21\uC0C1 preview \uC778\uC2A4\uD134\uC2A4 5\uAC1C\uC640 \uC815\uD655\uD788 \uC77C\uCE58\uD55C\uB2E4.",
+      group: "data",
+      // 실측 5/8, 원소 34개 — key·header 34/34, required 17/34(값은 전부 true), options 9/34.
+      item: [
+        { name: "key", kind: "string", label: "\uD0A4", required: true },
+        { name: "header", kind: "string", label: "\uC5D1\uC140 \uD5E4\uB354", required: true, description: "\uD55C\uAD6D\uC5B4 \uBCC4\uCE6D. key\uC640\uB3C4 \uB9E4\uCE6D\uB41C\uB2E4." },
+        { name: "required", kind: "boolean", label: "\uD544\uC218", default: false },
+        {
+          name: "options",
+          kind: "array",
+          label: "\uD5C8\uC6A9\uAC12",
+          description: "\uC788\uC73C\uBA74 \uC624\uB958 \uC140\uC744 Select\uB85C, \uC5C6\uC73C\uBA74 Input\uC73C\uB85C \uACE0\uCE5C\uB2E4.",
+          item: [],
+          itemKind: "string"
+        }
+      ]
+    },
+    {
+      name: "summaryLabels",
+      kind: "object",
+      label: "\uC694\uC57D \uD0C0\uC77C \uB77C\uBCA8",
+      // fields를 적지 않아 자유 JSON으로 둔다 — 키가 백엔드 응답의 숫자 필드 이름이라
+      // 엔드포인트마다 다르다. 실측에서도 rows(3)·createdUnits(2) 외에 skippedRows·
+      // createdAssets·skippedUnits·createdBorrows·skippedBorrows가 각 1회씩으로 전부 달랐다.
+      description: "\uC11C\uBC84 \uC751\uB2F5\uC758 \uC22B\uC790 \uD544\uB4DC \uC774\uB984 \u2192 \uC694\uC57D \uD0C0\uC77C\uC5D0 \uC4F8 \uB77C\uBCA8. server \uBAA8\uB4DC\uC5D0\uC11C\uB9CC \uC4F0\uC778\uB2E4.",
+      group: "content"
+    },
+    // 실측 3/8 — server 인스턴스 3개와 일치
+    {
+      name: "templateEndpoint",
+      kind: "string",
+      label: "\uD15C\uD50C\uB9BF \uB2E4\uC6B4\uB85C\uB4DC \uACBD\uB85C",
+      description: "templateColumns\uAC00 \uC5C6\uC744 \uB54C\uB9CC \uC4F0\uC778\uB2E4(blob \uB2E4\uC6B4\uB85C\uB4DC).",
+      group: "data",
+      advanced: true
+    },
+    // 실측 0/8 — 구현에는 있다
+    {
+      name: "onComplete",
+      kind: "action",
+      label: "\uC644\uB8CC",
+      eventArg: "server\uBA74 \uC751\uB2F5 JSON, preview\uBA74 \uC11C\uBC84 \uC751\uB2F5 \uB610\uB294 \uAC80\uC99D\uB41C \uC720\uD6A8 \uD589 \uBC30\uC5F4",
+      group: "behavior"
+    }
+    // 실측 5/8 — 단일 toast×3, 액션 배열×2(close→toast)
+  ],
+  children: { accepts: false },
+  dom: { element: "div" },
+  // 실측: 루트가 라이브러리 Card → <div class="wp-card">
+  // 프리셋에 endpoint·templateEndpoint를 넣지 않는다. 이 조합이면 템플릿은 브라우저에서
+  // xlsx로 만들고, 가져오기도 onComplete만 부른다 → 바깥으로 나가는 요청이 0건이다.
+  preset: {
+    component: "ExcelUploadCard",
+    props: {
+      mode: "preview",
+      templateColumns: [
+        { key: "name", header: "\uD488\uBAA9\uBA85", example: "\uB178\uD2B8\uBD81" },
+        { key: "qty", header: "\uC218\uB7C9", example: "3" }
+      ],
+      columns: [
+        { key: "name", header: "\uD488\uBAA9\uBA85", required: true },
+        { key: "qty", header: "\uC218\uB7C9", required: true }
+      ]
+    }
+  },
+  resize: { kind: "none" }
+};
 var AutocompleteFieldMeta = {
   name: "AutocompleteField",
   label: "\uC790\uB3D9\uC644\uC131",
@@ -5369,6 +5480,7 @@ var widgetComponentMeta = {
   ApprovalLineEditor: ApprovalLineEditorMeta,
   ApprovalOverridesEditor: ApprovalOverridesEditorMeta,
   ApprovalStepper: ApprovalStepperMeta,
+  ExcelUploadCard: ExcelUploadCardMeta,
   FileDropzone: FileDropzoneMeta,
   PermissionMatrixEditor: PermissionMatrixEditorMeta,
   RoleMemberPicker: RoleMemberPickerMeta,
@@ -5431,4 +5543,4 @@ function paletteGroups(catalog = allComponentMeta) {
   })).filter((group) => group.items.length > 0);
 }
 
-export { ActionsMeta, AlertMeta, ApprovalLineEditorMeta, ApprovalOverridesEditorMeta, ApprovalStepperMeta, AutocompleteFieldMeta, AvatarMeta, BadgeMeta, BreadcrumbMeta, ButtonMeta, CanMeta, CardMeta, ChartMeta, CheckboxMeta, ColMeta, ColumnBoardMeta, DatePickerMeta, DateRangePickerMeta, DialogMeta, DiffViewMeta, DisclosureMeta, DividerMeta, EmptyStateMeta, EventCalendarMeta, FieldMeta, FileDropzoneMeta, ForEachMeta, FormMeta, FragmentMeta, GridMeta, IconButtonMeta, IconMeta, ImageLightboxMeta, InlineEditMeta, InputMeta, JsonFieldMeta, KeyValueListMeta, LiveClockMeta, MapPreviewMeta, OrgChartBoardMeta, OrgChartMeta, PageHeadMeta, PaginationMeta, PeriodFilterMeta, PermissionMatrixEditorMeta, PrintSheetMeta, ProgressBarMeta, RadioMeta, RankBoardMeta, RecordSheetMeta, RemoteSearchResultsMeta, RoleMemberPickerMeta, RowMeta, SDUI_CATEGORIES, SELF_AXIS_PROPS, SearchResultsMeta, SearchableMultiPickerMeta, SectionMeta, SecureScreenMeta, SegmentedControlMeta, SelectMeta, ShowMeta, SidebarNavMeta, SortHandleMeta, SortableListMeta, SpacerMeta, SpinnerMeta, StackedMeterMeta, StatCardMeta, StripMeta, SummaryTableMeta, SwitchMeta, TableMeta, TabsMeta, TagMeta, TagMultiSelectMeta, TextMeta, TextareaMeta, TimePickerMeta, TimelineMeta, ToastMeta, TooltipMeta, TreePickerMeta, TreeViewMeta, allComponentMeta, builtinComponentMeta, coreComponentMeta, dsComponentMeta, getComponentMeta, paletteGroups, richComponentMeta, slotNamesOf, widgetComponentMeta, withSelfAxis, withSelfAxisAll };
+export { ActionsMeta, AlertMeta, ApprovalLineEditorMeta, ApprovalOverridesEditorMeta, ApprovalStepperMeta, AutocompleteFieldMeta, AvatarMeta, BadgeMeta, BreadcrumbMeta, ButtonMeta, CanMeta, CardMeta, ChartMeta, CheckboxMeta, ColMeta, ColumnBoardMeta, DatePickerMeta, DateRangePickerMeta, DialogMeta, DiffViewMeta, DisclosureMeta, DividerMeta, EmptyStateMeta, EventCalendarMeta, ExcelUploadCardMeta, FieldMeta, FileDropzoneMeta, ForEachMeta, FormMeta, FragmentMeta, GridMeta, IconButtonMeta, IconMeta, ImageLightboxMeta, InlineEditMeta, InputMeta, JsonFieldMeta, KeyValueListMeta, LiveClockMeta, MapPreviewMeta, OrgChartBoardMeta, OrgChartMeta, PageHeadMeta, PaginationMeta, PeriodFilterMeta, PermissionMatrixEditorMeta, PrintSheetMeta, ProgressBarMeta, RadioMeta, RankBoardMeta, RecordSheetMeta, RemoteSearchResultsMeta, RoleMemberPickerMeta, RowMeta, SDUI_CATEGORIES, SELF_AXIS_PROPS, SearchResultsMeta, SearchableMultiPickerMeta, SectionMeta, SecureScreenMeta, SegmentedControlMeta, SelectMeta, ShowMeta, SidebarNavMeta, SortHandleMeta, SortableListMeta, SpacerMeta, SpinnerMeta, StackedMeterMeta, StatCardMeta, StripMeta, SummaryTableMeta, SwitchMeta, TableMeta, TabsMeta, TagMeta, TagMultiSelectMeta, TextMeta, TextareaMeta, TimePickerMeta, TimelineMeta, ToastMeta, TooltipMeta, TreePickerMeta, TreeViewMeta, allComponentMeta, builtinComponentMeta, coreComponentMeta, dsComponentMeta, getComponentMeta, paletteGroups, richComponentMeta, slotNamesOf, widgetComponentMeta, withSelfAxis, withSelfAxisAll };

package/dist/rich/ExcelUploadCard.d.ts

@@ -0,0 +1,37 @@
+import { S as SduiBoxProps } from '../layout-B1QrIBm6.js';
+import React__default from 'react';
+
+interface ExcelTemplateColumn {
+    key: string;
+    header: string;
+    /** 템플릿 2행에 들어갈 예시값 */
+    example?: string;
+}
+interface ExcelPreviewColumn {
+    key: string;
+    /** 엑셀 헤더(한국어 별칭). key와도 매칭된다. */
+    header: string;
+    required?: boolean;
+    /** 허용값 목록 — 있으면 오류 셀을 Select로 수정 */
+    options?: string[];
+}
+interface ExcelUploadCardProps {
+    /** server = 파일을 서버로 바로 업로드, preview = 클라이언트 파싱·검증 후 가져오기 */
+    mode?: 'server' | 'preview';
+    /** server: multipart POST 대상 / preview: 검증된 rows JSON POST 대상 */
+    endpoint?: string;
+    /** 템플릿 다운로드 GET 경로 (templateColumns 없을 때 사용) */
+    templateEndpoint?: string;
+    /** 있으면 클라이언트에서 템플릿 xlsx 생성 — 백엔드 없이 동작 */
+    templateColumns?: ExcelTemplateColumn[];
+    /** preview 모드 파싱·검증 스키마 */
+    columns?: ExcelPreviewColumn[];
+    /** server 응답 요약 타일 라벨 매핑 (응답 키 → 라벨) */
+    summaryLabels?: Record<string, string>;
+    /** server: 응답 JSON / preview: 서버 응답(없으면 유효 행 배열) */
+    onComplete?: (result: unknown) => void;
+}
+/** 바깥에서 온 `style`·`className`을 뿌리에 얹어 내보낸다 — 자기 축(폭·여백)이 닿게 하는 통로. */
+declare const ExcelUploadCard: React__default.FC<ExcelUploadCardProps & SduiBoxProps>;
+
+export { type ExcelPreviewColumn, type ExcelTemplateColumn, ExcelUploadCard, type ExcelUploadCardProps };

package/dist/rich/ExcelUploadCard.js

@@ -0,0 +1,606 @@
+import { loadOptionalModule } from '../chunk-RRMKCZYQ.js';
+import { useSduiAdapter, useSduiSandbox, hostFetchOf, defaultAdapter, hostRawFetchOf } from '../chunk-DKPNFEVU.js';
+import { Select, Input, Card, Button, Spinner, Icon, Alert, StatCard, Badge, Table, EmptyState } from '../chunk-WIDDHR7L.js';
+import { boxed } from '../chunk-SAN4IX6N.js';
+import { useRef, useState, useMemo, useCallback } from 'react';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+var ACCEPT = ".xlsx,.xls";
+function pickCell(raw, column) {
+  const keys = Object.keys(raw);
+  const match = keys.find((key) => key.trim() === column.header) ?? keys.find((key) => key.trim() === column.key);
+  const value = match !== void 0 ? raw[match] : "";
+  return value === null || value === void 0 ? "" : String(value).trim();
+}
+function validateCell(column, value) {
+  if (value === "") return column.required ? "\uD544\uC218 \uC785\uB825\uC785\uB2C8\uB2E4" : null;
+  if (column.options && !column.options.includes(value)) {
+    return `\uD5C8\uC6A9\uAC12\uC774 \uC544\uB2D9\uB2C8\uB2E4 (\uD5C8\uC6A9: ${column.options.join(", ")})`;
+  }
+  return null;
+}
+function formatBytes(bytes) {
+  if (bytes < 1024) return `${bytes}B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+function collectSummary(result, summaryLabels) {
+  const nested = result.summary && typeof result.summary === "object" ? result.summary : void 0;
+  const lookup = (key) => nested?.[key] ?? result[key];
+  if (summaryLabels) {
+    return Object.entries(summaryLabels).flatMap(([key, label]) => {
+      const value = lookup(key);
+      return typeof value === "number" && Number.isFinite(value) ? [{ key, label, value }] : [];
+    });
+  }
+  const source = nested ?? result;
+  return Object.entries(source).flatMap(
+    ([key, value]) => typeof value === "number" && Number.isFinite(value) ? [{ key, label: key, value }] : []
+  );
+}
+function errorMessage(error, fallback) {
+  return error instanceof Error && error.message ? error.message : fallback;
+}
+function ExcelUploadCardImpl({
+  mode = "server",
+  endpoint,
+  templateEndpoint,
+  templateColumns,
+  columns,
+  summaryLabels,
+  onComplete
+}) {
+  const adapter = useSduiAdapter();
+  const sandbox = useSduiSandbox();
+  const api = hostFetchOf(adapter) ?? defaultAdapter.fetch;
+  const rawFetch = hostRawFetchOf(adapter) ?? defaultAdapter.rawFetch;
+  const inputRef = useRef(null);
+  const [inputKey, setInputKey] = useState(0);
+  const [fileName, setFileName] = useState(null);
+  const [notice, setNotice] = useState(null);
+  const [demoMode, setDemoMode] = useState(false);
+  const [downloading, setDownloading] = useState(false);
+  const [file, setFile] = useState(null);
+  const [uploading, setUploading] = useState(false);
+  const [result, setResult] = useState(null);
+  const [rows, setRows] = useState(null);
+  const [parsing, setParsing] = useState(false);
+  const excelRowNums = useRef([]);
+  const [importing, setImporting] = useState(false);
+  const schemaColumns = useMemo(() => columns ?? [], [columns]);
+  const reset = useCallback(() => {
+    setFile(null);
+    setFileName(null);
+    setResult(null);
+    setRows(null);
+    setNotice(null);
+    setInputKey((key) => key + 1);
+  }, []);
+  const hasTemplate = (templateColumns?.length ?? 0) > 0 || Boolean(templateEndpoint);
+  const handleTemplateDownload = useCallback(async () => {
+    setDownloading(true);
+    try {
+      if (templateColumns && templateColumns.length > 0) {
+        const XLSX = await loadOptionalModule(() => import('xlsx'), "xlsx");
+        const headers = templateColumns.map((column) => column.header);
+        const examples = templateColumns.map((column) => column.example ?? "");
+        const sheet = XLSX.utils.aoa_to_sheet([headers, examples]);
+        sheet["!cols"] = templateColumns.map((column) => ({
+          wch: Math.max(column.header.length * 2, (column.example ?? "").length + 2, 12)
+        }));
+        const workbook = XLSX.utils.book_new();
+        XLSX.utils.book_append_sheet(workbook, sheet, "\uC5C5\uB85C\uB4DC\uC591\uC2DD");
+        XLSX.writeFile(workbook, "\uC5D1\uC140_\uC5C5\uB85C\uB4DC_\uD15C\uD50C\uB9BF.xlsx");
+      } else if (templateEndpoint) {
+        const res = await rawFetch(templateEndpoint, { method: "GET" });
+        if (res.status === 503) {
+          setDemoMode(true);
+          setNotice({
+            tone: "warning",
+            text: "\uBC31\uC5D4\uB4DC \uBBF8\uC5F0\uB3D9 \uC0C1\uD0DC\uB77C \uD15C\uD50C\uB9BF\uC744 \uBC1B\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uB370\uBAA8 \uBAA8\uB4DC)"
+          });
+          return;
+        }
+        if (!res.ok) throw new Error(`\uD15C\uD50C\uB9BF \uB2E4\uC6B4\uB85C\uB4DC\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4 (${res.status})`);
+        const blob = await res.blob();
+        const url = URL.createObjectURL(blob);
+        const link = document.createElement("a");
+        link.href = url;
+        link.download = "\uC5D1\uC140_\uC5C5\uB85C\uB4DC_\uD15C\uD50C\uB9BF.xlsx";
+        document.body.appendChild(link);
+        link.click();
+        link.remove();
+        URL.revokeObjectURL(url);
+      }
+    } catch (error) {
+      setNotice({ tone: "danger", text: errorMessage(error, "\uD15C\uD50C\uB9BF \uB2E4\uC6B4\uB85C\uB4DC\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4") });
+    } finally {
+      setDownloading(false);
+    }
+  }, [templateColumns, templateEndpoint]);
+  const handleServerUpload = useCallback(async () => {
+    if (!file || !endpoint) return;
+    setUploading(true);
+    setNotice(null);
+    setResult(null);
+    try {
+      const formData = new FormData();
+      formData.append("file", file, file.name);
+      if (sandbox) {
+        setNotice({ tone: "warning", text: "\uBBF8\uB9AC\uBCF4\uAE30\uC5D0\uC11C\uB294 \uC5C5\uB85C\uB4DC\uAC00 \uB098\uAC00\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4" });
+        return;
+      }
+      const res = await rawFetch(endpoint, { method: "POST", body: formData });
+      if (res.status === 503) {
+        setDemoMode(true);
+        return;
+      }
+      const json = await res.json().catch(() => null);
+      if (!res.ok) {
+        if (json) setResult(json);
+        setNotice({
+          tone: "danger",
+          text: typeof json?.message === "string" && json.message || typeof json?.error === "string" && json.error || `\uC5C5\uB85C\uB4DC\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4 (${res.status})`
+        });
+        return;
+      }
+      setResult(json ?? {});
+      setNotice({ tone: "success", text: "\uC5C5\uB85C\uB4DC\uAC00 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4" });
+      setFile(null);
+      setFileName(null);
+      setInputKey((key) => key + 1);
+      onComplete?.(json ?? {});
+    } catch (error) {
+      setNotice({ tone: "danger", text: errorMessage(error, "\uC5C5\uB85C\uB4DC \uC911 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4") });
+    } finally {
+      setUploading(false);
+    }
+  }, [endpoint, file, onComplete]);
+  const validateRow = useCallback(
+    (row) => {
+      const errors = {};
+      for (const column of schemaColumns) {
+        const message = validateCell(column, row.cells[column.key] ?? "");
+        if (message) errors[column.key] = message;
+      }
+      return { ...row, errors };
+    },
+    [schemaColumns]
+  );
+  const parsePreviewFile = useCallback(
+    async (selected) => {
+      setParsing(true);
+      setNotice(null);
+      setRows(null);
+      try {
+        const buffer = await selected.arrayBuffer();
+        const XLSX = await loadOptionalModule(() => import('xlsx'), "xlsx");
+        const workbook = XLSX.read(buffer, { type: "array" });
+        const sheet = workbook.Sheets[workbook.SheetNames[0]];
+        if (!sheet) throw new Error("\uC5D1\uC140 \uD30C\uC77C\uC5D0\uC11C \uC2DC\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4");
+        const raw = XLSX.utils.sheet_to_json(sheet, {
+          defval: "",
+          raw: false
+        });
+        if (raw.length === 0) {
+          setNotice({ tone: "warning", text: "\uB370\uC774\uD130 \uD589\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uD15C\uD50C\uB9BF \uC591\uC2DD\uC744 \uD655\uC778\uD558\uC138\uC694" });
+          return;
+        }
+        excelRowNums.current = raw.map((rawRow, index) => {
+          const rowNum = rawRow.__rowNum__;
+          return typeof rowNum === "number" ? rowNum + 1 : index + 2;
+        });
+        setRows(
+          raw.map((rawRow, index) => {
+            const cells = {};
+            for (const column of schemaColumns) cells[column.key] = pickCell(rawRow, column);
+            return validateRow({ id: index, cells });
+          })
+        );
+        setFileName(selected.name);
+      } catch (error) {
+        setNotice({ tone: "danger", text: errorMessage(error, "\uC5D1\uC140 \uD30C\uC77C\uC744 \uC77D\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4") });
+      } finally {
+        setParsing(false);
+      }
+    },
+    [schemaColumns, validateRow]
+  );
+  const commitCell = useCallback(
+    (rowId, key, value) => {
+      setRows(
+        (current) => current ? current.map(
+          (row) => row.id === rowId ? validateRow({ id: row.id, cells: { ...row.cells, [key]: value.trim() } }) : row
+        ) : current
+      );
+    },
+    [validateRow]
+  );
+  const validRows = useMemo(
+    () => (rows ?? []).filter((row) => Object.keys(row.errors).length === 0),
+    [rows]
+  );
+  const invalidCount = (rows?.length ?? 0) - validRows.length;
+  const handleImport = useCallback(async () => {
+    if (validRows.length === 0) return;
+    const payload = validRows.map((row) => ({ ...row.cells }));
+    setImporting(true);
+    setNotice(null);
+    try {
+      if (endpoint) {
+        if (sandbox) {
+          setNotice({ tone: "warning", text: "\uBBF8\uB9AC\uBCF4\uAE30\uC5D0\uC11C\uB294 \uB4F1\uB85D\uC774 \uB098\uAC00\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4" });
+          return;
+        }
+        const response = await api(endpoint, { method: "POST", body: { rows: payload } });
+        setNotice({ tone: "success", text: `${payload.length}\uAC74\uC744 \uAC00\uC838\uC654\uC2B5\uB2C8\uB2E4` });
+        onComplete?.(response ?? payload);
+      } else {
+        setNotice({ tone: "success", text: `${payload.length}\uAC74\uC744 \uAC00\uC838\uC654\uC2B5\uB2C8\uB2E4` });
+        onComplete?.(payload);
+      }
+      setRows(null);
+      setFileName(null);
+      setInputKey((key) => key + 1);
+    } catch (error) {
+      if (error?.status === 503) {
+        setDemoMode(true);
+        setNotice({
+          tone: "warning",
+          text: `\uBC31\uC5D4\uB4DC \uBBF8\uC5F0\uB3D9 \u2014 \uAC80\uC99D\uB41C ${payload.length}\uAC74\uC744 \uB85C\uCEEC \uACB0\uACFC\uB85C \uC804\uB2EC\uD588\uC2B5\uB2C8\uB2E4 (\uB370\uBAA8 \uBAA8\uB4DC)`
+        });
+        onComplete?.(payload);
+        setRows(null);
+        setFileName(null);
+        setInputKey((key) => key + 1);
+      } else {
+        setNotice({ tone: "danger", text: errorMessage(error, "\uAC00\uC838\uC624\uAE30\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4") });
+      }
+    } finally {
+      setImporting(false);
+    }
+  }, [endpoint, onComplete, validRows]);
+  const previewTableColumns = useMemo(() => {
+    const base = [
+      {
+        key: "_row",
+        header: "#",
+        width: "48px",
+        align: "right",
+        mono: true,
+        // 엑셀 행 번호(헤더 1행 + 1-기반)
+        render: (row) => excelRowNums.current[row.id] ?? row.id + 2
+      },
+      {
+        key: "_status",
+        header: "\uC0C1\uD0DC",
+        width: "64px",
+        render: (row) => Object.keys(row.errors).length === 0 ? /* @__PURE__ */ jsx(Badge, { tone: "success", children: "\uC815\uC0C1" }) : /* @__PURE__ */ jsx(Badge, { tone: "danger", children: "\uC624\uB958" })
+      }
+    ];
+    const dataColumns = schemaColumns.map((column) => ({
+      key: column.key,
+      header: column.required ? `${column.header} *` : column.header,
+      render: (row) => {
+        const value = row.cells[column.key] ?? "";
+        const error = row.errors[column.key];
+        if (!error) {
+          return value !== "" ? value : /* @__PURE__ */ jsx("span", { style: { color: "var(--wp-text-muted)" }, children: "\u2014" });
+        }
+        return /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "wp-col",
+            style: {
+              gap: "var(--wp-space-half)",
+              padding: "var(--wp-space-1)",
+              background: "var(--wp-status-danger-bg)",
+              borderRadius: "var(--wp-radius-sm)",
+              minWidth: 140
+            },
+            children: [
+              column.options ? /* @__PURE__ */ jsx(
+                Select,
+                {
+                  size: "sm",
+                  invalid: true,
+                  value: "",
+                  placeholder: value !== "" ? `${value} (\uD5C8\uC6A9\uAC12 \uC544\uB2D8)` : "\uAC12 \uC120\uD0DD",
+                  "aria-label": `${column.header} \uC218\uC815`,
+                  options: column.options.map((option) => ({ value: option, label: option })),
+                  onChange: (event) => {
+                    if (event.target.value) commitCell(row.id, column.key, event.target.value);
+                  }
+                }
+              ) : /* @__PURE__ */ jsx(
+                Input,
+                {
+                  size: "sm",
+                  invalid: true,
+                  defaultValue: value,
+                  "aria-label": `${column.header} \uC218\uC815`,
+                  placeholder: column.header,
+                  onBlur: (event) => commitCell(row.id, column.key, event.target.value),
+                  onKeyDown: (event) => {
+                    if (event.key === "Enter") {
+                      commitCell(row.id, column.key, event.currentTarget.value);
+                    }
+                  }
+                }
+              ),
+              /* @__PURE__ */ jsx("span", { className: "wp-caption", style: { color: "var(--wp-text-danger)" }, children: error })
+            ]
+          }
+        );
+      }
+    }));
+    return [...base, ...dataColumns];
+  }, [commitCell, schemaColumns]);
+  const handleFileChange = (event) => {
+    const selected = event.target.files?.[0];
+    if (!selected) return;
+    if (mode === "preview") {
+      void parsePreviewFile(selected);
+    } else {
+      setFile(selected);
+      setFileName(selected.name);
+      setResult(null);
+      setNotice(null);
+    }
+  };
+  const previewSchemaMissing = mode === "preview" && schemaColumns.length === 0;
+  const pickerDisabled = uploading || parsing || importing || previewSchemaMissing;
+  const pickerReason = previewSchemaMissing ? "columns \uC2A4\uD0A4\uB9C8\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC544 \uBBF8\uB9AC\uBCF4\uAE30\uB97C \uC0AC\uC6A9\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4" : void 0;
+  const uploadDisabledReason = !endpoint ? "\uC5C5\uB85C\uB4DC endpoint\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4" : demoMode ? "\uBC31\uC5D4\uB4DC \uBBF8\uC5F0\uB3D9 \uC0C1\uD0DC\uC785\uB2C8\uB2E4 (\uB370\uBAA8 \uBAA8\uB4DC)" : !file ? "\uC5D1\uC140 \uD30C\uC77C\uC744 \uBA3C\uC800 \uC120\uD0DD\uD558\uC138\uC694" : void 0;
+  const importDisabledReason = validRows.length === 0 ? "\uAC00\uC838\uC62C \uC218 \uC788\uB294 \uC815\uC0C1 \uD589\uC774 \uC5C6\uC2B5\uB2C8\uB2E4" : void 0;
+  const summaryEntries = result ? collectSummary(result, summaryLabels) : [];
+  const rowErrors = Array.isArray(result?.errors) ? result.errors : [];
+  const hasReset = fileName !== null || file !== null || result !== null || rows !== null || notice !== null;
+  return /* @__PURE__ */ jsx(
+    Card,
+    {
+      title: "\uC5D1\uC140 \uC77C\uAD04 \uC5C5\uB85C\uB4DC",
+      subtitle: mode === "preview" ? "\uC5D1\uC140 \uD30C\uC77C\uC744 \uBD88\uB7EC\uC640 \uAC80\uC99D\uD55C \uB4A4 \uC815\uC0C1 \uD589\uB9CC \uAC00\uC838\uC635\uB2C8\uB2E4" : "\uC5D1\uC140 \uD30C\uC77C\uC744 \uC5C5\uB85C\uB4DC\uD558\uBA74 \uC11C\uBC84\uC5D0\uC11C \uC77C\uAD04 \uCC98\uB9AC\uD569\uB2C8\uB2E4",
+      actions: hasTemplate ? /* @__PURE__ */ jsx(
+        Button,
+        {
+          variant: "secondary",
+          size: "sm",
+          icon: "download",
+          loading: downloading,
+          onClick: () => void handleTemplateDownload(),
+          children: "\uD15C\uD50C\uB9BF \uB2E4\uC6B4\uB85C\uB4DC"
+        }
+      ) : void 0,
+      children: /* @__PURE__ */ jsxs("div", { className: "wp-col", style: { gap: "var(--wp-space-3)" }, children: [
+        /* @__PURE__ */ jsx(
+          "input",
+          {
+            ref: inputRef,
+            type: "file",
+            accept: ACCEPT,
+            hidden: true,
+            onChange: handleFileChange
+          },
+          inputKey
+        ),
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            style: {
+              display: "flex",
+              alignItems: "center",
+              flexWrap: "wrap",
+              gap: "var(--wp-space-2)"
+            },
+            children: [
+              /* @__PURE__ */ jsx(
+                Button,
+                {
+                  variant: "secondary",
+                  icon: "upload",
+                  disabled: pickerDisabled,
+                  title: pickerReason,
+                  onClick: () => inputRef.current?.click(),
+                  children: "\uD30C\uC77C \uC120\uD0DD"
+                }
+              ),
+              parsing ? /* @__PURE__ */ jsx(Spinner, { size: "sm", label: "\uC5D1\uC140 \uD30C\uC2F1 \uC911\u2026" }) : fileName ? /* @__PURE__ */ jsxs(
+                "span",
+                {
+                  className: "wp-body-sm",
+                  style: {
+                    display: "inline-flex",
+                    alignItems: "center",
+                    gap: "var(--wp-space-1)",
+                    color: "var(--wp-text-default)"
+                  },
+                  children: [
+                    /* @__PURE__ */ jsx(Icon, { name: "file-text", size: 16, style: { color: "var(--wp-text-muted)" } }),
+                    fileName,
+                    file ? /* @__PURE__ */ jsxs("span", { className: "wp-caption", style: { color: "var(--wp-text-muted)" }, children: [
+                      "(",
+                      formatBytes(file.size),
+                      ")"
+                    ] }) : null
+                  ]
+                }
+              ) : /* @__PURE__ */ jsx("span", { className: "wp-caption", children: ".xlsx / .xls \uD30C\uC77C\uC744 \uC120\uD0DD\uD558\uC138\uC694" }),
+              /* @__PURE__ */ jsxs("div", { style: { marginLeft: "auto", display: "flex", gap: "var(--wp-space-2)" }, children: [
+                /* @__PURE__ */ jsx(
+                  Button,
+                  {
+                    variant: "ghost",
+                    icon: "rotate-ccw",
+                    disabled: !hasReset || uploading || importing || parsing,
+                    title: !hasReset ? "\uCD08\uAE30\uD654\uD560 \uB0B4\uC6A9\uC774 \uC5C6\uC2B5\uB2C8\uB2E4" : void 0,
+                    onClick: reset,
+                    children: "\uCD08\uAE30\uD654"
+                  }
+                ),
+                mode === "server" ? /* @__PURE__ */ jsx(
+                  Button,
+                  {
+                    variant: "primary",
+                    icon: "cloud-upload",
+                    loading: uploading,
+                    disabled: uploadDisabledReason !== void 0,
+                    title: uploadDisabledReason,
+                    onClick: () => void handleServerUpload(),
+                    children: "\uC5C5\uB85C\uB4DC"
+                  }
+                ) : rows !== null ? /* @__PURE__ */ jsxs(
+                  Button,
+                  {
+                    variant: "primary",
+                    icon: "check",
+                    loading: importing,
+                    disabled: importDisabledReason !== void 0,
+                    title: importDisabledReason,
+                    onClick: () => void handleImport(),
+                    children: [
+                      validRows.length,
+                      "\uAC74 \uAC00\uC838\uC624\uAE30",
+                      invalidCount > 0 ? ` (\uC624\uB958 ${invalidCount}\uAC74 \uC81C\uC678)` : ""
+                    ]
+                  }
+                ) : null
+              ] })
+            ]
+          }
+        ),
+        demoMode ? /* @__PURE__ */ jsx(Alert, { tone: "warning", title: "\uBC31\uC5D4\uB4DC \uBBF8\uC5F0\uB3D9 (\uB370\uBAA8 \uBAA8\uB4DC)", children: "\uC11C\uBC84 \uCC98\uB9AC\uAC00 \uBD88\uAC00\uB2A5\uD55C \uC0C1\uD0DC\uC785\uB2C8\uB2E4. \uC5F0\uB3D9 \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694." }) : null,
+        notice ? /* @__PURE__ */ jsx(Alert, { tone: notice.tone, children: notice.text }) : null,
+        mode === "server" && summaryEntries.length > 0 ? /* @__PURE__ */ jsx(
+          "div",
+          {
+            style: {
+              display: "grid",
+              gridTemplateColumns: "repeat(auto-fill, minmax(150px, 1fr))",
+              gap: "var(--wp-space-2)"
+            },
+            children: summaryEntries.map((entry) => /* @__PURE__ */ jsx(
+              StatCard,
+              {
+                size: "sm",
+                label: entry.label,
+                value: entry.value.toLocaleString("ko-KR")
+              },
+              entry.key
+            ))
+          }
+        ) : null,
+        mode === "server" && rowErrors.length > 0 ? /* @__PURE__ */ jsxs("div", { className: "wp-col", style: { gap: "var(--wp-space-1)" }, children: [
+          /* @__PURE__ */ jsxs(
+            "span",
+            {
+              className: "wp-body-sm",
+              style: { fontWeight: "var(--wp-weight-semibold)", color: "var(--wp-text-strong)" },
+              children: [
+                "\uC624\uB958 \uBAA9\uB85D (",
+                rowErrors.length,
+                "\uAC74)"
+              ]
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            "div",
+            {
+              style: {
+                maxHeight: 240,
+                overflowY: "auto",
+                border: "var(--wp-border-w) solid var(--wp-border-subtle)",
+                borderRadius: "var(--wp-radius-md)",
+                padding: "var(--wp-space-2)"
+              },
+              children: rowErrors.map((rowError, index) => /* @__PURE__ */ jsxs(
+                "div",
+                {
+                  className: "wp-body-sm",
+                  style: {
+                    display: "flex",
+                    gap: "var(--wp-space-2)",
+                    padding: "var(--wp-space-1) 0"
+                  },
+                  children: [
+                    /* @__PURE__ */ jsxs(
+                      "span",
+                      {
+                        style: {
+                          color: "var(--wp-text-danger)",
+                          fontWeight: "var(--wp-weight-medium)",
+                          flexShrink: 0
+                        },
+                        children: [
+                          rowError.row_number ?? rowError.rowNumber,
+                          "\uD589"
+                        ]
+                      }
+                    ),
+                    /* @__PURE__ */ jsx("span", { style: { color: "var(--wp-text-default)" }, children: rowError.message })
+                  ]
+                },
+                `${rowError.row_number ?? rowError.rowNumber}-${index}`
+              ))
+            }
+          )
+        ] }) : null,
+        mode === "preview" && rows !== null ? /* @__PURE__ */ jsxs("div", { className: "wp-col", style: { gap: "var(--wp-space-2)" }, children: [
+          /* @__PURE__ */ jsxs(
+            "div",
+            {
+              style: {
+                display: "flex",
+                alignItems: "center",
+                gap: "var(--wp-space-2)",
+                flexWrap: "wrap"
+              },
+              children: [
+                /* @__PURE__ */ jsxs(Badge, { tone: "neutral", children: [
+                  "\uCD1D ",
+                  rows.length,
+                  "\uAC74"
+                ] }),
+                /* @__PURE__ */ jsxs(Badge, { tone: "success", dot: true, children: [
+                  "\uC815\uC0C1 ",
+                  validRows.length,
+                  "\uAC74"
+                ] }),
+                invalidCount > 0 ? /* @__PURE__ */ jsxs(Badge, { tone: "danger", dot: true, children: [
+                  "\uC624\uB958 ",
+                  invalidCount,
+                  "\uAC74"
+                ] }) : null,
+                invalidCount > 0 ? /* @__PURE__ */ jsx("span", { className: "wp-caption", children: "\uC624\uB958 \uC140\uC744 \uD45C\uC5D0\uC11C \uBC14\uB85C \uC218\uC815\uD558\uBA74 \uC7AC\uAC80\uC99D\uB429\uB2C8\uB2E4" }) : null
+              ]
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            "div",
+            {
+              style: {
+                maxHeight: 360,
+                overflow: "auto",
+                border: "var(--wp-border-w) solid var(--wp-border-subtle)",
+                borderRadius: "var(--wp-radius-md)"
+              },
+              children: /* @__PURE__ */ jsx(
+                Table,
+                {
+                  columns: previewTableColumns,
+                  rows,
+                  dense: true,
+                  sticky: true,
+                  empty: /* @__PURE__ */ jsx(EmptyState, { icon: "table", title: "\uD45C\uC2DC\uD560 \uD589\uC774 \uC5C6\uC2B5\uB2C8\uB2E4", tight: true, children: "\uC5D1\uC140 \uD30C\uC77C\uC5D0 \uB370\uC774\uD130 \uD589\uC774 \uC5C6\uC2B5\uB2C8\uB2E4." })
+                }
+              )
+            }
+          )
+        ] }) : null
+      ] })
+    }
+  );
+}
+var ExcelUploadCard = boxed(ExcelUploadCardImpl, "ExcelUploadCard");
+
+export { ExcelUploadCard };

package/dist/rich.js

@@ -1,5 +1,5 @@
-import { useOptionalModule, DependencyPlaceholder } from './chunk-WXOU7QTN.js';
-export { TimePicker } from './chunk-WXOU7QTN.js';
+export { TimePicker } from './chunk-SNRKPEWT.js';
+import { useOptionalModule, DependencyPlaceholder } from './chunk-RRMKCZYQ.js';
 import { HoistedStyle } from './chunk-EFMKWPZ3.js';
 export { DatePicker, DateRangePicker } from './chunk-EFMKWPZ3.js';
 import './chunk-XQPTSEJC.js';

package/dist/widgets/index.js

@@ -1,7 +1,11 @@
+import { Timeline } from '../chunk-EFYEOT47.js';
+export { Timeline } from '../chunk-EFYEOT47.js';
 import { TreePicker } from '../chunk-U3HYQCFA.js';
 export { TreePicker } from '../chunk-U3HYQCFA.js';
 import { TreeView } from '../chunk-X5R2HHEN.js';
 export { TreeView, buildTreeNodes } from '../chunk-X5R2HHEN.js';
+import { RecordSheet } from '../chunk-K3JBSWFI.js';
+export { RecordSheet } from '../chunk-K3JBSWFI.js';
 import { RoleMemberPicker } from '../chunk-WXZDYDXG.js';
 export { RoleMemberPicker } from '../chunk-WXZDYDXG.js';
 import { SearchableMultiPicker } from '../chunk-C53NGSA3.js';
@@ -14,8 +18,8 @@ import { Strip } from '../chunk-ZH5MLOZS.js';
 export { Strip } from '../chunk-ZH5MLOZS.js';
 import { SummaryTable } from '../chunk-O4U7Y3XL.js';
 export { SummaryTable } from '../chunk-O4U7Y3XL.js';
-import { Timeline } from '../chunk-EFYEOT47.js';
-export { Timeline } from '../chunk-EFYEOT47.js';
+import { JsonField } from '../chunk-JVBZRDC2.js';
+export { JsonField } from '../chunk-JVBZRDC2.js';
 import { LiveClock } from '../chunk-Z3WGIFJP.js';
 export { LiveClock } from '../chunk-Z3WGIFJP.js';
 import { OrgChart } from '../chunk-QWJ3OBBL.js';
@@ -30,8 +34,7 @@ import { PrintSheet } from '../chunk-MYJ2KEIP.js';
 export { PrintSheet } from '../chunk-MYJ2KEIP.js';
 import { RankBoard } from '../chunk-U6H7YN4I.js';
 export { RankBoard } from '../chunk-U6H7YN4I.js';
-import { RecordSheet } from '../chunk-K3JBSWFI.js';
-export { RecordSheet } from '../chunk-K3JBSWFI.js';
+export { AutocompleteField, toAutocompleteOptions } from '../chunk-CVCP52OD.js';
 import { ColumnBoard } from '../chunk-C4JRSZGS.js';
 export { ColumnBoard } from '../chunk-C4JRSZGS.js';
 import { DiffView } from '../chunk-LDJ2CFFH.js';
@@ -45,8 +48,6 @@ import { ImageLightbox } from '../chunk-XPBZMECW.js';
 export { ImageLightbox } from '../chunk-XPBZMECW.js';
 import { InlineEdit } from '../chunk-KT3ZVBLN.js';
 export { InlineEdit } from '../chunk-KT3ZVBLN.js';
-import { JsonField } from '../chunk-JVBZRDC2.js';
-export { JsonField } from '../chunk-JVBZRDC2.js';
 import '../chunk-QU7YVMFA.js';
 import '../chunk-THEP3VWY.js';
 import { ApprovalOverridesEditor } from '../chunk-OR27SRKL.js';
@@ -55,13 +56,12 @@ import { TagMultiSelect } from '../chunk-QDEZXA34.js';
 export { TagMultiSelect } from '../chunk-QDEZXA34.js';
 import { ApprovalLineEditor } from '../chunk-S4LOH2TU.js';
 export { ApprovalLineEditor } from '../chunk-S4LOH2TU.js';
-import { ApprovalStepper } from '../chunk-ZTQEP3TR.js';
-export { ApprovalStepper } from '../chunk-ZTQEP3TR.js';
-export { AutocompleteField, toAutocompleteOptions } from '../chunk-CVCP52OD.js';
 import '../chunk-BD75U73S.js';
 import '../chunk-EFMKWPZ3.js';
 import '../chunk-XQPTSEJC.js';
 import '../chunk-DKPNFEVU.js';
+import { ApprovalStepper } from '../chunk-ZTQEP3TR.js';
+export { ApprovalStepper } from '../chunk-ZTQEP3TR.js';
 import '../chunk-WIDDHR7L.js';
 import '../chunk-SAN4IX6N.js';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipco/sdui",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "WIPCO 서버 주도 UI(SDUI) 렌더러 — JSON 페이지 스펙을 React 컴포넌트로 렌더링",
   "keywords": [
     "sdui",
@@ -32,6 +32,10 @@
       "types": "./dist/rich.d.ts",
       "default": "./dist/rich.js"
     },
+    "./rich/ExcelUploadCard": {
+      "types": "./dist/rich/ExcelUploadCard.d.ts",
+      "default": "./dist/rich/ExcelUploadCard.js"
+    },
     "./widgets": {
       "types": "./dist/widgets/index.d.ts",
       "default": "./dist/widgets/index.js"