sellmate-design-system-react 0.4.0 → 0.6.0

package/dist/components/SGnb/SGnb.js

@@ -3,7 +3,7 @@ import { createContext, forwardRef, useState, useCallback, useMemo, useContext,
 import { clsx } from 'clsx';
 import { extendTailwindMerge } from 'tailwind-merge';
 import * as RPopover from '@radix-ui/react-popover';
-import { jsx, jsxs } from 'react/jsx-runtime';
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
 var twMerge = extendTailwindMerge({
   extend: {
@@ -3073,73 +3073,70 @@ function SGhostButton({
 }
 
 // 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 = {
@@ -3152,7 +3149,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"),
@@ -3163,19 +3162,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) {
@@ -3193,6 +3214,7 @@ var SLayoutContext = createContext(null);
 forwardRef(function SLayout2({
   type = "box",
   header = "fix",
+  useRail = false,
   folded,
   defaultFolded = false,
   onFoldedChange,
@@ -3211,21 +3233,40 @@ forwardRef(function SLayout2({
     },
     [isControlled, onFoldedChange]
   );
-  const ctx = useMemo(
-    () => ({ type, header, folded: currentFolded, setFolded }),
-    [type, header, currentFolded, setFolded]
+  const [gnbState, setGnbState] = useState({ forceFull: false, menuVisible: true });
+  const reportGnbState = useCallback(
+    (next) => setGnbState(
+      (prev) => prev.forceFull === next.forceFull && prev.menuVisible === next.menuVisible ? prev : next
+    ),
+    []
   );
-  const isFullHeader = header === "full";
+  const effectiveHeader = header === "full" || gnbState.forceFull ? "full" : "fix";
+  const ctx = useMemo(
+    () => ({
+      type,
+      header: effectiveHeader,
+      useRail,
+      folded: currentFolded,
+      setFolded,
+      reportGnbState
+    }),
+    [type, effectiveHeader, useRail, currentFolded, setFolded, reportGnbState]
+  );
+  const isFullHeader = effectiveHeader === "full";
+  const gnbColumnWidth = (useRail ? GNB_RAIL_WIDTH : 0) + (gnbState.menuVisible ? GNB_MENU_WIDTH : 0);
   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[effectiveHeader].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",
     {
       ref,
       "data-type": type,
-      "data-header": header,
+      "data-header": effectiveHeader,
       className: cn(
         "box-border h-full overflow-hidden",
         isFullHeader ? "grid" : "flex flex-row",
@@ -3243,8 +3284,10 @@ var SGnb = forwardRef(function SGnb2({
   header: headerProp,
   color = "light",
   items,
+  useRail: useRailProp,
   value = "",
   onValueChange,
+  onRailChange,
   folded: foldedProp,
   onFoldChange,
   onLauncherClick,
@@ -3256,8 +3299,10 @@ var SGnb = forwardRef(function SGnb2({
 }, ref) {
   const layout = useContext(SLayoutContext);
   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 railHasLeaf = useRail && items.some((item) => !item.children || item.children.length === 0);
+  const header = railHasLeaf ? "full" : headerProp ?? layout?.header ?? "fix";
   const H = GNB_HEADER[header];
   const M = GNB_MENU[type];
   const C = GNB_COLORS[color];
@@ -3265,6 +3310,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;
@@ -3275,6 +3323,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);
@@ -3291,16 +3348,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,
@@ -3337,8 +3436,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,
                 {
@@ -3356,94 +3458,221 @@ 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 showMenu = !useRail || menuItems.length > 0;
+  const bodyWidth = (useRail ? GNB_RAIL_WIDTH : 0) + (showMenu ? GNB_MENU_WIDTH : 0);
+  useEffect(() => {
+    layout?.reportGnbState({ forceFull: railHasLeaf, menuVisible: showMenu });
+  }, [layout, railHasLeaf, showMenu]);
   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"}`;
+  const foldInline = !!logo;
+  const sideFoldStyle = {
+    opacity: railFolded ? 0 : 1,
+    position: railFolded ? "absolute" : "static",
+    visibility: railFolded ? "hidden" : "visible",
+    transition: `opacity ${GNB_FOLD_MS}ms ease-out, ${hideAfterSlide(railFolded)}`
+  };
   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,
       "data-color": color,
       ...rest,
       children: [
-        /* @__PURE__ */ jsxs(
+        /* @__PURE__ */ jsx(
           "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,
+              // 인라인 간격은 컨테이너 gap 대신 각 요소 margin 으로 준다 — 런처↔폴드(8px)와
+              // 폴드↔로고(top-gap)를 다르게 두기 위함. 접히면 런처·로고가 흐름에서 빠져 margin 도 무의미해진다.
+              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,
-                {
-                  icon: "launcher",
-                  size: "xs",
-                  intent: color === "dark" ? "inverse" : "default",
-                  ariaLabel: "app launcher",
-                  onClick: onLauncherClick,
-                  className: "shrink-0"
-                }
-              ),
-              !railFolded && logo && /* @__PURE__ */ jsx("div", { className: "flex items-center", style: { height: H.logoHeight }, children: logo }),
-              /* @__PURE__ */ jsx(
-                SGhostButton,
-                {
-                  icon: "sidebar",
-                  size: "xs",
-                  intent: color === "dark" ? "inverse" : "default",
-                  ariaLabel: "toggle navigation",
-                  ariaPressed: folded,
-                  onClick: handleFoldToggle,
-                  className: cn("shrink-0", !railFolded && "ml-auto")
-                }
-              )
-            ]
+            children: foldInline ? (
+              // 런처(있을 때)·폴드·로고를 흐름에 나란히 둔다 → 폴드 버튼이 (런처와) 로고 사이에 선다.
+              // 접히면 런처·로고가 페이드하며 흐름에서 빠지고(sideFoldStyle), 폴드 버튼만 남아 레일 가운데에 선다.
+              /* @__PURE__ */ jsxs(Fragment, { children: [
+                onLauncherClick && /* @__PURE__ */ jsx(
+                  SGhostButton,
+                  {
+                    icon: "launcher",
+                    size: "xs",
+                    intent: color === "dark" ? "inverse" : "default",
+                    ariaLabel: "app launcher",
+                    onClick: onLauncherClick,
+                    className: "shrink-0",
+                    style: { ...sideFoldStyle, marginRight: "8px" }
+                  }
+                ),
+                /* @__PURE__ */ jsx(
+                  SGhostButton,
+                  {
+                    icon: "sidebar",
+                    size: "xs",
+                    intent: color === "dark" ? "inverse" : "default",
+                    ariaLabel: "toggle navigation",
+                    ariaPressed: folded,
+                    onClick: handleFoldToggle,
+                    className: "shrink-0"
+                  }
+                ),
+                /* @__PURE__ */ jsx(
+                  "div",
+                  {
+                    className: "flex shrink-0 items-center",
+                    style: { height: H.logoHeight, marginLeft: H.topGap, ...sideFoldStyle },
+                    children: logo
+                  }
+                )
+              ] })
+            ) : (
+              // 런처·로고는 좌측 그룹(흐름에서 빼 폭 축소 중 폴드 버튼을 밀어내지 않는다),
+              // 폴드 버튼은 우측 끝(ml-auto)이라 폭·패딩이 줄면 저절로 레일 가운데에 선다.
+              /* @__PURE__ */ jsxs(Fragment, { children: [
+                (onLauncherClick || logo) && /* @__PURE__ */ jsxs(
+                  "div",
+                  {
+                    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 })
+                    ]
+                  }
+                ),
+                /* @__PURE__ */ jsx(
+                  SGhostButton,
+                  {
+                    icon: "sidebar",
+                    size: "xs",
+                    intent: color === "dark" ? "inverse" : "default",
+                    ariaLabel: "toggle navigation",
+                    ariaPressed: folded,
+                    onClick: handleFoldToggle,
+                    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) })
+                }
+              ),
+              showMenu && /* @__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)) })
+                }
+              )
+            ]
           }
         )
       ]