@x-plat/design-system 0.10.0 → 0.12.0

package/dist/components/Select/index.css

@@ -6,6 +6,21 @@
   flex-direction: column;
   gap: var(--spacing-space-2);
 }
+.lib-xplat-field-label {
+  font-family: var(--semantic-typo-label-2-m-font);
+  font-size: var(--semantic-typo-label-2-m-size);
+  line-height: var(--semantic-typo-label-2-m-lh);
+  font-weight: var(--semantic-typo-label-2-m-weight);
+  letter-spacing: var(--semantic-typo-label-2-m-ls);
+  color: var(--semantic-text-secondary);
+  display: inline-flex;
+  align-items: center;
+  gap: var(--spacing-space-1);
+  cursor: pointer;
+}
+.lib-xplat-field-label > .required {
+  color: var(--semantic-text-error);
+}
 .lib-xplat-field-message-wrap {
   display: flex;
   gap: var(--spacing-space-2);
@@ -144,6 +159,45 @@
 .lib-xplat-select .select-trigger .select-trigger-icon svg {
   font-size: var(--semantic-typo-label-1-m-size);
 }
+.lib-xplat-select-content .select-search {
+  position: sticky;
+  top: 0;
+  z-index: 1;
+  padding: var(--spacing-space-2);
+  background-color: var(--semantic-surface-neutral-primary);
+  border-bottom: 1px solid var(--semantic-border-secondary);
+}
+.lib-xplat-select-content .select-search > input {
+  width: 100%;
+  border: 1px solid var(--semantic-border-primary);
+  border-radius: var(--spacing-radius-sm);
+  padding: var(--spacing-space-1) var(--spacing-space-2);
+  outline: none;
+  color: var(--semantic-text-primary);
+  background-color: var(--semantic-surface-neutral-primary);
+  font-family: var(--semantic-typo-label-2-m-font);
+  font-size: var(--semantic-typo-label-2-m-size);
+  line-height: var(--semantic-typo-label-2-m-lh);
+  font-weight: var(--semantic-typo-label-2-m-weight);
+  letter-spacing: var(--semantic-typo-label-2-m-ls);
+  transition: border-color 0.28s cubic-bezier(0.25, 0.46, 0.45, 0.94), box-shadow 0.28s cubic-bezier(0.25, 0.46, 0.45, 0.94);
+}
+.lib-xplat-select-content .select-search > input:focus {
+  border-color: var(--semantic-interaction-focus-ring);
+  box-shadow: 0 0 0 2px var(--semantic-interaction-overlay-10);
+  outline: 2px solid transparent;
+  outline-offset: 2px;
+}
+.lib-xplat-select-content .select-empty {
+  padding: var(--spacing-space-3);
+  text-align: center;
+  color: var(--semantic-text-tertiary);
+  font-family: var(--semantic-typo-label-2-m-font);
+  font-size: var(--semantic-typo-label-2-m-size);
+  line-height: var(--semantic-typo-label-2-m-lh);
+  font-weight: var(--semantic-typo-label-2-m-weight);
+  letter-spacing: var(--semantic-typo-label-2-m-ls);
+}
 .lib-xplat-select-content {
   position: fixed;
   z-index: 1000;
@@ -219,3 +273,6 @@
   cursor: not-allowed;
   color: var(--semantic-text-disabled);
 }
+.lib-xplat-select-content.repositioning {
+  transition: none;
+}

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

@@ -38,6 +38,17 @@ interface SelectProps {
     /** 컨트롤 아래에 표시할 검증 메시지. DS 폼 컴포넌트 공통 */
     validations?: Validation[];
     /** 메시지 없이 테두리만 붉게 한다. validations 와 함께 쓰면 둘 중 하나만 참이어도 적용된다 */
+    /** 컨트롤 위에 붙는 라벨. 클릭하면 컨트롤에 포커스가 간다 */
+    label?: React.ReactNode;
+    /** 라벨 뒤에 필수 표시(*)를 붙인다 */
+    required?: boolean;
+    /**
+     * 목록 위에 검색칸을 띄운다. 항목이 많아 스크롤로 찾기 어려울 때 켠다.
+     * 항목의 children 텍스트로 걸러낸다
+     */
+    searchable?: boolean;
+    /** 검색칸 안내 문구 */
+    searchPlaceholder?: string;
     error?: boolean;
     /** 사이즈 */
     size?: SelectSize;

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

@@ -38,6 +38,17 @@ interface SelectProps {
     /** 컨트롤 아래에 표시할 검증 메시지. DS 폼 컴포넌트 공통 */
     validations?: Validation[];
     /** 메시지 없이 테두리만 붉게 한다. validations 와 함께 쓰면 둘 중 하나만 참이어도 적용된다 */
+    /** 컨트롤 위에 붙는 라벨. 클릭하면 컨트롤에 포커스가 간다 */
+    label?: React.ReactNode;
+    /** 라벨 뒤에 필수 표시(*)를 붙인다 */
+    required?: boolean;
+    /**
+     * 목록 위에 검색칸을 띄운다. 항목이 많아 스크롤로 찾기 어려울 때 켠다.
+     * 항목의 children 텍스트로 걸러낸다
+     */
+    searchable?: boolean;
+    /** 검색칸 안내 문구 */
+    searchPlaceholder?: string;
     error?: boolean;
     /** 사이즈 */
     size?: SelectSize;

package/dist/components/Select/index.js

@@ -1,5 +1,5 @@
 // src/components/Select/Select.tsx
-import React5 from "react";
+import React6 from "react";
 
 // src/tokens/hooks/Portal.tsx
 import ReactDOM from "react-dom";
@@ -15,8 +15,10 @@ import React from "react";
 var useAutoPosition = (triggerRef, popRef, enabled = true) => {
   const [position, setPosition] = React.useState({
     position: {},
-    direction: "bottom"
+    direction: "bottom",
+    repositioning: false
   });
+  const placedRef = React.useRef(false);
   const calculatePosition = React.useCallback(() => {
     if (!triggerRef.current || !popRef.current) return;
     const triggerRect = triggerRef.current.getBoundingClientRect();
@@ -41,11 +43,16 @@ var useAutoPosition = (triggerRef, popRef, enabled = true) => {
     if (left < 8) left = 8;
     setPosition({
       position: { top, left },
-      direction
+      direction,
+      repositioning: placedRef.current
     });
+    placedRef.current = true;
   }, [triggerRef, popRef]);
   React.useLayoutEffect(() => {
-    if (!enabled) return;
+    if (!enabled) {
+      placedRef.current = false;
+      return;
+    }
     calculatePosition();
     const raf = requestAnimationFrame(calculatePosition);
     return () => cancelAnimationFrame(raf);
@@ -60,11 +67,17 @@ var useAutoPosition = (triggerRef, popRef, enabled = true) => {
   }, [calculatePosition, enabled, popRef]);
   React.useEffect(() => {
     if (!enabled) return;
-    window.addEventListener("resize", calculatePosition);
-    window.addEventListener("scroll", calculatePosition, true);
+    let raf = 0;
+    const onScrollOrResize = () => {
+      cancelAnimationFrame(raf);
+      raf = requestAnimationFrame(calculatePosition);
+    };
+    window.addEventListener("resize", onScrollOrResize, { passive: true });
+    window.addEventListener("scroll", onScrollOrResize, { passive: true, capture: true });
     return () => {
-      window.removeEventListener("resize", calculatePosition);
-      window.removeEventListener("scroll", calculatePosition, true);
+      cancelAnimationFrame(raf);
+      window.removeEventListener("resize", onScrollOrResize);
+      window.removeEventListener("scroll", onScrollOrResize, true);
     };
   }, [calculatePosition, enabled]);
   return position;
@@ -96,6 +109,30 @@ var useClickOutside = (refs, handler, enabled = true) => {
 };
 var useClickOutside_default = useClickOutside;
 
+// src/tokens/hooks/useOverlayKeyboard.ts
+import React3 from "react";
+var FOCUSABLE = [
+  "a[href]",
+  "button:not([disabled])",
+  "input:not([disabled]):not([type='hidden'])",
+  "select:not([disabled])",
+  "textarea:not([disabled])",
+  "[tabindex]:not([tabindex='-1'])"
+].join(",");
+var useEscapeKey = (enabled, onEscape) => {
+  React3.useEffect(() => {
+    if (!enabled) return;
+    const onKey = (e) => {
+      if (e.key !== "Escape") return;
+      if (e.defaultPrevented) return;
+      e.preventDefault();
+      onEscape();
+    };
+    document.addEventListener("keydown", onKey);
+    return () => document.removeEventListener("keydown", onKey);
+  }, [enabled, onEscape]);
+};
+
 // src/tokens/svg/action/CopyIcon.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
 
@@ -1126,27 +1163,32 @@ var FieldMessage = (props) => {
 };
 FieldMessage.displayName = "FieldMessage";
 var Field = (props) => {
-  const { validations, children } = props;
-  if (!validations || validations.length === 0) return /* @__PURE__ */ jsx295(Fragment, { children });
+  const { label, required = false, htmlFor, validations, children } = props;
+  const hasMessages = !!validations && validations.length > 0;
+  if (!label && !hasMessages) return /* @__PURE__ */ jsx295(Fragment, { children });
   return /* @__PURE__ */ jsxs189("div", { className: "lib-xplat-field", children: [
+    label && /* @__PURE__ */ jsxs189("label", { className: "lib-xplat-field-label", htmlFor, children: [
+      label,
+      required && /* @__PURE__ */ jsx295("span", { className: "required", "aria-hidden": "true", children: "*" })
+    ] }),
     children,
-    /* @__PURE__ */ jsx295(FieldMessage, { validations })
+    hasMessages && /* @__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);
+import React4 from "react";
+var SelectContext = React4.createContext(null);
 var context_default = SelectContext;
 
 // src/components/Select/SelectItem.tsx
-import React4 from "react";
+import React5 from "react";
 import { jsx as jsx296 } from "react/jsx-runtime";
 var SelectItem = (props) => {
   const { children, value, onClick, disabled = false } = props;
-  const ctx = React4.useContext(context_default);
+  const ctx = React5.useContext(context_default);
   const handleClick = (e) => {
     e.preventDefault();
     e.stopPropagation();
@@ -1186,32 +1228,37 @@ var SelectRoot = (props) => {
     onChange,
     children,
     disabled = false,
+    searchable = false,
+    searchPlaceholder = "\uAC80\uC0C9",
     error = false,
     validations,
+    label,
+    required,
     size = "md"
   } = props;
-  const itemChildren = React5.Children.toArray(children).filter(
-    (child) => React5.isValidElement(child) && child.type === SelectItem_default
+  const fieldId = React6.useId();
+  const itemChildren = React6.Children.toArray(children).filter(
+    (child) => React6.isValidElement(child) && child.type === SelectItem_default
   );
   const isControlled = valueProp !== void 0;
-  const [isOpen, setOpen] = React5.useState(false);
-  const [uncontrolledLabel, setUncontrolledLabel] = React5.useState(null);
-  const [uncontrolledValue, setUncontrolledValue] = React5.useState(void 0);
-  const controlledLabel = React5.useMemo(() => {
+  const [isOpen, setOpen] = React6.useState(false);
+  const [uncontrolledLabel, setUncontrolledLabel] = React6.useState(null);
+  const [uncontrolledValue, setUncontrolledValue] = React6.useState(void 0);
+  const controlledLabel = React6.useMemo(() => {
     if (!isControlled) return null;
     const match = itemChildren.find((child) => child.props.value === valueProp);
     return match ? match.props.children : null;
   }, [isControlled, valueProp, itemChildren]);
   const selectedLabel = isControlled ? controlledLabel : uncontrolledLabel;
   const selectedValue = isControlled ? valueProp : uncontrolledValue;
-  const triggerRef = React5.useRef(null);
-  const contentRef = React5.useRef(null);
-  const [mounted, setMounted] = React5.useState(false);
-  const [visible, setVisible] = React5.useState(false);
-  React5.useEffect(() => {
+  const triggerRef = React6.useRef(null);
+  const contentRef = React6.useRef(null);
+  const [mounted, setMounted] = React6.useState(false);
+  const [visible, setVisible] = React6.useState(false);
+  React6.useEffect(() => {
     if (disabled && isOpen) setOpen(false);
   }, [disabled, isOpen]);
-  React5.useEffect(() => {
+  React6.useEffect(() => {
     if (isOpen) {
       setMounted(true);
       const t2 = setTimeout(() => setVisible(true), 1);
@@ -1221,22 +1268,42 @@ var SelectRoot = (props) => {
     const t = setTimeout(() => setMounted(false), ANIMATION_DURATION_MS);
     return () => clearTimeout(t);
   }, [isOpen]);
-  const open = React5.useCallback(() => setOpen(true), []);
-  const close = React5.useCallback(() => setOpen(false), []);
-  const toggle = React5.useCallback(() => setOpen((prev) => !prev), []);
+  const [query, setQuery] = React6.useState("");
+  const textOf = (node) => {
+    if (node === null || node === void 0 || typeof node === "boolean") return "";
+    if (typeof node === "string" || typeof node === "number") return String(node);
+    if (Array.isArray(node)) return node.map(textOf).join("");
+    if (React6.isValidElement(node)) return textOf(node.props.children);
+    return "";
+  };
+  const visibleItems = React6.useMemo(() => {
+    if (!searchable || !query.trim()) return itemChildren;
+    const q = query.trim().toLowerCase();
+    return itemChildren.filter((c) => textOf(c.props.children).toLowerCase().includes(q));
+  }, [searchable, query, itemChildren]);
+  const open = React6.useCallback(() => setOpen(true), []);
+  const close = React6.useCallback(() => {
+    setOpen(false);
+    setQuery("");
+  }, []);
+  const toggle = React6.useCallback(() => setOpen((prev) => !prev), []);
   useClickOutside_default([contentRef, triggerRef], close, isOpen);
+  useEscapeKey(isOpen, () => {
+    close();
+    triggerRef.current?.focus({ preventScroll: true });
+  });
   const position = useAutoPosition_default(triggerRef, contentRef, mounted);
-  const setSelected = React5.useCallback(
-    (label, itemValue) => {
+  const setSelected = React6.useCallback(
+    (label2, itemValue) => {
       if (!isControlled) {
-        setUncontrolledLabel(label);
+        setUncontrolledLabel(label2);
         setUncontrolledValue(itemValue);
       }
-      onChange?.(itemValue, label);
+      onChange?.(itemValue, label2);
     },
     [isControlled, onChange]
   );
-  const ctxValue = React5.useMemo(
+  const ctxValue = React6.useMemo(
     () => ({
       isOpen,
       mounted,
@@ -1272,6 +1339,7 @@ var SelectRoot = (props) => {
         /* @__PURE__ */ jsxs190(
           "div",
           {
+            id: fieldId,
             ref: triggerRef,
             className: clsx_default(
               "select-trigger",
@@ -1314,20 +1382,33 @@ var SelectRoot = (props) => {
             ]
           }
         ),
-        mounted && /* @__PURE__ */ jsx297(Portal_default, { children: /* @__PURE__ */ jsx297(
+        mounted && /* @__PURE__ */ jsx297(Portal_default, { children: /* @__PURE__ */ jsxs190(
           "div",
           {
-            className: clsx_default("lib-xplat-select-content", size, position.direction, stateClass),
+            className: clsx_default("lib-xplat-select-content", size, position.direction, stateClass, position.repositioning && "repositioning"),
             ref: contentRef,
             style: { ...position.position, width: triggerRef.current?.offsetWidth },
             role: "listbox",
-            children: /* @__PURE__ */ jsx297(context_default.Provider, { value: ctxValue, children: itemChildren })
+            children: [
+              searchable && /* @__PURE__ */ jsx297("div", { className: "select-search", children: /* @__PURE__ */ jsx297(
+                "input",
+                {
+                  type: "text",
+                  value: query,
+                  placeholder: searchPlaceholder,
+                  onChange: (e) => setQuery(e.target.value),
+                  autoFocus: true,
+                  "aria-label": searchPlaceholder
+                }
+              ) }),
+              /* @__PURE__ */ jsx297(context_default.Provider, { value: ctxValue, children: visibleItems.length > 0 ? visibleItems : /* @__PURE__ */ jsx297("div", { className: "select-empty", children: "\uACB0\uACFC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4" }) })
+            ]
           }
         ) })
       ]
     }
   ) });
-  return /* @__PURE__ */ jsx297(Field, { validations, children: control });
+  return /* @__PURE__ */ jsx297(Field, { validations, label, required, htmlFor: fieldId, children: control });
 };
 SelectRoot.displayName = "Select";
 var Select = Object.assign(SelectRoot, {

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

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { L as LegacyStatusType } from '../../status-g_KP3qT6.cjs';
+import { L as LegacyStatusType } from '../../status-njWqQWFV.cjs';
 
 type SpinnerSize = "sm" | "md" | "lg";
 /** Spinner 의 상태 색 */

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

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { L as LegacyStatusType } from '../../status-g_KP3qT6.js';
+import { L as LegacyStatusType } from '../../status-njWqQWFV.js';
 
 type SpinnerSize = "sm" | "md" | "lg";
 /** Spinner 의 상태 색 */

package/dist/components/Stat/index.cjs

@@ -0,0 +1,84 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/Stat/index.ts
+var Stat_exports = {};
+__export(Stat_exports, {
+  Stat: () => Stat_default
+});
+module.exports = __toCommonJS(Stat_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 = "";
+  if ("string" == typeof e || "number" == typeof e) n += e;
+  else if ("object" == typeof e) if (Array.isArray(e)) {
+    var o = e.length;
+    for (t = 0; t < o; t++) e[t] && (f = r(e[t])) && (n && (n += " "), n += f);
+  } else for (f in e) e[f] && (n && (n += " "), n += f);
+  return n;
+}
+function clsx() {
+  for (var e, t, f = 0, n = "", o = arguments.length; f < o; f++) (e = arguments[f]) && (t = r(e)) && (n && (n += " "), n += t);
+  return n;
+}
+var clsx_default = clsx;
+
+// src/components/Stat/Stat.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var ARROW = {
+  up: "\u25B2",
+  down: "\u25BC",
+  flat: "\u2014"
+};
+var Stat = (props) => {
+  const {
+    label,
+    value,
+    unit,
+    description,
+    trend,
+    icon,
+    size = "md",
+    type = "primary"
+  } = props;
+  const statusType = normalizeStatus(type);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: clsx_default("lib-xplat-stat", size, statusType), children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "stat-label", children: label }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "stat-value-row", children: [
+      icon && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "stat-icon", children: icon }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "stat-value", children: value }),
+      unit && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "stat-unit", children: unit }),
+      trend && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { className: clsx_default("stat-trend", trend.direction), children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { "aria-hidden": "true", children: ARROW[trend.direction] }),
+        trend.value
+      ] })
+    ] }),
+    description && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "stat-description", children: description })
+  ] });
+};
+Stat.displayName = "Stat";
+var Stat_default = Stat;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Stat
+});

