@wipco/sdui 0.21.0 → 0.23.0

package/dist/index.js

@@ -1,9 +1,11 @@
-import { DEV, isSafeNavigationTarget, useSduiAdapter, hostFetchOf, TimePicker, useSduiSandbox, resolveAdapter, assetResolverOf, SduiAdapterContext } from './chunk-HPZTFZZN.js';
-export { TimePicker, defaultAdapter, useSduiAssetResolver, useSduiSandbox } from './chunk-HPZTFZZN.js';
+import { TimePicker } from './chunk-36MXPCJP.js';
+export { TimePicker, loadOptionalModule } from './chunk-36MXPCJP.js';
 import { ImageViewer } from './chunk-THEP3VWY.js';
 export { ImageViewer } from './chunk-THEP3VWY.js';
 import { normalizeSearchFields, searchValuesFromParams, splitMultiValue, includesLooseSearch, cascadingValuePaths, SearchToolbar, searchFieldKeys, Popover } from './chunk-U7ZK7WYH.js';
 export { SearchToolbar, cascadingValuePaths, cleanSearchValues, includesLooseSearch, joinMultiValue, normalizeSearchText, searchFieldKeys, searchValuesFromParams, splitMultiValue } from './chunk-U7ZK7WYH.js';
+import { DEV, isSafeNavigationTarget, useSduiAdapter, hostFetchOf, useSduiSandbox, resolveAdapter, assetResolverOf, SduiAdapterContext } from './chunk-DVOPZFQS.js';
+export { defaultAdapter, useSduiAssetResolver, useSduiSandbox } from './chunk-DVOPZFQS.js';
 import { HoistedStyle, DateRangePicker, DatePicker, OverlayLayer } from './chunk-XKLUCUVA.js';
 export { DatePicker, DateRangePicker, OverlayContainerContext, OverlayLayer, getOverlayRoot, useOverlayLayer } from './chunk-XKLUCUVA.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-WIDDHR7L.js';
@@ -1783,6 +1785,310 @@ function createRegistry(extensions) {
   return { ...defaultRegistry, ...extensions };
 }
 
