@x-plat/design-system 0.8.3 → 0.10.0

package/dist/components/Select/index.js

@@ -875,12 +875,83 @@ import { jsx as jsx253 } from "react/jsx-runtime";
 
 // src/tokens/svg/status/ErrorIcon.tsx
 import { jsx as jsx254, jsxs as jsxs160 } from "react/jsx-runtime";
+var ErrorIcon = () => /* @__PURE__ */ jsxs160(
+  "svg",
+  {
+    xmlns: "http://www.w3.org/2000/svg",
+    width: "1em",
+    height: "1em",
+    viewBox: "0 0 16 16",
+    fill: "none",
+    children: [
+      /* @__PURE__ */ jsxs160("g", { clipPath: "url(#clip0_1196_9603)", children: [
+        /* @__PURE__ */ jsx254(
+          "path",
+          {
+            d: "M9.57588 5.57559C9.81019 5.34127 10.19 5.34127 10.4243 5.57559C10.6586 5.8099 10.6586 6.18971 10.4243 6.42402L8.84854 7.9998L10.4243 9.57559C10.6586 9.8099 10.6586 10.1897 10.4243 10.424C10.19 10.6583 9.81019 10.6583 9.57588 10.424L8.0001 8.84824L6.42432 10.424C6.19 10.6583 5.81019 10.6583 5.57588 10.424C5.34156 10.1897 5.34156 9.8099 5.57588 9.57559L7.15166 7.9998L5.57588 6.42402C5.34156 6.18971 5.34156 5.8099 5.57588 5.57559C5.81019 5.34127 6.19 5.34127 6.42432 5.57559L8.0001 7.15137L9.57588 5.57559Z",
+            fill: "currentColor"
+          }
+        ),
+        /* @__PURE__ */ jsx254(
+          "path",
+          {
+            fillRule: "evenodd",
+            clipRule: "evenodd",
+            d: "M8.0001 0.733398C12.0131 0.73361 15.2671 3.98679 15.2673 7.9998C15.2672 12.0129 12.0131 15.2668 8.0001 15.267C3.98701 15.2669 0.733016 12.0129 0.73291 7.9998C0.733051 3.98674 3.98704 0.733539 8.0001 0.733398ZM8.0001 1.9334C4.64978 1.93354 1.93383 4.64948 1.93369 7.9998C1.9338 11.3502 4.64975 14.0669 8.0001 14.067C11.3504 14.0668 14.0672 11.3501 14.0673 7.9998C14.0671 4.64953 11.3504 1.93361 8.0001 1.9334Z",
+            fill: "currentColor"
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsx254("defs", { children: /* @__PURE__ */ jsx254("clipPath", { id: "clip0_1196_9603", children: /* @__PURE__ */ jsx254("rect", { width: "16", height: "16", fill: "white" }) }) })
+    ]
+  }
+);
+var ErrorIcon_default = ErrorIcon;
 
 // src/tokens/svg/status/HelpCircleIcon.tsx
 import { jsx as jsx255, jsxs as jsxs161 } from "react/jsx-runtime";
 
 // src/tokens/svg/status/InfoIcon.tsx
 import { jsx as jsx256, jsxs as jsxs162 } from "react/jsx-runtime";
+var InfoIcon = () => /* @__PURE__ */ jsxs162(
+  "svg",
+  {
+    xmlns: "http://www.w3.org/2000/svg",
+    width: "1em",
+    height: "1em",
+    viewBox: "0 0 16 16",
+    fill: "none",
+    children: [
+      /* @__PURE__ */ jsxs162("g", { clipPath: "url(#clip0_1188_11261)", children: [
+        /* @__PURE__ */ jsx256(
+          "path",
+          {
+            d: "M8.00156 7.39999C8.33293 7.39999 8.60156 7.66862 8.60156 7.99999V10.6664C8.60156 10.9978 8.33293 11.2664 8.00156 11.2664C7.67019 11.2664 7.40156 10.9978 7.40156 10.6664V7.99999C7.40156 7.66862 7.67019 7.39999 8.00156 7.39999Z",
+            fill: "currentColor"
+          }
+        ),
+        /* @__PURE__ */ jsx256(
+          "path",
+          {
+            d: "M8.00859 4.73358C8.3398 4.73378 8.60859 5.00233 8.60859 5.33358C8.60849 5.66474 8.33973 5.93338 8.00859 5.93358H8.00156C7.67026 5.93358 7.40167 5.66486 7.40156 5.33358C7.40156 5.00221 7.67019 4.73358 8.00156 4.73358H8.00859Z",
+            fill: "currentColor"
+          }
+        ),
+        /* @__PURE__ */ jsx256(
+          "path",
+          {
+            fillRule: "evenodd",
+            clipRule: "evenodd",
+            d: "M8.00156 0.733582C12.0146 0.733793 15.2686 3.98697 15.2688 7.99999C15.2686 12.013 12.0146 15.267 8.00156 15.2672C3.98848 15.267 0.734481 12.0131 0.734375 7.99999C0.734516 3.98693 3.9885 0.733722 8.00156 0.733582ZM8.00156 1.93358C4.65124 1.93372 1.9353 4.64967 1.93516 7.99999C1.93526 11.3503 4.65122 14.067 8.00156 14.0672C11.3518 14.067 14.0686 11.3503 14.0688 7.99999C14.0686 4.64971 11.3518 1.93379 8.00156 1.93358Z",
+            fill: "currentColor"
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsx256("defs", { children: /* @__PURE__ */ jsx256("clipPath", { id: "clip0_1188_11261", children: /* @__PURE__ */ jsx256("rect", { width: "16", height: "16", fill: "white" }) }) })
+    ]
+  }
+);
+var InfoIcon_default = InfoIcon;
 
 // src/tokens/svg/status/LoaderIcon.tsx
 import { jsx as jsx257, jsxs as jsxs163 } from "react/jsx-runtime";
@@ -905,6 +976,24 @@ import { jsx as jsx263, jsxs as jsxs167 } from "react/jsx-runtime";
 
 // src/tokens/svg/status/SuccessIcon.tsx
 import { jsx as jsx264 } from "react/jsx-runtime";
+var SuccessIcon = () => /* @__PURE__ */ jsx264(
+  "svg",
+  {
+    xmlns: "http://www.w3.org/2000/svg",
+    width: "1em",
+    height: "1em",
+    viewBox: "0 0 16 16",
+    fill: "none",
+    children: /* @__PURE__ */ jsx264(
+      "path",
+      {
+        d: "M12.9084 3.57597C13.1426 3.34172 13.5225 3.34185 13.7568 3.57597C13.9911 3.81028 13.9911 4.19009 13.7568 4.4244L6.424 11.758C6.31157 11.8703 6.15869 11.9337 5.99978 11.9338C5.8409 11.9337 5.68798 11.8703 5.57556 11.758L2.24197 8.4244C2.00782 8.19018 2.00795 7.81028 2.24197 7.57597C2.47626 7.34167 2.85609 7.34172 3.09041 7.57597L5.999 10.4846L12.9084 3.57597Z",
+        fill: "currentColor"
+      }
+    )
+  }
+);
+var SuccessIcon_default = SuccessIcon;
 
 // src/tokens/svg/status/XCircleIcon.tsx
 import { jsx as jsx265, jsxs as jsxs168 } from "react/jsx-runtime";
@@ -1012,6 +1101,41 @@ function clsx() {
 }
 var clsx_default = clsx;
 
+// src/components/FieldMessage/FieldMessage.tsx
+import { Fragment, jsx as jsx295, jsxs as jsxs189 } from "react/jsx-runtime";
+var ICON = {
+  default: /* @__PURE__ */ jsx295(InfoIcon_default, {}),
+  success: /* @__PURE__ */ jsx295(SuccessIcon_default, {}),
+  warning: /* @__PURE__ */ jsx295(InfoIcon_default, {}),
+  error: /* @__PURE__ */ jsx295(ErrorIcon_default, {})
+};
+var FieldMessage = (props) => {
+  const { validations } = props;
+  if (!validations || validations.length === 0) return null;
+  return /* @__PURE__ */ jsx295("div", { className: "lib-xplat-field-message-wrap", children: validations.map((v, idx) => /* @__PURE__ */ jsxs189(
+    "div",
+    {
+      className: clsx_default("lib-xplat-field-message", v.status),
+      children: [
+        /* @__PURE__ */ jsx295("div", { className: "icon", children: ICON[v.status] }),
+        /* @__PURE__ */ jsx295("span", { children: v.message })
+      ]
+    },
+    `${v.message}_${idx}`
+  )) });
+};
+FieldMessage.displayName = "FieldMessage";
+var Field = (props) => {
+  const { validations, children } = props;
+  if (!validations || validations.length === 0) return /* @__PURE__ */ jsx295(Fragment, { children });
+  return /* @__PURE__ */ jsxs189("div", { className: "lib-xplat-field", children: [
+    children,
+    /* @__PURE__ */ jsx295(FieldMessage, { validations })
+  ] });
+};
+Field.displayName = "Field";
+var hasError = (validations) => !!validations?.some((v) => v.status === "error");
+
 // src/components/Select/context.ts
 import React3 from "react";
 var SelectContext = React3.createContext(null);
@@ -1019,7 +1143,7 @@ var context_default = SelectContext;
 
 // src/components/Select/SelectItem.tsx
 import React4 from "react";
-import { jsx as jsx295 } from "react/jsx-runtime";
+import { jsx as jsx296 } from "react/jsx-runtime";
 var SelectItem = (props) => {
   const { children, value, onClick, disabled = false } = props;
   const ctx = React4.useContext(context_default);
@@ -1032,7 +1156,7 @@ var SelectItem = (props) => {
     onClick?.();
   };
   const isSelected = value !== void 0 ? ctx?.selectedValue === value : ctx?.selectedLabel === children;
-  return /* @__PURE__ */ jsx295(
+  return /* @__PURE__ */ jsx296(
     "div",
     {
       className: clsx_default("select-item", disabled && "disabled", isSelected && "is-selected"),
@@ -1053,7 +1177,7 @@ SelectItem.displayName = "Select.Item";
 var SelectItem_default = SelectItem;
 
 // src/components/Select/Select.tsx
-import { jsx as jsx296, jsxs as jsxs189 } from "react/jsx-runtime";
+import { jsx as jsx297, jsxs as jsxs190 } from "react/jsx-runtime";
 var ANIMATION_DURATION_MS = 200;
 var SelectRoot = (props) => {
   const {
@@ -1063,6 +1187,7 @@ var SelectRoot = (props) => {
     children,
     disabled = false,
     error = false,
+    validations,
     size = "md"
   } = props;
   const itemChildren = React5.Children.toArray(children).filter(
@@ -1133,32 +1258,32 @@ var SelectRoot = (props) => {
     if (disabled) return;
     toggle();
   };
-  return /* @__PURE__ */ jsx296(context_default.Provider, { value: ctxValue, children: /* @__PURE__ */ jsxs189(
+  const control = /* @__PURE__ */ jsx297(context_default.Provider, { value: ctxValue, children: /* @__PURE__ */ jsxs190(
     "div",
     {
       className: clsx_default(
         "lib-xplat-select",
         size,
         disabled && "disabled",
-        error && "error",
+        (error || hasError(validations)) && "error",
         mounted && "is-open"
       ),
       children: [
-        /* @__PURE__ */ jsxs189(
+        /* @__PURE__ */ jsxs190(
           "div",
           {
             ref: triggerRef,
             className: clsx_default(
               "select-trigger",
               disabled && "disabled",
-              error && "error"
+              (error || hasError(validations)) && "error"
             ),
             onClick: handleTriggerClick,
             role: "combobox",
             "aria-expanded": isOpen,
             "aria-haspopup": "listbox",
             "aria-disabled": disabled,
-            "aria-invalid": error,
+            "aria-invalid": error || hasError(validations) || void 0,
             tabIndex: disabled ? -1 : 0,
             onKeyDown: (e) => {
               if (disabled) return;
@@ -1168,7 +1293,7 @@ var SelectRoot = (props) => {
               }
             },
             children: [
-              /* @__PURE__ */ jsx296(
+              /* @__PURE__ */ jsx297(
                 "span",
                 {
                   className: clsx_default(
@@ -1178,30 +1303,31 @@ var SelectRoot = (props) => {
                   children: selectedLabel ?? placeholder
                 }
               ),
-              /* @__PURE__ */ jsx296(
+              /* @__PURE__ */ jsx297(
                 "span",
                 {
                   className: clsx_default("select-trigger-icon", isOpen && "open"),
                   "aria-hidden": true,
-                  children: /* @__PURE__ */ jsx296(ChevronDownIcon_default, {})
+                  children: /* @__PURE__ */ jsx297(ChevronDownIcon_default, {})
                 }
               )
             ]
           }
         ),
-        mounted && /* @__PURE__ */ jsx296(Portal_default, { children: /* @__PURE__ */ jsx296(
+        mounted && /* @__PURE__ */ jsx297(Portal_default, { children: /* @__PURE__ */ jsx297(
           "div",
           {
             className: clsx_default("lib-xplat-select-content", size, position.direction, stateClass),
             ref: contentRef,
             style: { ...position.position, width: triggerRef.current?.offsetWidth },
             role: "listbox",
-            children: /* @__PURE__ */ jsx296(context_default.Provider, { value: ctxValue, children: itemChildren })
+            children: /* @__PURE__ */ jsx297(context_default.Provider, { value: ctxValue, children: itemChildren })
           }
         ) })
       ]
     }
   ) });
+  return /* @__PURE__ */ jsx297(Field, { validations, children: control });
 };
 SelectRoot.displayName = "Select";
 var Select = Object.assign(SelectRoot, {

package/dist/components/Skeleton/index.d.cts

@@ -3,8 +3,11 @@ import React from 'react';
 type SkeletonVariant = "text" | "circular" | "rectangular";
 type SizeToken = "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full";
 interface SkeletonProps {
+    /** 자리표시자 모양 */
     variant?: SkeletonVariant;
+    /** 가로 크기 */
     width?: SizeToken;
+    /** 세로 크기 */
     height?: SizeToken;
 }
 declare const Skeleton: React.FC<SkeletonProps>;

package/dist/components/Skeleton/index.d.ts

@@ -3,8 +3,11 @@ import React from 'react';
 type SkeletonVariant = "text" | "circular" | "rectangular";
 type SizeToken = "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "full";
 interface SkeletonProps {
+    /** 자리표시자 모양 */
     variant?: SkeletonVariant;
+    /** 가로 크기 */
     width?: SizeToken;
+    /** 세로 크기 */
     height?: SizeToken;
 }
 declare const Skeleton: React.FC<SkeletonProps>;

package/dist/components/Spinner/index.cjs

@@ -24,6 +24,9 @@ __export(Spinner_exports, {
 });
 module.exports = __toCommonJS(Spinner_exports);
 
+// src/tokens/interface/status.ts
+var normalizeStatus = (value) => value === "brand" ? "primary" : value;
+
 // ../../node_modules/clsx/dist/clsx.mjs
 function r(e) {
   var t, f, n = "";
@@ -45,12 +48,13 @@ var import_jsx_runtime = require("react/jsx-runtime");
 var Spinner = (props) => {
   const {
     size = "md",
-    type = "brand"
+    type = "primary"
   } = props;
+  const statusType = normalizeStatus(type);
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
     "div",
     {
-      className: clsx_default("lib-xplat-spinner", size, type),
+      className: clsx_default("lib-xplat-spinner", size, statusType),
       role: "status",
       "aria-label": "\uB85C\uB529 \uC911",
       children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("svg", { viewBox: "0 0 24 24", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: [

package/dist/components/Spinner/index.css

@@ -33,6 +33,7 @@
   stroke-dasharray: 42;
   stroke-dashoffset: 28;
 }
+.lib-xplat-spinner.primary .indicator,
 .lib-xplat-spinner.brand .indicator {
   stroke: var(--semantic-surface-brand-default);
 }

package/dist/components/Spinner/index.d.cts

@@ -1,10 +1,16 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { L as LegacyStatusType } from '../../status-g_KP3qT6.cjs';
 
 type SpinnerSize = "sm" | "md" | "lg";
-type SpinnerType = "brand" | "success" | "error" | "warning" | "info";
+/** Spinner 의 상태 색 */
+type SpinnerType = "primary" | "success" | "error" | "warning" | "info";
+/** 입력으로는 예전 이름 `brand` 도 받는다 (= `primary`) */
+type SpinnerTypeInput = SpinnerType | LegacyStatusType;
 interface SpinnerProps {
+    /** 스피너 지름 */
     size?: SpinnerSize;
-    type?: SpinnerType;
+    /** 스피너 색 */
+    type?: SpinnerTypeInput;
 }
 declare const Spinner: {
     (props: SpinnerProps): react_jsx_runtime.JSX.Element;

package/dist/components/Spinner/index.d.ts

@@ -1,10 +1,16 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { L as LegacyStatusType } from '../../status-g_KP3qT6.js';
 
 type SpinnerSize = "sm" | "md" | "lg";
-type SpinnerType = "brand" | "success" | "error" | "warning" | "info";
+/** Spinner 의 상태 색 */
+type SpinnerType = "primary" | "success" | "error" | "warning" | "info";
+/** 입력으로는 예전 이름 `brand` 도 받는다 (= `primary`) */
+type SpinnerTypeInput = SpinnerType | LegacyStatusType;
 interface SpinnerProps {
+    /** 스피너 지름 */
     size?: SpinnerSize;
-    type?: SpinnerType;
+    /** 스피너 색 */
+    type?: SpinnerTypeInput;
 }
 declare const Spinner: {
     (props: SpinnerProps): react_jsx_runtime.JSX.Element;

package/dist/components/Spinner/index.js

@@ -1,3 +1,6 @@
+// src/tokens/interface/status.ts
+var normalizeStatus = (value) => value === "brand" ? "primary" : value;
+
 // ../../node_modules/clsx/dist/clsx.mjs
 function r(e) {
   var t, f, n = "";
@@ -19,12 +22,13 @@ import { jsx, jsxs } from "react/jsx-runtime";
 var Spinner = (props) => {
   const {
     size = "md",
-    type = "brand"
+    type = "primary"
   } = props;
+  const statusType = normalizeStatus(type);
   return /* @__PURE__ */ jsx(
     "div",
     {
-      className: clsx_default("lib-xplat-spinner", size, type),
+      className: clsx_default("lib-xplat-spinner", size, statusType),
       role: "status",
       "aria-label": "\uB85C\uB529 \uC911",
       children: /* @__PURE__ */ jsxs("svg", { viewBox: "0 0 24 24", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: [

package/dist/components/Steps/index.cjs

@@ -24,6 +24,9 @@ __export(Steps_exports, {
 });
 module.exports = __toCommonJS(Steps_exports);
 
+// src/tokens/interface/status.ts
+var normalizeStatus = (value) => value === "brand" ? "primary" : value;
+
 // src/tokens/svg/action/CopyIcon.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 
@@ -946,9 +949,10 @@ var Steps = (props) => {
   const {
     items,
     current,
-    type = "brand"
+    type = "primary"
   } = props;
-  return /* @__PURE__ */ (0, import_jsx_runtime295.jsx)("div", { className: clsx_default("lib-xplat-steps", type), children: items.map((item, index) => {
+  const statusType = normalizeStatus(type);
+  return /* @__PURE__ */ (0, import_jsx_runtime295.jsx)("div", { className: clsx_default("lib-xplat-steps", statusType), children: items.map((item, index) => {
     const status = index < current ? "completed" : index === current ? "active" : "pending";
     return /* @__PURE__ */ (0, import_jsx_runtime295.jsxs)("div", { className: clsx_default("step-item", status), children: [
       /* @__PURE__ */ (0, import_jsx_runtime295.jsx)("div", { className: "step-circle", children: status === "completed" ? /* @__PURE__ */ (0, import_jsx_runtime295.jsx)(CheckIcon_default, {}) : /* @__PURE__ */ (0, import_jsx_runtime295.jsx)("span", { children: index + 1 }) }),

package/dist/components/Steps/index.css

@@ -63,6 +63,17 @@
   color: var(--semantic-text-tertiary);
   margin-top: 2px;
 }
+.lib-xplat-steps.primary .step-item.completed .step-circle {
+  color: var(--semantic-text-inverse);
+  background-color: var(--semantic-surface-primary-default);
+}
+.lib-xplat-steps.primary .step-item.completed::after {
+  background-color: var(--semantic-surface-primary-default);
+}
+.lib-xplat-steps.primary .step-item.active .step-circle {
+  color: var(--semantic-text-inverse);
+  background-color: var(--semantic-surface-primary-default);
+}
 .lib-xplat-steps.brand .step-item.completed .step-circle {
   color: var(--semantic-text-inverse);
   background-color: var(--semantic-surface-brand-default);

package/dist/components/Steps/index.d.cts

@@ -1,14 +1,21 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { L as LegacyStatusType } from '../../status-g_KP3qT6.cjs';
 
 interface StepItem {
     title: string;
     description?: string;
 }
-type StepsType = "brand" | "success" | "error" | "warning" | "info";
+/** Steps 의 상태 색 */
+type StepsType = "primary" | "success" | "error" | "warning" | "info";
+/** 입력으로는 예전 이름 `brand` 도 받는다 (= `primary`) */
+type StepsTypeInput = StepsType | LegacyStatusType;
 interface StepsProps {
+    /** 단계 목록. 순서대로 그려진다 */
     items: StepItem[];
+    /** 진행 중인 단계 인덱스 (0부터). 앞은 완료, 뒤는 대기로 표시된다 */
     current: number;
-    type?: StepsType;
+    /** 완료·진행 단계의 색 */
+    type?: StepsTypeInput;
 }
 declare const Steps: {
     (props: StepsProps): react_jsx_runtime.JSX.Element;

package/dist/components/Steps/index.d.ts

@@ -1,14 +1,21 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { L as LegacyStatusType } from '../../status-g_KP3qT6.js';
 
 interface StepItem {
     title: string;
     description?: string;
 }
-type StepsType = "brand" | "success" | "error" | "warning" | "info";
+/** Steps 의 상태 색 */
+type StepsType = "primary" | "success" | "error" | "warning" | "info";
+/** 입력으로는 예전 이름 `brand` 도 받는다 (= `primary`) */
+type StepsTypeInput = StepsType | LegacyStatusType;
 interface StepsProps {
+    /** 단계 목록. 순서대로 그려진다 */
     items: StepItem[];
+    /** 진행 중인 단계 인덱스 (0부터). 앞은 완료, 뒤는 대기로 표시된다 */
     current: number;
-    type?: StepsType;
+    /** 완료·진행 단계의 색 */
+    type?: StepsTypeInput;
 }
 declare const Steps: {
     (props: StepsProps): react_jsx_runtime.JSX.Element;

package/dist/components/Steps/index.js

@@ -1,3 +1,6 @@
+// src/tokens/interface/status.ts
+var normalizeStatus = (value) => value === "brand" ? "primary" : value;
+
 // src/tokens/svg/action/CopyIcon.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
 
@@ -920,9 +923,10 @@ var Steps = (props) => {
   const {
     items,
     current,
-    type = "brand"
+    type = "primary"
   } = props;
-  return /* @__PURE__ */ jsx295("div", { className: clsx_default("lib-xplat-steps", type), children: items.map((item, index) => {
+  const statusType = normalizeStatus(type);
+  return /* @__PURE__ */ jsx295("div", { className: clsx_default("lib-xplat-steps", statusType), children: items.map((item, index) => {
     const status = index < current ? "completed" : index === current ? "active" : "pending";
     return /* @__PURE__ */ jsxs189("div", { className: clsx_default("step-item", status), children: [
       /* @__PURE__ */ jsx295("div", { className: "step-circle", children: status === "completed" ? /* @__PURE__ */ jsx295(CheckIcon_default, {}) : /* @__PURE__ */ jsx295("span", { children: index + 1 }) }),