package/dist/components/Stat/index.css

@@ -0,0 +1,96 @@
+/* src/components/Stat/stat.scss */
+.lib-xplat-stat {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-space-1);
+}
+.lib-xplat-stat .stat-label {
+  font-family: var(--semantic-typo-caption-1-r-font);
+  font-size: var(--semantic-typo-caption-1-r-size);
+  line-height: var(--semantic-typo-caption-1-r-lh);
+  font-weight: var(--semantic-typo-caption-1-r-weight);
+  letter-spacing: var(--semantic-typo-caption-1-r-ls);
+  color: var(--semantic-text-tertiary);
+}
+.lib-xplat-stat .stat-value-row {
+  display: flex;
+  align-items: baseline;
+  gap: var(--spacing-space-2);
+}
+.lib-xplat-stat .stat-icon {
+  display: flex;
+  align-items: center;
+  align-self: center;
+  color: var(--semantic-icon-secondary);
+}
+.lib-xplat-stat .stat-value {
+  font-family: var(--semantic-typo-title-1-sb-font);
+  font-size: var(--semantic-typo-title-1-sb-size);
+  line-height: var(--semantic-typo-title-1-sb-lh);
+  font-weight: var(--semantic-typo-title-1-sb-weight);
+  letter-spacing: var(--semantic-typo-title-1-sb-ls);
+  color: var(--semantic-text-primary);
+  font-variant-numeric: tabular-nums;
+}
+.lib-xplat-stat .stat-unit {
+  font-family: var(--semantic-typo-label-2-m-font);
+  font-size: var(--semantic-typo-label-2-m-size);
+  line-height: var(--semantic-typo-label-2-m-lh);
+  font-weight: var(--semantic-typo-label-2-m-weight);
+  letter-spacing: var(--semantic-typo-label-2-m-ls);
+  color: var(--semantic-text-tertiary);
+}
+.lib-xplat-stat .stat-trend {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--spacing-space-1);
+  font-family: var(--semantic-typo-caption-1-m-font);
+  font-size: var(--semantic-typo-caption-1-m-size);
+  line-height: var(--semantic-typo-caption-1-m-lh);
+  font-weight: var(--semantic-typo-caption-1-m-weight);
+  letter-spacing: var(--semantic-typo-caption-1-m-ls);
+  font-variant-numeric: tabular-nums;
+}
+.lib-xplat-stat .stat-trend.up {
+  color: var(--semantic-text-success);
+}
+.lib-xplat-stat .stat-trend.down {
+  color: var(--semantic-text-error);
+}
+.lib-xplat-stat .stat-trend.flat {
+  color: var(--semantic-text-tertiary);
+}
+.lib-xplat-stat .stat-description {
+  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);
+  color: var(--semantic-text-tertiary);
+}
+.lib-xplat-stat.sm .stat-value {
+  font-family: var(--semantic-typo-heading-1-sb-font);
+  font-size: var(--semantic-typo-heading-1-sb-size);
+  line-height: var(--semantic-typo-heading-1-sb-lh);
+  font-weight: var(--semantic-typo-heading-1-sb-weight);
+  letter-spacing: var(--semantic-typo-heading-1-sb-ls);
+}
+.lib-xplat-stat.lg .stat-value {
+  font-family: var(--semantic-typo-display-2-sb-font);
+  font-size: var(--semantic-typo-display-2-sb-size);
+  line-height: var(--semantic-typo-display-2-sb-lh);
+  font-weight: var(--semantic-typo-display-2-sb-weight);
+  letter-spacing: var(--semantic-typo-display-2-sb-ls);
+}
+.lib-xplat-stat.success .stat-value {
+  color: var(--semantic-text-success);
+}
+.lib-xplat-stat.error .stat-value {
+  color: var(--semantic-text-error);
+}
+.lib-xplat-stat.warning .stat-value {
+  color: var(--semantic-text-warning);
+}
+.lib-xplat-stat.info .stat-value {
+  color: var(--semantic-text-info);
+}

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