+// src/calc.ts
+function isPlainObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function toNumber2(v) {
+  if (typeof v === "number") return v;
+  if (typeof v === "string") {
+    const n = Number(v.replace(/,/g, ""));
+    return Number.isFinite(n) ? n : 0;
+  }
+  return 0;
+}
+function isNumericText(v) {
+  if (typeof v === "number") return true;
+  if (typeof v !== "string" || v === "") return false;
+  return Number.isFinite(Number(v.replace(/,/g, "")));
+}
+function orderingCompare(a, b) {
+  if (typeof a === "string" && typeof b === "string" && !isNumericText(a) && !isNumericText(b)) {
+    return a < b ? -1 : a > b ? 1 : 0;
+  }
+  const x = toNumber2(a);
+  const y = toNumber2(b);
+  return x < y ? -1 : x > y ? 1 : 0;
+}
+function looseEquals(a, b) {
+  return String(a ?? "") === String(b ?? "");
+}
+function isBlank(v) {
+  return v === null || v === void 0 || v === "";
+}
+function fieldOf(row, field) {
+  if (!field) return row;
+  if (!isPlainObject(row)) return void 0;
+  return Object.hasOwn(row, field) ? row[field] : void 0;
+}
+var FIELD_OPS = /* @__PURE__ */ new Set([
+  "eq",
+  "ne",
+  "gt",
+  "gte",
+  "lt",
+  "lte",
+  "in",
+  "notIn",
+  "contains",
+  "startsWith",
+  "endsWith",
+  "isNull"
+]);
+function isFieldOpObject(v) {
+  return isPlainObject(v) && Object.keys(v).some((key) => FIELD_OPS.has(key));
+}
+function matchesFieldOps(actual, ops, resolve) {
+  return Object.entries(ops).every(([op, rawExpected]) => {
+    if (!FIELD_OPS.has(op)) return true;
+    const expected = resolve(rawExpected);
+    switch (op) {
+      case "eq":
+        return looseEquals(actual, expected);
+      case "ne":
+        return !looseEquals(actual, expected);
+      case "gt":
+        return orderingCompare(actual, expected) > 0;
+      case "gte":
+        return orderingCompare(actual, expected) >= 0;
+      case "lt":
+        return orderingCompare(actual, expected) < 0;
+      case "lte":
+        return orderingCompare(actual, expected) <= 0;
+      case "in":
+        return Array.isArray(expected) && expected.some((item) => looseEquals(actual, item));
+      case "notIn":
+        return !Array.isArray(expected) || !expected.some((item) => looseEquals(actual, item));
+      case "contains":
+        return String(actual ?? "").includes(String(expected ?? ""));
+      case "startsWith":
+        return String(actual ?? "").startsWith(String(expected ?? ""));
+      case "endsWith":
+        return String(actual ?? "").endsWith(String(expected ?? ""));
+      case "isNull":
+        return isBlank(actual) === Boolean(expected);
+      default:
+        return true;
+    }
+  });
+}
+function matchesWhere(row, where, resolve) {
+  if (!isPlainObject(where)) return true;
+  return Object.entries(where).every(([key, condition]) => {
+    if (key === "AND") {
+      return Array.isArray(condition) && condition.every((sub) => matchesWhere(row, sub, resolve));
+    }
+    if (key === "OR") {
+      return Array.isArray(condition) && condition.some((sub) => matchesWhere(row, sub, resolve));
+    }
+    if (key === "NOT") {
+      return !matchesWhere(row, condition, resolve);
+    }
+    const actual = fieldOf(row, key);
+    if (isFieldOpObject(condition)) return matchesFieldOps(actual, condition, resolve);
+    return looseEquals(actual, resolve(condition));
+  });
+}
+var CALC_OPS = /* @__PURE__ */ new Set([
+  // 산술 (기존)
+  "sum",
+  "sub",
+  "mul",
+  "div",
+  "percent",
+  "count",
+  // 문자 (기존)
+  "concat",
+  "encode",
+  // 비교·논리 (기존)
+  "eq",
+  "gt",
+  "gte",
+  "lt",
+  "lte",
+  "not",
+  // 논리 (신규) — 예전에는 스펙이 eq(concat(eq(a),eq(b)),"falsefalse")로 우회했다
+  "and",
+  "or",
+  // 값 고르기 (신규)
+  "if",
+  "match",
+  "coalesce",
+  // 목록·객체 (신규)
+  "get",
+  "pluck",
+  "filter",
+  "some",
+  "every",
+  "includes",
+  "distinct",
+  "except",
+  "entries",
+  "length",
+  "join",
+  "split",
+  "sortBy"
+]);
+function evaluateCalc(calc, resolved, resolve) {
+  const op = typeof calc.op === "string" ? calc.op : "";
+  const field = typeof calc.field === "string" ? calc.field : void 0;
+  const first = resolved[0];
+  const list = Array.isArray(first) ? first : void 0;
+  const listOrEmpty = () => {
+    if (list) return list;
+    if (first !== void 0 && first !== null) {
+      warnOnce(
+        `calc:${op}:list`,
+        `[sdui] $calc(${op}): \uCCAB \uC778\uC790\uAC00 \uBC30\uC5F4\uC774 \uC544\uB2D9\uB2C8\uB2E4 \u2014 \uBE48 \uBAA9\uB85D\uC73C\uB85C \uCC98\uB9AC\uD569\uB2C8\uB2E4`
+      );
+    }
+    return [];
+  };
+  const nums = (v) => {
+    if (Array.isArray(v))
+      return v.map((row) => field && isPlainObject(row) ? toNumber2(row[field]) : toNumber2(row));
+    return [toNumber2(v)];
+  };
+  switch (op) {
+    /* ── 산술 ── */
+    case "sum":
+      return resolved.flatMap(nums).reduce((a, b) => a + b, 0);
+    case "count":
+      return resolved.reduce(
+        (a, v) => a + (Array.isArray(v) ? v.length : v == null ? 0 : 1),
+        0
+      );
+    case "sub": {
+      const items = resolved.map((v) => toNumber2(v));
+      return items.length === 0 ? 0 : items.reduce((a, b) => a - b);
+    }
+    case "mul":
+      return resolved.map((v) => toNumber2(v)).reduce((a, b) => a * b, 1);
+    case "div": {
+      const [a, b] = resolved.map((v) => toNumber2(v));
+      return b === 0 ? 0 : a / b;
+    }
+    case "percent": {
+      const [a, b] = resolved.map((v) => toNumber2(v));
+      return b === 0 ? 0 : Math.round(a / b * 1e3) / 10;
+    }
+    /* ── 문자 ── */
+    case "concat":
+      return resolved.map((v) => v == null ? "" : String(v)).join("");
+    case "encode":
+      return encodeURIComponent(resolved.map((v) => v == null ? "" : String(v)).join(""));
+    /* ── 비교·논리 ── */
+    case "eq":
+      return looseEquals(resolved[0], resolved[1]);
+    case "gt":
+      return orderingCompare(resolved[0], resolved[1]) > 0;
+    case "gte":
+      return orderingCompare(resolved[0], resolved[1]) >= 0;
+    case "lt":
+      return orderingCompare(resolved[0], resolved[1]) < 0;
+    case "lte":
+      return orderingCompare(resolved[0], resolved[1]) <= 0;
+    case "not":
+      return !resolved[0];
+    case "and":
+      return resolved.every(Boolean);
+    case "or":
+      return resolved.some(Boolean);
+    /* ── 값 고르기 ── */
+    case "if":
+      return resolved[0] ? resolve(calc.then ?? null) : resolve(calc.else ?? null);
+    case "match": {
+      const key = String(resolved[0] ?? "");
+      const cases = isPlainObject(calc.cases) ? calc.cases : {};
+      if (Object.hasOwn(cases, key)) return resolve(cases[key]);
+      return resolve(calc.default ?? null);
+    }
+    case "coalesce":
+      return resolved.find((v) => !isBlank(v)) ?? null;
+    /* ── 목록·객체 ── */
+    case "get": {
+      const [container, rawKey] = resolved;
+      const key = rawKey == null ? "" : String(rawKey);
+      if (Array.isArray(container)) {
+        const index = Number(key);
+        if (!Number.isInteger(index) || index < 0 || index >= container.length) return null;
+        return container[index] ?? null;
+      }
+      if (isPlainObject(container)) {
+        return Object.hasOwn(container, key) ? container[key] ?? null : null;
+      }
+      return null;
+    }
+    case "pluck":
+      return listOrEmpty().map((row) => fieldOf(row, field)).filter((v) => v !== null && v !== void 0);
+    case "filter":
+      return listOrEmpty().filter((row) => matchesWhere(row, calc.where, resolve));
+    case "some":
+      return listOrEmpty().some((row) => matchesWhere(row, calc.where, resolve));
+    case "every":
+      return listOrEmpty().every((row) => matchesWhere(row, calc.where, resolve));
+    case "includes": {
+      const needle = resolved[1];
+      if (typeof first === "string") return first.includes(String(needle ?? ""));
+      return listOrEmpty().some((row) => looseEquals(fieldOf(row, field), needle));
+    }
+    case "distinct": {
+      const seen = /* @__PURE__ */ new Set();
+      return listOrEmpty().filter((row) => {
+        const key = String(fieldOf(row, field) ?? "");
+        if (seen.has(key)) return false;
+        seen.add(key);
+        return true;
+      });
+    }
+    case "except": {
+      const remove = new Set(
+        (Array.isArray(resolved[1]) ? resolved[1] : []).map(
+          (row) => String(fieldOf(row, field) ?? "")
+        )
+      );
+      return listOrEmpty().filter(
+        (row) => !remove.has(String(fieldOf(row, field) ?? ""))
+      );
+    }
+    case "entries": {
+      if (!isPlainObject(first)) return [];
+      return Object.entries(first).map(([key, value]) => ({
+        key,
+        value
+      }));
+    }
+    case "length":
+      if (Array.isArray(first)) return first.length;
+      if (typeof first === "string") return first.length;
+      return 0;
+    case "join": {
+      const sep = typeof calc.sep === "string" ? calc.sep : ",";
+      return listOrEmpty().map((row) => {
+        const value = fieldOf(row, field);
+        return value == null ? "" : String(value);
+      }).join(sep);
+    }
+    case "split": {
+      const sep = typeof calc.sep === "string" ? calc.sep : ",";
+      const parts = String(first ?? "").split(sep);
+      if (calc.take === void 0) return parts;
+      const index = toNumber2(calc.take);
+      const at = index < 0 ? parts.length + index : index;
+      return parts[at] ?? null;
+    }
+    case "sortBy": {
+      const desc = Boolean(calc.desc);
+      return [...listOrEmpty()].sort((a, b) => {
+        const order = orderingCompare(fieldOf(a, field), fieldOf(b, field));
+        return desc ? -order : order;
+      });
+    }
+    default:
+      return null;
+  }
+}
+
 // src/request-action.ts
 function deferChainEntry(container, key) {
   return typeof container.action === "string" && (key === "onSuccess" || key === "onError");
@@ -1802,6 +2108,17 @@ async function runRequestAction(action, deps) {
     (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 (typeof action.errorKey === "string" && action.errorKey !== "") {
+      const detail = error;
+      const value = { message };
+      if (typeof detail?.status === "number") value.status = detail.status;
+      if (detail?.body !== void 0) value.body = detail.body;
+      deps.dispatch({
+        action: "setState",
+        key: action.errorKey,
+        value
+      });
+    }
     if (action.onError?.length) {
       action.onError.forEach((a) => deps.dispatch(a, message));
     } else {
@@ -1829,22 +2146,6 @@ var ACTION_NAMES = /* @__PURE__ */ new Set([
   "arrayUpdate",
   "custom"
 ]);
-var CALC_OPS = /* @__PURE__ */ new Set([
-  "sum",
-  "sub",
-  "mul",
-  "div",
-  "percent",
-  "count",
-  "concat",
-  "encode",
-  "eq",
-  "gt",
-  "gte",
-  "lt",
-  "lte",
-  "not"
-]);
 var RULE_NAMES = /* @__PURE__ */ new Set([
   "required",
   "min",
@@ -1864,7 +2165,7 @@ var DENIED_PROPS = /* @__PURE__ */ new Set([
   "constructor",
   "prototype"
 ]);
-function isPlainObject(v) {
+function isPlainObject2(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
 function checkUrlValue(key, value, path, issues) {
@@ -1874,7 +2175,7 @@ function checkUrlValue(key, value, path, issues) {
 }
 function validateSpec(page, knownComponents) {
   const issues = [];
-  if (!isPlainObject(page)) return [{ path: "$", message: "\uC2A4\uD399\uC774 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4" }];
+  if (!isPlainObject2(page)) return [{ path: "$", message: "\uC2A4\uD399\uC774 \uAC1D\uCCB4\uAC00 \uC544\uB2D9\uB2C8\uB2E4" }];
   if (page.version !== 1) issues.push({ path: "$.version", message: "version\uC740 1\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4" });
   validatePageData(page.data, issues);
   if (!Array.isArray(page.body)) {
@@ -1888,7 +2189,7 @@ function validateSpec(page, knownComponents) {
 }
 function validatePageData(data, issues) {
   if (data === void 0) return;
-  if (!isPlainObject(data)) {
+  if (!isPlainObject2(data)) {
     issues.push({ path: "$.data", message: "data\uB294 \uAC1D\uCCB4\uC5EC\uC57C \uD569\uB2C8\uB2E4" });
     return;
   }
@@ -1898,7 +2199,7 @@ function validatePageData(data, issues) {
       issues.push({ path, message: "\uC0C1\uD0DC \uD0A4\uB294 \uBE44\uC5B4 \uC788\uC9C0 \uC54A\uC544\uC57C \uD558\uACE0 $\uB85C \uC2DC\uC791\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4" });
       continue;
     }
-    if (!isPlainObject(raw)) {
+    if (!isPlainObject2(raw)) {
       issues.push({ path, message: "\uC870\uD68C\uB294 { endpoint, select?, when?, fallback? } \uAC1D\uCCB4\uC5EC\uC57C \uD569\uB2C8\uB2E4" });
       continue;
     }
@@ -1910,7 +2211,7 @@ function validatePageData(data, issues) {
       } else if (!raw.endpoint.startsWith("/")) {
         issues.push({ path: `${path}.endpoint`, message: "endpoint\uB294 /\uB85C \uC2DC\uC791\uD558\uB294 \uACBD\uB85C\uC5EC\uC57C \uD569\uB2C8\uB2E4" });
       }
-    } else if (!isPlainObject(raw.endpoint)) {
+    } else if (!isPlainObject2(raw.endpoint)) {
       issues.push({ path: `${path}.endpoint`, message: "endpoint\uB294 \uBB38\uC790\uC5F4\uC774\uAC70\uB098 \uAC12 \uCC38\uC870\uC5EC\uC57C \uD569\uB2C8\uB2E4" });
     } else {
       walkValue(raw.endpoint, `${path}.endpoint`, issues, false);
@@ -1933,7 +2234,7 @@ function validatePageData(data, issues) {
 }
 function walkChild(child, path, issues, known) {
   if (typeof child === "string") return;
-  if (!isPlainObject(child)) {
+  if (!isPlainObject2(child)) {
     issues.push({ path, message: "children \uD56D\uBAA9\uC740 \uBB38\uC790\uC5F4 \uB610\uB294 \uB178\uB4DC \uAC1D\uCCB4\uC5EC\uC57C \uD569\uB2C8\uB2E4" });
     return;
   }
@@ -1945,7 +2246,7 @@ function walkChild(child, path, issues, known) {
   if (known && !RENDERER_BUILTINS.has(node.component) && !known.has(node.component)) {
     issues.push({ path, message: `\uB4F1\uB85D\uB418\uC9C0 \uC54A\uC740 \uCEF4\uD3EC\uB10C\uD2B8: ${node.component}` });
   }
-  if (node.props !== void 0 && !isPlainObject(node.props)) {
+  if (node.props !== void 0 && !isPlainObject2(node.props)) {
     issues.push({ path: `${path}.props`, message: "props\uB294 \uAC1D\uCCB4\uC5EC\uC57C \uD569\uB2C8\uB2E4" });
   }
   for (const [name, value] of Object.entries(node.props ?? {})) {
@@ -1959,9 +2260,9 @@ function walkChild(child, path, issues, known) {
     checkUrlValue(name, value, `${path}.props.${name}`, issues);
     walkValue(value, `${path}.props.${name}`, issues, name.startsWith("on") || name === "rowClick");
   }
-  if (node.component === "Form" && isPlainObject(node.props) && node.props.rules !== void 0) {
+  if (node.component === "Form" && isPlainObject2(node.props) && node.props.rules !== void 0) {
     const rules = node.props.rules;
-    if (!isPlainObject(rules)) {
+    if (!isPlainObject2(rules)) {
       issues.push({ path: `${path}.props.rules`, message: "rules\uB294 { \uD544\uB4DC: \uADDC\uCE59\uBC30\uC5F4 } \uAC1D\uCCB4\uC5EC\uC57C \uD569\uB2C8\uB2E4" });
     } else {
       for (const [field, list] of Object.entries(rules)) {
@@ -1972,15 +2273,15 @@ function walkChild(child, path, issues, known) {
     }
   }
   if (node.component === "Fragment") {
-    const id = isPlainObject(node.props) ? node.props.id : void 0;
-    if ((typeof id !== "string" || id === "") && !isPlainObject(id)) {
+    const id = isPlainObject2(node.props) ? node.props.id : void 0;
+    if ((typeof id !== "string" || id === "") && !isPlainObject2(id)) {
       issues.push({
         path: `${path}.props.id`,
         message: "Fragment.id\uB294 \uBE44\uC5B4 \uC788\uC9C0 \uC54A\uC740 \uBB38\uC790\uC5F4(\uB610\uB294 \uAC12 \uCC38\uC870)\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4"
       });
     }
-    const args = isPlainObject(node.props) ? node.props.args : void 0;
-    if (args !== void 0 && !isPlainObject(args)) {
+    const args = isPlainObject2(node.props) ? node.props.args : void 0;
+    if (args !== void 0 && !isPlainObject2(args)) {
       issues.push({
         path: `${path}.props.args`,
         message: "Fragment.args\uB294 { \uC774\uB984: \uAC12 } \uD3C9\uBA74 \uC624\uBE0C\uC81D\uD2B8\uC5EC\uC57C \uD569\uB2C8\uB2E4"
@@ -1994,7 +2295,7 @@ function walkChild(child, path, issues, known) {
     }
   }
   if (node.slots !== void 0) {
-    if (!isPlainObject(node.slots)) {
+    if (!isPlainObject2(node.slots)) {
       issues.push({ path: `${path}.slots`, message: "slots\uB294 \uAC1D\uCCB4\uC5EC\uC57C \uD569\uB2C8\uB2E4" });
     } else {
       for (const [slot, children] of Object.entries(node.slots)) {
@@ -2019,7 +2320,7 @@ function walkValue(value, path, issues, actionEligible) {
     value.forEach((v, i) => walkValue(v, `${path}[${i}]`, issues, actionEligible));
     return;
   }
-  if (!isPlainObject(value)) return;
+  if (!isPlainObject2(value)) return;
   if (typeof value.action === "string" && (actionEligible || ACTION_NAMES.has(value.action))) {
     if (actionEligible && !ACTION_NAMES.has(value.action)) {
       issues.push({ path, message: `\uC54C \uC218 \uC5C6\uB294 \uC561\uC158: ${value.action}` });
@@ -2046,7 +2347,7 @@ function walkValue(value, path, issues, actionEligible) {
   }
   if ("$calc" in value) {
     const calc = value.$calc;
-    if (!isPlainObject(calc) || typeof calc.op !== "string" || !CALC_OPS.has(calc.op)) {
+    if (!isPlainObject2(calc) || typeof calc.op !== "string" || !CALC_OPS.has(calc.op)) {
       issues.push({ path, message: "$calc.op\uC774 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4" });
     } else if (!Array.isArray(calc.args)) {
       issues.push({ path: `${path}.$calc.args`, message: "args\uB294 \uBC30\uC5F4\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4" });
@@ -2075,12 +2376,12 @@ function walkValue(value, path, issues, actionEligible) {
 }
 
 // src/page-data.ts
-function isPlainObject2(value) {
+function isPlainObject3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function planPageData(data, resolve) {
   if (data === void 0) return [];
-  if (!isPlainObject2(data)) {
+  if (!isPlainObject3(data)) {
     warnOnce("page-data:root", "[sdui] page.data\uB294 \uAC1D\uCCB4\uC5EC\uC57C \uD569\uB2C8\uB2E4 \u2014 \uBB34\uC2DC\uD569\uB2C8\uB2E4");
     return [];
   }
@@ -2090,7 +2391,7 @@ function planPageData(data, resolve) {
       warnOnce(`page-data:${key}`, `[sdui] page.data\uC758 \uC0C1\uD0DC \uD0A4 "${key}"\uB294 \uC4F8 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uAC74\uB108\uB701\uB2C8\uB2E4`);
       continue;
     }
-    if (!isPlainObject2(raw)) {
+    if (!isPlainObject3(raw)) {
       warnOnce(`page-data:${key}`, `[sdui] page.data.${key}\uB294 \uAC1D\uCCB4\uC5EC\uC57C \uD569\uB2C8\uB2E4 \u2014 \uAC74\uB108\uB701\uB2C8\uB2E4`);
       continue;
     }
@@ -2125,7 +2426,7 @@ function pickPath(source, path) {
   if (path === void 0 || path === "") return source;
   let value = source;
   for (const segment of path.split(".")) {
-    if (!isPlainObject2(value)) return void 0;
+    if (!isPlainObject3(value)) return void 0;
     value = value[segment];
   }
   return value;
@@ -2156,26 +2457,26 @@ function nearestArgsFrame(scope) {
   }
   return void 0;
 }
-function isPlainObject3(v) {
+function isPlainObject4(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
 function isStateRef(v) {
-  return isPlainObject3(v) && typeof v.$state === "string";
+  return isPlainObject4(v) && typeof v.$state === "string";
 }
 function isItemRef(v) {
-  return isPlainObject3(v) && "$item" in v;
+  return isPlainObject4(v) && "$item" in v;
 }
 function isIndexRef(v) {
-  return isPlainObject3(v) && "$index" in v;
+  return isPlainObject4(v) && "$index" in v;
 }
 function isCalcRef(v) {
-  return isPlainObject3(v) && isPlainObject3(v.$calc);
+  return isPlainObject4(v) && isPlainObject4(v.$calc);
 }
 function isArgRef(v) {
-  return isPlainObject3(v) && typeof v.$arg === "string";
+  return isPlainObject4(v) && typeof v.$arg === "string";
 }
 function isAction(v) {
-  return isPlainObject3(v) && typeof v.action === "string";
+  return isPlainObject4(v) && typeof v.action === "string";
 }
 function isActionList(v) {
   return Array.isArray(v) && v.length > 0 && v.every(isAction);
@@ -2199,7 +2500,7 @@ function expandActionEntries(raw, scope) {
   return [];
 }
 function eventValue(arg) {
-  if (isPlainObject3(arg) && "target" in arg && typeof arg.preventDefault === "function") {
+  if (isPlainObject4(arg) && "target" in arg && typeof arg.preventDefault === "function") {
     const target = arg.target;
     if (target.type === "checkbox") return target.checked;
     if (target.type === "number" || target.type === "range") {
@@ -2211,14 +2512,6 @@ function eventValue(arg) {
   }
   return arg;
 }
-function toNumber2(v) {
-  if (typeof v === "number") return v;
-  if (typeof v === "string") {
-    const n = Number(v.replace(/,/g, ""));
-    return Number.isFinite(n) ? n : 0;
-  }
-  return 0;
-}
 function toIndex(v) {
   if (typeof v === "number") return Number.isInteger(v) ? v : null;
   if (typeof v === "string" && /^-?\d+$/.test(v.trim())) return Number(v.trim());
@@ -2317,7 +2610,7 @@ function childrenOf(node) {
 }
 function renderChild(child, index, scope, engine) {
   if (typeof child === "string") return child;
-  if (!isPlainObject3(child)) {
+  if (!isPlainObject4(child)) {
     warnOnce2(`child:${String(child)}`, `[sdui] \uC798\uBABB\uB41C \uB178\uB4DC(\uBB38\uC790\uC5F4 \uB610\uB294 \uAC1D\uCCB4\uC5EC\uC57C \uD569\uB2C8\uB2E4): ${String(child)}`);
     return /* @__PURE__ */ jsx(SpecErrorCard, { children: "[sdui] \uC798\uBABB\uB41C \uB178\uB4DC \u2014 \uBB38\uC790\uC5F4 \uB610\uB294 \uB178\uB4DC \uAC1D\uCCB4\uC5EC\uC57C \uD569\uB2C8\uB2E4" }, index);
   }
@@ -2332,11 +2625,11 @@ function SduiNodeRenderer({
   engine
 }) {
   const { registry, resolveValue, dispatch, resolveAsset } = engine;
-  const slots = isPlainObject3(node.slots) ? node.slots : void 0;
+  const slots = isPlainObject4(node.slots) ? node.slots : void 0;
   const childList = childrenOf(node);
   if (node.component === "ForEach") {
     const source = resolveValue(
-      isPlainObject3(node.props) ? node.props.source ?? null : null,
+      isPlainObject4(node.props) ? node.props.source ?? null : null,
       scope
     );
     const rows = Array.isArray(source) ? source : [];
@@ -2346,7 +2639,7 @@ function SduiNodeRenderer({
     }
     return /* @__PURE__ */ jsx(Fragment, { children: rows.map((item, rowIndex) => {
       const rowScope = [...scope, { item, index: rowIndex }];
-      const rowKey = isPlainObject3(item) && typeof item.id === "string" ? item.id : rowIndex;
+      const rowKey = isPlainObject4(item) && typeof item.id === "string" ? item.id : rowIndex;
       return /* @__PURE__ */ jsx(React11.Fragment, { children: childList?.map((child, i) => renderChild(child, i, rowScope, engine)) }, rowKey);
     }) });
   }
@@ -2365,7 +2658,7 @@ function SduiNodeRenderer({
     ] });
   }
   const props = {};
-  for (const [name, raw] of Object.entries(isPlainObject3(node.props) ? node.props : {})) {
+  for (const [name, raw] of Object.entries(isPlainObject4(node.props) ? node.props : {})) {
     if (DENIED_PROPS2.has(name)) {
       warnOnce2(`prop:${name}`, `[sdui] \uC2A4\uD399\uC5D0\uC11C \uD5C8\uC6A9\uB418\uC9C0 \uC54A\uB294 \uD504\uB86D: ${name} \u2014 \uBB34\uC2DC\uD569\uB2C8\uB2E4`);
       continue;
@@ -2404,7 +2697,7 @@ function SduiNodeRenderer({
   if (childLayout) {
     for (const name of CHILD_LAYOUT_PROPS) delete props[name];
     if (childLayout.style) {
-      props.style = isPlainObject3(props.style) ? { ...childLayout.style, ...props.style } : childLayout.style;
+      props.style = isPlainObject4(props.style) ? { ...childLayout.style, ...props.style } : childLayout.style;
     }
     if (childLayout.className) {
       props.className = typeof props.className === "string" && props.className ? `${childLayout.className} ${props.className}` : childLayout.className;
@@ -2428,7 +2721,7 @@ var FRAGMENT_MAX_DEPTH = 4;
 function SduiFragment({ node, scope, engine }) {
   const adapter = useSduiAdapter();
   const chain = React11.useContext(SduiFragmentChainContext);
-  const raw = isPlainObject3(node.props) ? node.props.id : void 0;
+  const raw = isPlainObject4(node.props) ? node.props.id : void 0;
   const id = engine.resolveValue(raw, scope);
   if (typeof id !== "string" || id === "") {
     warnOnce2("fragment:id", "[sdui] <Fragment>\uC5D0 \uBB38\uC790\uC5F4 id\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uB80C\uB354\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4");
@@ -2448,8 +2741,8 @@ function SduiFragment({ node, scope, engine }) {
     );
     return null;
   }
-  const rawArgs = isPlainObject3(node.props) ? node.props.args : void 0;
-  if (rawArgs !== void 0 && !isPlainObject3(rawArgs)) {
+  const rawArgs = isPlainObject4(node.props) ? node.props.args : void 0;
+  if (rawArgs !== void 0 && !isPlainObject4(rawArgs)) {
     warnOnce2(`fragment:args:${id}`, `[sdui] <Fragment ${id}>\uC758 args\uB294 \uD3C9\uBA74 \uC624\uBE0C\uC81D\uD2B8\uC5EC\uC57C \uD569\uB2C8\uB2E4 \u2014 \uBB34\uC2DC\uD569\uB2C8\uB2E4`);
   }
   const useSpec = adapter?.useSpec;
@@ -2464,7 +2757,7 @@ function SduiFragment({ node, scope, engine }) {
     SduiFragmentBody,
     {
       id,
-      args: isPlainObject3(rawArgs) ? rawArgs : void 0,
+      args: isPlainObject4(rawArgs) ? rawArgs : void 0,
       useSpec,
       chain,
       scope,
@@ -2485,13 +2778,13 @@ function SduiFragmentBody({
   const nextChain = React11.useMemo(() => [...chain, id], [chain, id]);
   const bodyScope = React11.useMemo(() => [...scope, { args, callSiteScope: scope }], [scope, args]);
   React11.useEffect(() => {
-    if (!DEV || !isPlainObject3(spec) || !Array.isArray(spec.body)) return;
+    if (!DEV || !isPlainObject4(spec) || !Array.isArray(spec.body)) return;
     validateSpec(spec, new Set(Object.keys(engine.registry))).forEach(
       (issue) => console.warn(`[sdui:spec:${id}] ${issue.path} \u2014 ${issue.message}`)
     );
   }, [spec, engine.registry, id]);
   if (spec === void 0) return null;
-  if (spec === null || !isPlainObject3(spec) || !Array.isArray(spec.body)) {
+  if (spec === null || !isPlainObject4(spec) || !Array.isArray(spec.body)) {
     warnOnce2(`fragment:missing:${id}`, `[sdui] Fragment \uC2A4\uD399\uC744 \uD574\uC11D\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${id} \u2014 \uB80C\uB354\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`);
     return null;
   }
@@ -2621,7 +2914,7 @@ function SduiRenderer({
       if (head in current) {
         let value = current[head];
         for (const segment of segments.slice(cut)) {
-          if (!isPlainObject3(value)) return void 0;
+          if (!isPlainObject4(value)) return void 0;
           value = value[segment];
         }
         return value;
@@ -2639,7 +2932,7 @@ function SduiRenderer({
         const frame = nearestItemFrame(scope);
         if (!frame) return null;
         if (value.$item === true) return frame.item;
-        return isPlainObject3(frame.item) ? frame.item[value.$item] ?? null : null;
+        return isPlainObject4(frame.item) ? frame.item[value.$item] ?? null : null;
       }
       if (isIndexRef(value)) {
         return nearestItemFrame(scope)?.index ?? null;
@@ -2653,64 +2946,17 @@ function SduiRenderer({
         return void 0;
       }
       if (isCalcRef(value)) {
-        const { op: rawOp, args, field: rawField } = value.$calc;
-        const op = typeof rawOp === "string" ? rawOp : "";
-        if (!Array.isArray(args)) {
+        const calc = value.$calc;
+        const op = typeof calc.op === "string" ? calc.op : "";
+        if (!Array.isArray(calc.args)) {
           warnOnce2(`calc:${op}`, `[sdui] $calc(${op || "?"}): args\uB294 \uBC30\uC5F4\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4 \u2014 \uAC12 \uC5C6\uC74C\uC73C\uB85C \uCC98\uB9AC\uD569\uB2C8\uB2E4`);
           return null;
         }
-        const field = typeof rawField === "string" ? rawField : void 0;
-        const resolved = args.map((arg) => resolveValue(arg, scope));
-        const nums = (v) => {
-          if (Array.isArray(v))
-            return v.map((row) => field && isPlainObject3(row) ? toNumber2(row[field]) : toNumber2(row));
-          return [toNumber2(v)];
-        };
-        switch (op) {
-          case "sum":
-            return resolved.flatMap(nums).reduce((a, b) => a + b, 0);
-          case "count":
-            return resolved.reduce((a, v) => a + (Array.isArray(v) ? v.length : v == null ? 0 : 1), 0);
-          case "sub": {
-            const list = resolved.map((v) => toNumber2(v));
-            return list.length === 0 ? 0 : list.reduce((a, b) => a - b);
-          }
-          case "mul":
-            return resolved.map((v) => toNumber2(v)).reduce((a, b) => a * b, 1);
-          case "div": {
-            const [a, b] = resolved.map((v) => toNumber2(v));
-            return b === 0 ? 0 : a / b;
-          }
-          case "percent": {
-            const [a, b] = resolved.map((v) => toNumber2(v));
-            return b === 0 ? 0 : Math.round(a / b * 1e3) / 10;
-          }
-          case "concat":
-            return resolved.map((v) => v == null ? "" : String(v)).join("");
-          case "encode":
-            return encodeURIComponent(resolved.map((v) => v == null ? "" : String(v)).join(""));
-          case "eq": {
-            const [a, b] = resolved;
-            return String(a ?? "") === String(b ?? "");
-          }
-          // 수량 비교 — 정원 초과 차단(Button.disabled), 임계값 경고(Show.when) 등
-          case "gt":
-            return toNumber2(resolved[0]) > toNumber2(resolved[1]);
-          case "gte":
-            return toNumber2(resolved[0]) >= toNumber2(resolved[1]);
-          case "lt":
-            return toNumber2(resolved[0]) < toNumber2(resolved[1]);
-          case "lte":
-            return toNumber2(resolved[0]) <= toNumber2(resolved[1]);
-          /** 부정 — 조건을 뒤집어 "없을 때만" 렌더링하는 데 쓴다 */
-          case "not":
-            return !resolved[0];
-          default:
-            return null;
-        }
+        const resolved = calc.args.map((arg) => resolveValue(arg, scope));
+        return evaluateCalc(calc, resolved, (late) => resolveValue(late, scope));
       }
       if (Array.isArray(value)) return value.map((v) => resolveValue(v, scope));
-      if (isPlainObject3(value)) {
+      if (isPlainObject4(value)) {
         const out = {};
         for (const [k, v] of Object.entries(value)) {
           out[k] = deferChainEntry(value, k) ? v : resolveValue(v, scope);
@@ -2879,7 +3125,7 @@ function SduiRenderer({
             break;
           }
           const row = current[index];
-          if (!isPlainObject3(row)) break;
+          if (!isPlainObject4(row)) break;
           const nextValue = (action.fromEvent ? eventValue(arg) : action.value) ?? null;
           const next = [...current];
           next[index] = { ...row, [action.field]: nextValue };
@@ -3022,4 +3268,4 @@ function SduiRenderer({
   );
 }
 
-export { Actions, Can, Col, Divider, Grid, KeyValueList, NodeErrorBoundary, PageHead, RemoteSearchResults, ResultTable, Row, SduiDialog, SduiForm, SduiPermissionProvider, SduiRenderer, SduiSearchDataProvider, SduiSearchResults, SearchResults, Section, Show, SortHandle, SortableList, Spacer, Text, cellRenderer, createRegistry, defaultRegistry, imageRenderer, normalizePageSizes, sortableDropIndex, sortableMove, useRemoteSearchPage, useSduiCan, useSduiDispatch, useSduiRuntime, useSearchFetcher, validateSpec };
+export { Actions, CALC_OPS, Can, Col, Divider, Grid, KeyValueList, NodeErrorBoundary, PageHead, RemoteSearchResults, ResultTable, Row, SduiDialog, SduiForm, SduiPermissionProvider, SduiRenderer, SduiSearchDataProvider, SduiSearchResults, SearchResults, Section, Show, SortHandle, SortableList, Spacer, Text, cellRenderer, createRegistry, defaultRegistry, imageRenderer, normalizePageSizes, sortableDropIndex, sortableMove, useRemoteSearchPage, useSduiCan, useSduiDispatch, useSduiRuntime, useSearchFetcher, validateSpec };