pds-dev-kit-web 1.4.24 → 1.4.27

package/README.md

@@ -8,5 +8,5 @@ publ design system 프로젝트
 
 ## 참고 문서
 
-해당 패키지 버전은 PDS 문서 1.3 버전을 따르고 있음
-[PDS 1.3 문서 링크](https://design.docs.publ.biz/pds-project/)
+해당 패키지 버전은 PDS 문서 1.4 버전을 따르고 있음
+[PDS 1.4 문서 링크](https://design.docs.publ.biz/pds-project/)

package/dist/src/common/components/BoxLayout/Row.js

@@ -43,6 +43,6 @@ function Row(_a, ref) {
     var children = _a.children, style = _a.style;
     return (react_1.default.createElement(S_Row, { ref: ref, style: __assign({}, style) }, children));
 }
-var S_Row = styled_components_1.default.div(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n  width: 100%;\n"], ["\n  width: 100%;\n"])));
+var S_Row = styled_components_1.default.div(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n  display: flex;\n  width: 100%;\n"], ["\n  display: flex;\n  width: 100%;\n"])));
 exports.default = (0, react_1.forwardRef)(Row);
 var templateObject_1;

package/dist/src/common/components/Navigations/ContextTextLabelNav.d.ts

@@ -8,5 +8,5 @@ declare type Props = {
     preventLineChange?: boolean;
     onClick?: () => void;
 };
-declare function TextLabelNav({ to, text, openNewTab, isActive, preventLineChange, onClick }: Props, ref: ForwardedRefType<HTMLAnchorElement>): JSX.Element;
-export default TextLabelNav;
+declare function ContextTextLabelNav({ to, text, openNewTab, isActive, preventLineChange, onClick }: Props, ref: ForwardedRefType<HTMLAnchorElement>): JSX.Element;
+export default ContextTextLabelNav;

package/dist/src/common/components/Navigations/ContextTextLabelNav.js

@@ -5,11 +5,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 var react_1 = __importDefault(require("react"));
 var desktop_1 = require("../../../desktop");
+var hybrid_1 = require("../../../hybrid");
+var BoxLayout_1 = require("../BoxLayout");
 var NavLink_1 = __importDefault(require("./NavLink"));
-function TextLabelNav(_a, ref) {
+function ContextTextLabelNav(_a, ref) {
     var to = _a.to, text = _a.text, openNewTab = _a.openNewTab, _b = _a.isActive, isActive = _b === void 0 ? false : _b, _c = _a.preventLineChange, preventLineChange = _c === void 0 ? false : _c, onClick = _a.onClick;
-    return preventLineChange ? (react_1.default.createElement(NavLink_1.default, { onClick: onClick, ref: ref, to: to, openNewTab: openNewTab, style: { width: 'max-content' } },
-        react_1.default.createElement(desktop_1.D_TextLabel, { text: text, styleTheme: "form2Regular", ellipsisMode: "use", lineLimit: 1 }))) : (react_1.default.createElement(NavLink_1.default, { onClick: onClick, ref: ref, to: to, openNewTab: openNewTab },
+    return preventLineChange ? (react_1.default.createElement(NavLink_1.default, { onClick: onClick, ref: ref, to: to, openNewTab: openNewTab, style: { minWidth: '100%', width: 'max-content' } },
+        react_1.default.createElement(BoxLayout_1.Row, null,
+            react_1.default.createElement(hybrid_1.Spacing, { size: "spacing_d", spacingType: "width" }),
+            react_1.default.createElement(desktop_1.D_TextLabel, { text: text, styleTheme: "form2Regular", ellipsisMode: "use", lineLimit: 1 }),
+            react_1.default.createElement(hybrid_1.Spacing, { size: "spacing_d", spacingType: "width" })))) : (react_1.default.createElement(NavLink_1.default, { onClick: onClick, ref: ref, to: to, openNewTab: openNewTab },
         react_1.default.createElement(desktop_1.D_TextLabel, { text: text, styleTheme: "form2Regular" })));
 }
-exports.default = TextLabelNav;
+exports.default = ContextTextLabelNav;

package/dist/src/desktop/components/AdminListHeader/HeaderBar.js

@@ -48,7 +48,7 @@ function HeaderBar(_a) {
             react_1.default.createElement(S_ListCount, null,
                 react_1.default.createElement(TextLabel_1.TextLabel, { text: t('str_rows_per_page', '목록 개수'), styleTheme: "caption1Regular" }),
                 react_1.default.createElement(hybrid_1.Spacing, { size: "spacing_b", spacingType: "width" }),
-                react_1.default.createElement(Dropdown_1.Dropdown, { size: "small", valueArray: dropdownTextArray, onChange: handleDropdown, defaultValue: dropdownDefaultValue !== null && dropdownDefaultValue !== void 0 ? dropdownDefaultValue : dropdownTextArray[0] })),
+                react_1.default.createElement(Dropdown_1.Dropdown, { customWidth: "88px", size: "small", valueArray: dropdownTextArray, onChange: handleDropdown, defaultValue: dropdownDefaultValue !== null && dropdownDefaultValue !== void 0 ? dropdownDefaultValue : dropdownTextArray[0] })),
             react_1.default.createElement(S_Page, null,
                 react_1.default.createElement(TextLabel_1.TextLabel, { text: currentPage, styleTheme: "caption1Regular", colorTheme: "sysTextPrimary" }),
                 react_1.default.createElement(TextLabel_1.TextLabel, { text: " / ", styleTheme: "caption1Regular", colorTheme: "sysTextPrimary" }),

package/dist/src/desktop/components/BasicChatListItem/BasicChatListItem.d.ts

@@ -5,11 +5,11 @@ declare type Props = {
     contentText?: PDSTextType;
     leftImageMode?: 'none' | 'use';
     imageSrc?: string;
-    hoverBtnMode?: 'none' | 'use';
+    hoverMode?: 'none' | 'use';
     contextMenuOptionArray?: PDSValueOption[];
     contextMenuState?: 'normal' | 'disabled';
     colorTheme?: 'seller' | 'subscriber';
-    onClickContextMenu?: (option: PDSValueOption) => void;
+    onClickContextMenuItem?: (option: PDSValueOption) => void;
 };
-declare function BasicChatListItem({ titleText, contentText, leftImageMode, imageSrc, hoverBtnMode, contextMenuOptionArray, onClickContextMenu, contextMenuState, colorTheme }: Props): JSX.Element;
+declare function BasicChatListItem({ titleText, contentText, leftImageMode, imageSrc, hoverMode, contextMenuOptionArray, onClickContextMenuItem, contextMenuState, colorTheme }: Props): JSX.Element;
 export default BasicChatListItem;

package/dist/src/desktop/components/BasicChatListItem/BasicChatListItem.js

@@ -33,6 +33,7 @@ var ContextMenu_1 = require("../ContextMenu");
 var ContextMenuItem_1 = require("../ContextMenuItem");
 var IconButton_1 = require("../IconButton");
 var TextLabel_1 = require("../TextLabel");
+var Popup_1 = require("./Popup");
 var titleTextColors = {
     seller: 'usrTextBrandPrimary',
     subscriber: 'sysTextSecondary'
@@ -42,9 +43,11 @@ var backgroundColorTheme = {
     subscriber: 'ui_cpnt_list_base_area'
 };
 function BasicChatListItem(_a) {
-    var titleText = _a.titleText, contentText = _a.contentText, _b = _a.leftImageMode, leftImageMode = _b === void 0 ? 'none' : _b, imageSrc = _a.imageSrc, _c = _a.hoverBtnMode, hoverBtnMode = _c === void 0 ? 'use' : _c, contextMenuOptionArray = _a.contextMenuOptionArray, onClickContextMenu = _a.onClickContextMenu, _d = _a.contextMenuState, contextMenuState = _d === void 0 ? 'normal' : _d, _e = _a.colorTheme, colorTheme = _e === void 0 ? 'subscriber' : _e;
+    var titleText = _a.titleText, contentText = _a.contentText, _b = _a.leftImageMode, leftImageMode = _b === void 0 ? 'none' : _b, imageSrc = _a.imageSrc, _c = _a.hoverMode, hoverMode = _c === void 0 ? 'use' : _c, contextMenuOptionArray = _a.contextMenuOptionArray, onClickContextMenuItem = _a.onClickContextMenuItem, _d = _a.contextMenuState, contextMenuState = _d === void 0 ? 'normal' : _d, _e = _a.colorTheme, colorTheme = _e === void 0 ? 'subscriber' : _e;
     var _f = (0, react_1.useState)(false), isContextMenuOpen = _f[0], setIsContextMenuOpen = _f[1];
     var contextMenuRef = (0, react_1.useRef)(null);
+    var chatBody = document.querySelector('#chatMessageBox');
+    var rect = chatBody === null || chatBody === void 0 ? void 0 : chatBody.getBoundingClientRect();
     /**
      * @when contextMenu가 열려 있을 때
      * @expected ChatList body의 스크롤을 숨기고, contextMenu의 외부를 클릭하면 contextMenu가 닫히도록 합니다.
@@ -52,57 +55,45 @@ function BasicChatListItem(_a) {
      */
     (0, react_1.useEffect)(function () {
         // NOTE pop up 개념이 생기기 전까지의 임시 조치 방법입니다.
-        var chatBody = document.querySelector('#chatMessageBox');
-        if (chatBody) {
-            if (isContextMenuOpen) {
-                chatBody.style.overflowY = 'hidden';
-            }
-            else {
-                chatBody.style.overflowY = 'auto';
-            }
+        if (!chatBody) {
+            return;
         }
-        function handleClickOutside(e) {
-            if (contextMenuRef.current && !contextMenuRef.current.contains(e.target)) {
-                if (isContextMenuOpen) {
-                    e.stopPropagation();
-                    setIsContextMenuOpen(false);
-                }
-            }
-        }
-        document.addEventListener('click', handleClickOutside);
-        return function () {
-            document.removeEventListener('click', handleClickOutside);
-        };
-    }, [isContextMenuOpen]);
-    var handleClickMoreButton = function () {
+        chatBody.style.overflowY = isContextMenuOpen ? 'hidden' : 'auto';
+    }, [isContextMenuOpen, chatBody]);
+    var handleMoreButtonClick = function (e) {
+        e.stopPropagation();
         setIsContextMenuOpen(function (prev) { return !prev; });
     };
-    var handleClickContextMenuItem = function (option) {
-        if (onClickContextMenu) {
-            onClickContextMenu(option);
+    var handleContextMenuItemClick = function (option) {
+        if (onClickContextMenuItem) {
+            onClickContextMenuItem(option);
         }
         setIsContextMenuOpen(false);
     };
     return (react_1.default.createElement(react_1.default.Fragment, null,
-        react_1.default.createElement(S_BasicChatListItem, { colorTheme: colorTheme, hoverBtnMode: hoverBtnMode },
+        react_1.default.createElement(S_BasicChatListItem, { colorTheme: colorTheme, hoverMode: hoverMode },
             leftImageMode === 'use' && (react_1.default.createElement(S_ImageViewWrapper, null,
                 react_1.default.createElement(hybrid_1.ImageView, { shapeType: "circular", ratio: "1_1", scaleType: "cover", src: imageSrc, width: "responsive" }))),
             react_1.default.createElement(TextLabel_1.TextLabel, { text: titleText, styleTheme: "caption1Bold", colorTheme: titleTextColors[colorTheme] }),
             react_1.default.createElement(S_ContentTextWrapper, null,
                 react_1.default.createElement(TextLabel_1.TextLabel, { text: contentText, styleTheme: "caption1Regular", colorTheme: "sysTextPrimary", wordBreak: "break_all" })),
-            react_1.default.createElement(S_SeeMoreButton, { isContextMenuOpen: isContextMenuOpen },
-                react_1.default.createElement(IconButton_1.IconButton, { fillType: "fill", baseSize: "xsmall", iconFillType: "fill", iconSize: 20, iconName: "ic_more", baseColorKey: "ui_cpnt_button_fill_base_transparent", iconColorKey: "ui_cpnt_button_icon_on_primary", onClick: handleClickMoreButton }),
-                isContextMenuOpen && (react_1.default.createElement(S_ContextMenuWrapper, { ref: contextMenuRef },
-                    react_1.default.createElement(ContextMenu_1.ContextMenu, null, contextMenuOptionArray === null || contextMenuOptionArray === void 0 ? void 0 : contextMenuOptionArray.map(function (el) { return (react_1.default.createElement(ContextMenuItem_1.ContextMenuItem, { key: el.value, option: el, onClick: handleClickContextMenuItem, state: contextMenuState })); }))))))));
+            hoverMode === 'use' && (react_1.default.createElement(S_SeeMoreButton, { isContextMenuOpen: isContextMenuOpen, ref: contextMenuRef },
+                react_1.default.createElement(IconButton_1.IconButton, { fillType: "fill", baseSize: "xsmall", iconFillType: "fill", iconSize: 20, iconName: "ic_more", baseColorKey: "ui_cpnt_button_fill_base_transparent", iconColorKey: "ui_cpnt_button_icon_enabled", onClick: handleMoreButtonClick }))),
+            react_1.default.createElement(Popup_1.PopupProvider, null,
+                react_1.default.createElement(Popup_1.Popup, { targetRef: contextMenuRef, isOpen: isContextMenuOpen, placement: "v-auto", wrapperHeight: rect === null || rect === void 0 ? void 0 : rect.height, onClickOutside: function () { return setIsContextMenuOpen(false); } },
+                    react_1.default.createElement(ContextMenu_1.ContextMenu, null, contextMenuOptionArray === null || contextMenuOptionArray === void 0 ? void 0 : contextMenuOptionArray.map(function (el) { return (react_1.default.createElement(ContextMenuItem_1.ContextMenuItem, { key: el.value, option: el, onClick: handleContextMenuItemClick, state: contextMenuState })); })))))));
 }
-var S_SeeMoreButton = styled_components_1.default.div(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n  display: ", ";\n  margin-left: ", ";\n  position: relative;\n"], ["\n  display: ", ";\n  margin-left: ", ";\n  position: relative;\n"])), function (_a) {
-    var isContextMenuOpen = _a.isContextMenuOpen;
-    return (isContextMenuOpen ? 'block' : 'none');
-}, function (_a) {
+var S_SeeMoreButton = styled_components_1.default.div(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n  margin-left: ", ";\n  position: relative;\n  visibility: ", ";\n"], ["\n  margin-left: ", ";\n  position: relative;\n  visibility: ", ";\n"])), function (_a) {
     var theme = _a.theme;
     return theme.spacing.spacingA;
+}, function (_a) {
+    var isContextMenuOpen = _a.isContextMenuOpen;
+    return (isContextMenuOpen ? 'visible' : 'hidden');
 });
-var S_BasicChatListItem = styled_components_1.default.div(templateObject_2 || (templateObject_2 = __makeTemplateObject(["\n  display: flex;\n  height: fit-content;\n  min-height: 24px;\n  max-width: 100%;\n  padding-bottom: ", ";\n  padding-left: ", ";\n  padding-right: ", ";\n  padding-top: ", ";\n\n  ", ";\n\n  :hover {\n    ", " {\n      display: ", ";\n    }\n  }\n"], ["\n  display: flex;\n  height: fit-content;\n  min-height: 24px;\n  max-width: 100%;\n  padding-bottom: ", ";\n  padding-left: ", ";\n  padding-right: ", ";\n  padding-top: ", ";\n\n  ", ";\n\n  :hover {\n    ", " {\n      display: ", ";\n    }\n  }\n"])), function (_a) {
+var S_BasicChatListItem = styled_components_1.default.div(templateObject_2 || (templateObject_2 = __makeTemplateObject(["\n  background-color: ", ";\n  display: flex;\n  height: fit-content;\n  max-width: 100%;\n  min-height: 24px;\n  padding-bottom: ", ";\n  padding-left: ", ";\n  padding-right: ", ";\n  padding-top: ", ";\n\n  :hover {\n    ", " {\n      visibility: ", ";\n    }\n  }\n"], ["\n  background-color: ", ";\n  display: flex;\n  height: fit-content;\n  max-width: 100%;\n  min-height: 24px;\n  padding-bottom: ", ";\n  padding-left: ", ";\n  padding-right: ", ";\n  padding-top: ", ";\n\n  :hover {\n    ", " {\n      visibility: ", ";\n    }\n  }\n"])), function (_a) {
+    var colorTheme = _a.colorTheme, theme = _a.theme;
+    return colorTheme && theme[backgroundColorTheme[colorTheme]];
+}, function (_a) {
     var theme = _a.theme;
     return theme.spacing.spacingA;
 }, function (_a) {
@@ -114,12 +105,9 @@ var S_BasicChatListItem = styled_components_1.default.div(templateObject_2 || (t
 }, function (_a) {
     var theme = _a.theme;
     return theme.spacing.spacingA;
-}, function (_a) {
-    var colorTheme = _a.colorTheme, theme = _a.theme;
-    return colorTheme && theme[backgroundColorTheme[colorTheme]];
 }, S_SeeMoreButton, function (_a) {
-    var hoverBtnMode = _a.hoverBtnMode;
-    return hoverBtnMode === 'use' && 'block';
+    var hoverMode = _a.hoverMode;
+    return hoverMode === 'use' && 'visible';
 });
 var S_ImageViewWrapper = styled_components_1.default.div(templateObject_3 || (templateObject_3 = __makeTemplateObject(["\n  height: 24px;\n  margin-right: ", ";\n  min-width: 24px;\n  width: 24px;\n"], ["\n  height: 24px;\n  margin-right: ", ";\n  min-width: 24px;\n  width: 24px;\n"])), function (_a) {
     var theme = _a.theme;
@@ -129,6 +117,5 @@ var S_ContentTextWrapper = styled_components_1.default.div(templateObject_4 || (
     var theme = _a.theme;
     return theme.spacing.spacingC;
 });
-var S_ContextMenuWrapper = styled_components_1.default.div(templateObject_5 || (templateObject_5 = __makeTemplateObject(["\n  position: absolute;\n  right: -4px;\n  z-index: 10;\n"], ["\n  position: absolute;\n  right: -4px;\n  z-index: 10;\n"])));
 exports.default = BasicChatListItem;
-var templateObject_1, templateObject_2, templateObject_3, templateObject_4, templateObject_5;
+var templateObject_1, templateObject_2, templateObject_3, templateObject_4;

package/dist/src/desktop/components/BasicChatListItem/Popup.d.ts

@@ -0,0 +1,19 @@
+import React, { MutableRefObject } from 'react';
+declare type Props = {
+    targetRef: MutableRefObject<HTMLElement | null>;
+    isOpen: boolean;
+    onClickOutside?: () => void;
+    onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;
+    placement: string;
+    wrapperHeight?: number;
+    children: React.ReactNode;
+};
+declare function Popup({ targetRef, isOpen, onClickOutside, onClick, placement, wrapperHeight, children }: Props): JSX.Element;
+/**
+ * 팝업 루트 프로바이더
+ * 팝업을 사용하기 위해서는 팝업 프로바이더가 상위 컴포넌트로 있어야 합니다.
+ */
+declare function PopupProvider({ children }: {
+    children: React.ReactNode;
+}): JSX.Element;
+export { PopupProvider, Popup };

package/dist/src/desktop/components/BasicChatListItem/Popup.js

@@ -0,0 +1,238 @@
+"use strict";
+var __makeTemplateObject = (this && this.__makeTemplateObject) || function (cooked, raw) {
+    if (Object.defineProperty) { Object.defineProperty(cooked, "raw", { value: raw }); } else { cooked.raw = raw; }
+    return cooked;
+};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Popup = exports.PopupProvider = void 0;
+var react_1 = __importStar(require("react"));
+var react_dom_1 = require("react-dom");
+var styled_components_1 = __importDefault(require("styled-components"));
+var PopupContext = (0, react_1.createContext)({
+    current: null
+});
+function getHAutoPlacement(_a) {
+    var targetRect = _a.targetRect, popupRect = _a.popupRect;
+    var leftSpaced = targetRect.right + popupRect.width > window.innerWidth;
+    var topSpaced = targetRect.bottom + popupRect.height > window.innerHeight;
+    return (leftSpaced ? 'left' : 'right') + "-" + (topSpaced ? 'end' : 'start');
+}
+function getVAutoPlacement(_a) {
+    var targetRect = _a.targetRect, popupRect = _a.popupRect, wrapperHeight = _a.wrapperHeight;
+    var leftSpaced = targetRect.right + popupRect.width > window.innerWidth;
+    var topSpaced = targetRect.bottom + popupRect.height > (wrapperHeight || window.innerWidth);
+    return (topSpaced ? 'top' : 'bottom') + "-" + (leftSpaced ? 'end' : 'start');
+}
+function getVCenterPlacement(_a) {
+    var targetRect = _a.targetRect, popupRect = _a.popupRect;
+    var leftSpaced = targetRect.right + popupRect.width > window.innerWidth;
+    return leftSpaced ? 'left-center' : 'right-center';
+}
+function getHCenterPlacement(_a) {
+    var targetRect = _a.targetRect, popupRect = _a.popupRect;
+    var topSpaced = targetRect.bottom + popupRect.height > window.innerHeight;
+    return topSpaced ? 'top-center' : 'bottom-center';
+}
+/**
+ * 위치 정규화
+ */
+function getNormalizedPlacement(_a) {
+    var placement = _a.placement, targetRect = _a.targetRect, popupRect = _a.popupRect, wrapperHeight = _a.wrapperHeight;
+    switch (placement) {
+        case 'v-auto':
+            return getVAutoPlacement({ targetRect: targetRect, popupRect: popupRect, wrapperHeight: wrapperHeight });
+        case 'h-auto':
+            return getHAutoPlacement({ targetRect: targetRect, popupRect: popupRect, wrapperHeight: wrapperHeight });
+        case 'v-center':
+            return getVCenterPlacement({ targetRect: targetRect, popupRect: popupRect, wrapperHeight: wrapperHeight });
+        case 'h-center':
+            return getHCenterPlacement({ targetRect: targetRect, popupRect: popupRect, wrapperHeight: wrapperHeight });
+        default:
+            return placement;
+    }
+}
+function updatePosition(_a) {
+    var targetElem = _a.targetElem, popupElem = _a.popupElem, placement = _a.placement, wrapperHeight = _a.wrapperHeight;
+    var targetRect = targetElem.getBoundingClientRect();
+    var popupRect = popupElem.getBoundingClientRect();
+    var normPlacement = getNormalizedPlacement({ placement: placement, targetRect: targetRect, popupRect: popupRect, wrapperHeight: wrapperHeight });
+    switch (normPlacement) {
+        case 'top':
+            popupElem.style.top = targetRect.top - popupRect.height + "px";
+            popupElem.style.left = targetRect.left - (popupRect.width - targetRect.width) / 2 + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'top-start':
+            popupElem.style.top = targetRect.top - popupRect.height + "px";
+            popupElem.style.left = targetRect.left + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'top-end':
+            popupElem.style.top = targetRect.top - popupRect.height + "px";
+            popupElem.style.left = targetRect.left + targetRect.width - popupRect.width + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'top-both':
+            popupElem.style.top = targetRect.top - popupRect.height + "px";
+            popupElem.style.left = targetRect.left + "px";
+            popupElem.style.width = targetRect.width + "px";
+            break;
+        case 'top-center':
+            popupElem.style.top = targetRect.top - popupRect.height + "px";
+            popupElem.style.left = targetRect.left - (popupRect.width - targetRect.width) / 2 + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'bottom':
+            popupElem.style.top = targetRect.bottom + "px";
+            popupElem.style.left = targetRect.left - (popupRect.width - targetRect.width) / 2 + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'bottom-start':
+            popupElem.style.top = targetRect.bottom + "px";
+            popupElem.style.left = targetRect.left + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'bottom-end':
+            popupElem.style.top = targetRect.bottom + "px";
+            popupElem.style.left = targetRect.right - popupRect.width + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'bottom-both':
+            popupElem.style.top = targetRect.bottom + "px";
+            popupElem.style.left = targetRect.left + "px";
+            popupElem.style.width = targetRect.width + "px";
+            break;
+        case 'bottom-center':
+            popupElem.style.top = targetRect.bottom + "px";
+            popupElem.style.left = targetRect.left - (popupRect.width - targetRect.width) / 2 + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'left':
+            popupElem.style.top = targetRect.top - (popupRect.height - targetRect.height) / 2 + "px";
+            popupElem.style.left = targetRect.left - popupRect.width + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'left-start':
+            popupElem.style.top = targetRect.top + "px";
+            popupElem.style.left = targetRect.left - popupRect.width + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'left-end':
+            popupElem.style.top = targetRect.top - (popupRect.height - targetRect.height) + "px";
+            popupElem.style.left = targetRect.left - popupRect.width + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'left-center':
+            popupElem.style.top = targetRect.top - (popupRect.height - targetRect.height) / 2 + "px";
+            popupElem.style.left = targetRect.left - popupRect.width + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'right':
+            popupElem.style.top = targetRect.top - (popupRect.height - targetRect.height) / 2 + "px";
+            popupElem.style.left = targetRect.left + targetRect.width + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'right-start':
+            popupElem.style.top = targetRect.top + "px";
+            popupElem.style.left = targetRect.left + targetRect.width + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'right-end':
+            popupElem.style.top = targetRect.top - (popupRect.height - targetRect.height) + "px";
+            popupElem.style.left = targetRect.left + targetRect.width + "px";
+            popupElem.style.width = 'auto';
+            break;
+        case 'right-center':
+            popupElem.style.top = targetRect.top - (popupRect.height - targetRect.height) / 2 + "px";
+            popupElem.style.left = targetRect.left + targetRect.width + "px";
+            popupElem.style.width = 'auto';
+            break;
+        default:
+            break;
+    }
+    return normPlacement;
+}
+function Popup(_a) {
+    var targetRef = _a.targetRef, _b = _a.isOpen, isOpen = _b === void 0 ? false : _b, onClickOutside = _a.onClickOutside, onClick = _a.onClick, _c = _a.placement, placement = _c === void 0 ? 'bottom-start' : _c, wrapperHeight = _a.wrapperHeight, children = _a.children;
+    var popupRootRef = (0, react_1.useContext)(PopupContext);
+    var _d = (0, react_1.useState)('bottom'), normPlacement = _d[0], setNormPlacement = _d[1];
+    var popupRef = (0, react_1.useRef)(null);
+    /**
+     * 팝업 외의 다른 요소 클릭시 팝업이 닫히도록 합니다.
+     */
+    (0, react_1.useEffect)(function () {
+        function handleClickOutside(e) {
+            if (popupRootRef.current && !popupRootRef.current.contains(e.target)) {
+                if (onClickOutside) {
+                    onClickOutside();
+                }
+            }
+        }
+        window.document.addEventListener('mousedown', handleClickOutside);
+        return function () {
+            window.document.removeEventListener('mousedown', handleClickOutside);
+        };
+    }, [popupRootRef, onClickOutside]);
+    /**
+     * 전체 UI 렌더링이 한 프레임 완료된 후에 팝업 위치를 결정합니다.
+     */
+    (0, react_1.useEffect)(function () {
+        window.requestAnimationFrame(function () {
+            if (!targetRef.current || !popupRef.current) {
+                return;
+            }
+            var targetElem = targetRef.current;
+            var popupElem = popupRef.current;
+            var updatedPlacement = updatePosition({ targetElem: targetElem, popupElem: popupElem, placement: placement, wrapperHeight: wrapperHeight });
+            setNormPlacement(updatedPlacement);
+        });
+    }, [isOpen, placement, wrapperHeight, targetRef, popupRef]);
+    function handlePopupClick(e) {
+        e.stopPropagation();
+        if (onClick) {
+            onClick(e);
+        }
+    }
+    if (!popupRootRef || !popupRootRef.current || !isOpen) {
+        return react_1.default.createElement(react_1.default.Fragment, null);
+    }
+    var popupComponent = (react_1.default.createElement(S_Popup, { ref: popupRef, onClick: function (e) { return handlePopupClick(e); } }, typeof children === 'function' ? children(normPlacement) : children));
+    return (0, react_dom_1.createPortal)(popupComponent, popupRootRef.current);
+}
+exports.Popup = Popup;
+var S_Popup = styled_components_1.default.div(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n  left: -1000px;\n  position: fixed;\n  top: -1000px;\n  z-index: 1000;\n"], ["\n  left: -1000px;\n  position: fixed;\n  top: -1000px;\n  z-index: 1000;\n"])));
+/**
+ * 팝업 루트 프로바이더
+ * 팝업을 사용하기 위해서는 팝업 프로바이더가 상위 컴포넌트로 있어야 합니다.
+ */
+function PopupProvider(_a) {
+    var children = _a.children;
+    var ref = (0, react_1.useRef)();
+    return (react_1.default.createElement(react_1.default.Fragment, null,
+        react_1.default.createElement(PopupContext.Provider, { value: ref }, children),
+        react_1.default.createElement("div", { ref: ref })));
+}
+exports.PopupProvider = PopupProvider;
+var templateObject_1;

package/dist/src/desktop/components/BodyTextGroup/BodyTextGroup.d.ts

@@ -4,7 +4,10 @@ declare type BodyTextGroupProps = {
     titleText: PDSTextType;
     descText?: PDSTextType;
     contentText?: PDSTextType;
+    titleTextWordBreak?: 'normal' | 'break_all' | 'keep_all' | 'break_word';
+    descTextWordBreak?: 'normal' | 'break_all' | 'keep_all' | 'break_word';
+    contentTextWordBreak?: 'normal' | 'break_all' | 'keep_all' | 'break_word';
     contentFontWeight?: 'regular' | 'bold';
 };
-declare function BodyTextGroup({ titleText, descText, contentText, contentFontWeight }: BodyTextGroupProps): JSX.Element;
+declare function BodyTextGroup({ titleText, descText, contentText, titleTextWordBreak, descTextWordBreak, contentTextWordBreak, contentFontWeight }: BodyTextGroupProps): JSX.Element;
 export default BodyTextGroup;

package/dist/src/desktop/components/BodyTextGroup/BodyTextGroup.js

@@ -7,14 +7,14 @@ var react_1 = __importDefault(require("react"));
 var hybrid_1 = require("../../../hybrid");
 var TextLabel_1 = require("../TextLabel");
 function BodyTextGroup(_a) {
-    var titleText = _a.titleText, descText = _a.descText, contentText = _a.contentText, _b = _a.contentFontWeight, contentFontWeight = _b === void 0 ? 'regular' : _b;
+    var titleText = _a.titleText, descText = _a.descText, contentText = _a.contentText, _b = _a.titleTextWordBreak, titleTextWordBreak = _b === void 0 ? 'keep_all' : _b, _c = _a.descTextWordBreak, descTextWordBreak = _c === void 0 ? 'keep_all' : _c, _d = _a.contentTextWordBreak, contentTextWordBreak = _d === void 0 ? 'keep_all' : _d, _e = _a.contentFontWeight, contentFontWeight = _e === void 0 ? 'regular' : _e;
     return (react_1.default.createElement("div", null,
-        react_1.default.createElement(TextLabel_1.TextLabel, { text: titleText, styleTheme: "subTitleBold", colorTheme: "sysTextPrimary" }),
+        react_1.default.createElement(TextLabel_1.TextLabel, { text: titleText, wordBreak: titleTextWordBreak, styleTheme: "subTitleBold", colorTheme: "sysTextPrimary" }),
         descText && (react_1.default.createElement(react_1.default.Fragment, null,
             react_1.default.createElement(hybrid_1.Spacing, { size: "spacing_d" }),
-            react_1.default.createElement(TextLabel_1.TextLabel, { text: descText, styleTheme: "caption1Regular", colorTheme: "sysTextSecondary" }))),
+            react_1.default.createElement(TextLabel_1.TextLabel, { text: descText, wordBreak: descTextWordBreak, styleTheme: "caption1Regular", colorTheme: "sysTextSecondary" }))),
         contentText && (react_1.default.createElement(react_1.default.Fragment, null,
             react_1.default.createElement(hybrid_1.Spacing, { size: "spacing_d" }),
-            react_1.default.createElement(TextLabel_1.TextLabel, { text: contentText, styleTheme: contentFontWeight === 'regular' ? 'body2Regular' : 'body2Bold', colorTheme: "sysTextPrimary" })))));
+            react_1.default.createElement(TextLabel_1.TextLabel, { text: contentText, wordBreak: contentTextWordBreak, styleTheme: contentFontWeight === 'regular' ? 'body2Regular' : 'body2Bold', colorTheme: "sysTextPrimary" })))));
 }
 exports.default = BodyTextGroup;

package/dist/src/desktop/components/ChatList/Body.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="react" />
 import type { Props as ChatListProps } from './ChatList';
-declare type Props = Pick<ChatListProps, 'scrollVisibleType' | 'children' | 'bodyBtnText'> & {
+declare type Props = Pick<ChatListProps, 'scrollVisibleType' | 'children' | 'bodyMBtnText'> & {
     isSubmitted: boolean;
 };
-declare function Body({ scrollVisibleType, children, isSubmitted, bodyBtnText }: Props): JSX.Element;
+declare function Body({ scrollVisibleType, children, isSubmitted, bodyMBtnText }: Props): JSX.Element;
 export default Body;

package/dist/src/desktop/components/ChatList/Body.js

@@ -31,10 +31,11 @@ var styled_components_1 = __importStar(require("styled-components"));
 var MainButton_1 = require("../MainButton");
 var useAutoScrollToBottom_1 = __importDefault(require("./useAutoScrollToBottom"));
 function Body(_a) {
-    var scrollVisibleType = _a.scrollVisibleType, children = _a.children, isSubmitted = _a.isSubmitted, bodyBtnText = _a.bodyBtnText;
+    var scrollVisibleType = _a.scrollVisibleType, children = _a.children, isSubmitted = _a.isSubmitted, bodyMBtnText = _a.bodyMBtnText;
     var _b = (0, react_1.useState)(false), isButtonShow = _b[0], setIsButtonShow = _b[1];
     var _c = (0, useAutoScrollToBottom_1.default)(), triggerScrollToBottom = _c.triggerScrollToBottom, EndOfList = _c.EndOfList;
     var scrollRef = (0, react_1.useRef)(null);
+    var childrenLength = react_1.default.Children.count(children);
     /**
      * @when 스크롤하지 않은 상태에서 chatMessages가 업데이트 될 때마다
      * @expected 채팅 리스트의 맨 밑으로 스크롤 내린다.
@@ -48,26 +49,24 @@ function Body(_a) {
             return;
         }
         triggerScrollToBottom();
-    }, [children, isButtonShow, isSubmitted]);
+    }, [childrenLength, isButtonShow, isSubmitted]);
     var handleClickMBtn = function () {
         triggerScrollToBottom();
     };
-    var handleScroll = function () {
-        if (scrollRef.current) {
-            var _a = scrollRef.current, scrollTop = _a.scrollTop, scrollHeight = _a.scrollHeight, clientHeight = _a.clientHeight;
-            if (Math.ceil(scrollTop) + clientHeight === scrollHeight) {
-                setIsButtonShow(false);
-                return;
-            }
-            setIsButtonShow(true);
+    var handleScroll = function (e) {
+        var _a = e.currentTarget, scrollTop = _a.scrollTop, scrollHeight = _a.scrollHeight, clientHeight = _a.clientHeight;
+        if (scrollTop + clientHeight === scrollHeight) {
+            setIsButtonShow(false);
+            return;
         }
+        setIsButtonShow(true);
     };
     return (react_1.default.createElement(S_Body, null,
         react_1.default.createElement(S_ChatMessageBox, { id: "chatMessageBox", onScroll: handleScroll, ref: scrollRef, scrollVisibleType: scrollVisibleType },
             children,
             react_1.default.createElement(EndOfList, null)),
         isButtonShow && (react_1.default.createElement(S_BottomButtonWrapper, null,
-            react_1.default.createElement(MainButton_1.MainButton, { text: bodyBtnText, size: "small", onClick: handleClickMBtn })))));
+            react_1.default.createElement(MainButton_1.MainButton, { text: bodyMBtnText, size: "small", onClick: handleClickMBtn })))));
 }
 var S_Body = styled_components_1.default.div(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n  flex: 1;\n  overflow-x: hidden;\n  overflow-y: hidden;\n  position: relative;\n"], ["\n  flex: 1;\n  overflow-x: hidden;\n  overflow-y: hidden;\n  position: relative;\n"])));
 var scrollVisibleStyle = (0, styled_components_1.css)(templateObject_2 || (templateObject_2 = __makeTemplateObject(["\n  ::-webkit-scrollbar {\n    display: block;\n  }\n"], ["\n  ::-webkit-scrollbar {\n    display: block;\n  }\n"])));
@@ -82,7 +81,7 @@ var S_ChatMessageBox = styled_components_1.default.div(templateObject_4 || (temp
         hidden: scrollHiddenStyle
     }[scrollVisibleType];
 });
-var S_BottomButtonWrapper = styled_components_1.default.div(templateObject_5 || (templateObject_5 = __makeTemplateObject(["\n  position: absolute;\n  bottom: ", ";\n  left: 50%;\n  transform: translate(-50%, 0);\n"], ["\n  position: absolute;\n  bottom: ", ";\n  left: 50%;\n  transform: translate(-50%, 0);\n"])), function (_a) {
+var S_BottomButtonWrapper = styled_components_1.default.div(templateObject_5 || (templateObject_5 = __makeTemplateObject(["\n  bottom: ", ";\n  left: 50%;\n  position: absolute;\n  transform: translate(-50%, 0);\n"], ["\n  bottom: ", ";\n  left: 50%;\n  position: absolute;\n  transform: translate(-50%, 0);\n"])), function (_a) {
     var theme = _a.theme;
     return theme.spacing.spacingC;
 });

package/dist/src/desktop/components/ChatList/ChatList.d.ts

@@ -6,8 +6,8 @@ export declare type Props = {
     titleText?: PDSTextType;
     captionText?: PDSTextType;
     headerDisplayType?: 'none' | 'ibtn1';
-    iBtn1IconName?: FillIconNameKeys | LineIconNameKeys;
-    iBtn1IconFillType?: 'line' | 'fill';
+    headerIBtn1IconName?: FillIconNameKeys | LineIconNameKeys;
+    headerIBtn1IconFillType?: 'line' | 'fill';
     children?: React.ReactNode;
     textFieldState?: 'normal' | 'read_only' | 'disabled';
     textFieldHintText?: PDSTextType;
@@ -15,9 +15,9 @@ export declare type Props = {
     textFieldMaxLength?: number;
     scrollVisibleType?: 'moving' | 'hidden' | 'visible';
     footerChildren?: React.ReactNode;
-    submitBtnState?: 'disabled' | 'normal';
-    bodyBtnText?: PDSTextType;
+    submitIBtnState?: 'disabled' | 'normal';
+    bodyMBtnText?: PDSTextType;
     onSubmit: (value: string) => void;
 };
-declare function ChatList({ styleTheme, headerMode, titleText, captionText, headerDisplayType, iBtn1IconName, iBtn1IconFillType, children, textFieldState, textFieldHintText, textFieldDefaultText, textFieldMaxLength, scrollVisibleType, footerChildren, submitBtnState, bodyBtnText, onSubmit }: Props): JSX.Element;
+declare function ChatList({ styleTheme, headerMode, titleText, captionText, headerDisplayType, headerIBtn1IconName, headerIBtn1IconFillType, children, textFieldState, textFieldHintText, textFieldDefaultText, textFieldMaxLength, scrollVisibleType, footerChildren, submitIBtnState, bodyMBtnText, onSubmit }: Props): JSX.Element;
 export default ChatList;