@wipco/sdui 0.13.1 → 0.14.1

package/dist/{chunk-WJEGCCPY.js → chunk-4NPTFNAL.js}

@@ -1,4 +1,4 @@
-import { SegmentedControl, Select, Input } from './chunk-B5JTXYDB.js';
+import { SegmentedControl, Select, Input } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { useState, useMemo } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/{chunk-4CZJF5PR.js → chunk-5C4SIRSW.js}

@@ -1,4 +1,4 @@
-import { Icon } from './chunk-B5JTXYDB.js';
+import { Icon } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { useRef, useState, useEffect } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/{chunk-JWYBFODH.js → chunk-5YVXVGQ2.js}

@@ -1,4 +1,4 @@
-import { Button } from './chunk-B5JTXYDB.js';
+import { Button } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { useEffect } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/{chunk-PBGYAVQZ.js → chunk-6NAJ2D4A.js}

@@ -1,5 +1,5 @@
-import { includesLooseSearch } from './chunk-QIDMPWZH.js';
-import { Icon, Button, Input, Spinner } from './chunk-B5JTXYDB.js';
+import { includesLooseSearch } from './chunk-FC2F37QH.js';
+import { Icon, Button, Input, Spinner } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { useId, useRef, useState, useEffect, useMemo } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/{chunk-7AHNAX6T.js → chunk-BOSSWJTN.js}

@@ -1,4 +1,4 @@
-import { IconButton, Input } from './chunk-B5JTXYDB.js';
+import { IconButton, Input } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { useState, useRef, useEffect, useCallback } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/{chunk-X3DGYP4W.js → chunk-BS4LGGQV.js}

@@ -1,6 +1,7 @@
-import { Input, IconButton, EmptyState, Icon, Badge } from './chunk-B5JTXYDB.js';
+import { buildCascadingTree } from './chunk-FC2F37QH.js';
+import { Input, IconButton, EmptyState, Icon, Badge } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
-import React, { useState, useMemo } from 'react';
+import React, { useMemo, useState, useRef, useEffect } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
 var INDENT = 24;
@@ -12,6 +13,20 @@ var TREE_CSS = `
 .erp-treeview__row[aria-current='true'],
 .erp-treeview__row[aria-current='true']:hover{background:var(--wp-surface-selected);}
 `;
