@wipco/sdui 0.21.0 → 0.23.0

package/dist/{chunk-HPZTFZZN.js → chunk-36MXPCJP.js}

@@ -1,102 +1,9 @@
 import { useDismiss, usePopoverAnchor, usePortalTo, HoistedStyle, AnchoredPopoverStyles, anchorStyle, focusStaysInside } from './chunk-XKLUCUVA.js';
-import { Icon } from './chunk-WIDDHR7L.js';
+import { Icon, Spinner, EmptyState } from './chunk-WIDDHR7L.js';
 import { boxed } from './chunk-SAN4IX6N.js';
-import { createContext, useState, useRef, useEffect, useMemo, useCallback, useContext } from 'react';
+import { useState, useRef, useEffect, useMemo, useCallback } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
-// src/env.ts
-var DEV = (() => {
-  try {
-    const meta = import.meta;
-    return Boolean(meta.env?.DEV);
-  } catch {
-    return false;
-  }
-})();
-
-// src/adapter.ts
-function isSafeNavigationTarget(to) {
-  if (typeof to !== "string") return false;
-  const value = to.replace(/[\u0000-\u0020]/g, "");
-  if (value === "") return false;
-  if (value.startsWith("//")) return false;
-  if (value.startsWith("/") || value.startsWith("?") || value.startsWith("#")) return true;
-  return /^https?:\/\//i.test(value);
-}
-async function defaultFetch(path, init) {
-  const response = await fetch(path, {
-    method: init.method,
-    headers: { "content-type": "application/json", accept: "application/json" },
-    credentials: "include",
-    body: init.body === void 0 ? void 0 : JSON.stringify(init.body),
-    signal: init.signal
-  });
-  const text = await response.text();
-  let json = null;
-  if (text) {
-    try {
-      json = JSON.parse(text);
-    } catch {
-      json = null;
-    }
-  }
-  if (!response.ok) {
-    const message = json && typeof json === "object" && typeof json.message === "string" ? json.message : `\uC694\uCCAD\uC774 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4 (${response.status})`;
-    throw new Error(message);
-  }
-  return json;
-}
-var defaultAdapter = {
-  navigate: (to) => {
-    if (!isSafeNavigationTarget(to)) {
-      console.error(`[sdui] \uD5C8\uC6A9\uB418\uC9C0 \uC54A\uB294 navigate \uB300\uC0C1: ${String(to)}`);
-      return;
-    }
-    window.location.assign(to);
-  },
-  fetch: defaultFetch,
-  rawFetch: (path) => fetch(path, { credentials: "include" }),
-  // 항등함수. 계약을 문서화하고, 컴포넌트가 `useSduiAssetResolver()`를 조건 없이
-  // 부를 수 있게 하는 것이 전부다. **이 함수 참조 자체가 표식**이기도 하다 —
-  // `assetResolverOf`가 이것과 같은지 보고 "주입 없음"을 판정한다.
-  resolveAsset: (url) => url,
-  invalidate: (prefix) => {
-    if (DEV) console.warn(`[sdui] invalidate \uC561\uC158\uC774 \uC5B4\uB311\uD130 \uC5C6\uC774 \uD638\uCD9C\uB428 (prefix: ${prefix})`);
-  },
-  refresh: () => {
-    if (DEV) console.warn("[sdui] refresh \uC561\uC158\uC774 \uC5B4\uB311\uD130 \uC5C6\uC774 \uD638\uCD9C\uB428");
-  }
-};
-function resolveAdapter(adapter) {
-  const merged = { ...defaultAdapter };
-  if (adapter) {
-    for (const [key, value] of Object.entries(adapter)) {
-      if (value !== void 0) merged[key] = value;
-    }
-  }
-  return merged;
-}
-var SduiAdapterContext = createContext(null);
-function useSduiAdapter() {
-  return useContext(SduiAdapterContext);
-}
-function assetResolverOf(adapter) {
-  const resolve = adapter?.resolveAsset;
-  if (!resolve || resolve === defaultAdapter.resolveAsset) return null;
-  return resolve;
-}
-function useSduiAssetResolver() {
-  const adapter = useContext(SduiAdapterContext);
-  return adapter?.resolveAsset ?? defaultAdapter.resolveAsset;
-}
-function useSduiSandbox() {
-  return useContext(SduiAdapterContext)?.sandbox === true;
-}
-function hostFetchOf(adapter) {
-  const hostFetch = adapter?.fetch;
-  if (!hostFetch || hostFetch === defaultAdapter.fetch) return null;
-  return hostFetch;
-}
 var HM_RE = /^\d{2}:\d{2}$/;
 var LIST_HEIGHT = 260;
 var MINUTES_PER_DAY = 24 * 60;
