pds-dev-kit-web 1.4.26 → 1.4.29

package/dist/src/desktop/layout/LayoutWS/ContainersBox/ContainersBox.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 export declare type ContainersBoxProps = {
-    layoutType: 'WSA_1' | 'WSB_1' | 'WSC_1' | 'WSD_1' | 'WSE_1' | 'WSF_1' | 'WSF_2' | 'WSF_3' | 'WSF_4' | 'WSF_5' | 'WSF_6' | 'WSF_7' | 'WSG_1' | 'WSG_2' | 'WSG_3' | 'WSG_4';
+    layoutType: 'WSA_1' | 'WSB_1' | 'WSC_1' | 'WSD_1' | 'WSE_1' | 'WSF_1' | 'WSF_2' | 'WSF_3' | 'WSF_4' | 'WSF_5' | 'WSF_6' | 'WSF_7' | 'WSG_1' | 'WSG_2' | 'WSG_3' | 'WSG_4' | 'WSG_5';
     pageMenuContent?: JSX.Element;
     tabMenuContent?: JSX.Element;
     content1?: JSX.Element;

package/dist/src/mobile/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/mobile/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/mobile/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/mobile/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/mobile/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/mobile/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(react_1.default.Fragment, 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("div", 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/mobile/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/mobile/components/ChatList/Body.js

@@ -32,10 +32,11 @@ var MainButton_1 = require("../MainButton");
 var useAutoScrollToBottom_1 = __importDefault(require("./useAutoScrollToBottom"));
 var useTimeout_1 = __importDefault(require("./useTimeout"));
 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);
     var handleTriggerScroll = function () {
         if (isButtonShow) {
             if (isSubmitted) {
@@ -50,7 +51,7 @@ function Body(_a) {
      * @expected 채팅 리스트의 맨 밑으로 스크롤 내린다.
      * @clear -
      */
-    (0, useTimeout_1.default)({ callback: handleTriggerScroll, target: children }, 200);
+    (0, useTimeout_1.default)({ callback: handleTriggerScroll, target: childrenLength }, 200);
     var handleClickMBtn = function () {
         triggerScrollToBottom();
     };
@@ -70,7 +71,7 @@ function Body(_a) {
             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"])));

package/dist/src/mobile/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,10 @@ 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;
+    onClickHeaderIBtn1?: () => 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, onClickHeaderIBtn1 }: Props): JSX.Element;
 export default ChatList;

package/dist/src/mobile/components/ChatList/ChatList.js

@@ -50,21 +50,21 @@ var baseBackgroundColors = {
     transparent: 'ui_cpnt_list_base_area_translucent'
 };
 function ChatList(_a) {
-    var _b = _a.styleTheme, styleTheme = _b === void 0 ? 'solid' : _b, _c = _a.headerMode, headerMode = _c === void 0 ? 'use' : _c, titleText = _a.titleText, captionText = _a.captionText, _d = _a.headerDisplayType, headerDisplayType = _d === void 0 ? 'none' : _d, _e = _a.iBtn1IconName, iBtn1IconName = _e === void 0 ? 'ic_xmark' : _e, _f = _a.iBtn1IconFillType, iBtn1IconFillType = _f === void 0 ? 'line' : _f, children = _a.children, _g = _a.textFieldState, textFieldState = _g === void 0 ? 'normal' : _g, textFieldHintText = _a.textFieldHintText, textFieldDefaultText = _a.textFieldDefaultText, textFieldMaxLength = _a.textFieldMaxLength, _h = _a.scrollVisibleType, scrollVisibleType = _h === void 0 ? 'moving' : _h, footerChildren = _a.footerChildren, submitBtnState = _a.submitBtnState, bodyBtnText = _a.bodyBtnText, onSubmit = _a.onSubmit;
+    var _b = _a.styleTheme, styleTheme = _b === void 0 ? 'solid' : _b, _c = _a.headerMode, headerMode = _c === void 0 ? 'use' : _c, titleText = _a.titleText, captionText = _a.captionText, _d = _a.headerDisplayType, headerDisplayType = _d === void 0 ? 'none' : _d, _e = _a.headerIBtn1IconName, headerIBtn1IconName = _e === void 0 ? 'ic_xmark' : _e, _f = _a.headerIBtn1IconFillType, headerIBtn1IconFillType = _f === void 0 ? 'line' : _f, children = _a.children, _g = _a.textFieldState, textFieldState = _g === void 0 ? 'normal' : _g, textFieldHintText = _a.textFieldHintText, textFieldDefaultText = _a.textFieldDefaultText, textFieldMaxLength = _a.textFieldMaxLength, _h = _a.scrollVisibleType, scrollVisibleType = _h === void 0 ? 'moving' : _h, footerChildren = _a.footerChildren, _j = _a.submitIBtnState, submitIBtnState = _j === void 0 ? 'normal' : _j, bodyMBtnText = _a.bodyMBtnText, onSubmit = _a.onSubmit, onClickHeaderIBtn1 = _a.onClickHeaderIBtn1;
     var methods = (0, react_hook_form_1.useForm)({
         mode: 'onChange',
         defaultValues: {
             chat: ''
         }
     });
-    var reset = methods.reset, handleSubmit = methods.handleSubmit, control = methods.control, _j = methods.formState, isSubmitted = _j.isSubmitted, isValid = _j.isValid, isDirty = _j.isDirty;
+    var reset = methods.reset, handleSubmit = methods.handleSubmit, control = methods.control, _k = methods.formState, isSubmitted = _k.isSubmitted, isValid = _k.isValid, isDirty = _k.isDirty;
     var inputValue = (0, react_hook_form_1.useWatch)({ name: 'chat', control: control });
     var isSubmitButtonActive = (0, react_1.useMemo)(function () {
-        if (!submitBtnState) {
+        if (!submitIBtnState) {
             return false;
         }
-        return isDirty && isValid && inputValue.length > 0 && submitBtnState === 'normal';
-    }, [isDirty, isValid, inputValue, submitBtnState]);
+        return isDirty && isValid && inputValue.length > 0 && submitIBtnState === 'normal';
+    }, [isDirty, isValid, inputValue, submitIBtnState]);
     var handleSubmitChat = function (_a) {
         var chat = _a.chat;
         if (!chat || !isSubmitButtonActive) {
@@ -75,9 +75,9 @@ function ChatList(_a) {
     };
     return (react_1.default.createElement(S_ChatList, { backgroundColor: baseBackgroundColors[styleTheme], id: "chatList" },
         headerMode === 'use' && (react_1.default.createElement(react_1.default.Fragment, null,
-            react_1.default.createElement(Header_1.default, { styleTheme: styleTheme, titleText: titleText, captionText: captionText, headerDisplayType: headerDisplayType, iBtn1IconName: iBtn1IconName, iBtn1IconFillType: iBtn1IconFillType }),
+            react_1.default.createElement(Header_1.default, { styleTheme: styleTheme, titleText: titleText, captionText: captionText, headerDisplayType: headerDisplayType, headerIBtn1IconName: headerIBtn1IconName, headerIBtn1IconFillType: headerIBtn1IconFillType, onClickHeaderIBtn1: onClickHeaderIBtn1 }),
             react_1.default.createElement(hybrid_1.Divider, null))),
-        react_1.default.createElement(Body_1.default, { scrollVisibleType: scrollVisibleType, isSubmitted: isSubmitted, bodyBtnText: bodyBtnText }, children),
+        react_1.default.createElement(Body_1.default, { scrollVisibleType: scrollVisibleType, isSubmitted: isSubmitted, bodyMBtnText: bodyMBtnText }, children),
         react_1.default.createElement(hybrid_1.Divider, null),
         react_1.default.createElement(hybrid_1.Spacing, { size: "spacing_d" }),
         react_1.default.createElement(react_hook_form_1.FormProvider, __assign({}, methods),

package/dist/src/mobile/components/ChatList/Header.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="react" />
 import type { Props as ChatListProps } from './ChatList';
-declare type Props = Required<Pick<ChatListProps, 'styleTheme'>> & Pick<ChatListProps, 'titleText' | 'captionText' | 'headerDisplayType' | 'iBtn1IconName' | 'iBtn1IconFillType'>;
-declare function Header({ styleTheme, titleText, captionText, headerDisplayType, iBtn1IconName, iBtn1IconFillType }: Props): JSX.Element;
+declare type Props = Required<Pick<ChatListProps, 'styleTheme'>> & Pick<ChatListProps, 'titleText' | 'captionText' | 'headerDisplayType' | 'headerIBtn1IconName' | 'headerIBtn1IconFillType' | 'onClickHeaderIBtn1'>;
+declare function Header({ styleTheme, titleText, captionText, headerDisplayType, headerIBtn1IconName, headerIBtn1IconFillType, onClickHeaderIBtn1 }: Props): JSX.Element;
 export default Header;

package/dist/src/mobile/components/ChatList/Header.js

@@ -23,14 +23,14 @@ var iconColors = {
     transparent: 'ui_cpnt_button_icon_white'
 };
 function Header(_a) {
-    var styleTheme = _a.styleTheme, titleText = _a.titleText, captionText = _a.captionText, headerDisplayType = _a.headerDisplayType, iBtn1IconName = _a.iBtn1IconName, iBtn1IconFillType = _a.iBtn1IconFillType;
+    var styleTheme = _a.styleTheme, titleText = _a.titleText, captionText = _a.captionText, headerDisplayType = _a.headerDisplayType, headerIBtn1IconName = _a.headerIBtn1IconName, headerIBtn1IconFillType = _a.headerIBtn1IconFillType, onClickHeaderIBtn1 = _a.onClickHeaderIBtn1;
     return (react_1.default.createElement(S_HeaderContentWrapper, null,
         react_1.default.createElement(S_HeaderLeftBox, null,
             titleText && (react_1.default.createElement(TextLabel_1.TextLabel, { text: titleText, styleTheme: "body1Bold", colorTheme: titleTextColors[styleTheme] })),
             captionText && (react_1.default.createElement(react_1.default.Fragment, null,
                 react_1.default.createElement(hybrid_1.Spacing, { size: "spacing_a" }),
                 react_1.default.createElement(TextLabel_1.TextLabel, { text: captionText, styleTheme: "caption1Regular", colorTheme: "sysTextSecondary", colorOverride: styleTheme === 'translucent' ? 'ui_cpnt_list_text_caption_02' : undefined })))),
-        headerDisplayType === 'ibtn1' && iBtn1IconName && (react_1.default.createElement(IconButton_1.IconButton, { iconName: iBtn1IconName, baseSize: "large", baseColorKey: "ui_cpnt_button_fill_base_transparent", iconColorKey: iconColors[styleTheme], iconSize: 24, iconFillType: iBtn1IconFillType }))));
+        headerDisplayType === 'ibtn1' && headerIBtn1IconName && (react_1.default.createElement(IconButton_1.IconButton, { iconName: headerIBtn1IconName, baseSize: "large", baseColorKey: "ui_cpnt_button_fill_base_transparent", iconColorKey: iconColors[styleTheme], iconSize: 24, iconFillType: headerIBtn1IconFillType, onClick: onClickHeaderIBtn1 }))));
 }
 var S_HeaderContentWrapper = styled_components_1.default.div(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n  align-items: center;\n  display: flex;\n  padding-bottom: ", ";\n  padding-left: ", ";\n  padding-right: ", ";\n  padding-top: ", ";\n"], ["\n  align-items: center;\n  display: flex;\n  padding-bottom: ", ";\n  padding-left: ", ";\n  padding-right: ", ";\n  padding-top: ", ";\n"])), function (_a) {
     var theme = _a.theme;