sellmate-design-system-react 0.3.0 → 0.5.0

package/dist/index.js

@@ -1,3 +1,4 @@
+"use client";
 import { clsx } from 'clsx';
 import { extendTailwindMerge } from 'tailwind-merge';
 import { forwardRef, useState, useEffect, useRef, useCallback, createContext, useImperativeHandle, useMemo, useContext, useId, useLayoutEffect, useSyncExternalStore, Fragment as Fragment$1 } from 'react';
@@ -12,7 +13,6 @@ import * as RDialog from '@radix-ui/react-dialog';
 import * as RCheckbox from '@radix-ui/react-checkbox';
 import * as Ariakit from '@ariakit/react';
 
-// src/lib/cn.ts
 var twMerge = extendTailwindMerge({
   extend: {
     classGroups: {
@@ -4876,73 +4876,70 @@ function SLoadingModal({
 }
 
 // src/components/SGnb/gnb.config.ts
-var belt = (p) => `var(--cmp-gnbBelt-${p})`;
-var box = (p) => `var(--cmp-gnbBox-${p})`;
-var light = (p) => `var(--cmp-light-${p})`;
-var dark = (p) => `var(--cmp-dark-${p})`;
+var gnb = (p) => `var(--cmp-gnb-${p})`;
+var box = (p) => `var(--cmp-gnb-box-${p})`;
+var belt = (p) => `var(--cmp-gnb-belt-${p})`;
+var light = (p) => `var(--cmp-gnb-light-${p})`;
+var dark = (p) => `var(--cmp-gnb-dark-${p})`;
+var HEADER_TOP = {
+  topHeight: gnb("top-height"),
+  topPaddingX: gnb("top-paddingX"),
+  topGap: gnb("top-gap"),
+  logoHeight: gnb("logo-height")
+};
 var GNB_HEADER = {
-  fix: {
-    topHeight: belt("top-height"),
-    topPaddingX: belt("top-paddingX"),
-    topGap: belt("top-gap"),
-    logoHeight: belt("logo-height")
-  },
-  full: {
-    topHeight: box("top-height"),
-    topPaddingX: box("paddingX"),
-    topGap: box("gap"),
-    // 상단바 gap (버튼 간 세부 gap 은 --cmp-gnbBox-button-gap)
-    logoHeight: box("logo-height")
-  }
+  fix: HEADER_TOP,
+  full: HEADER_TOP
 };
 var GNB_MENU = {
   box: {
-    // menu.body.padding 은 전방향 토큰 → 세로 패딩과 아이템 좌우 여백 양쪽에 쓴다
-    bodyPaddingY: box("menu-body-padding"),
-    itemMarginX: box("menu-body-padding"),
-    itemPaddingY: box("item-paddingY"),
+    // 바디 패딩·세로 패딩·chevron 은 gnb 로 통합된 공통 토큰
+    bodyPaddingY: gnb("body-padding"),
+    itemMarginX: gnb("body-padding"),
+    // 전방향 토큰 → 아이템 좌우 여백에도 사용
+    itemPaddingY: gnb("item-paddingY"),
     itemPaddingRight: box("item-paddingRight"),
     itemGap: box("item-gap"),
     itemRadius: box("item-radius"),
-    itemArrow: box("item-arrow"),
+    itemArrow: gnb("item-chevron-size"),
     depth1PaddingLeft: box("item-depth1-paddingLeft"),
     depth2PaddingLeft: box("item-depth2-paddingLeft"),
     depth3PaddingLeft: box("item-depth3-paddingLeft"),
     depth1Icon: box("item-depth1-icon"),
     depth1FontSize: 14,
-    // token: gnbBox.item.typography.bold.fontSize
+    // token: gnb.box.item.typography.selected.fontSize
     depth1LineHeight: 24,
-    // token: gnbBox.item.typography.bold.lineHeight
+    // token: gnb.box.item.typography.selected.lineHeight
     depth1FontWeight: 700,
     itemFontSize: 14,
-    // token: gnbBox.item.typography.default.fontSize
+    // token: gnb.box.item.typography.default.fontSize
     itemLineHeight: 24
-    // token: gnbBox.item.typography.default.lineHeight
+    // token: gnb.box.item.typography.default.lineHeight
   },
   belt: {
-    bodyPaddingY: belt("body-paddingY"),
+    bodyPaddingY: gnb("body-padding"),
     itemMarginX: "0px",
     // belt 토큰에 가로 여백 없음 → 풀폭 행 (들여쓰기는 depth*-paddingLeft 전담)
-    itemPaddingY: belt("item-paddingY"),
+    itemPaddingY: gnb("item-paddingY"),
     itemPaddingRight: belt("item-paddingRight"),
     itemGap: belt("item-gap"),
     itemRadius: "0px",
     // belt 토큰에 radius 없음 → 풀폭 행
-    itemArrow: belt("item-icon"),
+    itemArrow: gnb("item-chevron-size"),
     depth1PaddingLeft: belt("item-depth1-paddingLeft"),
     depth2PaddingLeft: belt("item-depth2-paddingLeft"),
     depth3PaddingLeft: belt("item-depth3-paddingLeft"),
-    depth1Icon: box("item-depth1-icon"),
-    // belt 토큰에 depth1-icon 없음 → box 값(20) 공유
+    depth1Icon: belt("item-depth1-icon"),
+    // belt 전용 depth1 아이콘 토큰(16)
     depth1FontSize: 13,
-    // token: gnbBelt.item.depth1.typography.fontSize
+    // token: gnb.belt.item.depth1.typography.fontSize
     depth1LineHeight: 22,
-    // token: gnbBelt.item.depth1.typography.lineHeight
+    // token: gnb.belt.item.depth1.typography.lineHeight
     depth1FontWeight: 700,
     itemFontSize: 12,
-    // token: gnbBelt.item.typography.default.fontSize
+    // token: gnb.belt.item.typography.default.fontSize
     itemLineHeight: 20
-    // token: gnbBelt.item.typography.default.lineHeight
+    // token: gnb.belt.item.typography.default.lineHeight
   }
 };
 var GNB_COLORS = {
@@ -4955,7 +4952,9 @@ var GNB_COLORS = {
     itemColorDefault: light("item-fg-default"),
     itemColorHover: light("item-fg-hover"),
     itemColorActive: light("item-fg-selected"),
-    itemChevron: light("item-chevron")
+    itemChevron: light("item-chevron"),
+    itemIcon: "grey_65",
+    railFgDefault: light("rail-fg-default")
   },
   dark: {
     panelBg: dark("bg"),
@@ -4966,19 +4965,41 @@ var GNB_COLORS = {
     itemColorDefault: dark("item-fg-default"),
     itemColorHover: dark("item-fg-hover"),
     itemColorActive: dark("item-fg-selected"),
-    itemChevron: dark("item-chevron")
+    itemChevron: dark("item-chevron"),
+    itemIcon: "grey_55",
+    railFgDefault: dark("rail-fg-default")
   }
 };
 var GNB_COMMON = {
   /** 접힘 레일 폭. header="full" 은 접으면 메뉴만 사라져 레일이 없으므로 fix 전용. */
-  foldWidth: belt("fold-width"),
-  /**
-   * 상단바 아이콘 버튼 사이 간격. fix 레일(세로 스택)의 gap·상하 여백에 쓴다.
-   * 레일 전용 여백 토큰이 따로 없어 같은 값(8px)인 이 토큰으로 재해석했다.
-   */
-  buttonGap: box("button-gap")
-};
+  foldWidth: gnb("fold-width")
+};
+var GNB_RAIL = {
+  padding: gnb("rail-padding"),
+  gap: gnb("rail-gap"),
+  itemWidth: gnb("rail-item-width"),
+  itemPaddingTop: gnb("rail-item-paddingTop"),
+  itemPaddingBottom: gnb("rail-item-paddingBottom"),
+  itemRadius: gnb("rail-item-radius"),
+  itemIcon: gnb("rail-item-icon"),
+  // 타이포 (theme.css 에 gnb 타이포 변수 없음 → 토큰 값 직접 명시)
+  itemFontSize: 11,
+  // token: gnb.rail.item.typography.default.fontSize
+  itemLineHeight: 18,
+  // token: gnb.rail.item.typography.default.lineHeight
+  itemFontWeight: 500,
+  // token: gnb.rail.item.typography.default.fontWeight
+  itemFontWeightSelected: 700
+  // token: gnb.rail.item.typography.selected.fontWeight
+};
+var GNB_RAIL_WIDTH = 68;
+var GNB_FOLD_MS = 200;
+var GNB_EXPAND_MS = 200;
 var GNB_MENU_WIDTH = 240;
+function findGnbRailValue(items, value) {
+  if (items.some((item) => item.value === value)) return value;
+  return findGnbAncestors(items, value)[0];
+}
 function findGnbAncestors(items, value) {
   const walk = (list, trail) => {
     for (const item of list) {
@@ -5001,6 +5022,7 @@ function useSLayout() {
 var SLayout = forwardRef(function SLayout2({
   type = "box",
   header = "fix",
+  useRail = false,
   folded,
   defaultFolded = false,
   onFoldedChange,
@@ -5020,13 +5042,17 @@ var SLayout = forwardRef(function SLayout2({
     [isControlled, onFoldedChange]
   );
   const ctx = useMemo(
-    () => ({ type, header, folded: currentFolded, setFolded }),
-    [type, header, currentFolded, setFolded]
+    () => ({ type, header, useRail, folded: currentFolded, setFolded }),
+    [type, header, useRail, currentFolded, setFolded]
   );
   const isFullHeader = header === "full";
+  const gnbColumnWidth = useRail ? GNB_RAIL_WIDTH + GNB_MENU_WIDTH : GNB_MENU_WIDTH;
   const frameStyle = isFullHeader ? {
-    gridTemplateColumns: `${currentFolded ? 0 : GNB_MENU_WIDTH}px 1fr`,
-    gridTemplateRows: `${GNB_HEADER[header].topHeight} 1fr`
+    gridTemplateColumns: `${currentFolded ? 0 : gnbColumnWidth}px 1fr`,
+    gridTemplateRows: `${GNB_HEADER[header].topHeight} 1fr`,
+    // 메뉴가 미끄러지는 동안 페이지 열도 같은 길이로 따라와야 한 덩어리로 읽힌다.
+    // (fix 는 SGnb 가 제 폭을 직접 전환하므로 프레임이 손댈 게 없다)
+    transition: `grid-template-columns ${GNB_FOLD_MS}ms ease-out`
   } : void 0;
   return /* @__PURE__ */ jsx(SLayoutContext.Provider, { value: ctx, children: /* @__PURE__ */ jsx(
     "div",
@@ -5051,8 +5077,10 @@ var SGnb = forwardRef(function SGnb2({
   header: headerProp,
   color = "light",
   items,
+  useRail: useRailProp,
   value = "",
   onValueChange,
+  onRailChange,
   folded: foldedProp,
   onFoldChange,
   onLauncherClick,
@@ -5066,6 +5094,7 @@ var SGnb = forwardRef(function SGnb2({
   const type = typeProp ?? layout?.type ?? "box";
   const header = headerProp ?? layout?.header ?? "fix";
   const folded = foldedProp ?? layout?.folded ?? false;
+  const useRail = useRailProp ?? layout?.useRail ?? false;
   const H = GNB_HEADER[header];
   const M = GNB_MENU[type];
   const C = GNB_COLORS[color];
@@ -5073,6 +5102,9 @@ var SGnb = forwardRef(function SGnb2({
     () => new Set(findGnbAncestors(items, value))
   );
   const [hoveredKey, setHoveredKey] = useState(null);
+  const [activeRail, setActiveRail] = useState(
+    () => findGnbRailValue(items, value) ?? items[0]?.value
+  );
   useEffect(() => {
     const ancestors = findGnbAncestors(items, value);
     if (ancestors.length === 0) return;
@@ -5083,6 +5115,15 @@ var SGnb = forwardRef(function SGnb2({
       return next;
     });
   }, [items, value]);
+  useEffect(() => {
+    const owner = findGnbRailValue(items, value);
+    if (owner !== void 0) setActiveRail(owner);
+  }, [items, value]);
+  useEffect(() => {
+    setActiveRail(
+      (prev) => prev !== void 0 && items.some((item) => item.value === prev) ? prev : items[0]?.value
+    );
+  }, [items]);
   const toggleExpand = (key) => {
     setExpandedKeys((prev) => {
       const next = new Set(prev);
@@ -5099,16 +5140,58 @@ var SGnb = forwardRef(function SGnb2({
     }
     onValueChange?.(item.value);
   };
+  const handleRailClick = (item) => {
+    if (item.disabled) return;
+    setActiveRail(item.value);
+    onRailChange?.(item.value);
+    if (!item.children || item.children.length === 0) onValueChange?.(item.value);
+  };
   const handleFoldToggle = () => {
     const next = !folded;
     onFoldChange?.(next);
     if (foldedProp === void 0) layout?.setFolded(next);
   };
-  const renderItem = (item, depth) => {
+  const renderRailItem = (item) => {
+    const isActive = item.value === activeRail;
+    const isHovered = hoveredKey === item.value && !item.disabled;
+    return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs(
+      "button",
+      {
+        type: "button",
+        disabled: item.disabled,
+        "aria-current": isActive ? "true" : void 0,
+        className: "box-border flex select-none flex-col items-center border-none bg-transparent transition-colors duration-150",
+        style: {
+          width: GNB_RAIL.itemWidth,
+          paddingTop: GNB_RAIL.itemPaddingTop,
+          paddingBottom: GNB_RAIL.itemPaddingBottom,
+          borderRadius: GNB_RAIL.itemRadius,
+          backgroundColor: isActive ? C.itemBgSelected : isHovered ? C.itemBgHover : C.itemBgDefault,
+          color: isActive ? C.itemColorActive : C.railFgDefault,
+          // <button> 의 UA 폰트를 끊고 앱 폰트를 잇는다 (메뉴 아이템과 같은 이유)
+          fontFamily: "inherit",
+          fontSize: GNB_RAIL.itemFontSize,
+          lineHeight: `${GNB_RAIL.itemLineHeight}px`,
+          fontWeight: isActive ? GNB_RAIL.itemFontWeightSelected : GNB_RAIL.itemFontWeight,
+          opacity: item.disabled ? 0.4 : 1,
+          cursor: item.disabled ? "not-allowed" : "pointer"
+        },
+        onClick: () => handleRailClick(item),
+        onMouseEnter: () => setHoveredKey(item.value),
+        onMouseLeave: () => setHoveredKey((prev) => prev === item.value ? null : prev),
+        children: [
+          item.icon && /* @__PURE__ */ jsx(SIcon, { name: item.icon, size: GNB_RAIL.itemIcon, className: "shrink-0" }),
+          /* @__PURE__ */ jsx("span", { className: "w-full overflow-hidden text-ellipsis whitespace-nowrap text-center", children: item.label })
+        ]
+      }
+    ) }, item.value);
+  };
+  const renderItem = (item, depth, branchHasIcon = false) => {
     const hasChildren = !!(item.children && item.children.length > 0);
     const isSelected = !hasChildren && item.value === value;
     const isExpanded = expandedKeys.has(item.value);
     const isHovered = hoveredKey === item.value && !item.disabled;
+    const iconBranch = depth === 1 ? !!item.icon : branchHasIcon;
     const itemStyle = {
       gap: M.itemGap,
       paddingTop: M.itemPaddingY,
@@ -5145,8 +5228,11 @@ var SGnb = forwardRef(function SGnb2({
             onMouseEnter: () => setHoveredKey(item.value),
             onMouseLeave: () => setHoveredKey((prev) => prev === item.value ? null : prev),
             children: [
-              depth === 1 && item.icon && /* @__PURE__ */ jsx(SIcon, { name: item.icon, size: M.depth1Icon, className: "shrink-0" }),
-              /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 overflow-hidden text-ellipsis whitespace-nowrap", children: item.label }),
+              depth === 1 && item.icon && /* @__PURE__ */ jsx(SIcon, { name: item.icon, size: M.depth1Icon, color: C.itemIcon, className: "shrink-0" }),
+              /* @__PURE__ */ jsxs("span", { className: "min-w-0 flex-1 overflow-hidden text-ellipsis whitespace-nowrap flex flex-no-wrap items-center", children: [
+                depth > 1 && iconBranch ? /* @__PURE__ */ jsx("div", { className: "w-[20px] h-[24px] flex items-center justify-center mr-[8px]", children: "-" }) : null,
+                item.label
+              ] }),
               item.tag !== void 0 && item.tag !== "" && /* @__PURE__ */ jsx(
                 STag,
                 {
@@ -5164,28 +5250,53 @@ var SGnb = forwardRef(function SGnb2({
                   size: M.itemArrow,
                   color: C.itemChevron,
                   rotate: isExpanded ? 180 : 0,
-                  className: "shrink-0 transition-transform duration-150"
+                  className: "shrink-0 transition-transform duration-200"
                 }
               )
             ]
           }
         ),
-        hasChildren && isExpanded && /* @__PURE__ */ jsx("ul", { className: "m-0 flex list-none flex-col p-0", children: item.children.map((child) => renderItem(child, depth + 1)) })
+        hasChildren && /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: "grid",
+            style: {
+              gridTemplateRows: isExpanded ? "1fr" : "0fr",
+              transition: `grid-template-rows ${GNB_EXPAND_MS}ms ease-out`
+            },
+            children: /* @__PURE__ */ jsx(
+              "ul",
+              {
+                className: "m-0 flex min-h-0 list-none flex-col overflow-hidden p-0",
+                style: {
+                  visibility: isExpanded ? "visible" : "hidden",
+                  transition: `visibility 0s linear ${isExpanded ? "0s" : `${GNB_EXPAND_MS}ms`}`
+                },
+                children: item.children.map((child) => renderItem(child, depth + 1, iconBranch))
+              }
+            )
+          }
+        )
       ] }, item.value)
     );
   };
+  const railItems = useRail ? items : [];
+  const menuItems = useRail ? items.find((item) => item.value === activeRail)?.children ?? [] : items;
+  const bodyWidth = useRail ? GNB_RAIL_WIDTH + GNB_MENU_WIDTH : GNB_MENU_WIDTH;
   const railFolded = folded && header === "fix";
-  const rootWidth = header === "full" ? "100%" : folded ? GNB_COMMON.foldWidth : GNB_MENU_WIDTH;
+  const rootWidth = header === "full" ? "100%" : folded ? GNB_COMMON.foldWidth : bodyWidth;
   const rootStyle = {
     width: rootWidth,
+    transition: `width ${GNB_FOLD_MS}ms ease-out`,
     ...header === "full" ? { gridArea: "1 / 1 / -1 / -1", pointerEvents: "none" } : { backgroundColor: C.panelBg },
     ...style
   };
+  const hideAfterSlide = (hidden) => `visibility 0s linear ${hidden ? `${GNB_FOLD_MS}ms` : "0s"}`;
   return /* @__PURE__ */ jsxs(
     "div",
     {
       ref,
-      className: cn("box-border flex h-full shrink-0 flex-col", className),
+      className: cn("box-border flex h-full shrink-0 flex-col overflow-hidden", className),
       style: rootStyle,
       "data-type": type,
       "data-header": header,
@@ -5195,30 +5306,47 @@ var SGnb = forwardRef(function SGnb2({
         /* @__PURE__ */ jsxs(
           "div",
           {
-            className: cn("box-border flex items-center", railFolded && "flex-col"),
+            className: "relative box-border flex shrink-0 items-center overflow-hidden",
             style: {
-              gap: railFolded ? GNB_COMMON.buttonGap : H.topGap,
-              height: railFolded ? "auto" : H.topHeight,
-              padding: railFolded ? `${GNB_COMMON.buttonGap} 0` : `0 ${H.topPaddingX}`,
+              height: H.topHeight,
+              padding: `0 ${railFolded ? GNB_RAIL.padding : H.topPaddingX}`,
               borderBottom: `1px solid ${C.topBorder}`,
               backgroundColor: C.panelBg,
               pointerEvents: "auto",
+              transition: `padding ${GNB_FOLD_MS}ms ease-out`,
               // 아이콘 버튼은 자체 ghostButton 토큰을 쓰므로, 이 색은 logo 슬롯 상속용
               color: C.itemColorDefault
             },
             children: [
-              onLauncherClick && /* @__PURE__ */ jsx(
-                SGhostButton,
+              (onLauncherClick || logo) && /* @__PURE__ */ jsxs(
+                "div",
                 {
-                  icon: "launcher",
-                  size: "xs",
-                  intent: color === "dark" ? "inverse" : "default",
-                  ariaLabel: "app launcher",
-                  onClick: onLauncherClick,
-                  className: "shrink-0"
+                  className: "absolute inset-y-0 flex items-center",
+                  style: {
+                    left: H.topPaddingX,
+                    gap: H.topGap,
+                    opacity: railFolded ? 0 : 1,
+                    transition: `opacity ${GNB_FOLD_MS}ms ease-out, ${hideAfterSlide(railFolded)}, transform ${GNB_FOLD_MS}ms ease-out`,
+                    // 메뉴와 같은 방향으로 빠지되, 좁은 레일 안에서 꼬리가 비치지 않게 페이드가 거리를 대신한다
+                    transform: railFolded ? `translateX(-${H.topPaddingX})` : "none",
+                    visibility: railFolded ? "hidden" : "visible"
+                  },
+                  children: [
+                    onLauncherClick && /* @__PURE__ */ jsx(
+                      SGhostButton,
+                      {
+                        icon: "launcher",
+                        size: "xs",
+                        intent: color === "dark" ? "inverse" : "default",
+                        ariaLabel: "app launcher",
+                        onClick: onLauncherClick,
+                        className: "shrink-0"
+                      }
+                    ),
+                    logo && /* @__PURE__ */ jsx("div", { className: "flex items-center", style: { height: H.logoHeight }, children: logo })
+                  ]
                 }
               ),
-              !railFolded && logo && /* @__PURE__ */ jsx("div", { className: "flex items-center", style: { height: H.logoHeight }, children: logo }),
               /* @__PURE__ */ jsx(
                 SGhostButton,
                 {
@@ -5228,30 +5356,61 @@ var SGnb = forwardRef(function SGnb2({
                   ariaLabel: "toggle navigation",
                   ariaPressed: folded,
                   onClick: handleFoldToggle,
-                  className: cn("shrink-0", !railFolded && "ml-auto")
+                  className: "ml-auto shrink-0"
                 }
               )
             ]
           }
         ),
-        !folded && /* @__PURE__ */ jsx(
-          "nav",
+        /* @__PURE__ */ jsxs(
+          "div",
           {
-            "aria-label": ariaLabel,
-            className: "flex flex-col overflow-y-auto",
+            className: "flex flex-row",
             style: {
-              width: GNB_MENU_WIDTH,
+              width: bodyWidth,
               alignSelf: "flex-start",
               flexGrow: 1,
               flexShrink: 1,
               flexBasis: "auto",
               minHeight: 0,
-              paddingTop: M.bodyPaddingY,
-              paddingBottom: M.bodyPaddingY,
-              backgroundColor: C.panelBg,
-              pointerEvents: "auto"
+              transform: folded ? "translateX(-100%)" : "none",
+              visibility: folded ? "hidden" : "visible",
+              transition: `transform ${GNB_FOLD_MS}ms ease-out, ${hideAfterSlide(folded)}`
             },
-            children: /* @__PURE__ */ jsx("ul", { className: "m-0 flex list-none flex-col p-0", children: items.map((item) => renderItem(item, 1)) })
+            children: [
+              useRail && // 레일도 내비게이션 landmark — nav 로 세워야 aria-label(레일)이 스크린리더에 노출된다
+              // (role 없는 ul 의 aria-label 은 영역명으로 읽히지 않는다). 메뉴 nav 와는 레이블로 구분된다.
+              /* @__PURE__ */ jsx(
+                "nav",
+                {
+                  "aria-label": `${ariaLabel} rail`,
+                  className: "flex shrink-0 flex-col overflow-y-auto",
+                  style: {
+                    width: GNB_RAIL_WIDTH,
+                    padding: GNB_RAIL.padding,
+                    borderRight: `1px solid ${C.topBorder}`,
+                    backgroundColor: C.panelBg,
+                    pointerEvents: "auto"
+                  },
+                  children: /* @__PURE__ */ jsx("ul", { className: "m-0 flex list-none flex-col p-0", style: { gap: GNB_RAIL.gap }, children: railItems.map(renderRailItem) })
+                }
+              ),
+              /* @__PURE__ */ jsx(
+                "nav",
+                {
+                  "aria-label": ariaLabel,
+                  className: "flex shrink-0 flex-col overflow-y-auto",
+                  style: {
+                    width: GNB_MENU_WIDTH,
+                    paddingTop: M.bodyPaddingY,
+                    paddingBottom: M.bodyPaddingY,
+                    backgroundColor: C.panelBg,
+                    pointerEvents: "auto"
+                  },
+                  children: /* @__PURE__ */ jsx("ul", { className: "m-0 flex list-none flex-col p-0", children: menuItems.map((item) => renderItem(item, 1)) })
+                }
+              )
+            ]
           }
         )
       ]
@@ -5265,7 +5424,7 @@ var SPage = forwardRef(function SPage2({ className, style, children, ...rest },
     "main",
     {
       ref,
-      className: cn("box-border min-h-0 min-w-0 flex-1 overflow-auto p-24", className),
+      className: cn("box-border min-h-0 min-w-0 flex-1 overflow-auto p-20", className),
       style: { ...gridStyle, ...style },
       ...rest,
       children
@@ -5307,6 +5466,7 @@ function STabs({
 }) {
   const s = TAB_MAIN_SIZE[size];
   const blue = TAB_MAIN_COLORS.selected.border;
+  const isVertical = isSub && vertical;
   const tabRefs = useRef([]);
   const moveTo = (target) => {
     if (target < 0 || target >= tabs.length) return;
@@ -5314,19 +5474,17 @@ function STabs({
     tabRefs.current[target]?.focus();
   };
   const containerStyle = { ...style };
-  if (!isSub) {
-    if (vertical) containerStyle.borderRight = `1px solid ${blue}`;
-    else containerStyle.borderBottom = `1px solid ${blue}`;
-  }
+  if (!isSub) containerStyle.borderBottom = `1px solid ${blue}`;
   return /* @__PURE__ */ jsx(
     "div",
     {
       role: "tablist",
-      "aria-orientation": vertical ? "vertical" : "horizontal",
+      "aria-orientation": isVertical ? "vertical" : "horizontal",
       className: cn(
-        "inline-flex w-fit",
-        vertical ? "flex-col items-stretch" : "flex-row",
-        isSub ? vertical ? "gap-[16px]" : "gap-[24px]" : "gap-[4px]",
+        // main(가로): baseline(하단 divider)이 100% 너비로 채워지도록 w-full
+        isSub ? "inline-flex w-fit" : "flex w-full",
+        isVertical ? "flex-col items-stretch" : "flex-row",
+        isSub ? isVertical ? "gap-[16px]" : "gap-[24px]" : "gap-[4px]",
         className
       ),
       style: containerStyle,
@@ -5355,22 +5513,12 @@ function STabs({
             color: selected ? TAB_MAIN_COLORS.selected.text : TAB_MAIN_COLORS.default.text,
             border: `1px solid ${border}`,
             // 폴더형: 미선택 탭은 baseline 위에, 선택 탭은 baseline(파란선)을 1px 덮어 연결된 것처럼 보이게
-            ...vertical ? {
-              borderTopLeftRadius: 6,
-              borderBottomLeftRadius: 6,
-              borderTopRightRadius: 0,
-              borderBottomRightRadius: 0,
-              justifyContent: "flex-start",
-              borderRight: selected ? `1px solid ${selectedBg}` : "none",
-              marginRight: selected ? -1 : 0
-            } : {
-              borderTopLeftRadius: 6,
-              borderTopRightRadius: 6,
-              borderBottomLeftRadius: 0,
-              borderBottomRightRadius: 0,
-              borderBottom: selected ? `1px solid ${selectedBg}` : "none",
-              marginBottom: selected ? -1 : 0
-            }
+            borderTopLeftRadius: 6,
+            borderTopRightRadius: 6,
+            borderBottomLeftRadius: 0,
+            borderBottomRightRadius: 0,
+            borderBottom: selected ? `1px solid ${selectedBg}` : "none",
+            marginBottom: selected ? -1 : 0
           };
         }
         return /* @__PURE__ */ jsxs(
@@ -5390,8 +5538,8 @@ function STabs({
                 select();
                 return;
               }
-              const nextKey = vertical ? "ArrowDown" : "ArrowRight";
-              const prevKey = vertical ? "ArrowUp" : "ArrowLeft";
+              const nextKey = isVertical ? "ArrowDown" : "ArrowRight";
+              const prevKey = isVertical ? "ArrowUp" : "ArrowLeft";
               if (e.key === nextKey) {
                 e.preventDefault();
                 moveTo((i + 1) % tabs.length);
@@ -6632,7 +6780,7 @@ var STable = forwardRef(function STable2({
             ref: scrollRef,
             onScroll: handleScroll,
             className: cn(
-              "relative overflow-auto border border-solid border-[color:var(--cmp-table-border-color)]",
+              "bg-white relative overflow-auto border border-solid border-[color:var(--cmp-table-border-color)]",
               radiusClass,
               // 원본 sd-table__scroll-container--loading/--no-data: 로딩·데이터 없음 시 스크롤·인터랙션 차단
               (isLoading || rowCount === 0) && "overflow-hidden pointer-events-none"
@@ -9806,6 +9954,856 @@ var SBarcodeInput = forwardRef(
   }
 );
 
-export { BADGE_COLORS, BUTTON_COLORS, BUTTON_SIZES, COLOR_KEYS, GNB_COLORS, GNB_COMMON, GNB_HEADER, GNB_MENU, GNB_MENU_WIDTH, ICONS, SActionModal, SBadge, SBarcodeInput, SButton, SCalendar, SCallout, SCard, SCheckbox, SChip, SChipInput, SCircleProgress, SConfirmModal, SDatePicker, SDateRangePicker, SDivider, SDropdownButton, SField, SFilePicker, SForm, SGhostButton, SGnb, SGuide, SIcon, SInput, SKeyValueTable, SLayout, SLayoutContext, SLinearProgress, SLoadingContainer, SLoadingModal, SLoadingViewport, SNumberInput, SPage, SPagination, SPopover, SPopup, SPortal, SRadio, SRadioButton, SRadioGroup, SSelect, SSwitch, STable, STabs, STag, STextLink, STextarea, SToast, SToastContainer, SToggle, STooltip, TAG_COLORS, TAG_SHAPES, TAG_SIZES, buttonPreset, cn, findGnbAncestors, isColorKey, loading, resolveColor, useSLayout };
+// src/components/STimePicker/timepicker.config.ts
+var V2 = (path) => `var(--cmp-timepicker-${path})`;
+var TIMEPICKER_SIZES = ["sm", "md"];
+var TIMEPICKER_SIZE_CONFIG = {
+  sm: {
+    height: V2("sm-height"),
+    paddingX: V2("sm-paddingX"),
+    gap: V2("sm-gap"),
+    icon: V2("sm-icon"),
+    radius: V2("sm-radius"),
+    // TODO: component.timepicker 토큰에 typography가 추가되면 CSS 변수로 교체한다.
+    fontSize: 12,
+    lineHeight: 20,
+    minWidth: 80,
+    fieldMinWidth: 128
+  },
+  md: {
+    height: V2("md-height"),
+    paddingX: V2("md-paddingX"),
+    gap: V2("md-gap"),
+    icon: V2("md-icon"),
+    radius: V2("md-radius"),
+    // TODO: component.timepicker 토큰에 typography가 추가되면 CSS 변수로 교체한다.
+    fontSize: 14,
+    lineHeight: 24,
+    minWidth: 96,
+    fieldMinWidth: 160
+  }
+};
+function clampTimePart(value, min, max) {
+  if (!Number.isFinite(value)) return min;
+  return Math.min(Math.max(value, min), max);
+}
+function padTimePart(value) {
+  return String(value).padStart(2, "0");
+}
+function parseTimeValue(value) {
+  const match = /^(\d{1,2}):(\d{1,2})$/.exec(value ?? "");
+  if (!match) return { hour: 0, minute: 0 };
+  return {
+    hour: clampTimePart(Number(match[1]), 0, 23),
+    minute: clampTimePart(Number(match[2]), 0, 59)
+  };
+}
+function formatTimeValue(hour, minute) {
+  return `${padTimePart(clampTimePart(hour, 0, 23))}:${padTimePart(clampTimePart(minute, 0, 59))}`;
+}
+function formatTimeDisplay(value, type) {
+  if (value == null || value === "") return "";
+  const { hour, minute } = parseTimeValue(value);
+  if (type === "default") return formatTimeValue(hour, minute);
+  const meridiem = hour >= 12 ? "\uC624\uD6C4" : "\uC624\uC804";
+  const displayHour = hour % 12 === 0 ? 12 : hour % 12;
+  return `${meridiem} ${padTimePart(displayHour)}:${padTimePart(minute)}`;
+}
+function TimeSelector({
+  value,
+  useMeridiem,
+  minuteStep,
+  onChange
+}) {
+  const parsed = useMemo(() => parseTimeValue(value), [value]);
+  const [hour, setHour] = useState(parsed.hour);
+  const [minute, setMinute] = useState(parsed.minute);
+  const [editingPart, setEditingPart] = useState(null);
+  const [inputDraft, setInputDraft] = useState({});
+  useEffect(() => {
+    setHour(parsed.hour);
+    setMinute(parsed.minute);
+  }, [parsed.hour, parsed.minute]);
+  const meridiem = hour >= 12 ? "PM" : "AM";
+  const displayHour = useMeridiem ? hour % 12 === 0 ? 12 : hour % 12 : hour;
+  const commit = (nextHour, nextMinute) => {
+    const h = clampTimePart(nextHour, 0, 23);
+    const m = clampTimePart(nextMinute, 0, 59);
+    setHour(h);
+    setMinute(m);
+    onChange(formatTimeValue(h, m));
+  };
+  const setMeridiem = (next) => {
+    if (next === meridiem) return;
+    commit(next === "AM" ? hour - 12 : hour + 12, minute);
+  };
+  const changeMinute = (delta) => {
+    const next = minute + delta;
+    if (next > 59) {
+      commit((hour + 1) % 24, next - 60);
+      return;
+    }
+    if (next < 0) {
+      commit((hour + 23) % 24, next + 60);
+      return;
+    }
+    commit(hour, next);
+  };
+  const changeHour = (delta) => commit((hour + delta + 24) % 24, minute);
+  const sanitizeInput = (next) => next.replace(/\D/g, "").slice(0, 2);
+  const beginEdit = (part, currentValue) => {
+    setEditingPart(part);
+    setInputDraft((prev) => ({ ...prev, [part]: String(currentValue).padStart(2, "0") }));
+  };
+  const commitHourDraft = (draft) => {
+    const clamped = clampTimePart(Number(draft), useMeridiem ? 1 : 0, useMeridiem ? 12 : 23);
+    const nextHour = useMeridiem ? meridiem === "PM" ? clamped === 12 ? 12 : clamped + 12 : clamped === 12 ? 0 : clamped : clamped;
+    commit(nextHour, minute);
+    return clamped;
+  };
+  const commitMinuteDraft = (draft) => {
+    const clamped = clampTimePart(Number(draft), 0, 59);
+    commit(hour, clamped);
+    return clamped;
+  };
+  const endEdit = (part) => {
+    const draft = inputDraft[part];
+    if (part === "hour" && draft != null && draft !== "") {
+      commitHourDraft(draft);
+    }
+    if (part === "minute" && draft != null && draft !== "") {
+      commitMinuteDraft(draft);
+    }
+    setEditingPart(null);
+    setInputDraft({});
+  };
+  const inputStyle = {
+    width: "var(--cmp-timepicker-selector-input-width)",
+    height: "var(--cmp-textinput-sm-height)",
+    borderRadius: "var(--cmp-textinput-sm-radius)",
+    border: "var(--cmp-textinput-borderWidth) solid var(--cmp-textinput-border-default)",
+    color: "var(--cmp-textinput-text-default)",
+    fontSize: 12,
+    lineHeight: "20px"
+  };
+  const renderColumn = (type) => {
+    const isHour = type === "hour";
+    const val = isHour ? displayHour : minute;
+    const displayValue = editingPart === type ? inputDraft[type] ?? "" : String(val).padStart(2, "0");
+    return /* @__PURE__ */ jsxs(
+      "div",
+      {
+        className: "flex flex-col items-center justify-center",
+        style: { gap: "var(--cmp-timepicker-selector-time-column-gap)" },
+        children: [
+          /* @__PURE__ */ jsx(
+            SGhostButton,
+            {
+              icon: "chevronUp",
+              size: "xs",
+              ariaLabel: `${isHour ? "\uC2DC" : "\uBD84"} \uC99D\uAC00`,
+              onClick: () => isHour ? changeHour(1) : changeMinute(minuteStep)
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            "input",
+            {
+              "aria-label": isHour ? "\uC2DC" : "\uBD84",
+              inputMode: "numeric",
+              value: displayValue,
+              placeholder: "-",
+              onFocus: () => beginEdit(type, val),
+              onBlur: () => endEdit(type),
+              onChange: (event) => {
+                const draft = sanitizeInput(event.target.value);
+                setInputDraft((prev) => ({ ...prev, [type]: draft }));
+                if (draft === "") return;
+                const raw = Number(draft);
+                if (isHour) {
+                  if (draft.length < 2) return;
+                  const clamped2 = commitHourDraft(draft);
+                  const displayDraft2 = raw === clamped2 ? draft : String(clamped2);
+                  setInputDraft((prev) => ({ ...prev, [type]: displayDraft2 }));
+                  return;
+                }
+                if (draft.length < 2) return;
+                const clamped = commitMinuteDraft(draft);
+                const displayDraft = raw === clamped ? draft : String(clamped);
+                setInputDraft((prev) => ({ ...prev, [type]: displayDraft }));
+              },
+              className: "box-border bg-white text-center outline-none",
+              style: inputStyle
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            SGhostButton,
+            {
+              icon: "chevronDown",
+              size: "xs",
+              ariaLabel: `${isHour ? "\uC2DC" : "\uBD84"} \uAC10\uC18C`,
+              onClick: () => isHour ? changeHour(-1) : changeMinute(-minuteStep)
+            }
+          )
+        ]
+      }
+    );
+  };
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: "flex flex-col items-stretch justify-center overflow-hidden",
+      style: {
+        background: "var(--cmp-timepicker-selector-bg)",
+        borderRadius: "var(--cmp-timepicker-selector-radius)",
+        boxShadow: "4px 8px 16px -4px rgba(34,34,34,0.1), 0 0 24px -6px rgba(34,34,34,0.12)"
+      },
+      children: [
+        useMeridiem && /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: "flex items-center justify-center",
+            style: {
+              padding: "var(--cmp-timepicker-selector-section-paddingY) var(--cmp-timepicker-selector-section-paddingX)"
+            },
+            children: /* @__PURE__ */ jsx("div", { className: "isolate flex", children: ["AM", "PM"].map((item, index) => {
+              const selected = item === meridiem;
+              return /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  onClick: () => setMeridiem(item),
+                  className: cn(
+                    "box-border h-[var(--cmp-textinput-sm-height)] w-[61px] cursor-pointer border border-solid bg-white text-center text-[12px] font-medium leading-[20px]",
+                    index === 0 ? "rounded-l-[var(--cmp-select-sm-radius)]" : "rounded-r-[var(--cmp-select-sm-radius)]",
+                    index === 0 ? "-mr-px" : "",
+                    selected ? "z-[1] border-[var(--cmp-timepicker-border-focus)] text-[var(--cmp-timepicker-border-focus)]" : "border-[var(--cmp-timepicker-border-default)] text-[var(--cmp-field-hint-color)]"
+                  ),
+                  children: item === "AM" ? "\uC624\uC804" : "\uC624\uD6C4"
+                },
+                item
+              );
+            }) })
+          }
+        ),
+        useMeridiem && /* @__PURE__ */ jsx("div", { className: "h-px w-full bg-[var(--sys-color-divider-default)]" }),
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "flex items-center justify-center",
+            style: {
+              gap: "var(--cmp-timepicker-selector-time-gap)",
+              padding: "var(--cmp-timepicker-selector-section-paddingY) var(--cmp-timepicker-selector-section-paddingX)"
+            },
+            children: [
+              renderColumn("hour"),
+              /* @__PURE__ */ jsx(
+                "span",
+                {
+                  className: "text-center",
+                  style: {
+                    width: "var(--cmp-timepicker-selector-colon-size)",
+                    color: "var(--cmp-field-hint-color)",
+                    fontSize: "var(--cmp-timepicker-selector-colon-size)",
+                    lineHeight: "var(--cmp-timepicker-selector-colon-size)"
+                  },
+                  children: ":"
+                }
+              ),
+              renderColumn("minute")
+            ]
+          }
+        )
+      ]
+    }
+  );
+}
+function STimePicker({
+  value,
+  onValueChange,
+  onOpenChange,
+  type = "default",
+  size = "sm",
+  placeholder = "00:00",
+  disabled = false,
+  clearable = false,
+  useMeridiem,
+  minuteStep = 1,
+  width,
+  name,
+  rules,
+  status,
+  label,
+  labelWidth,
+  icon,
+  iconColor,
+  labelTooltip,
+  labelTooltipProps,
+  addonLabel,
+  addonAlign,
+  hint,
+  error,
+  errorMessage,
+  className,
+  style
+}) {
+  const portalContainer = usePortalContainer();
+  const [open, setOpen] = useState(false);
+  const [focused, setFocused] = useState(false);
+  const [ruleError, setRuleError] = useState("");
+  const dims = TIMEPICKER_SIZE_CONFIG[size] ?? TIMEPICKER_SIZE_CONFIG.sm;
+  const normalized = value ? formatTimeValue(parseTimeValue(value).hour, parseTimeValue(value).minute) : null;
+  const effectiveUseMeridiem = useMeridiem ?? type === "midday";
+  const displayText = formatTimeDisplay(normalized, effectiveUseMeridiem ? "midday" : "default");
+  const hasValue = normalized != null && normalized !== "";
+  useFormField({
+    name,
+    validate: () => {
+      const msg = runRules(value, rules);
+      setRuleError(msg);
+      return msg === "";
+    },
+    resetValidation: () => setRuleError("")
+  });
+  const resolvedError = error || ruleError !== "";
+  const resolvedStatus = status ?? (rules && rules.length > 0 ? ruleError !== "" ? "error" : void 0 : void 0);
+  const commitOpen = (next) => {
+    if (disabled) return;
+    setOpen(next);
+    onOpenChange?.(next);
+    if (!next && rules && rules.length > 0) setRuleError(runRules(value, rules));
+  };
+  const commitValue = (next) => {
+    onValueChange?.(next);
+    if (rules && rules.length > 0) setRuleError(runRules(next, rules));
+  };
+  return /* @__PURE__ */ jsx(
+    SField,
+    {
+      label,
+      labelWidth,
+      icon,
+      iconColor,
+      labelTooltip,
+      labelTooltipProps,
+      addonLabel,
+      addonAlign,
+      size,
+      hint,
+      error: resolvedError,
+      status: resolvedStatus,
+      focused: focused || open,
+      errorMessage: ruleError !== "" ? ruleError : errorMessage,
+      width,
+      disabled,
+      className,
+      style: { minWidth: dims.fieldMinWidth, ...style },
+      children: /* @__PURE__ */ jsxs(RPopover2.Root, { open, onOpenChange: commitOpen, children: [
+        /* @__PURE__ */ jsx(RPopover2.Trigger, { asChild: true, children: /* @__PURE__ */ jsxs(
+          "button",
+          {
+            type: "button",
+            name,
+            disabled,
+            onFocus: () => setFocused(true),
+            onBlur: () => setFocused(false),
+            className: "flex h-full w-full items-center overflow-hidden bg-transparent outline-none disabled:cursor-not-allowed",
+            style: { padding: `0 ${dims.paddingX}`, gap: dims.gap, borderRadius: dims.radius },
+            children: [
+              /* @__PURE__ */ jsx(
+                SIcon,
+                {
+                  name: "clockOutline",
+                  size: dims.icon,
+                  color: disabled ? "var(--cmp-timepicker-icon-disabled)" : "var(--cmp-timepicker-icon-default)",
+                  className: "flex-shrink-0"
+                }
+              ),
+              /* @__PURE__ */ jsx(
+                "span",
+                {
+                  className: "flex-1 truncate text-center",
+                  style: {
+                    minWidth: dims.minWidth,
+                    fontSize: dims.fontSize,
+                    lineHeight: `${dims.lineHeight}px`,
+                    color: disabled ? "var(--cmp-timepicker-text-disabled)" : hasValue ? "var(--cmp-timepicker-text-default)" : "var(--cmp-field-hint-color)"
+                  },
+                  children: hasValue ? displayText : placeholder
+                }
+              ),
+              clearable && hasValue && !disabled && /* @__PURE__ */ jsx(
+                SGhostButton,
+                {
+                  icon: "close",
+                  size: "xs",
+                  ariaLabel: "\uC2DC\uAC04 \uC9C0\uC6B0\uAE30",
+                  onClick: (event) => {
+                    event.stopPropagation();
+                    commitValue(null);
+                  }
+                }
+              )
+            ]
+          }
+        ) }),
+        /* @__PURE__ */ jsx(RPopover2.Portal, { container: portalContainer, children: /* @__PURE__ */ jsx(
+          RPopover2.Content,
+          {
+            side: "bottom",
+            align: "start",
+            sideOffset: 4,
+            className: cn("z-50", FLOATING_SLIDE_ANIM),
+            children: /* @__PURE__ */ jsx(
+              TimeSelector,
+              {
+                value: normalized,
+                useMeridiem: effectiveUseMeridiem,
+                minuteStep,
+                onChange: commitValue
+              }
+            )
+          }
+        ) })
+      ] })
+    }
+  );
+}
+
+// src/components/STimeRangePicker/time-range-picker.config.ts
+function getTimeMinutes(value) {
+  const { hour, minute } = parseTimeValue(value);
+  return hour * 60 + minute;
+}
+function normalizeTimeRangeValue(value, rangeOrder = "strict") {
+  if (value == null) return null;
+  const normalized = value.map((item) => {
+    const parsed = parseTimeValue(item);
+    return formatTimeValue(parsed.hour, parsed.minute);
+  });
+  if (rangeOrder === "strict" && getTimeMinutes(normalized[0]) > getTimeMinutes(normalized[1])) {
+    return [normalized[0], normalized[0]];
+  }
+  return normalized;
+}
+function formatTimeRangeDisplay(value, type) {
+  if (value == null || value[0] === "" || value[1] === "") return "";
+  return `${formatTimeDisplay(value[0], type)} ~ ${formatTimeDisplay(value[1], type)}`;
+}
+function RangeTimeSelector({
+  value,
+  useMeridiem,
+  minuteStep,
+  rangeOrder,
+  onChange
+}) {
+  const range = useMemo(() => value ?? ["00:00", "23:59"], [value]);
+  const [editingKey, setEditingKey] = useState(null);
+  const [inputDraft, setInputDraft] = useState({});
+  const autoAdjustedRef = useRef(null);
+  const getParts = (side) => parseTimeValue(side === "start" ? range[0] : range[1]);
+  const getMeridiem = (side) => getParts(side).hour >= 12 ? "PM" : "AM";
+  const getDisplayHour = (side) => {
+    const { hour } = getParts(side);
+    if (!useMeridiem) return hour;
+    const displayHour = hour % 12;
+    return displayHour === 0 ? 12 : displayHour;
+  };
+  const commit = (side, hour, minute, direction = "unknown") => {
+    const next = formatTimeValue(hour, minute);
+    onChange(
+      normalizeNextRange(side === "start" ? [next, range[1]] : [range[0], next], side, direction)
+    );
+  };
+  const getTimeMinutes2 = (time) => {
+    const { hour, minute } = parseTimeValue(time);
+    return hour * 60 + minute;
+  };
+  const normalizeNextRange = (nextRange, changedSide, direction) => {
+    if (rangeOrder === "allow-cross-day") return nextRange;
+    const [start, end] = nextRange;
+    const [currentStart, currentEnd] = range;
+    if (getTimeMinutes2(start) <= getTimeMinutes2(end)) {
+      const shouldKeepSynced = autoAdjustedRef.current?.side === changedSide && currentStart === currentEnd && start !== end && (direction === "unknown" || autoAdjustedRef.current.direction === direction);
+      if (shouldKeepSynced) {
+        return changedSide === "start" ? [start, start] : [end, end];
+      }
+      autoAdjustedRef.current = null;
+      return nextRange;
+    }
+    autoAdjustedRef.current = {
+      side: changedSide,
+      direction: changedSide === "start" ? "increase" : "decrease"
+    };
+    return changedSide === "start" ? [start, start] : [end, end];
+  };
+  const changeHour = (side, delta) => {
+    const { hour, minute } = getParts(side);
+    commit(side, (hour + delta + 24) % 24, minute, delta > 0 ? "increase" : "decrease");
+  };
+  const changeMinute = (side, delta) => {
+    const { hour, minute } = getParts(side);
+    const next = minute + delta;
+    if (next > 59) {
+      commit(side, (hour + 1) % 24, next - 60, delta > 0 ? "increase" : "decrease");
+      return;
+    }
+    if (next < 0) {
+      commit(side, (hour + 23) % 24, next + 60, delta > 0 ? "increase" : "decrease");
+      return;
+    }
+    commit(side, hour, next, delta > 0 ? "increase" : "decrease");
+  };
+  const setMeridiem = (side, next) => {
+    const current = getMeridiem(side);
+    if (current === next) return;
+    const { hour, minute } = getParts(side);
+    commit(side, next === "AM" ? hour - 12 : hour + 12, minute);
+  };
+  const getEditingKey = (side, part) => `${side}-${part}`;
+  const sanitizeInput = (next) => next.replace(/\D/g, "").slice(0, 2);
+  const beginEdit = (side, part, currentValue) => {
+    const key = getEditingKey(side, part);
+    setEditingKey(key);
+    setInputDraft((prev) => ({ ...prev, [key]: String(currentValue).padStart(2, "0") }));
+  };
+  const commitHourDraft = (side, draft) => {
+    const clamped = clampTimePart(Number(draft), useMeridiem ? 1 : 0, useMeridiem ? 12 : 23);
+    const parts = getParts(side);
+    const meridiem = getMeridiem(side);
+    const nextHour = useMeridiem ? meridiem === "PM" ? clamped === 12 ? 12 : clamped + 12 : clamped === 12 ? 0 : clamped : clamped;
+    commit(side, nextHour, parts.minute);
+    return clamped;
+  };
+  const commitMinuteDraft = (side, draft) => {
+    const { hour } = getParts(side);
+    const clamped = clampTimePart(Number(draft), 0, 59);
+    commit(side, hour, clamped);
+    return clamped;
+  };
+  const endEdit = (side, part) => {
+    const key = getEditingKey(side, part);
+    const draft = inputDraft[key];
+    if (part === "hour" && draft != null && draft !== "") {
+      commitHourDraft(side, draft);
+    }
+    if (part === "minute" && draft != null && draft !== "") {
+      commitMinuteDraft(side, draft);
+    }
+    setEditingKey(null);
+    setInputDraft({});
+  };
+  const inputStyle = {
+    width: "var(--cmp-timepicker-selector-input-width)",
+    height: "var(--cmp-textinput-sm-height)",
+    borderRadius: "var(--cmp-textinput-sm-radius)",
+    border: "var(--cmp-textinput-borderWidth) solid var(--cmp-textinput-border-default)",
+    color: "var(--cmp-textinput-text-default)",
+    fontSize: 12,
+    lineHeight: "20px"
+  };
+  const renderColumn = (side, kind) => {
+    const isHour = kind === "hour";
+    const { minute } = getParts(side);
+    const val = isHour ? getDisplayHour(side) : minute;
+    const currentEditingKey = getEditingKey(side, kind);
+    const displayValue = editingKey === currentEditingKey ? inputDraft[currentEditingKey] ?? "" : String(val).padStart(2, "0");
+    return /* @__PURE__ */ jsxs(
+      "div",
+      {
+        className: "flex flex-col items-center justify-center",
+        style: { gap: "var(--cmp-timepicker-selector-time-column-gap)" },
+        children: [
+          /* @__PURE__ */ jsx(
+            SGhostButton,
+            {
+              icon: "chevronUp",
+              size: "xs",
+              ariaLabel: `${side === "start" ? "\uC2DC\uC791" : "\uC885\uB8CC"} ${isHour ? "\uC2DC" : "\uBD84"} \uC99D\uAC00`,
+              onClick: () => isHour ? changeHour(side, 1) : changeMinute(side, minuteStep)
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            "input",
+            {
+              "aria-label": `${side === "start" ? "\uC2DC\uC791" : "\uC885\uB8CC"} ${isHour ? "\uC2DC" : "\uBD84"}`,
+              inputMode: "numeric",
+              value: displayValue,
+              placeholder: "-",
+              onFocus: () => beginEdit(side, kind, val),
+              onBlur: () => endEdit(side, kind),
+              onChange: (event) => {
+                const draft = sanitizeInput(event.target.value);
+                setInputDraft((prev) => ({ ...prev, [currentEditingKey]: draft }));
+                if (draft === "") return;
+                const raw = Number(draft);
+                if (isHour) {
+                  if (draft.length < 2) return;
+                  const clamped2 = commitHourDraft(side, draft);
+                  const displayDraft2 = raw === clamped2 ? draft : String(clamped2);
+                  setInputDraft((prev) => ({ ...prev, [currentEditingKey]: displayDraft2 }));
+                  return;
+                }
+                if (draft.length < 2) return;
+                const clamped = commitMinuteDraft(side, draft);
+                const displayDraft = raw === clamped ? draft : String(clamped);
+                setInputDraft((prev) => ({ ...prev, [currentEditingKey]: displayDraft }));
+              },
+              className: "box-border bg-white text-center outline-none",
+              style: inputStyle
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            SGhostButton,
+            {
+              icon: "chevronDown",
+              size: "xs",
+              ariaLabel: `${side === "start" ? "\uC2DC\uC791" : "\uC885\uB8CC"} ${isHour ? "\uC2DC" : "\uBD84"} \uAC10\uC18C`,
+              onClick: () => isHour ? changeHour(side, -1) : changeMinute(side, -minuteStep)
+            }
+          )
+        ]
+      }
+    );
+  };
+  const renderPanel = (side, title) => /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: "flex flex-col items-center justify-center",
+      style: { gap: "var(--cmp-timepicker-selector-range-section-gap)" },
+      children: [
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "flex flex-col items-center",
+            style: { gap: "var(--cmp-timepicker-selector-range-heading-gap)" },
+            children: [
+              /* @__PURE__ */ jsx("div", { className: "whitespace-nowrap text-center text-[12px] font-bold leading-[20px] text-[var(--cmp-timepicker-selector-range-heading-color)]", children: title }),
+              useMeridiem && /* @__PURE__ */ jsx("div", { className: "isolate flex", children: ["AM", "PM"].map((item, index) => {
+                const selected = item === getMeridiem(side);
+                return /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    onClick: () => setMeridiem(side, item),
+                    className: cn(
+                      "box-border h-[var(--cmp-textinput-sm-height)] w-[61px] cursor-pointer border border-solid bg-white text-center text-[12px] font-medium leading-[20px]",
+                      index === 0 ? "rounded-l-[var(--cmp-select-sm-radius)] -mr-px" : "rounded-r-[var(--cmp-select-sm-radius)]",
+                      selected ? "z-[1] border-[var(--cmp-timepicker-border-focus)] text-[var(--cmp-timepicker-border-focus)]" : "border-[var(--cmp-timepicker-border-default)] text-[var(--cmp-field-hint-color)]"
+                    ),
+                    children: item === "AM" ? "\uC624\uC804" : "\uC624\uD6C4"
+                  },
+                  item
+                );
+              }) })
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "flex items-center justify-center",
+            style: {
+              gap: "var(--cmp-timepicker-selector-time-gap)",
+              padding: "0 var(--cmp-timepicker-selector-section-paddingX)"
+            },
+            children: [
+              renderColumn(side, "hour"),
+              /* @__PURE__ */ jsx(
+                "span",
+                {
+                  className: "text-center",
+                  style: {
+                    width: "var(--cmp-timepicker-selector-colon-size)",
+                    color: "var(--cmp-field-hint-color)",
+                    fontSize: "var(--cmp-timepicker-selector-colon-size)",
+                    lineHeight: "var(--cmp-timepicker-selector-colon-size)"
+                  },
+                  children: ":"
+                }
+              ),
+              renderColumn(side, "minute")
+            ]
+          }
+        )
+      ]
+    }
+  );
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: "flex items-start justify-center overflow-hidden",
+      style: {
+        gap: "var(--cmp-timepicker-selector-range-panelGap)",
+        padding: "var(--cmp-timepicker-selector-range-paddingXY)",
+        background: "var(--cmp-timepicker-selector-bg)",
+        borderRadius: "var(--cmp-timepicker-selector-radius)",
+        boxShadow: "var(--shadow-spread-sm), var(--shadow-spread-md)"
+      },
+      children: [
+        renderPanel("start", "\uC2DC\uC791 \uC2DC\uAC04"),
+        /* @__PURE__ */ jsx("div", { className: "self-stretch w-px bg-[var(--sys-color-divider-default)]" }),
+        renderPanel("end", "\uC885\uB8CC \uC2DC\uAC04")
+      ]
+    }
+  );
+}
+function STimeRangePicker({
+  value,
+  onValueChange,
+  onOpenChange,
+  type = "default",
+  size = "sm",
+  placeholder = "00:00 ~ 23:59",
+  disabled = false,
+  clearable = false,
+  useMeridiem,
+  minuteStep = 1,
+  rangeOrder = "strict",
+  width,
+  name,
+  rules,
+  status,
+  label,
+  labelWidth,
+  icon,
+  iconColor,
+  labelTooltip,
+  labelTooltipProps,
+  addonLabel,
+  addonAlign,
+  hint,
+  error,
+  errorMessage,
+  className,
+  style
+}) {
+  const portalContainer = usePortalContainer();
+  const [open, setOpen] = useState(false);
+  const [focused, setFocused] = useState(false);
+  const [ruleError, setRuleError] = useState("");
+  const dims = TIMEPICKER_SIZE_CONFIG[size] ?? TIMEPICKER_SIZE_CONFIG.sm;
+  const normalized = normalizeTimeRangeValue(value ?? null, rangeOrder);
+  const effectiveUseMeridiem = useMeridiem ?? type === "midday";
+  const displayText = formatTimeRangeDisplay(
+    normalized,
+    effectiveUseMeridiem ? "midday" : "default"
+  );
+  const hasValue = normalized != null && normalized[0] !== "" && normalized[1] !== "";
+  useFormField({
+    name,
+    validate: () => {
+      const msg = runRules(value, rules);
+      setRuleError(msg);
+      return msg === "";
+    },
+    resetValidation: () => setRuleError("")
+  });
+  const resolvedError = error || ruleError !== "";
+  const resolvedStatus = status ?? (rules && rules.length > 0 ? ruleError !== "" ? "error" : void 0 : void 0);
+  const commitOpen = (next) => {
+    if (disabled) return;
+    setOpen(next);
+    onOpenChange?.(next);
+    if (!next && rules && rules.length > 0) setRuleError(runRules(value, rules));
+  };
+  const commitValue = (next) => {
+    onValueChange?.(next);
+    if (rules && rules.length > 0) setRuleError(runRules(next, rules));
+  };
+  return /* @__PURE__ */ jsx(
+    SField,
+    {
+      label,
+      labelWidth,
+      icon,
+      iconColor,
+      labelTooltip,
+      labelTooltipProps,
+      addonLabel,
+      addonAlign,
+      size,
+      hint,
+      error: resolvedError,
+      status: resolvedStatus,
+      focused: focused || open,
+      errorMessage: ruleError !== "" ? ruleError : errorMessage,
+      width,
+      disabled,
+      className,
+      style: { minWidth: dims.fieldMinWidth, ...style },
+      children: /* @__PURE__ */ jsxs(RPopover2.Root, { open, onOpenChange: commitOpen, children: [
+        /* @__PURE__ */ jsx(RPopover2.Trigger, { asChild: true, children: /* @__PURE__ */ jsxs(
+          "button",
+          {
+            type: "button",
+            name,
+            disabled,
+            onFocus: () => setFocused(true),
+            onBlur: () => setFocused(false),
+            className: "flex h-full w-full items-center overflow-hidden bg-transparent outline-none disabled:cursor-not-allowed",
+            style: { padding: `0 ${dims.paddingX}`, gap: dims.gap, borderRadius: dims.radius },
+            children: [
+              /* @__PURE__ */ jsx(
+                SIcon,
+                {
+                  name: "clockOutline",
+                  size: dims.icon,
+                  color: disabled ? "var(--cmp-timepicker-icon-disabled)" : "var(--cmp-timepicker-icon-default)",
+                  className: "flex-shrink-0"
+                }
+              ),
+              /* @__PURE__ */ jsx(
+                "span",
+                {
+                  className: "flex-1 truncate text-center",
+                  style: {
+                    minWidth: dims.minWidth,
+                    fontSize: dims.fontSize,
+                    lineHeight: `${dims.lineHeight}px`,
+                    color: disabled ? "var(--cmp-timepicker-text-disabled)" : hasValue ? "var(--cmp-timepicker-text-default)" : "var(--cmp-field-hint-color)"
+                  },
+                  children: hasValue ? displayText : placeholder
+                }
+              ),
+              clearable && hasValue && !disabled && /* @__PURE__ */ jsx(
+                SGhostButton,
+                {
+                  icon: "close",
+                  size: "xs",
+                  ariaLabel: "\uC2DC\uAC04 \uBC94\uC704 \uC9C0\uC6B0\uAE30",
+                  onClick: (event) => {
+                    event.stopPropagation();
+                    commitValue(null);
+                  }
+                }
+              )
+            ]
+          }
+        ) }),
+        /* @__PURE__ */ jsx(RPopover2.Portal, { container: portalContainer, children: /* @__PURE__ */ jsx(
+          RPopover2.Content,
+          {
+            side: "bottom",
+            align: "start",
+            sideOffset: 4,
+            className: cn("z-50", FLOATING_SLIDE_ANIM),
+            children: /* @__PURE__ */ jsx(
+              RangeTimeSelector,
+              {
+                value: normalized,
+                useMeridiem: effectiveUseMeridiem,
+                minuteStep,
+                rangeOrder,
+                onChange: commitValue
+              }
+            )
+          }
+        ) })
+      ] })
+    }
+  );
+}
+
+export { BADGE_COLORS, BUTTON_COLORS, BUTTON_SIZES, COLOR_KEYS, GNB_COLORS, GNB_COMMON, GNB_FOLD_MS, GNB_HEADER, GNB_MENU, GNB_MENU_WIDTH, GNB_RAIL, GNB_RAIL_WIDTH, ICONS, SActionModal, SBadge, SBarcodeInput, SButton, SCalendar, SCallout, SCard, SCheckbox, SChip, SChipInput, SCircleProgress, SConfirmModal, SDatePicker, SDateRangePicker, SDivider, SDropdownButton, SField, SFilePicker, SForm, SGhostButton, SGnb, SGuide, SIcon, SInput, SKeyValueTable, SLayout, SLayoutContext, SLinearProgress, SLoadingContainer, SLoadingModal, SLoadingViewport, SNumberInput, SPage, SPagination, SPopover, SPopup, SPortal, SRadio, SRadioButton, SRadioGroup, SSelect, SSwitch, STable, STabs, STag, STextLink, STextarea, STimePicker, STimeRangePicker, SToast, SToastContainer, SToggle, STooltip, TAG_COLORS, TAG_SHAPES, TAG_SIZES, TIMEPICKER_SIZES, TIMEPICKER_SIZE_CONFIG, buttonPreset, cn, findGnbAncestors, findGnbRailValue, isColorKey, loading, resolveColor, useSLayout };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map