@x-plat/design-system 0.8.3 → 0.10.0

package/dist/components/CheckBox/index.cjs

@@ -806,12 +806,83 @@ var CheckIcon_default = CheckIcon;
 
 // src/tokens/svg/status/ErrorIcon.tsx
 var import_jsx_runtime254 = require("react/jsx-runtime");
+var ErrorIcon = () => /* @__PURE__ */ (0, import_jsx_runtime254.jsxs)(
+  "svg",
+  {
+    xmlns: "http://www.w3.org/2000/svg",
+    width: "1em",
+    height: "1em",
+    viewBox: "0 0 16 16",
+    fill: "none",
+    children: [
+      /* @__PURE__ */ (0, import_jsx_runtime254.jsxs)("g", { clipPath: "url(#clip0_1196_9603)", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime254.jsx)(
+          "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__ */ (0, import_jsx_runtime254.jsx)(
+          "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__ */ (0, import_jsx_runtime254.jsx)("defs", { children: /* @__PURE__ */ (0, import_jsx_runtime254.jsx)("clipPath", { id: "clip0_1196_9603", children: /* @__PURE__ */ (0, import_jsx_runtime254.jsx)("rect", { width: "16", height: "16", fill: "white" }) }) })
+    ]
+  }
+);
+var ErrorIcon_default = ErrorIcon;
 
 // src/tokens/svg/status/HelpCircleIcon.tsx
 var import_jsx_runtime255 = require("react/jsx-runtime");
 
 // src/tokens/svg/status/InfoIcon.tsx
 var import_jsx_runtime256 = require("react/jsx-runtime");
+var InfoIcon = () => /* @__PURE__ */ (0, import_jsx_runtime256.jsxs)(
+  "svg",
+  {
+    xmlns: "http://www.w3.org/2000/svg",
+    width: "1em",
+    height: "1em",
+    viewBox: "0 0 16 16",
+    fill: "none",
+    children: [
+      /* @__PURE__ */ (0, import_jsx_runtime256.jsxs)("g", { clipPath: "url(#clip0_1188_11261)", children: [
+        /* @__PURE__ */ (0, import_jsx_runtime256.jsx)(
+          "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__ */ (0, import_jsx_runtime256.jsx)(
+          "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__ */ (0, import_jsx_runtime256.jsx)(
+          "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__ */ (0, import_jsx_runtime256.jsx)("defs", { children: /* @__PURE__ */ (0, import_jsx_runtime256.jsx)("clipPath", { id: "clip0_1188_11261", children: /* @__PURE__ */ (0, import_jsx_runtime256.jsx)("rect", { width: "16", height: "16", fill: "white" }) }) })
+    ]
+  }
+);
+var InfoIcon_default = InfoIcon;
 
 // src/tokens/svg/status/LoaderIcon.tsx
 var import_jsx_runtime257 = require("react/jsx-runtime");
@@ -836,6 +907,24 @@ var import_jsx_runtime263 = require("react/jsx-runtime");
 
 // src/tokens/svg/status/SuccessIcon.tsx
 var import_jsx_runtime264 = require("react/jsx-runtime");
+var SuccessIcon = () => /* @__PURE__ */ (0, import_jsx_runtime264.jsx)(
+  "svg",
+  {
+    xmlns: "http://www.w3.org/2000/svg",
+    width: "1em",
+    height: "1em",
+    viewBox: "0 0 16 16",
+    fill: "none",
+    children: /* @__PURE__ */ (0, import_jsx_runtime264.jsx)(
+      "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
 var import_jsx_runtime265 = require("react/jsx-runtime");
@@ -930,6 +1019,9 @@ var import_jsx_runtime294 = require("react/jsx-runtime");
 // src/tokens/index.ts
 var import_tokens_core2 = require("@x-plat/tokens-core");
 
+// 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 = "";
@@ -946,8 +1038,43 @@ function clsx() {
 }
 var clsx_default = clsx;
 
-// src/components/CheckBox/CheckBox.tsx
+// src/components/FieldMessage/FieldMessage.tsx
 var import_jsx_runtime295 = require("react/jsx-runtime");
+var ICON = {
+  default: /* @__PURE__ */ (0, import_jsx_runtime295.jsx)(InfoIcon_default, {}),
+  success: /* @__PURE__ */ (0, import_jsx_runtime295.jsx)(SuccessIcon_default, {}),
+  warning: /* @__PURE__ */ (0, import_jsx_runtime295.jsx)(InfoIcon_default, {}),
+  error: /* @__PURE__ */ (0, import_jsx_runtime295.jsx)(ErrorIcon_default, {})
+};
+var FieldMessage = (props) => {
+  const { validations } = props;
+  if (!validations || validations.length === 0) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime295.jsx)("div", { className: "lib-xplat-field-message-wrap", children: validations.map((v, idx) => /* @__PURE__ */ (0, import_jsx_runtime295.jsxs)(
+    "div",
+    {
+      className: clsx_default("lib-xplat-field-message", v.status),
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime295.jsx)("div", { className: "icon", children: ICON[v.status] }),
+        /* @__PURE__ */ (0, import_jsx_runtime295.jsx)("span", { children: v.message })
+      ]
+    },
+    `${v.message}_${idx}`
+  )) });
+};
+FieldMessage.displayName = "FieldMessage";
+var Field = (props) => {
+  const { validations, children } = props;
+  if (!validations || validations.length === 0) return /* @__PURE__ */ (0, import_jsx_runtime295.jsx)(import_jsx_runtime295.Fragment, { children });
+  return /* @__PURE__ */ (0, import_jsx_runtime295.jsxs)("div", { className: "lib-xplat-field", children: [
+    children,
+    /* @__PURE__ */ (0, import_jsx_runtime295.jsx)(FieldMessage, { validations })
+  ] });
+};
+Field.displayName = "Field";
+var hasError = (validations) => !!validations?.some((v) => v.status === "error");
+
+// src/components/CheckBox/CheckBox.tsx
+var import_jsx_runtime296 = require("react/jsx-runtime");
 var CheckBox = (props) => {
   const {
     checked,
@@ -956,9 +1083,11 @@ var CheckBox = (props) => {
     onChange,
     disabled,
     size = "md",
-    type = "brand",
+    type = "primary",
+    validations,
     ...rest
   } = props;
+  const statusType = normalizeStatus(type);
   const handleChange = (e) => {
     if (onChange) onChange(e);
   };
@@ -966,20 +1095,22 @@ var CheckBox = (props) => {
   const checkedClasses = `checked`;
   const disabledClasses = "disabled";
   const boxClasses = disabled ? disabledClasses : checked ? checkedClasses : uncheckedClasses;
-  return /* @__PURE__ */ (0, import_jsx_runtime295.jsxs)("label", { className: clsx_default("lib-xplat-checkbox", size, type, className), children: [
-    /* @__PURE__ */ (0, import_jsx_runtime295.jsx)(
+  const control = /* @__PURE__ */ (0, import_jsx_runtime296.jsxs)("label", { className: clsx_default("lib-xplat-checkbox", size, statusType, className), children: [
+    /* @__PURE__ */ (0, import_jsx_runtime296.jsx)(
       "input",
       {
         type: "checkbox",
         checked,
         onChange: handleChange,
         disabled,
+        "aria-invalid": hasError(validations) || void 0,
         ...rest
       }
     ),
-    /* @__PURE__ */ (0, import_jsx_runtime295.jsx)("span", { className: clsx_default("checkbox", boxClasses), children: /* @__PURE__ */ (0, import_jsx_runtime295.jsx)("span", { className: clsx_default("check-icon", { visible: checked }), children: /* @__PURE__ */ (0, import_jsx_runtime295.jsx)(CheckIcon_default, {}) }) }),
-    label && /* @__PURE__ */ (0, import_jsx_runtime295.jsx)("span", { className: "label", children: label })
+    /* @__PURE__ */ (0, import_jsx_runtime296.jsx)("span", { className: clsx_default("checkbox", boxClasses), children: /* @__PURE__ */ (0, import_jsx_runtime296.jsx)("span", { className: clsx_default("check-icon", { visible: checked }), children: /* @__PURE__ */ (0, import_jsx_runtime296.jsx)(CheckIcon_default, {}) }) }),
+    label && /* @__PURE__ */ (0, import_jsx_runtime296.jsx)("span", { className: "label", children: label })
   ] });
+  return /* @__PURE__ */ (0, import_jsx_runtime296.jsx)(Field, { validations, children: control });
 };
 CheckBox.displayName = "CheckBox";
 var CheckBox_default = CheckBox;

package/dist/components/CheckBox/index.css

@@ -1,3 +1,41 @@
+/* src/components/FieldMessage/fieldMessage.scss */
+.lib-xplat-field {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-space-2);
+}
+.lib-xplat-field-message-wrap {
+  display: flex;
+  gap: var(--spacing-space-2);
+  margin-left: var(--spacing-space-1);
+}
+.lib-xplat-field-message-wrap > .lib-xplat-field-message {
+  display: flex;
+  gap: var(--spacing-space-1);
+  font-family: var(--semantic-typo-caption-2-r-font);
+  font-size: var(--semantic-typo-caption-2-r-size);
+  line-height: var(--semantic-typo-caption-2-r-lh);
+  font-weight: var(--semantic-typo-caption-2-r-weight);
+  letter-spacing: var(--semantic-typo-caption-2-r-ls);
+  align-items: center;
+  user-select: none;
+}
+.lib-xplat-field-message-wrap > .lib-xplat-field-message.default {
+  color: var(--semantic-icon-secondary);
+}
+.lib-xplat-field-message-wrap > .lib-xplat-field-message.success {
+  color: var(--semantic-text-success);
+}
+.lib-xplat-field-message-wrap > .lib-xplat-field-message.warning {
+  color: var(--semantic-text-warning);
+}
+.lib-xplat-field-message-wrap > .lib-xplat-field-message.error {
+  color: var(--semantic-text-error);
+}
+.lib-xplat-field-message-wrap > .lib-xplat-field-message > .icon {
+  font-size: var(--semantic-typo-label-2-m-size);
+}
+
 /* src/components/CheckBox/checkbox.scss */
 .lib-xplat-checkbox {
   display: flex;
@@ -72,6 +110,7 @@
 .lib-xplat-checkbox:hover > .checkbox.unchecked {
   background-color: var(--semantic-surface-neutral-disabled);
 }
+.lib-xplat-checkbox.primary > .checkbox.checked,
 .lib-xplat-checkbox.brand > .checkbox.checked {
   background-color: var(--semantic-surface-brand-default);
 }
@@ -87,6 +126,7 @@
 .lib-xplat-checkbox.info > .checkbox.checked {
   background-color: var(--semantic-surface-info-default);
 }
+.lib-xplat-checkbox:hover.primary > .checkbox.checked,
 .lib-xplat-checkbox:hover.brand > .checkbox.checked {
   background-color: var(--semantic-surface-brand-strong);
 }

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

@@ -1,14 +1,25 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { I as InputAttributes } from '../../attributes-DJIWir_0.cjs';
+import { L as LegacyStatusType } from '../../status-g_KP3qT6.cjs';
+import { V as Validation } from '../../validation-Dqo1zqhT.cjs';
 import 'react';
 
 type CheckBoxSize = "sm" | "md" | "lg";
-type CheckBoxType = "brand" | "success" | "error" | "warning" | "info";
+/** CheckBox 의 상태 색 */
+type CheckBoxType = "primary" | "success" | "error" | "warning" | "info";
+/** 입력으로는 예전 이름 `brand` 도 받는다 (= `primary`) */
+type CheckBoxTypeInput = CheckBoxType | LegacyStatusType;
 interface CheckBoxProps extends Omit<InputAttributes, "size"> {
+    /** 체크박스 옆에 붙는 글자. 클릭하면 체크가 토글된다 */
     label?: string;
+    /** 체크 여부. 주면 controlled 가 되므로 onChange 와 함께 쓴다 */
     checked?: boolean;
+    /** 컨트롤 아래에 표시할 검증 메시지. DS 폼 컴포넌트 공통 */
+    validations?: Validation[];
+    /** 컨트롤 크기. 글자 크기도 함께 바뀐다 */
     size?: CheckBoxSize;
-    type?: CheckBoxType;
+    /** 체크됐을 때의 색 */
+    type?: CheckBoxTypeInput;
 }
 declare const CheckBox: {
     (props: CheckBoxProps): react_jsx_runtime.JSX.Element;

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

@@ -1,14 +1,25 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { I as InputAttributes } from '../../attributes-DJIWir_0.js';
+import { L as LegacyStatusType } from '../../status-g_KP3qT6.js';
+import { V as Validation } from '../../validation-Dqo1zqhT.js';
 import 'react';
 
 type CheckBoxSize = "sm" | "md" | "lg";
-type CheckBoxType = "brand" | "success" | "error" | "warning" | "info";
+/** CheckBox 의 상태 색 */
+type CheckBoxType = "primary" | "success" | "error" | "warning" | "info";
+/** 입력으로는 예전 이름 `brand` 도 받는다 (= `primary`) */
+type CheckBoxTypeInput = CheckBoxType | LegacyStatusType;
 interface CheckBoxProps extends Omit<InputAttributes, "size"> {
+    /** 체크박스 옆에 붙는 글자. 클릭하면 체크가 토글된다 */
     label?: string;
+    /** 체크 여부. 주면 controlled 가 되므로 onChange 와 함께 쓴다 */
     checked?: boolean;
+    /** 컨트롤 아래에 표시할 검증 메시지. DS 폼 컴포넌트 공통 */
+    validations?: Validation[];
+    /** 컨트롤 크기. 글자 크기도 함께 바뀐다 */
     size?: CheckBoxSize;
-    type?: CheckBoxType;
+    /** 체크됐을 때의 색 */
+    type?: CheckBoxTypeInput;
 }
 declare const CheckBox: {
     (props: CheckBoxProps): react_jsx_runtime.JSX.Element;

package/dist/components/CheckBox/index.js

@@ -780,12 +780,83 @@ var CheckIcon_default = CheckIcon;
 
 // 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";
@@ -810,6 +881,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";
@@ -904,6 +993,9 @@ import { jsx as jsx294, jsxs as jsxs188 } from "react/jsx-runtime";
 // src/tokens/index.ts
 import { cssVar } from "@x-plat/tokens-core";
 
+// 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 = "";
@@ -920,8 +1012,43 @@ 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/CheckBox/CheckBox.tsx
-import { jsx as jsx295, jsxs as jsxs189 } from "react/jsx-runtime";
+import { jsx as jsx296, jsxs as jsxs190 } from "react/jsx-runtime";
 var CheckBox = (props) => {
   const {
     checked,
@@ -930,9 +1057,11 @@ var CheckBox = (props) => {
     onChange,
     disabled,
     size = "md",
-    type = "brand",
+    type = "primary",
+    validations,
     ...rest
   } = props;
+  const statusType = normalizeStatus(type);
   const handleChange = (e) => {
     if (onChange) onChange(e);
   };
@@ -940,20 +1069,22 @@ var CheckBox = (props) => {
   const checkedClasses = `checked`;
   const disabledClasses = "disabled";
   const boxClasses = disabled ? disabledClasses : checked ? checkedClasses : uncheckedClasses;
-  return /* @__PURE__ */ jsxs189("label", { className: clsx_default("lib-xplat-checkbox", size, type, className), children: [
-    /* @__PURE__ */ jsx295(
+  const control = /* @__PURE__ */ jsxs190("label", { className: clsx_default("lib-xplat-checkbox", size, statusType, className), children: [
+    /* @__PURE__ */ jsx296(
       "input",
       {
         type: "checkbox",
         checked,
         onChange: handleChange,
         disabled,
+        "aria-invalid": hasError(validations) || void 0,
         ...rest
       }
     ),
-    /* @__PURE__ */ jsx295("span", { className: clsx_default("checkbox", boxClasses), children: /* @__PURE__ */ jsx295("span", { className: clsx_default("check-icon", { visible: checked }), children: /* @__PURE__ */ jsx295(CheckIcon_default, {}) }) }),
-    label && /* @__PURE__ */ jsx295("span", { className: "label", children: label })
+    /* @__PURE__ */ jsx296("span", { className: clsx_default("checkbox", boxClasses), children: /* @__PURE__ */ jsx296("span", { className: clsx_default("check-icon", { visible: checked }), children: /* @__PURE__ */ jsx296(CheckIcon_default, {}) }) }),
+    label && /* @__PURE__ */ jsx296("span", { className: "label", children: label })
   ] });
+  return /* @__PURE__ */ jsx296(Field, { validations, children: control });
 };
 CheckBox.displayName = "CheckBox";
 var CheckBox_default = CheckBox;

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

@@ -5,7 +5,9 @@ type ChipType = "primary" | "secondary" | "neutral" | "success" | "error" | "war
 type ChipSize = "sm" | "md" | "lg";
 interface ChipProps {
     children: React.ReactNode;
+    /** 칩 색. 상태를 나타낸다 */
     type?: ChipType;
+    /** 칩 크기 */
     size?: ChipSize;
 }
 declare const Chip: {

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

@@ -5,7 +5,9 @@ type ChipType = "primary" | "secondary" | "neutral" | "success" | "error" | "war
 type ChipSize = "sm" | "md" | "lg";
 interface ChipProps {
     children: React.ReactNode;
+    /** 칩 색. 상태를 나타낸다 */
     type?: ChipType;
+    /** 칩 크기 */
     size?: ChipSize;
 }
 declare const Chip: {