+function toTreeNodes(options) {
+  return options.map((option) => ({
+    id: option.value,
+    label: option.label,
+    ...option.children ? { children: toTreeNodes(option.children) } : null
+  }));
+}
+function buildTreeNodes(rows, tree) {
+  return toTreeNodes(buildCascadingTree(rows, tree));
+}
+function resolveTreeNodes(nodes, rows, tree) {
+  if (Array.isArray(rows) && rows.length > 0 && tree) return buildTreeNodes(rows, tree);
+  return nodes ?? [];
+}
 function pruneExcluded(nodes, excluded) {
   if (excluded.size === 0) return nodes;
   const out = [];
@@ -59,6 +74,8 @@ function toggled(prev, id) {
 }
 function TreeViewImpl({
   nodes,
+  rows,
+  tree,
   selectedId,
   onSelect,
   searchable = false,
@@ -66,18 +83,25 @@ function TreeViewImpl({
   excludeIds,
   maxHeight
 }) {
-  const [expanded, setExpanded] = useState(() => collectExpandedIds(nodes, defaultExpandedDepth));
+  const sourceNodes = useMemo(() => resolveTreeNodes(nodes, rows, tree), [nodes, rows, tree]);
+  const [expanded, setExpanded] = useState(() => collectExpandedIds(sourceNodes, defaultExpandedDepth));
   const [searchCollapsed, setSearchCollapsed] = useState(() => /* @__PURE__ */ new Set());
   const [query, setQuery] = useState("");
   const [innerSelected, setInnerSelected] = useState(null);
+  const hadRows = useRef(Array.isArray(rows) && rows.length > 0);
+  useEffect(() => {
+    const hasRows = Array.isArray(rows) && rows.length > 0;
+    if (hasRows && !hadRows.current) setExpanded(collectExpandedIds(sourceNodes, defaultExpandedDepth));
+    hadRows.current = hasRows;
+  }, [rows, sourceNodes, defaultExpandedDepth]);
   const isControlled = selectedId !== void 0;
   const currentSelected = isControlled ? selectedId : innerSelected;
   const trimmedQuery = query.trim().toLowerCase();
   const searching = trimmedQuery.length > 0;
   const visibleNodes = useMemo(() => {
-    const pruned = pruneExcluded(nodes, new Set(excludeIds ?? []));
+    const pruned = pruneExcluded(sourceNodes, new Set(excludeIds ?? []));
     return searching ? filterTree(pruned, trimmedQuery) : pruned;
-  }, [nodes, excludeIds, searching, trimmedQuery]);
+  }, [sourceNodes, excludeIds, searching, trimmedQuery]);
   const isOpen = (id) => searching ? !searchCollapsed.has(id) : expanded.has(id);
   const toggleNode = (id) => {
     if (searching) setSearchCollapsed((prev) => toggled(prev, id));
@@ -259,4 +283,4 @@ function TreeViewImpl({
 }
 var TreeView = boxed(TreeViewImpl, "TreeView");
 
-export { TreeView };
+export { TreeView, buildTreeNodes, pruneExcluded, resolveTreeNodes };

package/dist/{chunk-WMPSOKNI.js → chunk-CXZYC7IN.js}

@@ -1,4 +1,4 @@
-import { SegmentedControl, IconButton, Button, Tag, EmptyState, Icon, Badge } from './chunk-B5JTXYDB.js';
+import { SegmentedControl, IconButton, Button, Tag, EmptyState, Icon, Badge } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { useState, useMemo } from 'react';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';

package/dist/{chunk-BT4HC3WR.js → chunk-F2MKI3W5.js}

@@ -1,4 +1,4 @@
-import { IconButton, Badge } from './chunk-B5JTXYDB.js';
+import { IconButton, Badge } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { useRef, useState, useMemo, useCallback, useEffect } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/{chunk-QIDMPWZH.js → chunk-FC2F37QH.js}

@@ -1,4 +1,4 @@
-import { Input, Button, IconButton, Tag, Field, Checkbox } from './chunk-B5JTXYDB.js';
+import { Input, Button, IconButton, Tag, Field, Checkbox } from './chunk-LMHIRQZ6.js';
 import { useRef, useEffect, useState, useMemo } from 'react';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 
@@ -623,4 +623,4 @@ function CascadingLevelSelect({
   );
 }
 
-export { Popover, SearchToolbar, cascadingValuePaths, cleanSearchValues, includesLooseSearch, joinMultiValue, normalizeSearchFields, normalizeSearchText, searchFieldKeys, searchValuesFromParams, splitMultiValue };
+export { Popover, SearchToolbar, buildCascadingTree, cascadingValuePaths, cleanSearchValues, includesLooseSearch, joinMultiValue, normalizeSearchFields, normalizeSearchText, searchFieldKeys, searchValuesFromParams, splitMultiValue };

package/dist/{chunk-VK6KWB65.js → chunk-G4QIJHEP.js}

@@ -1,4 +1,4 @@
-import { Badge, Checkbox, IconButton, Icon } from './chunk-B5JTXYDB.js';
+import { Badge, Checkbox, IconButton, Icon } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { useState, useEffect } from 'react';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';

package/dist/{chunk-5A7BWIGN.js → chunk-HINKJD6C.js}

@@ -1,4 +1,4 @@
-import { Icon } from './chunk-B5JTXYDB.js';
+import { Icon } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { createContext, useState, useRef, useMemo, useCallback, useEffect, useLayoutEffect, useContext } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/{chunk-VV73LOAE.js → chunk-JND5NXUT.js}

@@ -1,7 +1,7 @@
-import { TreeView } from './chunk-X3DGYP4W.js';
-import { Field, Dialog, Icon, Button, Input } from './chunk-B5JTXYDB.js';
+import { resolveTreeNodes, TreeView } from './chunk-BS4LGGQV.js';
+import { Field, Dialog, Icon, Button, Input } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
-import { useState, useEffect } from 'react';
+import { useState, useMemo, useEffect } from 'react';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 
 var PICKER_CSS = `
@@ -23,6 +23,8 @@ function findNode(nodes, id) {
 }
 function TreePickerImpl({
   nodes,
+  rows,
+  tree,
   value,
   valueLabel,
   onChange,
@@ -35,9 +37,10 @@ function TreePickerImpl({
   const [open, setOpen] = useState(false);
   const [pendingId, setPendingId] = useState(null);
   const [innerValue, setInnerValue] = useState(null);
+  const sourceNodes = useMemo(() => resolveTreeNodes(nodes, rows, tree), [nodes, rows, tree]);
   const isControlled = value !== void 0;
   const current = isControlled ? value : innerValue;
-  const currentNode = current != null ? findNode(nodes, current) : void 0;
+  const currentNode = current != null ? findNode(sourceNodes, current) : void 0;
   const displayLabel = current == null ? "" : currentNode?.label ?? valueLabel ?? current;
   const openDialog = () => {
     if (disabled) return;
@@ -46,7 +49,7 @@ function TreePickerImpl({
   };
   const closeDialog = () => setOpen(false);
   const commit = () => {
-    const node = pendingId != null ? findNode(nodes, pendingId) : void 0;
+    const node = pendingId != null ? findNode(sourceNodes, pendingId) : void 0;
     if (!isControlled) setInnerValue(pendingId);
     onChange?.(pendingId, node);
     setOpen(false);
@@ -175,7 +178,7 @@ function TreePickerImpl({
               /* @__PURE__ */ jsx(
                 TreeView,
                 {
-                  nodes,
+                  nodes: sourceNodes,
                   selectedId: pendingId,
                   onSelect: (id) => setPendingId(id),
                   searchable: true,

package/dist/{chunk-TMAVD3WL.js → chunk-K55ODWRY.js}

@@ -1,16 +1,29 @@
-import { Badge, Tag } from './chunk-B5JTXYDB.js';
+import { Badge, Tag } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
-import { useState, useMemo } from 'react';
+import { useMemo, useState } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
+function foldOptions(options, valueKey, labelKey) {
+  if (!Array.isArray(options)) return [];
+  return options.flatMap((raw) => {
+    if (raw === null || typeof raw !== "object") return [];
+    const row = raw;
+    const value = (valueKey ? row[valueKey] : void 0) ?? row.value;
+    if (value === void 0 || value === null) return [];
+    const label = (labelKey ? row[labelKey] : void 0) ?? row.label ?? value;
+    return [{ value: String(value), label: String(label) }];
+  });
+}
 function TagMultiSelectImpl({
   options,
+  valueKey,
+  labelKey,
   values,
   onChange,
   disabled = false,
   emptyText = "\uC120\uD0DD\uD560 \uD56D\uBAA9\uC774 \uC5C6\uC2B5\uB2C8\uB2E4"
 }) {
-  const safeOptions = options ?? [];
+  const safeOptions = useMemo(() => foldOptions(options, valueKey, labelKey), [options, valueKey, labelKey]);
   const isControlled = values !== void 0 && typeof onChange === "function";
   const [internalValues, setInternalValues] = useState(values ?? []);
   const current = isControlled ? values : internalValues;

package/dist/{chunk-UA5CT24N.js → chunk-K5ZJTLFP.js}

@@ -1,5 +1,5 @@
-import { includesLooseSearch } from './chunk-QIDMPWZH.js';
-import { Button, Dialog, Input, Tag, Checkbox } from './chunk-B5JTXYDB.js';
+import { includesLooseSearch } from './chunk-FC2F37QH.js';
+import { Button, Dialog, Input, Tag, Checkbox } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import React, { useMemo, useState, useEffect } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';

package/dist/{chunk-B5JTXYDB.js → chunk-LMHIRQZ6.js}

@@ -750,6 +750,7 @@ function Button({
       style: mergeStyle(containerLayoutStyle({ justify }), style),
       disabled: Tag2 === "button" ? disabled || loading : void 0,
       "aria-disabled": disabled || void 0,
+      type: Tag2 === "button" ? "button" : void 0,
       ...rest,
       children: [
         icon ? /* @__PURE__ */ jsx(Icon, { name: icon, size: iconSize }) : null,

package/dist/{chunk-4IRLQWQC.js → chunk-LN6IOMCK.js}

@@ -1,4 +1,4 @@
-import { Icon, Badge } from './chunk-B5JTXYDB.js';
+import { Icon, Badge } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import React from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';

package/dist/{chunk-3PYMVHL3.js → chunk-R3IK6EPA.js}

@@ -1,4 +1,4 @@
-import { IconButton } from './chunk-B5JTXYDB.js';
+import { IconButton } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { useState, useRef, useCallback, useEffect } from 'react';
 import { createPortal } from 'react-dom';

package/dist/{chunk-YFUQUWWH.js → chunk-VBCUIM7N.js}

@@ -1,5 +1,5 @@
-import { Disclosure } from './chunk-WLWWN5LW.js';
-import { Icon } from './chunk-B5JTXYDB.js';
+import { Disclosure } from './chunk-YGSU34B3.js';
+import { Icon } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { jsx, jsxs } from 'react/jsx-runtime';
 

package/dist/{chunk-FDVI3PWQ.js → chunk-X5X3FKCQ.js}

@@ -1,4 +1,4 @@
-import { Textarea, Icon } from './chunk-B5JTXYDB.js';
+import { Textarea, Icon } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { useState, useRef, useId, useEffect, useCallback } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/{chunk-WLWWN5LW.js → chunk-YGSU34B3.js}

@@ -1,4 +1,4 @@
-import { Icon } from './chunk-B5JTXYDB.js';
+import { Icon } from './chunk-LMHIRQZ6.js';
 import { boxed } from './chunk-SAN4IX6N.js';
 import { useState, useId, useCallback } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import React__default, { CSSProperties, ReactNode, ComponentType } from 'react';
-import { S as SduiAction, a as SduiPropValue, b as SduiRule, c as SduiPage } from './types-DO8_hC6A.js';
-export { d as SduiCalcRef, e as SduiChild, f as SduiIndexRef, g as SduiItemRef, h as SduiNode, i as SduiPageQuery, j as SduiScalar, k as SduiStateRef } from './types-DO8_hC6A.js';
+import { S as SduiAction, a as SduiPropValue, b as SduiRule, c as SduiPage } from './types-CeUhMB9Q.js';
+export { d as SduiCalcRef, e as SduiChild, f as SduiIndexRef, g as SduiItemRef, h as SduiNode, i as SduiPageQuery, j as SduiScalar, k as SduiStateRef } from './types-CeUhMB9Q.js';
 import { S as SduiBoxProps, a as SduiContainerLayoutProps, b as SduiColumnsScale, c as SduiGapScale, d as SduiWeightScale, e as SduiTextAlignScale } from './layout-B1QrIBm6.js';
 export { C as CHILD_LAYOUT_PROPS, L as LAYOUT_CSS, f as SduiAlignScale, g as SduiChildLayoutProps, h as SduiSizeScale, i as SduiSpanScale, j as childLayoutFrom, k as columnsClass, l as containerLayoutStyle, m as joinClass, n as mergeStyle, t as typographyStyle } from './layout-B1QrIBm6.js';
 import { D as DatePickerProps, a as DateRangePickerProps } from './DatePicker-BndreCPl.js';
@@ -448,6 +448,12 @@ interface SduiTextCell {
 interface SduiBadgeCell {
     type: 'badge';
     toneMap?: Record<string, BadgeTone>;
+    /**
+     * 값 → 표시 텍스트(생략 시 값 그대로) — Table 컬럼 badge와 같은 의미론.
+     * 톤 조회 키는 여전히 **원래 값**이다. labelMap이 조회 키까지 바꾸면 기존 스펙의
+     * toneMap(enum 키)이 전부 neutral로 떨어진다.
+     */
+    labelMap?: Record<string, string>;
 }
 /** 값을 태그로. 선행 점 색은 값별 매핑(CSS 색상 문자열). */
 interface SduiTagCell {
@@ -550,9 +556,11 @@ interface SduiGridCardAction {
 interface SduiGridCard {
     titleKey: string;
     subtitleKey?: string;
+    /** 카드 우상단 배지 — labelMap은 표시 텍스트만 바꾸고 톤 조회 키는 원래 값이다(셀 badge와 같은 규칙) */
     badge?: {
         key: string;
         toneMap?: Record<string, BadgeTone>;
+        labelMap?: Record<string, string>;
     };
     /** 한 열로 쌓는 행 */
     rows?: SduiGridCardRow[];

package/dist/index.js

@@ -1,9 +1,9 @@
-import { DEV, HoistedStyle, isSafeNavigationTarget, useSduiAdapter, hostFetchOf, DateRangePicker, DatePicker, useSduiSandbox, resolveAdapter, assetResolverOf, SduiAdapterContext } from './chunk-5A7BWIGN.js';
-export { DatePicker, DateRangePicker, defaultAdapter, useSduiAssetResolver, useSduiSandbox } from './chunk-5A7BWIGN.js';
-import { normalizeSearchFields, searchValuesFromParams, splitMultiValue, includesLooseSearch, cascadingValuePaths, SearchToolbar, searchFieldKeys, Popover } from './chunk-QIDMPWZH.js';
-export { SearchToolbar, cascadingValuePaths, cleanSearchValues, includesLooseSearch, joinMultiValue, normalizeSearchText, searchFieldKeys, searchValuesFromParams, splitMultiValue } from './chunk-QIDMPWZH.js';
-import { EmptyState, Button, Checkbox, SegmentedControl, Spinner, Select, Pagination, Icon, Card, Badge, ProgressBar, Tag, Toast, Textarea, Tabs, Table, Switch, StatCard, Input, IconButton, Field, Alert, warnOnce, Dialog } from './chunk-B5JTXYDB.js';
-export { Alert, Avatar, Badge, Breadcrumb, Button, Card, Checkbox, Dialog, EmptyState, Field, Icon, IconButton, Input, Pagination, ProgressBar, Radio, SegmentedControl, Select, SidebarNav, Spinner, StatCard, Switch, Table, Tabs, Tag, Textarea, Toast, Tooltip } from './chunk-B5JTXYDB.js';
+import { DEV, HoistedStyle, isSafeNavigationTarget, useSduiAdapter, hostFetchOf, DateRangePicker, DatePicker, useSduiSandbox, resolveAdapter, assetResolverOf, SduiAdapterContext } from './chunk-HINKJD6C.js';
+export { DatePicker, DateRangePicker, defaultAdapter, useSduiAssetResolver, useSduiSandbox } from './chunk-HINKJD6C.js';
+import { normalizeSearchFields, searchValuesFromParams, splitMultiValue, includesLooseSearch, cascadingValuePaths, SearchToolbar, searchFieldKeys, Popover } from './chunk-FC2F37QH.js';
+export { SearchToolbar, cascadingValuePaths, cleanSearchValues, includesLooseSearch, joinMultiValue, normalizeSearchText, searchFieldKeys, searchValuesFromParams, splitMultiValue } from './chunk-FC2F37QH.js';
+import { EmptyState, Button, Checkbox, SegmentedControl, Spinner, Select, Pagination, Icon, Card, Badge, ProgressBar, Tag, Toast, Textarea, Tabs, Table, Switch, StatCard, Input, IconButton, Field, Alert, warnOnce, Dialog } from './chunk-LMHIRQZ6.js';
+export { Alert, Avatar, Badge, Breadcrumb, Button, Card, Checkbox, Dialog, EmptyState, Field, Icon, IconButton, Input, Pagination, ProgressBar, Radio, SegmentedControl, Select, SidebarNav, Spinner, StatCard, Switch, Table, Tabs, Tag, Textarea, Toast, Tooltip } from './chunk-LMHIRQZ6.js';
 import { boxed, mergeStyle, containerLayoutStyle, joinClass, columnsClass, typographyStyle, LAYOUT_CSS, childLayoutFrom, CHILD_LAYOUT_PROPS } from './chunk-SAN4IX6N.js';
 export { CHILD_LAYOUT_PROPS, LAYOUT_CSS, boxed, childLayoutFrom, columnsClass, containerLayoutStyle, joinClass, mergeStyle, typographyStyle } from './chunk-SAN4IX6N.js';
 import React, { createContext, useState, useMemo, useContext, useRef, useEffect, useCallback } from 'react';
@@ -347,7 +347,7 @@ function cellRenderer(cell, key, dispatch) {
       return (row) => {
         const value = String(row[key] ?? "");
         if (!value) return null;
-        return /* @__PURE__ */ jsx(Badge, { tone: cell.toneMap?.[value] ?? "neutral", children: value });
+        return /* @__PURE__ */ jsx(Badge, { tone: cell.toneMap?.[value] ?? "neutral", children: cell.labelMap?.[value] ?? value });
       };
     case "tag":
       return (row) => {
@@ -1111,7 +1111,10 @@ function mapGridCard(gridCard, dispatch) {
     badge: gridCard.badge ? (row) => {
       const value = String(row[gridCard.badge.key] ?? "");
       if (!value) return null;
-      return { text: value, variant: gridCard.badge.toneMap?.[value] ?? "neutral" };
+      return {
+        text: gridCard.badge.labelMap?.[value] ?? value,
+        variant: gridCard.badge.toneMap?.[value] ?? "neutral"
+      };
     } : void 0,
     rows: mapCardRows(gridCard.rows, dispatch),
     leftRows: mapCardRows(gridCard.leftRows, dispatch),
@@ -1711,6 +1714,33 @@ function createRegistry(extensions) {
   return { ...defaultRegistry, ...extensions };
 }
 
+// src/request-action.ts
+function deferChainEntry(container, key) {
+  return typeof container.action === "string" && (key === "onSuccess" || key === "onError");
+}
+async function runRequestAction(action, deps) {
+  try {
+    if (typeof action.endpoint !== "string" || action.endpoint === "") {
+      throw new Error("request \uC561\uC158\uC758 endpoint\uAC00 \uBE44\uC5B4 \uC788\uC2B5\uB2C8\uB2E4 \u2014 $state \uCC38\uC870\uC5D0 \uC544\uC9C1 \uAC12\uC774 \uC5C6\uB294\uC9C0 \uD655\uC778\uD558\uC138\uC694");
+    }
+    const response = await deps.fetch(action.endpoint, {
+      method: action.method ?? "POST",
+      ...action.body === void 0 ? {} : { body: action.body }
+    });
+    if (typeof action.invalidate === "string" && action.invalidate !== "") {
+      deps.dispatch({ action: "invalidate", prefix: action.invalidate });
+    }
+    (action.onSuccess ?? []).forEach((a) => deps.dispatch(a, response));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "\uC694\uCCAD\uC774 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4";
+    if (action.onError?.length) {
+      action.onError.forEach((a) => deps.dispatch(a, message));
+    } else {
+      deps.toast({ tone: "danger", title: "\uC694\uCCAD \uC2E4\uD328", message });
+    }
+  }
+}
+
 // src/validate.ts
 var ACTION_NAMES = /* @__PURE__ */ new Set([
   "navigate",
@@ -1719,6 +1749,7 @@ var ACTION_NAMES = /* @__PURE__ */ new Set([
   "close",
   "toast",
   "submitForm",
+  "request",
   "invalidate",
   "refresh",
   "download",
@@ -2004,6 +2035,15 @@ function pickPath(source, path) {
   }
   return value;
 }
+function planStamp(plan, epochs) {
+  return `${plan.endpoint}#${epochs[plan.key] ?? 0}`;
+}
+function revertUnsettledStamps(fetched, runnable, epochs, settled) {
+  for (const plan of runnable) {
+    if (settled.has(plan.key)) continue;
+    if (fetched.get(plan.key) === planStamp(plan, epochs)) fetched.delete(plan.key);
+  }
+}
 function isPlainObject3(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
@@ -2442,7 +2482,9 @@ function SduiRenderer({
       if (Array.isArray(value)) return value.map((v) => resolveValue(v, scope));
       if (isPlainObject3(value)) {
         const out = {};
-        for (const [k, v] of Object.entries(value)) out[k] = resolveValue(v, scope);
+        for (const [k, v] of Object.entries(value)) {
+          out[k] = deferChainEntry(value, k) ? v : resolveValue(v, scope);
+        }
         return out;
       }
       return value;
@@ -2465,7 +2507,7 @@ function SduiRenderer({
   useEffect(() => {
     const epochs = dataEpochsRef.current;
     const runnable = runnablePlans(dataPlanRef.current).filter((plan) => {
-      const stamp = `${plan.endpoint}#${epochs[plan.key] ?? 0}`;
+      const stamp = planStamp(plan, epochs);
       if (fetchedRef.current.get(plan.key) === stamp) return false;
       fetchedRef.current.set(plan.key, stamp);
       return true;
@@ -2474,6 +2516,7 @@ function SduiRenderer({
     const controller = new AbortController();
     let cancelled = false;
     const timers = [];
+    const settled = /* @__PURE__ */ new Set();
     setEntries(
       Object.fromEntries(runnable.map((plan) => [`${plan.key}.$loading`, true]))
     );
@@ -2497,6 +2540,7 @@ function SduiRenderer({
               `[sdui] page.data.${plan.key}: \uC751\uB2F5\uC5D0 "${plan.select}" \uACBD\uB85C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uAC12 \uC5C6\uC74C\uC73C\uB85C \uB461\uB2C8\uB2E4 (${plan.endpoint})`
             );
           }
+          settled.add(plan.key);
           setEntries({
             [plan.key]: picked,
             [`${plan.key}.$loading`]: false,
@@ -2506,6 +2550,7 @@ function SduiRenderer({
           if (cancelled || controller.signal.aborted) return;
           const message = error instanceof Error ? error.message : "\uC870\uD68C\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4";
           warnOnce2(`data:${plan.key}:${plan.endpoint}`, `[sdui] page.data.${plan.key} \uC870\uD68C \uC2E4\uD328 (${plan.endpoint}): ${message}`);
+          settled.add(plan.key);
           setEntries({
             [plan.key]: plan.fallback ?? void 0,
             [`${plan.key}.$loading`]: false,
@@ -2518,6 +2563,7 @@ function SduiRenderer({
       cancelled = true;
       controller.abort();
       timers.forEach(clearTimeout);
+      revertUnsettledStamps(fetchedRef.current, runnable, epochs, settled);
     };
   }, [dataPlanKey, dataEpochKey, setEntries]);
   const dispatchRef = useRef(() => {
@@ -2646,6 +2692,13 @@ function SduiRenderer({
           })();
           break;
         }
+        case "request":
+          void runRequestAction(action, {
+            fetch: (path, init) => hostRef.current.fetch(path, init),
+            dispatch: (a, value) => dispatchRef.current(a, value),
+            toast: pushToast
+          });
+          break;
         case "invalidate": {
           hostRef.current.invalidate?.(action.prefix, action.exact ?? false);
           const prefix = typeof action.prefix === "string" ? action.prefix : "";

package/dist/meta.d.ts

@@ -1,4 +1,4 @@
-import { a as SduiPropValue, h as SduiNode } from './types-DO8_hC6A.js';
+import { a as SduiPropValue, h as SduiNode } from './types-CeUhMB9Q.js';
 
 /**
  * 시각 빌더용 컴포넌트 메타데이터 스키마.

package/dist/meta.js

@@ -1806,6 +1806,12 @@ var searchCellFields = [
     ]
   },
   { name: "toneMap", kind: "object", label: "\uAC12 \u2192 \uD1A4", description: "type=badge (\uC5C6\uB294 \uAC12\uC740 neutral)" },
+  {
+    name: "labelMap",
+    kind: "object",
+    label: "\uAC12 \u2192 \uD45C\uC2DC \uBB38\uAD6C",
+    description: "type=badge (\uC5C6\uB294 \uAC12\uC740 \uC6D0\uBB38 \uADF8\uB300\uB85C, \uD1A4 \uC870\uD68C \uD0A4\uB294 \uC6D0\uB798 \uAC12)"
+  },
   { name: "colorMap", kind: "object", label: "\uAC12 \u2192 \uC810 \uC0C9", description: "type=tag" },
   { name: "filled", kind: "boolean", label: "\uCC44\uC6B4 \uD0DC\uADF8", description: "type=tag" },
   {
@@ -1955,7 +1961,7 @@ var searchCommonProps = [
     fields: [
       { name: "titleKey", kind: "string", label: "\uC81C\uBAA9 \uD544\uB4DC", required: true },
       { name: "subtitleKey", kind: "string", label: "\uBD80\uC81C \uD544\uB4DC" },
-      { name: "badge", kind: "object", label: "\uBC30\uC9C0", description: "{ key, toneMap }" },
+      { name: "badge", kind: "object", label: "\uBC30\uC9C0", description: "{ key, toneMap, labelMap } \u2014 labelMap\uC740 \uD45C\uC2DC \uBB38\uAD6C\uB9CC \uBC14\uAFBC\uB2E4" },
       { name: "rows", kind: "array", label: "\uD589", item: searchCardRowFields },
       {
         name: "leftRows",
@@ -3493,12 +3499,29 @@ var TagMultiSelectMeta = {
       label: "\uC635\uC158",
       required: true,
       bindable: true,
+      description: "\uAE30\uBCF8\uC740 \uC544\uB798 \uD589 \uD3B8\uC9D1\uAE30\uC758 {\uAC12, \uD45C\uC2DC} \uBAA8\uC591\uC774\uB2E4. \uB3C4\uBA54\uC778 \uD589 \uBAA9\uB85D\uC744 \uADF8\uB300\uB85C \uBB3C\uB9B4 \uAC70\uBA74(\uC608: /employees\uC758 {id, name}) \uAC12 \uD0A4\xB7\uB77C\uBCA8 \uD0A4\uB85C \uC77D\uC744 \uC790\uB9AC\uB97C \uC54C\uB824 \uC900\uB2E4.",
       group: "data",
       item: [
         { name: "value", kind: "string", label: "\uAC12", required: true },
         { name: "label", kind: "string", label: "\uD45C\uC2DC", required: true }
       ]
     },
+    {
+      name: "valueKey",
+      kind: "string",
+      label: "\uAC12 \uD0A4",
+      default: "value",
+      description: "\uC635\uC158\uC5D0\uC11C \uAC12\uC744 \uC77D\uC744 \uD0A4. Select\uC758 \uAC19\uC740 \uC774\uB984 \uD504\uB86D\uACFC \uB73B\uC774 \uAC19\uB2E4.",
+      group: "data"
+    },
+    {
+      name: "labelKey",
+      kind: "string",
+      label: "\uB77C\uBCA8 \uD0A4",
+      default: "label",
+      description: "\uC635\uC158\uC5D0\uC11C \uD45C\uC2DC \uB77C\uBCA8\uC744 \uC77D\uC744 \uD0A4. \uADF8 \uC790\uB9AC\uAC00 \uBE44\uBA74 \uAC12\uC73C\uB85C \uB300\uC2E0 \uADF8\uB9B0\uB2E4.",
+      group: "data"
+    },
     {
       name: "values",
       kind: "array",
@@ -3541,11 +3564,33 @@ var TreePickerMeta = {
       name: "nodes",
       kind: "array",
       label: "\uD2B8\uB9AC",
-      required: true,
       bindable: true,
+      description: "rows\uAC00 \uBE44\uC5B4 \uC788\uC744 \uB54C\uC758 \uD3F4\uBC31 \u2014 \uCE94\uBC84\uC2A4 \uB370\uBAA8\uB294 \uC5EC\uAE30 \uB454\uB2E4.",
       group: "data",
       item: treeNodeItem
     },
+    {
+      name: "rows",
+      kind: "array",
+      label: "\uD3C9\uBA74 \uD589",
+      bindable: true,
+      description: "{id, parent_id, name} \uAC19\uC740 \uD3C9\uBA74 \uBAA9\uB85D. \uBE44\uC5B4\uC788\uC9C0 \uC54A\uC73C\uBA74 tree \uB9E4\uD551\uC73C\uB85C \uACC4\uCE35\uC744 \uC138\uC6B4\uB2E4 \u2014 /categories\uCC98\uB7FC \uD3C9\uBA74\uC73C\uB85C \uC8FC\uB294 API\uB97C \uADF8\uB300\uB85C \uBC14\uC778\uB529\uD55C\uB2E4.",
+      group: "data",
+      item: [],
+      itemKind: "object"
+    },
+    {
+      name: "tree",
+      kind: "object",
+      label: "\uD589 \u2192 \uD2B8\uB9AC \uB9E4\uD551",
+      description: "\uD3C9\uBA74 \uD589\uC5D0\uC11C \uC77D\uC744 \uD0A4 \uC774\uB984. \uC0C1\uC138\uAC80\uC0C9 cascading\uC758 tree\uC640 \uAC19\uC740 \uACC4\uC57D\uC774\uB2E4.",
+      group: "data",
+      fields: [
+        { name: "idKey", kind: "string", label: "id \uD0A4", required: true },
+        { name: "parentIdKey", kind: "string", label: "\uBD80\uBAA8 id \uD0A4", required: true },
+        { name: "labelKey", kind: "string", label: "\uB77C\uBCA8 \uD0A4", required: true }
+      ]
+    },
     {
       name: "value",
       kind: "string",
@@ -4198,11 +4243,33 @@ var TreeViewMeta = {
       name: "nodes",
       kind: "array",
       label: "\uD2B8\uB9AC",
-      required: true,
       bindable: true,
+      description: "rows\uAC00 \uBE44\uC5B4 \uC788\uC744 \uB54C\uC758 \uD3F4\uBC31 \u2014 \uCE94\uBC84\uC2A4 \uB370\uBAA8\uB294 \uC5EC\uAE30 \uB454\uB2E4.",
       group: "data",
       item: treeNodeItem
     },
+    {
+      name: "rows",
+      kind: "array",
+      label: "\uD3C9\uBA74 \uD589",
+      bindable: true,
+      description: "{id, parent_id, name} \uAC19\uC740 \uD3C9\uBA74 \uBAA9\uB85D. \uBE44\uC5B4\uC788\uC9C0 \uC54A\uC73C\uBA74 tree \uB9E4\uD551\uC73C\uB85C \uACC4\uCE35\uC744 \uC138\uC6B4\uB2E4 \u2014 /categories\uCC98\uB7FC \uD3C9\uBA74\uC73C\uB85C \uC8FC\uB294 API\uB97C \uADF8\uB300\uB85C \uBC14\uC778\uB529\uD55C\uB2E4.",
+      group: "data",
+      item: [],
+      itemKind: "object"
+    },
+    {
+      name: "tree",
+      kind: "object",
+      label: "\uD589 \u2192 \uD2B8\uB9AC \uB9E4\uD551",
+      description: "\uD3C9\uBA74 \uD589\uC5D0\uC11C \uC77D\uC744 \uD0A4 \uC774\uB984. \uC0C1\uC138\uAC80\uC0C9 cascading\uC758 tree\uC640 \uAC19\uC740 \uACC4\uC57D\uC774\uB2E4.",
+      group: "data",
+      fields: [
+        { name: "idKey", kind: "string", label: "id \uD0A4", required: true },
+        { name: "parentIdKey", kind: "string", label: "\uBD80\uBAA8 id \uD0A4", required: true },
+        { name: "labelKey", kind: "string", label: "\uB77C\uBCA8 \uD0A4", required: true }
+      ]
+    },
     {
       name: "selectedId",
       kind: "string",

package/dist/rich.js

@@ -1,6 +1,6 @@
-import { useSduiAssetResolver, HoistedStyle } from './chunk-5A7BWIGN.js';
-export { DatePicker, DateRangePicker } from './chunk-5A7BWIGN.js';
-import { Spinner, EmptyState } from './chunk-B5JTXYDB.js';
+import { useSduiAssetResolver, HoistedStyle } from './chunk-HINKJD6C.js';
+export { DatePicker, DateRangePicker } from './chunk-HINKJD6C.js';
+import { Spinner, EmptyState } from './chunk-LMHIRQZ6.js';
 import './chunk-SAN4IX6N.js';
 import { useRef, useCallback, useMemo, useState, useEffect, useLayoutEffect } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';

package/dist/{types-DO8_hC6A.d.ts → types-CeUhMB9Q.d.ts}

@@ -134,6 +134,24 @@ type SduiAction = {
     /** 실패 시 순차 실행 (이벤트 값 = 에러 메시지). 생략하면 danger 토스트 */
     onError?: SduiAction[];
 }
+/**
+ * 단발 API 호출 — submitForm에서 폼 수집·검증을 뺀 것. 서버의 2단계 커밋 계약
+ * (본체 POST 후 `POST /{entity}/{id}/attachments`)을 submitForm의 onSuccess 안에서
+ * 잇는 자리다. endpoint·body는 디스패치 시점에 해석되므로 같은 체인의 setState를 본다.
+ */
+ | {
+    action: 'request';
+    endpoint: string;
+    /** 생략하면 POST. GET은 page.data의 몫이다 — 본문 실린 GET은 브라우저가 막는다. */
+    method?: 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    body?: SduiPropValue;
+    /** 성공 시 순차 실행 (이벤트 값 = 응답 JSON) */
+    onSuccess?: SduiAction[];
+    /** 실패 시 순차 실행 (이벤트 값 = 에러 메시지). 생략하면 danger 토스트 */
+    onError?: SduiAction[];
+    /** 성공 시 무효화할 조회 prefix — onSuccess의 invalidate 액션 단축 */
+    invalidate?: string;
+}
 /** 클라이언트 조회 캐시 무효화 — 어댑터의 invalidate로 위임 */
  | {
     action: 'invalidate';

package/dist/widgets/AutocompleteField.js

@@ -1,4 +1,4 @@
-export { AutocompleteField, toAutocompleteOptions } from '../chunk-PBGYAVQZ.js';
-import '../chunk-QIDMPWZH.js';
-import '../chunk-B5JTXYDB.js';
+export { AutocompleteField, toAutocompleteOptions } from '../chunk-6NAJ2D4A.js';
+import '../chunk-FC2F37QH.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/ColumnBoard.js

@@ -1,3 +1,3 @@
-export { ColumnBoard } from '../chunk-VK6KWB65.js';
-import '../chunk-B5JTXYDB.js';
+export { ColumnBoard } from '../chunk-G4QIJHEP.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/DiffView.js

@@ -1,3 +1,3 @@
-export { DiffView } from '../chunk-4IRLQWQC.js';
-import '../chunk-B5JTXYDB.js';
+export { DiffView } from '../chunk-LN6IOMCK.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/Disclosure.js

@@ -1,3 +1,3 @@
-export { Disclosure } from '../chunk-WLWWN5LW.js';
-import '../chunk-B5JTXYDB.js';
+export { Disclosure } from '../chunk-YGSU34B3.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/EventCalendar.js

@@ -1,3 +1,3 @@
-export { EventCalendar } from '../chunk-WMPSOKNI.js';
-import '../chunk-B5JTXYDB.js';
+export { EventCalendar } from '../chunk-CXZYC7IN.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/ImageLightbox.js

@@ -1,3 +1,3 @@
-export { ImageLightbox } from '../chunk-3PYMVHL3.js';
-import '../chunk-B5JTXYDB.js';
+export { ImageLightbox } from '../chunk-R3IK6EPA.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/InlineEdit.js

@@ -1,3 +1,3 @@
-export { InlineEdit } from '../chunk-7AHNAX6T.js';
-import '../chunk-B5JTXYDB.js';
+export { InlineEdit } from '../chunk-BOSSWJTN.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/JsonField.js

@@ -1,3 +1,3 @@
-export { JsonField } from '../chunk-FDVI3PWQ.js';
-import '../chunk-B5JTXYDB.js';
+export { JsonField } from '../chunk-X5X3FKCQ.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/OrgChart.js

@@ -1,3 +1,3 @@
-export { OrgChart } from '../chunk-BT4HC3WR.js';
-import '../chunk-B5JTXYDB.js';
+export { OrgChart } from '../chunk-F2MKI3W5.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/PeriodFilter.js

@@ -1,3 +1,3 @@
-export { PeriodFilter } from '../chunk-WJEGCCPY.js';
-import '../chunk-B5JTXYDB.js';
+export { PeriodFilter } from '../chunk-4NPTFNAL.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/PrintSheet.js

@@ -1,3 +1,3 @@
-export { PrintSheet } from '../chunk-JWYBFODH.js';
-import '../chunk-B5JTXYDB.js';
+export { PrintSheet } from '../chunk-5YVXVGQ2.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/SearchableMultiPicker.js

@@ -1,4 +1,4 @@
-export { SearchableMultiPicker } from '../chunk-UA5CT24N.js';
-import '../chunk-QIDMPWZH.js';
-import '../chunk-B5JTXYDB.js';
+export { SearchableMultiPicker } from '../chunk-K5ZJTLFP.js';
+import '../chunk-FC2F37QH.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/SecureScreen.js

@@ -1,3 +1,3 @@
-export { SecureScreen } from '../chunk-4CZJF5PR.js';
-import '../chunk-B5JTXYDB.js';
+export { SecureScreen } from '../chunk-5C4SIRSW.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/TagMultiSelect.d.ts

@@ -14,7 +14,15 @@ interface TagMultiSelectOption {
     label: string;
 }
 interface TagMultiSelectProps {
-    options: TagMultiSelectOption[];
+    /**
+     * 기본은 `{value, label}`이고, 도메인 행(`{id, name, …}`)을 그대로 넘길 거면
+     * `valueKey`/`labelKey`로 읽을 키를 알려 준다 — Select 0.7.0과 같은 계약.
+     */
+    options: Array<TagMultiSelectOption | Record<string, unknown>>;
+    /** 옵션에서 값을 읽을 키. 기본 'value'. */
+    valueKey?: string;
+    /** 옵션에서 표시 라벨을 읽을 키. 기본 'label'. */
+    labelKey?: string;
     values: string[];
     onChange: (values: string[]) => void;
     disabled?: boolean;

package/dist/widgets/TagMultiSelect.js

@@ -1,3 +1,3 @@
-export { TagMultiSelect } from '../chunk-TMAVD3WL.js';
-import '../chunk-B5JTXYDB.js';
+export { TagMultiSelect } from '../chunk-K55ODWRY.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/Timeline.js

@@ -1,4 +1,4 @@
-export { Timeline } from '../chunk-YFUQUWWH.js';
-import '../chunk-WLWWN5LW.js';
-import '../chunk-B5JTXYDB.js';
+export { Timeline } from '../chunk-VBCUIM7N.js';
+import '../chunk-YGSU34B3.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/TreePicker.d.ts

@@ -1,9 +1,14 @@
 import * as React from 'react';
 import { S as SduiBoxProps } from '../layout-B1QrIBm6.js';
-import { TreeNode } from './TreeView.js';
+import { TreeNode, TreeRowsMapping } from './TreeView.js';
 
 interface TreePickerProps {
-    nodes: TreeNode[];
+    /** 정적 트리. `rows`가 비어 있을 때의 폴백이기도 하다 — 캔버스 데모는 여기 둔다. */
+    nodes?: TreeNode[];
+    /** 평면 행. 비어있지 않으면 `tree` 매핑으로 계층을 세운다 — {@link TreeViewProps.rows}와 같은 계약. */
+    rows?: unknown[];
+    /** 평면 행에서 읽을 키 이름. 없으면 `rows`는 무시된다. */
+    tree?: TreeRowsMapping;
     /** 지정하면 controlled — 내부 커밋 상태를 쓰지 않는다. null = 선택 없음. */
     value?: string | null;
     /** 트리에서 노드를 찾지 못할 때 표시할 라벨(controlled 보조). */

package/dist/widgets/TreePicker.js

@@ -1,4 +1,5 @@
-export { TreePicker } from '../chunk-VV73LOAE.js';
-import '../chunk-X3DGYP4W.js';
-import '../chunk-B5JTXYDB.js';
+export { TreePicker } from '../chunk-JND5NXUT.js';
+import '../chunk-BS4LGGQV.js';
+import '../chunk-FC2F37QH.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/TreeView.d.ts

@@ -8,8 +8,25 @@ interface TreeNode {
     meta?: string;
     children?: TreeNode[];
 }
+/**
+ * `rows` → 트리 매핑 계약. 상세검색 cascading의 `tree`(SearchToolbar)와 같은 모양이다 —
+ * 스펙 작성자가 한 어휘를 두 자리에서 그대로 쓴다.
+ */
+interface TreeRowsMapping {
+    idKey: string;
+    parentIdKey: string;
+    labelKey: string;
+}
 interface TreeViewProps {
-    nodes: TreeNode[];
+    /** 정적 트리. `rows`가 비어 있을 때의 폴백이기도 하다 — 캔버스 데모는 여기 둔다. */
+    nodes?: TreeNode[];
+    /**
+     * 평면 행(/categories 모양 — {id, parent_id, name}). 비어있지 않으면 `tree` 매핑으로
+     * 계층을 세우고, 아니면 `nodes` 폴백 — AutocompleteField의 데모 options 유지와 같은 관례.
+     */
+    rows?: unknown[];
+    /** 평면 행에서 읽을 키 이름. 없으면 `rows`는 무시된다. */
+    tree?: TreeRowsMapping;
     /** 지정하면 controlled — 내부 선택 상태를 쓰지 않는다. */
     selectedId?: string | null;
     onSelect?: (id: string, node: TreeNode) => void;
@@ -22,10 +39,18 @@ interface TreeViewProps {
     /** 스크롤 컨테이너 최대 높이 (예: "320px"). */
     maxHeight?: string;
 }
+/**
+ * 평면 행을 TreeNode 계층으로 세운다. 고아 행(부모가 목록에 없음)을 루트로 올리는 것까지
+ * `buildCascadingTree`와 동작이 같다 — 알고리즘은 그쪽 한 벌뿐이고 여기는 노드 모양만 바꾼다.
+ */
+declare function buildTreeNodes(rows: unknown[] | undefined, tree: TreeRowsMapping): TreeNode[];
+/** rows가 비어있지 않고 매핑이 있으면 파생 트리, 아니면 nodes 폴백. TreePicker도 이 판을 쓴다. */
+declare function resolveTreeNodes(nodes: TreeNode[] | undefined, rows: unknown[] | undefined, tree: TreeRowsMapping | undefined): TreeNode[];
+declare function pruneExcluded(nodes: TreeNode[], excluded: ReadonlySet<string>): TreeNode[];
 /**
  * 바깥에서 온 `style`·`className`을 뿌리에 얹어 내보낸다 — 자식 축(`grow`·`width` …)이
  * 이 컴포넌트에서도 동작하게 하는 유일한 통로다. 까닭은 {@link ../boxed.tsx}에 있다.
  */
 declare const TreeView: React__default.FC<TreeViewProps & SduiBoxProps>;
 
-export { type TreeNode, TreeView, type TreeViewProps };
+export { type TreeNode, type TreeRowsMapping, TreeView, type TreeViewProps, buildTreeNodes, pruneExcluded, resolveTreeNodes };

package/dist/widgets/TreeView.js

@@ -1,3 +1,4 @@
-export { TreeView } from '../chunk-X3DGYP4W.js';
-import '../chunk-B5JTXYDB.js';
+export { TreeView, buildTreeNodes, pruneExcluded, resolveTreeNodes } from '../chunk-BS4LGGQV.js';
+import '../chunk-FC2F37QH.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';

package/dist/widgets/index.d.ts

@@ -1,5 +1,5 @@
 import { TreeViewProps } from './TreeView.js';
-export { TreeNode, TreeView } from './TreeView.js';
+export { TreeNode, TreeRowsMapping, TreeView, buildTreeNodes } from './TreeView.js';
 import { TreePickerProps } from './TreePicker.js';
 export { TreePicker } from './TreePicker.js';
 import { TimelineProps } from './Timeline.js';

package/dist/widgets/index.js

@@ -1,46 +1,46 @@
-import { SearchableMultiPicker } from '../chunk-UA5CT24N.js';
-export { SearchableMultiPicker } from '../chunk-UA5CT24N.js';
-import { SecureScreen } from '../chunk-4CZJF5PR.js';
-export { SecureScreen } from '../chunk-4CZJF5PR.js';
+import { SearchableMultiPicker } from '../chunk-K5ZJTLFP.js';
+export { SearchableMultiPicker } from '../chunk-K5ZJTLFP.js';
+import { SecureScreen } from '../chunk-5C4SIRSW.js';
+export { SecureScreen } from '../chunk-5C4SIRSW.js';
 import { StackedMeter } from '../chunk-BMZKZGJF.js';
 export { StackedMeter } from '../chunk-BMZKZGJF.js';
 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 { TagMultiSelect } from '../chunk-TMAVD3WL.js';
-export { TagMultiSelect } from '../chunk-TMAVD3WL.js';
-import { Timeline } from '../chunk-YFUQUWWH.js';
-export { Timeline } from '../chunk-YFUQUWWH.js';
-import { TreePicker } from '../chunk-VV73LOAE.js';
-export { TreePicker } from '../chunk-VV73LOAE.js';
-import { TreeView } from '../chunk-X3DGYP4W.js';
-export { TreeView } from '../chunk-X3DGYP4W.js';
-import { EventCalendar } from '../chunk-WMPSOKNI.js';
-export { EventCalendar } from '../chunk-WMPSOKNI.js';
-import { ImageLightbox } from '../chunk-3PYMVHL3.js';
-export { ImageLightbox } from '../chunk-3PYMVHL3.js';
-import { InlineEdit } from '../chunk-7AHNAX6T.js';
-export { InlineEdit } from '../chunk-7AHNAX6T.js';
-import { JsonField } from '../chunk-FDVI3PWQ.js';
-export { JsonField } from '../chunk-FDVI3PWQ.js';
+import { TagMultiSelect } from '../chunk-K55ODWRY.js';
+export { TagMultiSelect } from '../chunk-K55ODWRY.js';
+import { Timeline } from '../chunk-VBCUIM7N.js';
+export { Timeline } from '../chunk-VBCUIM7N.js';
+import { TreePicker } from '../chunk-JND5NXUT.js';
+export { TreePicker } from '../chunk-JND5NXUT.js';
+import { TreeView } from '../chunk-BS4LGGQV.js';
+export { TreeView, buildTreeNodes } from '../chunk-BS4LGGQV.js';
+import { EventCalendar } from '../chunk-CXZYC7IN.js';
+export { EventCalendar } from '../chunk-CXZYC7IN.js';
+import { ImageLightbox } from '../chunk-R3IK6EPA.js';
+export { ImageLightbox } from '../chunk-R3IK6EPA.js';
+import { InlineEdit } from '../chunk-BOSSWJTN.js';
+export { InlineEdit } from '../chunk-BOSSWJTN.js';
+import { JsonField } from '../chunk-X5X3FKCQ.js';
+export { JsonField } from '../chunk-X5X3FKCQ.js';
 import { LiveClock } from '../chunk-Z3WGIFJP.js';
 export { LiveClock } from '../chunk-Z3WGIFJP.js';
-import { OrgChart } from '../chunk-BT4HC3WR.js';
-export { OrgChart } from '../chunk-BT4HC3WR.js';
-import { PeriodFilter } from '../chunk-WJEGCCPY.js';
-export { PeriodFilter } from '../chunk-WJEGCCPY.js';
-import { PrintSheet } from '../chunk-JWYBFODH.js';
-export { PrintSheet } from '../chunk-JWYBFODH.js';
-export { AutocompleteField, toAutocompleteOptions } from '../chunk-PBGYAVQZ.js';
-import '../chunk-QIDMPWZH.js';
-import { ColumnBoard } from '../chunk-VK6KWB65.js';
-export { ColumnBoard } from '../chunk-VK6KWB65.js';
-import { DiffView } from '../chunk-4IRLQWQC.js';
-export { DiffView } from '../chunk-4IRLQWQC.js';
-import { Disclosure } from '../chunk-WLWWN5LW.js';
-export { Disclosure } from '../chunk-WLWWN5LW.js';
-import '../chunk-B5JTXYDB.js';
+import { OrgChart } from '../chunk-F2MKI3W5.js';
+export { OrgChart } from '../chunk-F2MKI3W5.js';
+import { PeriodFilter } from '../chunk-4NPTFNAL.js';
+export { PeriodFilter } from '../chunk-4NPTFNAL.js';
+import { PrintSheet } from '../chunk-5YVXVGQ2.js';
+export { PrintSheet } from '../chunk-5YVXVGQ2.js';
+export { AutocompleteField, toAutocompleteOptions } from '../chunk-6NAJ2D4A.js';
+import '../chunk-FC2F37QH.js';
+import { ColumnBoard } from '../chunk-G4QIJHEP.js';
+export { ColumnBoard } from '../chunk-G4QIJHEP.js';
+import { DiffView } from '../chunk-LN6IOMCK.js';
+export { DiffView } from '../chunk-LN6IOMCK.js';
+import { Disclosure } from '../chunk-YGSU34B3.js';
+export { Disclosure } from '../chunk-YGSU34B3.js';
+import '../chunk-LMHIRQZ6.js';
 import '../chunk-SAN4IX6N.js';
 
 // src/widgets/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipco/sdui",
-  "version": "0.13.1",
+  "version": "0.14.1",
   "description": "WIPCO 서버 주도 UI(SDUI) 렌더러 — JSON 페이지 스펙을 React 컴포넌트로 렌더링",
   "keywords": [
     "sdui",