@ncds/ui-admin 1.3.0 → 1.4.1

package/dist/esm/src/components/modal/Modal.js

@@ -29,11 +29,12 @@ export var Modal = function (_a) {
     _b = _a.size,
     size = _b === void 0 ? 'md' : _b,
     _c = _a.closeOnBackdropClick,
-    closeOnBackdropClick = _c === void 0 ? true : _c,
+    closeOnBackdropClick = _c === void 0 ? false : _c,
     _d = _a.closeOnEsc,
     closeOnEsc = _d === void 0 ? true : _d,
     className = _a.className,
-    restProps = __rest(_a, ["isOpen", "onClose", "children", "size", "closeOnBackdropClick", "closeOnEsc", "className"]);
+    zIndex = _a.zIndex,
+    restProps = __rest(_a, ["isOpen", "onClose", "children", "size", "closeOnBackdropClick", "closeOnEsc", "className", "zIndex"]);
   var modalRef = useRef(null);
   var handleBackdropClick = function (e) {
     if (closeOnBackdropClick && e.target === e.currentTarget) {
@@ -59,7 +60,10 @@ export var Modal = function (_a) {
   var modalContent = _jsx("div", __assign({
     className: classnames('ncua-modal-backdrop', className),
     onClick: handleBackdropClick,
-    ref: modalRef
+    ref: modalRef,
+    style: zIndex ? {
+      zIndex: zIndex
+    } : undefined
   }, restProps, {
     children: _jsx("div", __assign({
       className: classnames('ncua-modal', "ncua-modal--".concat(size))

package/dist/esm/src/components/notification/FloatingNotification.js

@@ -18,7 +18,7 @@ var __rest = this && this.__rest || function (s, e) {
 };
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import classNames from 'classnames';
-import { forwardRef } from 'react';
+import { forwardRef, useEffect, useRef, useState } from 'react';
 import { MEDIA_QUERY } from '../../constant/breakpoint';
 import { useMediaQuery } from '../../hooks/useMediaQuery';
 import { Button } from '../button';
@@ -29,6 +29,7 @@ var iconNameMap = {
   error: 'alert-triangle',
   warning: 'alert-circle',
   success: 'check-circle'
+  // info는 floating에서는 지원하지 않음
 };
 export var FloatingNotification = /*#__PURE__*/forwardRef(function (_a, ref) {
   var title = _a.title,
@@ -38,10 +39,15 @@ export var FloatingNotification = /*#__PURE__*/forwardRef(function (_a, ref) {
     onClose = _a.onClose,
     className = _a.className,
     actions = _a.actions,
-    rest = __rest(_a, ["title", "supportingText", "color", "onClose", "className", "actions"]);
+    _c = _a.autoClose,
+    autoClose = _c === void 0 ? 0 : _c,
+    rest = __rest(_a, ["title", "supportingText", "color", "onClose", "className", "actions", "autoClose"]);
+  var _d = useState(false),
+    shouldRemove = _d[0],
+    setShouldRemove = _d[1];
   var iconColor = color;
   var featuredIconProps = {
-    name: iconNameMap[color],
+    name: iconNameMap[color] || 'pin-02',
     size: 'sm',
     color: iconColor,
     theme: 'dark-circle'
@@ -49,6 +55,31 @@ export var FloatingNotification = /*#__PURE__*/forwardRef(function (_a, ref) {
   var isMobile = useMediaQuery(MEDIA_QUERY.mobile, {
     onMatched: onClose
   });
+  // autoClose 타이머 관리
+  var timerRef = useRef(null);
+  useEffect(function () {
+    // autoClose가 0보다 크면 무조건 타이머 설정
+    if (autoClose > 0) {
+      timerRef.current = setTimeout(function () {
+        if (onClose) {
+          onClose();
+        }
+        // DOM에서 바로 제거
+        setShouldRemove(true);
+      }, autoClose);
+    }
+    // cleanup 함수: 컴포넌트 언마운트 시 타이머 정리
+    return function () {
+      if (timerRef.current) {
+        clearTimeout(timerRef.current);
+        timerRef.current = null;
+      }
+    };
+  }, [autoClose, onClose]);
+  // DOM에서 완전히 제거
+  if (shouldRemove) {
+    return null;
+  }
   return _jsxs("div", __assign({
     ref: ref,
     className: classNames('ncua-floating-notification', "ncua-floating-notification--".concat(color), className),
@@ -83,7 +114,7 @@ export var FloatingNotification = /*#__PURE__*/forwardRef(function (_a, ref) {
             children: actions.map(function (action) {
               return _jsx(Button, {
                 size: "xs",
-                hierarchy: action.hierarchy || 'link',
+                hierarchy: action.hierarchy || 'text',
                 label: action.label,
                 onClick: action === null || action === void 0 ? void 0 : action.onClick
               }, "".concat(action.label, "-").concat(action.hierarchy));

package/dist/esm/src/components/notification/FullWidthNotification.js

@@ -19,19 +19,21 @@ var __rest = this && this.__rest || function (s, e) {
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import Icon from '@ncds/ui-admin-icon/dynamic';
 import classNames from 'classnames';
-import { forwardRef } from 'react';
+import { forwardRef, useEffect, useRef, useState } from 'react';
 import { COLOR } from '../../../constant/color';
 var iconNameMap = {
   neutral: 'message-chat-square',
   error: 'alert-triangle',
   warning: 'alert-triangle',
-  success: 'check-circle'
+  success: 'check-circle',
+  info: 'info-circle'
 };
 var iconColorMap = {
   neutral: 'gray700',
   error: 'red500',
   warning: 'orange500',
-  success: 'green600'
+  success: 'green600',
+  info: 'violet600'
 };
 export var FullWidthNotification = /*#__PURE__*/forwardRef(function (_a, ref) {
   var title = _a.title,
@@ -41,11 +43,43 @@ export var FullWidthNotification = /*#__PURE__*/forwardRef(function (_a, ref) {
     onClose = _a.onClose,
     className = _a.className,
     actions = _a.actions,
-    rest = __rest(_a, ["title", "supportingText", "color", "onClose", "className", "actions"]);
+    _c = _a.autoClose,
+    autoClose = _c === void 0 ? 0 : _c,
+    supportTextLink = _a.supportTextLink,
+    onHidePermanently = _a.onHidePermanently,
+    rest = __rest(_a, ["title", "supportingText", "color", "onClose", "className", "actions", "autoClose", "supportTextLink", "onHidePermanently"]);
+  var _d = useState(false),
+    shouldRemove = _d[0],
+    setShouldRemove = _d[1];
   var closeIconSize = {
     width: 20,
     height: 20
   };
+  // autoClose 타이머 관리
+  var timerRef = useRef(null);
+  useEffect(function () {
+    // autoClose가 0보다 크면 무조건 타이머 설정
+    if (autoClose > 0) {
+      timerRef.current = setTimeout(function () {
+        if (onClose) {
+          onClose();
+        }
+        // DOM에서 바로 제거
+        setShouldRemove(true);
+      }, autoClose);
+    }
+    // cleanup 함수: 컴포넌트 언마운트 시 타이머 정리
+    return function () {
+      if (timerRef.current) {
+        clearTimeout(timerRef.current);
+        timerRef.current = null;
+      }
+    };
+  }, [autoClose, onClose]);
+  // DOM에서 완전히 제거
+  if (shouldRemove) {
+    return null;
+  }
   return _jsx("div", __assign({
     ref: ref,
     className: classNames('ncua-full-width-notification', "ncua-full-width-notification--".concat(color), className),
@@ -73,10 +107,19 @@ export var FullWidthNotification = /*#__PURE__*/forwardRef(function (_a, ref) {
               className: "ncua-full-width-notification__title"
             }, {
               children: title
-            })), supportingText && _jsx("span", __assign({
+            })), !supportTextLink && supportingText && _jsx("span", __assign({
               className: "ncua-full-width-notification__supporting-text"
             }, {
               children: supportingText
+            })), supportTextLink && supportingText && _jsx("a", __assign({
+              href: supportTextLink,
+              className: "ncua-full-width-notification__link"
+            }, {
+              children: _jsx("span", __assign({
+                className: "ncua-full-width-notification__supporting-text"
+              }, {
+                children: supportingText
+              }))
             }))]
           }))]
         })), _jsxs("div", __assign({
@@ -88,11 +131,17 @@ export var FullWidthNotification = /*#__PURE__*/forwardRef(function (_a, ref) {
             children: actions.map(function (action) {
               return _jsx("button", __assign({
                 onClick: action.onClick,
-                className: classNames('ncua-notification__action-button', "ncua-notification__action-button--".concat(action.hierarchy || 'link'))
+                className: classNames('ncua-notification__action-button', "ncua-notification__action-button--".concat(action.hierarchy || 'text'))
               }, {
                 children: action.label
               }), "".concat(action.label, "-").concat(action.hierarchy));
             })
+          })), onHidePermanently && _jsx("button", __assign({
+            type: "button",
+            className: classNames('ncua-notification__action-button', 'ncua-notification__action-button--text', 'ncua-full-width-notification__link'),
+            onClick: onHidePermanently
+          }, {
+            children: "\uB2E4\uC2DC\uBCF4\uC9C0 \uC54A\uAE30"
           })), onClose && _jsx("button", __assign({
             type: "button",
             className: "ncua-full-width-notification__close-button",

package/dist/esm/src/components/pagination/NavButton.js

@@ -42,12 +42,9 @@ var NAV_BUTTON_CONFIG = {
 };
 export var NavButton = function (_a) {
   var type = _a.type,
-    as = _a.as,
     breakPoint = _a.breakPoint,
     noPrev = _a.noPrev,
     noNext = _a.noNext,
-    href = _a.href,
-    target = _a.target,
     onClick = _a.onClick;
   var config = NAV_BUTTON_CONFIG[type];
   var isNavigationButton = type === 'first' || type === 'prev' || type === 'next' || type === 'last';
@@ -73,14 +70,5 @@ export var NavButton = function (_a) {
   };
   // key 값 별도 계산
   var buttonKey = isNavigationButton ? "".concat(breakPoint, "-").concat(type) : undefined;
-  if (as === 'a') {
-    return _jsx(Button, __assign({
-      as: "a",
-      href: href,
-      target: target
-    }, buttonProps), buttonKey);
-  }
-  return _jsx(Button, __assign({
-    as: "button"
-  }, buttonProps), buttonKey);
+  return _jsx(Button, __assign({}, buttonProps), buttonKey);
 };

package/dist/esm/src/components/pagination/Pagination.js

@@ -31,16 +31,14 @@ export var Pagination = function (_a) {
     _d = _a.pageCount,
     pageCount = _d === void 0 ? 10 : _d,
     currentPage = _a.currentPage,
-    _e = _a.as,
-    as = _e === void 0 ? 'button' : _e,
-    _f = _a.breakPoint,
-    breakPoint = _f === void 0 ? 'pc' : _f,
+    _e = _a.breakPoint,
+    breakPoint = _e === void 0 ? 'pc' : _e,
     onPageChange = _a.onPageChange,
-    restProps = __rest(_a, ["className", "totalCount", "itemCountPerPage", "pageCount", "currentPage", "as", "breakPoint", "onPageChange"]);
+    restProps = __rest(_a, ["className", "totalCount", "itemCountPerPage", "pageCount", "currentPage", "breakPoint", "onPageChange"]);
   var totalPage = Math.ceil(totalCount / itemCountPerPage);
-  var _g = useState(1),
-    start = _g[0],
-    setStart = _g[1];
+  var _f = useState(1),
+    start = _f[0],
+    setStart = _f[1];
   var noPrev = start === 1;
   var noNext = start + pageCount - 1 >= totalPage;
   var showJumpPageButton = totalPage > pageCount;
@@ -75,23 +73,17 @@ export var Pagination = function (_a) {
       children: [showJumpPageButton && _jsxs(_Fragment, {
         children: [NavButton({
           type: 'first',
-          as: as,
           breakPoint: breakPoint,
           noPrev: noPrev,
           noNext: noNext,
-          href: restProps.href || '',
-          target: restProps.target || '',
           onClick: function () {
             return handleClickButton(1);
           }
         }), NavButton({
           type: 'prev',
-          as: as,
           breakPoint: breakPoint,
           noPrev: noPrev,
           noNext: noNext,
-          href: restProps.href || '',
-          target: restProps.target || '',
           onClick: function () {
             return handleClickButton(Math.max(start - pageCount, 1));
           }
@@ -126,23 +118,17 @@ export var Pagination = function (_a) {
       })), showJumpPageButton && _jsxs(_Fragment, {
         children: [NavButton({
           type: 'next',
-          as: as,
           breakPoint: breakPoint,
           noPrev: noPrev,
           noNext: noNext,
-          href: restProps.href || '',
-          target: restProps.target || '',
           onClick: function () {
             return handleClickButton(Math.min(start + pageCount, totalPage));
           }
         }), NavButton({
           type: 'last',
-          as: as,
           breakPoint: breakPoint,
           noPrev: noPrev,
           noNext: noNext,
-          href: restProps.href || '',
-          target: restProps.target || '',
           onClick: function () {
             return handleClickButton(totalPage);
           }

package/dist/esm/src/components/progress-bar/ProgressBar.js

@@ -9,42 +9,111 @@ var __assign = this && this.__assign || function () {
   return __assign.apply(this, arguments);
 };
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useProgressBar } from './hooks/useProgressBar';
+import { SegmentBar } from './components/SegmentBar';
+import { SegmentLabels, SingleLabel } from './components/SegmentLabels';
+import { getFillColorClass } from './utils';
 export var ProgressBar = function (_a) {
   var label = _a.label,
-    value = _a.value;
-  var limitedValue = Math.min(Math.max(0, value), 100);
-  var displayValue = "".concat(limitedValue.toFixed(0), "%");
-  var progressValueStyle = label === 'top-float' || label === 'bottom-float' ? {
-    '--progress-value': "".concat(limitedValue, "%")
-  } : undefined;
-  var renderLabel = function (labelType) {
-    return _jsx("span", __assign({
-      className: "ncua-progress-bar__label ncua-progress-bar__label-".concat(labelType)
+    value = _a.value,
+    segments = _a.segments,
+    _b = _a.showZeroLabel,
+    showZeroLabel = _b === void 0 ? false : _b,
+    _c = _a.valueToPercent,
+    valueToPercent = _c === void 0 ? true : _c;
+  var _d = useProgressBar(label, value, segments, valueToPercent),
+    totalValue = _d.totalValue,
+    displayValue = _d.displayValue,
+    processedSegments = _d.processedSegments,
+    effectiveLabel = _d.effectiveLabel,
+    progressValueStyle = _d.progressValueStyle,
+    hasSegments = _d.hasSegments,
+    segmentCount = _d.segmentCount,
+    shouldSpaceOut = _d.shouldSpaceOut;
+  var isFloatingLabel = effectiveLabel === 'top-float' || effectiveLabel === 'bottom-float';
+  // segments가 1개일 때는 기존 value 방식과 동일하게 처리
+  if (hasSegments && segmentCount === 1) {
+    var singleSegment = processedSegments[0];
+    return _jsxs("div", __assign({
+      className: "ncua-progress-bar ncua-progress-bar-".concat(effectiveLabel || ''),
+      style: progressValueStyle
     }, {
-      children: displayValue
+      children: [isFloatingLabel && _jsx(SingleLabel, {
+        labelType: effectiveLabel,
+        displayValue: displayValue,
+        totalValue: totalValue,
+        showZeroLabel: showZeroLabel
+      }), _jsxs("div", __assign({
+        className: "ncua-progress-bar__content"
+      }, {
+        children: [_jsx("div", __assign({
+          className: "ncua-progress-bar__bar"
+        }, {
+          children: _jsx("div", {
+            className: "ncua-progress-bar__fill ".concat(getFillColorClass(singleSegment.color)),
+            style: {
+              width: "".concat(totalValue, "%")
+            },
+            "aria-valuenow": totalValue,
+            "aria-valuemin": 0,
+            "aria-valuemax": 100
+          })
+        })), effectiveLabel === 'right' && _jsx(SingleLabel, {
+          labelType: "right",
+          displayValue: displayValue,
+          totalValue: totalValue,
+          showZeroLabel: showZeroLabel
+        })]
+      })), effectiveLabel === 'bottom' && _jsx(SingleLabel, {
+        labelType: "bottom",
+        displayValue: displayValue,
+        totalValue: totalValue,
+        showZeroLabel: showZeroLabel
+      })]
     }));
-  };
-  var isFloatingLabel = label === 'top-float' || label === 'bottom-float';
+  }
   return _jsxs("div", __assign({
-    className: "ncua-progress-bar ncua-progress-bar-".concat(label),
+    className: "ncua-progress-bar ncua-progress-bar-".concat(effectiveLabel || ''),
     style: progressValueStyle
   }, {
-    children: [isFloatingLabel && renderLabel(label), _jsxs("div", __assign({
+    children: [isFloatingLabel && _jsx(SingleLabel, {
+      labelType: effectiveLabel,
+      displayValue: displayValue,
+      totalValue: totalValue,
+      showZeroLabel: showZeroLabel
+    }), _jsxs("div", __assign({
       className: "ncua-progress-bar__content"
     }, {
       children: [_jsx("div", __assign({
-        className: "ncua-progress-bar__bar"
+        className: "ncua-progress-bar__bar ".concat(hasSegments ? 'ncua-progress-bar__bar--segments' : '')
       }, {
-        children: _jsx("div", {
+        children: hasSegments ? _jsx(SegmentBar, {
+          segments: processedSegments,
+          shouldSpaceOut: shouldSpaceOut
+        }) : _jsx("div", {
           className: "ncua-progress-bar__fill",
           style: {
-            width: "".concat(limitedValue, "%")
+            width: "".concat(totalValue, "%")
           },
-          "aria-valuenow": limitedValue,
+          "aria-valuenow": totalValue,
           "aria-valuemin": 0,
           "aria-valuemax": 100
         })
-      })), label === 'right' && renderLabel('right')]
-    })), label === 'bottom' && renderLabel('bottom')]
+      })), effectiveLabel === 'right' && _jsx(SingleLabel, {
+        labelType: "right",
+        displayValue: displayValue,
+        totalValue: totalValue,
+        showZeroLabel: showZeroLabel
+      })]
+    })), hasSegments && segmentCount >= 2 ? _jsx(SegmentLabels, {
+      segments: processedSegments,
+      segmentCount: segmentCount,
+      showZeroLabel: showZeroLabel
+    }) : effectiveLabel === 'bottom' ? _jsx(SingleLabel, {
+      labelType: "bottom",
+      displayValue: displayValue,
+      totalValue: totalValue,
+      showZeroLabel: showZeroLabel
+    }) : null]
   }));
 };

package/dist/esm/src/components/progress-bar/components/SegmentBar.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { getFillColorClass } from '../utils';
+export var SegmentBar = function (_a) {
+  var segments = _a.segments,
+    shouldSpaceOut = _a.shouldSpaceOut;
+  return _jsx(_Fragment, {
+    children: segments.map(function (segment, index) {
+      var isFirst = index === 0;
+      var isLast = index === segments.length - 1;
+      return _jsx("div", {
+        className: "ncua-progress-bar__fill ".concat(isFirst ? 'ncua-progress-bar__fill--first' : '', " ").concat(isLast ? 'ncua-progress-bar__fill--last' : '', " ").concat(shouldSpaceOut && isLast ? 'ncua-progress-bar__fill--spaced' : '', " ").concat(getFillColorClass(segment.color)),
+        style: {
+          width: "".concat(segment.width, "%")
+        }
+      }, index);
+    })
+  });
+};

package/dist/esm/src/components/progress-bar/components/SegmentLabels.js

@@ -0,0 +1,66 @@
+var __assign = this && this.__assign || function () {
+  __assign = Object.assign || function (t) {
+    for (var s, i = 1, n = arguments.length; i < n; i++) {
+      s = arguments[i];
+      for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
+    }
+    return t;
+  };
+  return __assign.apply(this, arguments);
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+import { getLabelColorClass } from '../utils';
+export var SegmentLabels = function (_a) {
+  var segments = _a.segments,
+    segmentCount = _a.segmentCount,
+    _b = _a.showZeroLabel,
+    showZeroLabel = _b === void 0 ? false : _b;
+  if (segmentCount >= 2) {
+    return _jsx("div", __assign({
+      className: "ncua-progress-bar__labels--multiple"
+    }, {
+      children: segments.map(function (segment, index) {
+        // 0%이고 showZeroLabel이 false면 라벨 표시하지 않음
+        if (segment.value === 0 && !showZeroLabel) {
+          return null;
+        }
+        var leftPosition = 0;
+        for (var i = 0; i < index; i++) {
+          leftPosition += segments[i].width;
+        }
+        // 0%일 때는 segment 시작 위치에 맞추되, 라벨이 게이지 바를 넘어가지 않도록 조정
+        // 그 외에는 중앙에 정렬
+        var isZero = segment.value === 0;
+        // 0%일 때는 약간의 오프셋을 주어 자연스럽게 보이도록 함 (라벨 너비의 절반 정도)
+        var labelPosition = isZero ? Math.max(0, leftPosition - 1) : leftPosition + segment.width / 2;
+        var transform = isZero ? 'translateX(0)' : 'translateX(-50%)';
+        return _jsx("span", __assign({
+          className: "ncua-progress-bar__label ncua-progress-bar__label--segment ".concat(getLabelColorClass(segment.color)),
+          style: {
+            left: "".concat(labelPosition, "%"),
+            transform: transform
+          }
+        }, {
+          children: "".concat(segment.value.toFixed(0), "%")
+        }), index);
+      })
+    }));
+  }
+  return null;
+};
+export var SingleLabel = function (_a) {
+  var labelType = _a.labelType,
+    displayValue = _a.displayValue,
+    totalValue = _a.totalValue,
+    _b = _a.showZeroLabel,
+    showZeroLabel = _b === void 0 ? false : _b;
+  // 0%이고 showZeroLabel이 false면 라벨 표시하지 않음
+  if (totalValue === 0 && !showZeroLabel) {
+    return null;
+  }
+  return _jsx("span", __assign({
+    className: "ncua-progress-bar__label ncua-progress-bar__label-".concat(labelType)
+  }, {
+    children: displayValue
+  }));
+};

package/dist/esm/src/components/progress-bar/hooks/useProgressBar.js

@@ -0,0 +1,112 @@
+var __assign = this && this.__assign || function () {
+  __assign = Object.assign || function (t) {
+    for (var s, i = 1, n = arguments.length; i < n; i++) {
+      s = arguments[i];
+      for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
+    }
+    return t;
+  };
+  return __assign.apply(this, arguments);
+};
+import { useMemo } from 'react';
+import { clampValue } from '../utils';
+/**
+ * segments를 처리하여 프로그레스 바에 표시할 데이터를 계산합니다.
+ */
+var processSegments = function (segments, segmentCount, valueToPercent) {
+  // segment가 2개 이상일 때만 valueToPercent 적용 (기본값: true)
+  var shouldApplyValueToPercent = segmentCount >= 2 && valueToPercent !== false;
+  var segmentsToProcess = segments;
+  // valueToPercent 적용: segments의 합계를 100%로 규정하고 비율로 계산
+  if (shouldApplyValueToPercent) {
+    // 원본 값들의 합계 계산
+    var originalTotal_1 = segmentsToProcess.reduce(function (sum, seg) {
+      return sum + Number(seg.value);
+    }, 0);
+    if (originalTotal_1 > 0) {
+      // 각 segment를 합계 대비 비율로 변환 (합계를 100%로 규정)
+      segmentsToProcess = segmentsToProcess.map(function (segment) {
+        return {
+          value: segment.value / originalTotal_1 * 100,
+          color: segment.color
+        };
+      });
+    }
+  }
+  // 각 값 제한 (0-100 범위)
+  var limitedSegments = segmentsToProcess.map(function (segment) {
+    return {
+      value: clampValue(segment.value),
+      color: segment.color
+    };
+  });
+  // 전체 합계 계산
+  var actualTotal = limitedSegments.reduce(function (sum, seg) {
+    return sum + seg.value;
+  }, 0);
+  var total = Math.min(actualTotal, 100);
+  // 모든 segments를 좌측에서부터 연속적으로 배치 (비율로 계산)
+  var processed = limitedSegments.map(function (segment) {
+    return __assign(__assign({}, segment), {
+      width: actualTotal > 0 ? segment.value / actualTotal * total : 0
+    });
+  });
+  return {
+    totalValue: total,
+    displayValue: "".concat(total.toFixed(0), "%"),
+    processedSegments: processed,
+    shouldSpaceOut: false // 항상 왼쪽에 붙도록 통일
+  };
+};
+export var useProgressBar = function (label, value, segments, valueToPercent) {
+  var _a;
+  var hasSegments = Boolean(segments && segments.length > 0);
+  var segmentCount = (_a = segments === null || segments === void 0 ? void 0 : segments.length) !== null && _a !== void 0 ? _a : 0;
+  var _b = useMemo(function () {
+      // segments가 있을 때는 각 값을 제한하고 전체 합계를 계산
+      // value는 무시되며, 각 segment의 값을 value로 처리
+      if (hasSegments) {
+        return processSegments(segments, segmentCount, valueToPercent);
+      }
+      // value만 있을 때는 valueToPercent 무시 (이미 퍼센트로 간주)
+      if (value !== undefined) {
+        var clamped = clampValue(value);
+        return {
+          totalValue: clamped,
+          displayValue: "".concat(clamped.toFixed(0), "%"),
+          processedSegments: [],
+          shouldSpaceOut: false
+        };
+      }
+      return {
+        totalValue: 0,
+        displayValue: '0%',
+        processedSegments: [],
+        shouldSpaceOut: false
+      };
+    }, [hasSegments, segments, segmentCount, value, valueToPercent]),
+    totalValue = _b.totalValue,
+    displayValue = _b.displayValue,
+    processedSegments = _b.processedSegments,
+    shouldSpaceOut = _b.shouldSpaceOut;
+  // segment의 개수가 2이상일때는 bottom 라벨로 고정
+  var effectiveLabel = segmentCount >= 2 ? 'bottom' : label;
+  var progressValueStyle = useMemo(function () {
+    if (effectiveLabel === 'top-float' || effectiveLabel === 'bottom-float') {
+      return {
+        '--progress-value': "".concat(totalValue, "%")
+      };
+    }
+    return undefined;
+  }, [effectiveLabel, totalValue]);
+  return {
+    totalValue: totalValue,
+    displayValue: displayValue,
+    processedSegments: processedSegments,
+    effectiveLabel: effectiveLabel,
+    progressValueStyle: progressValueStyle,
+    hasSegments: hasSegments,
+    segmentCount: segmentCount,
+    shouldSpaceOut: shouldSpaceOut
+  };
+};

package/dist/esm/src/components/progress-bar/index.js

@@ -1 +1,2 @@
-export * from './ProgressBar';
+export * from './ProgressBar';
+export * from './types';

package/dist/esm/src/components/progress-bar/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/src/components/progress-bar/utils.js

@@ -0,0 +1,22 @@
+/**
+ * 색상 이름을 fill 색상 클래스명으로 변환
+ */
+export var getFillColorClass = function (color) {
+  if (!color) return '';
+  var normalizedColor = color.toLowerCase().trim();
+  return "ncua-progress-bar__fill--color-".concat(normalizedColor);
+};
+/**
+ * 색상 이름을 label 색상 클래스명으로 변환
+ */
+export var getLabelColorClass = function (color) {
+  if (!color) return '';
+  var normalizedColor = color.toLowerCase().trim();
+  return "ncua-progress-bar__label--color-".concat(normalizedColor);
+};
+/**
+ * 값을 0-100 범위로 제한
+ */
+export var clampValue = function (value) {
+  return Math.min(Math.max(0, value), 100);
+};