@@ -0,0 +1,37 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+import { S as StatusTypeInput } from '../../status-njWqQWFV.cjs';
+
+type StatSize = "sm" | "md" | "lg";
+type TrendDirection = "up" | "down" | "flat";
+/** 큰 숫자 하나를 강조해 보여주는 칸. 대시보드의 지표 타일에 쓴다 */
+interface StatProps {
+    /** 지표 이름 (예: "총 호출 수") */
+    label: React.ReactNode;
+    /** 강조할 값. 포맷은 호출부가 정한다 (천 단위 구분·통화 기호 등) */
+    value: React.ReactNode;
+    /** 값 뒤에 붙는 단위 (예: "원", "회"). 값보다 작게 표시된다 */
+    unit?: React.ReactNode;
+    /** 값 아래 보조 설명 */
+    description?: React.ReactNode;
+    /**
+     * 증감 표시. `value` 는 이미 포맷된 문자열을 그대로 쓴다 (예: "+12.4%").
+     * `direction` 이 색과 화살표를 정한다
+     */
+    trend?: {
+        direction: TrendDirection;
+        value: React.ReactNode;
+    };
+    /** 값 왼쪽에 놓을 아이콘 */
+    icon?: React.ReactNode;
+    /** 타일 크기 */
+    size?: StatSize;
+    /** 값 색. 상태를 나타낼 때 쓴다 */
+    type?: StatusTypeInput;
+}
+declare const Stat: {
+    (props: StatProps): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+
+export { Stat };

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

@@ -0,0 +1,37 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+import { S as StatusTypeInput } from '../../status-njWqQWFV.js';
+
+type StatSize = "sm" | "md" | "lg";
+type TrendDirection = "up" | "down" | "flat";
+/** 큰 숫자 하나를 강조해 보여주는 칸. 대시보드의 지표 타일에 쓴다 */
+interface StatProps {
+    /** 지표 이름 (예: "총 호출 수") */
+    label: React.ReactNode;
+    /** 강조할 값. 포맷은 호출부가 정한다 (천 단위 구분·통화 기호 등) */
+    value: React.ReactNode;
+    /** 값 뒤에 붙는 단위 (예: "원", "회"). 값보다 작게 표시된다 */
+    unit?: React.ReactNode;
+    /** 값 아래 보조 설명 */
+    description?: React.ReactNode;
+    /**
+     * 증감 표시. `value` 는 이미 포맷된 문자열을 그대로 쓴다 (예: "+12.4%").
+     * `direction` 이 색과 화살표를 정한다
+     */
+    trend?: {
+        direction: TrendDirection;
+        value: React.ReactNode;
+    };
+    /** 값 왼쪽에 놓을 아이콘 */
+    icon?: React.ReactNode;
+    /** 타일 크기 */
+    size?: StatSize;
+    /** 값 색. 상태를 나타낼 때 쓴다 */
+    type?: StatusTypeInput;
+}
+declare const Stat: {
+    (props: StatProps): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+
+export { Stat };