@ncds/ui-admin 1.8.21-alpha.0 → 1.8.21-alpha.10

package/dist/esm/assets/scripts/notification/MessageNotification.js

@@ -1,7 +1,8 @@
 import { FeaturedIcon } from '../featuredIcon';
 import { sanitizeHtml } from '../utils/sanitize';
-import { CLASS_NAMES, FLOATING_ICON_MAP, MESSAGE_SIZES, SVG_ICONS } from './const';
-import { bindNotificationEvents, createWrapperElement, renderActions, renderSupportingText, setupAutoClose } from './utils';
+import { CLASS_NAMES, FLOATING_ICON_MAP, MESSAGE_SIZES } from './const';
+import { buildMessageTemplate } from './messageTemplate';
+import { bindNotificationEvents, createWrapperElement, setupAutoClose } from './utils';
 export class MessageNotification {
   constructor(options) {
     this.options = {
@@ -24,7 +25,8 @@ export class MessageNotification {
       className,
       actions,
       onClose,
-      onHidePermanently
+      onHidePermanently,
+      hidePermanentlyLabel
     } = this.options;
     // message 타입은 neutral, error, warning, success 4가지 색상만 지원
     let actualColor = color;
@@ -41,16 +43,20 @@ export class MessageNotification {
         svgString: iconSvg,
         theme: 'light-circle',
         color: actualColor,
-        size: MESSAGE_SIZES.FEATURED_ICON
+        size: MESSAGE_SIZES.FEATURED_ICON,
+        // React 구현과 동일하게 `__icon`(flex-shrink: 0)을 부여한다.
+        // 누락 시 긴 타이틀에서 아이콘이 찌그러진다.
+        className: CLASS_NAMES.MESSAGE.ICON
       });
       featuredIconElement = this.featuredIcon.getElement();
     }
-    wrapper.innerHTML = sanitizeHtml(this.buildTemplate({
+    wrapper.innerHTML = sanitizeHtml(buildMessageTemplate({
       title,
       supportingText,
       actions,
       onClose,
-      onHidePermanently
+      onHidePermanently,
+      hidePermanentlyLabel
     }));
     // FeaturedIcon을 content-wrapper에 추가
     if (featuredIconElement) {
@@ -61,50 +67,6 @@ export class MessageNotification {
     }
     return wrapper;
   }
-  buildTemplate(params) {
-    const {
-      title,
-      supportingText,
-      actions,
-      onClose,
-      onHidePermanently
-    } = params;
-    return `
-      <div class="${CLASS_NAMES.MESSAGE.CONTAINER}">
-        <div class="${CLASS_NAMES.MESSAGE.CONTENT}">
-          <div class="${CLASS_NAMES.MESSAGE.CONTENT_WRAPPER}">
-            <div class="${CLASS_NAMES.MESSAGE.TEXT_CONTAINER}">
-              <span class="${CLASS_NAMES.MESSAGE.TITLE}">${title}</span>
-              ${renderSupportingText(supportingText, CLASS_NAMES.MESSAGE.SUPPORTING_TEXT)}
-            </div>
-          </div>
-          <div class="${CLASS_NAMES.MESSAGE.ACTIONS_CONTAINER}">
-            ${actions && actions.length > 0 ? renderActions(actions, CLASS_NAMES.MESSAGE.ACTIONS) : ''}
-          </div>
-          <div class="${CLASS_NAMES.MESSAGE.ACTIONS_CONTAINER}">
-            ${this.renderHidePermanentlyButton(onHidePermanently)}
-            ${this.renderCloseButton(onClose)}
-          </div>
-        </div>
-      </div>
-    `;
-  }
-  renderHidePermanentlyButton(onHidePermanently) {
-    if (!onHidePermanently) return '';
-    return `
-      <button type="button" class="${CLASS_NAMES.COMMON.ACTION_BUTTON} ${CLASS_NAMES.COMMON.ACTION_BUTTON}--text ${CLASS_NAMES.MESSAGE.HIDE_LINK}" data-hide-permanently="true">
-        다시 보지 않기
-      </button>
-    `;
-  }
-  renderCloseButton(onClose) {
-    if (!onClose) return '';
-    return `
-      <button type="button" class="${CLASS_NAMES.MESSAGE.CLOSE_BUTTON}" aria-label="알림 닫기">
-        ${SVG_ICONS['x-close'](MESSAGE_SIZES.CLOSE_BUTTON).replace('stroke="currentColor"', `stroke="#2F2F30"`)}
-      </button>
-    `;
-  }
   bindEvents() {
     bindNotificationEvents(this.element, this.options.actions, this.options.onClose, () => this.remove());
     // 다시보지 않기 버튼 이벤트 바인딩

package/dist/esm/assets/scripts/notification/const/classNames.js

@@ -35,6 +35,9 @@ export const CLASS_NAMES = {
     SUPPORTING_TEXT: 'ncua-message-notification__supporting-text',
     ACTIONS_CONTAINER: 'ncua-message-notification__actions-container',
     ACTIONS: 'ncua-message-notification__actions',
+    // 다시 보지 않기 + 닫기 그룹 전용 래퍼. ACTIONS_CONTAINER를 재사용하면
+    // 해당 클래스의 gap(12px)이 그룹 내부에도 적용되어 8px 규격이 깨진다.
+    FOOTER_CONTAINER: 'ncua-message-notification__footer-container',
     HIDE_LINK: 'ncua-message-notification__hide-link',
     CLOSE_BUTTON: 'ncua-message-notification__close-button'
   },

package/dist/esm/assets/scripts/notification/const/index.js

@@ -1,4 +1,5 @@
-export { SVG_ICONS, FLOATING_ICON_MAP, FULL_WIDTH_ICON_MAP, ICON_MAP } from './icons';
+// Re-export all constants and types from separate files
 export { CLASS_NAMES } from './classNames';
-export { FEATURED_ICON_SIZES, ICON_PIXEL_SIZES, CLOSE_BUTTON_SIZES, CLOSE_BUTTON_SVG_SIZES, FULL_WIDTH_SIZES, MESSAGE_SIZES, getSizes } from './sizes';
+export { FLOATING_ICON_MAP, FULL_WIDTH_ICON_MAP, ICON_MAP, SVG_ICONS } from './icons';
+export { CLOSE_BUTTON_SIZES, CLOSE_BUTTON_SVG_SIZES, FEATURED_ICON_SIZES, FULL_WIDTH_SIZES, getSizes, ICON_PIXEL_SIZES, MESSAGE_SIZES } from './sizes';
 export { MESSAGE_CLOSE_ICON_COLORS } from './types';

package/dist/esm/assets/scripts/notification/const/sizes.js

@@ -26,9 +26,11 @@ export const FULL_WIDTH_SIZES = {
   CLOSE_BUTTON: '20'
 };
 // Message 알림 고정 사이즈
+// FEATURED_ICON(원 크기)과 ICON_PIXEL(내부 SVG 크기)은 항상 짝을 맞춰야 한다.
+// 'md' = 40px 원 / 20px 아이콘 (FeaturedIcon iconSizeMap 기준)
 export const MESSAGE_SIZES = {
-  FEATURED_ICON: 'lg',
-  ICON_PIXEL: '24',
+  FEATURED_ICON: 'md',
+  ICON_PIXEL: '20',
   CLOSE_BUTTON: '20'
 };
 // 사이즈 유틸리티 함수들

package/dist/esm/assets/scripts/notification/messageTemplate.js

@@ -0,0 +1,100 @@
+import { HIDE_PERMANENTLY_LABEL } from '../../../constant/notification';
+import { CLASS_NAMES, MESSAGE_SIZES, SVG_ICONS } from './const';
+import { renderActions, renderSupportingText } from './utils';
+/**
+ * message 타입 액션 버튼 사이즈. TO-BE 규격 28px이며 React `<Button size="xs">`와 같다.
+ * floating / full-width는 이 값을 쓰지 않고 `renderActions`의 기본값('sm')을 유지한다.
+ */
+const ACTION_BUTTON_SIZE = 'xs';
+/**
+ * Message Notification의 마크업을 만든다.
+ * React 구현(`src/components/overlays/notification/MessageNotification.tsx`)과
+ * 동일한 클래스 트리를 산출해야 한다 — SCSS 한 벌을 두 구현이 공유한다.
+ */
+export function buildMessageTemplate(params) {
+  const {
+    title,
+    supportingText,
+    actions,
+    onClose,
+    onHidePermanently,
+    hidePermanentlyLabel
+  } = params;
+  return `
+    <div class="${CLASS_NAMES.MESSAGE.CONTAINER}">
+      <div class="${CLASS_NAMES.MESSAGE.CONTENT}">
+        <div class="${CLASS_NAMES.MESSAGE.CONTENT_WRAPPER}">
+          <div class="${CLASS_NAMES.MESSAGE.TEXT_CONTAINER}">
+            <span class="${CLASS_NAMES.MESSAGE.TITLE}">${title}</span>
+            ${renderSupportingText(supportingText, CLASS_NAMES.MESSAGE.SUPPORTING_TEXT)}
+          </div>
+        </div>
+        ${renderActionsContainer({
+    actions,
+    onClose,
+    onHidePermanently,
+    hidePermanentlyLabel
+  })}
+      </div>
+    </div>
+  `;
+}
+/**
+ * 액션 버튼 그룹과 닫기 그룹을 함께 감싸는 우측 영역.
+ * 이 컨테이너의 gap(12px)이 두 그룹 사이 간격을 만든다.
+ * 표시할 요소가 하나도 없으면 빈 컨테이너를 남기지 않는다.
+ */
+function renderActionsContainer(params) {
+  const {
+    actions,
+    onClose,
+    onHidePermanently,
+    hidePermanentlyLabel
+  } = params;
+  const actionsHtml = renderActions(actions ?? [], CLASS_NAMES.MESSAGE.ACTIONS, ACTION_BUTTON_SIZE);
+  const footerHtml = renderFooterContainer({
+    onClose,
+    onHidePermanently,
+    hidePermanentlyLabel
+  });
+  if (!actionsHtml && !footerHtml) return '';
+  return `<div class="${CLASS_NAMES.MESSAGE.ACTIONS_CONTAINER}">${actionsHtml}${footerHtml}</div>`;
+}
+/** 다시 보지 않기 + 닫기 그룹. 전용 래퍼를 쓰는 이유는 `CLASS_NAMES.MESSAGE.FOOTER_CONTAINER` 참조. */
+function renderFooterContainer(params) {
+  const {
+    onClose,
+    onHidePermanently,
+    hidePermanentlyLabel
+  } = params;
+  if (!onHidePermanently && !onClose) return '';
+  return `
+    <div class="${CLASS_NAMES.MESSAGE.FOOTER_CONTAINER}">
+      ${renderHidePermanentlyButton(onHidePermanently, hidePermanentlyLabel)}
+      ${renderCloseButton(onClose)}
+    </div>
+  `;
+}
+/**
+ * 다시 보지 않기 버튼.
+ *
+ * `label`은 이 함수의 반환값이 `wrapper.innerHTML`에 들어가기 전에 `sanitizeHtml`로
+ * 처리되므로 별도 이스케이프하지 않는다 — `renderSupportingText`와 같은 정책이다.
+ */
+function renderHidePermanentlyButton(onHidePermanently, hidePermanentlyLabel) {
+  if (!onHidePermanently) return '';
+  const label = hidePermanentlyLabel ?? HIDE_PERMANENTLY_LABEL.message;
+  return `
+    <button type="button" class="${CLASS_NAMES.COMMON.ACTION_BUTTON} ${CLASS_NAMES.MESSAGE.HIDE_LINK}" data-hide-permanently="true">
+      ${label}
+    </button>
+  `;
+}
+function renderCloseButton(onClose) {
+  if (!onClose) return '';
+  return `
+    <button type="button" class="${CLASS_NAMES.MESSAGE.CLOSE_BUTTON}" aria-label="알림 닫기">
+      ${SVG_ICONS['x-close'](MESSAGE_SIZES.CLOSE_BUTTON).replace('stroke="currentColor"', 'stroke="#2F2F30"')}
+    </button>
+  `;
+}

package/dist/esm/assets/scripts/notification/utils.js

@@ -45,16 +45,51 @@ export function renderSupportingText(supportingText, className, supportTextLink)
   // unsafe URL이거나 link가 없으면 링크 없이 텍스트만 렌더링
   return `<span class="${className}">${supportingText}</span>`;
 }
+/** 액션 버튼 색상을 지정하지 않았을 때의 기본값. React `MessageNotificationParts`와 같다. */
+const DEFAULT_ACTION_HIERARCHY = 'text';
+/**
+ * 액션 버튼의 색상 수식자를 현행 어휘로 정규화한다.
+ *
+ * 구 어휘(`'link'` / `'link-gray'`)는 Link 컴포넌트의 색상 이름을 빌려 쓴 것이라
+ * `ncua-btn--link`에 대응하는 CSS가 존재하지 않았다. 기존 CDN 사용처를 깨지 않기 위해
+ * 타입에서 제거하는 대신 이 지점에서 실제 Button 테마로 매핑한다.
+ *
+ * 렌더(`renderActions`)와 이벤트 바인딩(`bindNotificationEvents`)이 이 함수를 함께 써야
+ * `data-action` 키가 어긋나지 않는다.
+ */
+export function resolveActionHierarchy(hierarchy) {
+  switch (hierarchy) {
+    case undefined:
+      return DEFAULT_ACTION_HIERARCHY;
+    case 'link':
+      return 'text';
+    case 'link-gray':
+      return 'text-gray';
+    default:
+      return hierarchy;
+  }
+}
+/** 액션 버튼의 클릭 라우팅 키. 렌더와 바인딩이 같은 규칙으로 만들어야 한다. */
+function buildActionKey(action) {
+  return `${action.label}-${resolveActionHierarchy(action.hierarchy)}`;
+}
+/**
+ * 액션 버튼 그룹 HTML을 만든다.
+ *
+ * `size` 기본값 'sm'은 floating / full-width 타입의 기존 렌더링을 그대로 보존하기 위한 것이다.
+ * message 타입만 TO-BE 규격(28px)에 맞춰 'xs'를 넘긴다 — React `<Button size="xs">`와 동일.
+ */
 export function renderActions(actions, wrapperClass) {
+  let size = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'sm';
   // 액션이 없으면 빈 문자열 반환
   if (!actions || actions.length === 0) {
     return '';
   }
   const buttonsHtml = actions.map(action => {
     const buttonHtml = `
-      <button 
-        class="ncua-btn ncua-btn--sm ncua-btn--${action.hierarchy || 'text'}"
-        data-action="${action.label}-${action.hierarchy}"
+      <button
+        class="ncua-btn ncua-btn--${size} ncua-btn--${resolveActionHierarchy(action.hierarchy)}"
+        data-action="${buildActionKey(action)}"
       >
         ${action.label}
       </button>`;
@@ -80,7 +115,7 @@ export function bindNotificationEvents(element, actions, onClose, onRemove) {
       if (actionData) {
         let matchedAction = null;
         for (const action of actions) {
-          const expectedDataAction = `${action.label}-${action.hierarchy || 'link'}`;
+          const expectedDataAction = buildActionKey(action);
           if (actionData === expectedDataAction) {
             matchedAction = action;
             break;

package/dist/esm/constant/notification.js

@@ -0,0 +1,15 @@
+/**
+ * 다시보지 않기 버튼의 타입별 기본 문구.
+ *
+ * `hidePermanentlyLabel`을 지정하지 않았을 때 쓰인다.
+ * React(`src/components/overlays/notification/`)와 Vanilla(`assets/scripts/notification/`)
+ * 두 구현이 이 상수를 함께 참조한다 — 문구가 하드코딩으로 흩어져 서로 어긋나던 문제(#460)를
+ * 막기 위한 단일 출처다.
+ *
+ * `message`와 `fullWidth`의 띄어쓰기가 다른 것은 오타가 아니라 현행 유지다.
+ * 표기 통일은 별도 결정 사항이며, 결정되면 이 파일 한 곳만 고치면 된다.
+ */
+export const HIDE_PERMANENTLY_LABEL = {
+  message: '다시 보지 않기',
+  fullWidth: '다시보지 않기'
+};

package/dist/esm/src/components/forms-and-input/input-base/InputBase.js

@@ -5,11 +5,9 @@ import { forwardRef, useEffect, useRef, useState } from 'react';
 import { COLOR } from '../../../../constant/color';
 import { HintText } from '../../shared/hintText/HintText';
 import { Label } from '../../shared/label/Label';
-const validationSvgSize = {
-  xs: 14,
-  sm: 16
-};
-const generalSvgSize = {
+// 슬롯 아이콘(leadingElement/trailingElement)과 상태 아이콘(clear·validation·destructive)은 같은 크기를 쓴다.
+// slot.size 를 명시하면 그 값이 우선한다.
+const iconSvgSize = {
   xs: 14,
   sm: 20
 };
@@ -34,20 +32,28 @@ const InputBase = /*#__PURE__*/forwardRef((_ref, ref) => {
     ...props
   } = _ref;
   const inputRef = useRef(null);
-  const [textCount, setTextCount] = useState(0);
+  // controlled 인풋은 props.value 로 길이를 알 수 있으므로 상태를 두지 않는다.
+  // 입력마다 setState 를 하면 조합 중(한글 IME)에 리렌더가 끼어들어 조합이 끊긴다.
+  const isControlled = props.value !== undefined;
+  const [uncontrolledLength, setUncontrolledLength] = useState(0);
+  const valueLength = isControlled ? String(props.value ?? '').length : uncontrolledLength;
+  const hasValue = valueLength > 0;
+  const textCount = valueLength;
+  // uncontrolled 인풋만 DOM 값을 읽어 따라간다 — props.value 가 없어 길이를 알 방법이 이것뿐이다.
   useEffect(() => {
-    if (inputRef.current && showTextCount) {
-      setTextCount(inputRef.current.value.length);
-      const handleInput = () => {
-        setTextCount(inputRef.current?.value.length ?? 0);
-      };
-      inputRef.current.addEventListener('input', handleInput);
-      return () => {
-        inputRef.current?.removeEventListener('input', handleInput);
-      };
-    }
-  }, [showTextCount]);
-  const renderOutsideSlot = slot => {
+    if (isControlled) return;
+    const input = inputRef.current;
+    if (!input) return;
+    const syncFromInput = () => {
+      setUncontrolledLength(input.value.length);
+    };
+    syncFromInput();
+    input.addEventListener('input', syncFromInput);
+    return () => {
+      input.removeEventListener('input', syncFromInput);
+    };
+  }, [isControlled]);
+  const renderOutsideSlot = (slot, position) => {
     if (slot.type === 'custom' && slot.placement !== 'outside') {
       return null;
     }
@@ -60,10 +66,15 @@ const InputBase = /*#__PURE__*/forwardRef((_ref, ref) => {
           children: slot.label
         });
       case 'text':
-        return _jsx("span", {
-          className: classNames('ncua-input__leading-text', `ncua-input__leading-text--${size}`),
-          children: slot.text
-        });
+        {
+          // 클래스명은 리터럴로 쓴다 — MCP 의 BEM 추출기가 `ncua-input__${position}-text` 형태의
+          // 템플릿 리터럴에서는 `ncua-input__` 조각만 읽어 완성된 클래스를 잡지 못한다.
+          const textClass = position === 'leading' ? 'ncua-input__leading-text' : 'ncua-input__trailing-text';
+          return _jsx("span", {
+            className: classNames(textClass, `${textClass}--${size}`),
+            children: slot.text
+          });
+        }
       case 'custom':
         return slot.children;
       default:
@@ -78,10 +89,15 @@ const InputBase = /*#__PURE__*/forwardRef((_ref, ref) => {
           return _jsx("div", {
             className: "ncua-input__icon-wrap",
             children: _jsx(SlotIcon, {
-              className: classNames(`ncua-input__${position}-icon`, slot.className),
+              className: classNames(`ncua-input__${position}-icon`,
+              // color 를 지정하지 않았을 때만 상태별 색(Placeholder/Filled/Focused/Disabled)을 CSS 에 맡긴다.
+              // 지정한 경우에는 이 클래스를 붙이지 않아 지정 색이 그대로 유지된다.
+              {
+                'ncua-input__slot-icon': !slot.color
+              }, slot.className),
               color: slot.color ? COLOR[slot.color] : undefined,
-              width: slot.size ?? generalSvgSize[size],
-              height: slot.size ?? generalSvgSize[size]
+              width: slot.size ?? iconSvgSize[size],
+              height: slot.size ?? iconSvgSize[size]
             })
           });
         }
@@ -102,8 +118,8 @@ const InputBase = /*#__PURE__*/forwardRef((_ref, ref) => {
       onClick: onClearText,
       children: _jsx(X, {
         className: "ncua-input__clear-icon",
-        width: validationSvgSize[size],
-        height: validationSvgSize[size]
+        width: iconSvgSize[size],
+        height: iconSvgSize[size]
       })
     });
   };
@@ -113,8 +129,8 @@ const InputBase = /*#__PURE__*/forwardRef((_ref, ref) => {
         className: "ncua-input__icon-wrap ncua-input__right-icon",
         children: _jsx(InfoCircle, {
           className: "ncua-input__destructive-icon",
-          width: validationSvgSize[size],
-          height: validationSvgSize[size]
+          width: iconSvgSize[size],
+          height: iconSvgSize[size]
         })
       });
     }
@@ -123,8 +139,8 @@ const InputBase = /*#__PURE__*/forwardRef((_ref, ref) => {
         className: "ncua-input__icon-wrap ncua-input__right-icon",
         children: _jsx(CheckCircle, {
           className: "ncua-input__validation-icon",
-          width: validationSvgSize[size],
-          height: validationSvgSize[size]
+          width: iconSvgSize[size],
+          height: iconSvgSize[size]
         })
       });
     }
@@ -149,13 +165,15 @@ const InputBase = /*#__PURE__*/forwardRef((_ref, ref) => {
       'is-disabled': disabled,
       'full-width': fullWidth,
       'ncua-input__trailing-button': trailingElement?.type === 'button',
-      'ncua-input__leading-text-wrap': leadingElement?.type === 'text'
+      'ncua-input__leading-text-wrap': leadingElement?.type === 'text',
+      'ncua-input__trailing-text-wrap': trailingElement?.type === 'text',
+      'has-value': hasValue
     }, className),
     children: [renderLabel(), _jsxs("div", {
       className: "ncua-input__content-wrap",
       children: [_jsxs("div", {
         className: "ncua-input__content",
-        children: [leadingElement && renderOutsideSlot(leadingElement), _jsxs("div", {
+        children: [leadingElement && renderOutsideSlot(leadingElement, 'leading'), _jsxs("div", {
           className: classNames('ncua-input__field', `ncua-input__field--${size}`),
           children: [leadingElement && renderInsideSlot(leadingElement, 'left'), _jsx("input", {
             ref: node => {
@@ -171,7 +189,7 @@ const InputBase = /*#__PURE__*/forwardRef((_ref, ref) => {
             maxLength: maxLength,
             ...props
           }), renderClearButton(), renderStatusIcon(), trailingElement && renderInsideSlot(trailingElement, 'right')]
-        }), trailingElement && renderOutsideSlot(trailingElement)]
+        }), trailingElement && renderOutsideSlot(trailingElement, 'trailing')]
       }), showTextCount && maxLength && _jsxs("div", {
         className: "ncua-input__field-text-count",
         children: [_jsx("output", {