@@ -287,5 +194,66 @@ 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 { DEV, SduiAdapterContext, TimePicker, assetResolverOf, defaultAdapter, hostFetchOf, isSafeNavigationTarget, resolveAdapter, useSduiAdapter, useSduiAssetResolver, useSduiSandbox };
+export { DependencyPlaceholder, TimePicker, loadOptionalModule, useOptionalModule };

package/dist/chunk-DVOPZFQS.js

@@ -0,0 +1,100 @@
+import { createContext, useContext } from 'react';
+
+// src/adapter.ts
+
+// src/env.ts
+var DEV = (() => {
+  try {
+    const meta = import.meta;
+    return Boolean(meta.env?.DEV);
+  } catch {
+    return false;
+  }
+})();
+
+// src/adapter.ts
+function isSafeNavigationTarget(to) {
+  if (typeof to !== "string") return false;
+  const value = to.replace(/[\u0000-\u0020]/g, "");
+  if (value === "") return false;
+  if (value.startsWith("//")) return false;
+  if (value.startsWith("/") || value.startsWith("?") || value.startsWith("#")) return true;
+  return /^https?:\/\//i.test(value);
+}
+async function defaultFetch(path, init) {
+  const response = await fetch(path, {
+    method: init.method,
+    headers: { "content-type": "application/json", accept: "application/json" },
+    credentials: "include",
+    body: init.body === void 0 ? void 0 : JSON.stringify(init.body),
+    signal: init.signal
+  });
+  const text = await response.text();
+  let json = null;
+  if (text) {
+    try {
+      json = JSON.parse(text);
+    } catch {
+      json = null;
+    }
+  }
+  if (!response.ok) {
+    const message = json && typeof json === "object" && typeof json.message === "string" ? json.message : `\uC694\uCCAD\uC774 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4 (${response.status})`;
+    throw new Error(message);
+  }
+  return json;
+}
+var defaultAdapter = {
+  navigate: (to) => {
+    if (!isSafeNavigationTarget(to)) {
+      console.error(`[sdui] \uD5C8\uC6A9\uB418\uC9C0 \uC54A\uB294 navigate \uB300\uC0C1: ${String(to)}`);
+      return;
+    }
+    window.location.assign(to);
+  },
+  fetch: defaultFetch,
+  // init을 반드시 흘린다 — 버리면 드롭인 소비자의 업로드가 본문 없는 GET이 된다.
+  rawFetch: (path, init) => fetch(path, { credentials: "include", ...init }),
+  // 항등함수. 계약을 문서화하고, 컴포넌트가 `useSduiAssetResolver()`를 조건 없이
+  // 부를 수 있게 하는 것이 전부다. **이 함수 참조 자체가 표식**이기도 하다 —
+  // `assetResolverOf`가 이것과 같은지 보고 "주입 없음"을 판정한다.
+  resolveAsset: (url) => url,
+  invalidate: (prefix) => {
+    if (DEV) console.warn(`[sdui] invalidate \uC561\uC158\uC774 \uC5B4\uB311\uD130 \uC5C6\uC774 \uD638\uCD9C\uB428 (prefix: ${prefix})`);
+  },
+  refresh: () => {
+    if (DEV) console.warn("[sdui] refresh \uC561\uC158\uC774 \uC5B4\uB311\uD130 \uC5C6\uC774 \uD638\uCD9C\uB428");
+  }
+};
+function resolveAdapter(adapter) {
+  const merged = { ...defaultAdapter };
+  if (adapter) {
+    for (const [key, value] of Object.entries(adapter)) {
+      if (value !== void 0) merged[key] = value;
+    }
+  }
+  return merged;
+}
+var SduiAdapterContext = createContext(null);
+function useSduiAdapter() {
+  return useContext(SduiAdapterContext);
+}
+function assetResolverOf(adapter) {
+  const resolve = adapter?.resolveAsset;
+  if (!resolve || resolve === defaultAdapter.resolveAsset) return null;
+  return resolve;
+}
+function useSduiAssetResolver() {
+  const adapter = useContext(SduiAdapterContext);
+  return adapter?.resolveAsset ?? defaultAdapter.resolveAsset;
+}
+function useSduiSandbox() {
+  return useContext(SduiAdapterContext)?.sandbox === true;
+}
+function hostFetchOf(adapter) {
+  const hostFetch = adapter?.fetch;
+  if (!hostFetch || hostFetch === defaultAdapter.fetch) return null;
+  return hostFetch;
+}
+
+export { DEV, SduiAdapterContext, assetResolverOf, defaultAdapter, hostFetchOf, isSafeNavigationTarget, resolveAdapter, useSduiAdapter, useSduiAssetResolver, useSduiSandbox };

package/dist/{chunk-SRGXODY2.js → chunk-OG62LSFH.js}

@@ -1,9 +1,24 @@
 import { includesLooseSearch } from './chunk-U7ZK7WYH.js';
+import { useSduiAdapter, hostFetchOf } from './chunk-DVOPZFQS.js';
 import { Icon, Button, Input, Spinner } from './chunk-WIDDHR7L.js';
 import { boxed } from './chunk-SAN4IX6N.js';
-import { useId, useRef, useState, useEffect, useMemo } from 'react';
+import { useId, useRef, useMemo, useState, useEffect } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
+function endpointSearchFn(endpoint, searchParam, hostFetch) {
+  return async (keyword, signal) => {
+    const sep = endpoint.includes("?") ? "&" : "?";
+    const url = `${endpoint}${sep}${searchParam}=${encodeURIComponent(keyword)}`;
+    try {
+      return toAutocompleteOptions(await hostFetch(url, { method: "GET", signal }));
+    } catch (error) {
+      if (error?.status === 503) {
+        return { options: [], status: "offline" };
+      }
+      throw error;
+    }
+  };
+}
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -34,6 +49,8 @@ var statusRowStyle = {
 };
 function AutocompleteFieldImpl({
   search,
+  endpoint,
+  searchParam = "q",
   options,
   labelKey = "label",
   valueKey = "value",
@@ -52,9 +69,17 @@ function AutocompleteFieldImpl({
   const seqRef = useRef(0);
   const optionsRef = useRef(options);
   optionsRef.current = options;
-  const searchRef = useRef(search);
-  searchRef.current = search;
-  const hasSearch = search !== void 0;
+  const adapter = useSduiAdapter();
+  const endpointSearch = useMemo(() => {
+    if (!endpoint) return void 0;
+    const hostFetch = hostFetchOf(adapter);
+    if (!hostFetch) return void 0;
+    return endpointSearchFn(endpoint, searchParam, hostFetch);
+  }, [endpoint, searchParam, adapter]);
+  const effectiveSearch = search ?? endpointSearch;
+  const searchRef = useRef(effectiveSearch);
+  searchRef.current = effectiveSearch;
+  const hasSearch = effectiveSearch !== void 0;
   const isControlled = value !== void 0;
   const [internalValue, setInternalValue] = useState("");
   const committed = (isControlled ? value : internalValue) ?? "";
@@ -298,4 +323,4 @@ function AutocompleteFieldImpl({
 }
 var AutocompleteField = boxed(AutocompleteFieldImpl, "AutocompleteField");
 
-export { AutocompleteField, toAutocompleteOptions };
+export { AutocompleteField, endpointSearchFn, toAutocompleteOptions };

package/dist/chunk-ZTQEP3TR.js

@@ -0,0 +1,211 @@
+import { Icon, Badge, Tooltip } from './chunk-WIDDHR7L.js';
+import { boxed } from './chunk-SAN4IX6N.js';
+import React from 'react';
+import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
+
+var STATUS_META = {
+  approved: {
+    icon: "check",
+    label: "\uC2B9\uC778",
+    bg: "var(--wp-status-success-bg)",
+    border: "var(--wp-status-success-border)",
+    fg: "var(--wp-status-success-fg)"
+  },
+  rejected: {
+    icon: "x",
+    label: "\uBC18\uB824",
+    bg: "var(--wp-status-danger-bg)",
+    border: "var(--wp-status-danger-border)",
+    fg: "var(--wp-status-danger-fg)"
+  },
+  skipped: {
+    icon: "minus",
+    label: "\uAC74\uB108\uB700",
+    bg: "var(--wp-status-neutral-bg)",
+    border: "var(--wp-status-neutral-border)",
+    fg: "var(--wp-status-neutral-fg)"
+  },
+  current: {
+    icon: "circle-dot",
+    label: "\uC9C4\uD589 \uC911",
+    bg: "var(--wp-surface-brand-tint)",
+    border: "var(--wp-border-brand)",
+    fg: "var(--wp-text-brand)"
+  },
+  pending: {
+    icon: "circle-dot",
+    label: "\uB300\uAE30",
+    bg: "var(--wp-surface-card)",
+    border: "var(--wp-border-subtle)",
+    fg: "var(--wp-text-muted)"
+  }
+};
+function stepTitle(step, index, typeLabels) {
+  const name = step.name?.trim();
+  if (name) return name;
+  if (step.type) return typeLabels?.[step.type] ?? step.type;
+  return `${index + 1}\uB2E8\uACC4`;
+}
+function formatDateTime(value) {
+  const time = Date.parse(value);
+  if (Number.isNaN(time)) return value;
+  const date = new Date(time);
+  const pad = (part) => String(part).padStart(2, "0");
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+var circleStyle = (bg, border, fg, ring) => ({
+  display: "inline-flex",
+  alignItems: "center",
+  justifyContent: "center",
+  width: 32,
+  height: 32,
+  flex: "none",
+  borderRadius: "var(--wp-radius-pill)",
+  background: bg,
+  border: `var(--wp-border-w) solid ${border}`,
+  color: fg,
+  boxShadow: ring ? "var(--wp-ring-selected)" : void 0
+});
+var nodeStyle = {
+  display: "flex",
+  flexDirection: "column",
+  alignItems: "center",
+  gap: "var(--wp-space-1)",
+  flex: "none",
+  minWidth: 88,
+  maxWidth: 140,
+  padding: "var(--wp-space-1)"
+};
+var nodeTextStyle = {
+  display: "block",
+  maxWidth: "100%",
+  overflow: "hidden",
+  textOverflow: "ellipsis",
+  whiteSpace: "nowrap",
+  textAlign: "center"
+};
+var connectorStyle = {
+  flex: "none",
+  width: "var(--wp-space-6)",
+  height: 0,
+  borderTop: "var(--wp-border-w) solid var(--wp-divider)",
+  // 원(32px) 세로 중앙에 맞춘다: 노드 padding(space-1) + 16px
+  marginTop: "calc(var(--wp-space-1) + 16px)"
+};
+function stepTooltip(step, index, typeLabels) {
+  const meta = STATUS_META[step.status ?? "pending"];
+  const lines = [`${stepTitle(step, index, typeLabels)} \u2014 ${meta.label}`];
+  if (step.approver) lines.push(`\uCC98\uB9AC\uC790: ${step.approver}`);
+  if (step.processedAt) lines.push(`\uCC98\uB9AC \uC77C\uC2DC: ${formatDateTime(step.processedAt)}`);
+  if (step.candidates && step.candidates.length > 0) {
+    lines.push(`\uACB0\uC7AC \uD6C4\uBCF4: ${step.candidates.join(", ")}`);
+  }
+  return /* @__PURE__ */ jsx(Fragment, { children: lines.map((line) => /* @__PURE__ */ jsx("span", { style: { display: "block" }, children: line }, line)) });
+}
+function ApprovalStepperImpl({
+  requester,
+  steps,
+  onStepClick,
+  typeLabels
+}) {
+  const safeSteps = steps ?? [];
+  const clickable = typeof onStepClick === "function";
+  const requesterNode = requester ? /* @__PURE__ */ jsxs("div", { style: nodeStyle, children: [
+    /* @__PURE__ */ jsx(
+      "span",
+      {
+        style: circleStyle(
+          "var(--wp-surface-sunken)",
+          "var(--wp-border-subtle)",
+          "var(--wp-text-muted)",
+          false
+        ),
+        children: /* @__PURE__ */ jsx(Icon, { name: "user", size: 16 })
+      }
+    ),
+    /* @__PURE__ */ jsx("span", { className: "wp-body-sm", style: { ...nodeTextStyle, color: "var(--wp-text-strong)" }, children: requester.name }),
+    /* @__PURE__ */ jsx("span", { className: "wp-caption", style: nodeTextStyle, children: requester.sub?.trim() || "\uC2E0\uCCAD\uC790" })
+  ] }) : null;
+  if (safeSteps.length === 0) {
+    return /* @__PURE__ */ jsxs("div", { className: "wp-row", style: { overflowX: "auto", paddingBottom: "var(--wp-space-1)" }, children: [
+      requesterNode,
+      requesterNode ? /* @__PURE__ */ jsx("span", { "aria-hidden": true, style: connectorStyle }) : null,
+      /* @__PURE__ */ jsxs("div", { style: nodeStyle, children: [
+        /* @__PURE__ */ jsxs(Badge, { tone: "success", size: "lg", children: [
+          /* @__PURE__ */ jsx(Icon, { name: "check-check", size: 14, style: { marginRight: "var(--wp-space-1)" } }),
+          "\uC790\uB3D9 \uC2B9\uC778"
+        ] }),
+        /* @__PURE__ */ jsx("span", { className: "wp-caption", style: { textAlign: "center", whiteSpace: "nowrap" }, children: "\uACB0\uC7AC \uB2E8\uACC4\uAC00 \uC5C6\uC5B4 \uC790\uB3D9\uC73C\uB85C \uC2B9\uC778\uB429\uB2C8\uB2E4" })
+      ] })
+    ] });
+  }
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: "wp-row",
+      role: "list",
+      "aria-label": "\uACB0\uC7AC \uC9C4\uD589 \uB2E8\uACC4",
+      style: {
+        alignItems: "flex-start",
+        gap: 0,
+        overflowX: "auto",
+        paddingBottom: "var(--wp-space-1)"
+      },
+      children: [
+        requesterNode,
+        safeSteps.map((step, index) => {
+          const status = step.status ?? "pending";
+          const meta = STATUS_META[status];
+          const body = /* @__PURE__ */ jsxs(Fragment, { children: [
+            /* @__PURE__ */ jsx("span", { style: circleStyle(meta.bg, meta.border, meta.fg, status === "current"), children: /* @__PURE__ */ jsx(Icon, { name: meta.icon, size: 16 }) }),
+            /* @__PURE__ */ jsx(
+              "span",
+              {
+                className: "wp-body-sm",
+                style: {
+                  ...nodeTextStyle,
+                  color: status === "skipped" ? "var(--wp-text-muted)" : "var(--wp-text-strong)"
+                },
+                children: stepTitle(step, index, typeLabels)
+              }
+            ),
+            /* @__PURE__ */ jsx(
+              "span",
+              {
+                className: "wp-caption",
+                style: {
+                  ...nodeTextStyle,
+                  color: status === "rejected" ? "var(--wp-text-danger)" : status === "current" ? "var(--wp-text-brand)" : void 0
+                },
+                children: step.approver?.trim() || meta.label
+              }
+            )
+          ] });
+          return /* @__PURE__ */ jsxs(React.Fragment, { children: [
+            (requesterNode || index > 0) && /* @__PURE__ */ jsx("span", { "aria-hidden": true, style: connectorStyle }),
+            /* @__PURE__ */ jsx(Tooltip, { label: stepTooltip(step, index, typeLabels), wrap: true, placement: "top", children: clickable ? /* @__PURE__ */ jsx(
+              "button",
+              {
+                type: "button",
+                role: "listitem",
+                onClick: () => onStepClick?.(step),
+                style: {
+                  ...nodeStyle,
+                  background: "none",
+                  border: 0,
+                  font: "inherit",
+                  cursor: "pointer",
+                  borderRadius: "var(--wp-radius-sm)"
+                },
+                children: body
+              }
+            ) : /* @__PURE__ */ jsx("div", { role: "listitem", style: nodeStyle, children: body }) })
+          ] }, step.id);
+        })
+      ]
+    }
+  );
+}
+var ApprovalStepper = boxed(ApprovalStepperImpl, "ApprovalStepper");
+
+export { ApprovalStepper };

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 SduiPage, a as SduiAction, b as SduiPropValue, c as SduiRule } from './types-opTPYysN.js';
-export { d as SduiArgRef, e as SduiCalcRef, f as SduiChild, g as SduiIndexRef, h as SduiItemRef, i as SduiNode, j as SduiPageQuery, k as SduiScalar, l as SduiStateRef } from './types-opTPYysN.js';
+import { S as SduiPage, a as SduiAction, b as SduiPropValue, c as SduiRule } from './types-DmHC7HCN.js';
+export { d as SduiArgRef, e as SduiCalcRef, f as SduiChild, g as SduiIndexRef, h as SduiItemRef, i as SduiNode, j as SduiPageQuery, k as SduiScalar, l as SduiStateRef } from './types-DmHC7HCN.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, T as TimePickerProps } from './DatePicker-D2EtpvkQ.js';
@@ -19,6 +19,11 @@ interface SduiAdapter {
      * submitForm 등 JSON API 호출. 성공 시 응답 JSON을, 실패 시
      * Error(사용자에게 보여줄 메시지)를 던진다.
      *
+     * 던지는 오류에 **`status`(HTTP 상태)와 `body`(파싱된 응답 본문)를 얹어도 된다.**
+     * 필수는 아니지만, 얹으면 스펙이 상태 코드로 갈라 쓸 수 있다(`request` 액션의
+     * `errorKey` 참고 — 409의 위반 목록을 화면에 그리는 것이 그 자리다). 라이브러리는
+     * 있으면 읽고 없으면 메시지만 쓴다 — 특정 앱의 오류 타입을 알지 않는다.
+     *
      * `signal`은 호출부가 중단할 수 있는 조회(목록 재조회 등)에서만 넘어온다 —
      * 선택 사항이라 무시해도 계약은 성립하지만, 넘겨받은 호스트는 자기 클라이언트에
      * 그대로 흘려 보내면 파라미터가 바뀔 때 이전 요청이 실제로 끊긴다.
@@ -28,8 +33,25 @@ interface SduiAdapter {
         body?: unknown;
         signal?: AbortSignal;
     }) => Promise<unknown>;
-    /** download 액션용 원시 fetch. 기본: fetch(path, { credentials: 'include' }) */
-    rawFetch?: (path: string) => Promise<Response>;
+    /**
+     * 원시 fetch — **직렬화하지 않는 통로**다. `fetch`가 본문을 JSON으로 굳혀 보내는 것과
+     * 정반대이고, 그 차이가 이 항목의 존재 이유다: 업로드의 `FormData`는 경계 문자열
+     * (boundary)을 브라우저가 붙여야 하는데 `JSON.stringify`를 태우면 `"{}"`가 된다.
+     *
+     * `init`을 받는다. 예전에는 경로 하나만 받아 download 액션의 GET만 낼 수 있었고,
+     * multipart POST나 DELETE를 실을 자리가 없었다.
+     *
+     * ⚠ **호스트 구현을 1인자로 남겨 두면 안 된다.** `(path) => myFetch(path)`처럼 쓰면
+     * 타입은 통과하는데 `init`이 조용히 버려져 POST가 본문 없는 GET으로 나간다.
+     * 타입 검사로도 {@link hostRawFetchOf}로도 잡히지 않는 자리라 여기 적어 둔다.
+     */
+    rawFetch?: (path: string, init?: {
+        method?: string;
+        /** 직렬화하지 않고 그대로 흘린다 — FormData·Blob·string 전부 가능. */
+        body?: BodyInit;
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+    }) => Promise<Response>;
     /** invalidate 액션 — 클라이언트 조회 캐시 무효화 (TanStack Query 등) */
     invalidate?: (prefix: string, exact: boolean) => void;
     /** refresh 액션 — 페이지 스펙 재조회 */
@@ -1677,6 +1699,23 @@ interface SduiRendererProps {
  */
 declare function SduiRenderer({ page, registry, adapter, syncUrlState, initialState, can, onCustomAction, customValidators, }: SduiRendererProps): React__default.JSX.Element;
 
+/**
+ * 어휘 전체. **렌더러와 편집기 검증기가 같은 이 집합을 본다** — 목록이 두 벌이면
+ * 한쪽에만 연산을 더했을 때 "렌더는 되는데 저장이 거부되는" 스펙이 생긴다.
+ */
+declare const CALC_OPS: ReadonlySet<string>;
+
+/**
+ * 선택적 peer 의존성(recharts · ol)을 런타임에 끌어오는 공용 장치.
+ *
+ * 이 진입점(@wipco/sdui/rich)의 위젯은 무거운 라이브러리를 쓰지만, 그 라이브러리는
+ * optional peerDependency다 — 안 깔려 있어도 렌더가 죽으면 안 된다. 그래서
+ * 모듈은 동적 import로만 만지고, 로드에 실패하면 예외를 그대로 흘리지 않고
+ * "무엇을 설치해야 하는지" 알려주는 플레이스홀더로 떨어진다.
+ */
+
+declare function loadOptionalModule<T>(load: () => Promise<T>, packageName: string): Promise<T>;
+
 /**
  * 스펙 구조 검증기 — 서버(또는 편집기)가 만든 스펙의 형태 오류를 렌더 전에 찾아낸다.
  * 렌더러는 개발 모드에서 이 결과를 콘솔에 경고하고, 관리자 편집기는
@@ -1831,4 +1870,4 @@ interface ImageViewerProps {
  */
 declare function ImageViewer({ src, alt, open, onClose }: ImageViewerProps): React__default.ReactPortal | null;
 
-export { Actions, type ActionsProps, Alert, type AlertProps, Avatar, type AvatarProps, Badge, type BadgeProps, type BadgeTone, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonProps, Can, type CanProps, Card, type CardProps, type CascadingSearchOption, Checkbox, type CheckboxProps, Col, type ColProps, type CustomActionHandler, type CustomValidator, DatePickerProps, DateRangePickerProps, Dialog, type DialogProps, Divider, EmptyState, type EmptyStateProps, Field, type FieldProps, Grid, type GridCardConfig, type GridCardRow, type GridProps, Icon, IconButton, type IconButtonProps, type IconProps, ImageViewer, type ImageViewerProps, Input, type InputProps, type Justify, type KeyValueItem, KeyValueList, type KeyValueListProps, type MeterTone, NodeErrorBoundary, OverlayContainerContext, OverlayLayer, PageHead, type PageHeadProps, Pagination, type PaginationProps, ProgressBar, type ProgressBarProps, Radio, type RadioProps, RemoteSearchResults, type RemoteSearchResultsProps, ResultTable, type ResultTableColumn, type ResultTableProps, Row, type RowProps, SduiAction, type SduiAdapter, type SduiAssetContext, type SduiAssetResolver, type SduiBadgeCell, SduiBoxProps, type SduiCanFn, type SduiCanQuery, type SduiCanSetting, type SduiCell, SduiColumnsScale, SduiContainerLayoutProps, type SduiDateCell, SduiDialog, type SduiDispatch, SduiForm, type SduiFormConfig, type SduiFormProps, SduiGapScale, type SduiGridCard, type SduiGridCardAction, type SduiGridCardRow, type SduiIconCell, type SduiImageCell, type SduiLinkCell, type SduiNumberCell, SduiPage, SduiPermissionProvider, type SduiProgressCell, SduiPropValue, type SduiRegistry, SduiRenderer, type SduiRendererProps, type SduiRowCondition, SduiRule, type SduiRuntime, type SduiSearchAction, type SduiSearchColumn, SduiSearchDataProvider, SduiSearchResults, type SduiSearchResultsProps, type SduiTagCell, SduiTextAlignScale, type SduiTextCell, type SduiUseSpec, SduiWeightScale, type SearchAction, type SearchColumn, type SearchFetcher, type SearchField, type SearchFilter, type SearchOption, type SearchPage, SearchResults, type SearchResultsProps, type SearchRow, SearchToolbar, type SearchValues, type SearchViewItem, Section, type SectionProps, SegmentedControl, type SegmentedControlProps, type SegmentedItem, Select, type SelectOption, type SelectOptionRecord, type SelectProps, Show, type ShowProps, SidebarNav, type SidebarNavItem, type SidebarNavProps, type SidebarNavSection, type SortDir, SortHandle, type SortHandleProps, SortableList, type SortableListProps, Spacer, type SpacerProps, type SpecIssue, Spinner, type SpinnerProps, StatCard, type StatCardProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TableProps, Tabs, type TabsProps, Tag, type TagProps, Text, type TextPreset, type TextProps, Textarea, type TextareaProps, TimePickerProps, Toast, type ToastProps, Tooltip, type TooltipProps, boxed, cascadingValuePaths, cellRenderer, cleanSearchValues, createRegistry, defaultAdapter, defaultRegistry, getOverlayRoot, imageRenderer, includesLooseSearch, joinMultiValue, normalizePageSizes, normalizeSearchText, searchFieldKeys, searchValuesFromParams, sortableDropIndex, sortableMove, splitMultiValue, useOverlayLayer, useRemoteSearchPage, useSduiAssetResolver, useSduiCan, useSduiDispatch, useSduiRuntime, useSduiSandbox, useSearchFetcher, validateSpec };
+export { Actions, type ActionsProps, Alert, type AlertProps, Avatar, type AvatarProps, Badge, type BadgeProps, type BadgeTone, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonProps, CALC_OPS, Can, type CanProps, Card, type CardProps, type CascadingSearchOption, Checkbox, type CheckboxProps, Col, type ColProps, type CustomActionHandler, type CustomValidator, DatePickerProps, DateRangePickerProps, Dialog, type DialogProps, Divider, EmptyState, type EmptyStateProps, Field, type FieldProps, Grid, type GridCardConfig, type GridCardRow, type GridProps, Icon, IconButton, type IconButtonProps, type IconProps, ImageViewer, type ImageViewerProps, Input, type InputProps, type Justify, type KeyValueItem, KeyValueList, type KeyValueListProps, type MeterTone, NodeErrorBoundary, OverlayContainerContext, OverlayLayer, PageHead, type PageHeadProps, Pagination, type PaginationProps, ProgressBar, type ProgressBarProps, Radio, type RadioProps, RemoteSearchResults, type RemoteSearchResultsProps, ResultTable, type ResultTableColumn, type ResultTableProps, Row, type RowProps, SduiAction, type SduiAdapter, type SduiAssetContext, type SduiAssetResolver, type SduiBadgeCell, SduiBoxProps, type SduiCanFn, type SduiCanQuery, type SduiCanSetting, type SduiCell, SduiColumnsScale, SduiContainerLayoutProps, type SduiDateCell, SduiDialog, type SduiDispatch, SduiForm, type SduiFormConfig, type SduiFormProps, SduiGapScale, type SduiGridCard, type SduiGridCardAction, type SduiGridCardRow, type SduiIconCell, type SduiImageCell, type SduiLinkCell, type SduiNumberCell, SduiPage, SduiPermissionProvider, type SduiProgressCell, SduiPropValue, type SduiRegistry, SduiRenderer, type SduiRendererProps, type SduiRowCondition, SduiRule, type SduiRuntime, type SduiSearchAction, type SduiSearchColumn, SduiSearchDataProvider, SduiSearchResults, type SduiSearchResultsProps, type SduiTagCell, SduiTextAlignScale, type SduiTextCell, type SduiUseSpec, SduiWeightScale, type SearchAction, type SearchColumn, type SearchFetcher, type SearchField, type SearchFilter, type SearchOption, type SearchPage, SearchResults, type SearchResultsProps, type SearchRow, SearchToolbar, type SearchValues, type SearchViewItem, Section, type SectionProps, SegmentedControl, type SegmentedControlProps, type SegmentedItem, Select, type SelectOption, type SelectOptionRecord, type SelectProps, Show, type ShowProps, SidebarNav, type SidebarNavItem, type SidebarNavProps, type SidebarNavSection, type SortDir, SortHandle, type SortHandleProps, SortableList, type SortableListProps, Spacer, type SpacerProps, type SpecIssue, Spinner, type SpinnerProps, StatCard, type StatCardProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TableProps, Tabs, type TabsProps, Tag, type TagProps, Text, type TextPreset, type TextProps, Textarea, type TextareaProps, TimePickerProps, Toast, type ToastProps, Tooltip, type TooltipProps, boxed, cascadingValuePaths, cellRenderer, cleanSearchValues, createRegistry, defaultAdapter, defaultRegistry, getOverlayRoot, imageRenderer, includesLooseSearch, joinMultiValue, loadOptionalModule, normalizePageSizes, normalizeSearchText, searchFieldKeys, searchValuesFromParams, sortableDropIndex, sortableMove, splitMultiValue, useOverlayLayer, useRemoteSearchPage, useSduiAssetResolver, useSduiCan, useSduiDispatch, useSduiRuntime, useSduiSandbox, useSearchFetcher, validateSpec };